share(1M)                                                         share(1M)

NAME
     share - make local NFS resources available

SYNOPSIS
     share [-o specificoptions] [-d description] [pathname]

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

     If share is called without arguments, it displays all the NFS
     resources which have been made available.

OPTIONS
     -o specificoptions
          The following options can be specified in a comma-delimited list.

          rw   All clients have read and write access to the resource.

          rw=client[:client]...
               Only the listed clients have read and write access to the
               resource.

          ro   All clients have read-only access to the resource.

          ro=client[:client]...
               Only the listed clients have read-only access to the
               resource.

          anon=uid
               The client superuser UID is set to uid on the server for
               every NFS job. If this option is not specified, the client
               superuser UID is set to UIDNOBODY (60001) on the server. If
               uid is -1, all NFS requests from the client superuser are
               rejected.

          root=host[:host]...
               The superusers of the specified systems are assigned
               superuser rights for their NFS jobs on the server also.

          async
               Write requests from clients using the NFS protocol version 2
               are executed asynchronously.

          mknod
               Clients can create device nodes on the server.

          If no specific options are specified, all clients are permitted
          read and write access to the resources which have been made
          available.





Page 1                       Reliant UNIX 5.44                Printed 11/98

share(1M)                                                         share(1M)

     -d description
          Comment describing the resource.

     pathname
          Pathname of the resource.

NOTES
     The options ro and rw cannot both be specified at the same time. If
     the same client name occurs both in an ro= list and in a rw= list, the
     client is assigned both read and write access to the resource. If an
     ro= list and a root= list are both specified, every client in the
     root= list is assigned read access only, irrespective of whether it is
     also contained in the ro= list or not, unless the resource is made
     available explicitly with rw or if the client appears in an -rw=.

     Example:

          share -oro=hosta,root=hostb /var

     grants hostb read-only access to the resource /var, whereas

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

     grants hostb read and write access to /var.

     Although two variants of the share command exist in the operating sys-
     tem, i.e. as a DFS command (generic layer of commands for distributed
     file systems) and as an NFS command, it will only be documented once
     to avoid confusion: However, NFS is the only distributed file system
     available in Reliant UNIX.

     Nevertheless, when share is called, the DFS share command is executed
     first for compatibility reasons, which then in turn executes the NFS
     share command described here. The DFS share command can also interpret
     the -F fstype option. However, only nfs can be specified for fstype.

FILES
     /etc/dfs/sharetab

SEE ALSO
     unshare(1M).













Page 2                       Reliant UNIX 5.44                Printed 11/98