- Timestamp:
- May 24, 2009, 7:17:10 AM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.3.x/docs/htmldocs/manpages/mount.cifs.8.html
r218 r221 8 8 by the popular Open Source server Samba. 9 9 </p><p> 10 The mount.cifs utility attaches the UNC name (exported network resource) to 11 the local directory <span class="emphasis"><em>mount-point</em></span>. It is possible to set the mode for mount.cifs to 12 setuid root to allow non-root users to mount shares to directories for which they 13 have write permission. 10 The mount.cifs utility attaches the UNC name (exported network resource) 11 specified as <span class="emphasis"><em>service</em></span> (using //server/share syntax, 12 where "server" is the server name or IP address and "share" is the name 13 of the share) to the local directory <span class="emphasis"><em>mount-point</em></span>. 14 It is possible to set the mode for mount.cifs to setuid root to allow 15 non-root users to mount shares to directories for which they 16 have write permission. 14 17 </p><p> 15 18 Options to <span class="emphasis"><em>mount.cifs</em></span> are specified as a comma-separated … … 21 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 22 25 the mounted resource is unmounted (usually via the umount utility). 23 </p></div><div class="refsect1" lang="en"><a name="id248339 3"></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" 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. If 24 27 this is not given, then the environment variable <span class="emphasis"><em>USER</em></span> is used. This option can also take the 25 28 form "user%password" or "workgroup/user" or … … 61 64 the server supports the Unix Extensions then the uid 62 65 and gid can be retrieved from the server (and uid 63 and gid would not have to be specif ed on the mount.66 and gid would not have to be specified on the mount. 64 67 For servers which do not support the CIFS Unix 65 68 extensions, the default uid (and gid) returned on lookup … … 159 162 server crashes.</p></dd><dt><span class="term">soft</span></dt><dd><p>(default) The program accessing a file on the cifs mounted file system will not hang when the server crashes and will return errors to the user application.</p></dd><dt><span class="term">noacl</span></dt><dd><p>Do not allow POSIX ACL operations even if server would support them.</p><p> 160 163 The CIFS client can get and set POSIX ACLs (getfacl, setfacl) to Samba servers 161 version 3. 10 and later. Setting POSIX ACLs requires enabling both XATTR and164 version 3.0.10 and later. Setting POSIX ACLs requires enabling both XATTR and 162 165 then POSIX support in the CIFS configuration options when building the cifs 163 module. POSIX ACL support can be disabled on a per mount basi cby specifying166 module. POSIX ACL support can be disabled on a per mount basis by specifying 164 167 "noacl" on mount.</p></dd><dt><span class="term">nocase</span></dt><dd><p>Request case insensitive path name matching (case 165 168 sensitive is the default if the server suports it). … … 216 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) 217 220 maximum wsize currently allowed by CIFS is 57344 (fourteen 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="id2 532635"></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" lang="en"><a name="id2481469"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p> 219 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. 220 223 </p><p> 221 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. 222 </p></div><div class="refsect1" lang="en"><a name="id2 532658"></a><h2>ENVIRONMENT VARIABLES</h2><p>225 </p></div><div class="refsect1" lang="en"><a name="id2481910"></a><h2>ENVIRONMENT VARIABLES</h2><p> 223 226 The variable <span class="emphasis"><em>USER</em></span> may contain the username of the 224 227 person to be used to authenticate to the server. … … 232 235 of a file to read the password from. A single line of input is 233 236 read and used as the password. 234 </p></div><div class="refsect1" lang="en"><a name="id2 532690"></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>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> 235 238 The primary mechanism for making configuration changes and for reading 236 239 debug information for the cifs vfs is via the Linux /proc filesystem. … … 243 246 installation (device driver load). 244 247 For more information see the kernel file <code class="filename">fs/cifs/README</code>. 245 </p></div><div class="refsect1" lang="en"><a name="id2 532733"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.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. 246 249 </p><p>The credentials file does not handle usernames or passwords with 247 250 leading space.</p><p> … … 251 254 when reporting bugs (minimum: mount.cifs (try mount.cifs -V), kernel (see /proc/version) and 252 255 server type you are trying to contact. 253 </p></div><div class="refsect1" lang="en"><a name="id2 532757"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of254 the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2 532769"></a><h2>SEE ALSO</h2><p>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 of 257 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> 255 258 Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel 256 259 source tree may contain additional options and information. 257 </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="id2 532789"></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" 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. It 258 261 was converted to Docbook/XML by Jelmer Vernooij.</p><p>The maintainer of the Linux cifs vfs and the userspace 259 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.
