Changeset 286 for branches/samba-3.0/docs/manpages/smbmount.8
- Timestamp:
- Jun 24, 2009, 5:09:21 PM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.0/docs/manpages/smbmount.8
r158 r286 1 1 .\" Title: smbmount 2 .\" Author: 3 .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/> 4 .\" Date: 08/25/2008 5 .\" Manual: 6 .\" Source: 2 .\" Author: [see the "AUTHOR" section] 3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> 4 .\" Date: 06/22/2009 5 .\" Manual: [FIXME: manual] 6 .\" Source: [FIXME: source] 7 .\" Language: English 7 8 .\" 8 .TH "SMBMOUNT" "8" "08/25/2008" "" "" 9 .TH "SMBMOUNT" "8" "06/22/2009" "[FIXME: source]" "[FIXME: manual]" 10 .\" ----------------------------------------------------------------- 11 .\" * (re)Define some macros 12 .\" ----------------------------------------------------------------- 13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 14 .\" toupper - uppercase a string (locale-aware) 15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 16 .de toupper 17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ 18 \\$* 19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz 20 .. 21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 22 .\" SH-xref - format a cross-reference to an SH section 23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 24 .de SH-xref 25 .ie n \{\ 26 .\} 27 .toupper \\$* 28 .el \{\ 29 \\$* 30 .\} 31 .. 32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 33 .\" SH - level-one heading that works better for non-TTY output 34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 35 .de1 SH 36 .\" put an extra blank line of space above the head in non-TTY output 37 .if t \{\ 38 .sp 1 39 .\} 40 .sp \\n[PD]u 41 .nr an-level 1 42 .set-an-margin 43 .nr an-prevailing-indent \\n[IN] 44 .fi 45 .in \\n[an-margin]u 46 .ti 0 47 .HTML-TAG ".NH \\n[an-level]" 48 .it 1 an-trap 49 .nr an-no-space-flag 1 50 .nr an-break-flag 1 51 \." make the size of the head bigger 52 .ps +3 53 .ft B 54 .ne (2v + 1u) 55 .ie n \{\ 56 .\" if n (TTY output), use uppercase 57 .toupper \\$* 58 .\} 59 .el \{\ 60 .nr an-break-flag 0 61 .\" if not n (not TTY), use normal case (not uppercase) 62 \\$1 63 .in \\n[an-margin]u 64 .ti 0 65 .\" if not n (not TTY), put a border/line under subheading 66 .sp -.6 67 \l'\n(.lu' 68 .\} 69 .. 70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 71 .\" SS - level-two heading that works better for non-TTY output 72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 73 .de1 SS 74 .sp \\n[PD]u 75 .nr an-level 1 76 .set-an-margin 77 .nr an-prevailing-indent \\n[IN] 78 .fi 79 .in \\n[IN]u 80 .ti \\n[SN]u 81 .it 1 an-trap 82 .nr an-no-space-flag 1 83 .nr an-break-flag 1 84 .ps \\n[PS-SS]u 85 \." make the size of the head bigger 86 .ps +2 87 .ft B 88 .ne (2v + 1u) 89 .if \\n[.$] \&\\$* 90 .. 91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 92 .\" BB/BE - put background/screen (filled box) around block of text 93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 94 .de BB 95 .if t \{\ 96 .sp -.5 97 .br 98 .in +2n 99 .ll -2n 100 .gcolor red 101 .di BX 102 .\} 103 .. 104 .de EB 105 .if t \{\ 106 .if "\\$2"adjust-for-leading-newline" \{\ 107 .sp -1 108 .\} 109 .br 110 .di 111 .in 112 .ll 113 .gcolor 114 .nr BW \\n(.lu-\\n(.i 115 .nr BH \\n(dn+.5v 116 .ne \\n(BHu+.5v 117 .ie "\\$2"adjust-for-leading-newline" \{\ 118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 119 .\} 120 .el \{\ 121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 122 .\} 123 .in 0 124 .sp -.5v 125 .nf 126 .BX 127 .in 128 .sp .5v 129 .fi 130 .\} 131 .. 132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 133 .\" BM/EM - put colored marker in margin next to block of text 134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 135 .de BM 136 .if t \{\ 137 .br 138 .ll -2n 139 .gcolor red 140 .di BX 141 .\} 142 .. 143 .de EM 144 .if t \{\ 145 .br 146 .di 147 .ll 148 .gcolor 149 .nr BH \\n(dn 150 .ne \\n(BHu 151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] 152 .in 0 153 .nf 154 .BX 155 .in 156 .fi 157 .\} 158 .. 159 .\" ----------------------------------------------------------------- 160 .\" * set default formatting 161 .\" ----------------------------------------------------------------- 9 162 .\" disable hyphenation 10 163 .nh 11 164 .\" disable justification (adjust text to left margin only) 12 165 .ad l 13 .SH "NAME" 14 smbmount - mount an smbfs filesystem 15 .SH "SYNOPSIS" 16 .HP 1 17 smbmount {service} {mount\-point} [\-o\ options] 166 .\" ----------------------------------------------------------------- 167 .\" * MAIN CONTENT STARTS HERE * 168 .\" ----------------------------------------------------------------- 169 .SH "Name" 170 smbmount \- mount an smbfs filesystem 171 .SH "Synopsis" 172 .fam C 173 .HP \w'\ 'u 174 \FCsmbmount\F[] {service} {mount\-point} [\-o\ options] 175 .fam 18 176 .SH "DESCRIPTION" 19 177 .PP 20 smbmount 21 mounts a Linux SMB filesystem\ . It is usually invoked as22 mount\.smbfs 178 \FCsmbmount\F[] 179 mounts a Linux SMB filesystem\&. It is usually invoked as 180 \FCmount\&.smbfs\F[] 23 181 by the 24 182 \fBmount\fR(8) 25 command when using the "\-t smbfs" option\ . This command only works in Linux, and the kernel must support the smbfs filesystem\.183 command when using the "\-t smbfs" option\&. This command only works in Linux, and the kernel must support the smbfs filesystem\&. 26 184 .PP 27 185 WARNING: 28 smbmount 29 is deprecated and not maintained any longer\ .30 mount\.cifs 186 \FCsmbmount\F[] 187 is deprecated and not maintained any longer\&. 188 \FCmount\&.cifs\F[] 31 189 (mount \-t cifs) should be used instead of 32 smbmount\.190 \FCsmbmount\F[]\&. 33 191 .PP 34 192 Options to 35 smbmount 36 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\. 37 .PP 38 smbmount 39 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 40 \fIlog\.smbmount\fR\. The 41 smbmount 42 process may also be called mount\.smbfs\. 43 .sp 193 \FCsmbmount\F[] 194 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\&. 195 .PP 196 \FCsmbmount\F[] 197 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 198 \FClog\&.smbmount\F[]\&. The 199 \FC smbmount\F[] 200 process may also be called mount\&.smbfs\&. 201 .if n \{\ 202 .sp 203 .\} 204 .RS 4 205 .BM yellow 44 206 .it 1 an-trap 45 207 .nr an-no-space-flag 1 46 208 .nr an-break-flag 1 47 209 .br 48 Note 210 .ps +1 211 \fBNote\fR 212 .ps -1 213 .br 49 214 .PP 50 215 51 smbmount 216 \FCsmbmount\F[] 52 217 calls 53 218 \fBsmbmnt\fR(8) 54 to do the actual mount\. You must make sure that 55 smbmnt 56 is in the path so that it can be found\. 219 to do the actual mount\&. You must make sure that 220 \FCsmbmnt\F[] 221 is in the path so that it can be found\&. 222 .sp .5v 223 .EM yellow 224 .RE 57 225 .SH "OPTIONS" 58 226 .PP 59 227 username=<arg> 60 228 .RS 4 61 specifies the username to connect as\ . If this is not given, then the environment variable229 specifies the username to connect as\&. If this is not given, then the environment variable 62 230 \fB USER\fR 63 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\.231 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\&. 64 232 .RE 65 233 .PP 66 234 password=<arg> 67 235 .RS 4 68 specifies the SMB password\ . If this option is not given then the environment variable69 PASSWD 70 is used\ . If it can find no password71 smbmount 72 will prompt for a password, unless the guest option is given\ .73 .sp 74 Note that passwords which contain the argument 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\.236 specifies the SMB password\&. If this option is not given then the environment variable 237 \FCPASSWD\F[] 238 is used\&. If it can find no password 239 \FCsmbmount\F[] 240 will prompt for a password, unless the guest option is given\&. 241 .sp 242 Note that passwords which contain the argument 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\&. 75 243 .RE 76 244 .PP 77 245 credentials=<filename> 78 246 .RS 4 79 specifies a file that contains a username and/or password\. The format of the file is: 80 .sp 81 .RS 4 247 specifies a file that contains a username and/or password\&. The format of the file is: 248 .sp 249 .if n \{\ 250 .RS 4 251 .\} 252 .fam C 253 .ps -1 82 254 .nf 255 .if t \{\ 256 .sp -1 257 .\} 258 .BB lightgray adjust-for-leading-newline 259 .sp -1 260 83 261 username=value 84 262 password=value 263 .EB lightgray adjust-for-leading-newline 264 .if t \{\ 265 .sp 1 266 .\} 85 267 .fi 86 .RE 268 .fam 269 .ps +1 270 .if n \{\ 271 .RE 272 .\} 87 273 .sp 88 274 This is preferred over having passwords in plaintext in a shared file, such as 89 \ fI/etc/fstab\fR\. Be sure to protect any credentials file properly\.275 \FC/etc/fstab\F[]\&. Be sure to protect any credentials file properly\&. 90 276 .RE 91 277 .PP 92 278 krb 93 279 .RS 4 94 Use kerberos (Active Directory)\ .280 Use kerberos (Active Directory)\&. 95 281 .RE 96 282 .PP 97 283 netbiosname=<arg> 98 284 .RS 4 99 sets the source NetBIOS name\ . It defaults to the local hostname\.285 sets the source NetBIOS name\&. It defaults to the local hostname\&. 100 286 .RE 101 287 .PP 102 288 uid=<arg> 103 289 .RS 4 104 sets the uid that will own all files on the mounted filesystem\ . It may be specified as either a username or a numeric uid\.290 sets the uid that will own all files on the mounted filesystem\&. It may be specified as either a username or a numeric uid\&. 105 291 .RE 106 292 .PP 107 293 gid=<arg> 108 294 .RS 4 109 sets the gid that will own all files on the mounted filesystem\ . It may be specified as either a groupname or a numeric gid\.295 sets the gid that will own all files on the mounted filesystem\&. It may be specified as either a groupname or a numeric gid\&. 110 296 .RE 111 297 .PP 112 298 port=<arg> 113 299 .RS 4 114 sets the remote SMB port number\ . The default is 445, fallback is 139\.300 sets the remote SMB port number\&. The default is 445, fallback is 139\&. 115 301 .RE 116 302 .PP 117 303 fmask=<arg> 118 304 .RS 4 119 sets the file mask\ . This determines the permissions that remote files have in the local filesystem\. This is not a umask, but the actual permissions for the files\. The default is based on the current umask\.305 sets the file mask\&. This determines the permissions that remote files have in the local filesystem\&. This is not a umask, but the actual permissions for the files\&. The default is based on the current umask\&. 120 306 .RE 121 307 .PP 122 308 dmask=<arg> 123 309 .RS 4 124 Sets the directory mask\ . This determines the permissions that remote directories have in the local filesystem\. This is not a umask, but the actual permissions for the directories\. The default is based on the current umask\.310 Sets the directory mask\&. This determines the permissions that remote directories have in the local filesystem\&. This is not a umask, but the actual permissions for the directories\&. The default is based on the current umask\&. 125 311 .RE 126 312 .PP 127 313 debug=<arg> 128 314 .RS 4 129 Sets the debug level\ . This is useful for tracking down SMB connection problems\. A suggested value to start with is 4\. If set too high there will be a lot of output, possibly hiding the useful output\.315 Sets the debug level\&. This is useful for tracking down SMB connection problems\&. A suggested value to start with is 4\&. If set too high there will be a lot of output, possibly hiding the useful output\&. 130 316 .RE 131 317 .PP 132 318 ip=<arg> 133 319 .RS 4 134 Sets the destination host or IP address\ .320 Sets the destination host or IP address\&. 135 321 .RE 136 322 .PP … … 142 328 sockopt=<arg> 143 329 .RS 4 144 Sets the TCP socket options\ . See the330 Sets the TCP socket options\&. See the 145 331 \fBsmb.conf\fR(5) 146 332 \fIsocket options\fR 147 option\ .333 option\&. 148 334 .RE 149 335 .PP … … 170 356 iocharset=<arg> 171 357 .RS 4 172 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)358 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) 173 359 .RE 174 360 .PP 175 361 codepage=<arg> 176 362 .RS 4 177 sets the codepage the server uses\ . See the iocharset option\. Example value cp850\. (Note: only kernel 2\.4\.0 or later)363 sets the codepage the server uses\&. See the iocharset option\&. Example value cp850\&. (Note: only kernel 2\&.4\&.0 or later) 178 364 .RE 179 365 .PP 180 366 ttl=<arg> 181 367 .RS 4 182 sets 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)368 sets 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) 183 369 .RE 184 370 .SH "ENVIRONMENT VARIABLES" … … 186 372 The variable 187 373 \fBUSER\fR 188 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\.374 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\&. 189 375 .PP 190 376 The variable 191 377 \fBPASSWD\fR 192 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\.378 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\&. 193 379 .PP 194 380 The variable 195 381 \fBPASSWD_FILE\fR 196 may contain the pathname of a file to read the password from\ . A single line of input is read and used as the password\.382 may contain the pathname of a file to read the password from\&. A single line of input is read and used as the password\&. 197 383 .SH "OTHER COMMANDS" 198 384 .PP 199 385 File systems that have been mounted using the 200 smbmount 386 \FCsmbmount\F[] 201 387 can be unmounted using the 202 smbumount 388 \FCsmbumount\F[] 203 389 or the UNIX system 204 umount 205 command\ .390 \FCumount\F[] 391 command\&. 206 392 .SH "BUGS" 207 393 .PP 208 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\.209 .PP 210 The credentials file does not handle usernames or passwords with leading space\ .394 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\&. 395 .PP 396 The credentials file does not handle usernames or passwords with leading space\&. 211 397 .PP 212 398 One smbfs bug is important enough to mention here, even if it is a bit misplaced: … … 220 406 .IP \(bu 2.3 221 407 .\} 222 Mounts sometimes stop working\ . This is usually caused by smbmount terminating\. Since smbfs needs smbmount 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\.223 .sp 224 .RE 225 .PP 226 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)408 Mounts sometimes stop working\&. This is usually caused by smbmount terminating\&. Since smbfs needs smbmount 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\&. 409 .sp 410 .RE 411 .PP 412 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) 227 413 .SH "SEE ALSO" 228 414 .PP 229 Documentation/filesystems/smbfs\ .txt in the linux kernel source tree may contain additional options and information\.415 Documentation/filesystems/smbfs\&.txt in the linux kernel source tree may contain additional options and information\&. 230 416 .PP 231 417 FreeBSD also has a smbfs, but it is not related to smbmount … … 233 419 For Solaris, HP\-UX and others you may want to look at 234 420 \fBsmbsh\fR(1) 235 or at other solutions, such as Sharity or perhaps replacing the SMB server with a NFS server\ .421 or at other solutions, such as Sharity or perhaps replacing the SMB server with a NFS server\&. 236 422 .SH "AUTHOR" 237 423 .PP 238 Volker Lendecke, Andrew Tridgell, Michael H\ . Warfield and others\.424 Volker Lendecke, Andrew Tridgell, Michael H\&. Warfield and others\&. 239 425 .PP 240 426 The current maintainer of smbfs and the userspace tools 241 smbmount,242 smbumount, and243 smbmnt 427 \FCsmbmount\F[], 428 \FCsmbumount\F[], and 429 \FCsmbmnt\F[] 244 430 is 245 Urban Widmark\ . The431 Urban Widmark\&. The 246 432 SAMBA Mailing list 247 is the preferred place to ask questions regarding these programs\ .248 .PP 249 The conversion of this manpage for Samba 2\ .2 was performed by Gerald Carter\. The conversion to DocBook XML 4\.2 for Samba 3\.0 was done by Alexander Bokovoy\.433 is the preferred place to ask questions regarding these programs\&. 434 .PP 435 The conversion of this manpage for Samba 2\&.2 was performed by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.
Note:
See TracChangeset
for help on using the changeset viewer.