Debian Codegraph @

upstream/debian-unstable/man8/nfsdclnts.8

raw
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]>