GNU Pies Manual (split by chapter):   Section:   Chapter:FastBack: Command Line Usage   Up: Top   FastForward: Reporting Bugs   Contents: Table of ContentsIndex: Concept Index

9 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.

--no-init

Don’t assume init mode (see Init Process if running with PID 1. This option is useful if you intend to run pies as a process manager in a docker container.

--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.

--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.

-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 include files. See include search path.

--instance=name

Define the name of the pies instance. See instances.

--lint
-t
--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.

--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.

GNU Pies Manual (split by chapter):   Section:   Chapter:FastBack: Command Line Usage   Up: Top   FastForward: Reporting Bugs   Contents: Table of ContentsIndex: Concept Index