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
27 .No // Ar user No @ Ar server
28 .Op Ar :port1 Op Ar :port2
35 command mounts a share from a remote server using SMB/CIFS protocol.
37 The options are as follows:
38 .Bl -tag -width indent
39 .It Fl E Ar cs1 : Ns Ar cs2
46 Do not use NetBIOS name resolver and connect directly to
48 which can be either a valid DNS name or an IP address.
52 for lower/upper case conversion routines.
53 Set the locale for case conversion.
56 tries to use an environment variable
59 .It Fl M Ar crights : Ns Ar srights
60 Assign access rights to the newly created connection.
62 Do not ask for a password.
67 file for additional configuration parameters and a password.
68 If no password is found,
71 .It Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
72 Assign owner/group attributes to the newly created connection.
73 .It Fl R Ar retrycount
74 How many retries should be done before the SMB requester decides to drop
78 Timeout in seconds for each request.
81 This option specifies the workgroup to be used in the authentication request.
85 option which affects name representation.
87 can be one of the following:
88 .Bl -tag -width ".Em Value"
92 All existing file names are converted to lower case.
93 Newly created file gets a lower case.
95 All existing file names are converted to upper case.
96 Newly created file gets an upper case.
98 .It Fl f Ar mode , Fl d Ar mode
99 Specify permissions that should be assigned to files and directories.
100 The values must be specified as octal numbers.
101 Default value for the file mode
102 is taken from mount point, default value for the directory mode adds execute
103 permission where the file mode gives read permission.
105 Note that these permissions can differ from the rights granted by SMB
107 .It Fl u Ar uid , Fl g Ar gid
108 User ID and group ID assigned to files.
109 The default are owner and group IDs from
110 the 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
116 as the NetBIOS name of remote computer,
118 as the remote user name and
120 as the resource name on a remote server.
125 arguments can be used to override default values of port numbers used
126 by communication protocols.
127 For SMB over NetBIOS default value for
136 .Bl -tag -width ".Pa ~/.nsmbrc" -compact
138 Keeps static parameters for connections and other information.
140 .Pa /usr/share/examples/smbfs/dot.nsmbrc
144 The following example illustrates how to connect to SMB server
152 .Bd -literal -offset indent
153 mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public
154 mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp
157 It is possible to use
161 .Dl "//guest@samba/public /smb/public smbfs rw,noauto 0 0"
163 .An Boris Popov Aq bp@butya.kz ,
166 Please report bugs to the author.