NSMB.CONF(5)

NAME
nsmb.conf - configuration file for server message block (SMB1/CIFS) requests

DESCRIPTION
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 values. Each of these sections must begin with a section name enclosed within square brackets, similar to:

    [section_name]

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:

    [section_name]
    key=value

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

FILES

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

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

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

    # Configuration file for example.com
    [default]
    workgroup=SALES
    # The 'FSERVER' is an NT server.
    [FSERVER]
    charsets=koi8-r:cp866
    addr=fserv.example.com
    # User specific data for FSERVER
    [FSERVER:MYUSER]
    password=$$16144562c293a0314e6e1

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”, defines a server section and then assigns it a charset which is only required when Cyrillic characters are not used. The hostname value, “fserv.example.com”, is also assigned in this section. “FSERVER:USER”, defines the user settings and is useful for saving the password used during 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 intended only to hide clear text passwords. If the use of simple encryption is desired, the following command may be used on a password:

    smbutil crypt

SEE ALSO
smbutil(1), mount_smbfs(8)

AUTHORS
This manual page was written by -nosplit Sergey Osokin <osa@FreeBSD.org> and Tom Rhodes <trhodes@FreeBSD.org>.