[linux-cifs-client] [PATCH] doc: add information about nounix mount option
Jeff Layton
jlayton at redhat.com
Fri Dec 18 05:52:12 MST 2009
On Fri, 18 Dec 2009 18:02:20 +0530
Suresh Jayaraman <sjayaraman at 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 at 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>
--
Jeff Layton <jlayton at redhat.com>
More information about the linux-cifs-client
mailing list