docs-xml/smbdotconf/misc/usersharepath.xml

   1 <samba:parameter name="usershare path"
   2                  context="G"
   3                  basic="1" advanced="1"
   4                  type="string"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7         <para>This parameter specifies the absolute path of the directory on the
   8         filesystem used to store the user defined share definition files.
   9         This directory must be owned by root, and have no access for
  10         other, and be writable only by the group owner. In addition the
  11         "sticky" bit must also be set, restricting rename and delete to
  12         owners of a file (in the same way the /tmp directory is usually configured).
  13         Members of the group owner of this directory are the users allowed to create
  14         usershares.
  15         </para>
  16         <para>
  17         For example, a valid usershare directory might be /usr/local/samba/lib/usershares,
  18         set up as follows.
  19         </para>
  20         <para>
  21         <programlisting>
  22         ls -ld /usr/local/samba/lib/usershares/
  23         drwxrwx--T  2 root power_users 4096 2006-05-05 12:27 /usr/local/samba/lib/usershares/
  24         </programlisting>
  25         </para>
  26         <para>
  27         In this case, only members of the group "power_users" can create user defined shares.
  28         </para>
  29
  30 </description>
  31 <value type="default">&pathconfig.STATEDIR;/usershares</value>
  32 </samba:parameter>