make message data on invoke() optional
[project/ubus.git] / libubus.c
1 #include <sys/types.h>
2 #include <sys/uio.h>
3 #include <sys/socket.h>
4 #include <unistd.h>
5
6 #include <libubox/blob.h>
7 #include <libubox/blobmsg.h>
8 #include <libubox/usock.h>
9
10 #include "libubus.h"
11 #include "ubusmsg.h"
12
13 #define DEBUG 1
14
15 #ifdef DEBUG
16 #define DPRINTF(_format, ...) fprintf(stderr, "ubus: " _format, ## __VA_ARGS__)
17 #else
18 #define DPRINTF(...) do {} while(0)
19 #endif
20
21 #define STATIC_IOV(_var) { .iov_base = (char *) &(_var), .iov_len = sizeof(_var) }
22
23 const char *__ubus_strerror[__UBUS_STATUS_LAST] = {
24         [UBUS_STATUS_OK] = "Success",
25         [UBUS_STATUS_INVALID_COMMAND] = "Invalid command",
26         [UBUS_STATUS_INVALID_ARGUMENT] = "Invalid argument",
27         [UBUS_STATUS_METHOD_NOT_FOUND] = "Method not found",
28         [UBUS_STATUS_NOT_FOUND] = "Not found",
29         [UBUS_STATUS_NO_DATA] = "No response",
30 };
31
32 static struct blob_buf b;
33
34 static const struct blob_attr_info ubus_policy[UBUS_ATTR_MAX] = {
35         [UBUS_ATTR_STATUS] = { .type = BLOB_ATTR_INT32 },
36         [UBUS_ATTR_OBJID] = { .type = BLOB_ATTR_INT32 },
37         [UBUS_ATTR_OBJPATH] = { .type = BLOB_ATTR_STRING },
38         [UBUS_ATTR_METHOD] = { .type = BLOB_ATTR_STRING },
39 };
40 static struct blob_attr *attrbuf[UBUS_ATTR_MAX];
41
42 struct ubus_pending_data {
43         struct list_head list;
44         int type;
45         struct blob_attr data[];
46 };
47
48 static int ubus_cmp_id(const void *k1, const void *k2, void *ptr)
49 {
50         const uint32_t *id1 = k1, *id2 = k2;
51
52         if (*id1 < *id2)
53                 return -1;
54         else
55                 return *id1 > *id2;
56 }
57
58 struct blob_attr **ubus_parse_msg(struct blob_attr *msg)
59 {
60         blob_parse(msg, attrbuf, ubus_policy, UBUS_ATTR_MAX);
61         return attrbuf;
62 }
63
64 const char *ubus_strerror(int error)
65 {
66         static char err[32];
67
68         if (error < 0 || error >= __UBUS_STATUS_LAST)
69                 goto out;
70
71         if (!__ubus_strerror[error])
72                 goto out;
73
74         return __ubus_strerror[error];
75
76 out:
77         sprintf(err, "Unknown error: %d", error);
78         return err;
79 }
80
81 static int ubus_send_msg(struct ubus_context *ctx, uint32_t seq,
82                          struct blob_attr *msg, int cmd, uint32_t peer)
83 {
84         struct ubus_msghdr hdr;
85         struct iovec iov[2] = {
86                 STATIC_IOV(hdr)
87         };
88
89         hdr.version = 0;
90         hdr.type = cmd;
91         hdr.seq = seq;
92         hdr.peer = peer;
93
94         if (!msg) {
95                 blob_buf_init(&b, 0);
96                 msg = b.head;
97         }
98
99         iov[1].iov_base = (char *) msg;
100         iov[1].iov_len = blob_raw_len(msg);
101
102         return writev(ctx->sock.fd, iov, 2);
103 }
104
105 int ubus_start_request(struct ubus_context *ctx, struct ubus_request *req,
106                        struct blob_attr *msg, int cmd, uint32_t peer)
107 {
108         memset(req, 0, sizeof(*req));
109
110         INIT_LIST_HEAD(&req->list);
111         INIT_LIST_HEAD(&req->pending);
112         req->ctx = ctx;
113         req->peer = peer;
114         req->seq = ++ctx->request_seq;
115         return ubus_send_msg(ctx, req->seq, msg, cmd, peer);
116 }
117
118 static bool recv_retry(int fd, struct iovec *iov, bool wait)
119 {
120         int bytes;
121
122         while (iov->iov_len > 0) {
123                 bytes = read(fd, iov->iov_base, iov->iov_len);
124                 if (bytes < 0) {
125                         bytes = 0;
126                         if (errno == EINTR)
127                                 continue;
128
129                         if (errno != EAGAIN) {
130                                 perror("read");
131                                 return false;
132                         }
133                 }
134                 if (!wait && !bytes)
135                         return false;
136
137                 wait = true;
138                 iov->iov_len -= bytes;
139                 iov->iov_base += bytes;
140         }
141
142         return true;
143 }
144
145 static bool ubus_validate_hdr(struct ubus_msghdr *hdr)
146 {
147         if (hdr->version != 0)
148                 return false;
149
150         if (blob_raw_len(hdr->data) < sizeof(*hdr->data))
151                 return false;
152
153         if (blob_raw_len(hdr->data) + sizeof(*hdr) > UBUS_MAX_MSGLEN)
154                 return false;
155
156         return true;
157 }
158
159 static bool get_next_msg(struct ubus_context *ctx, bool wait)
160 {
161         struct iovec iov = STATIC_IOV(ctx->msgbuf.hdr);
162
163         /* receive header + start attribute */
164         iov.iov_len += sizeof(struct blob_attr);
165         if (!recv_retry(ctx->sock.fd, &iov, wait))
166                 return false;
167
168         iov.iov_len = blob_len(ctx->msgbuf.hdr.data);
169         if (iov.iov_len > 0 && !recv_retry(ctx->sock.fd, &iov, true))
170                 return false;
171
172         return ubus_validate_hdr(&ctx->msgbuf.hdr);
173 }
174
175 static bool ubus_get_status(struct ubus_msghdr *hdr, int *ret)
176 {
177         ubus_parse_msg(hdr->data);
178
179         if (!attrbuf[UBUS_ATTR_STATUS])
180                 return false;
181
182         *ret = blob_get_int32(attrbuf[UBUS_ATTR_STATUS]);
183         return true;
184 }
185
186 static void req_data_cb(struct ubus_request *req, int type, struct blob_attr *data)
187 {
188         struct blob_attr **attr;
189
190         if (req->raw_data_cb)
191                 req->raw_data_cb(req, type, data);
192
193         if (!req->data_cb)
194                 return;
195
196         attr = ubus_parse_msg(data);
197         req->data_cb(req, type, attr[UBUS_ATTR_DATA]);
198 }
199
200 static void ubus_process_req_data(struct ubus_request *req)
201 {
202         struct ubus_pending_data *data;
203
204         while (!list_empty(&req->pending)) {
205                 data = list_first_entry(&req->pending,
206                         struct ubus_pending_data, list);
207                 list_del(&data->list);
208                 if (!req->cancelled)
209                         req_data_cb(req, data->type, data->data);
210                 free(data);
211         }
212 }
213
214 static void ubus_req_complete_cb(struct ubus_request *req)
215 {
216         ubus_complete_handler_t cb = req->complete_cb;
217
218         if (!cb)
219                 return;
220
221         req->complete_cb = NULL;
222         cb(req, req->status_code);
223 }
224
225 static int ubus_process_req_status(struct ubus_request *req, struct ubus_msghdr *hdr)
226 {
227         int ret = UBUS_STATUS_INVALID_ARGUMENT;
228
229         if (!list_empty(&req->list))
230                 list_del(&req->list);
231
232         ubus_get_status(hdr, &ret);
233         req->peer = hdr->peer;
234         req->status_msg = true;
235         req->status_code = ret;
236         if (!req->blocked)
237                 ubus_req_complete_cb(req);
238
239         return ret;
240 }
241
242 static void ubus_req_data(struct ubus_request *req, struct ubus_msghdr *hdr)
243 {
244         struct ubus_pending_data *data;
245         int len;
246
247         if (!req->blocked) {
248                 req->blocked = true;
249                 req_data_cb(req, hdr->type, hdr->data);
250                 ubus_process_req_data(req);
251                 req->blocked = false;
252
253                 if (req->status_msg)
254                         ubus_req_complete_cb(req);
255
256                 return;
257         }
258
259         len = blob_raw_len(hdr->data);
260         data = calloc(1, sizeof(*data) + len);
261         if (!data)
262                 return;
263
264         data->type = hdr->type;
265         memcpy(data->data, hdr->data, len);
266         list_add(&data->list, &req->pending);
267 }
268
269 static struct ubus_request *ubus_find_request(struct ubus_context *ctx, uint32_t seq, uint32_t peer)
270 {
271         struct ubus_request *req;
272
273         list_for_each_entry(req, &ctx->requests, list) {
274                 if (seq != req->seq || peer != req->peer)
275                         continue;
276
277                 return req;
278         }
279         return NULL;
280 }
281
282 static void ubus_process_invoke(struct ubus_context *ctx, struct ubus_msghdr *hdr)
283 {
284         struct ubus_request_data req;
285         struct ubus_object *obj;
286         uint32_t objid = 0;
287         int method;
288         int ret = 0;
289
290         ubus_parse_msg(hdr->data);
291
292         if (!attrbuf[UBUS_ATTR_OBJID])
293                 return;
294
295         objid = blob_get_int32(attrbuf[UBUS_ATTR_OBJID]);
296
297         if (!attrbuf[UBUS_ATTR_METHOD]) {
298                 ret = UBUS_STATUS_INVALID_ARGUMENT;
299                 goto send;
300         }
301
302         obj = avl_find_element(&ctx->objects, &objid, obj, avl);
303         if (!obj) {
304                 ret = UBUS_STATUS_NOT_FOUND;
305                 goto send;
306         }
307
308         for (method = 0; method < obj->n_methods; method++)
309                 if (!strcmp(obj->methods[method].name,
310                             blob_data(attrbuf[UBUS_ATTR_METHOD])))
311                         goto found;
312
313         /* not found */
314         ret = UBUS_STATUS_METHOD_NOT_FOUND;
315         goto send;
316
317 found:
318         req.object = objid;
319         req.peer = hdr->peer;
320         req.seq = hdr->seq;
321         ret = obj->methods[method].handler(ctx, obj, &req,
322                                            obj->methods[method].name,
323                                            attrbuf[UBUS_ATTR_DATA]);
324
325 send:
326         blob_buf_init(&b, 0);
327         blob_put_int32(&b, UBUS_ATTR_STATUS, ret);
328         blob_put_int32(&b, UBUS_ATTR_OBJID, objid);
329         ubus_send_msg(ctx, hdr->seq, b.head, UBUS_MSG_STATUS, hdr->peer);
330 }
331
332 static void ubus_process_msg(struct ubus_context *ctx, struct ubus_msghdr *hdr)
333 {
334         struct ubus_request *req;
335
336         switch(hdr->type) {
337         case UBUS_MSG_STATUS:
338                 req = ubus_find_request(ctx, hdr->seq, hdr->peer);
339                 if (!req)
340                         break;
341
342                 ubus_process_req_status(req, hdr);
343                 break;
344
345         case UBUS_MSG_DATA:
346                 req = ubus_find_request(ctx, hdr->seq, hdr->peer);
347                 if (req && (req->data_cb || req->raw_data_cb))
348                         ubus_req_data(req, hdr);
349                 break;
350
351         case UBUS_MSG_INVOKE:
352                 ubus_process_invoke(ctx, hdr);
353                 break;
354         default:
355                 DPRINTF("unknown message type: %d\n", hdr->type);
356                 break;
357         }
358 }
359
360 void ubus_abort_request(struct ubus_context *ctx, struct ubus_request *req)
361 {
362         if (!list_empty(&req->list))
363                 return;
364
365         req->cancelled = true;
366         ubus_process_req_data(req);
367         list_del(&req->list);
368 }
369
370 void ubus_complete_request_async(struct ubus_context *ctx, struct ubus_request *req)
371 {
372         if (!list_empty(&req->list))
373                 return;
374
375         list_add(&req->list, &ctx->requests);
376 }
377
378 static void ubus_handle_data(struct uloop_fd *u, unsigned int events)
379 {
380         struct ubus_context *ctx = container_of(u, struct ubus_context, sock);
381         struct ubus_msghdr *hdr = &ctx->msgbuf.hdr;
382
383         while (get_next_msg(ctx, false))
384                 ubus_process_msg(ctx, hdr);
385
386         if (u->eof)
387                 ctx->connection_lost(ctx);
388 }
389
390 int ubus_complete_request(struct ubus_context *ctx, struct ubus_request *req)
391 {
392         struct ubus_msghdr *hdr = &ctx->msgbuf.hdr;
393
394         if (!list_empty(&req->list))
395                 list_del(&req->list);
396
397         while (1) {
398                 if (req->status_msg)
399                         return req->status_code;
400
401                 if (req->cancelled)
402                         return UBUS_STATUS_NO_DATA;
403
404                 if (!get_next_msg(ctx, true))
405                         return UBUS_STATUS_NO_DATA;
406
407                 if (hdr->seq != req->seq || hdr->peer != req->peer)
408                         goto skip;
409
410                 switch(hdr->type) {
411                 case UBUS_MSG_STATUS:
412                         return ubus_process_req_status(req, hdr);
413                 case UBUS_MSG_DATA:
414                         if (req->data_cb || req->raw_data_cb)
415                                 ubus_req_data(req, hdr);
416                         continue;
417                 default:
418                         goto skip;
419                 }
420
421 skip:
422                 ubus_process_msg(ctx, hdr);
423         }
424 }
425
426 int ubus_send_reply(struct ubus_context *ctx, struct ubus_request_data *req,
427                     struct blob_attr *msg)
428 {
429         int ret;
430
431         blob_buf_init(&b, 0);
432         blob_put_int32(&b, UBUS_ATTR_OBJID, req->object);
433         blob_put(&b, UBUS_ATTR_DATA, blob_data(msg), blob_len(msg));
434         ret = ubus_send_msg(ctx, req->seq, b.head, UBUS_MSG_DATA, req->peer);
435         if (ret < 0)
436                 return UBUS_STATUS_NO_DATA;
437
438         return 0;
439 }
440
441 void ubus_invoke_async(struct ubus_context *ctx, uint32_t obj, const char *method,
442                        struct blob_attr *msg, struct ubus_request *req)
443 {
444         blob_buf_init(&b, 0);
445         blob_put_int32(&b, UBUS_ATTR_OBJID, obj);
446         blob_put_string(&b, UBUS_ATTR_METHOD, method);
447         if (msg)
448                 blob_put(&b, UBUS_ATTR_DATA, blob_data(msg), blob_len(msg));
449
450         ubus_start_request(ctx, req, b.head, UBUS_MSG_INVOKE, obj);
451 }
452
453 int ubus_invoke(struct ubus_context *ctx, uint32_t obj, const char *method,
454                 struct blob_attr *msg, ubus_data_handler_t cb, void *priv)
455 {
456         struct ubus_request req;
457
458         ubus_invoke_async(ctx, obj, method, msg, &req);
459         req.data_cb = cb;
460         req.priv = priv;
461         return ubus_complete_request(ctx, &req);
462 }
463
464 static void ubus_publish_cb(struct ubus_request *req, int type, struct blob_attr *msg)
465 {
466         struct ubus_object *obj = req->priv;
467
468         ubus_parse_msg(msg);
469
470         if (!attrbuf[UBUS_ATTR_OBJID])
471                 return;
472
473         obj->id = blob_get_int32(attrbuf[UBUS_ATTR_OBJID]);
474
475         if (attrbuf[UBUS_ATTR_OBJTYPE])
476                 obj->type->id = blob_get_int32(attrbuf[UBUS_ATTR_OBJTYPE]);
477
478         obj->avl.key = &obj->id;
479         avl_insert(&req->ctx->objects, &obj->avl);
480 }
481
482 static bool ubus_push_table_data(const struct ubus_signature **sig, int *rem, bool array)
483 {
484         const struct ubus_signature *cur;
485         bool nest_type;
486         void *nest;
487
488         while (rem) {
489                 cur = (*sig)++;
490                 (*rem)--;
491                 switch(cur->type) {
492                 case UBUS_SIGNATURE_END:
493                         return !array;
494                 case BLOBMSG_TYPE_INT32:
495                 case BLOBMSG_TYPE_STRING:
496                         blobmsg_add_u32(&b, cur->name, cur->type);
497                         break;
498                 case BLOBMSG_TYPE_TABLE:
499                 case BLOBMSG_TYPE_ARRAY:
500                         nest_type = cur->type == BLOBMSG_TYPE_ARRAY;
501                         nest = blobmsg_open_nested(&b, cur->name, nest_type);
502                         if (!ubus_push_table_data(sig, rem, nest_type))
503                                 return false;
504                         blobmsg_close_table(&b, nest);
505                         break;
506                 default:
507                         return false;
508                 }
509                 if (array)
510                         return true;
511         }
512         return false;
513 }
514
515 static bool ubus_push_object_type(struct ubus_object_type *type)
516 {
517         void *s, *m;
518         int rem = type->n_signature;
519         const struct ubus_signature *sig = type->signature;
520
521         s = blob_nest_start(&b, UBUS_ATTR_SIGNATURE);
522         while (rem) {
523                 if (sig->type != UBUS_SIGNATURE_METHOD)
524                         return false;
525
526                 m = blobmsg_open_table(&b, sig->name);
527
528                 sig++;
529                 rem--;
530                 if (!ubus_push_table_data(&sig, &rem, false))
531                         return false;
532
533                 blobmsg_close_table(&b, m);
534         }
535         blob_nest_end(&b, s);
536
537         return true;
538 }
539
540 int ubus_publish(struct ubus_context *ctx, struct ubus_object *obj)
541 {
542         struct ubus_request req;
543         int ret;
544
545         if (obj->id || !obj->name || !obj->type)
546                 return UBUS_STATUS_INVALID_ARGUMENT;
547
548         blob_buf_init(&b, 0);
549         blob_put_string(&b, UBUS_ATTR_OBJPATH, obj->name);
550
551         if (obj->type->id)
552                 blob_put_int32(&b, UBUS_ATTR_OBJTYPE, obj->type->id);
553         else if (!ubus_push_object_type(obj->type))
554                 return UBUS_STATUS_INVALID_ARGUMENT;
555
556         ubus_start_request(ctx, &req, b.head, UBUS_MSG_PUBLISH, 0);
557         req.raw_data_cb = ubus_publish_cb;
558         req.priv = obj;
559         ret = ubus_complete_request(ctx, &req);
560         if (ret)
561                 return ret;
562
563         if (!obj->id)
564                 return UBUS_STATUS_NO_DATA;
565
566         return 0;
567 }
568
569 void ubus_default_connection_lost(struct ubus_context *ctx)
570 {
571         if (ctx->sock.registered)
572                 uloop_end();
573 }
574
575 struct ubus_context *ubus_connect(const char *path)
576 {
577         struct ubus_context *ctx;
578         struct {
579                 struct ubus_msghdr hdr;
580                 struct blob_attr data;
581         } hdr;
582         struct blob_attr *buf;
583
584         if (!path)
585                 path = UBUS_UNIX_SOCKET;
586
587         ctx = calloc(1, sizeof(*ctx));
588         if (!ctx)
589                 goto error;
590
591         ctx->sock.fd = usock(USOCK_UNIX, path, NULL);
592         if (ctx->sock.fd < 0) {
593                 DPRINTF("Failed to connect to server\n");
594                 goto error_free;
595         }
596         ctx->sock.cb = ubus_handle_data;
597
598         if (read(ctx->sock.fd, &hdr, sizeof(hdr)) != sizeof(hdr)) {
599                 DPRINTF("Failed to read initial message data\n");
600                 goto error_close;
601         }
602
603         if (!ubus_validate_hdr(&hdr.hdr)) {
604                 DPRINTF("Failed to validate initial message header\n");
605                 goto error_close;
606         }
607
608         if (hdr.hdr.type != UBUS_MSG_HELLO) {
609                 DPRINTF("Unexpected initial message\n");
610                 goto error_close;
611         }
612
613         buf = calloc(1, blob_raw_len(&hdr.data));
614         if (!buf)
615                 goto error_close;
616
617         memcpy(buf, &hdr.data, sizeof(hdr.data));
618         if (read(ctx->sock.fd, blob_data(buf), blob_len(buf)) != blob_len(buf)) {
619                 DPRINTF("Failed to retrieve initial message data\n");
620                 goto error_free_buf;
621         }
622
623         ctx->local_id = hdr.hdr.peer;
624         free(buf);
625
626         ctx->connection_lost = ubus_default_connection_lost;
627
628         INIT_LIST_HEAD(&ctx->requests);
629         avl_init(&ctx->objects, ubus_cmp_id, false, NULL);
630
631         if (!ctx->local_id) {
632                 DPRINTF("Failed to get local peer id\n");
633                 goto error_close;
634         }
635
636         return ctx;
637
638 error_free_buf:
639         free(buf);
640 error_close:
641         close(ctx->sock.fd);
642 error_free:
643         free(ctx);
644 error:
645         return NULL;
646 }
647
648 void ubus_free(struct ubus_context *ctx)
649 {
650         close(ctx->sock.fd);
651         free(ctx);
652 }