gng

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHORS
SEE ALSO

NAME

gng − Gigapxy engine daemon.

SYNOPSIS

gng [−h?TvVq] [−C config_file] [−l logfile}] [−p pidfile] [−w path] [−P cpunum]

DESCRIPTION

gng is the Gigapxy engine module performing I/O on behalf of data requests submitted to gws. The format of gws requests is described in the gigapxy(1) manpage.

gng attaches to the specified gws upon start−up; up to 64 engines may attach to a single gws. The controlling gws relays (pre−processed) data requests to the attached engines for execution.

gng takes its parameters from a configuration file, which is either gng.conf or gigapxy.conf by default and can contain sections for any or all gigapxy modules. gng will look for the default configuration in a) current directory; b) /etc; c) /usr/local/etc. Path to a specific configuration file could be given at command−line (see OPTIONS). Configuration options for gws are described in detail in gng.conf(5) manpage.

gng re−reads its configuration in response to SIGHUP. gng will force−rotate its log in response to SIGUSR1.

OPTIONS

gng accepts the following options:
−h, −−help, −?, −−options

output brief option guide. This is NOT the behavior when run without parameters.

−C, −−config path

specify configuration file.

−l, −−logfile path

specify log file.

−p, −−pidfile path

specify pid file.

−w, −−gws path

specify path to the controlling gws (domain socket).

−T, −−term

run as a terminal (non-daemon) application. This is the default behavior when gws is run by a non−privileged user. −T could be specified when run as root in order NOT to become a daemon, for instance, for debugging purposes.

−v, −−verbose

set the level of verbosity in the output. This option could be repeated to get to the desired level, which is 0, unless the option is used at least once. Level 0 will reduce output to the very essential log entries of NRM (normal) priority; level 1 will set verbosity to output to INF (info): suitable for monitoring but not debugging; level 2 will enable DBG (debug) level for most (but not all) application modules (please mind that bufd is NOT at debug at level 2); level 3 will set DBG (debug) for additional modules, including bufd; level 4 will set all modules to debug. This switch has a rather inflexible nature, for more precise setting of log levels please use config settings alone.

−V, −−version

output application’s version and quit.

−q,−−quiet

send no output to terminal. This is to supress any output normally sent to standard output or error streams. Unless specified, when run from a non−privileged account, gws will mirror diagnostic messages sent to the log (as specified with the −l option) to standard output.

−P,−−cpu

Set CPU affinity for the main process. This option allows to restrict the main gng process to the given CPU/core (numbered from 0 to N−1).

AUTHORS

Pavel V. Cherenkov

SEE ALSO

gigapxy(1),gws(1),gws.conf(5),gng.conf(5)