From f95fb5fe3941a0ef916ac85c6ccf4aecf17aaf39 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 19 Apr 2001 21:33:44 +0000 Subject: large sync up with 2.2 (This used to be commit 96523293da19df201703fed6130f1ff9ba25324b) --- docs/htmldocs/smbmount.8.html | 190 +++++++++++++++++++++++++++++++++++++----- 1 file changed, 170 insertions(+), 20 deletions(-) (limited to 'docs/htmldocs/smbmount.8.html') diff --git a/docs/htmldocs/smbmount.8.html b/docs/htmldocs/smbmount.8.html index 94a4ae8bc8..ba07f08ed4 100644 --- a/docs/htmldocs/smbmount.8.html +++ b/docs/htmldocs/smbmount.8.html @@ -24,7 +24,7 @@ NAME="AEN5" >

Name

smbmount -- mount and smbfs filesystemsmbmount -- mount an smbfs filesystem
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.

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.smbmount. The + smbmount process may also be called mount.smbfs.

OPTIONS

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/workgroup%password" to allow the password and workgroup + 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/workgroup%password" to allow the password and workgroup to be specified as part of the username.

password=<arg>

specifies the SMB password. If not given then - 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.

will prompt + for a passeword, unless the guest option is + given.

credentials=<filename>

specifies a file that contains a username + and/or password. The format of the file is:

		username = <value>
+		password = <value>
+
+

This is preferred over having passwords in plaintext in a + shared file, such as /etc/fstab. Be sure to protect any + credentials file properly. +

netbiosname=<arg>
uid=<arg>

sets the uid that files will be mounted as. +>sets the uid that will own all files on + the mounted filesystem. It may be specified as either a username or a numeric uid.

gid=<arg>

sets the gid that files will be mounted as. +>sets the gid that will own all files on + the mounted filesystem. It may be specified as either a groupname or a numeric gid.

mount read-write

iocharset=<arg>

sets the charset used by the linux side for codepage + 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 milliseconds + (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 something + 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 password.

BUGS

Not many known smbmount bugs. But one smbfs bug is + important 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.

Note that the typical response to a bugreport is suggestion + 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 Urban Widmark

. + The SAMBA Mailing list + is the preferred place to ask questions regarding these programs. +

The conversion of this manpage for Samba 2.2 was performed by Gerald Carter