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. 76.It Fl T Ar timeout 77Timeout in seconds for each request. 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. 165