Manual Pages for UNIX Operating System command usage for man nfsref

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 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  refer-
     ral  pointing to the specified locations. If a reparse point
     does not exist, one is created. If it does exist,  NFS  ser-
     vice  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 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.






SunOS 5.11          Last change: 10 Nov 2009                    1






System Administration Commands                         nfsref(1M)



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






SunOS 5.11          Last change: 10 Nov 2009                    2






System Administration Commands                         nfsref(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/file-system/nfs     |
    |_____________________________|_____________________________|
    | Interface Stability         | Consolidation Private       |
    |_____________________________|_____________________________|


SEE ALSO
     reparsed(1M), libreparse(3LIB), attributes(5)












































SunOS 5.11          Last change: 10 Nov 2009                    3