| 1 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbmount</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="smbmount.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbmount — mount an smbfs filesystem</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbmount</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id2522934"></a><h2>DESCRIPTION</h2><p><code class="literal">smbmount</code> mounts a Linux SMB filesystem. It
|
|---|
| 2 | is usually invoked as <code class="literal">mount.smbfs</code> by
|
|---|
| 3 | the <a class="citerefentry" href="mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> command when using the
|
|---|
| 4 | "-t smbfs" option. This command only works in Linux, and the kernel must
|
|---|
| 5 | support the smbfs filesystem.</p><p>WARNING: <code class="literal">smbmount</code> is deprecated and not
|
|---|
| 6 | maintained any longer. <code class="literal">mount.cifs</code> (mount -t cifs)
|
|---|
| 7 | should be used instead of <code class="literal">smbmount</code>.</p><p>Options to <code class="literal">smbmount</code> are specified as a comma-separated
|
|---|
| 8 | list of key=value pairs. It is possible to send options other
|
|---|
| 9 | than those listed here, assuming that smbfs supports them. If
|
|---|
| 10 | you get mount failures, check your kernel log for errors on
|
|---|
| 11 | unknown options.</p><p><code class="literal">smbmount</code> is a daemon. After mounting it keeps running until
|
|---|
| 12 | the mounted smbfs is umounted. It will log things that happen
|
|---|
| 13 | when in daemon mode using the "machine name" smbmount, so
|
|---|
| 14 | typically this output will end up in <code class="filename">log.smbmount</code>. The <code class="literal">
|
|---|
| 15 | smbmount</code> process may also be called mount.smbfs.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> <code class="literal">smbmount</code>
|
|---|
| 16 | calls <a class="citerefentry" href="smbmnt.8.html"><span class="citerefentry"><span class="refentrytitle">smbmnt</span>(8)</span></a> to do the actual mount. You
|
|---|
| 17 | must make sure that <code class="literal">smbmnt</code> is in the path so
|
|---|
| 18 | that it can be found. </p></div></div><div class="refsect1" lang="en"><a name="id2483538"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">username=<arg></span></dt><dd><p>
|
|---|
| 19 | specifies the username to connect as. If this is not given, then the environment variable <code class="envar"> USER</code>
|
|---|
| 20 | is used. This option can also take the form "user%password" or "user/workgroup" or "user/workgroup%password"
|
|---|
| 21 | to allow the password and workgroup to be specified as part of the username.
|
|---|
| 22 | </p></dd><dt><span class="term">password=<arg></span></dt><dd><p>
|
|---|
| 23 | specifies the SMB password. If this option is not given then the environment
|
|---|
| 24 | variable <code class="literal">PASSWD</code> is used. If it can find no password
|
|---|
| 25 | <code class="literal">smbmount</code> will prompt for a password, unless the guest option is given.
|
|---|
| 26 | </p><p>
|
|---|
| 27 | Note that passwords which contain the argument delimiter character (i.e. a comma ',') will failed to be parsed
|
|---|
| 28 | correctly on the command line. However, the same password defined in the PASSWD environment variable or a
|
|---|
| 29 | credentials file (see below) will be read correctly.
|
|---|
| 30 | </p></dd><dt><span class="term">credentials=<filename></span></dt><dd><p>specifies a file that contains a username and/or password.
|
|---|
| 31 | The format of the file is:
|
|---|
| 32 | </p><pre class="programlisting">
|
|---|
| 33 | username=value
|
|---|
| 34 | password=value
|
|---|
| 35 | </pre><p>This is preferred over having passwords in plaintext in a
|
|---|
| 36 | shared file, such as <code class="filename">/etc/fstab</code>. Be sure to protect any
|
|---|
| 37 | credentials file properly.
|
|---|
| 38 | </p></dd><dt><span class="term">krb</span></dt><dd><p>Use kerberos (Active Directory). </p></dd><dt><span class="term">netbiosname=<arg></span></dt><dd><p>sets the source NetBIOS name. It defaults
|
|---|
| 39 | to the local hostname. </p></dd><dt><span class="term">uid=<arg></span></dt><dd><p>sets the uid that will own all files on
|
|---|
| 40 | the mounted filesystem.
|
|---|
| 41 | It may be specified as either a username or a numeric uid.
|
|---|
| 42 | </p></dd><dt><span class="term">gid=<arg></span></dt><dd><p>sets the gid that will own all files on
|
|---|
| 43 | the mounted filesystem.
|
|---|
| 44 | It may be specified as either a groupname or a numeric
|
|---|
| 45 | gid. </p></dd><dt><span class="term">port=<arg></span></dt><dd><p>sets the remote SMB port number. The default
|
|---|
| 46 | is 445, fallback is 139. </p></dd><dt><span class="term">fmask=<arg></span></dt><dd><p>sets the file mask. This determines the
|
|---|
| 47 | permissions that remote files have in the local filesystem.
|
|---|
| 48 | This is not a umask, but the actual permissions for the files.
|
|---|
| 49 | The default is based on the current umask. </p></dd><dt><span class="term">dmask=<arg></span></dt><dd><p>Sets the directory mask. This determines the
|
|---|
| 50 | permissions that remote directories have in the local filesystem.
|
|---|
| 51 | This is not a umask, but the actual permissions for the directories.
|
|---|
| 52 | The default is based on the current umask. </p></dd><dt><span class="term">debug=<arg></span></dt><dd><p>Sets the debug level. This is useful for
|
|---|
| 53 | tracking down SMB connection problems. A suggested value to
|
|---|
| 54 | start with is 4. If set too high there will be a lot of
|
|---|
| 55 | output, possibly hiding the useful output.</p></dd><dt><span class="term">ip=<arg></span></dt><dd><p>Sets the destination host or IP address.
|
|---|
| 56 | </p></dd><dt><span class="term">workgroup=<arg></span></dt><dd><p>Sets the workgroup on the destination </p></dd><dt><span class="term">sockopt=<arg></span></dt><dd><p>Sets the TCP socket options. See the <a class="ulink" href="smb.conf.5.html#SOCKETOPTIONS" target="_top"><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a></a> <em class="parameter"><code>socket options</code></em> option.
|
|---|
| 57 | </p></dd><dt><span class="term">scope=<arg></span></dt><dd><p>Sets the NetBIOS scope </p></dd><dt><span class="term">guest</span></dt><dd><p>Don't prompt for a password </p></dd><dt><span class="term">ro</span></dt><dd><p>mount read-only </p></dd><dt><span class="term">rw</span></dt><dd><p>mount read-write </p></dd><dt><span class="term">iocharset=<arg></span></dt><dd><p>
|
|---|
| 58 | sets the charset used by the Linux side for codepage
|
|---|
| 59 | to charset translations (NLS). Argument should be the
|
|---|
| 60 | name of a charset, like iso8859-1. (Note: only kernel
|
|---|
| 61 | 2.4.0 or later)
|
|---|
| 62 | </p></dd><dt><span class="term">codepage=<arg></span></dt><dd><p>
|
|---|
| 63 | sets the codepage the server uses. See the iocharset
|
|---|
| 64 | option. Example value cp850. (Note: only kernel 2.4.0
|
|---|
| 65 | or later)
|
|---|
| 66 | </p></dd><dt><span class="term">ttl=<arg></span></dt><dd><p>
|
|---|
| 67 | sets how long a directory listing is cached in milliseconds
|
|---|
| 68 | (also affects visibility of file size and date
|
|---|
| 69 | changes). A higher value means that changes on the
|
|---|
| 70 | server take longer to be noticed but it can give
|
|---|
| 71 | better performance on large directories, especially
|
|---|
| 72 | over long distances. Default is 1000ms but something
|
|---|
| 73 | like 10000ms (10 seconds) is probably more reasonable
|
|---|
| 74 | in many cases.
|
|---|
| 75 | (Note: only kernel 2.4.2 or later)
|
|---|
| 76 | </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481557"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the username of the
|
|---|
| 77 | person using the client. This information is used only if the
|
|---|
| 78 | protocol level is high enough to support session-level
|
|---|
| 79 | passwords. The variable can be used to set both username and
|
|---|
| 80 | password by using the format username%password.</p><p>The variable <code class="envar">PASSWD</code> may contain the password of the
|
|---|
| 81 | person using the client. This information is used only if the
|
|---|
| 82 | protocol level is high enough to support session-level
|
|---|
| 83 | passwords.</p><p>The variable <code class="envar">PASSWD_FILE</code> may contain the pathname
|
|---|
| 84 | of a file to read the password from. A single line of input is
|
|---|
| 85 | read and used as the password.</p></div><div class="refsect1" lang="en"><a name="id2481595"></a><h2>OTHER COMMANDS</h2><p>
|
|---|
| 86 | File systems that have been mounted using the <code class="literal">smbmount</code>
|
|---|
| 87 | can be unmounted using the <code class="literal">smbumount</code> or the UNIX system
|
|---|
| 88 | <code class="literal">umount</code> command.
|
|---|
| 89 | </p></div><div class="refsect1" lang="en"><a name="id2481623"></a><h2>BUGS</h2><p>Passwords and other options containing , can not be handled.
|
|---|
| 90 | For passwords an alternative way of passing them is in a credentials
|
|---|
| 91 | file or in the PASSWD environment.</p><p>The credentials file does not handle usernames or passwords with
|
|---|
| 92 | leading space.</p><p>One smbfs bug is important enough to mention here, even if it
|
|---|
| 93 | is a bit misplaced:</p><div class="itemizedlist"><ul type="disc"><li><p>Mounts sometimes stop working. This is usually
|
|---|
| 94 | caused by smbmount terminating. Since smbfs needs smbmount to
|
|---|
| 95 | reconnect when the server disconnects, the mount will eventually go
|
|---|
| 96 | dead. An umount/mount normally fixes this. At least 2 ways to
|
|---|
| 97 | trigger this bug are known.</p></li></ul></div><p>Note that the typical response to a bug report is suggestion
|
|---|
| 98 | to try the latest version first. So please try doing that first,
|
|---|
| 99 | and always include which versions you use of relevant software
|
|---|
| 100 | when reporting bugs (minimum: samba, kernel, distribution)</p></div><div class="refsect1" lang="en"><a name="id2481665"></a><h2>SEE ALSO</h2><p>Documentation/filesystems/smbfs.txt in the linux kernel
|
|---|
| 101 | source tree may contain additional options and information.</p><p>FreeBSD also has a smbfs, but it is not related to smbmount</p><p>For Solaris, HP-UX and others you may want to look at <a class="citerefentry" href="smbsh.1.html"><span class="citerefentry"><span class="refentrytitle">smbsh</span>(1)</span></a> or at other solutions, such as
|
|---|
| 102 | Sharity or perhaps replacing the SMB server with a NFS server.</p></div><div class="refsect1" lang="en"><a name="id2481695"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
|
|---|
| 103 | and others.</p><p>The current maintainer of smbfs and the userspace
|
|---|
| 104 | tools <code class="literal">smbmount</code>, <code class="literal">smbumount</code>,
|
|---|
| 105 | and <code class="literal">smbmnt</code> is <a class="ulink" href="mailto:urban@teststation.com" target="_top">Urban Widmark</a>.
|
|---|
| 106 | The <a class="ulink" href="mailto:samba@samba.org" target="_top">SAMBA Mailing list</a>
|
|---|
| 107 | is the preferred place to ask questions regarding these programs.
|
|---|
| 108 | </p><p>The conversion of this manpage for Samba 2.2 was performed
|
|---|
| 109 | by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0
|
|---|
| 110 | was done by Alexander Bokovoy.</p></div></div></body></html>
|
|---|
