smbmount - mount an smbfs filesystem
SYNOPSIS
smbumount service mount-point [ -o options ]
DESCRIPTION
smbmount mounts a SMB filesystem. It is usually invoked as
mount.smb from the mount(8) command when using the "-t
smb" option. The kernel must support the smbfs filesystem.
Options to smbmount are specified as a comma-separated
list of key=value pairs. It is possible to send options
other than those listed here, assuming that smbfs supports
them. If you get mount failures, check your kernel log for
errors on unknown options.
smbmount is a daemon. After mounting it keeps running
until the mounted smbfs is umounted. It will log things
that happen when in daemon mode using the "machine name"
smbmount, so typically this output will end up in log.smb
mount. The smbmount process may also be called
mount.smbfs.
NOTE: smbmount calls smbmnt(8) to do the actual mount. You
must make sure that smbmnt is in the path so that it can
be found.
OPTIONS
username=<arg>
specifies the username to connect as. If this is
not given, then the environment variable USER is
used. This option can also take the form
"user%password" or "user/workgroup" or "user/work
group%password" to allow the password and workgroup
to be specified as part of the username.
password=<arg>
specifies the SMB password. If this option is not
given then the environment variable PASSWD is used.
If it can find no password smbmount will prompt for
a passeword, unless the guest option is given.
Note that password which contain the arguement
delimiter character (i.e. a comma ',') will failed
to be parsed correctly on the command line. How
ever, the same password defined in the PASSWD envi
ronment variable or a credentials file (see below)
will be read correctly.
credentials=<filename>
specifies a file that contains a username and/or
password. The format of the file is:
password = <value>
This is preferred over having passwords in plain
text in a shared file, such as /etc/fstab. Be sure
to protect any credentials file properly.
netbiosname=<arg>
sets the source NetBIOS name. It defaults to the
local hostname.
uid=<arg>
sets the uid that will own all files on the mounted
filesystem. It may be specified as either a user
name or a numeric uid.
gid=<arg>
sets the gid that will own all files on the mounted
filesystem. It may be specified as either a group
name or a numeric gid.
port=<arg>
sets the remote SMB port number. The default is
139.
fmask=<arg>
sets the file mask. This determines the permissions
that remote files have in the local filesystem.
The default is based on the current umask.
dmask=<arg>
sets the directory mask. This determines the per
missions that remote directories have in the local
filesystem. The default is based on the current
umask.
debug=<arg>
sets the debug level. This is useful for tracking
down SMB connection problems.
ip=<arg>
sets the destination host or IP address.
workgroup=<arg>
sets the workgroup on the destination
sockopt=<arg>
sets the TCP socket options. See the smb.conf
socket options option.
scope=<arg>
sets the NetBIOS scope
ro mount read-only
rw mount read-write
iocharset=<arg>
sets the charset used by the Linux side for code
page to charset translations (NLS). Argument should
be the name of a charset, like iso8859-1. (Note:
only kernel 2.4.0 or later)
codepage=<arg>
sets the codepage the server uses. See the
iocharset option. Example value cp850. (Note: only
kernel 2.4.0 or later)
ttl=<arg>
how long a directory listing is cached in millisec
onds (also affects visibility of file size and date
changes). A higher value means that changes on the
server take longer to be noticed but it can give
better performance on large directories, especially
over long distances. Default is 1000ms but some
thing like 10000ms (10 seconds) is probably more
reasonable in many cases. (Note: only kernel 2.4.2
or later)
ENVIRONMENT VARIABLES
The variable USER may contain the username of the person
using the client. This information is used only if the
protocol level is high enough to support session-level
passwords. The variable can be used to set both username
and password by using the format username%password.
The variable PASSWD may contain the password of the person
using the client. This information is used only if the
protocol level is high enough to support session-level
passwords.
The variable PASSWD_FILE may contain the pathname of a
file to read the password from. A single line of input is
read and used as the password.
BUGS
Not many known smbmount bugs. But one smbfs bug is impor
tant enough to mention here anyway:
· Mounts sometimes stop working. This is usually caused by
smbmount terminating. Since smbfs needs smbmount to
reconnect when the server disconnects, the mount will go
dead. A re-mount normally fixes this. At least 2 ways to
trigger this bug are known.
tion to try the latest version first. So please try doing
that first, and always include which versions you use of
relevant software when reporting bugs (minimum: samba,
kernel, distribution)
SEE ALSO
Documentation/filesystems/smbfs.txt in the kernel source
tree may contain additional options and information.
AUTHOR
Volker Lendecke, Andrew Tridgell, Michael H. Warfield and
others.
The current maintainer of smbfs and the userspace tools
smbmount, smbumount, and smbmnt is Urban Widmark
<URL:mailto:urban@teststation.com>. The SAMBA Mailing
list <URL:mailto:samba@samba.org> is the preferred place
to ask questions regarding these programs.
The conversion of this manpage for Samba 2.2 was performed
by Gerald Carter
Man(1) output converted with
man2html