Skip to contentSkip to conversation

nfsd(7): minimal updates

PATCH In review J. Bruce Fields 2 participants 4 messages Mar 19, 2020 – Mar 27, 2020

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/2 nfsd(7): minimal updates

From: "J. Bruce Fields" <[email protected]>

The nfsd(7) man page has some useful documentation of the files under /proc/fs/nfsd/ and proc/net/rpc, but it's many years out of date.

As a start, banish any discussion of the long-deprecated nfsctl systemcall to a NOTES section at the end, and admit that there are more than 3 files under /proc/fs/nfsd/.

---
 utils/exportfs/nfsd.man | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)
utils/exportfs/nfsd.man +14 -13
index 9efa29f9f01c..1392f3926053 100644
@@ -13,14 +13,8 @@ nfsd \- special filesystem for controlling Linux NFS server
 The
 .B nfsd
 filesystem is a special filesystem which provides access to the Linux
-NFS server.  The filesystem consists of a single directory which
-contains a number of files.  These files are actually gateways into
-the NFS server.  Writing to them can affect the server.  Reading from
-them can provide information about the server.
-.P
-This file system is only available in Linux 2.6 and later series
-kernels (and in the later parts of the 2.5 development series leading
-up to 2.6).  This man page does not apply to 2.4 and earlier.
+NFS server.  Writing to files in this filesystem can affect the server.
+Reading from them can provide information about the server.
 .P
 As well as this filesystem, there are a collection of files in the
 .B procfs
@@ -38,13 +32,10 @@ filesystem mounted at
 .B /proc/fs/nfsd
 or
 .BR /proc/fs/nfs .
-If it is not mounted, they will fall-back on 2.4 style functionality.
-This involves accessing the NFS server via a systemcall.  This
-systemcall is scheduled to be removed after the 2.6 kernel series.
 .SH DETAILS
-The three files in the
+Files in the
 .B nfsd
-filesystem are:
+filesystem include:
 .TP
 .B exports
 This file contains a list of filesystems that are currently exported
@@ -191,6 +182,16 @@ number represents a bit-pattern where bits that are set cause certain
 classes of tracing to be enabled.  Consult the kernel header files to
 find out what number correspond to what tracing.
 
+.SH NOTES
+This file system is only available in Linux 2.6 and later series
+kernels (and in the later parts of the 2.5 development series leading
+up to 2.6).  This man page does not apply to 2.4 and earlier.
+.P
+Previously the nfsctl systemcall was used for communication between nfsd
+and user utilities.  That systemcall was removed in kernel version 3.1.
+Older nfs-utils versions were able to fall back to nfsctl if necessary;
+that was removed from nfs-utils 1.3.5.
+
 .SH SEE ALSO
 .BR nfsd (8),
 .BR rpc.nfsd (8),
Signature · 1 line
2.25.1
#1 lore raw

PATCH 2/2 nfsd(7): minimal /proc/fs/nfsd/clients/ documentation

From: "J. Bruce Fields" <[email protected]>

We should really say more, but this is at least a starting point.

---
 utils/exportfs/nfsd.man | 10 ++++++++++
 1 file changed, 10 insertions(+)
utils/exportfs/nfsd.man +10 -0
index 1392f3926053..514153f024fa 100644
@@ -81,6 +81,16 @@ for that path as exported to the given client.  The filehandle's length
 will be at most the number of bytes given.
 
 The filehandle will be represented in hex with a leading '\ex'.
+
+.TP
+.B clients/
+This directory contains a subdirectory for each NFSv4 client.  Each file
+under that subdirectory gives some details about the client in YAML
+format.  In addition, writing "expire\\n" to the
+.B ctl
+file will force the server to immediately revoke all state held by that
+client.
+
 .PP
 The directory
 .B /proc/net/rpc
Signature · 1 line
2.25.1
#2 lore raw

Re: [PATCH 2/2] nfsd(7): minimal /proc/fs/nfsd/clients/ documentation

Quoted 5 lines · J. Bruce Fields

From: "J. Bruce Fields" <[email protected]>

We should really say more, but this is at least a starting point.

Committed... (tag: nfs-utils-2-4-4-rc2)

steved.

Quoted 26 lines
---
 utils/exportfs/nfsd.man | 10 ++++++++++
 1 file changed, 10 insertions(+)
utils/exportfs/nfsd.man +10 -0
index 1392f3926053..514153f024fa 100644
@@ -81,6 +81,16 @@ for that path as exported to the given client.  The filehandle's length
 will be at most the number of bytes given.
 
 The filehandle will be represented in hex with a leading '\ex'.
+
+.TP
+.B clients/
+This directory contains a subdirectory for each NFSv4 client.  Each file
+under that subdirectory gives some details about the client in YAML
+format.  In addition, writing "expire\\n" to the
+.B ctl
+file will force the server to immediately revoke all state held by that
+client.
+
 .PP
 The directory
 .B /proc/net/rpc
#3 lore raw
In reply to J. Bruce Fields
Quoted 10 lines · J. Bruce Fields

From: "J. Bruce Fields" <[email protected]>

The nfsd(7) man page has some useful documentation of the files under /proc/fs/nfsd/ and proc/net/rpc, but it's many years out of date.

As a start, banish any discussion of the long-deprecated nfsctl systemcall to a NOTES section at the end, and admit that there are more than 3 files under /proc/fs/nfsd/.

Committed... (tag: nfs-utils-2-4-4-rc2)

steved.

Quoted 59 lines
---
 utils/exportfs/nfsd.man | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)
utils/exportfs/nfsd.man +14 -13
index 9efa29f9f01c..1392f3926053 100644
@@ -13,14 +13,8 @@ nfsd \- special filesystem for controlling Linux NFS server
 The
 .B nfsd
 filesystem is a special filesystem which provides access to the Linux
-NFS server.  The filesystem consists of a single directory which
-contains a number of files.  These files are actually gateways into
-the NFS server.  Writing to them can affect the server.  Reading from
-them can provide information about the server.
-.P
-This file system is only available in Linux 2.6 and later series
-kernels (and in the later parts of the 2.5 development series leading
-up to 2.6).  This man page does not apply to 2.4 and earlier.
+NFS server.  Writing to files in this filesystem can affect the server.
+Reading from them can provide information about the server.
 .P
 As well as this filesystem, there are a collection of files in the
 .B procfs
@@ -38,13 +32,10 @@ filesystem mounted at
 .B /proc/fs/nfsd
 or
 .BR /proc/fs/nfs .
-If it is not mounted, they will fall-back on 2.4 style functionality.
-This involves accessing the NFS server via a systemcall.  This
-systemcall is scheduled to be removed after the 2.6 kernel series.
 .SH DETAILS
-The three files in the
+Files in the
 .B nfsd
-filesystem are:
+filesystem include:
 .TP
 .B exports
 This file contains a list of filesystems that are currently exported
@@ -191,6 +182,16 @@ number represents a bit-pattern where bits that are set cause certain
 classes of tracing to be enabled.  Consult the kernel header files to
 find out what number correspond to what tracing.
 
+.SH NOTES
+This file system is only available in Linux 2.6 and later series
+kernels (and in the later parts of the 2.5 development series leading
+up to 2.6).  This man page does not apply to 2.4 and earlier.
+.P
+Previously the nfsctl systemcall was used for communication between nfsd
+and user utilities.  That systemcall was removed in kernel version 3.1.
+Older nfs-utils versions were able to fall back to nfsctl if necessary;
+that was removed from nfs-utils 1.3.5.
+
 .SH SEE ALSO
 .BR nfsd (8),
 .BR rpc.nfsd (8),