.\" $Id: mount_smbfs.8,v 1.10 2002/04/16 02:47:41 bp Exp $ .\" $FreeBSD$ .Dd March 10, 2000 .Dt MOUNT_SMBFS 8 .Os .Sh NAME .Nm mount_smbfs .Nd "mount a shared resource from an SMB file server" .Sh SYNOPSIS .Nm .Op Fl E Ar cs1 : Ns Ar cs2 .Op Fl I Ar host .Op Fl L Ar locale .Op Fl M Ar crights : Ns Ar srights .Op Fl N .Op Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup .Op Fl R Ar retrycount .Op Fl T Ar timeout .Op Fl W Ar workgroup .Op Fl c Ar case .Op Fl d Ar mode .Op Fl f Ar mode .Op Fl g Ar gid .Op Fl n Ar opt .Op Fl u Ar uid .Sm off .No // Ar user No @ Ar server .Op Ar :port1 Op Ar :port2 .No / Ar share .Sm on .Ar node .Sh DESCRIPTION The .Nm command mounts a share from a remote server using SMB/CIFS protocol. .Pp The options are as follows: .Bl -tag -width indent .It Fl E Ar cs1 : Ns Ar cs2 Specifies local .Pq Ar cs1 and server's .Pq Ar cs2 character sets. .It Fl I Ar host Do not use NetBIOS name resolver and connect directly to .Ar host , which can be either a valid DNS name or an IP address. .It Fl L Ar locale Use .Ar locale for lower/upper case conversion routines. Set the locale for case conversion. By default, .Nm tries to use an environment variable .Ev LC_* to determine it. .It Fl M Ar crights : Ns Ar srights Assign access rights to the newly created connection. .It Fl N Do not ask for a password. At run time, .Nm reads the .Pa ~/.nsmbrc file for additional configuration parameters and a password. If no password is found, .Nm prompts for it. .It Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup Assign owner/group attributes to the newly created connection. .It Fl R Ar retrycount How many retries should be done before the SMB requester decides to drop the connection. Default is 4. .It Fl T Ar timeout Timeout in seconds for each request. Default is 15. .It Fl W Ar workgroup This option specifies the workgroup to be used in the authentication request. .It Fl c Ar case Set a .Ar case option which affects name representation. .Ar case can be one of the following: .Bl -tag -width ".Em Value" .It Em Value .Em Meaning .It Cm l All existing file names are converted to lower case. Newly created file gets a lower case. .It Cm u All existing file names are converted to upper case. Newly created file gets an upper case. .El .It Fl f Ar mode , Fl d Ar mode Specify permissions that should be assigned to files and directories. The values must be specified as octal numbers. Default value for the file mode is taken from mount point, default value for the directory mode adds execute permission where the file mode gives read permission. .Pp Note that these permissions can differ from the rights granted by SMB server. .It Fl u Ar uid , Fl g Ar gid User ID and group ID assigned to files. The default are owner and group IDs from the directory where the volume is mounted. .It No // Ns Ar user Ns @ Ns Ar server Ns Oo Ar :port1 Ns Oo Ar :port2 Oc Oc Ns No / Ns Ar share The .Nm command will use .Ar server as the NetBIOS name of remote computer, .Ar user as the remote user name and .Ar share as the resource name on a remote server. Optional .Ar port1 and .Ar port2 arguments can be used to override default values of port numbers used by communication protocols. For SMB over NetBIOS default value for .Ar port1 are 139, and .Ar port2 are 137. .It Ar node Path to mount point. .El .Sh FILES .Bl -tag -width ".Pa ~/.nsmbrc" -compact .It Pa ~/.nsmbrc Keeps static parameters for connections and other information. See .Pa /usr/share/examples/smbfs/dot.nsmbrc for details. .El .Sh EXAMPLES The following example illustrates how to connect to SMB server .Em SAMBA as user .Em GUEST , and mount shares .Em PUBLIC and .Em TMP : .Bd -literal -offset indent mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp .Ed .Pp It is possible to use .Xr fstab 5 for smbfs mounts: .Pp .Dl "//guest@samba/public /smb/public smbfs rw,noauto 0 0" .Sh AUTHORS .An Boris Popov Aq bp@butya.kz , .Aq bp@FreeBSD.org .Sh BUGS Please report bugs to the author.