share(1M)         MISC. REFERENCE MANUAL PAGES          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 mount-
     ing 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 pack-
     ages.

     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  follow-
          ing:

          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 speci-
               fied.

          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 speci-
               fied.

          anon=uid
               Set uid to be the effective user ID of  unathenti-
               cated 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.



                        Last change: NFS                        1

share(1M)         MISC. REFERENCE MANUAL PAGES          share(1M)



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

          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
















                        Last change: NFS                        2