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

NAME
     mount_smbfs -- mount a shared resource from an SMB file server

SYNOPSIS
     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

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

     The options are as follows:

     -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 lo-
	     cale 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 pass-
	     word.  If no password is found, mount_smbfs prompts for it.

     -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 are converted to lower case.   Newly
		    created file gets a lower case.

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

     -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 directory 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 are owner and
	     group IDs from the directory where the volume is mounted.

     //user@server/share
	     The mount_smbfs command will use server as the NetBIOS name of  re-
	     mote  computer,  user  as the remote user name and share as the re-
	     source name on a remote server.

     node    Path to mount point.

FILES
     ~/.nsmbrc	Keeps static parameters for connections and  other  information.
		See /usr/share/examples/smbfs/dot.nsmbrc for details.

EXAMPLES
     The  following  example  illustrates  how to connect to SMB server SAMBA as
     user GUEST, and mount shares PUBLIC and TMP:

	   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

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

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

BUGS
     Please report bugs to the author.

AUTHORS
     Boris Popov <bp@butya.kz>, <bp@FreeBSD.org>

FreeBSD 5.3			 March 10, 2000 		  MOUNT_SMBFS(8)

home | help