aboutsummaryrefslogtreecommitdiff
path: root/doc/pies.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pies.texi')
-rw-r--r--doc/pies.texi77
1 files changed, 51 insertions, 26 deletions
diff --git a/doc/pies.texi b/doc/pies.texi
index 7008ce6..b51be37 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -2179,12 +2179,23 @@ component pop3d @{
socket "inet://0.0.0.0:110";
program "/usr/sbin/pop3d";
command "pop3d --inetd";
@}
@end smallexample
+The following is almost equivalent configuration in @command{inetd}
+format:
+
+@smallexample
+ftp stream tcp nowait root /usr/sbin/ftpd ftpd -l -C
+pop3 stream tcp nowait root /usr/sbin/pop3d pop3d --inetd
+@end smallexample
+
+This configuration is ``almost'' equivalent, because the
+@command{inetd} has no way of specifying ACLs and setting the umask.
+
@node Command Line Usage
@chapter Command Line Usage
When run without arguments, @command{pies} parses and loads the
configuration file, detaches itself from the controlling terminal
(becomes a daemon), and starts all components. Before actually
@@ -2192,49 +2203,63 @@ starting up, it ensures that no another instance of it is
already running, by looking for a PID file and verifying that the PID
listed there is alive and responding. If another instance is running,
@command{pies} refuses to start up.
@anchor{pies-status}
After startup, you can verify the status of the running process
-using @option{--status} command line option:
+using the @option{--status} command line option:
@smallexample
@group
$ pies --status
-redirector smtps/stderr 4697
-redirector pmult/stderr 4677
-redirector pmult/stdout 4676
-component pmult 4678 /usr/local/sbin/pmult
-component smar 4680 smar -f /etc/meta1/meta1.conf -d 100
-component qmgr 4691 qmgr -f /etc/meta1/meta1.conf
-component smtpc 4696 smtpc -f /etc/meta1/meta1.conf
-component smtps 4698 smtps -d100 -f /etc/meta1/meta1.conf
+smtps/stderr R 4697
+pmult/stderr R 4677
+pmult/stdout R 4676
+pmult CR 4678 /usr/local/sbin/pmult
+smar CR 4680 smar -f /etc/meta1/meta1.conf -d 100
+qmgr CR 4691 qmgr -f /etc/meta1/meta1.conf
+smtpc CR 4696 smtpc -f /etc/meta1/meta1.conf
+smtps PR 4698 smtps -d100 -f /etc/meta1/meta1.conf
@end group
@end smallexample
- In its output, lines beginning with @samp{component} refer to
-running components. For running components, the following information
-is displayed:
+ Each output line contains at least two columns. The first column
+lists the tag of the component. The second one contains @dfn{flags},
+describing the type and status of the component. The first flag
+describes the type:
+
+@multitable @columnfractions 0.2 0.7
+@headitem Flag @tab Meaning
+@item C @tab Init-style component
+@item A @tab Accept-style component
+@item I @tab Inetd-style component
+@item P @tab Pass-style component
+@item R @tab Output redirector
+@item E @tab Command being executed
+@end multitable
-@enumerate 1
-@item Component tag (@pxref{Component Statement}).
-@item PID of the running instance of the component.
-@item Command line of the component, as set by the @code{command}
-statement (@pxref{Component Statement, command}).
-@end enumerate
+ The second flag is meaningful only for components, i.e. if the first
+flag is one of @samp{CAIP}. Its values are:
-If the component is not running, the reason is indicated in the PID
-column, between the square brackets, e.g.:
+@multitable @columnfractions 0.2 0.7
+@headitem Flag @tab Meaning
+@item R @tab Running component
+@item D @tab Disabled component
+@item L @tab Inetd listener
+@item s @tab Component is sleeping
+@item S @tab Component is stopping
+@end multitable
-@smallexample
-component pmult [disabled; scheduled for Mon 01 Dec 2008 20:27:02]
- /usr/local/sbin/pmult
-@end smallexample
+ The next column lists the PID (for running components) or socket address
+(for internet listeners), or the string @samp{N/A} if neither of the
+above applies.
-@noindent
-(the example above is split in two lines for readability).
+ If the component is sleeping, the time of its scheduled wake-up is
+listed in the next column.
+
+ The rest of line contains the component command line.
@anchor{pies-restart}
@xopindex{restart-component, described}
You can restart any component by using the
@option{--restart-component} (@option{-R}) option, e.g.:

Return to:

Send suggestions and report system problems to the System administrator.