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

FreeBSD Manual Pages


home | help
NSMB.CONF(5)		    BSD	File Formats Manual		  NSMB.CONF(5)

     nsmb.conf -- configuration	file for SMB requests

     The nsmb.conf file	contains information about the computers, users, and
     shares or mount points for	the SMB	network	protocol.

     The configuration files are loaded	in the following order:

	   1. ~/.nsmbrc
	   2. /etc/nsmb.conf

     As	a result, /etc/nsmb.conf settings override those in ~/.nsmbrc.

     The configuration hierarchy is made up of several sections, each section
     containing	a few or several lines of parameters and their assigned	val-
     ues.  Each	of these sections must begin with a section name enclosed
     within square brackets, similar to:


     The end of	each section is	marked by either the start of a	new section,
     or	by the abrupt ending of	the file, commonly referred to as the EOF.
     Each section may contain zero or more parameters such as:


     where key represents a parameter name, and	value would be the parameter's
     assigned value.

     The SMB library uses the following	information for	section	names:

     A)	     [default]
     B)	     [SERVER]
     C)	     [SERVER:USER]
     D)	     [SERVER:USER:SHARE]

     Possible keywords may include:

     Keyword	    Section    Comment
		    A B	C D
     addr	    - +	- -    IP address of SMB server
     charsets	    - +	+ +    local:remote charset pair
     nbns	    + +	- -    address of NetBIOS name server (WINS)
     nbscope	    + +	- -    NetBIOS scope
     nbtimeout	    + +	- -    timeout for NetBIOS name	servers
     password	    - -	+ +    plain text or simple encrypted password used to
			       access the given	share
     retry_count    + +	- -    number of retries before	connection is marked
			       as broken
     timeout	    + +	- -    SMB request timeout
     workgroup	    + +	+ +    workgroup name

     /etc/nsmb.conf  The default remote	mount-point configuration file.

     ~/.nsmbrc	     The user specific remote mount-point configuration	file.

     What follows is a sample configuration file which may, or may not match
     your environment:

	   # Configuration file	for
	   # The 'FSERVER' is an NT server.
	   # User specific data	for FSERVER

     All lines which begin with	the `#'	character are comments and will	not be
     parsed.  The "default" section describes the default workgroup or domain,
     in	this case "SALES".  The	next section depicted here as "FSERVER", de-
     fines a server section and	then assigns it	a charset which	is only	re-
     quired when Cyrillic characters are not used.  The	hostname value,
     "", is also assigned in this section.  "FSERVER:USER",
     defines the user settings and is useful for saving	the password used dur-
     ing a specific connection.	 The password may be plaintext or obfuscated
     using simple encryption.  The simple encrypted password starts with the
     `$$1' symbols.  Warning: the encryption function is very weak and in-
     tended only to hide clear text passwords.	If the use of simple encryp-
     tion is desired, the following command may	be used	on a password:

	   smbutil crypt

     smbutil(1), mount_smbfs(8)

     This manual page was written by Sergey Osokin <> and Tom
     Rhodes <>.

BSD			       November	2, 2018				   BSD


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

home | help