docs/manpages/smbmount.8

   1 .\" This manpage has been automatically generated by docbook2man-spec
   2 .\" from a DocBook document.  docbook2man-spec can be found at:
   3 .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
   4 .\" Please send any bug reports, improvements, comments, patches,
   5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6 .TH "SMBMOUNT" "8" "28 January 2002" "" ""
   7 .SH NAME
   8 smbmount \- mount an smbfs filesystem
   9 .SH SYNOPSIS
  10 .sp
  11 \fBsmbumount\fR \fBservice\fR \fBmount-point\fR [ \fB-o options\fR ]
  12 .SH "DESCRIPTION"
  13 .PP
  14 \fBsmbmount\fR mounts a Linux SMB filesystem. It
  15 is usually invoked as \fBmount.smbfs\fR by
  16 the \fBmount(8)\fR command when using the
  17 "-t smbfs" option. This command only works in Linux, and the kernel must
  18 support the smbfs filesystem.
  19 .PP
  20 Options to \fBsmbmount\fR are specified as a comma-separated
  21 list of key=value pairs. It is possible to send options other
  22 than those listed here, assuming that smbfs supports them. If
  23 you get mount failures, check your kernel log for errors on
  24 unknown options.
  25 .PP
  26 \fBsmbmount\fR is a daemon. After mounting it keeps running until
  27 the mounted smbfs is umounted. It will log things that happen
  28 when in daemon mode using the "machine name" smbmount, so
  29 typically this output will end up in \fIlog.smbmount\fR. The
  30 \fBsmbmount\fR process may also be called mount.smbfs.
  31 .PP
  32 \fBNOTE:\fR \fBsmbmount\fR
  33 calls \fBsmbmnt(8)\fR to do the actual mount. You
  34 must make sure that \fBsmbmnt\fR is in the path so
  35 that it can be found.
  36 .SH "OPTIONS"
  37 .TP
  38 \fBusername=<arg>\fR
  39 specifies the username to connect as. If
  40 this is not given, then the environment variable \fB USER\fR is used. This option can also take the
  41 form "user%password" or "user/workgroup" or
  42 "user/workgroup%password" to allow the password and workgroup
  43 to be specified as part of the username.
  44 .TP
  45 \fBpassword=<arg>\fR
  46 specifies the SMB password. If this
  47 option is not given then the environment variable
  48 \fBPASSWD\fR is used. If it can find
  49 no password \fBsmbmount\fR will prompt
  50 for a passeword, unless the guest option is
  51 given.
  52
  53 Note that password which contain the arguement delimiter
  54 character (i.e. a comma ',') will failed to be parsed correctly
  55 on the command line. However, the same password defined
  56 in the PASSWD environment variable or a credentials file (see
  57 below) will be read correctly.
  58 .TP
  59 \fBcredentials=<filename>\fR
  60 specifies a file that contains a username
  61 and/or password. The format of the file is:
  62
  63 .sp
  64 .nf
  65                 username = <value>
  66                 password = <value>
  67
  68 .sp
  69 .fi
  70
  71 This is preferred over having passwords in plaintext in a
  72 shared file, such as \fI/etc/fstab\fR. Be sure to protect any
  73 credentials file properly.
  74 .TP
  75 \fBnetbiosname=<arg>\fR
  76 sets the source NetBIOS name. It defaults
  77 to the local hostname.
  78 .TP
  79 \fBuid=<arg>\fR
  80 sets the uid that will own all files on
  81 the mounted filesystem.
  82 It may be specified as either a username or a numeric uid.
  83 .TP
  84 \fBgid=<arg>\fR
  85 sets the gid that will own all files on
  86 the mounted filesystem.
  87 It may be specified as either a groupname or a numeric
  88 gid.
  89 .TP
  90 \fBport=<arg>\fR
  91 sets the remote SMB port number. The default
  92 is 139.
  93 .TP
  94 \fBfmask=<arg>\fR
  95 sets the file mask. This determines the
  96 permissions that remote files have in the local filesystem.
  97 The default is based on the current umask.
  98 .TP
  99 \fBdmask=<arg>\fR
 100 sets the directory mask. This determines the
 101 permissions that remote directories have in the local filesystem.
 102 The default is based on the current umask.
 103 .TP
 104 \fBdebug=<arg>\fR
 105 sets the debug level. This is useful for
 106 tracking down SMB connection problems. A suggested value to
 107 start with is 4. If set too high there will be a lot of
 108 output, possibly hiding the useful output.
 109 .TP
 110 \fBip=<arg>\fR
 111 sets the destination host or IP address.
 112 .TP
 113 \fBworkgroup=<arg>\fR
 114 sets the workgroup on the destination
 115 .TP
 116 \fBsockopt=<arg>\fR
 117 sets the TCP socket options. See the \fIsmb.conf
 118 \fR\fIsocket options\fR option.
 119 .TP
 120 \fBscope=<arg>\fR
 121 sets the NetBIOS scope
 122 .TP
 123 \fBguest\fR
 124 don't prompt for a password
 125 .TP
 126 \fBro\fR
 127 mount read-only
 128 .TP
 129 \fBrw\fR
 130 mount read-write
 131 .TP
 132 \fBiocharset=<arg>\fR
 133 sets the charset used by the Linux side for codepage
 134 to charset translations (NLS). Argument should be the
 135 name of a charset, like iso8859-1. (Note: only kernel
 136 2.4.0 or later)
 137 .TP
 138 \fBcodepage=<arg>\fR
 139 sets the codepage the server uses. See the iocharset
 140 option. Example value cp850. (Note: only kernel 2.4.0
 141 or later)
 142 .TP
 143 \fBttl=<arg>\fR
 144 how long a directory listing is cached in milliseconds
 145 (also affects visibility of file size and date
 146 changes). A higher value means that changes on the
 147 server take longer to be noticed but it can give
 148 better performance on large directories, especially
 149 over long distances. Default is 1000ms but something
 150 like 10000ms (10 seconds) is probably more reasonable
 151 in many cases.
 152 (Note: only kernel 2.4.2 or later)
 153 .SH "ENVIRONMENT VARIABLES"
 154 .PP
 155 The variable \fBUSER\fR may contain the username of the
 156 person using the client. This information is used only if the
 157 protocol level is high enough to support session-level
 158 passwords. The variable can be used to set both username and
 159 password by using the format username%password.
 160 .PP
 161 The variable \fBPASSWD\fR may contain the password of the
 162 person using the client. This information is used only if the
 163 protocol level is high enough to support session-level
 164 passwords.
 165 .PP
 166 The variable \fBPASSWD_FILE\fR may contain the pathname
 167 of a file to read the password from. A single line of input is
 168 read and used as the password.
 169 .SH "BUGS"
 170 .PP
 171 Passwords and other options containing , can not be handled.
 172 For passwords an alternative way of passing them is in a credentials
 173 file or in the PASSWD environment.
 174 .PP
 175 The credentials file does not handle usernames or passwords with
 176 leading space.
 177 .PP
 178 One smbfs bug is important enough to mention here, even if it
 179 is a bit misplaced:
 180 .TP 0.2i
 181 \(bu
 182 Mounts sometimes stop working. This is usually
 183 caused by smbmount terminating. Since smbfs needs smbmount to
 184 reconnect when the server disconnects, the mount will eventually go
 185 dead. An umount/mount normally fixes this. At least 2 ways to
 186 trigger this bug are known.
 187 .PP
 188 Note that the typical response to a bug report is suggestion
 189 to try the latest version first. So please try doing that first,
 190 and always include which versions you use of relevant software
 191 when reporting bugs (minimum: samba, kernel, distribution)
 192 .PP
 193 .SH "SEE ALSO"
 194 .PP
 195 Documentation/filesystems/smbfs.txt in the linux kernel
 196 source tree may contain additional options and information.
 197 .PP
 198 FreeBSD also has a smbfs, but it is not related to smbmount
 199 .PP
 200 For Solaris, HP-UX and others you may want to look at
 201 \fBsmbsh(1)\fRor at other
 202 solutions, such as sharity or perhaps replacing the SMB server with
 203 a NFS server.
 204 .SH "AUTHOR"
 205 .PP
 206 Volker Lendecke, Andrew Tridgell, Michael H. Warfield
 207 and others.
 208 .PP
 209 The current maintainer of smbfs and the userspace
 210 tools \fBsmbmount\fR, \fBsmbumount\fR,
 211 and \fBsmbmnt\fR is Urban Widmark <URL:mailto:urban@teststation.com>.
 212 The SAMBA Mailing list <URL:mailto:samba@samba.org>
 213 is the preferred place to ask questions regarding these programs.
 214 .PP
 215 The conversion of this manpage for Samba 2.2 was performed
 216 by Gerald Carter