3 # procd_open_service(name, [script]):
4 # Initialize a new procd command message containing a service with one or more instances
6 # procd_close_service()
7 # Send the command message for the service
9 # procd_open_instance([name]):
10 # Add an instance to the service described by the previous procd_open_service call
12 # procd_set_param(type, [value...])
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: $username to run service as
22 # group: $groupname to run service as
23 # pidfile: file name to write pid into
24 # stdout: boolean whether to redirect commands stdout to syslog (default: 0)
25 # stderr: boolean whether to redirect commands stderr to syslog (default: 0)
26 # facility: syslog facility used when logging to syslog (default: daemon)
28 # No space separation is done for arrays/tables - use one function argument per command line argument
30 # procd_close_instance():
31 # Complete the instance being prepared
33 # procd_running(service, [instance]):
34 # Checks if service/instance is currently running
36 # procd_kill(service, [instance]):
37 # Kill a service instance (or all instances)
39 # procd_send_signal(service, [instance], [signal])
40 # Send a signal to a service instance (or all instances)
43 . "$IPKG_INSTROOT/usr/share/libubox/jshn.sh"
45 PROCD_RELOAD_DELAY=1000
49 local basescript=$(readlink "$initscript")
50 local service_name="$(basename ${basescript:-$initscript})"
52 flock -n 1000 &> /dev/null
53 if [ "$?" != "0" ]; then
54 exec 1000>"$IPKG_INSTROOT/var/lock/procd_${service_name}.lock"
56 if [ "$?" != "0" ]; then
57 logger "warning: procd flock for $service_name failed"
65 json_set_namespace procd old_cb
67 json_set_namespace $old_cb
73 eval "$1() { _procd_call _$1 \"\$@\"; }"
81 [ -n "$PROCD_DEBUG" ] && json_dump >&2
82 ubus call service "$cmd" "$(json_dump)"
86 _procd_open_service() {
90 _PROCD_SERVICE="$name"
94 json_add_string name "$name"
95 [ -n "$script" ] && json_add_string script "$script"
96 json_add_object instances
99 _procd_close_service() {
107 _procd_ubus_call ${1:-set}
110 _procd_add_array_data() {
111 while [ "$#" -gt 0 ]; do
112 json_add_string "" "$1"
120 _procd_add_array_data "$@"
124 _procd_add_table_data() {
125 while [ -n "$1" ]; do
128 [ "$1" = "$val" ] && val=
129 json_add_string "$var" "$val"
137 _procd_add_table_data "$@"
141 _procd_open_instance() {
142 local name="$1"; shift
144 _PROCD_INSTANCE_SEQ="$(($_PROCD_INSTANCE_SEQ + 1))"
145 name="${name:-instance$_PROCD_INSTANCE_SEQ}"
146 json_add_object "$name"
147 [ -n "$TRACE_SYSCALLS" ] && json_add_boolean trace "1"
150 _procd_open_trigger() {
151 let '_procd_trigger_open = _procd_trigger_open + 1'
152 [ "$_procd_trigger_open" -gt 1 ] && return
153 json_add_array "triggers"
156 _procd_close_trigger() {
157 let '_procd_trigger_open = _procd_trigger_open - 1'
158 [ "$_procd_trigger_open" -lt 1 ] || return
163 let '_procd_data_open = _procd_data_open + 1'
164 [ "$_procd_data_open" -gt 1 ] && return
165 json_add_object "data"
168 _procd_close_data() {
169 let '_procd_data_open = _procd_data_open - 1'
170 [ "$_procd_data_open" -lt 1 ] || return
174 _procd_open_validate() {
176 json_add_array "validate"
179 _procd_close_validate() {
185 json_add_object "jail"
186 json_add_string name "$1"
192 log) json_add_boolean "log" "1";;
193 ubus) json_add_boolean "ubus" "1";;
194 procfs) json_add_boolean "procfs" "1";;
195 sysfs) json_add_boolean "sysfs" "1";;
196 ronly) json_add_boolean "ronly" "1";;
197 requirejail) json_add_boolean "requirejail" "1";;
198 netns) json_add_boolean "netns" "1";;
199 userns) json_add_boolean "userns" "1";;
200 cgroupsns) json_add_boolean "cgroupsns" "1";;
203 json_add_object "mount"
208 _procd_add_jail_mount() {
209 local _json_no_warning=1
219 json_add_string "$a" "0"
225 _procd_add_jail_mount_rw() {
226 local _json_no_warning=1
236 json_add_string "$a" "1"
243 local type="$1"; shift
247 _procd_add_table "$type" "$@"
249 command|netdev|file|respawn|watch)
250 _procd_add_array "$type" "$@"
253 json_add_array "$type"
254 json_add_string "" "$@"
258 json_add_int "$type" "$1"
261 json_add_int "$type" $(kill -l "$1")
263 pidfile|user|group|seccomp|capabilities|facility|\
264 extroot|overlaydir|tmpoverlaysize)
265 json_add_string "$type" "$1"
267 stdout|stderr|no_new_privs)
268 json_add_boolean "$type" "$1"
273 _procd_add_timeout() {
274 [ "$PROCD_RELOAD_DELAY" -gt 0 ] && json_add_int "" "$PROCD_RELOAD_DELAY"
278 _procd_add_interface_trigger() {
280 _procd_add_array_data "$1"
284 _procd_add_array_data "if"
287 _procd_add_array_data "eq" "interface" "$1"
292 _procd_add_array_data "run_script" "$@"
300 _procd_add_reload_interface_trigger() {
301 local script=$(readlink "$initscript")
302 local name=$(basename ${script:-$initscript})
305 _procd_add_interface_trigger "interface.*" $1 /etc/init.d/$name reload
309 _procd_add_config_trigger() {
311 _procd_add_array_data "$1"
315 _procd_add_array_data "if"
318 _procd_add_array_data "eq" "package" "$1"
323 _procd_add_array_data "run_script" "$@"
331 _procd_add_raw_trigger() {
333 _procd_add_array_data "$1"
340 _procd_add_array_data "run_script" "$@"
344 json_add_int "" "$timeout"
349 _procd_add_reload_trigger() {
350 local script=$(readlink "$initscript")
351 local name=$(basename ${script:-$initscript})
356 _procd_add_config_trigger "config.change" "$file" /etc/init.d/$name reload
361 _procd_add_validation() {
364 _procd_close_validate
367 _procd_append_param() {
368 local type="$1"; shift
369 local _json_no_warning=1
373 _procd_set_param "$type" "$@"
378 _procd_add_table_data "$@"
380 command|netdev|file|respawn|watch)
381 _procd_add_array_data "$@"
384 json_add_string "" "$@"
390 _procd_close_instance() {
393 if json_select respawn ; then
394 json_get_values respawn_vals
395 if [ -z "$respawn_vals" ]; then
396 local respawn_threshold=$(uci_get system.@service[0].respawn_threshold)
397 local respawn_timeout=$(uci_get system.@service[0].respawn_timeout)
398 local respawn_retry=$(uci_get system.@service[0].respawn_retry)
399 _procd_add_array_data ${respawn_threshold:-3600} ${respawn_timeout:-5} ${respawn_retry:-5}
407 _procd_add_instance() {
409 _procd_set_param command "$@"
410 _procd_close_instance
415 local instance="${2:-*}"
416 [ "$instance" = "*" ] || instance="'$instance'"
419 json_add_string name "$service"
420 local running=$(_procd_ubus_call list | jsonfilter -l 1 -e "@['$service'].instances[$instance].running")
422 [ "$running" = "true" ]
430 [ -n "$service" ] && json_add_string name "$service"
431 [ -n "$instance" ] && json_add_string instance "$instance"
432 _procd_ubus_call delete
435 _procd_send_signal() {
441 [A-Z]*) signal="$(kill -l "$signal" 2>/dev/null)" || return 1;;
445 json_add_string name "$service"
446 [ -n "$instance" -a "$instance" != "*" ] && json_add_string instance "$instance"
447 [ -n "$signal" ] && json_add_int signal "$signal"
448 _procd_ubus_call signal
457 [ -n "$service" ] && json_add_string name "$service"
459 data=$(_procd_ubus_call list | jsonfilter -e '@["'"$service"'"]')
460 [ -z "$data" ] && { echo "inactive"; return 3; }
462 data=$(echo "$data" | jsonfilter -e '$.instances')
463 if [ -z "$data" ]; then
464 [ -z "$instance" ] && { echo "active with no instances"; return 0; }
468 [ -n "$instance" ] && instance="\"$instance\"" || instance='*'
469 if [ -z "$(echo "$data" | jsonfilter -e '$['"$instance"']')" ]; then
470 echo "unknown instance $instance"; return 4
472 echo "running"; return 0
478 json_set_namespace procd __procd_old_cb
484 json_set_namespace $__procd_old_cb
487 _procd_set_config_changed() {
491 json_add_string type config.change
493 json_add_string package "$package"
496 ubus call service event "$(json_dump)"
499 procd_add_mdns_service() {
500 local service proto port
504 json_add_object "${service}_$port"
505 json_add_string "service" "_$service._$proto.local"
506 json_add_int port "$port"
509 for txt in "$@"; do json_add_string "" "$txt"; done
517 json_add_object "mdns"
518 procd_add_mdns_service "$@"
523 uci_validate_section()
531 _result=`/sbin/validate_data "$_package" "$_type" "$_name" "$@" 2> /dev/null`
534 [ "$_error" = "0" ] || `/sbin/validate_data "$_package" "$_type" "$_name" "$@" 1> /dev/null`
538 uci_load_validate() {
545 shift; shift; shift; shift
546 for _option in "$@"; do
547 eval "local ${_option%%:*}"
549 uci_validate_section "$_package" "$_type" "$_name" "$@"
551 [ -n "$_function" ] || return $_result
552 eval "$_function \"\$_name\" \"\$_result\""
557 procd_close_service \
559 procd_add_raw_trigger \
560 procd_add_config_trigger \
561 procd_add_interface_trigger \
562 procd_add_reload_trigger \
563 procd_add_reload_interface_trigger \
565 procd_close_trigger \
566 procd_open_instance \
567 procd_close_instance \
568 procd_open_validate \
569 procd_close_validate \
571 procd_add_jail_mount \
572 procd_add_jail_mount_rw \
575 procd_add_validation \
576 procd_set_config_changed \