diff options
| author | Jeff Layton <jlayton@samba.org> | 2012-09-25 11:07:08 -0400 |
|---|---|---|
| committer | Jeff Layton <jlayton@samba.org> | 2012-09-25 11:07:08 -0400 |
| commit | 67e0f46bfc39d280986f20c7074039151cb188ba (patch) | |
| tree | d19b372dc2617658dc54f1f06aa94954f1816410 /mount.cifs.8 | |
| parent | 82f93c44343f281ce61f547ff8f9e5f79945cb20 (diff) | |
| download | cifs-utils-67e0f46bfc39d280986f20c7074039151cb188ba.tar.gz cifs-utils-67e0f46bfc39d280986f20c7074039151cb188ba.tar.bz2 cifs-utils-67e0f46bfc39d280986f20c7074039151cb188ba.zip | |
manpage: clarify usage of the username= option
Specifying the username as "user=" can confuse some versions of /bin/mount,
and cause it to append noexec to the mount string. Also, remove the blurb
about how cifs.ko will accept abbreviations -- it's just bad practice since
it leads to these sorts of conflicts.
A wonderful example of this confusion was reported by Stefan here:
https://bugzilla.redhat.com/show_bug.cgi?id=860154
Reported-by: Stefan Walter <walteste@inf.ethz.ch>
Signed-off-by: Jeff Layton <jlayton@samba.org>
Diffstat (limited to 'mount.cifs.8')
| -rw-r--r-- | mount.cifs.8 | 24 |
1 files changed, 2 insertions, 22 deletions
diff --git a/mount.cifs.8 b/mount.cifs.8 index cca6048..a4fdd98 100644 --- a/mount.cifs.8 +++ b/mount.cifs.8 @@ -52,33 +52,13 @@ command displays the version of cifs mount helper\&. command displays the version of cifs module\&. .SH "OPTIONS" .PP -user=\fIarg\fR +username=\fIarg\fR .RS 4 specifies the username to connect as\&. If this is not given, then the environment variable \fIUSER\fR is used\&. .PP -Earlier versions of mount.cifs also allowed one to specify the username in a "user%password" or "workgroup/user" or "workgroup/user%password" to allow the password and workgroup to be specified as part of the username. Support for those alternate username formats is now deprecated and should no longer be used. Users should use the discrete "pass=" and "dom=" to specify the username. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -The cifs vfs accepts the parameter -\fIuser=\fR, or for users familiar with smbfs it accepts the longer form of the parameter -\fIusername=\fR\&. Similarly the longer smbfs style parameter names may be accepted as synonyms for the shorter cifs parameters -\fIpass=\fR,\fIdom=\fR -and -\fIcred=\fR\&. -.sp .5v -.RE +Earlier versions of mount.cifs also allowed one to specify the username in a "user%password" or "workgroup/user" or "workgroup/user%password" to allow the password and workgroup to be specified as part of the username. Support for those alternate username formats is now deprecated and should no longer be used. Users should use the discrete "password=" and "domain=" to specify those values. While some versions of the cifs kernel module accept "user=" as an abbreviation for this option, its use can confuse the standard mount program into thinking that this is a non-superuser mount. It is therefore recommended to use the full "username=" option name. .RE .PP password=\fIarg\fR |