Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nsmb.conf(5) [freebsd man page]

NSMB.CONF(5)						      BSD File Formats Manual						      NSMB.CONF(5)

nsmb.conf -- configuration file for SMB requests DESCRIPTION
The nsmb.conf file contains information about the computers, users, and shares or mount points for the SMB network protocol. 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. ~/nsmb.conf 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 [default] workgroup=SALES # The 'FSERVER' is an NT server. [FSERVER] charsets=koi8-r:cp866 # 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, ``'', 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 func- tion 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 <> and Tom Rhodes <>. BSD
October 19, 2010 BSD

Check Out this Related Man Page

MOUNT_SMBFS(8)						    BSD System Manager's Manual 					    MOUNT_SMBFS(8)

mount_smbfs -- mount a shared resource from an SMB file server SYNOPSIS
mount_smbfs [-N] [-o options] [-d mode] [-f mode] [-h] //[domain;][user[:password]@]server[/share] path DESCRIPTION
The mount_smbfs command mounts a share from a remote server using SMB/CIFS protocol. The options are as follows: -N Do not ask for a password. At run time, mount_smbfs reads the ~/Library/Preferences/nsmb.conf file for additional configuration parameters and a password. If no password is found, mount_smbfs prompts for it. -o Options passed to mount(2) are specified with the -o option followed by a comma separated string of options. See the mount(8) man page for possible options and their meanings. Additional options supported by the mount_smbfs are as follows: nobrowse Indicate to the Carbon subsystem that this volume is not to be displayed to the user. automounted Set flags on the mountpoint to indicate that the volume has been mounted by the automounter. nostreams Don't use NTFS Streams even if they are supported by the server. soft Make the mount soft. Fail file system calls after a number of seconds. nonotification Turn off using notifications for this volume. -f mode, -d mode Specify permissions that should be assigned to files and directories. 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. -h Prints a help message, much like the SYNOPSIS above. //[domain;][user[password]@] server[/share] 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. Domain and/or password may be specified here. If user is omitted the logged in user id will be used. Omitting share is an error when mount_smbfs is run from the command line, otherwise a browsing dialogue is presented. path Path to mount point. FILES
nsmb.conf Keeps static parameters for connections and other information. See man nsmb.conf for details. EXAMPLES
This example shows the proper url to use to mount the share PUBLIC from the SMB server myserver : mkdir /smb/public mount -t smbfs //username:userpass@myserver/PUBLIC /smb/public This example shows the proper url to use to mount the share PUBLIC from the SMB server myserver as guest: mkdir /smb/public mount -t smbfs //guest:@myserver/PUBLIC /smb/public Note: You should always use the system mount command and never call mount_smbfs directly. SEE ALSO
mount(2), nsmb.conf(5), mount(8), umount(8) BUGS
Please report bugs to Apple. AUTHORS
Boris Popov <>, <> FreeBSD March 10, 2000 FreeBSD
Man Page

Featured Tech Videos