System Administration Commands			     nfsref(1M)



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 filesystems.	Referrals are  based  on  reparse
     points  (see  reparsed(1M)	 and   libreparse(1M)).	 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".

     The first form, nfsref add, will create a referral	 pointing
     to	 the given locations.  If a reparse point does not exist,
     one will be created, and if it does exist,	NFS service  data
     will  be  added  or  will replace existing	NFS service data.
     Each location has a host:/path format, and	the path may con-
     tain  spaces  (which  must	be escaped to ensure proper shell
     parsing).

     The second	form, nfsref delete, will remove an NFS	referral.
     It	 will  remove  NFS  service  data  from	the given reparse
     point, and	will remove the	reparse	point  if  there  are  no
     other types of service data present.

     The third form, nfsref lookup, will display  to  what  loca-
     tions the NFS referral points.


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





SunOS 5.11	    Last change: 18 Sep	2009			1






System Administration Commands			     nfsref(1M)



     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  attri-
     butes:



     ____________________________________________________________
    |	    ATTRIBUTE TYPE	  |	  ATTRIBUTE VALUE	|
    |_____________________________|_____________________________|
    | Availability		  | SUNWnfssu			|
    |_____________________________|_____________________________|
    | Interface	Stability	  | Consolidation Private	|
    |_____________________________|_____________________________|


SEE ALSO
     libreparse(3reparse), attributes(5)
















SunOS 5.11	    Last change: 18 Sep	2009			2