Project Config File Entries

The value for each field is the string that follows on the same input line. A trailing '\' can be used as a line continuation character. Comments must be entire lines, created by putting a '#' in the first column.

The code we distributed uses some of the fields listed below, as does the code we use as part of grading. Those fields are listed as mandatory - your code must use them as intended. The remainder are optional.

Android
Req	Field name	Use
*	android.apps	Space separated list of Java class names to instantiate as applications when running on Android. These classes should subclass NetLoadableAndroidApp.
*	android.initialapp	App name of Android application to launch once finished loading all other system components. Normally this is AndroidAppManager, a kind of Android shell.
Console
Req	Field name	Use
*	console.apps	Space separated list of Java class names to instantiate as applications when running in console mode. Services implement the NetLoadableConsoleApp interface.
*	console.initialapp	App name of console application to launch once finished loading all other system components. Normally this is appmanager, a kind of console shell.
DataXfer
Req	Field name	Use
	dataxfer.server.ip	IP address (or DNS name) of the DataXfer server the client application should contact.
*	dataxferraw.server.baseport	Lowest numbered of the four ports used by the DataXferRawService.
	dataxferrpc.maxlength	Maximum size data transfer allowed when using RPC communication.
Echo / Ping
Req	Field name	Use
	echo.server.ip	IP (or DNS name) of the echo server.
HTTPDService
Req	Field name	Use
	httpd.name	Name under which to register the HTTPDService for this instance. Normally <net.host.name>.www
	httpd.port	Port on which HTTPDService should listen.
Log
Req	Field name	Use
	debug.enable	0 → supress all Log output; 1 → don't supress. Default: 1
	debug.level	Suppress output below this level: v:2 d:3 i:4 w:5 e:6. Default: 3
Net.Base
Req	Field name	Use
	net.host.ip	The IP address to use for this host. Typically not needed, but can be used if the code is unable to reliably determine the IP itself.
*	net.host.name	DDNS full name of this host
*	net.services	Space separated list of Java class names to instantiate as services. Services are loaded in the order given in the file, and there may be dependencies among services that will cause loading to fail if an incorrect order is given.
	net.timeout.granularity	How often to check for application termination while waiting for a timeout period to expire. (An interval, in msec.)
	net.timeout.serversocket	Default timeout to use when waiting for connections on a server socket. (In msec.)
	net.timeout.socket	Default timeout when reading from a socket. (In msec.)
Net.DDNS
Req	Field name	Use
	ddns.resolver.cache.timeout	Timeout for the resolver's cache, in msec. Value 0 means "don't cache"
	ddns.resolver.password	A password to use when registering or unregistering names
	ddns.resolver.serverttl	Max number of distinct DDNS servers to contact before giving up
*	ddns.root.ip	IP address (or DNS name) of DDNS root name server
*	ddns.root.port	Port on which DDNS root name server is listening
	ddns.service.cleaninterval	The amount of time after a register() call at which the name's zone server will forget the registration. (In msec.)
	ddns.service.init	Whitespace separated vector of initialization data for nodes. Each element of the vector is of the form <DDNS full name>:<:IP addr>:<port>.
	ddns.service.nodefile	The name of a file containing a ddns.service.nodes entry, allowing the initialization data for DDNS to be separated from the main config file. Only one of ddns.nodefile and ddns.nodes should be present in the main config file.
	ddns.service.nodes	A whitespace separated vector of resource record entries in the zone. The first record must be an SOA. Example: ddns.service.nodes=soa:default.uw12au.cse461.:samplePassword \ a:child.default.uw12au.cse461.:samplePassword
	ddns.service.resolvettl	Upper bound on the number of name resolution steps allowed within a single zone before giving up. (Insurance against bugs that cause loops in the name structure internal to a zone.)
Net.RPC
Req	Field name	Use
	rpc.persistence.timeout	Idle time threshold (in msec.) afer which a persistent connection is closed.
	rpc.server.port	Local port on which the RPC service should listen for connections. If a root configuration, must match ddns.root.port. Otherwise need not be specified.
SNET
Req	Field name	Use
	snet.fetchphoto.maxlength	Max bytes SNet is willing to transfer in a single fetchPhoto() invocation. (Note that TCPMessageHandler imposes a limit that cannot be exceeded.)
	snet.name	SNet member name of user.
	snet.proxyname	DDNS name of SNet proxy.
TCPMessageHandler
Req	Field name	Use
*	tcpmessagehandler.maxmsglength	The maximum allowed length of the data portion of a received TCPMessageHandler message.
Test
Req	Field name	Use
	test.snet.server.name	DDNS name of the node on which the test server is running. (Normally '.'.)
	test.snet.testsuite	The name for the test suite to run; e.g., 'uw12au'.
	test.snet.initialdataset	The name for the first data set defined in the test suite. (See SNetTestData.java.)
	test.team	Names of the team members for the project.