diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2009-10-13 16:53:42 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2009-10-13 16:53:42 +0300 |
commit | c60e857d7f35128b077eac4a30a5900925bb38e8 (patch) | |
tree | c9bae66b94b2cfbd7b8869abf1b1dbe34bcf51e9 /README | |
parent | 8a4ba77068e5d7f6eab2cc1c1c10f31dcbccf7a6 (diff) | |
download | pies-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-- | README | 84 |
1 files changed, 84 insertions, 0 deletions
@@ -0,0 +1,84 @@ | |||
1 | Pies README | ||
2 | Copyright (C) 2009 Sergey Poznyakoff | ||
3 | See the end of file for copying conditions. | ||
4 | |||
5 | * Introduction | ||
6 | |||
7 | This file contains brief information about configuring, testing | ||
8 | and running Pies. It is *not* intended as a replacement | ||
9 | for the documentation, it is provided as a brief reference only. | ||
10 | The complete documentation for Pies is available in | ||
11 | doc/ subdirectory. To read it without installing the package | ||
12 | run `info -f doc/pies.info'. After the package is installed | ||
13 | the documentation can be accessed running `info Pies'. Invoking | ||
14 | `info pies' (with lower-case `p') will show you a concise | ||
15 | description of the command line syntax (similar to a man-page style). | ||
16 | |||
17 | * Overview | ||
18 | |||
19 | Pies (pronounced ``p-yes'') stands for the Program Invocation and | ||
20 | Execution Supervisor. This utility starts and controls execution of | ||
21 | external programs, called ``components''. Each component is a stand-alone | ||
22 | program, designed to be executed in the foreground. Upon startup pies | ||
23 | reads the list of components from its configuration file, starts them, | ||
24 | and remains in the background, controlling their execution. When a | ||
25 | component terminates, pies tries to restarts it. Its configuration allows | ||
26 | to specify actions other than simple restart, depending on the exit code | ||
27 | of the component. | ||
28 | |||
29 | Pies supports a wide variety of component types. For example, it can | ||
30 | bind the standard input and output of a component to a network socket, | ||
31 | which makes pies a replacement for the inetd utility. Pies implements | ||
32 | powerful access control lists, which are especially useful with such | ||
33 | inetd-style components. | ||
34 | |||
35 | Pies can also be used to manage MeTA1 (http://meta1.org) components. | ||
36 | Moreover, it is able to use MeTA1 configuration file directly, so that | ||
37 | migration from the native mcp utility to pies does not require any | ||
38 | efforts. | ||
39 | |||
40 | Pies gives you complete control over the execution environment of | ||
41 | each component. This includes modifying shell environment, running | ||
42 | components with the given user privileges, etc. The standard error | ||
43 | and/or output of any component may be redirected either to a disk | ||
44 | file or to syslog. | ||
45 | |||
46 | * Building | ||
47 | |||
48 | A usual three-state procedure: | ||
49 | |||
50 | ./configure | ||
51 | make | ||
52 | make install | ||
53 | |||
54 | See INSTALL for a generic options to ./configure. | ||
55 | |||
56 | * Configuring and Running | ||
57 | |||
58 | Please, see the Pies documentation. | ||
59 | |||
60 | * Bug reporting. | ||
61 | |||
62 | Send bug reports to <bug-pies@gnu.org.ua>. | ||
63 | |||
64 | |||
65 | * Copyright information: | ||
66 | |||
67 | Copyright (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 | |||
80 | Local Variables: | ||
81 | mode: outline | ||
82 | paragraph-separate: "[ ]*$" | ||
83 | version-control: never | ||
84 | End: | ||