docs-xml/manpages/vfs_linux_xfs_sgid.8.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="vfs_linux_xfs_sgid.8">
   4
   5 <refmeta>
   6         <refentrytitle>vfs_syncops</refentrytitle>
   7         <manvolnum>8</manvolnum>
   8         <refmiscinfo class="source">Samba</refmiscinfo>
   9         <refmiscinfo class="manual">System Administration tools</refmiscinfo>
  10         <refmiscinfo class="version">&doc.version;</refmiscinfo>
  11 </refmeta>
  12
  13
  14 <refnamediv>
  15         <refname>vfs_linux_xfs_sgid</refname>
  16         <refpurpose>Workaround XFS sgid bit not inherited during mkdir with default acl on Linux older than 3.1</refpurpose>
  17 </refnamediv>
  18
  19 <refsynopsisdiv>
  20         <cmdsynopsis>
  21                 <command>vfs objects = linux_xfs_sgid</command>
  22         </cmdsynopsis>
  23 </refsynopsisdiv>
  24
  25 <refsect1>
  26         <title>DESCRIPTION</title>
  27
  28         <para>This VFS module is part of the
  29         <citerefentry><refentrytitle>samba</refentrytitle>
  30         <manvolnum>7</manvolnum></citerefentry> suite.</para>
  31
  32         <para>
  33         <command>vfs_linux_xfs_sgid</command> is a VFS module to work around an
  34         old Linux XFS bug fixed in 3.11: the SGID bit is not inherited during mkdir
  35         when a default ACL is set
  36         (<ulink url="https://web.archive.org/web/20160320180937/http://oss.sgi.com/bugzilla/show_bug.cgi?id=280">
  37         https://web.archive.org/web/20160320180937/http://oss.sgi.com/bugzilla/show_bug.cgi?id=280
  38         </ulink> fixed by <ulink url="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=42c49d7f249c2487f36d3314753d5d8ebcee8249">
  39         https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=42c49d7f249c2487f36d3314753d5d8ebcee8249</ulink>).
  40         The <command>vfs_linux_xfs_sgid</command> VFS module will work around this
  41         bug by manually setting the SGID bit after a <command>mkdir</command>
  42         if the parent directory had the SGID bit set.
  43         </para>
  44
  45         <para>This module is stackable.</para>
  46
  47 </refsect1>
  48
  49 <refsect1>
  50         <title>EXAMPLES</title>
  51
  52         <para>Add syncops functionality for [share]:</para>
  53 <programlisting>
  54         <smbconfsection name="[share]"/>
  55         <smbconfoption name="vfs objects">linux_xfs_sgid</smbconfoption>
  56 </programlisting>
  57
  58 </refsect1>
  59
  60 <refsect1>
  61         <title>VERSION</title>
  62
  63         <para>This man page is part of version &doc.version; of the Samba suite.
  64         </para>
  65 </refsect1>
  66
  67 <refsect1>
  68         <title>AUTHOR</title>
  69
  70         <para>The original Samba software and related utilities
  71         were created by Andrew Tridgell. Samba is now developed
  72         by the Samba Team as an Open Source project similar
  73         to the way the Linux kernel is developed.</para>
  74
  75 </refsect1>
  76
  77 </refentry>