10 Pies Invocation

This section summarizes pies command line options.

--config-file=file

-c file

Read configuration from file, instead of the default /etc/pies.conf.

See Configuration.

--config-help

Show configuration file summary. See Configuration.

--define=sym[=value]

-D symbol[=value]

Define symbol sym as having value, or empty, if the value is not given. See Preprocessor.

--debug=level

-x level

Set debug verbosity level. See Pies Debugging, for a description of level.

--dump-depmap

Dump dependency map. See dump-depmap.

-E

Preprocess configuration file and exit. See Preprocessor.

--force

Force startup even if another instance may be running.

--foreground

Remain in foreground.

--help

Display a short usage summary and exit.

--inetd

-i

Run in inetd-compatibility mode. It is roughly equivalent to pies --instance=inetd --syntax=inetd. See inetd.

--include-directory=dir

-I dir

Add directory dir to the list of directories to be scanned for preprocessor include files.

--instance=name

Define the name of the pies instance. See instances.

--lint

-t

--no-init

Don’t assume init mode (see Init Process) if running with PID 1. See Docker Entrypoint.

--list-shutdown-sequence

List components in order of shutdown sequence. Each line lists the sequence stage number and the component name. See shutdown sequence, for a detailed discussion of its meaning.

--no-preprocessor

Disable the use of the external preprocessor.

See Preprocessor.

--preprocessor=cmd

Use the command cmd as the external preprocessor, instead of the default m4.

See Preprocessor.

--source-info

Show source info with debugging messages. See source-info.

--status

-s

Start piesctl list to obtain information about the running processes. See piesctl list.

--stderr

Log to standard error.

--stop

-S

Stop the running instance. This is equivalent to running piesctl shutdown.

--syntax=type

Define the syntax for parsing the configuration files specified by any --config-file options that follow this one. Possible values for type are:

pies

Native pies configuration. See Configuration.

inetd

‘Inetd’-style configuration files. See inetd.conf.

meta1

‘meta1’-style configuration files. See include-meta1.

inittab

‘Inittab’ file. See Init Process.

See config syntax, for a detailed description of this option.

--syslog

Log to syslog. This is the default.

--telinit

-T

Emulate the telinit legacy interface. The rest of command line following this option is processed as telinit options. See telinit command, for a detailed description of these.

--trace-depend

List dependencies for components named in the command line. Without arguments, dependencies for each component are listed. See trace-depend.

--trace-prereq

List prerequisites for components named in the command line. Without arguments, prerequisites for each component are listed. See trace-prereq.

--rate=r

Set maximum connection rate (connections per second) for inetd-style components. See inetd component rate.

-r

--reload

--hup

Reread the configuration files. This is equivalent to running piesctl config reload (see config reload).

-R

--restart-component

Restart components named in the command line. See pies-restart.

--version

Display program version and license information and exit.

--undefine=sym

-U sym

Undefine symbol sym. See Preprocessor.

--usage

Display a short summary of available options and exit.