Patchwork doc: add information about nounix mount option

login
register
mail settings
Submitter Suresh Jayaraman
Date Dec. 18, 2009, 12:32 p.m.
Message ID <1261139540-9485-1-git-send-email-sjayaraman@suse.de>
Download mbox | patch
Permalink /patch/41399/
State New
Headers show

Comments

Suresh Jayaraman - Dec. 18, 2009, 12:32 p.m.
Also clarify the use of UniqueID when serverino is used with nounix.
Thanks to Jeff Layton for explaining the no so clear details.

Signed-off-by: Suresh Jayaraman <sjayaraman@suse.de>
---
 docs-xml/manpages-3/mount.cifs.8.xml |   17 +++++++++++++++++
 1 files changed, 17 insertions(+), 0 deletions(-)
Jeff Layton - Dec. 18, 2009, 12:52 p.m.
On Fri, 18 Dec 2009 18:02:20 +0530
Suresh Jayaraman <sjayaraman@suse.de> wrote:

> Also clarify the use of UniqueID when serverino is used with nounix.
> Thanks to Jeff Layton for explaining the no so clear details.
> 
> Signed-off-by: Suresh Jayaraman <sjayaraman@suse.de>
> ---
>  docs-xml/manpages-3/mount.cifs.8.xml |   17 +++++++++++++++++
>  1 files changed, 17 insertions(+), 0 deletions(-)
> 
> diff --git a/docs-xml/manpages-3/mount.cifs.8.xml b/docs-xml/manpages-3/mount.cifs.8.xml
> index 372b477..aa62334 100644
> --- a/docs-xml/manpages-3/mount.cifs.8.xml
> +++ b/docs-xml/manpages-3/mount.cifs.8.xml
> @@ -483,6 +483,23 @@ permissions in memory that can't be stored on the server. This information can d
>          </varlistentry>
>  
>          <varlistentry>
> +		<term>nounix</term>
> +		<listitem><para>Disable the CIFS Unix Extensions for this
> +		mount. This can be useful in order to turn off multiple settings
> +		all at once (i.e. POSIX acls, POSIX locks, POSIX paths, symlink
		^^^
		the "all" should be removed here. Maybe this should be
		a new sentence too "This includes POSIX ACLs, POSIX locks..."

> +		support and retrieving uids/gids/mode from the server) or to
> +		workaround a bug in server that support the Unix Extensions.
		^^^^^^^^^^
		work around a bug in a server that supports Unix Extensions.
> +		</para>
> +		<para>
> +		When Unix Extensions are disabled and "serverino" mount option
> +		is enabled there is no way to get the server inode number.
> +		So a "UniqueID" from the server is used, instead. UniqueID's are
> +		often greater than 2 power 32. To avoid this make sure you
> +		build your programs with LFS support.
> +		</para></listitem>
		
I wonder whether it wouldn't be better to add the second paragraph to a
new manpage section that discusses inode numbers more thoroughly. Maybe
a new "INODE NUMBERS" section below the "SERVICE FORMATTING AND
DELIMITERS" section. Then you could have the "nounix" and "serverino"
options refer to that section.

> +        </varlistentry>
> +
> +        <varlistentry>
>                  <term>nouser_xattr</term>
>                  <listitem><para>(default) Do not allow getfattr/setfattr to get/set xattrs, even if server would support it otherwise. </para></listitem>
>          </varlistentry>

Patch

diff --git a/docs-xml/manpages-3/mount.cifs.8.xml b/docs-xml/manpages-3/mount.cifs.8.xml
index 372b477..aa62334 100644
--- a/docs-xml/manpages-3/mount.cifs.8.xml
+++ b/docs-xml/manpages-3/mount.cifs.8.xml
@@ -483,6 +483,23 @@  permissions in memory that can't be stored on the server. This information can d
         </varlistentry>
 
         <varlistentry>
+		<term>nounix</term>
+		<listitem><para>Disable the CIFS Unix Extensions for this
+		mount. This can be useful in order to turn off multiple settings
+		all at once (i.e. POSIX acls, POSIX locks, POSIX paths, symlink
+		support and retrieving uids/gids/mode from the server) or to
+		workaround a bug in server that support the Unix Extensions.
+		</para>
+		<para>
+		When Unix Extensions are disabled and "serverino" mount option
+		is enabled there is no way to get the server inode number.
+		So a "UniqueID" from the server is used, instead. UniqueID's are
+		often greater than 2 power 32. To avoid this make sure you
+		build your programs with LFS support.
+		</para></listitem>
+        </varlistentry>
+
+        <varlistentry>
                 <term>nouser_xattr</term>
                 <listitem><para>(default) Do not allow getfattr/setfattr to get/set xattrs, even if server would support it otherwise. </para></listitem>
         </varlistentry>