System Administration Commands                          share(1M)



NAME
     share - make local resource available for mounting by remote
     systems

SYNOPSIS
     share [-p] [-F FSType] [-o specificoptions] [-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  sharenfs(1M).
     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 specificoptions

         The specificoptions are used to control access  of  the
         shared resource. (See sharenfs(1M) 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.



SunOS 5.11          Last change: 23 Jan 2007                    1






System Administration Commands                          share(1M)



         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=netgroupname,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.





SunOS 5.11          Last change: 23 Jan 2007                    2






System Administration Commands                          share(1M)



     /etc/dfs/sharetab

         System record of shared file systems.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


SEE ALSO
     mountd(1M),    nfsd(1M),    sharenfs(1M),     shareall(1M),
     unshare(1M), attributes(5)

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  permis-
     sion 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.














SunOS 5.11          Last change: 23 Jan 2007                    3