1UMOUNT.CIFS(8) UMOUNT.CIFS(8)
2
6 umount.cifs - for normal, non-root users, to unmount their own Common
7 Internet File System (CIFS) mounts
8
10 umount.cifs {mount-point} [-nVvhfle]
11
13 This tool is part of the samba(7) suite.
14 umount.cifs unmounts a Linux CIFS filesystem. It can be invoked indi‐
16 rectly by the umount(8) command when umount.cifs is in /sbin directory,
17 unless you specify the "-i" option to umount. Specifying -i to umount
18 avoids execution of umount helpers such as umount.cifs. The umount.cifs
19 command only works in Linux, and the kernel must support the cifs
20 filesystem. The CIFS protocol is the successor to the SMB protocol and
21 is supported by most Windows servers and many other commercial servers
22 and Network Attached Storage appliances as well as by the popular Open
23 Source server Samba.
24 The umount.cifs utility detaches the local directory mount-point from
26 the corresponding UNC name (exported network resource) and frees the
27 associated kernel resources. It is possible to set the mode for
28 umount.cifs to setuid root (or equivalently update the /etc/permissions
29 file) to allow non-root users to umount shares to directories for which
30 they have write permission. The umount.cifs utility is typically not
31 needed if unmounts need only be performed by root users, or if user
32 mounts and unmounts can rely on specifying explicit entries in
33 /etc/fstab See
34 fstab(5)
36
38 --verbose
39 print additional debugging information
40 --no-mtab
42 Do not update the mtab even if unmount completes successfully
43 (/proc/mounts will still display the correct information)
44
46 This command is normally intended to be installed setuid (since root
47 users can already run unmount). An alternative to using umount.cifs is
48 to add specfic entries for the user mounts that you wish a particular
49 user or users to mount and unmount to /etc/fstab
50
52 The primary mechanism for making configuration changes and for reading
53 debug information for the cifs vfs is via the Linux /proc filesystem.
54 In the directory /proc/fs/cifs are various configuration files and
55 pseudo files which can display debug information. For more information
56 see the kernel file fs/cifs/README.
57
59 At this time umount.cifs does not lock the mount table using the same
60 lock as the umount utility does, so do not attempt to do multiple
61 unmounts from different processes (and in particular unmounts of a cifs
62 mount and another type of filesystem mount at the same time).
63 If the same mount point is mounted multiple times by cifs, umount.cifs
65 will remove all of the matching entries from the mount table (although
66 umount.cifs will actually only unmount the last one), rather than only
67 removing the last matching entry in /etc/mtab. The pseudofile
68 /proc/mounts will display correct information though, and the lack of
69 an entry in /etc/mtab does not prevent subsequent unmounts.
70 Note that the typical response to a bug report is a suggestion to try
72 the latest version first. So please try doing that first, and always
73 include which versions you use of relevant software when reporting bugs
74 (minimum: umount.cifs (try umount.cifs -V), kernel (see /proc/version)
75 and server type you are trying to contact.
76
78 This man page is correct for version 1.34 of the cifs vfs filesystem
79 (roughly Linux kernel 2.6.12).
80
82 Documentation/filesystems/cifs.txt and fs/cifs/README in the linux ker‐
83 nel source tree may contain additional options and information.
84 mount.cifs(8)
86
88 Steve French
89 The syntax was loosely based on the umount utility and the manpage was
91 loosely based on that of mount.cifs.8. The man page was created by
92 Steve French
93 The maintainer of the Linux cifs vfs and the userspace tool umount.cifs
95 is Steve French. The Linux CIFS Mailing list is the preferred place to
96 ask questions regarding these programs.
97 UMOUNT.CIFS(8)