sharing(1) Mac OS X Server Manual Page

Mac Dev Center Mac OS X Reference Library General Mac OS X Man Pages

This manual page is for Mac OS X Server version 10.6.3

If you are running Mac OS X (client), this command is not available.

If you are running a different version of Mac OS X Server, view the documentation locally:

In Xcode
In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

For more information about the manual page format, see the manual page for manpages(5).
For more information about this technology, look for other documentation in the Apple Reference Library.
For general information about writing shell scripts, read Shell Scripting Primer.


sharing(1)                               BSD General Commands Manual                              sharing(1)

NAME
     sharing -- create share points for afp, ftp and smb services.

SYNOPSIS
     sharing [-a <path> [options]] [-e <share point name> [options]] [-r <share point name>      ]
             [-l                       ]

DESCRIPTION
     A list of flags and their descriptions:

     -a <path>
              add a new share point for the directory specified by <path>.

     -e <share point name>
              edit the share point record specified by <share point name>.

     -r <share point name>
              delete the share point record specified by <share point name>.

     -l       list all existing share point records.

     Description of options The following options modify share point record attributes

     -A <afp name>
              use customized name <afp name> when using share point with afp.

     -F <ftp name>
              use customized name <ftp name> when using share point with ftp.

     -S <smb name>
              use customized name <smb name> when using share points with smb.

     -s <flags>
              use this option to modify individually, the sharing attribute for afp, ftp and smb.  By
              default a share point record is enabled for afp, ftp and smb.  To modify the indiviual
              attributes AND the following flags as required: 100 (enable sharing for afp only), 010 (enable
              sharing for ftp only), 001 (enable sharing for smb only). Specify 000 to turn off sharing of a
              share point all together.  use customized name <smb name> when using share points with smb.

     -g <guest flag>
              use this option to modify individually, the "guest" attribute for afp, ftp and smb.  The
              "guest" attribute specifies whether a service will allow guest access to this share point
              record.  By default a "guest" is enabled for afp, ftp and smb.  To modify the attribute, AND
              the following <guest flags> as required: 100 (enable guest access for afp only), 010 (enable
              guest access for ftp only), 001 (enable guest access for smb only). Specify 000 to turn off
              guest access for the share point all together.

     -i <inherit privileges flag>
              use this option to modify individually, the "inherit privileges" attribute for afp and smb.
              The "inherit privileges" attribute specifies whether a afp and smb will apply the classic
              privilege model to operations within this share point.  By default "inherit privileges" is
              disabled for afp and smb.  To modify the "inherit privileges", AND the following <guest flags>
              as required: 10 (enable "inherit privileges" for afp only), 01 (enable "inherit privileges"
              for smb only).  Specify 00 to turn off "inherit privileges" for the share point all together.

     -c <creation mask>
              specify a creation mask (for smb).  By default this value is set to 0644.

     -d <directory mask>
              specify a directory mask (for smb).  By default this value is set to 0755.

     -o <oplock flag>
              enable/disable oplocks (for smb).  The <oplock flag> is 1 (enable) or 0 (disable).  By default
              oplocks are disabled.

     -t <strict locking flag>
              enable/disable strict locking (for smb).  By default this value is set to 0755.  The <strict
              locking flag> is 1 (enable) or 0 (disable).  By default "strict locking" is disabled.

     -n <customized record name>
              Specify a <customized record name> to be used as the share point record name.  By default the
              record name is the name of the directory pointed to by the share point record.  This directory
              is specified bt the <path> when the record is created.

EXAMPLES
           /usr/sbin/sharing -a /SomePath/ShareThisDirectory

     This example shows how create a share point record for the directory "/SomePath/ShareThisDirectory".

           /usr/sbin/sharing -e ShareThisDirectory -A SP1 -g 101

     This example shows how to edit the share point record created above, adding a customized name "SP1" for
     afp servies, and enabling guest access only for afp and smb.

FILES
     /usr/sbin/sharing                             location of tool

Mac OS X Server                                 May 12, 2010                                 Mac OS X Server

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors: Report errors in the content of this documentation with the feedback links below.
Bug reports: Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems: Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you?