187874Ssheldonh# $FreeBSD$
287874Ssheldonh#
387874Ssheldonh# smbfs lookups configuration files in next order:
487874Ssheldonh#	1. ~/.nsmbrc
588287Ssheldonh#	2. /etc/nsmb.conf - if this file found it will
687874Ssheldonh#	   override values with same keys from user files.
787874Ssheldonh#
887874Ssheldonh#
987874Ssheldonh# This file consist from a set of sections. Each section started by section name
1087874Ssheldonh# surrounded with square brackets:
1187874Ssheldonh# [section_name]
1287874Ssheldonh#
1387874Ssheldonh# End of the section marked either by new section or by the end of file.
1487874Ssheldonh# Each section can contain zero or more parameters:
1587874Ssheldonh# [section_name]
1687874Ssheldonh# key=value
1787874Ssheldonh#
1887874Ssheldonh# where 'key' represents parameter name and 'value' a value assigned
1987874Ssheldonh# to this parameter.
2087874Ssheldonh#
2195270Ssheldonh# SMB library uses next forms of section names (please note that the section
2295270Ssheldonh# name should be in upper case when it refers to server, user or share):
2387874Ssheldonh# A) [default]
2487874Ssheldonh# B) [SERVER]
2587874Ssheldonh# C) [SERVER:USER]
2687874Ssheldonh# D) [SERVER:USER:SHARE]
2787874Ssheldonh#
2887874Ssheldonh# Here is the map of possible keywords:
2987874Ssheldonh#
3087874Ssheldonh# keyword/section	A  B  C  D	Comment
3187874Ssheldonh#
3287874Ssheldonh# addr			-  +  -  -	IP or IPX address of SMB server
3395270Ssheldonh# charsets		+  +  +  +	local:remote charset pair
3487874Ssheldonh# nbns			+  +  -	 -	address of NetBIOS name server (WINS)
3587874Ssheldonh# nbscope		+  +  -	 -	NetBIOS scope
3687874Ssheldonh# nbtimeout		+  +  -	 -	timeout for NetBIOS name servers
3787874Ssheldonh# password		-  -  +	 +	a plain text password used to access to the given share
3887874Ssheldonh# retry_count		+  +  -	 -	number of retries before connection marked as broken
3987874Ssheldonh# timeout		+  +  -	 -	SMB request timeout
4087874Ssheldonh# workgroup		+  +  +  +	name of workgroup
4187874Ssheldonh#
4287874Ssheldonh
4387874Ssheldonh# A simple configuration example:
4487874Ssheldonh
4587874Ssheldonh# First, define a workgroup.
4687874Ssheldonh#[default]
4787874Ssheldonh#workgroup=SALES
4887874Ssheldonh
4987874Ssheldonh# The 'FSERVER' is an NT server.
5087874Ssheldonh#[FSERVER]
5187874Ssheldonh#charsets=koi8-r:cp866
5287874Ssheldonh#addr=fserv.coolcorp.com
5387874Ssheldonh
5489001Ssheldonh#[FSERVER:JOE]
5587874Ssheldonh# use persistent password cache for user 'joe'
5687874Ssheldonh#password=$$1767877DF
57