summaryrefslogtreecommitdiff
path: root/mount.cifs.8
AgeCommit message (Collapse)AuthorFilesLines
2017-10-03man: generate all man pages from POD files when buidlingAurelien Aptel1-856/+0
Move all man pages to easily editable POD files and generate troff source when building. Previous .in troff file are still preprocessed before final generation to use configured path (.pod.in -> .pod -> troff). All temporary files (.pod.in and troff sources) are properly deleted on clean. Remove all troff file, no need to keep generated copies under source control. This commit does not change the content of the man pages but makes future editing easier. Adds a new --enable-man/--disable-man configure option to control the generation and installation of man pages. The option is automatically enabled if the system supports it. Explicitly enabling it will make the configure script fail if pod2man is not installed. Signed-off-by: Aurelien Aptel <aaptel@suse.com>
2017-04-22mount.cifs: document SMBv3.1.1 and new seal optionAurelien Aptel1-0/+16
Signed-off-by: Aurelien Aptel <aaptel@suse.com>
2017-03-16manpage: correct typos and spelling mistakesAurelien Aptel1-9/+9
Signed-off-by: Aurelien Aptel <aaptel@suse.com>
2017-01-04manpage: document mfsymlinks in the mount.cifs man pageSachin Prabhu1-0/+5
Information from the cifs README in the kernel sources is used. Signed-off-by: Sachin Prabhu <sprabhu@redhat.com>
2016-01-07manpage: clarify use of backupuid and backupgid in mount.cifs.8Uri Simchoni1-3/+3
Assert that backup intent shall only be attempted if the user matches the backupuid or backupgid parameter. Signed-off-by: Uri Simchoni <uri@samba.org> Signed-off-by: Jeff Layton <jlayton@samba.org>
2013-07-08manpage: fix nouser_xattr descriptionJeff Layton1-1/+1
The manpage erroneously states that nouser_xattr is the default, when it's actually the reverse. Reported-by: Dome <domfe@tiscali.it> Signed-off-by: Jeff Layton <jlayton@samba.org>
2013-03-20manpage: better document the default sec= mount optionJeff Layton1-9/+11
The default changed in mainline kernel v3.8. Signed-off-by: Jeff Layton <jlayton@samba.org>
2013-03-16manpage: document the mount.cifs vers= optionJeff Layton1-0/+51
Thanks to Tom Talpey for clarifying some of the info here. Cc: Tom Talpey <ttalpey@microsoft.com> Signed-off-by: Jeff Layton <jlayton@samba.org>
2012-09-25manpage: clarify usage of the username= optionJeff Layton1-22/+2
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>
2012-08-21cifs-utils: fix up references to getcifsacl and setcifsacl filesJeff Layton1-3/+3
When I moved the manpages for this to section 1, I missed some references to them. Also, get rid of the unneeded clean-local-aclprogs makefile target. Signed-off-by: Jeff Layton <jlayton@samba.org>
2012-08-07mount.cifs: deprecate the DOMAIN/username%password username syntaxJeff Layton1-1/+3
mount.cifs has in the past allowed users to specify a username using the above syntax, which would populate the domain and password fields with the different pieces. Unfortunately, there are cases where it is legit to have a '/' in a username. krb5 SPNs generally contain a '/' and we have no clear way to distinguish between the two. I don't see any real value in keeping that syntax allowed. It's no easier than specifying "pass=" and "domain=" on the command line. Ditto for credential files. Begin the transition away from that syntax by adding a warning message that support for it will be removed in 5.9. Signed-off-by: Jeff Layton <jlayton@samba.org>
2012-05-21manpage: document the cache= option and mark strictcache and directio asJeff Layton1-0/+100
being deprecated ...also add a CACHE COHERENCY section so that we can explain cifs' behavior in detail. Signed-off-by: Jeff Layton <jlayton@samba.org>
2012-04-02mount.cifs: don't allow unprivileged users to mount onto dirs to which theyJeff Layton1-1/+2
can't chdir If mount.cifs is installed as a setuid root program, then a user can use it to gather information about files and directories to which he does not have access. One of the first things that mount.cifs does is to chdir() into the mountpoint and then proceeds to perform the mount onto ".". A malicious user could exploit this fact to determine information about directories to which he does not have access. Specifically, whether the dentry in question is a file or directory and whether it exists at all. This patch fixes this by making the program switch the fsuid to the real uid for unprivileged users when mounting. Note that this is a behavior change. mount.cifs has in the past allowed users to mount onto any directory as long as it's listed in /etc/fstab as a user mount. With this change, the user must also be able to chdir into the mountpoint without needing special privileges. Hopefully not many people have such a pathological configuration. This patch should fix CVE-2012-1586. Reported-by: Jesus Olmos <jesus.olmos@blueliv.com> Signed-off-by: Jeff Layton <jlayton@samba.org>
2012-02-20manpage: update wsize= entry to account for change in default wsizeJeff Layton1-1/+3
Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-12-05manpage: add an entry for prefixpath= to the mount.cifs manpageJeff Layton1-0/+5
Reported-by: Sumit Bose <sbose@redhat.com> Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-10-19manpage: document new rsize= behaviorJeff Layton1-2/+2
With the addition of async readpages in 3.2 kernels, the behavior of the rsize= option has changed. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-10-19manpage: cleanups to new backupuid/gid sectionsJeff Layton1-9/+5
Minor cleanups and consistency fixes... Cc: Shirish Pargaonkar <shirishpargaonkar@gmail.com> Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-10-19mount.cifs: Add mount options for backup intent and their manpages (try #8)Shirish Pargaonkar1-0/+40
Add mount options backupuid and backugid and their manpage contents. Check for either a valid uid/gid or valid user/group name. Signed-off-by: Shirish Pargaonkar <shirishpargaonkar@gmail.com>
2011-09-24acltools: install them in $bindir, not $sbindirJeff Layton1-1/+1
Move the manpages to section 1 since getcifsacl and setcifsacl are user, not sysadmin tools. Get rid of the useless sed calls on the manpages. They don't have any explicit paths in them that need replacing. Also get rid of the "4.0" in the footers of all the manpages. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-09-23manpage: document sec=ntlmssp(i) and clean up discussion of signingJeff Layton1-4/+26
Acked-by: Shirish Pargaonkar <shirishpargaonkar@gmail.com> Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-08-25cifsacl: Change contents of mount.cifs manpage (try #2)Shirish Pargaonkar1-1/+1
State getcifsacl and setcifsacl utilities to manipulate get/set xattr blob respectively. Signed-off-by: Shirish Pargaonkar <shirishpargaonkar@gmail.com>
2011-07-19manpage: corrections and cleanups to the cifsacl option sectionsJeff Layton1-12/+12
..also update the part that describes what kernel version this manpage is accurate against. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-07-18manpages: add contents for mount option cifsacl (try #3)Shirish Pargaonkar1-0/+90
Manpage contents for cifs mount option cifsacl Signed-off-by: Shirish Pargaonkar <shirishpargaonkar@gmail.com>
2011-07-12manpage: add some missing options to mount.cifs.8Jeff Layton1-1/+25
Clarify servernetbiosname parameter name, add mention of ignorecase, and add a section on noposixpaths. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-05-30manpage: change mention of kernel 2.6.40 to 3.0.0Jeff Layton1-1/+1
...to match the change in versioning. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-05-30manpage: add entry for rwpidforward optionPavel Shilovsky1-0/+5
Signed-off-by: Pavel Shilovsky <piastry@etersoft.ru>
2011-05-30manpage: add decription about matching superblock to wsize= optionPavel Shilovsky1-1/+1
...according to shared superblock capability merged into cifs-2.6 git tree recently. Signed-off-by: Pavel Shilovsky <piastry@etersoft.ru>
2011-05-26manpage: update the description of the wsize= optionJeff Layton1-2/+2
...to account for the changes in the async write patchset. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-05-20manpage: make serverino and noserverino option descriptions clearPavel Shilovsky1-2/+2
Signed-off-by: Pavel Shilovsky <piastry@etersoft.ru>
2011-03-15manpage: add entry for strictcache optionPavel Shilovsky1-0/+5
Signed-off-by: Pavel Shilovsky <piastry@etersoft.ru>
2011-01-14manpage: fix the SEE ALSO sectionJeff Layton1-1/+1
It references umount.cifs(8) which is no longer shipped as part of cifs-utils. Replace it with a reference to cifs.upcall(8) instead. Signed-off-by: Jeff Layton <jlayton@samba.org>
2011-01-14mount.cifs: add cruid= mount optionJeff Layton1-0/+5
Allow admins to pass in a username for the cruid= mount option. Signed-off-by: Jeff Layton <jlayton@samba.org> Reviewed-by: Shirish Pargaonkar <shirishpargaonkar@gmail.com>
2011-01-05manpage: change port option descriptionPavel Shilovsky1-1/+1
Provide changes according to new ip/port connection logic in CIFS. Signed-off-by: Pavel Shilovsky <piastryyy@gmail.com>
2010-12-09mount.cifs: manpage: add entry for "actimeo" optionSuresh Jayaraman1-0/+18
Signed-off-by: Suresh Jayaraman <sjayaraman@suse.de> Signed-off-by: Jeff Layton <jlayton@samba.org>
2010-10-08manpage: add mount.cifs manpage entry for "multiuser" optionJeff Layton1-0/+7
Signed-off-by: Jeff Layton <jlayton@samba.org>
2010-07-27mount.cifs: document the 'fsc' mount optionSuresh Jayaraman1-0/+7
Changes since last post: - added the information about the kernel CONFIG option - also added the information that caching is currently enabled for files opened as read-only Document the newly added local caching feature using FS-Cache. This patch could be queued and considered once the local caching patches gets merged upstream. Signed-off-by: Suresh Jayaraman <sjayaraman@suse.de>
2010-03-03docs: these tools are no longer part of SambaMichael Wood1-4/+2
Remove references to samba(7). There's no cifs-utils(7) man page, so don't refer to one. Signed-off-by: Michael Wood <esiotrot@gmail.com>
2010-03-03docs: change source from Samba 3.6Michael Wood1-1/+1
These tools are no longer part of the Samba suite, so change the source to cifs-utils 4.0. Signed-off-by: Michael Wood <esiotrot@gmail.com>
2010-02-08add manpages for mount.cifs and cifs.upcallJeff Layton1-0/+475
...for now we just add them as regular troff manpages. Signed-off-by: Jeff Layton <jlayton@redhat.com>