Configuration File Format

A configuration file is a list of whitespace separated entries of the form

<key> [=] <value>[, <value>, ...]

Integer and string values are distinguished automatically, except that values enclosed in quotes (") are interpreted as strings. String values containing any of the characters ``,'', ``#'', or ``='' must be enclosed in quotes. Quoted strings may include C-style escape sequences.

String values may include substitutions of the form $(<key>), where <key> is the name of a defined string-valued key. For example, the two entries

this_key     "Hello"
that_key     "$(this_key) world."

would assign that_key the value "Hello world." Key substitution can be suppressed by escaping the dollar sign (i.e., \\$).

Tilde expansion (substitution of home directory for login name) is attempted on all string values whose first character is ``~''.

Comments begin with the pound character (#) and continue to the end of the line.

Multiple entries with the same key are equivalent to a single entry with the values of the multiple entries concatenated in a list. For example, the two entries

this_key     value1, value2
this_key     value3

are equivalent to the single entry

this_key     value1, value2, value3

This makes it possible, for example, for a local configuration file to add values to keys set in the main configuration file. Note, however, that values lists are not necessarily meaningful for all keys. Certain keys (as indicated in Table 1) are defined internally by Anetd and cannot have their values set or modified by configuration files.

Table 1: Anetd configuration.

Key	Description	Default value
user1	Owner of Anetd process	N/A
abone_rolea01a 0	Acting ABone account	$(user)2
abocc_userba2b 0	Account acting in abocc role	abocc34
		$(user)da4d 05
hostnameec5e 0	Local hostname	N/A
osea5e 0	Host OS type	N/A
home_dir	User home directory	(from passwd entry)
primary_role	ABone role of primary Anetd	anpubea5e 0
		$(user)ed5e 0
port	Primary Anetd port	3322
child_port	First secondary Anetd port	8000
ip_addr	Listening IP address(es) (list)	0.0.0.0 (any)
debug_java	Allow Java EE debugging (yes/no)	no
debug_native	Allow native EE debugging (yes/no)	no
abocc_servers	ACL/TCL server URLs	(ABOCC defined)
halt_on_xcl_fail	Halt on ACL/TCL download failure	no
anetd_dir	Anetd top-level directory	$(home_dir)/anetd
bin_dir	Anetd binary directory	~$(abocc_user)/anetd/binee5e 0
		$(anetd_dir)/bined5e 0
code_dir	Local code directory	~$(abocc_user)/anetd/code/$(abone_role)ee5e 0
		$(anetd_dir)/codeed5e 0
conf_dir	Anetd configuration dir.	$(anetd_dir)/conf
abocc_conf_dir	ABOCC-owned conf. dir.	~$(abocc_user)/anetd/etc/$(abone_role)
conf_file	Master configuration file	$(abocc_conf_dir)/anetd.confee5e 0
		$(conf_dir)/anetd.confed5e 0
local_conf_file	Local configuration file	$(conf_dir)/anetd.conf.local
acl_server_dir	Master ACL server dir.	(ABOCC defined)
tcl_server_dir	Master TCL server dir.	(ABOCC defined)
acl_file	Master ACL file	$(conf_dir)/hosts.allow
tcl_file	Master TCL file	$(conf_dir)/web.allow
local_acl_file	Local ACL file	$(conf_dir)/hosts.allow.local
local_tcl_file	Local TCL file	$(conf_dir)/web.allow.local
run_dir	Anetd runtime directory	$(anetd_dir)/var
log_file	Anetd log	$(run_dir)/anetd.log
startup_file	Permanent command record	$(run_dir)/startup
jdk<version>	Location of JDK <version>	(ABOCC defined)
java<version>	JVM invocation (list)	(ABOCC defined)
javag<version>	JVM debugging invocation (list)	(ABOCC defined)
jlc<version>	Class loader for JDK <version>	abocc.LoadClient
jsp<version>	Security policy for JDK <version>	(ABOCC defined)
classpath	Java class path for EEs	$(bin_dir)
ld_library_path	Library path for EEs	$(bin_dir)
gdbserver_path	Location of gdbserver	gdbserver
accept_w_path	Gdbserver accept() wrapper	$(bin_dir)/accept.$(os).so

¹ This key is defined internally and its value may not be altered by configuration files.

² The default may be overridden via the -a command-line option.

³ The default may be overridden via the -m command-line option.

⁴ This value is the default when Anetd is running in an ABone configuration.

⁵ This value is the default when Anetd is running standalone.