share(1M)

NAME

share — make local resource available for mounting by remote systems

SYNOPSIS

/usr/sbin/share [-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(1M).

pathname is the pathname of the directory to be shared. When invoked with no arguments, share displays all shared file systems.

Options

share recognizes the following options:

-F FStype

Specify the file system type.

-o specific_options

The specific_options are used to control access of the shared resource. (See share_nfs(1M) for 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] ...: Share the pathname read-mostly if sec= option is not provided. Read-mostly means read-write to those clients specified and read-only for all other systems. If a sec= option is provided, 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.

-d description

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

WARNINGS

Old terminology (export)

File system sharing used to be called exporting on HP-UX, and exportfs was used for exporting file systems. With the new share NFS model, the share command replaces exportfs(1M) or /usr/sbin/exportfs.

If share commands are invoked multiple times on the same file system, the last share invocation supersedes the previous; the options set by the last share command replace the old options. For example, if read-only permission was previously given to usera on somefs, use the following share command to also give read-only permission to userb on somefs:

share -F nfs -o ro=usera:userb /somefs 

This behavior is not limited to sharing the root file system, but applies to all file systems.

EXAMPLES

The following command wll share the disk file system read-only.

share -F nfs -o ro /disk 

FILES

/etc/dfs/dfstab: list of share commands to be executed at boot time
/etc/dfs/fstypes: list of distributed file system types, NFS by default
/etc/dfs/sharetab: system record of shared file systems

AUTHOR

share was developed by Sun Microsystems, Inc.