Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MOUNT_SMBFS(8)		FreeBSD	System Manager's Manual		MOUNT_SMBFS(8)

     mount_smbfs -- mounts a shared resource from an SMB file server

     mount_smbfs [-E cs1:cs2] [-I host]	[-L locale] [-M	crights:srights] [-N]
		 [-O cowner:cgroup/sowner:sgroup] [-R retrycount] [-T timeout]
		 [-W workgroup]	[-c case] [-d mode] [-f	mode] [-g gid]
		 [-n opt] [-u uid] //user@server/share node

     The mount_smbfs command mounts a share from a remote server using
     SMB/CIFS protocol.

     The options are:

     -E	cs1:cs2
	     Specifies local (cs1) and server's	(cs2) character	sets.

     -I	host
	     Do	not use	NetBIOS	name resolver and connect directly to host,
	     which can be either a valid DNS name or an	IP address.

     -L	locale
	     Use locale	for lower/upper	case conversion	routines.  Set the
	     locale for	case conversion.  By default mount_smbfs tries to use
	     an	environment variable LC_* to determine it.

     -M	crights:srights
	     Assign access rights to the newly created connection.  See
	     nsmb(8) for theory.

     -N	     Do	not ask	for a password.	 At run	time, mount_smbfs reads	the
	     ~/.nsmbrc file for	additional configuration parameters and	a
	     password.	If no password is found	the mount_smbfs	prompts	for

     -O	cowner:cgroup/sowner:sgroup
	     Assign owner/group	attributes to the newly	created	connection.
	     See nsmb(8) for theory.

     -R	retrycount
	     How many retries should be	done before the	SMB requester decides
	     to	drop the connection.

     -T	timeout
	     Timeout in	seconds	for each request.

     -W	workgroup
	     This option specifies the workgroup to be used in the authentica-
	     tion request.

     -c	case
	     Set a case	option which affects name representation.  case	can be
	     one of the	following:

	     Value    Meaning

	     l	      All existing file	names converted	to lower case.	Newly
		      created file gets	a lower	case.

	     u	      All existing file	names converted	to upper case.	Newly
		      created file gets	an upper case unde.

     -f	mode, -d mode
	     Specify permissions that should be	assigned to files and directo-
	     ries.  The	values must be specified as octal numbers.  Default
	     value for the file	mode is	taken from mount point,	default	value
	     for the dir mode adds execute permission where the	file mode
	     gives read	permission.

	     Note that these permissions can differ from the rights granted by
	     SMB server.

     -u	uid, -g	gid
	     User id and group id assigned to files.  The default is owner and
	     group id from directory where the volume is mounted.

	     The mount_smbfs command will use server as	the NetBIOS name of
	     remote computer, user as the remote user name and share as	the
	     resource name on a	remote server.

     node    Path to mount point.

     ~/.nsmbrc	    Keeps static parameters for	connections and	other informa-
		    tion.  See ./examples/dot.nsmbrc for details.

     The following examples illustrate how to connect to a SMB server SAMBA as
     user GUEST	and mount shares PUBLIC	and TMP:

	   mount_smbfs -I //guest@samba/public /smb/public
	   mount_smbfs -I -E koi8-r:cp866 //guest@samba/tmp /smb/tmp

     It	is possible to use fstab(5) for	smbfs mounts:

	   //guest@samba/public	   /smb/public	   smbfs  rw,noauto 0	0

     Please report bugs	to the author.

     Boris Popov <>,	<>

FreeBSD				 Mar 10, 2000			       FreeBSD


Want to link to this manual page? Use this URL:

home | help