X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fafb-stub-ws.c;h=f008c41871fc854b35a31bd059f1c4e61c116e6b;hb=034b0ab71f42b927c4e6ba88e552643258e95069;hp=8298fc7bdd9ca022b7cccb4f60107774137d37ac;hpb=968c3fca18c7518f240d2487a561e8df8b2907a7;p=src%2Fapp-framework-binder.git diff --git a/src/afb-stub-ws.c b/src/afb-stub-ws.c index 8298fc7b..f008c418 100644 --- a/src/afb-stub-ws.c +++ b/src/afb-stub-ws.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2015, 2016, 2017 "IoT.bzh" + * Copyright (C) 2015-2018 "IoT.bzh" * Author José Bollo * * Licensed under the Apache License, Version 2.0 (the "License"); @@ -17,8 +17,6 @@ #define _GNU_SOURCE -#define NO_PLUGIN_VERBOSE_MACRO - #include #include #include @@ -33,264 +31,124 @@ #include #include -#include - -#include -#include "afb-common.h" +#include #include "afb-session.h" #include "afb-cred.h" -#include "afb-ws.h" -#include "afb-msg-json.h" #include "afb-api.h" #include "afb-apiset.h" +#include "afb-proto-ws.h" #include "afb-stub-ws.h" #include "afb-context.h" #include "afb-evt.h" #include "afb-xreq.h" #include "verbose.h" +#include "fdev.h" +#include "jobs.h" -struct client_call; -struct client_event; struct afb_stub_ws; -/************** constants for protocol definition *************************/ - -#define CHAR_FOR_CALL 'C' -#define CHAR_FOR_ANSWER_SUCCESS 'T' -#define CHAR_FOR_ANSWER_FAIL 'F' -#define CHAR_FOR_EVT_BROADCAST '*' -#define CHAR_FOR_EVT_ADD '+' -#define CHAR_FOR_EVT_DEL '-' -#define CHAR_FOR_EVT_PUSH '!' -#define CHAR_FOR_EVT_SUBSCRIBE 'S' -#define CHAR_FOR_EVT_UNSUBSCRIBE 'U' -#define CHAR_FOR_SUBCALL_CALL 'B' -#define CHAR_FOR_SUBCALL_REPLY 'R' - -/******************* handling subcalls *****************************/ /** - * Structure on server side for recording pending - * subcalls. + * structure for a ws request: requests on server side */ -struct server_subcall -{ - struct server_subcall *next; /**< next subcall for the client */ - uint32_t subcallid; /**< the subcallid */ - void (*callback)(void*, int, struct json_object*); /**< callback on completion */ - void *closure; /**< closure of the callback */ +struct server_req { + struct afb_xreq xreq; /**< the xreq */ + struct afb_stub_ws *stubws; /**< the client of the request */ + struct afb_proto_ws_call *call; /**< the incoming call */ }; /** - * Structure for sending back replies on client side + * structure for recording events on client side */ -struct client_subcall +struct client_event { - struct afb_stub_ws *stubws; /**< stub descriptor */ - uint32_t subcallid; /**< subcallid for the reply */ + struct client_event *next; /**< link to the next */ + struct afb_event_x2 *event; /**< the local event */ + int id; /**< the identifier */ + int refcount; /**< a reference count */ }; -/* - * structure for recording calls on client side +/** + * structure for recording describe requests on the client side */ -struct client_call { - struct client_call *next; /* the next call */ - struct afb_stub_ws *stubws; /* the stub_ws */ - struct afb_xreq *xreq; /* the request handle */ - uint32_t msgid; /* the message identifier */ +struct client_describe +{ + struct afb_stub_ws *stubws; /**< the stub */ + struct jobloop *jobloop; /**< the jobloop to leave */ + struct json_object *result; /**< result */ }; -/* - * structure for a ws request +/** + * structure for jobs of describing */ -struct server_req { - struct afb_xreq xreq; /* the xreq */ - struct afb_stub_ws *stubws; /* the client of the request */ - uint32_t msgid; /* the incoming request msgid */ +struct server_describe +{ + struct afb_stub_ws *stubws; + struct afb_proto_ws_describe *describe; }; -/* - * structure for recording events on client side +/** + * structure for recording sessions */ -struct client_event +struct server_session { - struct client_event *next; - struct afb_event event; - int eventid; - int refcount; + struct server_session *next; + struct afb_session *session; }; -/******************* client description part for server *****************************/ +/******************* stub description for client or servers ******************/ struct afb_stub_ws { - /* count of references */ - int refcount; - - /* file descriptor */ - int fd; - - /* resource control */ - pthread_mutex_t mutex; - - /* websocket */ - struct afb_ws *ws; - - /* listener for events (server side) */ - struct afb_evt_listener *listener; - - /* event replica (client side) */ - struct client_event *events; - - /* emitted calls (client side) */ - struct client_call *calls; - - /* credentials (server side) */ - struct afb_cred *cred; - - /* pending subcalls (server side) */ - struct server_subcall *subcalls; + /* protocol */ + struct afb_proto_ws *proto; /* apiset */ struct afb_apiset *apiset; - /* the api name */ - char apiname[1]; -}; - -/******************* common useful tools **********************************/ - -/** - * translate a pointer to some integer - * @param ptr the pointer to translate - * @return an integer - */ -static inline uint32_t ptr2id(void *ptr) -{ - return (uint32_t)(((intptr_t)ptr) >> 6); -} - -/******************* serialisation part **********************************/ - -struct readbuf -{ - char *head, *end; -}; - -#define WRITEBUF_COUNT_MAX 32 -struct writebuf -{ - struct iovec iovec[WRITEBUF_COUNT_MAX]; - uint32_t uints[WRITEBUF_COUNT_MAX]; - int count; -}; - -static char *readbuf_get(struct readbuf *rb, uint32_t length) -{ - char *before = rb->head; - char *after = before + length; - if (after > rb->end) - return 0; - rb->head = after; - return before; -} + /* on hangup callback */ + void (*on_hangup)(struct afb_stub_ws *); -static int readbuf_char(struct readbuf *rb, char *value) -{ - if (rb->head >= rb->end) - return 0; - *value = *rb->head++; - return 1; -} + union { + /* server side */ + struct { + /* listener for events */ + struct afb_evt_listener *listener; -static int readbuf_uint32(struct readbuf *rb, uint32_t *value) -{ - char *after = rb->head + sizeof *value; - if (after > rb->end) - return 0; - memcpy(value, rb->head, sizeof *value); - rb->head = after; - *value = le32toh(*value); - return 1; -} + /* sessions */ + struct server_session *sessions; -static int readbuf_string(struct readbuf *rb, const char **value, size_t *length) -{ - uint32_t len; - if (!readbuf_uint32(rb, &len) || !len) - return 0; - if (length) - *length = (size_t)(len - 1); - return (*value = readbuf_get(rb, len)) != NULL && rb->head[-1] == 0; -} + /* credentials of the client */ + struct afb_cred *cred; + }; -static int readbuf_object(struct readbuf *rb, struct json_object **object) -{ - const char *string; - struct json_object *o; - int rc = readbuf_string(rb, &string, NULL); - if (rc) { - o = json_tokener_parse(string); - if (o == NULL && strcmp(string, "null")) - o = json_object_new_string(string); - *object = o; - } - return rc; -} + /* client side */ + struct { + /* event replica */ + struct client_event *events; -static int writebuf_put(struct writebuf *wb, const void *value, size_t length) -{ - int i = wb->count; - if (i == WRITEBUF_COUNT_MAX) - return 0; - wb->iovec[i].iov_base = (void*)value; - wb->iovec[i].iov_len = length; - wb->count = i + 1; - return 1; -} + /* robustify */ + struct { + struct fdev *(*reopen)(void*); + void *closure; + void (*release)(void*); + } robust; + }; + }; -static int writebuf_char(struct writebuf *wb, char value) -{ - int i = wb->count; - if (i == WRITEBUF_COUNT_MAX) - return 0; - *(char*)&wb->uints[i] = value; - wb->iovec[i].iov_base = &wb->uints[i]; - wb->iovec[i].iov_len = 1; - wb->count = i + 1; - return 1; -} + /* count of references */ + unsigned refcount; -static int writebuf_uint32(struct writebuf *wb, uint32_t value) -{ - int i = wb->count; - if (i == WRITEBUF_COUNT_MAX) - return 0; - wb->uints[i] = htole32(value); - wb->iovec[i].iov_base = &wb->uints[i]; - wb->iovec[i].iov_len = sizeof wb->uints[i]; - wb->count = i + 1; - return 1; -} + /* type of the stub: 0=server, 1=client */ + uint8_t is_client; -static int writebuf_string_length(struct writebuf *wb, const char *value, size_t length) -{ - uint32_t len = (uint32_t)++length; - return (size_t)len == length && len && writebuf_uint32(wb, len) && writebuf_put(wb, value, length); -} + /* the api name */ + char apiname[]; +}; -static int writebuf_string(struct writebuf *wb, const char *value) -{ - return writebuf_string_length(wb, value, strlen(value)); -} - -static int writebuf_object(struct writebuf *wb, struct json_object *object) -{ - const char *string = json_object_to_json_string_ext(object, JSON_C_TO_STRING_PLAIN); - return string != NULL && writebuf_string(wb, string); -} +static struct afb_proto_ws *afb_stub_ws_create_proto(struct afb_stub_ws *stubws, struct fdev *fdev, uint8_t server); /******************* ws request part for server *****************/ @@ -302,153 +160,70 @@ static void server_req_destroy_cb(struct afb_xreq *xreq) afb_context_disconnect(&wreq->xreq.context); afb_cred_unref(wreq->xreq.cred); json_object_put(wreq->xreq.json); + afb_proto_ws_call_unref(wreq->call); afb_stub_ws_unref(wreq->stubws); free(wreq); } -static void server_req_success_cb(struct afb_xreq *xreq, struct json_object *obj, const char *info) +static void server_req_reply_cb(struct afb_xreq *xreq, struct json_object *obj, const char *error, const char *info) { int rc; - struct writebuf wb = { .count = 0 }; struct server_req *wreq = CONTAINER_OF_XREQ(struct server_req, xreq); - if (writebuf_char(&wb, CHAR_FOR_ANSWER_SUCCESS) - && writebuf_uint32(&wb, wreq->msgid) - && writebuf_uint32(&wb, (uint32_t)wreq->xreq.context.flags) - && writebuf_string(&wb, info ? : "") - && writebuf_object(&wb, obj)) { - rc = afb_ws_binary_v(wreq->stubws->ws, wb.iovec, wb.count); - if (rc >= 0) - goto success; - } - ERROR("error while sending success"); -success: + rc = afb_proto_ws_call_reply(wreq->call, obj, error, info); + if (rc < 0) + ERROR("error while sending reply"); json_object_put(obj); } -static void server_req_fail_cb(struct afb_xreq *xreq, const char *status, const char *info) -{ - int rc; - struct writebuf wb = { .count = 0 }; - struct server_req *wreq = CONTAINER_OF_XREQ(struct server_req, xreq); - - if (writebuf_char(&wb, CHAR_FOR_ANSWER_FAIL) - && writebuf_uint32(&wb, wreq->msgid) - && writebuf_uint32(&wb, (uint32_t)wreq->xreq.context.flags) - && writebuf_string(&wb, status) - && writebuf_string(&wb, info ? : "")) { - rc = afb_ws_binary_v(wreq->stubws->ws, wb.iovec, wb.count); - if (rc >= 0) - return; - } - ERROR("error while sending fail"); -} - -static void server_req_subcall_cb(struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args, void (*callback)(void*, int, struct json_object*), void *cb_closure) +static int server_req_subscribe_cb(struct afb_xreq *xreq, struct afb_event_x2 *event) { int rc; - struct writebuf wb = { .count = 0 }; - struct server_subcall *sc, *osc; - struct server_req *wreq = CONTAINER_OF_XREQ(struct server_req, xreq); - struct afb_stub_ws *stubws = wreq->stubws; - - sc = malloc(sizeof *sc); - if (!sc) { - - } else { - sc->callback = callback; - sc->closure = cb_closure; - - pthread_mutex_unlock(&stubws->mutex); - sc->subcallid = ptr2id(sc); - do { - sc->subcallid++; - osc = stubws->subcalls; - while(osc && osc->subcallid != sc->subcallid) - osc = osc->next; - } while (osc); - sc->next = stubws->subcalls; - stubws->subcalls = sc; - pthread_mutex_unlock(&stubws->mutex); - - if (writebuf_char(&wb, CHAR_FOR_SUBCALL_CALL) - && writebuf_uint32(&wb, wreq->msgid) - && writebuf_uint32(&wb, sc->subcallid) - && writebuf_string(&wb, api) - && writebuf_string(&wb, verb) - && writebuf_object(&wb, args)) { - rc = afb_ws_binary_v(wreq->stubws->ws, wb.iovec, wb.count); - if (rc >= 0) - return; - } - ERROR("error while sending fail"); - } -} - -static int server_req_subscribe_cb(struct afb_xreq *xreq, struct afb_event event) -{ - int rc, rc2; - struct writebuf wb = { .count = 0 }; struct server_req *wreq = CONTAINER_OF_XREQ(struct server_req, xreq); - rc = afb_evt_add_watch(wreq->stubws->listener, event); + rc = afb_evt_event_x2_add_watch(wreq->stubws->listener, event); + if (rc >= 0) + rc = afb_proto_ws_call_subscribe(wreq->call, afb_evt_event_x2_fullname(event), afb_evt_event_x2_id(event)); if (rc < 0) - return rc; - - if (writebuf_char(&wb, CHAR_FOR_EVT_SUBSCRIBE) - && writebuf_uint32(&wb, wreq->msgid) - && writebuf_uint32(&wb, (uint32_t)afb_evt_event_id(event)) - && writebuf_string(&wb, afb_evt_event_name(event))) { - rc2 = afb_ws_binary_v(wreq->stubws->ws, wb.iovec, wb.count); - if (rc2 >= 0) - goto success; - } - ERROR("error while subscribing event"); -success: + ERROR("error while subscribing event"); return rc; } -static int server_req_unsubscribe_cb(struct afb_xreq *xreq, struct afb_event event) +static int server_req_unsubscribe_cb(struct afb_xreq *xreq, struct afb_event_x2 *event) { int rc, rc2; - struct writebuf wb = { .count = 0 }; struct server_req *wreq = CONTAINER_OF_XREQ(struct server_req, xreq); - if (writebuf_char(&wb, CHAR_FOR_EVT_UNSUBSCRIBE) - && writebuf_uint32(&wb, wreq->msgid) - && writebuf_uint32(&wb, (uint32_t)afb_evt_event_id(event)) - && writebuf_string(&wb, afb_evt_event_name(event))) { - rc2 = afb_ws_binary_v(wreq->stubws->ws, wb.iovec, wb.count); - if (rc2 >= 0) - goto success; - } - ERROR("error while subscribing event"); -success: - rc = afb_evt_remove_watch(wreq->stubws->listener, event); + rc = afb_proto_ws_call_unsubscribe(wreq->call, afb_evt_event_x2_fullname(event), afb_evt_event_x2_id(event)); + rc2 = afb_evt_event_x2_remove_watch(wreq->stubws->listener, event); + if (rc >= 0 && rc2 < 0) + rc = rc2; + if (rc < 0) + ERROR("error while unsubscribing event"); return rc; } static const struct afb_xreq_query_itf server_req_xreq_itf = { - .success = server_req_success_cb, - .fail = server_req_fail_cb, + .reply = server_req_reply_cb, .unref = server_req_destroy_cb, - .subcall = server_req_subcall_cb, .subscribe = server_req_subscribe_cb, .unsubscribe = server_req_unsubscribe_cb }; /******************* client part **********************************/ -/* search a memorized call */ -static struct client_call *client_call_search(struct afb_stub_ws *stubws, uint32_t msgid) +/* destroy all events */ +static void client_drop_all_events(struct afb_stub_ws *stubws) { - struct client_call *call; - - call = stubws->calls; - while (call != NULL && call->msgid != msgid) - call = call->next; + struct client_event *ev, *nxt; - return call; + nxt = __atomic_exchange_n(&stubws->events, NULL, __ATOMIC_RELAXED); + while (nxt) { + ev = nxt; + nxt = ev->next; + afb_evt_event_x2_unref(ev->event); + free(ev); + } } /* search the event */ @@ -457,155 +232,175 @@ static struct client_event *client_event_search(struct afb_stub_ws *stubws, uint struct client_event *ev; ev = stubws->events; - while (ev != NULL && (ev->eventid != eventid || 0 != strcmp(afb_evt_event_name(ev->event), name))) + while (ev != NULL && (ev->id != eventid || 0 != strcmp(afb_evt_event_x2_fullname(ev->event), name))) ev = ev->next; + DEBUG("searching event %s[%d]: %s", name, eventid, ev ? "found" : "not found"); return ev; } - -/* allocates and init the memorizing call */ -static struct client_call *client_call_make(struct afb_stub_ws *stubws, struct afb_xreq *xreq) +static struct afb_proto_ws *client_get_proto(struct afb_stub_ws *stubws) { - struct client_call *call; - - call = malloc(sizeof *call); - if (call != NULL) { - afb_xreq_addref(xreq); - call->xreq = xreq; - call->msgid = ptr2id(call); - while(client_call_search(stubws, call->msgid) != NULL) - call->msgid++; - call->stubws = stubws; - call->next = stubws->calls; - stubws->calls = call; + struct fdev *fdev; + struct afb_proto_ws *proto; + + proto = stubws->proto; + if (proto == NULL && stubws->robust.reopen) { + fdev = stubws->robust.reopen(stubws->robust.closure); + if (fdev != NULL) + proto = afb_stub_ws_create_proto(stubws, fdev, 0); } - return call; + return proto; } -/* free and release the memorizing call */ -static void client_call_destroy(struct client_call *call) +/* on call, propagate it to the ws service */ +static void client_api_call_cb(void * closure, struct afb_xreq *xreq) { - struct client_call **prv; + int rc; + struct afb_stub_ws *stubws = closure; + struct afb_proto_ws *proto; - prv = &call->stubws->calls; - while (*prv != NULL) { - if (*prv == call) { - *prv = call->next; - break; - } - prv = &(*prv)->next; + proto = client_get_proto(stubws); + if (proto == NULL) { + afb_xreq_reply(xreq, NULL, "disconnected", "server hung up"); + return; } - afb_xreq_unref(call->xreq); - free(call); + afb_xreq_unhooked_addref(xreq); + rc = afb_proto_ws_client_call( + proto, + xreq->request.called_verb, + afb_xreq_json(xreq), + afb_session_uuid(xreq->context.session), + xreq, + xreq_on_behalf_cred_export(xreq)); + if (rc < 0) { + afb_xreq_reply(xreq, NULL, "internal", "can't send message"); + afb_xreq_unhooked_unref(xreq); + } } -/* get event data from the message */ -static int client_msg_event_read(struct readbuf *rb, uint32_t *eventid, const char **name) +static void client_on_description_cb(void *closure, struct json_object *data) { - return readbuf_uint32(rb, eventid) && readbuf_string(rb, name, NULL); + struct client_describe *desc = closure; + + desc->result = data; + jobs_leave(desc->jobloop); } -/* get event from the message */ -static int client_msg_event_get(struct afb_stub_ws *stubws, struct readbuf *rb, struct client_event **ev) +static void client_send_describe_cb(int signum, void *closure, struct jobloop *jobloop) { - const char *name; - uint32_t eventid; + struct client_describe *desc = closure; + struct afb_proto_ws *proto; - /* get event data from the message */ - if (!client_msg_event_read(rb, &eventid, &name)) { - ERROR("Invalid message"); - return 0; + proto = client_get_proto(desc->stubws); + if (signum || proto == NULL) + jobs_leave(jobloop); + else { + desc->jobloop = jobloop; + afb_proto_ws_client_describe(proto, client_on_description_cb, desc); } +} - /* check conflicts */ - *ev = client_event_search(stubws, eventid, name); - if (*ev == NULL) { - ERROR("event %s not found", name); - return 0; - } +/* get the description */ +static struct json_object *client_api_describe_cb(void * closure) +{ + struct client_describe desc; - return 1; + /* synchronous job: send the request and wait its result */ + desc.stubws = closure; + desc.result = NULL; + jobs_enter(NULL, 0, client_send_describe_cb, &desc); + return desc.result; } -/* get event from the message */ -static int client_msg_call_get(struct afb_stub_ws *stubws, struct readbuf *rb, struct client_call **call) +/******************* server part: manage events **********************************/ + +static void server_event_add_cb(void *closure, const char *event, int eventid) { - uint32_t msgid; + struct afb_stub_ws *stubws = closure; - /* get event data from the message */ - if (!readbuf_uint32(rb, &msgid)) { - ERROR("Invalid message"); - return 0; - } + if (stubws->proto != NULL) + afb_proto_ws_server_event_create(stubws->proto, event, eventid); +} - /* get the call */ - *call = client_call_search(stubws, msgid); - if (*call == NULL) { - ERROR("message not found"); - return 0; - } +static void server_event_remove_cb(void *closure, const char *event, int eventid) +{ + struct afb_stub_ws *stubws = closure; - return 1; + if (stubws->proto != NULL) + afb_proto_ws_server_event_remove(stubws->proto, event, eventid); } -/* read a subscrition message */ -static int client_msg_subscription_get(struct afb_stub_ws *stubws, struct readbuf *rb, struct client_call **call, struct client_event **ev) +static void server_event_push_cb(void *closure, const char *event, int eventid, struct json_object *object) { - return client_msg_call_get(stubws, rb, call) && client_msg_event_get(stubws, rb, ev); + struct afb_stub_ws *stubws = closure; + + if (stubws->proto != NULL) + afb_proto_ws_server_event_push(stubws->proto, event, eventid, object); + json_object_put(object); } -/* adds an event */ -static void client_event_create(struct afb_stub_ws *stubws, struct readbuf *rb) +static void server_event_broadcast_cb(void *closure, const char *event, int eventid, struct json_object *object) { - size_t offset; - const char *name; - uint32_t eventid; - struct client_event *ev; + struct afb_stub_ws *stubws = closure; - /* get event data from the message */ - offset = client_msg_event_read(rb, &eventid, &name); - if (offset == 0) { - ERROR("Invalid message"); - return; - } + if (stubws->proto != NULL) + afb_proto_ws_server_event_broadcast(stubws->proto, event, object); + json_object_put(object); +} + +/*****************************************************/ + +static void client_on_reply_cb(void *closure, void *request, struct json_object *object, const char *error, const char *info) +{ + struct afb_xreq *xreq = request; + + afb_xreq_reply(xreq, object, error, info); + afb_xreq_unhooked_unref(xreq); +} + +static void client_on_event_create_cb(void *closure, const char *event_name, int event_id) +{ + struct afb_stub_ws *stubws = closure; + struct client_event *ev; /* check conflicts */ - ev = client_event_search(stubws, eventid, name); + ev = client_event_search(stubws, event_id, event_name); if (ev != NULL) { - ev->refcount++; + __atomic_add_fetch(&ev->refcount, 1, __ATOMIC_RELAXED); return; } /* no conflict, try to add it */ ev = malloc(sizeof *ev); if (ev != NULL) { - ev->event = afb_evt_create_event(name); - if (ev->event.closure == NULL) - free(ev); - else { + ev->event = afb_evt_event_x2_create(event_name); + if (ev->event != NULL) { ev->refcount = 1; - ev->eventid = eventid; + ev->id = event_id; ev->next = stubws->events; stubws->events = ev; return; } + free(ev); } - ERROR("can't create event %s, out of memory", name); + ERROR("can't create event %s, out of memory", event_name); } -/* removes an event */ -static void client_event_drop(struct afb_stub_ws *stubws, struct readbuf *rb) +static void client_on_event_remove_cb(void *closure, const char *event_name, int event_id) { + struct afb_stub_ws *stubws = closure; struct client_event *ev, **prv; - /* retrieves the event */ - if (!client_msg_event_get(stubws, rb, &ev)) + /* check conflicts */ + ev = client_event_search(stubws, event_id, event_name); + if (ev == NULL) return; /* decrease the reference count */ - if (--ev->refcount) + + if (__atomic_sub_fetch(&ev->refcount, 1, __ATOMIC_RELAXED)) return; /* unlinks the event */ @@ -615,515 +410,299 @@ static void client_event_drop(struct afb_stub_ws *stubws, struct readbuf *rb) *prv = ev->next; /* destroys the event */ - afb_event_drop(ev->event); + afb_evt_event_x2_unref(ev->event); free(ev); } -/* subscribes an event */ -static void client_event_subscribe(struct afb_stub_ws *stubws, struct readbuf *rb) +static void client_on_event_subscribe_cb(void *closure, void *request, const char *event_name, int event_id) { + struct afb_stub_ws *stubws = closure; + struct afb_xreq *xreq = request; struct client_event *ev; - struct client_call *call; - if (client_msg_subscription_get(stubws, rb, &call, &ev)) { - /* subscribe the request from the event */ - if (afb_xreq_subscribe(call->xreq, ev->event) < 0) - ERROR("can't subscribe: %m"); - } + /* check conflicts */ + ev = client_event_search(stubws, event_id, event_name); + if (ev == NULL) + return; + + if (afb_xreq_subscribe(xreq, ev->event) < 0) + ERROR("can't subscribe: %m"); } -/* unsubscribes an event */ -static void client_event_unsubscribe(struct afb_stub_ws *stubws, struct readbuf *rb) +static void client_on_event_unsubscribe_cb(void *closure, void *request, const char *event_name, int event_id) { + struct afb_stub_ws *stubws = closure; + struct afb_xreq *xreq = request; struct client_event *ev; - struct client_call *call; - if (client_msg_subscription_get(stubws, rb, &call, &ev)) { - /* unsubscribe the request from the event */ - if (afb_xreq_unsubscribe(call->xreq, ev->event) < 0) - ERROR("can't unsubscribe: %m"); - } -} - -/* receives broadcasted events */ -static void client_event_broadcast(struct afb_stub_ws *stubws, struct readbuf *rb) -{ - struct json_object *object; - const char *event; + /* check conflicts */ + ev = client_event_search(stubws, event_id, event_name); + if (ev == NULL) + return; - if (readbuf_string(rb, &event, NULL) && readbuf_object(rb, &object)) - afb_evt_broadcast(event, object); - else - ERROR("unreadable broadcasted event"); + if (afb_xreq_unsubscribe(xreq, ev->event) < 0) + ERROR("can't unsubscribe: %m"); } -/* pushs an event */ -static void client_event_push(struct afb_stub_ws *stubws, struct readbuf *rb) +static void client_on_event_push_cb(void *closure, const char *event_name, int event_id, struct json_object *data) { + struct afb_stub_ws *stubws = closure; struct client_event *ev; - struct json_object *object; - if (client_msg_event_get(stubws, rb, &ev) && readbuf_object(rb, &object)) - afb_event_push(ev->event, object); + /* check conflicts */ + ev = client_event_search(stubws, event_id, event_name); + if (ev) + afb_evt_event_x2_push(ev->event, data); else ERROR("unreadable push event"); } -static void client_reply_success(struct afb_stub_ws *stubws, struct readbuf *rb) -{ - struct client_call *call; - struct json_object *object; - const char *info; - uint32_t flags; - - /* retrieve the message data */ - if (!client_msg_call_get(stubws, rb, &call)) - return; - - if (readbuf_uint32(rb, &flags) - && readbuf_string(rb, &info, NULL) - && readbuf_object(rb, &object)) { - call->xreq->context.flags = (unsigned)flags; - afb_xreq_success(call->xreq, object, *info ? info : NULL); - } else { - /* failing to have the answer */ - afb_xreq_fail(call->xreq, "error", "ws error"); - } - client_call_destroy(call); -} - -static void client_reply_fail(struct afb_stub_ws *stubws, struct readbuf *rb) -{ - struct client_call *call; - const char *info, *status; - uint32_t flags; - - /* retrieve the message data */ - if (!client_msg_call_get(stubws, rb, &call)) - return; - - if (readbuf_uint32(rb, &flags) - && readbuf_string(rb, &status, NULL) - && readbuf_string(rb, &info, NULL)) { - call->xreq->context.flags = (unsigned)flags; - afb_xreq_fail(call->xreq, status, *info ? info : NULL); - } else { - /* failing to have the answer */ - afb_xreq_fail(call->xreq, "error", "ws error"); - } - client_call_destroy(call); -} - -/* send a subcall reply */ -static void client_send_subcall_reply(struct client_subcall *subcall, int iserror, json_object *object) +static void client_on_event_broadcast_cb(void *closure, const char *event_name, struct json_object *data) { - int rc; - struct writebuf wb = { .count = 0 }; - char ie = (char)!!iserror; - - if (!writebuf_char(&wb, CHAR_FOR_SUBCALL_REPLY) - || !writebuf_uint32(&wb, subcall->subcallid) - || !writebuf_char(&wb, ie) - || !writebuf_object(&wb, object)) { - /* write error ? */ - return; - } - - rc = afb_ws_binary_v(subcall->stubws->ws, wb.iovec, wb.count); - if (rc >= 0) - return; - ERROR("error while sending subcall reply"); + afb_evt_broadcast(event_name, data); } -/* callback for subcall reply */ -static void client_subcall_reply_cb(void *closure, int iserror, json_object *object) -{ - client_send_subcall_reply(closure, iserror, object); - free(closure); -} +/*****************************************************/ -/* received a subcall request */ -static void client_subcall(struct afb_stub_ws *stubws, struct readbuf *rb) +static void server_record_session(struct afb_stub_ws *stubws, struct afb_session *session) { - struct client_subcall *subcall; - struct client_call *call; - const char *api, *verb; - uint32_t subcallid; - struct json_object *object; - - subcall = malloc(sizeof *subcall); - if (!subcall) - return; + struct server_session *s, **prv; - /* retrieve the message data */ - if (!client_msg_call_get(stubws, rb, &call)) - return; - - if (readbuf_uint32(rb, &subcallid) - && readbuf_string(rb, &api, NULL) - && readbuf_string(rb, &verb, NULL) - && readbuf_object(rb, &object)) { - subcall->stubws = stubws; - subcall->subcallid = subcallid; - afb_xreq_subcall(call->xreq, api, verb, object, client_subcall_reply_cb, subcall); + /* search */ + prv = &stubws->sessions; + while ((s = *prv)) { + if (s->session == session) + return; + if (afb_session_is_closed(s->session)) { + *prv = s->next; + afb_session_unref(s->session); + free(s); + } + else + prv = &s->next; } -} -/* callback when receiving binary data */ -static void client_on_binary(void *closure, char *data, size_t size) -{ - if (size > 0) { - struct afb_stub_ws *stubws = closure; - struct readbuf rb = { .head = data, .end = data + size }; - - pthread_mutex_lock(&stubws->mutex); - switch (*rb.head++) { - case CHAR_FOR_ANSWER_SUCCESS: /* success */ - client_reply_success(stubws, &rb); - break; - case CHAR_FOR_ANSWER_FAIL: /* fail */ - client_reply_fail(stubws, &rb); - break; - case CHAR_FOR_EVT_BROADCAST: /* broadcast */ - client_event_broadcast(stubws, &rb); - break; - case CHAR_FOR_EVT_ADD: /* creates the event */ - client_event_create(stubws, &rb); - break; - case CHAR_FOR_EVT_DEL: /* drops the event */ - client_event_drop(stubws, &rb); - break; - case CHAR_FOR_EVT_PUSH: /* pushs the event */ - client_event_push(stubws, &rb); - break; - case CHAR_FOR_EVT_SUBSCRIBE: /* subscribe event for a request */ - client_event_subscribe(stubws, &rb); - break; - case CHAR_FOR_EVT_UNSUBSCRIBE: /* unsubscribe event for a request */ - client_event_unsubscribe(stubws, &rb); - break; - case CHAR_FOR_SUBCALL_CALL: /* subcall */ - client_subcall(stubws, &rb); - break; - default: /* unexpected message */ - /* TODO: close the connection */ - break; - } - pthread_mutex_unlock(&stubws->mutex); + /* create */ + s = malloc(sizeof *s); + if (s) { + s->session = afb_session_addref(session); + s->next = stubws->sessions; + stubws->sessions = s; } - free(data); } -/* on call, propagate it to the ws service */ -static void client_call_cb(void * closure, struct afb_xreq *xreq) +static void server_release_all_sessions(struct afb_stub_ws *stubws) { - int rc; - struct client_call *call; - struct writebuf wb = { .count = 0 }; - const char *raw; - size_t szraw; - struct afb_stub_ws *stubws = closure; + struct server_session *ses, *nses; - pthread_mutex_lock(&stubws->mutex); - - /* create the recording data */ - call = client_call_make(stubws, xreq); - if (call == NULL) { - afb_xreq_fail_f(xreq, "error", "out of memory"); - goto end; + nses = __atomic_exchange_n(&stubws->sessions, NULL, __ATOMIC_RELAXED); + while(nses) { + ses = nses; + nses = ses->next; + afb_session_unref(ses->session); + free(ses); } - - /* creates the call message */ - raw = afb_xreq_raw(xreq, &szraw); - if (raw == NULL) - goto internal_error; - if (!writebuf_char(&wb, CHAR_FOR_CALL) - || !writebuf_uint32(&wb, call->msgid) - || !writebuf_uint32(&wb, (uint32_t)xreq->context.flags) - || !writebuf_string(&wb, xreq->verb) - || !writebuf_string(&wb, afb_session_uuid(xreq->context.session)) - || !writebuf_string_length(&wb, raw, szraw)) - goto overflow; - - /* send */ - rc = afb_ws_binary_v(stubws->ws, wb.iovec, wb.count); - if (rc >= 0) - goto end; - - afb_xreq_fail(xreq, "error", "websocket sending error"); - goto clean_call; - -internal_error: - afb_xreq_fail(xreq, "error", "internal: raw is NULL!"); - goto clean_call; - -overflow: - afb_xreq_fail(xreq, "error", "overflow: size doesn't match 32 bits!"); - -clean_call: - client_call_destroy(call); -end: - pthread_mutex_unlock(&stubws->mutex); } -/******************* client description part for server *****************************/ +/*****************************************************/ -/* on call, propagate it to the ws service */ -static void server_on_call(struct afb_stub_ws *stubws, struct readbuf *rb) +static void server_on_call_cb(void *closure, struct afb_proto_ws_call *call, const char *verb, struct json_object *args, const char *sessionid, const char *user_creds) { + struct afb_stub_ws *stubws = closure; struct server_req *wreq; - char *cverb; - const char *uuid, *verb; - uint32_t flags, msgid; - size_t lenverb; - struct json_object *object; afb_stub_ws_addref(stubws); - /* reads the call message data */ - if (!readbuf_uint32(rb, &msgid) - || !readbuf_uint32(rb, &flags) - || !readbuf_string(rb, &verb, &lenverb) - || !readbuf_string(rb, &uuid, NULL) - || !readbuf_object(rb, &object)) - goto overflow; - /* create the request */ - wreq = malloc(++lenverb + sizeof *wreq); + wreq = malloc(sizeof *wreq); if (wreq == NULL) goto out_of_memory; afb_xreq_init(&wreq->xreq, &server_req_xreq_itf); wreq->stubws = stubws; - wreq->msgid = msgid; - cverb = (char*)&wreq[1]; - memcpy(cverb, verb, lenverb); + wreq->call = call; /* init the context */ - if (afb_context_connect(&wreq->xreq.context, uuid, NULL) < 0) + if (afb_context_connect(&wreq->xreq.context, sessionid, NULL) < 0) goto unconnected; - wreq->xreq.context.flags = flags; + wreq->xreq.context.validated = 1; + server_record_session(stubws, wreq->xreq.context.session); + if (wreq->xreq.context.created) + afb_session_set_autoclose(wreq->xreq.context.session, 1); /* makes the call */ - wreq->xreq.cred = afb_cred_addref(stubws->cred); - wreq->xreq.api = stubws->apiname; - wreq->xreq.verb = cverb; - wreq->xreq.json = object; + wreq->xreq.cred = afb_cred_mixed_on_behalf_import(stubws->cred, sessionid, user_creds); + wreq->xreq.request.called_api = stubws->apiname; + wreq->xreq.request.called_verb = verb; + wreq->xreq.json = args; afb_xreq_process(&wreq->xreq, stubws->apiset); return; unconnected: free(wreq); out_of_memory: - json_object_put(object); -overflow: + json_object_put(args); afb_stub_ws_unref(stubws); + afb_proto_ws_call_reply(call, NULL, "internal-error", NULL); + afb_proto_ws_call_unref(call); } -/* on subcall reply */ -static void server_on_subcall_reply(struct afb_stub_ws *stubws, struct readbuf *rb) +static void server_describe_cb(int signum, void *closure) { - char iserror; - uint32_t subcallid; - struct json_object *object; - struct server_subcall *sc, **psc; - - /* reads the call message data */ - if (!readbuf_uint32(rb, &subcallid) - || !readbuf_char(rb, &iserror) - || !readbuf_object(rb, &object)) { - /* TODO bad protocol */ - return; - } + struct json_object *obj; + struct server_describe *desc = closure; - /* search the subcall and unlink it */ - pthread_mutex_lock(&stubws->mutex); - psc = &stubws->subcalls; - while ((sc = *psc) && sc->subcallid != subcallid) - psc = &sc->next; - if (!sc) { - pthread_mutex_unlock(&stubws->mutex); - /* TODO subcall not found */ - } else { - *psc = sc->next; - pthread_mutex_unlock(&stubws->mutex); - sc->callback(sc->closure, (int)iserror, object); - free(sc); - } - json_object_put(object); -} + /* get the description if possible */ + obj = !signum ? afb_apiset_describe(desc->stubws->apiset, desc->stubws->apiname) : NULL; -/* callback when receiving binary data */ -static void server_on_binary(void *closure, char *data, size_t size) -{ - if (size > 0) { - struct readbuf rb = { .head = data, .end = data + size }; - switch (*rb.head++) { - case CHAR_FOR_CALL: - server_on_call(closure, &rb); - break; - case CHAR_FOR_SUBCALL_REPLY: - server_on_subcall_reply(closure, &rb); - break; - default: /* unexpected message */ - /* TODO: close the connection */ - break; - } - } - free(data); + /* send it */ + afb_proto_ws_describe_put(desc->describe, obj); + json_object_put(obj); + afb_stub_ws_unref(desc->stubws); } -/******************* server part: manage events **********************************/ - -static void server_event_send(struct afb_stub_ws *stubws, char order, const char *event, int eventid, const char *data) +static void server_describe_job(int signum, void *closure) { - int rc; - struct writebuf wb = { .count = 0 }; - - if (writebuf_char(&wb, order) - && writebuf_uint32(&wb, eventid) - && writebuf_string(&wb, event) - && (data == NULL || writebuf_string(&wb, data))) { - rc = afb_ws_binary_v(stubws->ws, wb.iovec, wb.count); - if (rc >= 0) - return; - } - ERROR("error while sending %c for event %s", order, event); + server_describe_cb(signum, closure); + free(closure); } -static void server_event_add(void *closure, const char *event, int eventid) +static void server_on_describe_cb(void *closure, struct afb_proto_ws_describe *describe) { - server_event_send(closure, CHAR_FOR_EVT_ADD, event, eventid, NULL); -} + struct server_describe *desc, sdesc; + struct afb_stub_ws *stubws = closure; -static void server_event_remove(void *closure, const char *event, int eventid) -{ - server_event_send(closure, CHAR_FOR_EVT_DEL, event, eventid, NULL); + /* allocate (if possible) and init */ + desc = malloc(sizeof *desc); + if (desc == NULL) + desc = &sdesc; + desc->stubws = stubws; + desc->describe = describe; + afb_stub_ws_addref(stubws); + + /* process */ + if (desc == &sdesc || jobs_queue(NULL, 0, server_describe_job, desc) < 0) + jobs_call(NULL, 0, server_describe_cb, desc); } -static void server_event_push(void *closure, const char *event, int eventid, struct json_object *object) +/*****************************************************/ + +static const struct afb_proto_ws_client_itf client_itf = { - const char *data = json_object_to_json_string_ext(object, JSON_C_TO_STRING_PLAIN); - server_event_send(closure, CHAR_FOR_EVT_PUSH, event, eventid, data ? : "null"); - json_object_put(object); -} + .on_reply = client_on_reply_cb, + .on_event_create = client_on_event_create_cb, + .on_event_remove = client_on_event_remove_cb, + .on_event_subscribe = client_on_event_subscribe_cb, + .on_event_unsubscribe = client_on_event_unsubscribe_cb, + .on_event_push = client_on_event_push_cb, + .on_event_broadcast = client_on_event_broadcast_cb, +}; -static void server_event_broadcast(void *closure, const char *event, int eventid, struct json_object *object) +static struct afb_api_itf client_api_itf = { + .call = client_api_call_cb, + .describe = client_api_describe_cb +}; + +static const struct afb_proto_ws_server_itf server_itf = { - int rc; - struct afb_stub_ws *stubws = closure; + .on_call = server_on_call_cb, + .on_describe = server_on_describe_cb +}; - struct writebuf wb = { .count = 0 }; +/* the interface for events pushing */ +static const struct afb_evt_itf server_event_itf = { + .broadcast = server_event_broadcast_cb, + .push = server_event_push_cb, + .add = server_event_add_cb, + .remove = server_event_remove_cb +}; - if (writebuf_char(&wb, CHAR_FOR_EVT_BROADCAST) && writebuf_string(&wb, event) && writebuf_object(&wb, object)) { - rc = afb_ws_binary_v(stubws->ws, wb.iovec, wb.count); - if (rc < 0) - ERROR("error while broadcasting event %s", event); - } else - ERROR("error while broadcasting event %s", event); - json_object_put(object); +/*****************************************************/ + +/* disconnect */ +static void disconnect(struct afb_stub_ws *stubws) +{ + afb_proto_ws_unref(__atomic_exchange_n(&stubws->proto, NULL, __ATOMIC_RELAXED)); + if (stubws->is_client) + client_drop_all_events(stubws); + else { + afb_evt_listener_unref(__atomic_exchange_n(&stubws->listener, NULL, __ATOMIC_RELAXED)); + afb_cred_unref(__atomic_exchange_n(&stubws->cred, NULL, __ATOMIC_RELAXED)); + server_release_all_sessions(stubws); + } } -/*****************************************************/ /* callback when receiving a hangup */ -static void server_on_hangup(void *closure) +static void on_hangup(void *closure) { struct afb_stub_ws *stubws = closure; - /* close the socket */ - if (stubws->fd >= 0) { - close(stubws->fd); - stubws->fd = -1; + if (stubws->proto) { + afb_stub_ws_addref(stubws); + disconnect(stubws); + if (stubws->on_hangup) + stubws->on_hangup(stubws); + afb_stub_ws_unref(stubws); } +} - /* release the client */ - afb_stub_ws_unref(stubws); +static int enqueue_processing(struct afb_proto_ws *proto, void (*callback)(int signum, void* arg), void *arg) +{ + return jobs_queue(proto, 0, callback, arg); } /*****************************************************/ -/* the interface for events pushing */ -static const struct afb_evt_itf server_evt_itf = { - .broadcast = server_event_broadcast, - .push = server_event_push, - .add = server_event_add, - .remove = server_event_remove -}; - -static const struct afb_ws_itf stub_ws_client_ws_itf = +static struct afb_proto_ws *afb_stub_ws_create_proto(struct afb_stub_ws *stubws, struct fdev *fdev, uint8_t is_client) { - .on_close = NULL, - .on_text = NULL, - .on_binary = client_on_binary, - .on_error = NULL, - .on_hangup = NULL -}; + struct afb_proto_ws *proto; -static const struct afb_ws_itf server_ws_itf = -{ - .on_close = NULL, - .on_text = NULL, - .on_binary = server_on_binary, - .on_error = NULL, - .on_hangup = server_on_hangup -}; - -static struct afb_api_itf ws_api_itf = { - .call = client_call_cb -}; + stubws->proto = proto = is_client + ? afb_proto_ws_create_client(fdev, &client_itf, stubws) + : afb_proto_ws_create_server(fdev, &server_itf, stubws); + if (proto) { + afb_proto_ws_on_hangup(proto, on_hangup); + afb_proto_ws_set_queuing(proto, enqueue_processing); + } -/*****************************************************/ + return proto; +} -static struct afb_stub_ws *afb_stub_ws_create(int fd, const char *apiname, struct afb_apiset *apiset, const struct afb_ws_itf *itf) +static struct afb_stub_ws *afb_stub_ws_create(struct fdev *fdev, const char *apiname, struct afb_apiset *apiset, uint8_t is_client) { struct afb_stub_ws *stubws; - stubws = calloc(1, sizeof *stubws + strlen(apiname)); + stubws = calloc(1, sizeof *stubws + 1 + strlen(apiname)); if (stubws == NULL) errno = ENOMEM; else { - fcntl(fd, F_SETFD, FD_CLOEXEC); - fcntl(fd, F_SETFL, O_NONBLOCK); - stubws->ws = afb_ws_create(afb_common_get_event_loop(), fd, itf, stubws); - if (stubws->ws != NULL) { - stubws->fd = fd; + if (afb_stub_ws_create_proto(stubws, fdev, is_client)) { + stubws->refcount = 1; + stubws->is_client = is_client; strcpy(stubws->apiname, apiname); stubws->apiset = afb_apiset_addref(apiset); - stubws->refcount = 1; - stubws->subcalls = NULL; return stubws; } free(stubws); } + fdev_unref(fdev); return NULL; } -struct afb_stub_ws *afb_stub_ws_create_client(int fd, const char *apiname, struct afb_apiset *apiset) +struct afb_stub_ws *afb_stub_ws_create_client(struct fdev *fdev, const char *apiname, struct afb_apiset *apiset) { - struct afb_api afb_api; - struct afb_stub_ws *stubws; - - stubws = afb_stub_ws_create(fd, apiname, apiset, &stub_ws_client_ws_itf); - if (stubws) { - afb_api.closure = stubws; - afb_api.itf = &ws_api_itf; - if (afb_apiset_add(apiset, stubws->apiname, afb_api) >= 0) - return stubws; - afb_stub_ws_unref(stubws); - } - return NULL; - + return afb_stub_ws_create(fdev, apiname, apiset, 1); } -struct afb_stub_ws *afb_stub_ws_create_server(int fd, const char *apiname, struct afb_apiset *apiset) +struct afb_stub_ws *afb_stub_ws_create_server(struct fdev *fdev, const char *apiname, struct afb_apiset *apiset) { struct afb_stub_ws *stubws; - stubws = afb_stub_ws_create(fd, apiname, apiset, &server_ws_itf); + stubws = afb_stub_ws_create(fdev, apiname, apiset, 0); if (stubws) { - stubws->cred = afb_cred_create_for_socket(fd); - stubws->listener = afb_evt_listener_create(&server_evt_itf, stubws); + stubws->cred = afb_cred_create_for_socket(fdev_fd(fdev)); + stubws->listener = afb_evt_listener_create(&server_event_itf, stubws); if (stubws->listener != NULL) return stubws; afb_stub_ws_unref(stubws); @@ -1133,19 +712,15 @@ struct afb_stub_ws *afb_stub_ws_create_server(int fd, const char *apiname, struc void afb_stub_ws_unref(struct afb_stub_ws *stubws) { - struct server_subcall *sc, *nsc; - - if (!__atomic_sub_fetch(&stubws->refcount, 1, __ATOMIC_RELAXED)) { - afb_evt_listener_unref(stubws->listener); - afb_ws_destroy(stubws->ws); - nsc = stubws->subcalls; - while (nsc) { - sc= nsc; - nsc = sc->next; - sc->callback(sc->closure, 1, NULL); - free(sc); + if (stubws && !__atomic_sub_fetch(&stubws->refcount, 1, __ATOMIC_RELAXED)) { + + if (stubws->is_client) { + stubws->robust.reopen = NULL; + if (stubws->robust.release) + stubws->robust.release(stubws->robust.closure); } - afb_cred_unref(stubws->cred); + + disconnect(stubws); afb_apiset_unref(stubws->apiset); free(stubws); } @@ -1156,3 +731,40 @@ void afb_stub_ws_addref(struct afb_stub_ws *stubws) __atomic_add_fetch(&stubws->refcount, 1, __ATOMIC_RELAXED); } +void afb_stub_ws_set_on_hangup(struct afb_stub_ws *stubws, void (*on_hangup)(struct afb_stub_ws*)) +{ + stubws->on_hangup = on_hangup; +} + +const char *afb_stub_ws_name(struct afb_stub_ws *stubws) +{ + return stubws->apiname; +} + +struct afb_api_item afb_stub_ws_client_api(struct afb_stub_ws *stubws) +{ + struct afb_api_item api; + + assert(stubws->is_client); /* check client */ + api.closure = stubws; + api.itf = &client_api_itf; + api.group = stubws; /* serialize for reconnections */ + return api; +} + +int afb_stub_ws_client_add(struct afb_stub_ws *stubws, struct afb_apiset *apiset) +{ + return afb_apiset_add(apiset, stubws->apiname, afb_stub_ws_client_api(stubws)); +} + +void afb_stub_ws_client_robustify(struct afb_stub_ws *stubws, struct fdev *(*reopen)(void*), void *closure, void (*release)(void*)) +{ + assert(stubws->is_client); /* check client */ + + if (stubws->robust.release) + stubws->robust.release(stubws->robust.closure); + + stubws->robust.reopen = reopen; + stubws->robust.closure = closure; + stubws->robust.release = release; +}