smbmount

smbmount

---

This program mounts an smbfs filesystem on a mount point in the Unix filesystem. It is typically called as mount.smb from mount , although it can also be run directly by users. After mounting the smbfs filesystem, smbmount continues to run as a daemon as long as the filesystem is mounted. It logs events in the file log.smbmount in the same directory as the other Samba log files (which is commonly /usr/local/samba/var by default). The logging level is controlled by the debug level parameter in the Samba configuration file.

Command synopsis

 smbmount   service mount_point [-o options]   

The service argument specifies the SMB share to mount, given as a UNC. The mount_point argument specifies a directory to use as the mount point. The options to smbmount are specified as a comma-separated list of key = value pairs. The documented options are as follows . Others can be passed if the kernel supports them.

Options

username= name

Specifies the username to connect as. If this is not provided, the environment variable USER will be tried. The name can be specified as username % password , user / workgroup , or user / workgroup % password .

password= string

Specifies the SMB password. If no password is provided using this option, the username option, or the credentials option, the environment variable PASSWD is used. If that also does not exist, smbmount will prompt interactively for a password.

credentials= filename

Specifies a file that contains a username and password in the following format:

 username =   value   password =   value   

uid= number

Sets the Unix user ID to be used as the owner of all files in the mounted filesystem. It can be specified as a username or numeric UID. Defaults to the UID of the user running smbmount .

gid= number

Sets the Unix group ID to be used as the group for all files in the mounted filesystem. It can be specified as a group name or a numeric GID. Defaults to the GID of the user running smbmount .

port= number

Sets the TCP port number. This is 139, which is required by most Windows versions.

fmask= octal_mask

Sets the Unix permissions of all files in the mounted filesystem. Defaults to the user's current umask.

dmask= octal_mask

Sets the Unix permissions of all directories in the mounted filesystem. Defaults to the current umask.

debug= number

Sets the debugging level.

ip= host

Sets the destination hostname or IP address.

netbiosname= name

Sets the computer name to connect as. This defaults to the hostname of the local system.

workgroup= name

Sets the workgroup or domain.

sockopt= opts

Sets TCP socket options.

scope= num

Sets the NetBIOS scope.

guest

Don't expect or prompt for a password.

ro

Mounts the share read-only.

rw

Mounts the share read-write.

iocharset= charset

Sets the charset used by the Linux machine for codepage-to-charset translation. See also the codepage option.

codepage= page

Sets the DOS code page. See also the iocharset option.

ttl= milliseconds

Sets the time to live, in milliseconds, for entries in the directory cache. A higher value gives better performance on large directories and/or slower connections. The default is 1000ms. Try 10000ms (10 seconds) as a starting value if directory operations are visibly slow.