Improve vfs_linux_xfs_sgid manpage

- Add missing refpurpose and describe the "circumstances"
- Replace dangling link by archive.org backup
- Add fixed Linux version and commit link

Signed-off-by: Mathieu Parent <math.parent@gmail.com>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Garming Sam <garming@catalyst.net.nz>

diff --git a/docs-xml/manpages/vfs_linux_xfs_sgid.8.xml b/docs-xml/manpages/vfs_linux_xfs_sgid.8.xml
index 21f7fab9d0a6e483b6b640c0fbca4a048c635de6..2bc67e56a897ebfc34e0ed6c8b5dc1e6d93ee653 100644 (file)
--- a/docs-xml/manpages/vfs_linux_xfs_sgid.8.xml
+++ b/docs-xml/manpages/vfs_linux_xfs_sgid.8.xml
@@ -13,7 +13,7 @@
 
 <refnamediv>
        <refname>vfs_linux_xfs_sgid</refname>
-       <refpurpose></refpurpose>
+       <refpurpose>Workaround XFS sgid bit not inherited during mkdir with default acl on Linux older than 3.1</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -31,9 +31,12 @@
 
        <para>
        <command>vfs_linux_xfs_sgid</command> is a VFS module to work around an
-       old Linux XFS bug that still exists: Under certain circumstances the
-       SGID bit is not inherited (<ulink url="http://oss.sgi.com/bugzilla/show_bug.cgi?id=280">
-       http://oss.sgi.com/bugzilla/show_bug.cgi?id=280</ulink>).
+       old Linux XFS bug fixed in 3.11: the SGID bit is not inherited during mkdir
+       when a default ACL is set
+       (<ulink url="https://web.archive.org/web/20160320180937/http://oss.sgi.com/bugzilla/show_bug.cgi?id=280">
+       https://web.archive.org/web/20160320180937/http://oss.sgi.com/bugzilla/show_bug.cgi?id=280
+       </ulink> fixed by <ulink url="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=42c49d7f249c2487f36d3314753d5d8ebcee8249">
+       https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=42c49d7f249c2487f36d3314753d5d8ebcee8249</ulink>).
        The <command>vfs_linux_xfs_sgid</command> VFS module will work around this
        bug by manually setting the SGID bit after a <command>mkdir</command>
        if the parent directory had the SGID bit set.