Re: [PATCH] doc: add information about nounix mount option

On Fri, 18 Dec 2009 18:02:20 +0530
Suresh Jayaraman <[email protected]> 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 <[email protected]>
> ---
>  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>


-- 
Jeff Layton <[email protected]>