Implement "wait" in the process manager + fix bug in kill reply handler.
[barrelfish] / usr / proc_mgmt / service.c
1 /**
2  * \file
3  * \brief Process management service.
4  */
5
6 /*
7  * Copyright (c) 2017, ETH Zurich.
8  * All rights reserved.
9  *
10  * This file is distributed under the terms in the attached LICENSE file.
11  * If you do not find this file, copies can be found by writing to:
12  * ETH Zurich D-INFK, Haldeneggsteig 4, CH-8092 Zurich. Attn: Systems Group.
13  */
14
15 #include <barrelfish/barrelfish.h>
16 #include <barrelfish/nameservice_client.h>
17 #include <barrelfish/proc_mgmt_client.h>
18 #include <barrelfish/spawn_client.h>
19 #include <if/monitor_defs.h>
20 #include <if/proc_mgmt_defs.h>
21 #include <if/spawn_defs.h>
22
23 #include "domain.h"
24 #include "internal.h"
25 #include "pending_clients.h"
26 #include "spawnd_state.h"
27
28 static void add_spawnd_handler(struct proc_mgmt_binding *b, coreid_t core_id,
29                                iref_t iref)
30 {
31     if (spawnd_state_exists(core_id)) {
32         DEBUG_ERR(PROC_MGMT_ERR_SPAWND_EXISTS, "spawnd_state_exists");
33         return;
34     }
35
36     // Bind with the spawnd.
37     struct spawn_binding *spawnb;
38     errval_t err = spawn_bind_iref(iref, &spawnb);
39     if (err_is_fail(err)) {
40         DEBUG_ERR(err, "spawn_bind_iref");
41         return;
42     }
43
44     err = spawnd_state_alloc(core_id, spawnb);
45     if (err_is_fail(err)) {
46         DEBUG_ERR(err, "spawnd_state_alloc");
47     }
48
49     debug_printf("Process manager bound with spawnd.%u on iref %u\n", core_id,
50             iref);
51 }
52
53 static void add_spawnd_handler_non_monitor(struct proc_mgmt_binding *b,
54                                            coreid_t core_id, iref_t iref)
55 {
56     debug_printf("Ignoring add_spawnd call: %s\n",
57                  err_getstring(PROC_MGMT_ERR_NOT_MONITOR));
58 }
59
60 static void spawn_reply_handler(struct spawn_binding *b,
61                                 struct capref domain_cap, errval_t spawn_err)
62 {
63     struct pending_client *cl;
64     errval_t err = pending_clients_release(domain_cap, &cl);
65     if (err_is_fail(err)) {
66         // This might be a kill request issued after a successful spawn/span
67         // followed by a local error in the process manager (see below). If that
68         // is the case, then we won't have a client, as it has already been
69         // released.
70         DEBUG_ERR(err, "failed to retrieve pending client based on domain cap "
71                   "returned by spawnd");
72         return;
73     }
74
75     errval_t resp_err = SYS_ERR_OK;
76     struct domain_entry *entry;
77     switch (cl->type) {
78         case ClientType_Spawn:
79             err = spawn_err;
80             if (err_is_ok(spawn_err)) {
81                 err = domain_spawn(domain_cap, cl->core_id);
82             }
83             resp_err = cl->b->tx_vtbl.spawn_response(cl->b, NOP_CONT, err,
84                                                      domain_cap);
85             break;
86
87         case ClientType_SpawnWithCaps:
88             err = spawn_err;
89             if (err_is_ok(spawn_err)) {
90                 err = domain_spawn(domain_cap, cl->core_id);
91             }
92             resp_err = cl->b->tx_vtbl.spawn_with_caps_response(cl->b, NOP_CONT,
93                                                                err, domain_cap);
94             break;
95
96         case ClientType_Span:
97             err = spawn_err;
98             if (err_is_ok(spawn_err)) {
99                 err = domain_span(domain_cap, cl->core_id);
100             }
101             resp_err = cl->b->tx_vtbl.span_response(cl->b, NOP_CONT, err);
102             break;
103
104         case ClientType_Kill:
105             if (err_is_fail(spawn_err)) {
106                 // Looks like some spawnd was unable to successfully kill
107                 // its dispatcher for this domain. Not much the process
108                 // manager can do about it; return the error to the client.
109                 resp_err = cl->b->tx_vtbl.kill_response(cl->b, NOP_CONT,
110                                                         err);
111                 break;
112             }
113
114             err = domain_get_by_cap(domain_cap, &entry);
115             if (err_is_fail(err)) {
116                 DEBUG_ERR(err, "failed to retrieve domain by domain_cap "
117                           "returned by spawnd after kill");
118                 break;
119             }
120
121             assert(entry->num_spawnds_running > 0);
122             assert(entry->status != DOMAIN_STATUS_STOPPED);
123
124             --entry->num_spawnds_running;
125             if (entry->num_spawnds_running == 0) {
126                 entry->status = DOMAIN_STATUS_STOPPED;
127                 entry->exit_status = EXIT_STATUS_KILLED;  // TODO(razvan): Is this desirable?
128
129                 resp_err = cl->b->tx_vtbl.kill_response(cl->b, NOP_CONT,
130                                                         err);
131
132                 // At this point, the domain exists in state STOPPED for
133                 // history reasons. For instance, if some other domain
134                 // issues a wait call for this one, the process manager can
135                 // return the exit status directly.
136                 // At some point, however, we might want to just clean up
137                 // the domain entry and recycle the domain cap.
138                 struct domain_waiter *waiter = entry->waiters;
139                 while (waiter != NULL) {
140                     waiter->b->tx_vtbl.wait_response(waiter->b,
141                                                      NOP_CONT,
142                                                      SYS_ERR_OK,
143                                                      entry->exit_status);
144                     struct domain_waiter *aux = waiter;
145                     waiter = waiter->next;
146                     free(aux);
147                 }
148                 break;
149             } else {
150                 // Expecting to receive further kill replies from other spawnds
151                 // for the same domain cap, hence re-add the pending client.
152                 err = pending_clients_add(domain_cap, cl->b, ClientType_Kill,
153                                           MAX_COREID);
154                 if (err_is_fail(err)) {
155                 DEBUG_ERR(err, "pending_clients_add in kill reply handler");
156                 }
157             }
158
159             break;
160
161         case ClientType_Exit:
162             if (err_is_fail(spawn_err)) {
163                 // Looks like some spawnd was unable to successfully kill
164                 // its dispatcher for this domain. Not much the process
165                 // manager can do about it. Furthermore, this was an exit call,
166                 // so there's no client to reply back to.
167                 break;
168             }
169
170             err = domain_get_by_cap(domain_cap, &entry);
171             if (err_is_fail(err)) {
172                 DEBUG_ERR(err, "failed to retrieve domain by domain_cap "
173                           "returned by spawnd after kill");
174                 break;
175             }
176
177             assert(entry->num_spawnds_running > 0);
178             assert(entry->status != DOMAIN_STATUS_STOPPED);
179
180             --entry->num_spawnds_running;
181             if (entry->num_spawnds_running == 0) {
182                 entry->status = DOMAIN_STATUS_STOPPED;
183
184                 // At this point, the domain exists in state STOPPED for
185                 // history reasons. For instance, if some other domain
186                 // issues a wait call for this one, the process manager can
187                 // return the exit status directly.
188                 // At some point, however, we might want to just clean up
189                 // the domain entry and recycle the domain cap.
190                 struct domain_waiter *waiter = entry->waiters;
191                 while (waiter != NULL) {
192                     waiter->b->tx_vtbl.wait_response(waiter->b,
193                                                      NOP_CONT,
194                                                      SYS_ERR_OK,
195                                                      entry->exit_status);
196                     struct domain_waiter *aux = waiter;
197                     waiter = waiter->next;
198                     free(aux);
199                 }
200                 break;
201             } else {
202                 // Expecting to receive further kill replies from other spawnds
203                 // for the same domain cap, hence re-add the pending client.
204                 err = pending_clients_add(domain_cap, cl->b, ClientType_Exit,
205                                           MAX_COREID);
206                 if (err_is_fail(err)) {
207                 DEBUG_ERR(err, "pending_clients_add in exit reply handler");
208                 }
209             }
210
211         break;
212
213         default:
214             // TODO(razvan): Handle the other cases, e.g. wait.
215             debug_printf("Unknown client type %u\n", cl->type);
216             return;
217     }
218
219     if (err_is_ok(spawn_err) && err_is_fail(err)) {
220         // Spawnd has successfully completed its end of the operation, but
221         // there's been an error in the process manager's book-keeping
222         // of domains. Therefore, if the request was a spawn or span one, spawnd
223         // needs to be asked to stop the dispatcher which it has just enqueued.
224         if (cl->type == ClientType_Spawn ||
225             cl->type == ClientType_SpawnWithCaps ||
226             cl->type == ClientType_Span) {
227             struct spawnd_state *state = spawnd_state_get(cl->core_id);
228             assert(state != NULL);
229             struct spawn_binding *spb = state->b;
230             assert(spb != NULL);
231
232             err = spb->tx_vtbl.kill_request(spb, NOP_CONT, domain_cap);
233             if (err_is_fail(err)) {
234                 // XXX: How severe is this? Maybe we want something more
235                 // assertive than logging an error message.
236                 DEBUG_ERR(err, "failed to send kill request for dangling "
237                           "dispatcher");
238             }
239         }
240     }
241
242     free(cl);
243
244     if (err_is_fail(resp_err)) {
245         DEBUG_ERR(resp_err, "failed to send response to client");
246     }
247 }
248
249 static errval_t spawn_handler_common(struct proc_mgmt_binding *b,
250                                      enum ClientType type,
251                                      coreid_t core_id, const char *path,
252                                      const char *argvbuf, size_t argvbytes,
253                                      const char *envbuf, size_t envbytes,
254                                      struct capref inheritcn_cap,
255                                      struct capref argcn_cap, uint8_t flags,
256                                      struct capref *ret_domain_cap)
257 {
258     assert(ret_domain_cap != NULL);
259
260     if (!spawnd_state_exists(core_id)) {
261         return PROC_MGMT_ERR_INVALID_SPAWND;
262     }
263
264     struct spawnd_state *state = spawnd_state_get(core_id);
265     assert(state != NULL);
266     struct spawn_binding *cl = state->b;
267     assert(cl != NULL);
268
269     struct capref domain_cap;
270     errval_t err = slot_alloc(&domain_cap);
271     if (err_is_fail(err)) {
272         DEBUG_ERR(err, "slot_alloc domain_cap");
273         return err_push(err, PROC_MGMT_ERR_CREATE_DOMAIN_CAP);
274     }
275     err = cap_retype(domain_cap, cap_procmng, 0, ObjType_Domain, 0, 1);
276     if (err_is_fail(err)) {
277         DEBUG_ERR(err, "cap_retype domain_cap");
278         return err_push(err, PROC_MGMT_ERR_CREATE_DOMAIN_CAP);
279     }
280
281     err = pending_clients_add(domain_cap, b, type, core_id);
282     if (err_is_fail(err)) {
283         DEBUG_ERR(err, "pending_clients_add");
284         return err;
285     }
286
287     cl->rx_vtbl.spawn_reply = spawn_reply_handler;
288     if (capref_is_null(inheritcn_cap) && capref_is_null(argcn_cap)) {
289         err = cl->tx_vtbl.spawn_request(cl, NOP_CONT, domain_cap, path, argvbuf,
290                                         argvbytes, envbuf, envbytes, flags);
291     } else {
292         err = cl->tx_vtbl.spawn_with_caps_request(cl, NOP_CONT, domain_cap,
293                                                   path, argvbuf, argvbytes,
294                                                   envbuf, envbytes,
295                                                   inheritcn_cap, argcn_cap,
296                                                   flags);
297     }
298     if (err_is_fail(err)) {
299         DEBUG_ERR(err, "sending spawn request");
300         pending_clients_release(domain_cap, NULL);
301         return err_push(err, PROC_MGMT_ERR_SPAWND_REQUEST);
302     }
303
304     return SYS_ERR_OK;
305 }
306
307 static void spawn_handler(struct proc_mgmt_binding *b, coreid_t core_id,
308                           const char *path, const char *argvbuf,
309                           size_t argvbytes, const char *envbuf, size_t envbytes,
310                           uint8_t flags)
311 {
312     errval_t err, resp_err;
313     struct capref domain_cap;
314     err = spawn_handler_common(b, ClientType_Spawn, core_id, path, argvbuf,
315                                argvbytes, envbuf, envbytes, NULL_CAP, NULL_CAP,
316                                flags, &domain_cap);
317     if (err_is_ok(err)) {
318         // Will respond to client when we get the reply from spawnd.
319         return;
320     }
321
322     resp_err = b->tx_vtbl.spawn_response(b, NOP_CONT, err, NULL_CAP);
323     if (err_is_fail(resp_err)) {
324         DEBUG_ERR(resp_err, "failed to send spawn_response");
325     }
326 }
327
328 static void spawn_with_caps_handler(struct proc_mgmt_binding *b,
329                                     coreid_t core_id, const char *path,
330                                     const char *argvbuf, size_t argvbytes,
331                                     const char *envbuf, size_t envbytes,
332                                     struct capref inheritcn_cap,
333                                     struct capref argcn_cap, uint8_t flags)
334 {
335     errval_t err, resp_err;
336     struct capref domain_cap;
337     err = spawn_handler_common(b, ClientType_SpawnWithCaps, core_id, path,
338                                argvbuf, argvbytes, envbuf, envbytes,
339                                inheritcn_cap, argcn_cap, flags, &domain_cap);
340     if (err_is_ok(err)) {
341         // Will respond to client when we get the reply from spawnd.
342         return;
343     }
344
345     resp_err = b->tx_vtbl.spawn_with_caps_response(b, NOP_CONT, err,
346                                                             NULL_CAP);
347     if (err_is_fail(resp_err)) {
348         DEBUG_ERR(resp_err, "failed to send spawn_with_caps_response");
349     }
350 }
351
352 static void span_handler(struct proc_mgmt_binding *b, struct capref domain_cap,
353                          coreid_t core_id, struct capref vroot,
354                          struct capref dispframe)
355 {
356     errval_t err, resp_err;
357     err = domain_can_span(domain_cap, core_id);
358     if (err_is_fail(err)) {
359         goto respond_with_err;
360     }
361
362     if (!spawnd_state_exists(core_id)) {
363         err = PROC_MGMT_ERR_INVALID_SPAWND;
364         goto respond_with_err;
365     }
366
367     struct spawnd_state *state = spawnd_state_get(core_id);
368     assert(state != NULL);
369     struct spawn_binding *cl = state->b;
370     assert(cl != NULL);
371
372     err = pending_clients_add(domain_cap, b, ClientType_Span, core_id);
373     if (err_is_fail(err)) {
374         goto respond_with_err;
375     }
376
377     cl->rx_vtbl.spawn_reply = spawn_reply_handler;
378     err = cl->tx_vtbl.span_request(cl, NOP_CONT, domain_cap, vroot, dispframe);
379     if (err_is_ok(err)) {
380         // Will respond to client when we get the reply from spawnd.
381         return;
382     } else {
383         DEBUG_ERR(err, "sending span request");
384         pending_clients_release(domain_cap, NULL);
385         err = err_push(err, PROC_MGMT_ERR_SPAWND_REQUEST);
386     }
387
388 respond_with_err:
389     resp_err = b->tx_vtbl.span_response(b, NOP_CONT, err);
390     if (err_is_fail(resp_err)) {
391         DEBUG_ERR(resp_err, "failed to send span_response");
392     }
393 }
394
395 static errval_t kill_handler_common(struct proc_mgmt_binding *b,
396                                     struct capref domain_cap,
397                                     enum ClientType type,
398                                     uint8_t exit_status)
399 {
400     errval_t err = pending_clients_add(domain_cap, b, type, MAX_COREID);
401     if (err_is_fail(err)) {
402         return err;
403     }
404
405     struct domain_entry *entry;
406     err = domain_get_by_cap(domain_cap, &entry);
407     if (err_is_fail(err)) {
408         return err;
409     }
410
411     entry->exit_status = exit_status;
412     domain_stop_pending(entry);
413
414     for (coreid_t i = 0; i < MAX_COREID; ++i) {
415         if (entry->spawnds[i] == NULL) {
416             continue;
417         }
418
419         struct spawn_binding *spb = entry->spawnds[i]->b;
420         spb->rx_vtbl.spawn_reply = spawn_reply_handler;
421         errval_t req_err = spb->tx_vtbl.kill_request(spb, NOP_CONT, domain_cap);
422         if (err_is_fail(req_err)) {
423             DEBUG_ERR(req_err, "failed to send kill_request to spawnd %u\n", i);
424         }
425     }
426
427     return SYS_ERR_OK;
428 }
429
430 static void kill_handler(struct proc_mgmt_binding *b, struct capref domain_cap)
431 {
432     errval_t err = kill_handler_common(b, domain_cap, ClientType_Kill,
433                                        EXIT_STATUS_KILLED);
434     if (err_is_fail(err)) {
435         errval_t resp_err = b->tx_vtbl.kill_response(b, NOP_CONT, err);
436         if (err_is_fail(resp_err)) {
437             DEBUG_ERR(resp_err, "failed to send kill_response");
438         }
439     }
440 }
441
442 static void exit_handler(struct proc_mgmt_binding *b, struct capref domain_cap,
443                          uint8_t exit_status)
444 {
445     errval_t err = kill_handler_common(b, domain_cap, ClientType_Exit,
446                                        exit_status);
447     if (err_is_fail(err)) {
448         DEBUG_ERR(err, "processing exit_handler for requesting domain, exit "
449                   "code %u", exit_status);
450     }
451     // Error or not, there's no client to reply to anymore.
452 }
453
454 static void wait_handler(struct proc_mgmt_binding *b, struct capref domain_cap)
455 {
456     errval_t err, resp_err;
457     struct domain_entry *entry;
458     err = domain_get_by_cap(domain_cap, &entry);
459     if (err_is_fail(err)) {
460         goto respond;
461     }
462
463     if (entry->status == DOMAIN_STATUS_STOPPED) {
464         // Domain has already been stopped, so just reply with exit status.
465         goto respond;
466     }
467
468     struct domain_waiter *waiter = (struct domain_waiter*) malloc(
469             sizeof(struct domain_waiter));
470     waiter->b = b;
471     waiter->next = entry->waiters;
472     entry->waiters = waiter;
473     // Will respond when domain is stopped.
474     return;
475
476 respond:
477     resp_err = b->tx_vtbl.wait_response(b, NOP_CONT, err, entry->exit_status);
478     if (err_is_fail(resp_err)) {
479         DEBUG_ERR(resp_err, "failed to send wait_response");
480     }
481 }
482
483 static struct proc_mgmt_rx_vtbl monitor_vtbl = {
484     .add_spawnd           = add_spawnd_handler,
485     .spawn_call           = spawn_handler,
486     .spawn_with_caps_call = spawn_with_caps_handler,
487     .span_call            = span_handler,
488     .kill_call            = kill_handler,
489     .exit                 = exit_handler,
490     .wait_call            = wait_handler
491 };
492
493 static struct proc_mgmt_rx_vtbl non_monitor_vtbl = {
494     .add_spawnd           = add_spawnd_handler_non_monitor,
495     .spawn_call           = spawn_handler,
496     .spawn_with_caps_call = spawn_with_caps_handler,
497     .span_call            = span_handler,
498     .kill_call            = kill_handler,
499     .exit                 = exit_handler,
500     .wait_call            = wait_handler
501 };
502
503 static errval_t alloc_ep_for_monitor(struct capref *ep)
504 {
505     struct proc_mgmt_lmp_binding *lmpb =
506         malloc(sizeof(struct proc_mgmt_lmp_binding));
507     assert(lmpb != NULL);
508
509     // setup our end of the binding
510     errval_t err = proc_mgmt_client_lmp_accept(lmpb, get_default_waitset(),
511                                                DEFAULT_LMP_BUF_WORDS);
512     if (err_is_fail(err)) {
513         free(lmpb);
514         return err_push(err, LIB_ERR_PROC_MGMT_CLIENT_ACCEPT);
515     }
516
517     *ep = lmpb->chan.local_cap;
518     lmpb->b.rx_vtbl = monitor_vtbl;
519
520     return SYS_ERR_OK;
521 }
522
523 static void export_cb(void *st, errval_t err, iref_t iref)
524 {
525     if (err_is_fail(err)) {
526         USER_PANIC_ERR(err, "export failed");
527     }
528
529     // Allocate an endpoint for the local monitor, who will use it to inform
530     // us about new spawnd irefs on behalf of other monitors.
531     struct capref ep;
532     err = alloc_ep_for_monitor(&ep);
533     if (err_is_fail(err)) {
534         USER_PANIC_ERR(err, "failed to allocate LMP EP for local monitor");
535     }
536
537     // Send the endpoint to the monitor, so it can finish the handshake.
538     struct monitor_binding *mb = get_monitor_binding();
539     err = mb->tx_vtbl.set_proc_mgmt_ep_request(mb, NOP_CONT, ep);
540     if (err_is_fail(err)) {
541         USER_PANIC_ERR(err, "failed to send set_proc_mgmt_ep_request to "
542                        "monitor");
543     }
544
545     // Also register this iref with the name service, for arbitrary client
546     // domains to use for spawn-related ops.
547     err = nameservice_register(SERVICE_BASENAME, iref);
548     if (err_is_fail(err)) {
549         USER_PANIC_ERR(err, "nameservice_register failed");
550     }
551 }
552
553 static errval_t connect_cb(void *st, struct proc_mgmt_binding *b)
554 {
555     b->rx_vtbl = non_monitor_vtbl;
556     return SYS_ERR_OK;
557 }
558
559 errval_t start_service(void)
560 {
561     return proc_mgmt_export(NULL, export_cb, connect_cb, get_default_waitset(),
562             IDC_EXPORT_FLAGS_DEFAULT);
563 }