3.10 Global Configuration

The statements described in this section affect pies behavior as a whole.

Config: env { … }

Modifies the environment for the running pies instance. The modified environment will be inherited by all processes started by pies in the course of its normal operation.

See Environment, for a detailed discussion of the env statement syntax.

Config: syslog { … }

This block statement configures logging via syslog. It has the following substatements:

Config: syslog: dev address

Address of the socket the syslog daemon is listening on. By default, /dev/log is used.

The address argument is either the file name of the UNIX socket file or IPv4 address of the syslog collector optionally followed by the colon and port number (or symbolic service name). If the port number is not supplied, the ‘syslog’ port (UDP) from /etc/services is used.

Config: syslog: facility string

Set syslog facility to use. Allowed values are: ‘user’, ‘daemon’, ‘auth’, ‘authpriv’, ‘mail’, ‘cron’, ‘local0’ through ‘local7’ (case-insensitive).

Config: syslog: tag string

Prefix syslog messages with this string. By default, the program name is used.

Config: umask number

Set the default umask. The number must be an octal value not greater than ‘777’. The default umask is inherited at startup.

Config: limits arg

Set global system limits for all pies components. See limits, for a detailed description of arg.

Config: return-code { … }

Configure global exit actions. See Exit Actions, for a detailed description of this statement.

Config: shutdown-timeout number;

Wait number of seconds for all components to shut down. Default is 5 seconds.

The normal shutdown sequence looks as follows:

1. Compute shutdown sequence that takes into account dependencies between components, so as to ensure that dependent components stop before their prerequisites. This sequence can be viewed using the --list-shutdown-sequence option.
2. For each stage in the shutdown sequence, send the termination signal to each component marked for that stage. By default, SIGTERM is used, but it can be changed for each component using the sigterm configuration statement (see sigterm). Wait for the signalled components to terminate. If any of them remain running after shutdown-timeout seconds, send them the SIGKILL signal.
3. If any shutdown components are defined, start them and wait for their termination. If any components are left running after shutdown-timeout seconds, terminate them by sending the SIGKILL signal.