bnetd.conf - configuration for the Unix Battle.net daemon
The file bnetd.conf contains information used by the Unix Battle.net
daemon bnetd(1) to obtain system-specific information such as file
locations and policies.
The file consists of a list of configuration entries and comments. A
comment starts with a pound (#) sign and continues to the end of the
line. Blank lines and whitespace are ignored between entries. A
configuration entry is composed of two fields separated by an equals
directive = value
The directive field contains the name of the configuration item you
want to set to the value of value. If the value contains spaces it
should be surrounded by quotation marks ("). The value may not contain
quotation marks. Multiple entries are not allowed on a single line.
If the field is Boolean, any of true, false, yes, no, 1, or 0 may be
used. If the field is numeric, it must be in base ten. If the field
is an address list, it must be delimited by commas. Each element may
contain a hostname (or IP) and a port number. If a port number is
given, it must be preceded by a colon (:). A colon by itself may be
used to represent the wildcard address. If the field is a file or
directory path, use of an absolute pathname is recommended. The values
for iconfile, tosfile, and mpqauthfile are not pathnames but just the
names of the files. They must be in the filedir directory.
Recognized values for directive include:
filedir Specifies the path where downloadable files are
stored. These files are include the TOS (terms of
service), icons, and ad banners. (Normally "files/")
userdir Specify the path where user accounts are stored.
reportdir Specify the path where game reports are stored.
Specify the path where channel logs are stored.
defacct Specify the path of the default account file. This
file contains all default account attributes which are
used when an attribute is not set on an actual
account. (Normally "bnetd_default_user")
motdfile Specify the path of the "message of the day" text
file. This is displayed when a user enters the first
chat channel. (Normally "bnmotd.txt")
Specify the path of the permanent channel list.
newsfile Specify the path of the file that is printed when the
/news command is used. If no file is specified or the
file doesn't exist then the server prints "No news
today" to the user. (Normally "news.txt")
adfile Specify the path of the ad banner list which
determines which banners to display at which times.
ipbanfile Specify the path of the IP ban file which can be used
to block connections from certain addresses.
helpfile Specify the path of the chat command help file.
transfile Specify the path of the game address translation file
which can be used to allow players from behind a NAT
firewall to play with those outside of the firewall.
mpqfile Specify the path of the autoupdate MPQ archive list.
It chooses which versions of which clients to update.
logfile Specifies the file where the server appends the event
messages selected with the loglevels field. (Normally
pidfile Specify the path of the file where the server records
its process ID. (Normally "bnetd.pid")
The path for the program to be executed when /fortune
is used. See fortune(6). (Normally
loglevels Specify A comma-delimited list of message levels to
log. The available levels are:
trace flow tracing statements
debug debugging information
info potentially useful informational
warn potentially serious events
error error messages and unexpected events
fatal fatal errors
iconfile Specify the name of the BNI chat icons file which must
be inside of the filedir directory. (Normally
tosfile Specify the name of the TOS file which must be inside
of the filedir directory. (Normally "tos.txt")
Enable or disable to automatic client update facility.
If you want to allow different client versions to
connect, set this to false. If you want to update all
clients to the same version, be sure to also download
the MPQ auth file, and the update MPQ.
Specify the name of the MPQ authorization file which
must be inside of the filedir directory. This file is
used to determine the current client version. This is
only needed if allow_autoupdate is turned on.
usersync Specify the time in seconds between account file
saves. A value of 0 means to wait until shutdown to
save account files and not do do periodic updates.
userflush Specify the number of seconds of inactivity before a
user is unloaded from memory (only checked during file
account updates, see usersync. After the account has
been unloaded, it must be read from disk when accessed
latency How often to send user latency tests to the user, in
seconds. These are used to decide how many "lag bars"
to print next to users in channels.
Specify the amount of time in seconds to delay
shutting down the server when it receives a SIGTERM or
You can decrease the amount of time to wait by this
value by sending another SIGTERM or SIGINT signal(7).
If this value is true then new accounts may be created
by users on the system. Administrators can always use
the /addacct chat command.
If this value is true then a second login by the same
user will kick off the first, otherwise the second
login will get message saying that they are already
If this value is true, a user using the "Channels"
button to join a non-existing channel will be asked if
they wish to create it just like Battle.net.
Otherwise, the channel will be created silently.
If this value is true, all games with more than one
player lasting for more than 5 minutes will be logged.
Otherwise, only ladder games are logged.
If this value is true, private (passworded) games will
not be shown in the game list just like Battle.net.
Otherwise all games will be listed.
If this value is true, games which have already stated
will not be sent to the clients. The clients filter
these games out for Starcraft and Brood War already.
If this value is true, private channels will not be
shown in the channel list just like Battle.net.
Otherwise all channels will be listed.
If this value is true then all the extended chat
commands are enabled, otherwise only those which exist
on Battle.net are enabled.
If this value is true then any disconnect will be
treated as a loss (regardless of the setting in ladder
If this value is true then all users may use the /con
and /connections commands. Otherwise only
administrators may use them.
hide_addr If this value is true then IP addresses will be hidden
from non-admins in the output of the /con, /games,
/gameinfo, and /netinfo commands.
chanlog If this value is true then private channels will be
logged to files in the chanlogdir direcotry. The
logging of public (permanent) channels is controlled
in the channelfile file.
track Set this value to 0 to disable sending updates to the
tracking server. Any other number will set the number
of seconds between tracking packets. Try to use a
number above 60 seconds unless you know the tracking
server administrator doesn't mind being spammed.
Specify a comma-delimited list of addresses of
tracking servers to send updates to. The address for
the master server is "track.bnetd.org". A port may be
specified after a colon numerically or by name from
/etc/services(5). If a port number is not specified,
it defaults to 6114.
location Give a description of the physical location of the
server such as "San Diego, CA, USA". This is reported
to the tracking server.
Give a description of title or role of the server such
as "Joe's Spiffy Server". This is reported to the
url Give a URL for the homepage or contact for the server
such as "http://www.foo.com/joeserv.php". This is
reported to the tracking server.
Give the name of the contact for the server such as
"Joe Blockhead". This is reported to the tracking
Give the email address of the contact for the server
such as "firstname.lastname@example.org". This is reported to the
If this value is set to true, the server will enable
the TCP keepalive option to allow the system to detect
servaddrs Specify the comma-delimited list of addresses the
server should listen on. A port may be specified
after a colon numerically or by name from
/etc/services(5). If a port number is not specified,
it defaults to 6112.
The UDP port number which is assumed for clients if
they don't send SESSIONADDR packets. If it is set to
zero, the server will use the remote TCP port number
as the default UDP port number.
Rob Crittenden (email@example.com), Ross Combs (firstname.lastname@example.org)