Provided by: zorp_3.9.2-1ubuntu1_i386 bug

NAME

       instances.conf_ - zorp(8) instances database

DESCRIPTION

       The instances.conf file describes the zorp(8) instances to be run on
       the system. It is processed by zorpctl(8) line by line, each line
       having the structure described below. Empty lines and lines beginning
       with '#' are comments ignored by zorpctl.

STRUCTURE

       instance-name parameters [-- zorpctl-options]

       instance-name is the name of the Zorp instance to be started; it is
       passed to zorp with its --as parameter. Instance names may consist of
       the characters [a-zA-Z0-9_] and must begin with a letter.

       parameters are space separated parameters entered into the zorp
       command-line. For details on these command-line parameters see zorp(8).

       zorpctl-options are space separated parameters control startup specific
       options. They are processed by zorpctl itself. The following zorpctl
       options are available:

       --auto-restart or -A
           Enable the automatic restart feature of zorpctl. When an instance
           is in auto-restart mode, it is restarted automatically in case the
           instance exits.

       --no-auto-restart or -a
           Disable automatic restart for this instance.

       --fd-limit <number> or -f <number>
           Set the file descriptor limit to <number>. The file descriptor
           limit defaults to the number of threads (specified by the --threads
           parameter of zorp(8)) multiplied by 4.

       --process-limit <number> or -p <number>
           Set the process limit to <number>. The process limit defaults to
           the number of threads (specified by the --threads parameter of
           zorp(8)) multiplied by 2.

       --enable-core
           Explicitly enable core dumps for Zorp processes. The core limit is
           inherited from the local starting environment (e.g.: starting
           shell) if not specified.

EXAMPLES

       zorp_ftp --policy /etc/zorp/policy.py --verbose 5

       The line above describes a zorp instance named zorp_ftp using policy
       file /etc/zorp/policy.py, and having verbosity level 5.

       zorp_intra -v4 -p /etc/zorp/policy.py --threads 500 --no-auto-restart
       --fd-limit 1024 --process-limit 512

       This line describes a zorp instance named zorp_intra using the policy
       file /etc/zorp/policy.py, verbosity level 4. The maximum number of
       threads is set to 500, file descriptor limit to 1024, process limit to
       512.

FILES

       The default location of instances.conf is /etc/zorp/instances.conf.
       Defaults for zorpctl tunables can be specified in /etc/zorp/zorpctl.

AUTHOR

       This manual page was written by the BalaBit Documentation Team
       <documentation@balabit.com>.

COPYRIGHT

       Copyright © 2006 BalaBit IT Security Ltd. All rights reserved. For more
       information about the legal status of this document please read:
       http://www.balabit.com/products/zorp/docs/legal_notice.bbq

[FIXME: source]                   08/13/2011                 INSTANCES.CONF(5)