diff options
Diffstat (limited to 'doc/pies.texi')
-rw-r--r-- | doc/pies.texi | 176 |
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,5 +1,101 @@ -@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-*- +@smallbook +@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 + +@ifinfo +@dircategory GNU Utilities +@direntry (pies) pies. Program execution supervisor. +@end direntry +@end ifinfo + +@copying +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 + +@titlepage +@title Program Invocation and Execution Supervisor +@subtitle version @value{VERSION}, @value{UPDATED} +@author Sergey Poznyakoff. +@page +@vskip 0pt plus 1filll +@insertcopying +@end titlepage + +@page +@summarycontents +@page +@contents + +@ifnottex +@node Top +@top Pies + +This edition of the @cite{Pies Manual}, last updated @value{UPDATED}, +documents @command{pies} Version @value{VERSION}. +@end ifnottex + +@menu +* Intro:: +* Pies Configuration File:: +* Component Statement:: +* include-meta1:: +* Global Configuration:: +* Pies Debugging:: +* Configuration Example:: +* Command Line Usage:: +* Pies Invocation:: + +Appendices + +* 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 @@ -87,10 +183,2 @@ statement (@pxref{include-meta1}). @menu -* Pies Configuration File:: -* Component Statement:: -* include-meta1:: -* Global Configuration:: -* Pies Debugging:: -* Configuration Example:: -* Command Line Usage:: -* Pies Invocation:: @end menu @@ -98,3 +186,3 @@ statement (@pxref{include-meta1}). @node Pies Configuration File -@section Pies Configuration File +@chapter Pies Configuration File @command{Pies} reads its configuration from the main Mailutils @@ -106,3 +194,3 @@ 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. @@ -125,3 +213,3 @@ mailutils, GNU Mailutils Manual}. @node Component Statement -@section Component Statement +@chapter Component Statement @kwindex component @@ -205,3 +293,3 @@ respawn too fast. @node Prerequisites -@subsection Component Prerequisites +@section Component Prerequisites @cindex declaring prerequisites @@ -232,3 +320,3 @@ component tags. @node Component Privileges -@subsection Component Privileges +@section Component Privileges @cindex privileges, pies @@ -252,3 +340,3 @@ components specified in @file{meta1.conf} file (@pxref{include-meta1}). @node Resources -@subsection Resources +@section Resources @@ -342,3 +430,3 @@ before assignment. @node Actions Before Startup -@subsection Actions Before Startup +@section Actions Before Startup @@ -367,3 +455,3 @@ This may change in future versions. @node Exit Actions -@subsection Exit Actions +@section Exit Actions @kwindex return-code @@ -479,3 +567,3 @@ The following macro-variables are expanded within @var{string}: @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}). @@ -506,3 +594,3 @@ all components. Any @code{return-code} statements appearing within a @node Output Redirectors -@subsection Output Redirectors +@section Output Redirectors @cindex repeater @@ -552,3 +640,3 @@ through @samp{local7} (all names case-insensitive), or a facility number. @node Inetd-Style Components -@subsection Inetd-Style Components +@section Inetd-Style Components @cindex inetd-style components @@ -610,3 +698,3 @@ be added if there is a demand. @node Meta1-Style Components -@subsection Meta1-Style Components +@section Meta1-Style Components @cindex meta1-style components @@ -629,3 +717,3 @@ upon its startup. @node Component Syntax Summary -@subsection Component Syntax Summary +@section Component Syntax Summary This subsection summarizes the @code{component} summary. For each @@ -729,3 +817,3 @@ component @var{tag} @{ @node include-meta1 -@section Using MeTA1 Configuration File +@chapter Using MeTA1 Configuration File @cindex /etc/meta1/meta1.conf @@ -784,3 +872,3 @@ component smtps @{ @node Global Configuration -@section Global Configuration +@chapter Global Configuration The statements described in this section affect @command{pies} @@ -813,3 +901,3 @@ Default is 5 seconds. @node Less Useful Statements -@subsection Less Useful Statements +@section Less Useful Statements @@ -828,3 +916,3 @@ Write PID of the master @command{pies} process to @var{file}. By default, master PID is stored in @file{@var{statedir}/pies.pid} -(@pxref{statedir}). +(@FIXME-pxref{statedir}). @end deffn @@ -860,3 +948,3 @@ Retain all supplementary groups of which user, given with @node Pies Debugging -@section Pies Debugging +@chapter Pies Debugging The amount of debugging information produced by @command{pies} is configured @@ -896,3 +984,3 @@ Debug the lexical analyzer of MeTA1 configuration file. @node Configuration Example -@section Configuration Example +@chapter Configuration Example In this section we provide several examples of working @command{pies} @@ -907,4 +995,5 @@ configuration files. @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 @@ -924,3 +1013,3 @@ component pmult @{ @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 @@ -966,3 +1055,3 @@ include-meta1 "/etc/meta1/meta1.conf"; @node Inetd Pies -@subsection Running Pies Instead of Inetd +@section Running Pies Instead of Inetd @@ -999,3 +1088,3 @@ component pop3d @{ @node Command Line Usage -@section Command Line Usage +@chapter Command Line Usage @@ -1108,3 +1197,3 @@ smtps: smar qmgr @node Pies Invocation -@section Pies Invocation +@chapter Pies Invocation @@ -1159 +1248,14 @@ 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 + +@bye |