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