Next: , Previous: , Up: Configuration   [Contents][Index]


3.9 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. Send all components the SIGTERM signal.
  2. Wait at most shutdown-timeout seconds for their termination.

    If any components are still running at the end of this interval:

    1. Send all components the SIGKILL signal.
    2. Wait at most shutdown-timeout seconds for their termination.

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 using the above procedure.

This means that pies termination sequence can take up to 2*shutdown-timeout seconds.


Next: , Previous: , Up: Configuration   [Contents][Index]