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