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