5.3.1 Server Compilation Options

The following option values are specified (via #define) in the file `options.h' in the server sources. Except for those cases where property values on $server_options take precedence, these settings cannot be changed at runtime.

This list is not intended to be exhaustive.

Network Options

NETWORK_PROTOCOL

This specifies the underlying protocol for the server to use for all connections and will be one of the following:

NP_TCP

The server uses TCP/IP protocols.

NP_LOCAL

The server uses local interprocess communication mechanisms (currently either BSD UNIX-domain sockets or SYSV named pipes).

NP_SINGLE

The server accepts only a single "connection" via the standard input and output streams of the server itself. Attempts to have multiple simultaneous listening points (via listen() will likewise fail.

DEFAULT_PORT

(for NP_TCP) the TCP port number on which the server listens when no port-number argument is given on the command line.

DEFAULT_CONNECT_FILE

(for NP_LOCAL) the local filename through which the server will listen for connections when no connect-file-name is given on the command line.

OUTBOUND_NETWORK

The server will include support for open_network_connection() if this constant is defined. If given a zero value, the function will be disabled by default and `+O' will need to be specified on the command line in order to enable it, otherwise (nonzero or blank value) the function is enabled by default and `-O' will needed to disable it.

When disabled or not supported, open_network_connection() raises E_PERM whenever it is called.

The NETWORK_PROTOCOL must be NP_TCP.

MAX_QUEUED_OUTPUT

The maximum number of output characters the server is willing to buffer for any given network connection before discarding old output to make way for new.

MAX_QUEUED_INPUT

The maximum number of input characters the server is willing to buffer from any given network connection before it stops reading from the connection at all.

Other Options

IGNORE_PROP_PROTECTED

Disables protection of builtin properties via $server_options.protect_property when set. See section Protected Properties.

OUT_OF_BAND_PREFIX

Specifies the out-of-band prefix. If this is defined as a non-empty string, then any lines of input from any player that begin with that prefix will not be consumed by reading tasks and will not undergo normal command parsing. See section Out-of-band Processing.

OUT_OF_BAND_QUOTE_PREFIX

Specifies the out-of-band quoting prefix. If this is defined as a non-empty string, then any lines of input from any player that begin with that prefix will have that prefixed stripped and the resulting string will bypass 5.1.2 Out-of-Band Processing.

The following are discussed in Controlling the Execution of Tasks.

DEFAULT_MAX_STACK_DEPTH

Default value for $server_options.max_stack_depth.

DEFAULT_FG_TICKS

The number of ticks allotted to foreground tasks. Default value for $server_options.fg_ticks.

DEFAULT_BG_TICKS

The number of ticks allotted to background tasks. Default value for $server_options.bg_ticks.

DEFAULT_FG_SECONDS

The number of seconds allotted to foreground tasks. Default value for $server_options.fg_seconds.

DEFAULT_BG_SECONDS

The number of seconds allotted to background tasks. Default value for $server_options.bg_seconds.

DEFAULT_CONNECT_TIMEOUT

Default value for $server_options.connect_timeout.