summaryrefslogtreecommitdiff
path: root/docs/manpages/smbmount.8
blob: 259dea7d6de445fa5e6cefc29a143d62a35da331 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
.\" This manpage has been automatically generated by docbook2man-spec
.\" from a DocBook document.  docbook2man-spec can be found at:
.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SMBMOUNT" "8" "23 February 2001" "" ""
.SH NAME
smbmount \- mount and smbfs filesystem
.SH SYNOPSIS
.sp
\fBsmbumount\fR \fBservice\fR \fBmount-point\fR [ \fB-o options\fR ] 
.SH "DESCRIPTION"
.PP
\fBsmbmount\fR mounts a SMB filesystem. It 
is usually invoked as \fBmount.smb\fR from 
the \fBmount(8)\fR command when using the 
"-t smb" option. The kernel must support the smbfs filesystem. 
.PP
Options to smbmount are specified as a comma separated list 
of key=value pairs.
.PP
\fBNOTE:\fR \fBsmbmount\fR 
calls \fBsmbmnt(8)\fR to do the actual mount. You 
must make sure that \fBsmbmnt\fR is in the path so 
that it can be found. 
.SH "OPTIONS"
.TP
\fBusername=<arg>\fR
specifies the username to connect as. If
this is not given then the environment variable \fI $USER\fR 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.
.TP
\fBpassword=<arg>\fR
specifies the SMB password. If not given then 
\fBsmbmount\fR will prompt for a passeword, unless 
the guest option is given. 
.TP
\fBnetbiosname=<arg>\fR
sets the source NetBIOS name. It defaults 
to the local hostname. 
.TP
\fBuid=<arg>\fR
sets the uid that files will be mounted as. 
It may be specified as either a username or a numeric uid.
.TP
\fBgid=<arg>\fR
sets the gid that files will be mounted as. 
It may be specified as either a groupname or a numeric 
gid. 
.TP
\fBport=<arg>\fR
sets the remote SMB port number. The default 
is 139. 
.TP
\fBfmask=<arg>\fR
sets the file mask. This determines the 
permissions that remote files have in the local filesystem. 
The default is based on the current umask. 
.TP
\fBdmask=<arg>\fR
sets the directory mask. This deterines the 
permissions that remote directories have in the local filesystem. 
The default is based on the current umask. 
.TP
\fBdebug=<arg>\fR
sets the debug level. This is useful for 
tracking down SMB connection problems. 
.TP
\fBip=<arg>\fR
sets the destination host or IP address.
.TP
\fBworkgroup=<arg>\fR
sets the workgroup on the destination 
.TP
\fBsockopt=<arg>\fR
sets the TCP socket options. See the \fIsmb.conf
\fR <URL:smb.conf.5.html#SOCKETOPTIONS> \fIsocket options\fR option.
.TP
\fBscope=<arg>\fR
sets the NetBIOS scope 
.TP
\fBguest\fR
don't prompt for a password 
.TP
\fBro\fR
mount read-only 
.TP
\fBrw\fR
mount read-write 
.SH "AUTHOR"
.PP
The current maintainer of smbfs and the userspace
tools \fBsmbmount\fR, \fBsmbumount\fR,
and \fBsmbmnt\fR is Urban Widmark <URL:mailto:urban@teststation.com>
.PP
The conversion of this manpage for Samba 2.2 was performed 
by Gerald Carter