path: root/doc/pies.texi
diff options
Diffstat (limited to 'doc/pies.texi')
1 files changed, 139 insertions, 37 deletions
diff --git a/doc/pies.texi b/doc/pies.texi
index 7f020f1..cc35b5d 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -1,7 +1,103 @@
-@c This file is part of the Mailfromd manual.
-@c Copyright (C) 2008, 2009 Sergey Poznyakoff
-@c See file mailfromd.texi for copying conditions.
-@c *******************************************************************
+\input texinfo @c -*-texinfo-*-
+@c %**start of header
+@setfilename pies.info
+@settitle Pies
+@c %**end of header
+@setchapternewpage odd
+@defcodeindex pr
+@defcodeindex op
+@c mt is the same as op, but used for mtasim options.
+@defcodeindex mt
+@defcodeindex kw
+@defcodeindex fl
+@syncodeindex fn cp
+@syncodeindex vr cp
+@syncodeindex ky cp
+@syncodeindex mt cp
+@syncodeindex pg cp
+@syncodeindex tp cp
+@syncodeindex op cp
+@syncodeindex pr cp
+@syncodeindex kw cp
+@syncodeindex fl cp
+@include version.texi
+@include rendition.texi
+@include macros.texi
+@dircategory GNU Utilities
+@direntry (pies) pies. Program execution supervisor.
+@end direntry
+@end ifinfo
+Published by the Free Software Foundation,
+51 Franklin Street, Fifth Floor,
+Boston, MA 02110-1301 USA
+Copyright @copyright{} 2005, 2006, 2007, 2008, 2009 Sergey Poznyakoff
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with the Front-Cover texts being ``Pies Manual'',
+and with the Back-Cover Texts as in (a) below. A copy of the license
+is included in the section entitled ``GNU Free Documentation License''.
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software. Copies published by the Free
+Software Foundation raise funds for GNU development.''
+@end copying
+@title Program Invocation and Execution Supervisor
+@subtitle version @value{VERSION}, @value{UPDATED}
+@author Sergey Poznyakoff.
+@vskip 0pt plus 1filll
+@end titlepage
+@node Top
+@top Pies
+This edition of the @cite{Pies Manual}, last updated @value{UPDATED},
+documents @command{pies} Version @value{VERSION}.
+@end ifnottex
+* Intro::
+* Pies Configuration File::
+* Component Statement::
+* include-meta1::
+* Global Configuration::
+* Pies Debugging::
+* Configuration Example::
+* Command Line Usage::
+* Pies Invocation::
+* Copying This Manual:: The GNU Free Documentation License.
+* Concept Index:: Index of Concepts.
+@c @detailmenu
+@c @end detailmenu
+@end menu
+@node Intro
+@chapter Introduction
@cindex component, pies
The name @command{pies} (pronounced @samp{p-yes}) stands for
@samp{Program Invocation and Execution Supervisor}. This utility
@@ -85,18 +181,10 @@ stopping component dependencies, the same ordering is preserved.
statement (@pxref{include-meta1}).
-* Pies Configuration File::
-* Component Statement::
-* include-meta1::
-* Global Configuration::
-* Pies Debugging::
-* Configuration Example::
-* Command Line Usage::
-* Pies Invocation::
@end menu
@node Pies Configuration File
-@section Pies Configuration File
+@chapter Pies Configuration File
@command{Pies} reads its configuration from the main Mailutils
configuration file. @xref{configuration, Mailutils Configuration
File,, mailutils, GNU Mailutils Manual}, for a description of GNU
@@ -104,7 +192,7 @@ Mailutils configuration system. It is recommended to use
@code{include @var{directory}} statement (@pxref{Include, Include
Statement,, mailutils, GNU Mailutils Manual}), and to place
@command{pies} configuration in file @file{@var{directory}/pies}.
-@xref{MeTA1}, for an example.
+@xref{MeTA1,,, mailfromd, Mailfromd Manual}, for an example.
The following standard Mailutils configuration statements are understood:
@@ -123,7 +211,7 @@ mailutils, GNU Mailutils Manual}.
@end multitable
@node Component Statement
-@section Component Statement
+@chapter Component Statement
@kwindex component
The @code{component} statement defines a new component:
@@ -203,7 +291,7 @@ respawn too fast.
@end menu
@node Prerequisites
-@subsection Component Prerequisites
+@section Component Prerequisites
@cindex declaring prerequisites
@cindex prerequisites, declaring
Prerequisites (@pxref{component prerequisite}) for a component are
@@ -230,7 +318,7 @@ component tags.
@end deffn
@node Component Privileges
-@subsection Component Privileges
+@section Component Privileges
@cindex privileges, pies
Following statements control the privileges the component
is executed with.
@@ -250,7 +338,7 @@ components specified in @file{meta1.conf} file (@pxref{include-meta1}).
@end deffn
@node Resources
-@subsection Resources
+@section Resources
@deffn {Pies Conf} limits @var{string}
Impose limits on system resources, as defined by @var{string}. The
@@ -340,7 +428,7 @@ before assignment.
@end deffn
@node Actions Before Startup
-@subsection Actions Before Startup
+@section Actions Before Startup
Several statements are available that specify actions to perform
immediately before starting the component:
@@ -365,7 +453,7 @@ This may change in future versions.
@end deffn
@node Exit Actions
-@subsection Exit Actions
+@section Exit Actions
@kwindex return-code
The default behavior of @command{pies} if an @samp{init-style}
component terminates is to restart it. Unless the component
@@ -477,7 +565,7 @@ The following macro-variables are expanded within @var{string}:
@headitem Variable @tab Expansion
@item canonical-program-name @tab @samp{pies}
@item program-name @tab Program name of the @command{pies} binary.
-@item package @tab Package name (@samp{Mailfromd}).
+@item package @tab Package name (@samp{Pies}).
@item version @tab Package version (@value{VERSION}).
@item mu-version @tab Version of GNU Mailutils.
@item component @tab Name of the terminated component.
@@ -504,7 +592,7 @@ all components. Any @code{return-code} statements appearing within a
@code{component} block override the global ones.
@node Output Redirectors
-@subsection Output Redirectors
+@section Output Redirectors
@cindex repeater
Output redirectors allow to redirect the standard error and/or standard
output of a component to a file or @command{syslog} facility.
@@ -550,7 +638,7 @@ through @samp{local7} (all names case-insensitive), or a facility number.
@end deffn
@node Inetd-Style Components
-@subsection Inetd-Style Components
+@section Inetd-Style Components
@cindex inetd-style components
Inetd-style components are declared using @code{mode inetd}
statement. You must also declare a socket to listen for requests for
@@ -608,7 +696,7 @@ be added if there is a demand.
@end deffn
@node Meta1-Style Components
-@subsection Meta1-Style Components
+@section Meta1-Style Components
@cindex meta1-style components
Meta1-style components are declared using @code{mode pass}
statement. For such components, you must declare both a socket to
@@ -627,7 +715,7 @@ upon its startup.
@end deffn
@node Component Syntax Summary
-@subsection Component Syntax Summary
+@section Component Syntax Summary
This subsection summarizes the @code{component} summary. For each
statement, a reference to its detailed description is supplied.
@@ -727,7 +815,7 @@ component @var{tag} @{
@end smallexample
@node include-meta1
-@section Using MeTA1 Configuration File
+@chapter Using MeTA1 Configuration File
@cindex /etc/meta1/meta1.conf
@command{Pies} is able to take a list of components from MeTA1
configuration file:
@@ -782,7 +870,7 @@ component smtps @{
@end smallexample
@node Global Configuration
-@section Global Configuration
+@chapter Global Configuration
The statements described in this section affect @command{pies}
behavior as a whole.
@@ -811,7 +899,7 @@ Default is 5 seconds.
@end menu
@node Less Useful Statements
-@subsection Less Useful Statements
+@section Less Useful Statements
Some configuration file statements are provided for completeness and
are rarely, if at all used. If used improperly, they may severely
@@ -826,7 +914,7 @@ suit your needs:
@deffn {Pies Conf} pidfile @var{file}
Write PID of the master @command{pies} process to @var{file}. By
default, master PID is stored in @file{@var{statedir}/pies.pid}
@end deffn
@deffn {Pies Conf} control-file @var{file}
@@ -858,7 +946,7 @@ Retain all supplementary groups of which user, given with
@end deffn
@node Pies Debugging
-@section Pies Debugging
+@chapter Pies Debugging
The amount of debugging information produced by @command{pies} is configured
by the following two configuration statements. First of all, the standard
@code{debug} block statement controls debugging of the underlying GNU
@@ -894,7 +982,7 @@ Debug the lexical analyzer of MeTA1 configuration file.
@end deffn
@node Configuration Example
-@section Configuration Example
+@chapter Configuration Example
In this section we provide several examples of working @command{pies}
configuration files.
@@ -905,8 +993,9 @@ configuration files.
@end menu
@node Simple Pies
-@subsection Simplest Case: Using Pies to Run Pmult
- The example below runs @command{pmult} (@pxref{pmult}) utility with
+@section Simplest Case: Using Pies to Run Pmult
+ The example below runs @command{pmult} (@pxref{pmult, Pmilter
+multiplexer program,, mailfromd, Mailfromd Manual}) utility with
the privileges of @samp{meta1} user. Both standard error and standard
output are redirected to the syslog facility @samp{mail}, priorities
@samp{err} and @samp{info}, correspondingly.
@@ -922,7 +1011,7 @@ component pmult @{
@end smallexample
@node Hairy Pies
-@subsection Using Pies to Run Pmult and MeTA1
+@section Using Pies to Run Pmult and MeTA1
The example below is a working configuration file for running
@command{pmult} and all components of MeTA1, configured in
@file{/etc/meta1/meta1.conf}. The global @code{return-code} statement
@@ -964,7 +1053,7 @@ include-meta1 "/etc/meta1/meta1.conf";
@end smallexample
@node Inetd Pies
-@subsection Running Pies Instead of Inetd
+@section Running Pies Instead of Inetd
This configuration file allows to run @command{pies} instead of
@command{initd}. It starts two services: @samp{ftp} and @samp{pop3d},
@@ -997,7 +1086,7 @@ component pop3d @{
@end smallexample
@node Command Line Usage
-@section 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
@@ -1106,7 +1195,7 @@ smtps: smar qmgr
@end smallexample
@node Pies Invocation
-@section Pies Invocation
+@chapter Pies Invocation
This section summarizes @command{pies} command line options.
@@ -1157,3 +1246,16 @@ Apart from these, the common GNU Mailutils options are understood, which
are useful for checking @command{pies} configuration file for syntax
errors. @xref{Common Options, Common Options, , mailutils, GNU
Mailutils Manual}, for a detailed description of these.
+@node Copying This Manual
+@appendix GNU Free Documentation License
+@include fdl.texi
+@node Concept Index
+@unnumbered Concept Index
+This is a general index of all issues discussed in this manual
+@printindex cp

Return to:

Send suggestions and report system problems to the System administrator.