procd: Allow to configure default respawn retry count
[openwrt/openwrt.git] / package / system / procd / files / procd.sh
1 # procd API:
2 #
3 # procd_open_service(name, [script]):
4 # Initialize a new procd command message containing a service with one or more instances
5 #
6 # procd_close_service()
7 # Send the command message for the service
8 #
9 # procd_open_instance([name]):
10 # Add an instance to the service described by the previous procd_open_service call
11 #
12 # procd_set_param(type, [value...])
13 # Available types:
14 # command: command line (array).
15 # respawn info: array with 3 values $fail_threshold $restart_timeout $max_fail
16 # env: environment variable (passed to the process)
17 # data: arbitrary name/value pairs for detecting config changes (table)
18 # file: configuration files (array)
19 # netdev: bound network device (detects ifindex changes)
20 # limits: resource limits (passed to the process)
21 # user info: array with 1 values $username
22 #
23 # No space separation is done for arrays/tables - use one function argument per command line argument
24 #
25 # procd_close_instance():
26 # Complete the instance being prepared
27 #
28 # procd_kill(service, [instance]):
29 # Kill a service instance (or all instances)
30 #
31
32 . $IPKG_INSTROOT/usr/share/libubox/jshn.sh
33
34 _PROCD_SERVICE=
35
36 _procd_call() {
37 local old_cb
38
39 json_set_namespace procd old_cb
40 "$@"
41 json_set_namespace $old_cb
42 }
43
44 _procd_wrapper() {
45 while [ -n "$1" ]; do
46 eval "$1() { _procd_call _$1 \"\$@\"; }"
47 shift
48 done
49 }
50
51 _procd_ubus_call() {
52 local cmd="$1"
53
54 [ -n "$PROCD_DEBUG" ] && json_dump >&2
55 ubus call service "$cmd" "$(json_dump)"
56 json_cleanup
57 }
58
59 _procd_open_service() {
60 local name="$1"
61 local script="$2"
62
63 _PROCD_SERVICE="$name"
64 _PROCD_INSTANCE_SEQ=0
65
66 json_init
67 json_add_string name "$name"
68 [ -n "$script" ] && json_add_string script "$script"
69 json_add_object instances
70 }
71
72 _procd_close_service() {
73 json_close_object
74 service_triggers
75 _procd_ubus_call set
76 }
77
78 _procd_add_array_data() {
79 while [ "$#" -gt 0 ]; do
80 json_add_string "" "$1"
81 shift
82 done
83 }
84
85 _procd_add_array() {
86 json_add_array "$1"
87 shift
88 _procd_add_array_data "$@"
89 json_close_array
90 }
91
92 _procd_add_table_data() {
93 while [ -n "$1" ]; do
94 local var="${1%%=*}"
95 local val="${1#*=}"
96 [ "$1" = "$val" ] && val=
97 json_add_string "$var" "$val"
98 shift
99 done
100 }
101
102 _procd_add_table() {
103 json_add_object "$1"
104 shift
105 _procd_add_table_data "$@"
106 json_close_object
107 }
108
109 _procd_open_instance() {
110 local name="$1"; shift
111
112 _PROCD_INSTANCE_SEQ="$(($_PROCD_INSTANCE_SEQ + 1))"
113 name="${name:-instance$_PROCD_INSTANCE_SEQ}"
114 json_add_object "$name"
115 [ -n "$TRACE_SYSCALLS" ] && json_add_boolean trace "1"
116 }
117
118 _procd_open_trigger() {
119 json_add_array "triggers"
120 }
121
122 _procd_open_validate() {
123 json_add_array "validate"
124 }
125
126 _procd_add_jail() {
127 json_add_object "jail"
128 json_add_string name "$1"
129
130 shift
131
132 for a in $@; do
133 case $a in
134 log) json_add_boolean "log" "1";;
135 ubus) json_add_boolean "ubus" "1";;
136 procfs) json_add_boolean "procfs" "1";;
137 sysfs) json_add_boolean "sysfs" "1";;
138 ronly) json_add_boolean "ronly" "1";;
139 esac
140 done
141 json_add_object "mount"
142 json_close_object
143 json_close_object
144 }
145
146 _procd_add_jail_mount() {
147 local _json_no_warning=1
148
149 json_select "jail"
150 [ $? = 0 ] || return
151 json_select "mount"
152 [ $? = 0 ] || {
153 json_select ..
154 return
155 }
156 for a in $@; do
157 json_add_string "$a" "0"
158 done
159 json_select ..
160 json_select ..
161 }
162
163 _procd_add_jail_mount_rw() {
164 local _json_no_warning=1
165
166 json_select "jail"
167 [ $? = 0 ] || return
168 json_select "mount"
169 [ $? = 0 ] || {
170 json_select ..
171 return
172 }
173 for a in $@; do
174 json_add_string "$a" "1"
175 done
176 json_select ..
177 json_select ..
178 }
179
180 _procd_set_param() {
181 local type="$1"; shift
182
183 case "$type" in
184 env|data|limits)
185 _procd_add_table "$type" "$@"
186 ;;
187 command|netdev|file|respawn|watch)
188 _procd_add_array "$type" "$@"
189 ;;
190 error)
191 json_add_array "$type"
192 json_add_string "" "$@"
193 json_close_array
194 ;;
195 nice)
196 json_add_int "$type" "$1"
197 ;;
198 user|seccomp|capabilities)
199 json_add_string "$type" "$1"
200 ;;
201 stdout|stderr|no_new_privs)
202 json_add_boolean "$type" "$1"
203 ;;
204 esac
205 }
206
207 _procd_add_interface_trigger() {
208 json_add_array
209 _procd_add_array_data "$1"
210 shift
211
212 json_add_array
213 _procd_add_array_data "if"
214
215 json_add_array
216 _procd_add_array_data "eq" "interface" "$1"
217 shift
218 json_close_array
219
220 json_add_array
221 _procd_add_array_data "run_script" "$@"
222 json_close_array
223
224 json_close_array
225 json_close_array
226 }
227
228 _procd_add_reload_interface_trigger() {
229 local script=$(readlink "$initscript")
230 local name=$(basename ${script:-$initscript})
231
232 _procd_open_trigger
233 _procd_add_interface_trigger "interface.*" $1 /etc/init.d/$name reload
234 _procd_close_trigger
235 }
236
237 _procd_add_config_trigger() {
238 json_add_array
239 _procd_add_array_data "$1"
240 shift
241
242 json_add_array
243 _procd_add_array_data "if"
244
245 json_add_array
246 _procd_add_array_data "eq" "package" "$1"
247 shift
248 json_close_array
249
250 json_add_array
251 _procd_add_array_data "run_script" "$@"
252 json_close_array
253
254 json_close_array
255
256 json_close_array
257 }
258
259 _procd_add_raw_trigger() {
260 json_add_array
261 _procd_add_array_data "$1"
262 shift
263 local timeout=$1
264 shift
265
266 json_add_array
267 json_add_array
268 _procd_add_array_data "run_script" "$@"
269 json_close_array
270 json_close_array
271
272 json_add_int "" "$timeout"
273
274 json_close_array
275 }
276
277 _procd_add_reload_trigger() {
278 local script=$(readlink "$initscript")
279 local name=$(basename ${script:-$initscript})
280 local file
281
282 _procd_open_trigger
283 for file in "$@"; do
284 _procd_add_config_trigger "config.change" "$file" /etc/init.d/$name reload
285 done
286 _procd_close_trigger
287 }
288
289 _procd_add_validation() {
290 _procd_open_validate
291 $@
292 _procd_close_validate
293 }
294
295 _procd_append_param() {
296 local type="$1"; shift
297 local _json_no_warning=1
298
299 json_select "$type"
300 [ $? = 0 ] || {
301 _procd_set_param "$type" "$@"
302 return
303 }
304 case "$type" in
305 env|data|limits)
306 _procd_add_table_data "$@"
307 ;;
308 command|netdev|file|respawn|watch)
309 _procd_add_array_data "$@"
310 ;;
311 error)
312 json_add_string "" "$@"
313 ;;
314 esac
315 json_select ..
316 }
317
318 _procd_close_instance() {
319 local respawn_vals
320 if json_select respawn ; then
321 json_get_values respawn_vals
322 if [ -z "$respawn_vals" ]; then
323 local respawn_retry=$(uci_get system.@service[0].respawn_retry)
324 _procd_add_array_data 3600 5 ${respawn_retry:-5}
325 fi
326 json_select ..
327 fi
328
329 json_close_object
330 }
331
332 _procd_close_trigger() {
333 json_close_array
334 }
335
336 _procd_close_validate() {
337 json_close_array
338 }
339
340 _procd_add_instance() {
341 _procd_open_instance
342 _procd_set_param command "$@"
343 _procd_close_instance
344 }
345
346 _procd_kill() {
347 local service="$1"
348 local instance="$2"
349
350 json_init
351 [ -n "$service" ] && json_add_string name "$service"
352 [ -n "$instance" ] && json_add_string instance "$instance"
353 _procd_ubus_call delete
354 }
355
356 procd_open_data() {
357 local name="$1"
358 json_set_namespace procd __procd_old_cb
359 json_add_object data
360 }
361
362 procd_close_data() {
363 json_close_object
364 json_set_namespace $__procd_old_cb
365 }
366
367 _procd_set_config_changed() {
368 local package="$1"
369
370 json_init
371 json_add_string type config.change
372 json_add_object data
373 json_add_string package "$package"
374 json_close_object
375
376 ubus call service event "$(json_dump)"
377 }
378
379 procd_add_mdns_service() {
380 local service proto port
381 service=$1; shift
382 proto=$1; shift
383 port=$1; shift
384 json_add_object "${service}_$port"
385 json_add_string "service" "_$service._$proto.local"
386 json_add_int port "$port"
387 [ -n "$1" ] && {
388 json_add_array txt
389 for txt in $@; do json_add_string "" $txt; done
390 json_select ..
391 }
392 json_select ..
393 }
394
395 procd_add_mdns() {
396 procd_open_data
397 json_add_object "mdns"
398 procd_add_mdns_service $@
399 json_close_object
400 procd_close_data
401 }
402
403 uci_validate_section()
404 {
405 local _package="$1"
406 local _type="$2"
407 local _name="$3"
408 local _result
409 local _error
410 shift; shift; shift
411 _result=`/sbin/validate_data "$_package" "$_type" "$_name" "$@" 2> /dev/null`
412 _error=$?
413 eval "$_result"
414 [ "$_error" = "0" ] || `/sbin/validate_data "$_package" "$_type" "$_name" "$@" 1> /dev/null`
415 return $_error
416 }
417
418 _procd_wrapper \
419 procd_open_service \
420 procd_close_service \
421 procd_add_instance \
422 procd_add_raw_trigger \
423 procd_add_config_trigger \
424 procd_add_interface_trigger \
425 procd_add_reload_trigger \
426 procd_add_reload_interface_trigger \
427 procd_open_trigger \
428 procd_close_trigger \
429 procd_open_instance \
430 procd_close_instance \
431 procd_open_validate \
432 procd_close_validate \
433 procd_add_jail \
434 procd_add_jail_mount \
435 procd_add_jail_mount_rw \
436 procd_set_param \
437 procd_append_param \
438 procd_add_validation \
439 procd_set_config_changed \
440 procd_kill