From patchwork Mon Dec 21 14:38:32 2009 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Suresh Jayaraman X-Patchwork-Id: 41552 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.samba.org (fn.samba.org [216.83.154.106]) by ozlabs.org (Postfix) with ESMTP id 2650BB6F15 for ; Tue, 22 Dec 2009 01:38:50 +1100 (EST) Received: from fn.samba.org (localhost [127.0.0.1]) by lists.samba.org (Postfix) with ESMTP id D0045AD0C0; Mon, 21 Dec 2009 07:40:25 -0700 (MST) X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on fn.samba.org X-Spam-Level: X-Spam-Status: No, score=-4.6 required=3.8 tests=AWL,BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.2.5 X-Original-To: linux-cifs-client@lists.samba.org Delivered-To: linux-cifs-client@lists.samba.org Received: from victor.provo.novell.com (victor.provo.novell.com [137.65.250.26]) by lists.samba.org (Postfix) with ESMTP id B91E2AD0A4 for ; Mon, 21 Dec 2009 07:40:19 -0700 (MST) Received: from localhost (prv-ext-foundry1int.gns.novell.com [137.65.251.240]) by victor.provo.novell.com with ESMTP; Mon, 21 Dec 2009 07:38:36 -0700 From: Suresh Jayaraman To: Steve French Date: Mon, 21 Dec 2009 20:08:32 +0530 Message-Id: <1261406312-7060-1-git-send-email-sjayaraman@suse.de> X-Mailer: git-send-email 1.6.4.2 Cc: linux-cifs-client@lists.samba.org, Jeff Layton Subject: [linux-cifs-client] [PATCH] doc: update mount.cifs man page with nounix option X-BeenThere: linux-cifs-client@lists.samba.org X-Mailman-Version: 2.1.12 Precedence: list List-Id: The Linux CIFS VFS client List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: linux-cifs-client-bounces@lists.samba.org Errors-To: linux-cifs-client-bounces@lists.samba.org Also add a section on INODE NUMBERS that discusses inode numbers more thoroughly and add reference to it in "nounix" and "noserverino" options. Thanks to Jeff Layton for explaining those details. Signed-off-by: Suresh Jayaraman --- docs-xml/manpages-3/mount.cifs.8.xml | 55 ++++++++++++++++++++++++++++++++- 1 files changed, 53 insertions(+), 2 deletions(-) diff --git a/docs-xml/manpages-3/mount.cifs.8.xml b/docs-xml/manpages-3/mount.cifs.8.xml index 372b477..ab389d9 100644 --- a/docs-xml/manpages-3/mount.cifs.8.xml +++ b/docs-xml/manpages-3/mount.cifs.8.xml @@ -477,12 +477,36 @@ permissions in memory that can't be stored on the server. This information can d noserverino - client generates inode numbers (rather than using the actual one - from the server) by default. + + + Client generates inode numbers (rather than + using the actual one from the server) by default. + + + See section INODE NUMBERS for + more information. + + nounix + + + Disable the CIFS Unix Extensions for this mount. This + can be useful in order to turn off multiple settings at once. + This includes POSIX acls, POSIX locks, POSIX paths, symlink + support and retrieving uids/gids/mode from the server. This + can also be useful to work around a bug in a server that + supports Unix Extensions. + + + See section INODE NUMBERS for + more information. + + + + nouser_xattr (default) Do not allow getfattr/setfattr to get/set xattrs, even if server would support it otherwise. @@ -533,6 +557,33 @@ permissions in memory that can't be stored on the server. This information can d + INODE NUMBERS + + When Unix Extensions are enabled, we use the actual inode + number provided by the server in response to the POSIX calls as an + inode number. + + + When Unix Extensions are disabled and "serverino" mount option + is enabled there is no way to get the server inode number. The + client typically maps the server-assigned "UniqueID" onto an inode + number. + + + Note that the UniqueID is a different value from the server + inode number. The UniqueID value is unique over the scope of the entire + server and is often greater than 2 power 32. This value often makes + programs that are not compiled with LFS (Large File Support), to + trigger a glibc EOVERFLOW error on 32 bit machines as this won't fit + in the target structure field. It is strongly recommended to compile + your programs with LFS support (i.e. with -D_FILE_OFFSET_BITS=64) to + prevent this problem. You can also use "noserverino" mount option to + generate inode numbers smaller than 2 power 32 on the client. But you + may not be able to detect hardlinks properly. + + + + FILE AND DIRECTORY OWNERSHIP AND PERMISSIONS The core CIFS protocol does not provide unix ownership