FreeBSD Manual Pages
NSMB.CONF(5) File Formats Manual 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 sec- tion 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 parame- ter'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 plain- text or obfuscated using simple encryption. The simple encrypted pass- word 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 Sergey Osokin <osa@FreeBSD.org> and Tom Rhodes <trhodes@FreeBSD.org>. FreeBSD 14.3 November 2, 2018 NSMB.CONF(5)
NAME | DESCRIPTION | FILES | EXAMPLES | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nsmb.conf&manpath=FreeBSD+14.3-RELEASE+and+Ports>