| 1 |
.\" |
| 2 |
.\" nfsdclnts(8) |
| 3 |
.\" |
| 4 |
.TH "NFSDCLTS" "8" "2020-05-09" "nfsdclnts" "nfsdclnts" |
| 5 |
.ie \n(.g .ds Aq \(aq |
| 6 |
.el .ds Aq ' |
| 7 |
.ss \n[.ss] 0 |
| 8 |
.nh |
| 9 |
.ad l |
| 10 |
.de URL |
| 11 |
\fI\\$2\fP <\\$1>\\$3 |
| 12 |
.. |
| 13 |
.als MTO URL |
| 14 |
.if \n[.g] \{\ |
| 15 |
. mso www.tmac |
| 16 |
. am URL |
| 17 |
. ad l |
| 18 |
. . |
| 19 |
. am MTO |
| 20 |
. ad l |
| 21 |
. . |
| 22 |
. LINKSTYLE blue R < > |
| 23 |
.\} |
| 24 |
.SH "NAME" |
| 25 |
nfsdclnts \- print various nfs client information for knfsd server. |
| 26 |
.SH "SYNOPSIS" |
| 27 |
.sp |
| 28 |
\fBnfsdclnts\fP [\fI\-h\fP] [\fI\-t type\fP] [\fI\-\-clientinfo\fP] [\fI\-\-hostname\fP] [\fI\-q\fP] |
| 29 |
.SH "DESCRIPTION" |
| 30 |
.sp |
| 31 |
The nfsdclnts(8) command parses the content present in /proc/fs/nfsd/clients/ directories. nfsdclnts(8) displays files which are open, locked, delegated by the nfs\-client. It also prints useful client information such as hostname, clientID, NFS version mounted by the nfs\-client. |
| 32 |
.SH "OPTIONS" |
| 33 |
.sp |
| 34 |
\fB\-t, \-\-type\fP=TYPE |
| 35 |
.RS 4 |
| 36 |
Specify the type of file to be displayed. Takes only one TYPE at a time. |
| 37 |
.sp |
| 38 |
\fIopen\fP, \fIlock\fP, \fIdeleg\fP, \fIlayout\fP, or \fIall\fP |
| 39 |
.sp |
| 40 |
open: displays the open files by nfs\-client(s). |
| 41 |
.sp |
| 42 |
lock: displays the files locked by nfs\-client(s). |
| 43 |
.sp |
| 44 |
layout: displays the files for which layout is given. |
| 45 |
.sp |
| 46 |
deleg: displays delegated files information and delegation type. |
| 47 |
.sp |
| 48 |
all: prints all the above type. |
| 49 |
.RE |
| 50 |
.sp |
| 51 |
\fB\-\-clientinfo\fP |
| 52 |
.RS 4 |
| 53 |
displays various nfs\-client info fields such as version of nfs mounted at nfs\-client and clientID. |
| 54 |
.RE |
| 55 |
.sp |
| 56 |
\fB\-\-hostname\fP |
| 57 |
.RS 4 |
| 58 |
Print hostname of nfs\-client instead of ip-address. |
| 59 |
.RE |
| 60 |
.sp |
| 61 |
\fB\-q, \-\-quiet\fP |
| 62 |
.RS 4 |
| 63 |
Hide the header information. |
| 64 |
.RE |
| 65 |
.sp |
| 66 |
\fB\-v, \-\-verbose\fP |
| 67 |
.RS 4 |
| 68 |
Verbose operation, show debug messages. |
| 69 |
.RE |
| 70 |
.sp |
| 71 |
\fB\-f, \-\-file\fP |
| 72 |
.RS 4 |
| 73 |
Instead of processing all client directories under /proc/fs/nfsd/clients, one can provide a specific |
| 74 |
states file to process. One should make sure that info file resides in the same directory as states file. |
| 75 |
If the info file is not valid or present the fields would be marked as "N/A". |
| 76 |
.RE |
| 77 |
.sp |
| 78 |
\fB\-h, \-\-help\fP |
| 79 |
.RS 4 |
| 80 |
Print help explaining the command line options. |
| 81 |
.SH "EXAMPLES" |
| 82 |
.sp |
| 83 |
\fBnfsdclnts \-\-type open\fP |
| 84 |
.RS 4 |
| 85 |
List all files with open type only. |
| 86 |
.RE |
| 87 |
.sp |
| 88 |
.if n .RS 4 |
| 89 |
.nf |
| 90 |
Inode number | Type | Access | Deny | ip address | Filename |
| 91 |
33823232 | open | r\- | \-\- | [::1]:757 | testfile |
| 92 |
.fi |
| 93 |
.if n .RE |
| 94 |
.sp |
| 95 |
\fBnfsdclnts \-\-type deleg\fP |
| 96 |
.RS 4 |
| 97 |
List all files with deleg type only. |
| 98 |
.RE |
| 99 |
.sp |
| 100 |
.if n .RS 4 |
| 101 |
.nf |
| 102 |
Inode number | Type | Access | ip address | Filename |
| 103 |
33823232 | deleg | r | [::1]:757 | testfile |
| 104 |
.fi |
| 105 |
.if n .RE |
| 106 |
.sp |
| 107 |
\fBnfsdclnts \-\-hostname\fP |
| 108 |
.RS 4 |
| 109 |
Print hostname instead of ip\-address. |
| 110 |
.RE |
| 111 |
.sp |
| 112 |
.if n .RS 4 |
| 113 |
.nf |
| 114 |
Inode number | Type | Access | Deny | Hostname | Filename |
| 115 |
33823232 | open | r\- | \-\- | nfs\-server | testfile |
| 116 |
33823232 | deleg | r | | nfs\-server | testfile |
| 117 |
.fi |
| 118 |
.if n .RE |
| 119 |
.sp |
| 120 |
\fBnfsdclnts \-\-clientinfo\fP |
| 121 |
.RS 4 |
| 122 |
Print client information. |
| 123 |
.RE |
| 124 |
.sp |
| 125 |
.if n .RS 4 |
| 126 |
.nf |
| 127 |
Inode number | Type | Access | Deny | ip address | Client ID | vers | Filename |
| 128 |
33823232 | open | r\- | \-\- | [::1]:757 | 0xc79a009f5eb65e84 | 4.2 | testfile |
| 129 |
33823232 | deleg | r | | [::1]:757 | 0xc79a009f5eb65e84 | 4.2 | testfile |
| 130 |
.fi |
| 131 |
.if n .RE |
| 132 |
.sp |
| 133 |
\fBnfsdclnts \-\-file /proc/fs/nfsd/clients/3/states -t open\fP |
| 134 |
.RS 4 |
| 135 |
Process specific states file. |
| 136 |
.RE |
| 137 |
.sp |
| 138 |
.if n .RS 4 |
| 139 |
.nf |
| 140 |
Inode number | Type | Access | Deny | ip address | Client ID | vers | Filename |
| 141 |
33823232 | open | r\- | \-\- | [::1]:757 | 0xc79a009f5eb65e84 | 4.2 | testfile |
| 142 |
.fi |
| 143 |
.if n .RE |
| 144 |
.sp |
| 145 |
\fBnfsdclnts \-\-quiet \-\-hostname\fP |
| 146 |
.RS 4 |
| 147 |
Hide the header information. |
| 148 |
.RE |
| 149 |
.sp |
| 150 |
.if n .RS 4 |
| 151 |
.nf |
| 152 |
33823232 | open | r\- | \-\- | nfs\-server | testfile |
| 153 |
33823232 | deleg | r | | nfs\-server | testfile |
| 154 |
.fi |
| 155 |
.if n .RE |
| 156 |
.SH "FILES" |
| 157 |
.sp |
| 158 |
\fB/proc/fs/nfsd/clients/\fP |
| 159 |
.sp |
| 160 |
Displays basic information about each NFSv4 client. |
| 161 |
.sp |
| 162 |
\fB/proc/fs/nfsd/clients/#/info\fP |
| 163 |
.sp |
| 164 |
Displays information about all the opens held by the given client, including open modes, device numbers, inode numbers, and open owners. |
| 165 |
.sp |
| 166 |
\fB/proc/fs/nfsd/clients/#/states\fP |
| 167 |
.SH "NOTES" |
| 168 |
.sp |
| 169 |
/proc/fs/nfsd/clients/ support was initially introduced in 5.3 kernel and is only implemented for mount points using NFSv4. |
| 170 |
.SH "BUGS" |
| 171 |
Please report any BUGs to \c |
| 172 |
.MTO "linux\-nfs\(atvger.kernel.org" "" "" |
| 173 |
.SH SEE ALSO |
| 174 |
.BR nfsd (8), |
| 175 |
.BR exportfs (8), |
| 176 |
.BR idmapd (8), |
| 177 |
.BR statd (8) |
| 178 |
.SH "AUTHORS" |
| 179 |
Achilles Gaikwad <[email protected]> and |
| 180 |
Kenneth D'souza <[email protected]> |