share(1M)                          (NFS)                          share(1M)


   NAME
         share - make local NFS resource available for mounting by remote
         systems

   SYNOPSIS
         share [ -F nfs ] [ -o specific_options ] [ -d description ] pathname

   DESCRIPTION
         The share command makes local resources available for mounting by
         remote systems.

         If no argument is specified, then share displays all resources
         currently shared, including NFS resources and resources shared
         through other distributed file system packages.

         The following options are recognized:

         -o specific_options
               Specify options in a comma-separated list of keywords and
               attribute-value-assertions for interpretation by the file-
               system-type-specific command.

               specific_options can be any combination of the following:

              rw    Sharing will be read-write to all clients.

              rw=client[:client]...
                    Sharing will be read-write to the listed clients;
                    overrides the ro suboption for the clients specified.

              ro    Sharing will be read-only to all clients.

              ro=client[:client]...
                    Sharing will be read-only to the listed clients; overrides
                    the rw suboption for the clients specified.

              anon=uid
                    Set uid to be the effective user ID of unathenticated
                    users if AUTH_DES authentication is used, or to be root if
                    AUTH_UNIX authentication is used.  By default, unknown
                    users are given the effective user ID UIDNOBODY.  If uid
                    is set to -1, access is denied.

              root=host[:host]...
                    Only root users from the specified hosts will have root
                    access.  By default, no host has root access.

              secure
                    Clients must use the AUTH_DES authentication of RPC.
                    AUTH_UNIX authentication is the default.



   8/91                                                                 Page 1

   share(1M)                          (NFS)                          share(1M)


               If specific_options is not specified, then by default sharing
               will be read-write to all clients.

         -d description
                     Provide a comment that describes the resource to be
                     shared.

         pathname    Specify the pathname of the resource to be shared.

   FILES
         /etc/dfs/fstypes
         /etc/dfs/sharetab

   SEE ALSO
         unshare(1M)

   NOTES
         The command will fail if both ro and rw are specified.  If the same
         client name exists in both the ro= and rw= lists, the rw will
         override the ro, giving read/write access to the client specified.

         ro=, rw=, and root= are guaranteed to work over UDP but may not work
         over other transport providers.

         If a resource is shared with a ro= list and a root= list, any host
         that is on the root= list will be given only read-only access,
         regardless of whether that host is specified in the ro= list, unless
         rw is declared as the default, or the host is mentioned in a rw=
         list. The same is true if the resource is shared with ro as the
         default. For example, the following share commands will give read-
         only permissions to hostb:

               share -F nfs -oro=hosta,root=hostb /var

               share -F nfs -oro,root=hostb /var

         While the following will give read/write permissions to hostb:

               share -F nfs -oro=hosta,rw=hostb,root=hostb /var

               share -F nfs -oroot=hostb /var












   Page 2                                                                 8/91