SHARE(8) Maintenance Commands and Procedures SHARE(8)

NAME

share - make local resource available for mounting by remote systems

SYNOPSIS

share [-p] [-F FSType] [-o specific_options] [-d description]
[pathname]

DESCRIPTION

The share command exports, or makes a resource available for mounting,
through a remote file system of type FSType. If the option -F FSType is
omitted, the first file system type listed in /etc/dfs/fstypes is used as
default. For a description of NFS specific options, see share_nfs(8).
pathname is the pathname of the directory to be shared. When invoked with
no arguments, share displays all shared file systems.

OPTIONS

-d description

The -d flag may be used to provide a description of the resource
being shared.


-F FSType

Specify the filesystem type.


-o specific_options

The specific_options are used to control access of the shared
resource. (See share_nfs(8) for the NFS specific options.) They may
be any of the following:

rw

pathname is shared read/write to all clients. This is also the
default behavior.


rw=client[:client]...

pathname is shared read/write only to the listed clients. No
other systems can access pathname.


ro

pathname is shared read-only to all clients.


ro=client[:client]...

pathname is shared read-only only to the listed clients. No other
systems can access pathname.

Separate multiple options with commas. Separate multiple operands for
an option with colons. See EXAMPLES.


-p

Causes the share operation to persist across reboots.

EXAMPLES

Example 1: Sharing a Read-Only Filesystem

This line will share the /disk file system read-only at boot time.


share -F nfs -o ro /disk

Example 2: Invoking Multiple Options

The following command shares the filesystem /export/manuals, with members
of the netgroup having read-only access and users on the specified host
having read-write access.


share -F nfs -o ro=netgroup_name,rw=host1:host2:host3 /export/manuals

FILES

/etc/dfs/dfstab

List of share commands to be executed at boot time. Note that you can
invoke share from a command line and use the -p option, described
above, as an alternative to editing this file.


/etc/dfs/fstypes

List of file system types; NFS is the default.


/etc/dfs/sharetab

System record of shared file systems.

SEE ALSO

attributes(7), mountd(8), nfsd(8), share_nfs(8), shareall(8), unshare(8)

NOTES

Export (old terminology): file system sharing used to be called exporting
on SunOS 4.x, so the share command used to be invoked as exportfs(1B) or
/usr/sbin/exportfs.


If share commands are invoked multiple times on the same filesystem, the
last share invocation supersedes the previous--the options set by the
last share command replace the old options. For example, if read-write
permission was given to usera on /somefs, then to give read-write
permission also to userb on /somefs:


example% share -F nfs -o rw=usera:userb /somefs


This behavior is not limited to sharing the root filesystem, but applies
to all filesystems.

January 23, 2007 SHARE(8)