nfsref

- NFS referral utility

Synopsis

nfsref [-tsvc_type] add pathlocation [location ...]

nfsref [-tsvc_type] remove path

nfsref [-tsvc_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 systems. 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 currently 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
existing NFS service data. Each location has a host:/path format. The path
can contain spaces, which must be escaped to ensure proper shell parsing.

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:

-tsvc_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.