Changeset 599 for trunk/server/docs/htmldocs/manpages/umount.cifs.8.html
- Timestamp:
- Jul 6, 2011, 8:21:13 PM (14 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/server/docs/htmldocs/manpages/umount.cifs.8.html
r414 r599 1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>umount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.7 4.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="umount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>umount.cifs — for normal, non-root users, to unmount their own Common Internet File System (CIFS) mounts</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">umount.cifs</code> {mount-point} [-nVvhfle]</p></div></div><div class="refsect1" lang="en"><a name="id2522920"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>umount.cifs unmounts a Linux CIFS filesystem. It can be invoked1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>umount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="umount.cifs"><a name="umount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>umount.cifs — for normal, non-root users, to unmount their own Common Internet File System (CIFS) mounts</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">umount.cifs</code> {mount-point} [-nVvhfle]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266358"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>umount.cifs unmounts a Linux CIFS filesystem. It can be invoked 2 2 indirectly by the 3 3 <a class="citerefentry" href="umount.8.html"><span class="citerefentry"><span class="refentrytitle">umount</span>(8)</span></a> command … … 12 12 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 13 13 not needed if unmounts need only be performed by root users, or if user mounts and unmounts 14 can rely on specifying explicit entries in /etc/fstab See</p><p><a class="citerefentry" href="fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a></p></div><div class="refsect1" lang="en"><a name="id2483353"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-V</span></dt><dd><p>Print version and exit.</p></dd><dt><span class="term">-h</span></dt><dd><p>Print help message and exit.</p></dd><dt><span class="term">-r</span></dt><dd><p>In case unmounting fails, try to remount14 can rely on specifying explicit entries in /etc/fstab See</p><p><a class="citerefentry" href="fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a></p></div><div class="refsect1" title="OPTIONS"><a name="id266865"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-V</span></dt><dd><p>Print version and exit.</p></dd><dt><span class="term">-h</span></dt><dd><p>Print help message and exit.</p></dd><dt><span class="term">-r</span></dt><dd><p>In case unmounting fails, try to remount 15 15 read-only.</p></dd><dt><span class="term">-d</span></dt><dd><p>In case the unmounted device was a loop device, 16 16 also free this loop device.</p></dd><dt><span class="term">-f</span></dt><dd><p>Force unmount (in case of an unreachable … … 26 26 A second unmount call specifying -e unmounts 27 27 an expired mount point. This flag cannot be 28 specified with either -f or -l</p></dd><dt><span class="term">-v|--verbose</span></dt><dd><p>Verbose Mode. Print additional debugging information</p></dd><dt><span class="term">-n|--no-mtab</span></dt><dd><p>Do not update the mtab even if unmount completes successfully (/proc/mounts will still display the correct information)</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483613"></a><h2>NOTES</h2><p>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</p></div><div class="refsect1" lang="en"><a name="id2483628"></a><h2>CONFIGURATION</h2><p>28 specified with either -f or -l</p></dd><dt><span class="term">-v|--verbose</span></dt><dd><p>Verbose Mode. Print additional debugging information</p></dd><dt><span class="term">-n|--no-mtab</span></dt><dd><p>Do not update the mtab even if unmount completes successfully (/proc/mounts will still display the correct information)</p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id265780"></a><h2>NOTES</h2><p>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</p></div><div class="refsect1" title="CONFIGURATION"><a name="id265793"></a><h2>CONFIGURATION</h2><p> 29 29 The primary mechanism for making configuration changes and for reading 30 30 debug information for the cifs vfs is via the Linux /proc filesystem. … … 32 32 configuration files and pseudo files which can display debug information. 33 33 For more information see the kernel file <code class="filename">fs/cifs/README</code>. 34 </p></div><div class="refsect1" lang="en"><a name="id2483655"></a><h2>BUGS</h2><p>At this time umount.cifs does not lock the mount table using the same lock as the umount utility does, so do not attempt to do multiple unmounts from different processes (and in particular unmounts of a cifs mount and another type of filesystem mount at the same time).34 </p></div><div class="refsect1" title="BUGS"><a name="id265817"></a><h2>BUGS</h2><p>At this time umount.cifs does not lock the mount table using the same lock as the umount utility does, so do not attempt to do multiple unmounts from different processes (and in particular unmounts of a cifs mount and another type of filesystem mount at the same time). 35 35 </p><p>If the same mount point is mounted multiple times by cifs, umount.cifs will remove all of the matching entries from the mount table (although umount.cifs will actually only unmount the last one), rather than only removing the last matching entry in /etc/mtab. The pseudofile /proc/mounts will display correct information though, and the lack of an entry in /etc/mtab does not prevent subsequent unmounts.</p><p> 36 36 Note that the typical response to a bug report is a suggestion … … 39 39 when reporting bugs (minimum: umount.cifs (try umount.cifs -V), kernel (see /proc/version) and 40 40 server type you are trying to contact. 41 </p></div><div class="refsect1" lang="en"><a name="id2483689"></a><h2>VERSION</h2><p>This man page is correct for version 1.34 of42 the cifs vfs filesystem (roughly Linux kernel 2.6.12).</p></div><div class="refsect1" lang="en"><a name="id2483701"></a><h2>SEE ALSO</h2><p>41 </p></div><div class="refsect1" title="VERSION"><a name="id265842"></a><h2>VERSION</h2><p>This man page is correct for version 1.34 of 42 the cifs vfs filesystem (roughly Linux kernel 2.6.12).</p></div><div class="refsect1" title="SEE ALSO"><a name="id265853"></a><h2>SEE ALSO</h2><p> 43 43 Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel 44 44 source tree may contain additional options and information. 45 </p><p><a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2483722"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax was loosely based on the umount utility and the manpage was loosely based on that of mount.cifs.8. The man page was created by Steve French</p><p>The maintainer of the Linux cifs vfs and the userspace45 </p><p><a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id265873"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax was loosely based on the umount utility and the manpage was loosely based on that of mount.cifs.8. The man page was created by Steve French</p><p>The maintainer of the Linux cifs vfs and the userspace 46 46 tool <span class="emphasis"><em>umount.cifs</em></span> is <a class="ulink" href="mailto:sfrench@samba.org" target="_top">Steve French</a>. 47 47 The <a class="ulink" href="mailto:linux-cifs-client@lists.samba.org" target="_top">Linux CIFS Mailing list</a>
Note:
See TracChangeset
for help on using the changeset viewer.