From 55abd936a838a4410899db76cb5530b0c4694dc9 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Wed, 10 Oct 2001 17:19:10 +0000 Subject: mega-merge from 2.2 (This used to be commit c76bf8ed3275e217d1b691879153fe9137bcbe38) --- docs/htmldocs/smbmount.8.html | 100 ++++++++++++++++++++++++++++++------------ 1 file changed, 73 insertions(+), 27 deletions(-) (limited to 'docs/htmldocs/smbmount.8.html') diff --git a/docs/htmldocs/smbmount.8.html b/docs/htmldocs/smbmount.8.html index c8c9727be9..b7263ebf83 100644 --- a/docs/htmldocs/smbmount.8.html +++ b/docs/htmldocs/smbmount.8.html @@ -49,28 +49,41 @@ NAME="AEN14" >smbmount mounts a SMB filesystem. It +> mounts a Linux SMB filesystem. It is usually invoked as mount.smb from +>mount.smbfs by 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 +>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 +>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.

log.smbmount. The + smbmount process may also be called mount.smbfs.

NOTE:

OPTIONS

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. However, the same password defined + in the PASSWD environment variable or a credentials file (see + below) will be read correctly. +

credentials=<filename>

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

dmask=<arg>

sets the directory mask. This deterines the +>sets the directory mask. This determines the permissions that remote directories have in the local filesystem. The default is based on the current umask.

sets the debug level. This is useful for - tracking down SMB connection problems.

ip=<arg>
iocharset=<arg>

sets the charset used by the linux side for codepage +> 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) @@ -311,7 +336,7 @@ CLASS="PARAMETER" >

ENVIRONMENT VARIABLES

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.

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 - important enough to mention here anyway:

Passwords and other options containing , can not be handled. + For passwords an alternative way of passing them is in a credentials + file or in the PASSWD environment.

The credentials file does not handle usernames or passwords with + leading space.

One smbfs bug is important enough to mention here, even if it + is a bit misplaced:

    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 + reconnect when the server disconnects, the mount will eventually go + dead. An umount/mount normally fixes this. At least 2 ways to trigger this bug are known.

Note that the typical response to a bugreport is suggestion +>Note that the typical response to a bug report 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.

Documentation/filesystems/smbfs.txt in the linux kernel + source tree may contain additional options and information.

FreeBSD also has a smbfs, but it is not related to smbmount

For Solaris, HP-UX and others you may want to look at + smbsh(1) or at other + solutions, such as sharity or perhaps replacing the SMB server with + a NFS server.

AUTHOR