Name

ipc — format of ipc component configuration

DESCRIPTION

General syntax rules of Kernun Firewall configuration files are described in configuration(7). This man page describes types, sections and items specific for the ipc component configuration.

Repeatable sections/items are marked by the '*' before section/item name.

TYPES

Configuration directives have attributes of several value-types. For the basic types description, see configuration(7).

Enumeration is a list of words (names) representing integer values. Some enumerations accept both names and direct integer values; in this case, enumeration description contains values for every name (in parenthesis next to name). For other enumerations, using of names is obligatory.

The following enumerations are used in ipc configuration directives:

lock-type (name-usage obligatory)

Type of an alternative lock.

none

No locking done.

semaphore

Lock implemented by a SysV semaphore.

lock2

Two levels of locks with a single lock file.

multilock2

Two levels of locks with multiple lock files.

ITEMS AND SECTIONS

Configuration of ipc library component consists of following prototypes:


  lock ... ;
  alt-lock ... ;
    

Description:

lock [path];

Lock file used as a lock.

path (type: str, optional, default: <NULL>)

If set to directory, file in that directory is created with name PREFIX.PID.XXXXXX, where PREFIX is a string defined by the proxy, PID is the proxy parent process ID and X is a random suffix. If not set, directory /tmp is assumed. Automatic generation of lock file name is strongly recommended, because each lock must have a unique name.

alt-lock none;

alt-lock semaphore;

alt-lock lock2 [path];

alt-lock [multilock2] [path];

An alternative implemetation of locks.

<branching element> (type: lock-type, optional, default: multilock2)

path (type: str, optional, default: <NULL>)

If set to directory, file in that directory is created with name PREFIX.PID.XXXXXX, where PREFIX is a string defined by the proxy, PID is the proxy parent process ID and X is a random suffix. If not set, directory /tmp is assumed. Automatic generation of lock file name is strongly recommended, because each lock must have a unique name.

SEE ALSO

configuration(7)