aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2009-10-13 16:53:42 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2009-10-13 16:53:42 +0300
commitc60e857d7f35128b077eac4a30a5900925bb38e8 (patch)
treec9bae66b94b2cfbd7b8869abf1b1dbe34bcf51e9 /README
parent8a4ba77068e5d7f6eab2cc1c1c10f31dcbccf7a6 (diff)
downloadpies-c60e857d7f35128b077eac4a30a5900925bb38e8.tar.gz
pies-c60e857d7f35128b077eac4a30a5900925bb38e8.tar.bz2
Bugfixes.
* README: Update. * configure.ac: Change bug-reporting address. * doc/pies.texi: Minor fixes. * src/pies.c: New configuration statements: mailer-program and mailer-command-line. (mailer_program, mailer_command_line) (mailer_argc, mailer_argv): New globals. * src/pies.h (mailer_program, mailer_command_line) (mailer_argc, mailer_argv): New globals. * src/progman.c (destroy_prog): Bugfix: update master program when destroying a retranslator. (send_msg): Several bugfixes. Use mailer_argc, mailer_argv instead of hardcoding sendmail command line. Remove invalid recipient addresses from the resulting command line.
Diffstat (limited to 'README')
-rw-r--r--README84
1 files changed, 84 insertions, 0 deletions
diff --git a/README b/README
index e69de29..6b86aea 100644
--- a/README
+++ b/README
@@ -0,0 +1,84 @@
1Pies README
2Copyright (C) 2009 Sergey Poznyakoff
3See the end of file for copying conditions.
4
5* Introduction
6
7This file contains brief information about configuring, testing
8and running Pies. It is *not* intended as a replacement
9for the documentation, it is provided as a brief reference only.
10The complete documentation for Pies is available in
11doc/ subdirectory. To read it without installing the package
12run `info -f doc/pies.info'. After the package is installed
13the documentation can be accessed running `info Pies'. Invoking
14`info pies' (with lower-case `p') will show you a concise
15description of the command line syntax (similar to a man-page style).
16
17* Overview
18
19Pies (pronounced ``p-yes'') stands for the Program Invocation and
20Execution Supervisor. This utility starts and controls execution of
21external programs, called ``components''. Each component is a stand-alone
22program, designed to be executed in the foreground. Upon startup pies
23reads the list of components from its configuration file, starts them,
24and remains in the background, controlling their execution. When a
25component terminates, pies tries to restarts it. Its configuration allows
26to specify actions other than simple restart, depending on the exit code
27of the component.
28
29Pies supports a wide variety of component types. For example, it can
30bind the standard input and output of a component to a network socket,
31which makes pies a replacement for the inetd utility. Pies implements
32powerful access control lists, which are especially useful with such
33inetd-style components.
34
35Pies can also be used to manage MeTA1 (http://meta1.org) components.
36Moreover, it is able to use MeTA1 configuration file directly, so that
37migration from the native mcp utility to pies does not require any
38efforts.
39
40Pies gives you complete control over the execution environment of
41each component. This includes modifying shell environment, running
42components with the given user privileges, etc. The standard error
43and/or output of any component may be redirected either to a disk
44file or to syslog.
45
46* Building
47
48A usual three-state procedure:
49
50 ./configure
51 make
52 make install
53
54See INSTALL for a generic options to ./configure.
55
56* Configuring and Running
57
58Please, see the Pies documentation.
59
60* Bug reporting.
61
62Send bug reports to <bug-pies@gnu.org.ua>.
63
64
65* Copyright information:
66
67Copyright (C) 2009 Sergey Poznyakoff
68
69 Permission is granted to anyone to make or distribute verbatim copies
70 of this document as received, in any medium, provided that the
71 copyright notice and this permission notice are preserved,
72 thus giving the recipient permission to redistribute in turn.
73
74 Permission is granted to distribute modified versions
75 of this document, or of portions of it,
76 under the above conditions, provided also that they
77 carry prominent notices stating who last changed them.
78
79
80Local Variables:
81mode: outline
82paragraph-separate: "[ ]*$"
83version-control: never
84End:

Return to:

Send suggestions and report system problems to the System administrator.