aboutsummaryrefslogtreecommitdiff
path: root/NEWS
blob: 153fad663a7bc5e974052b734cf68ad68438770b (plain)
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:

Return to:

Send suggestions and report system problems to the System administrator.