README
1# examples/README
2# perp: persistent process supervision
3# sample perp services
4# wcm, 2009.12.28 - 2011.02.02
5# ===
6
7This directory contains the following sample perp services:
8
9 apgd automatic password generator
10 dnscache djbdns caching nameserver
11 hellod port 1789 (hello) service for testing
12 mathopd lightweight httpd server
13 sshd secure shell daemon
14
15To install a service:
16
17 $ su
18 # cp -R apgd /etc/perp
19 # chmod +x /etc/perp/apgd/rc.*
20
21To activate a service:
22
23 $ su
24 # chmod +t /etc/perp/apgd && perphup
25
26or (since perp-2.00):
27
28 $ su
29 # perpctl A apgd
30
31
32Notes:
33
34All services use the same generic rc.log runscript for logging
35with tinylog using the tinylog_run wrapper. A sample
36tinylog.conf file is shown here, and may be edited/installed
37in /etc/tinylog.conf.
38
39The tinylog_run script is setup to run under an unprivileged
40user account named `tinylog'. The administrator will need
41to add the appropriate user/group accounts to the system to
42enable this feature.
43
44### EOF
45