man/man8/share.8

         te
 Copyright (c) 2000 Sun Microsystems, Inc. All Rights Reserved
 Copyright 1989 AT&T
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 SHARE 8 "Jan 23, 2007"
 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\(emthe 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.