78b01627d8cfa5d7c16ee54abe05b2b19b48815d
[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