1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
genrc NEWS -- history of user-visible changes. 2020-09-09
See the end of file for copying conditions.
Please send genrc bug reports to <gray@gnu.org> or <gray@gnu.org.ua>
* Verbose diagnostics
Verbose diagnostics is enabled by the -v,--verbose option.
* Shell selection
By default, the program is started using "/bin/sh -c". Two options
are provided to alter this behavior:
-s, --shell=SHELL
Use SHELL to start the program. Default is /bin/sh.
-e, --exec
In sentinel mode, run the command directly via exec(3), instead
of via the shell.
* Syslog
In sentinel mode, the syslog facility and tag can be changed:
--log-facility=F
Use syslog facility F instead of the default "daemon".
(equivalent environment variable - GENRC_LOG_FACILITY)
--log-tag=S
Use syslog tag S instead of the program name.
(equivalent environment variable - GENRC_LOG_TAG)
* Runtime resource limits
The --limit (-l) option is provided to control the resource usage.
Its argument is a resource designator followed by the limit value
for that resource. Resource designators are:
c Core file size (KB).
d Data size (KB).
f File size (KB).
l Locked-in-memory address space (KB).
m Resident set size (KB).
n Number of open files.
p Process priority (nice value), -20..20.
s Stack size (KB).
t CPU time (seconds).
u Number of subprocesses.
v Virtual memory size (KB).
Version 1.1, 2018-05-20
Implements restart mode.
The restart mode is a special feature of sentinel mode, controlled by
the new options --restart-on-exit and --restart-on-signal. In this
mode genrc will restart the subsidiary program if it exits with a
predefined status code or terminates on a predefined signal. Use this
feature to ensure the service provided by the program controlled by
genrc won't get terminated because of hitting a bug or encountering an
unforeseen external condition.
For example:
genrc --command=COMMAND \
--sentinel \
--restart-on-exit='!0' --restart-on-signal='!TERM,QUIT' start
This will ensure that the COMMAND will be restarted immediately after
it terminates, unless it exits with the status 0 or terminates on
SIGTERM or SIGQUIT.
Version 1.0, 2018-05-15
Initial release
=========================================================================
Copyright information:
Copyright (C) 2018-2020 Sergey Poznyakoff
Permission is granted to anyone to make or distribute verbatim copies
of this document as received, in any medium, provided that the
copyright notice and this permission notice are preserved,
thus giving the recipient permission to redistribute in turn.
Permission is granted to distribute modified versions
of this document, or of portions of it,
under the above conditions, provided also that they
carry prominent notices stating who last changed them.
Local variables:
mode: outline
paragraph-separate: "[ ]*$"
eval: (add-hook 'write-file-hooks 'time-stamp)
time-stamp-start: "changes. "
time-stamp-format: "%:y-%02m-%02d"
time-stamp-end: "\n"
end:
|