- Timestamp:
- Jun 24, 2009, 5:09:21 PM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.0/docs/htmldocs/manpages/mount.cifs.8.html
r158 r286 1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>mount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.7 3.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="mount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>mount.cifs — mount using the Common Internet File System (CIFS)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">mount.cifs</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id258193"></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>mount.cifs mounts a Linux CIFS filesystem. It1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>mount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="mount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>mount.cifs — mount using the Common Internet File System (CIFS)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">mount.cifs</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id2522954"></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>mount.cifs mounts a Linux CIFS filesystem. It 2 2 is usually invoked indirectly by 3 3 the <a class="citerefentry" href="mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> command when using the … … 21 21 </p><p><span class="emphasis"><em>mount.cifs</em></span> causes the cifs vfs to launch a thread named cifsd. After mounting it keeps running until 22 22 the mounted resource is unmounted (usually via the umount utility). 23 </p></div><div class="refsect1" lang="en"><a name="id2 90829"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">user=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the username to connect as. If23 </p></div><div class="refsect1" lang="en"><a name="id2483393"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">user=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the username to connect as. If 24 24 this is not given, then the environment variable <span class="emphasis"><em>USER</em></span> is used. This option can also take the 25 25 form "user%password" or "workgroup/user" or … … 30 30 </p></div></dd><dt><span class="term">password=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the CIFS password. If this 31 31 option is not given then the environment variable 32 <span class="emphasis"><em>PASSWD</em></span> is used. If the password is not specified 32 <span class="emphasis"><em>PASSWD</em></span> is used. If the password is not specified 33 33 directly or indirectly via an argument to mount, <span class="emphasis"><em>mount.cifs</em></span> will prompt 34 34 for a password, unless the guest option is specified. … … 40 40 </p></dd><dt><span class="term">credentials=<em class="replaceable"><code>filename</code></em></span></dt><dd><p> 41 41 specifies a file that contains a username 42 and/or password. The format of the file is: 42 and/or password and optionally the name of the 43 workgroup. The format of the file is: 43 44 </p><pre class="programlisting"> 44 45 username=<em class="replaceable"><code>value</code></em> 45 46 password=<em class="replaceable"><code>value</code></em> 47 workgroup=<em class="replaceable"><code>value</code></em> 46 48 </pre><p> 47 49 This is preferred over having passwords in plaintext in a … … 214 216 </p></dd><dt><span class="term">wsize=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>default network write size (default 57344) 215 217 maximum wsize currently allowed by CIFS is 57344 (fourteen 216 4096 byte pages)</p></dd><dt><span class="term">--verbose</span></dt><dd><p>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</p><p>mount -t cifs //server/share /mnt --verbose -o user=username</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id 300200"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>218 4096 byte pages)</p></dd><dt><span class="term">--verbose</span></dt><dd><p>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</p><p>mount -t cifs //server/share /mnt --verbose -o user=username</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532635"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p> 217 219 It's generally preferred to use forward slashes (/) as a delimiter in service names. They are considered to be the "universal delimiter" since they are generally not allowed to be embedded within path components on Windows machines and the client can convert them to blackslashes (\) unconditionally. Conversely, backslash characters are allowed by POSIX to be part of a path component, and can't be automatically converted in the same way. 218 220 </p><p> 219 221 mount.cifs will attempt to convert backslashes to forward slashes where it's able to do so, but it cannot do so in any path component following the sharename. 220 </p></div><div class="refsect1" lang="en"><a name="id 300218"></a><h2>ENVIRONMENT VARIABLES</h2><p>222 </p></div><div class="refsect1" lang="en"><a name="id2532658"></a><h2>ENVIRONMENT VARIABLES</h2><p> 221 223 The variable <span class="emphasis"><em>USER</em></span> may contain the username of the 222 224 person to be used to authenticate to the server. … … 230 232 of a file to read the password from. A single line of input is 231 233 read and used as the password. 232 </p></div><div class="refsect1" lang="en"><a name="id 300247"></a><h2>NOTES</h2><p>This command may be used only by root, unless installed setuid, in which case the noeexec and nosuid mount flags are enabled.</p></div><div class="refsect1" lang="en"><a name="id300258"></a><h2>CONFIGURATION</h2><p>234 </p></div><div class="refsect1" lang="en"><a name="id2532690"></a><h2>NOTES</h2><p>This command may be used only by root, unless installed setuid, in which case the noeexec and nosuid mount flags are enabled.</p></div><div class="refsect1" lang="en"><a name="id2532702"></a><h2>CONFIGURATION</h2><p> 233 235 The primary mechanism for making configuration changes and for reading 234 236 debug information for the cifs vfs is via the Linux /proc filesystem. … … 241 243 installation (device driver load). 242 244 For more information see the kernel file <code class="filename">fs/cifs/README</code>. 243 </p></div><div class="refsect1" lang="en"><a name="id 300283"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.245 </p></div><div class="refsect1" lang="en"><a name="id2532733"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported. 244 246 </p><p>The credentials file does not handle usernames or passwords with 245 247 leading space.</p><p> … … 249 251 when reporting bugs (minimum: mount.cifs (try mount.cifs -V), kernel (see /proc/version) and 250 252 server type you are trying to contact. 251 </p></div><div class="refsect1" lang="en"><a name="id 300304"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of252 the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id 300314"></a><h2>SEE ALSO</h2><p>253 </p></div><div class="refsect1" lang="en"><a name="id2532757"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of 254 the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2532769"></a><h2>SEE ALSO</h2><p> 253 255 Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel 254 256 source tree may contain additional options and information. 255 </p><p><a class="citerefentry" href="umount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">umount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id 300334"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It257 </p><p><a class="citerefentry" href="umount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">umount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2532789"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It 256 258 was converted to Docbook/XML by Jelmer Vernooij.</p><p>The maintainer of the Linux cifs vfs and the userspace 257 259 tool <span class="emphasis"><em>mount.cifs</em></span> is <a class="ulink" href="mailto:sfrench@samba.org" target="_top">Steve French</a>.
Note:
See TracChangeset
for help on using the changeset viewer.
