Skip to content

Commit 5e12f17

Browse files
neilbrownamschuma-ntap
authored andcommitted
NFS: update documentation for the nfs4_unique_id parameter
The documentation for nfs4_unique_id is out-of-date. In particular it claim that when nfs4_unique_id is set, the host name is not used. since Commit 55b5929 ("NFSv4: Fix nfs4_init_uniform_client_string for net namespaces") both the unique_id AND the host name are used. Update the documentation to match the code. Signed-off-by: NeilBrown <[email protected]> Signed-off-by: Anna Schumaker <[email protected]>
1 parent 3e2910c commit 5e12f17

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

Documentation/admin-guide/nfs/nfs-client.rst

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -36,10 +36,9 @@ administrative requirements that require particular behavior that does not
3636
work well as part of an nfs_client_id4 string.
3737

3838
The nfs.nfs4_unique_id boot parameter specifies a unique string that can be
39-
used instead of a system's node name when an NFS client identifies itself to
40-
a server. Thus, if the system's node name is not unique, or it changes, its
41-
nfs.nfs4_unique_id stays the same, preventing collision with other clients
42-
or loss of state during NFS reboot recovery or transparent state migration.
39+
used together with a system's node name when an NFS client identifies itself to
40+
a server. Thus, if the system's node name is not unique, its
41+
nfs.nfs4_unique_id can help prevent collisions with other clients.
4342

4443
The nfs.nfs4_unique_id string is typically a UUID, though it can contain
4544
anything that is believed to be unique across all NFS clients. An
@@ -53,8 +52,12 @@ outstanding NFSv4 state has expired, to prevent loss of NFSv4 state.
5352

5453
This string can be stored in an NFS client's grub.conf, or it can be provided
5554
via a net boot facility such as PXE. It may also be specified as an nfs.ko
56-
module parameter. Specifying a uniquifier string is not support for NFS
57-
clients running in containers.
55+
module parameter.
56+
57+
This uniquifier string will be the same for all NFS clients running in
58+
containers unless it is overridden by a value written to
59+
/sys/fs/nfs/net/nfs_client/identifier which will be local to the network
60+
namespace of the process which writes.
5861

5962

6063
The DNS resolver

0 commit comments

Comments
 (0)