| 1 | .\" Title: umount.cifs
|
|---|
| 2 | .\" Author:
|
|---|
| 3 | .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
|
|---|
| 4 | .\" Date: 08/25/2008
|
|---|
| 5 | .\" Manual: System Administration tools
|
|---|
| 6 | .\" Source: Samba 3.0
|
|---|
| 7 | .\"
|
|---|
| 8 | .TH "UMOUNT\.CIFS" "8" "08/25/2008" "Samba 3\.0" "System Administration tools"
|
|---|
| 9 | .\" disable hyphenation
|
|---|
| 10 | .nh
|
|---|
| 11 | .\" disable justification (adjust text to left margin only)
|
|---|
| 12 | .ad l
|
|---|
| 13 | .SH "NAME"
|
|---|
| 14 | umount.cifs - for normal, non-root users, to unmount their own Common Internet File System (CIFS) mounts
|
|---|
| 15 | .SH "SYNOPSIS"
|
|---|
| 16 | .HP 1
|
|---|
| 17 | umount\.cifs {mount\-point} [\-nVvhfle]
|
|---|
| 18 | .SH "DESCRIPTION"
|
|---|
| 19 | .PP
|
|---|
| 20 | This tool is part of the
|
|---|
| 21 | \fBsamba\fR(7)
|
|---|
| 22 | suite\.
|
|---|
| 23 | .PP
|
|---|
| 24 | umount\.cifs unmounts a Linux CIFS filesystem\. It can be invoked indirectly by the
|
|---|
| 25 | \fBumount\fR(8)
|
|---|
| 26 | command when umount\.cifs is in /sbin directory, unless you specify the "\-i" option to umount\. Specifying \-i to umount avoids execution of umount helpers such as umount\.cifs\. The umount\.cifs command only works in Linux, and the kernel must support the cifs filesystem\. The CIFS protocol is the successor to the SMB protocol and is supported by most Windows servers and many other commercial servers and Network Attached Storage appliances as well as by the popular Open Source server Samba\.
|
|---|
| 27 | .PP
|
|---|
| 28 | The umount\.cifs utility detaches the local directory
|
|---|
| 29 | \fImount\-point\fR
|
|---|
| 30 | from the corresponding UNC name (exported network resource) and frees the associated kernel resources\. It is possible to set the mode for umount\.cifs to setuid root (or equivalently update the /etc/permissions file) to allow non\-root users to umount shares to directories for which they have write permission\. The umount\.cifs utility is typically not needed if unmounts need only be performed by root users, or if user mounts and unmounts can rely on specifying explicit entries in /etc/fstab See
|
|---|
| 31 | .PP
|
|---|
| 32 | \fBfstab\fR(5)
|
|---|
| 33 | .SH "OPTIONS"
|
|---|
| 34 | .PP
|
|---|
| 35 | \-\-verbose
|
|---|
| 36 | .RS 4
|
|---|
| 37 | print additional debugging information
|
|---|
| 38 | .RE
|
|---|
| 39 | .PP
|
|---|
| 40 | \-\-no\-mtab
|
|---|
| 41 | .RS 4
|
|---|
| 42 | Do not update the mtab even if unmount completes successfully (/proc/mounts will still display the correct information)
|
|---|
| 43 | .RE
|
|---|
| 44 | .SH "NOTES"
|
|---|
| 45 | .PP
|
|---|
| 46 | This command is normally intended to be installed setuid (since root users can already run unmount)\. An alternative to using umount\.cifs is to add specfic entries for the user mounts that you wish a particular user or users to mount and unmount to /etc/fstab
|
|---|
| 47 | .SH "CONFIGURATION"
|
|---|
| 48 | .PP
|
|---|
| 49 | The primary mechanism for making configuration changes and for reading debug information for the cifs vfs is via the Linux /proc filesystem\. In the directory
|
|---|
| 50 | \fI/proc/fs/cifs\fR
|
|---|
| 51 | are various configuration files and pseudo files which can display debug information\. For more information see the kernel file
|
|---|
| 52 | \fIfs/cifs/README\fR\.
|
|---|
|
|---|
