nfsref(1M) System Administration Commands nfsref(1M)NAMEnfsref - NFS referral utility
SYNOPSISnfsref [-t svc_type] add path location [location ...]
nfsref [-t svc_type] remove path
nfsref [-t svc_type] lookup path
DESCRIPTION
The nfsref command manages NFS Version 4 referrals, which are server-
side pointers used to redirect clients to actual locations of file sys‐
tems. Referrals are based on reparse points (see reparsed(1M) and
libreparse(3LIB)). The path arguments in all forms of the synopsis
refer to the path to the reparse point symbolic link. This command cur‐
rently implements one "service type" - nfs-basic, which is the default.
The first form of the command, nfsref add, creates a referral pointing
to the specified locations. If a reparse point does not exist, one is
created. If it does exist, NFS service data is added or replaces exist‐
ing NFS service data. Each location has a host:/path format. The path
can contain spaces, which must be escaped to ensure proper shell pars‐
ing.
The second form of the command, nfsref delete, removes an NFS referral.
It removes NFS service data from the specified reparse point, and
removes the reparse point if there are no other types of service data
present.
The third form of the command, nfsref lookup, displays the locations to
which the specified NFS referral points.
OPTIONS
The following options are supported:
-t svc_type
Specify a service type. Currently, only nfs-basic is supported.
EXAMPLES
Example 1 Adding an NFS Referral
The following command creates an NFS referral at the server path
/pool/home/bob, pointing to the resource homeserver:/homepool/bob.
# nfsref add /pool/home/bob homeserver:/homepool/bob
Created reparse point /pool/home/bob
# nfsref lookup /pool/home/bob
homeserver:/homepool/bob
Example 2 Removing an NFS Referral
The following command removes an NFS referral at the server path
/pool/home/bob.
# nfsref remove /pool/home/bob homeserver:/homepool/bob
Removed svc_type 'nfs-basic' from /pool/home/bob
EXIT STATUS
0
Successful completion.
>0
An error occurred.
FILES
/usr/lib/reparsed/*.so.1
Per-service plugins for reparsed.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │service/file-system/nfs │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Consolidation Private │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOreparsed(1M), libreparse(3LIB), attributes(5)SunOS 5.11 10 Nov 2009 nfsref(1M)
