NAME

share_nfs − make local NFS resources 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. 

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

anon=uid
Set uid to be the effective user ID of unauthenticated users ( AUTH_DES or AUTH_KERB authentication), 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 opton (above) for information about how unauthenticated requests are handled. 

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

−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), 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 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

Sun Microsystems  —  Last change: 5 Jul 1990