SOS_CONFIG(5)

NAME
sos_config - format of SOS's configuration file

DESCRIPTION
SOS uses a common format for all of its configuration files. A configuration file consists of a sequence of comments and key/values pairs. If the line starts with the comment characters "#", ";", or whitespace " \t\r\n", then the line is considered a comment and is ignored. Otherwise, the line is considered a key/value pair.

The key consists of the sequence of characters from the first character on a line to the first whitespace character. Every character following the first whitespace character to the end of line ("\n") is the value which is retrieved when the key is looked up. It is important to note the the seperator between the key and value is a single whitespace character. If multiple whitespace characters are present, all following the first are part of the value. This is to allow formatted output with leading spaces.

If there is no seperating whitespace character, or if there is only one seperating whitespace character, then the resulting value is a string of zero length (the null string instead of the null pointer).

If you wish to allow multiple values for a single key, you should have multiple lines with the same key and different values instead of putting multiple values on the same line.

EXAMPLE
######################################################################
##
##		      Sample configuration file
##
########################################
# Two "servers"
#
server fearless.soscorp.com
server brimstone.soscorp.com
########################################
# Port number (really a string to be atoi()ed)
#
port 5060
########################################
# btelnet prompt
#
TELNET_PROMPT telnet>
########################################
# Multi-line greeting printed when you
# first connect to btelnet.  Note the
# user of missing values for blank lines.
#
TELNET_GREET
TELNET_GREET This is the Brimstone firewall proxy client.
TELNET_GREET
TELNET_GREET In compliance with Federal Law, we must inform you that if you
TELNET_GREET are not an authorized user of this machine, you can be prosecuted.
TELNET_GREET Use constitutes consent to security testing and monitoring.
TELNET_GREET NO UNAUTHORIZED USERS ARE WANTED OR ALLOWED ON ANY SOS COMPUTER.
TELNET_GREET
##
######################################################################

SEE ALSO
bs.client.conf(5) bs.rmnt.conf(5) sos_config_read(3)

BUGS
There are no syntax errors (*all* files are valid, from /dev/null to /dev/zero--though it might take a while to read in the latter config file :-).