docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / misc / followsymlinks.xml
blobdeca63466c51f2ddc79bae251915bd8b18059c36
1 <samba:parameter name="follow symlinks"
2                  context="S"
3                  type="boolean"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>
7         This parameter allows the Samba administrator to stop <citerefentry><refentrytitle>smbd</refentrytitle>
8         <manvolnum>8</manvolnum></citerefentry> from following symbolic links in a particular share. Setting this 
9         parameter to <constant>no</constant> prevents any file or directory that is a symbolic link from being 
10         followed (the user will get an  error).  This option is very useful to stop users from adding a symbolic 
11         link to <filename moreinfo="none">/etc/passwd</filename> in their home directory for instance.  However 
12         it will slow filename lookups down slightly.
13         </para>
15         <para>
16         This option is enabled (i.e. <command moreinfo="none">smbd</command> will follow symbolic links) by default.
17         </para>
18 </description>
19 <value type="default">yes</value>
20 </samba:parameter>