aboutsummaryrefslogtreecommitdiffstats
path: root/doc/pingu.conf.txt.in
blob: bb5f438806c49b78b17ce699cb79a00231278474 (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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
PINGU.CONF(5)
=============
:doctype: manpage


NAME
----
pingu.conf - pingu daemon configuration file


DESCRIPTION
-----------
The file can contain 3 different contexts: Global context, interface context
and host context.

Blank lines and lines starting with # are ignored.


GLOBAL CONTEXT
--------------
The config file starts in global context. In this section the default values
for the keywords used in interface on hosts sections are set. Values set in
global context can be overridden in interface and host sections.

*interval*::
Set the default ping burst interval

*timeout*::
	The default ping timout value in seconds. If the ping response does
	not come back within "timeout" seconds the ping is considered lost.

*required*::
	The minimum required ping responses of a burst to consider the host
	online.

*retries*::
	Maximum sent ping packets for a burst.

*up-action*::
	The default action to execute when a ping host goes online.

*down-action*::
	The default action to execute when a ping host goes offline.


INTERFACE CONTEXT
-----------------
Example:
....
interface eth0 {
	keyword value
	...
}
....


The keywords valid in an interface sections are:

*gateway-down-action*::
	Execute this action when a gateway is considered offline.

*gateway-up-action*::
	Execute this action when a gateway is considered online.

*label*::
	A user defined label that will be used in logs and by pinguctl.

*load-balance*::
	Enable balancing for this interface. A minimum of two interfaces need
	to be configured in order for load-balancing to work. An optional
	weight value can be given.

*required-hosts-online*::
	The minimum number of ping hosts that needs to be online to consider
	the gateway online.

*route-table*::
	The alternate route table for this interface.

*rule-priority*::
	The preference value for the ip rule.

*ping*::
	Host to ping to verify that gateway is still up. This is the same as
	defining a host and bind it to interface.

*fwmark*::
	Add an additional route rule for configured fwmark integer.


HOST CONTEXT
------------
Example:
....
host 1.2.3.4 {
	keyword value
	...
}
....

*bind-interface*::
	Bind the pings to this interface.

*down-action*::
	Execute this action when ping host goes offline.

*interval*::
	The interval for ping bursts.

*label*::
	A label to be used in logs and pinguctl.

*required*::
	The number of required ping responses to consider host online.

*retry*::
	The maximum number of retries for a ping burst.

*timeout*::
	The ping response timeout value in seconds. If no ping response
	returns within this value the ping is considered lost.

*up-action*::
	Execute this action when a ping host goes online


AUTHORS
-------
Natanael Copa