1
2NFSREF(8)                   System Manager's Manual                  NFSREF(8)
3
4
5

NAME

7       nfsref - manage NFS referrals
8

SYNOPSIS

10       nfsref [-?d] [-t type] add pathname server export [ server export ... ]
11
12       nfsref [-?d] [-t type] remove pathname
13
14       nfsref [-?d] [-t type] lookup pathname
15

INTRODUCTION

17       NFS  version  4 introduces the concept of file system referrals to NFS.
18       A file system referral is like a symbolic link  on  a  file  server  to
19       another  file system share, possibly on another file server.  On an NFS
20       client, a referral behaves like an automounted directory.  The  client,
21       under  the  server's  direction,  mounts a new NFS export automatically
22       when an application first accesses that directory.
23
24       Referrals are typically used to construct  a  single  file  name  space
25       across  multiple  file servers.  Because file servers control the shape
26       of the name space, no client configuration is required, and all clients
27       see the same referral information.
28
29       The  Linux NFS server supports NFS version 4 referrals.  Administrators
30       can specify the refer= export option in  /etc/exports  to  configure  a
31       list  of  exports from which the client can choose.  See exports(5) for
32       details.
33

DESCRIPTION

35       The nfsref(8) command is a simple way to get started managing  junction
36       metadata.  Other administrative commands provide richer access to junc‐
37       tion information.
38
39   Subcommands
40       Valid nfsref(8) subcommands are:
41
42       add    Adds junction information to the directory  named  by  pathname.
43              The  named  directory  must  already exist, and must not already
44              contain junction information.  Regular  directory  contents  are
45              obscured to NFS clients by this operation.
46
47              A  list of one or more file server and export path pairs is also
48              specified on the command line.  When creating an NFS basic junc‐
49              tion, this list is stored in an extended attribute of the direc‐
50              tory.
51
52              If  junction  creation  is  successful,  the  nfsref(8)  command
53              flushes  the  kernel's  export cache to remove previously cached
54              junction information.
55
56       remove Removes junction information from the directory named  by  path‐
57              name.  The named directory must exist, and must contain junction
58              information.  Regular directory contents are made visible to NFS
59              clients again by this operation.
60
61              If  junction  deletion  is  successful,  the  nfsref(8)  command
62              flushes the kernel's export cache to  remove  previously  cached
63              junction information.
64
65       lookup Displays  junction  information stored in the directory named by
66              pathname.  The named directory  must  exist,  and  must  contain
67              junction information.
68
69              When  looking up an NFS basic junction, the junction information
70              in the directory is listed on stdout.
71
72   Command line options
73       -d, --debug
74              Enables debugging messages during operation.
75
76       -t, --type=junction-type
77              Specifies the junction type for the operation.  Valid values for
78              junction-type are nfs-basic or nfs-fedfs.
79
80              For  the add subcommand, the default value if this option is not
81              specified is nfs-basic.  For the remove and lookup  subcommands,
82              the  --type option is not required.  The nfsref(8) command oper‐
83              ates on whatever junction contents are available.
84

EXAMPLES

86       Suppose you have  two  file  servers,  top.example.net  and  home.exam‐
87       ple.net.  You want all your clients to mount top.example.net:/ and then
88       see the files under home.example.net:/ automatically in top:/home.
89
90       On top.example.net, you might issue this command as root:
91
92              # mkdir /home
93              # nfsref --type=nfs-basic add /home home.example.net /
94              Created junction /home.
95
96

FILES

98       /etc/exports
99              NFS server export table
100

SEE ALSO

102       exports(5)
103
104       RFC 5661 for a description of NFS version 4 referrals
105

AUTHOR

107       Chuck Lever <chuck.lever@oracle.com>
108
109
110
111                                  9 Jan 2018                         NFSREF(8)
Impressum