share(1M)                     UNIX System V(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.





10/89                                                                    Page 1

share(1M)                     UNIX System V(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                                                                    10/89