diff options
Diffstat (limited to 'docs/htmldocs/smbmount.8.html')
| -rw-r--r-- | docs/htmldocs/smbmount.8.html | 190 |
1 files changed, 170 insertions, 20 deletions
diff --git a/docs/htmldocs/smbmount.8.html b/docs/htmldocs/smbmount.8.html index 94a4ae8bc88..ba07f08ed47 100644 --- a/docs/htmldocs/smbmount.8.html +++ b/docs/htmldocs/smbmount.8.html @@ -24,7 +24,7 @@ NAME="AEN5" ></A ><H2 >Name</H2 ->smbmount -- mount and smbfs filesystem</DIV +>smbmount -- mount an smbfs filesystem</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A @@ -60,8 +60,17 @@ CLASS="COMMAND" > command when using the "-t smb" option. The kernel must support the smbfs filesystem. </P ><P ->Options to smbmount are specified as a comma separated list - of key=value pairs.</P +>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.</P +><P +>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.</P ><P ><I CLASS="EMPHASIS" @@ -83,7 +92,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN26" +NAME="AEN27" ></A ><H2 >OPTIONS</H2 @@ -97,26 +106,50 @@ CLASS="VARIABLELIST" ><DD ><P >specifies the username to connect as. If - this is not given then the environment variable <TT -CLASS="PARAMETER" -><I -> $USER</I -></TT -> 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 <TT +CLASS="ENVAR" +> USER</TT +> 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.</P ></DD ><DT >password=<arg></DT ><DD ><P ->specifies the SMB password. If not given then - <B +>specifies the SMB password. If this + option is not given then the environment variable + <TT +CLASS="ENVAR" +>PASSWD</TT +> is used. If it can find + no password <B CLASS="COMMAND" >smbmount</B -> will prompt for a passeword, unless - the guest option is given. </P +> will prompt + for a passeword, unless the guest option is + given. </P +></DD +><DT +>credentials=<filename></DT +><DD +><P +>specifies a file that contains a username + and/or password. The format of the file is:</P +><P +> <PRE +CLASS="PROGRAMLISTING" +> username = <value> + password = <value> + </PRE +> + </P +><P +>This is preferred over having passwords in plaintext in a + shared file, such as /etc/fstab. Be sure to protect any + credentials file properly. + </P ></DD ><DT >netbiosname=<arg></DT @@ -129,7 +162,8 @@ CLASS="COMMAND" >uid=<arg></DT ><DD ><P ->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. </P ></DD @@ -137,7 +171,8 @@ CLASS="COMMAND" >gid=<arg></DT ><DD ><P ->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. </P ></DD @@ -228,17 +263,125 @@ CLASS="PARAMETER" ><P >mount read-write </P ></DD +><DT +>iocharset=<arg></DT +><DD +><P +> 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) + </P +></DD +><DT +>codepage=<arg></DT +><DD +><P +> sets the codepage the server uses. See the iocharset + option. Example value cp850. (Note: only kernel 2.4.0 + or later) + </P +></DD +><DT +>ttl=<arg></DT +><DD +><P +> 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) + </P +></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN98" +NAME="AEN119" +></A +><H2 +>ENVIRONMENT VARIABLES</H2 +><P +>The variable <TT +CLASS="ENVAR" +>USER</TT +> 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.</P +><P +>The variable <TT +CLASS="ENVAR" +>PASSWD</TT +> 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.</P +><P +>The variable <TT +CLASS="ENVAR" +>PASSWD_FILE</TT +> may contain the pathname of + a file to read the password from. A single line of input is + read and used as password.</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN127" +></A +><H2 +>BUGS</H2 +><P +>Not many known smbmount bugs. But one smbfs bug is + important enough to mention here anyway:</P +><P +></P +><UL +><LI +><P +>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.</P +></LI +></UL +><P +>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)</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN134" +></A +><H2 +>SEE ALSO</H2 +><P +>Documentation/filesystems/smbfs.txt in the kernel source tree + may contain additional options and information.</P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN137" ></A ><H2 >AUTHOR</H2 ><P +>Volker Lendecke, Andrew Tridgell, Michael H. Warfield + and others.</P +><P >The current maintainer of smbfs and the userspace tools <B CLASS="COMMAND" @@ -254,7 +397,14 @@ CLASS="COMMAND" HREF="mailto:urban@teststation.com" TARGET="_top" >Urban Widmark</A -></P +>. + The <A +HREF="mailto:samba@samba.org" +TARGET="_top" +>SAMBA Mailing list</A +> + is the preferred place to ask questions regarding these programs. + </P ><P >The conversion of this manpage for Samba 2.2 was performed by Gerald Carter</P |