Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

nfsref(8)

Name

nfsref - NFS referral utility

Synopsis

nfsref [-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 systems. Referrals are based on reparse points (see reparsed(8) 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 implements two service types: nfs-basic, which is the default, and nfs-fedfs. nfs-basic referrals embed location information within the reparse point, while nfs-fedfs referrals embed information to look up location information in LDAP. For more information, see the fedfs(7) man page.

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.

Creating FedFS referrals must always be done with LDAP simple authentication with the root distinguished name and matching password available. The root DN must be stored for the LDAP server in nsdbparams; the password may be stored in nsdbparams, or the admin may enter it when prompted. The default LDAP host and port will be those set with nsdbparams get unless overridden with the FEDFS_NSDB_HOST and FEDFS_NSDB_PORT environment variables.

Options

The following options are supported:

–t svc_type

Specify a service type. Currently, only nfs-basic and nfs-fedfs are 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
/pool/home/bob points to: 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
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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
service/file-system/nfs
Interface Stability
Committed

See Also

libreparse(3LIB), attributes(7), fedfs(7), reparsed(8)