share_nfs(1M)         Maintenance Commands          share_nfs(1M)



NAME
     share_nfs - make local NFS filesystems available for  mount-
     ing by remote systems

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

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

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

OPTIONS
     -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.

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

          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.  Netgroup names may  be  used  in  place  of
               client  names  unless the list is used to override
               an ro option.

          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.  Netgroup names may  be  used  in  place  of
               client  names  unless the list is used to override
               an rw option.

          anon=uid
               Set uid to be the effective user ID of unauthenti-
               cated  users  (AUTH_DES  or  AUTH_KERB authentica-
               tion), or to be root if  AUTH_UNIX  authentication
               is  used.  By default, unknown users are given the
               effective user ID UID_NOBODY.  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 to be authenticated.  AUTH_UNIX authentication
               is the default.  See the anon=uid  option  (above)
               for information about how unauthenticated requests
               are handled.

          nosuid
               By default, clients are allowed to create files on
               the  shared  file system with the setuid or setgid
               mode enabled.  Specifying nosuid causes the server
               file  system  to  silently  ignore  any attempt to
               enable the setuid or setgid mode bits.

          kerberos
               Clients must use the AUTH_KERB  authentication  of
               RPC to be authenticated.  AUTH_UNIX authentication
               is the default.  See the anon=uid  option  (above)
               for information about how unauthenticated requests
               are handled.

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

     pathname       Specify the pathname of the filesystem to  be
                    shared.

FILES
     /etc/dfs/fstypes    list of system types, NFS by default
     /etc/dfs/sharetab   system record of shared file systems

SEE ALSO
     unshare(1M), share(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 filesystem is shared with an 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 an rw= list. The same is  true  if  the
     filesystem  is  shared  with ro as the default. For example,
     the following share commands will give read-only permissions
     to hostb:

          share -F nfs -o ro=hosta,root=hostb /var

          share -F nfs -o ro,root=hostb /var

     The following will give read/write permissions to hostb:

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

          share -F nfs -o root=hostb /var

     If the filesystem being shared is a symbolic link to a valid
     pathname,  the  canonical  path (the path which the symbolic
     link follows) will be shared.

     For  example,  if  /export/foo  is  a   symbolic   link   to
     /export/bar  (/export/foo  ->  /export/bar),  the  following
     share command will result in /export/bar as the shared path-
     name (and not /export/foo).

          example# share -F nfs /export/foo

     Note that an NFS mount of server:/export/foo will result  in
     server:/export/bar really being mounted.

SunOS 5.4           Last change: 22 Feb 1994