1.\" $Id: mount_smbfs.8,v 1.10 2002/04/16 02:47:41 bp Exp $ 2.\" $FreeBSD$ 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. 77.It Fl T Ar timeout 78Timeout in seconds for each request. 79Default is 15. 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. 167