docs-xml/smbdotconf/misc/widelinks.xml

   1 <samba:parameter name="wide links"
   2                  context="S"
   3                  type="boolean"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>This parameter controls whether or not links
   7         in the UNIX file system may be followed by the server. Links
   8         that point to areas within the directory tree exported by the
   9         server are always allowed; this parameter controls access only
  10         to areas that are outside the directory tree being exported.</para>
  11
  12         <para>Note: Turning this parameter on when UNIX extensions are enabled
  13         will allow UNIX clients to create symbolic links on the share that
  14         can point to files or directories outside restricted path exported
  15         by the share definition. This can cause access to areas outside of
  16         the share. Due to this problem, this parameter will be automatically
  17         disabled (with a message in the log file) if the
  18         <smbconfoption name="unix extensions"/> option is on.
  19         </para>
  20         <para>
  21         See the parameter <smbconfoption name="allow insecure wide links"/>
  22         if you wish to change this coupling between the two parameters.
  23         </para>
  24 </description>
  25
  26 <value type="default">no</value>
  27 </samba:parameter>