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