1.\" $Id: mount_smbfs.8,v 1.10 2002/04/16 02:47:41 bp Exp $
2.\" $FreeBSD$
3.Dd September 17, 2011
4.Dt MOUNT_SMBFS 8
5.Os
6.Sh NAME
7.Nm mount_smbfs
8.Nd "mount a shared resource from an SMB file server"
9.Sh SYNOPSIS
10.Nm
11.Op Fl E Ar cs1 : Ns Ar cs2
12.Op Fl I Ar host
13.Op Fl L Ar locale
14.Op Fl M Ar crights : Ns Ar srights
15.Op Fl N
16.Op Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
17.Op Fl R Ar retrycount
18.Op Fl T Ar timeout
19.Op Fl U Ar username
20.Op Fl W Ar workgroup
21.Op Fl c Ar case
22.Op Fl d Ar mode
23.Op Fl f Ar mode
24.Op Fl g Ar gid
25.Op Fl n Ar opt
26.Op Fl u Ar uid
27.Sm off
28.No // Ar user No @ Ar server
29.Op Ar :port1 Op Ar :port2
30.No / Ar share
31.Sm on
32.Ar node
33.Sh DESCRIPTION
34The
35.Nm
36command mounts a share from a remote server using SMB/CIFS protocol.
37.Pp
38The options are as follows:
39.Bl -tag -width indent
40.It Fl E Ar cs1 : Ns Ar cs2
41Specifies local
42.Pq Ar cs1
43and server's
44.Pq Ar cs2
45character sets.
46.It Fl I Ar host
47Do not use NetBIOS name resolver and connect directly to
48.Ar host ,
49which can be either a valid DNS name or an IP address.
50.It Fl L Ar locale
51Use
52.Ar locale
53for lower/upper case conversion routines.
54Set the locale for case conversion.
55By default,
56.Nm
57tries to use an environment variable
58.Ev LC_*
59to determine it.
60.It Fl M Ar crights : Ns Ar srights
61Assign access rights to the newly created connection.
62.It Fl N
63Do not ask for a password.
64At run time,
65.Nm
66reads the
67.Pa ~/.nsmbrc
68file for additional configuration parameters and a password.
69If no password is found,
70.Nm
71prompts for it.
72.It Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
73Assign owner/group attributes to the newly created connection.
74.It Fl R Ar retrycount
75How many retries should be done before the SMB requester decides to drop
76the connection.
77Default is 4.
78.It Fl T Ar timeout
79Timeout in seconds for each request.
80Default is 15.
81.It Fl U Ar username
82Username to authenticate with.
83.It Fl W Ar workgroup
84This option specifies the workgroup to be used in the authentication request.
85.It Fl c Ar case
86Set a
87.Ar case
88option which affects name representation.
89.Ar case
90can be one of the following:
91.Bl -tag -width ".Em Value"
92.It Em Value
93.Em Meaning
94.It Cm l
95All existing file names are converted to lower case.
96Newly created file gets a lower case.
97.It Cm u
98All existing file names are converted to upper case.
99Newly created file gets an upper case.
100.El
101.It Fl f Ar mode , Fl d Ar mode
102Specify permissions that should be assigned to files and directories.
103The values must be specified as octal numbers.
104Default value for the file mode
105is taken from mount point, default value for the directory mode adds execute
106permission where the file mode gives read permission.
107.Pp
108Note that these permissions can differ from the rights granted by SMB
109server.
110.It Fl u Ar uid , Fl g Ar gid
111User ID and group ID assigned to files.
112The default are owner and group IDs from
113the directory where the volume is mounted.
114.It No // Ns Ar user Ns @ Ns Ar server Ns Oo Ar :port1 Ns Oo Ar :port2 Oc Oc Ns No / Ns Ar share
115The
116.Nm
117command will use
118.Ar server
119as the NetBIOS name of remote computer,
120.Ar user
121as the remote user name and
122.Ar share
123as the resource name on a remote server.
124Optional
125.Ar port1
126and
127.Ar port2
128arguments can be used to override default values of port numbers used
129by communication protocols.
130For SMB over NetBIOS default value for
131.Ar port1
132are 139, and
133.Ar port2
134are 137.
135.It Ar node
136Path to mount point.
137.El
138.Sh FILES
139.Bl -tag -width ".Pa ~/.nsmbrc" -compact
140.It Pa ~/.nsmbrc
141Keeps static parameters for connections and other information.
142See
143.Pa /usr/share/examples/smbfs/dot.nsmbrc
144for details.
145.El
146.Sh EXAMPLES
147The following example illustrates how to connect to SMB server
148.Em SAMBA
149as user
150.Em GUEST ,
151and mount shares
152.Em PUBLIC
153and
154.Em TMP :
155.Bd -literal -offset indent
156mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public
157mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp
158.Ed
159.Pp
160It is also possible to use
161.Xr fstab 5
162for smbfs mounts (the example below doesn't prompt for a password):
163.Pp
164.Dl "//guest@samba/public    /smb/public     smbfs  rw,noauto,-N 0   0"
165.Sh AUTHORS
166.An Boris Popov Aq bp@butya.kz ,
167.Aq bp@FreeBSD.org
168.Sh BUGS
169Please report bugs to the author.
170