Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

share(8)

Name

share - display file system shares or make local file system available for mounting by remote systems

Synopsis

share [-F protocol] -a
share [-F protocol] [-o options] [-d description] pathname [sharename]
share [-F protocol] [-A]

Description

The share command defines and publishes a file system share, which means the file system is available for mounting through a sharing protocol.

If the –F protocol option is omitted, the first file sharing protocol listed in /etc/dfs/fstypes is used as the default.

For a description of NFS-specific share options, see share_nfs(8) man page. For a description of SMB specific share options, see share_smb(8) man page.

Using the share command to define and publish an NFS or SMB share of a ZFS file system is considered a legacy operation. Consider setting the share.nfs property or using the zfs share command to define and publish an NFS or an SMB share of a ZFS file system. For more information, see share_nfs(8) and share_smb(8) man pages.

In the third form of share command, as shown in the Synopsis above, share displays published shares or, with the –A option, displays all configured (defined) shares.

Options

–F protocol

Specify the file sharing protocol.

–o specific_options
rw

Share pathname is published with read and write access to all clients. This is the default behavior.

rw=client[:client]...

Share pathname is published with read and write access only to the listed clients. No other systems can access the share pathname.

ro

Share pathname is published with read-only access to all clients.

ro=client[:client]...

Share pathname is published with read-only access only to the listed clients. No other systems can access the share pathname.

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

–d

Provide a comment that describes the file system share to be published.

–a

Publish all defined shares.

–A

Display all defined shares.

Examples

Example 1 Publishing an NFS Share With Read-Only Access

The following command defines and publishes an NFS share of /ufsfs with read-only access.

# share -F nfs -o ro /ufsfs
Example 2 Publishing an NFS Share with Multiple Share Options

The following command defines and publishes an NFS share of the /export/manuals file system with a netgroup called users_nfs who have read-only access and users from specified hosts who have read and write access.

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

Files

/etc/dfs/dfstab

This file is obsolete. An SMF service publishes NFS or SMB shares at boot time.

/etc/dfs/fstypes

List of file-sharing protocols. NFS is the default file sharing protocol.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/core-os

See Also

attributes(7), mountd(8), nfsd(8), share_nfs(8), share_smb(8), shareall(8), unshare(8), zfs(8), zfs_share(8)

Notes

If share commands are invoked multiple times on the same file system, the last share invocation supersedes the previous invocation. The options set by the last share command replace the old options. For example, if read-write permission was granted to usera on the legacy /somefs file system, then you want to grant read-write permission also to userb on /somefs, use the following syntax:

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