1 .\" $Id: mount_smbfs.8,v 1.10 2002/04/16 02:47:41 bp Exp $
8 .Nd "mount a shared resource from an SMB file server"
11 .Op Fl E Ar cs1 : Ns Ar cs2
14 .Op Fl M Ar crights : Ns Ar srights
16 .Op Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
17 .Op Fl R Ar retrycount
28 .No // Ar user No @ Ar server
29 .Op Ar :port1 Op Ar :port2
36 command mounts a share from a remote server using SMB/CIFS protocol.
38 The options are as follows:
39 .Bl -tag -width indent
40 .It Fl E Ar cs1 : Ns Ar cs2
47 Do not use NetBIOS name resolver and connect directly to
49 which can be either a valid DNS name or an IP address.
53 for lower/upper case conversion routines.
54 Set the locale for case conversion.
57 tries to use an environment variable
60 .It Fl M Ar crights : Ns Ar srights
61 Assign access rights to the newly created connection.
63 Do not ask for a password.
68 file for additional configuration parameters and a password.
69 If no password is found,
72 .It Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
73 Assign owner/group attributes to the newly created connection.
74 .It Fl R Ar retrycount
75 How many retries should be done before the SMB requester decides to drop
79 Timeout in seconds for each request.
82 Username to authenticate with.
84 This option specifies the workgroup to be used in the authentication request.
88 option which affects name representation.
90 can be one of the following:
91 .Bl -tag -width ".Em Value"
95 All existing file names are converted to lower case.
96 Newly created file gets a lower case.
98 All existing file names are converted to upper case.
99 Newly created file gets an upper case.
101 .It Fl f Ar mode , Fl d Ar mode
102 Specify permissions that should be assigned to files and directories.
103 The values must be specified as octal numbers.
104 Default value for the file mode
105 is taken from mount point, default value for the directory mode adds execute
106 permission where the file mode gives read permission.
108 Note that these permissions can differ from the rights granted by SMB
110 .It Fl u Ar uid , Fl g Ar gid
111 User ID and group ID assigned to files.
112 The default are owner and group IDs from
113 the 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
119 as the NetBIOS name of remote computer,
121 as the remote user name and
123 as the resource name on a remote server.
128 arguments can be used to override default values of port numbers used
129 by communication protocols.
130 For SMB over NetBIOS default value for
139 .Bl -tag -width ".Pa ~/.nsmbrc" -compact
141 Keeps static parameters for connections and other information.
143 .Pa /usr/share/examples/smbfs/dot.nsmbrc
147 The following example illustrates how to connect to SMB server
155 .Bd -literal -offset indent
156 mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public
157 mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp
160 It is possible to use
164 .Dl "//guest@samba/public /smb/public smbfs rw,noauto 0 0"
166 .An Boris Popov Aq bp@butya.kz ,
169 Please report bugs to the author.