docs-xml/smbdotconf/misc/widelinks.xml

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