- Timestamp:
- Jan 15, 2010, 8:21:06 AM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.3.x/docs/htmldocs/manpages/mount.cifs.8.html
r221 r368 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 4.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. 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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="mount.cifs"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">mount.cifs</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528928"></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 … … 24 24 </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 25 25 the mounted resource is unmounted (usually via the umount utility). 26 </p></div><div class="refsect1" lang="en"><a name="id2483399"></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. If26 </p></div><div class="refsect1" title="OPTIONS"><a name="id2489361"></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 27 27 this is not given, then the environment variable <span class="emphasis"><em>USER</em></span> is used. This option can also take the 28 28 form "user%password" or "workgroup/user" or 29 29 "workgroup/user%password" to allow the password and workgroup 30 30 to be specified as part of the username. 31 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>31 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> 32 32 The cifs vfs accepts the parameter <em class="parameter"><code>user=</code></em>, or for users familiar with smbfs it accepts the longer form of the parameter <em class="parameter"><code>username=</code></em>. Similarly the longer smbfs style parameter names may be accepted as synonyms for the shorter cifs parameters <em class="parameter"><code>pass=</code></em>,<em class="parameter"><code>dom=</code></em> and <em class="parameter"><code>cred=</code></em>. 33 33 </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 … … 48 48 username=<em class="replaceable"><code>value</code></em> 49 49 password=<em class="replaceable"><code>value</code></em> 50 workgroup=<em class="replaceable"><code>value</code></em>50 domain=<em class="replaceable"><code>value</code></em> 51 51 </pre><p> 52 52 This is preferred over having passwords in plaintext in a … … 167 167 "noacl" on mount.</p></dd><dt><span class="term">nocase</span></dt><dd><p>Request case insensitive path name matching (case 168 168 sensitive is the default if the server suports it). 169 </p></dd><dt><span class="term">sec=</span></dt><dd><p>Security mode. Allowed values are:</p><div class="itemizedlist"><ul type="disc"><li><p>none attempt to connection as a null user (no name) </p></li><li><p>krb5 Use Kerberos version 5 authentication</p></li><li><p>krb5i Use Kerberos authentication and packet signing</p></li><li><p>ntlm Use NTLM password hashing (default)</p></li><li><p>ntlmi Use NTLM password hashing with signing (if169 </p></dd><dt><span class="term">sec=</span></dt><dd><p>Security mode. Allowed values are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>none attempt to connection as a null user (no name) </p></li><li class="listitem"><p>krb5 Use Kerberos version 5 authentication</p></li><li class="listitem"><p>krb5i Use Kerberos authentication and packet signing</p></li><li class="listitem"><p>ntlm Use NTLM password hashing (default)</p></li><li class="listitem"><p>ntlmi Use NTLM password hashing with signing (if 170 170 /proc/fs/cifs/PacketSigningEnabled on or if 171 server requires signing also can be the default)</p></li><li ><p>ntlmv2 Use NTLMv2 password hashing</p></li><li><p>ntlmv2i Use NTLMv2 password hashing with packet signing</p></li></ul></div><p>[NB This [sec parameter] is under development and expected to be available in cifs kernel module 1.40 and later]171 server requires signing also can be the default)</p></li><li class="listitem"><p>ntlmv2 Use NTLMv2 password hashing</p></li><li class="listitem"><p>ntlmv2i Use NTLMv2 password hashing with packet signing</p></li></ul></div><p>[NB This [sec parameter] is under development and expected to be available in cifs kernel module 1.40 and later] 172 172 </p></dd><dt><span class="term">nobrl</span></dt><dd><p>Do not send byte range lock requests to the server. 173 173 This is necessary for certain applications that break … … 219 219 </p></dd><dt><span class="term">wsize=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>default network write size (default 57344) 220 220 maximum wsize currently allowed by CIFS is 57344 (fourteen 221 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="id2481469"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>221 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" title="SERVICE FORMATTING AND DELIMITERS"><a name="id2487437"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p> 222 222 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. 223 223 </p><p> 224 224 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. 225 </p></div><div class="refsect1" lang="en"><a name="id2481910"></a><h2>ENVIRONMENT VARIABLES</h2><p>225 </p></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id2487878"></a><h2>ENVIRONMENT VARIABLES</h2><p> 226 226 The variable <span class="emphasis"><em>USER</em></span> may contain the username of the 227 227 person to be used to authenticate to the server. … … 235 235 of a file to read the password from. A single line of input is 236 236 read and used as the password. 237 </p></div><div class="refsect1" lang="en"><a name="id2481944"></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="id2481956"></a><h2>CONFIGURATION</h2><p>237 </p></div><div class="refsect1" title="NOTES"><a name="id2487912"></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" title="CONFIGURATION"><a name="id2487924"></a><h2>CONFIGURATION</h2><p> 238 238 The primary mechanism for making configuration changes and for reading 239 239 debug information for the cifs vfs is via the Linux /proc filesystem. … … 246 246 installation (device driver load). 247 247 For more information see the kernel file <code class="filename">fs/cifs/README</code>. 248 </p></div><div class="refsect1" lang="en"><a name="id2481989"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.248 </p></div><div class="refsect1" title="BUGS"><a name="id2487957"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported. 249 249 </p><p>The credentials file does not handle usernames or passwords with 250 250 leading space.</p><p> … … 254 254 when reporting bugs (minimum: mount.cifs (try mount.cifs -V), kernel (see /proc/version) and 255 255 server type you are trying to contact. 256 </p></div><div class="refsect1" lang="en"><a name="id2482014"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of257 the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2482026"></a><h2>SEE ALSO</h2><p>256 </p></div><div class="refsect1" title="VERSION"><a name="id2487982"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of 257 the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487994"></a><h2>SEE ALSO</h2><p> 258 258 Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel 259 259 source tree may contain additional options and information. 260 </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="id2482047"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It260 </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" title="AUTHOR"><a name="id2488015"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It 261 261 was converted to Docbook/XML by Jelmer Vernooij.</p><p>The maintainer of the Linux cifs vfs and the userspace 262 262 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.
