/*
- * Copyright (C) 2011 Felix Fietkau <nbd@openwrt.org>
+ * Copyright (C) 2011-2012 Felix Fietkau <nbd@openwrt.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 2.1
* GNU General Public License for more details.
*/
+#ifndef __LIBUBUS_H
+#define __LIBUBUS_H
+
#include <libubox/avl.h>
#include <libubox/list.h>
#include <libubox/blobmsg.h>
#include "ubusmsg.h"
#include "ubus_common.h"
+#define UBUS_MAX_NOTIFY_PEERS 16
+
struct ubus_context;
struct ubus_msg_src;
struct ubus_object;
struct ubus_request_data;
struct ubus_object_data;
struct ubus_event_handler;
+struct ubus_subscriber;
+struct ubus_notify_request;
+
+static inline struct blob_attr *
+ubus_msghdr_data(struct ubus_msghdr *hdr)
+{
+ return (struct blob_attr *) (hdr + 1);
+}
typedef void (*ubus_lookup_handler_t)(struct ubus_context *ctx,
struct ubus_object_data *obj,
typedef int (*ubus_handler_t)(struct ubus_context *ctx, struct ubus_object *obj,
struct ubus_request_data *req,
const char *method, struct blob_attr *msg);
+typedef void (*ubus_state_handler_t)(struct ubus_context *ctx, struct ubus_object *obj);
+typedef void (*ubus_remove_handler_t)(struct ubus_context *ctx,
+ struct ubus_subscriber *obj, uint32_t id);
typedef void (*ubus_event_handler_t)(struct ubus_context *ctx, struct ubus_event_handler *ev,
const char *type, struct blob_attr *msg);
typedef void (*ubus_data_handler_t)(struct ubus_request *req,
int type, struct blob_attr *msg);
typedef void (*ubus_complete_handler_t)(struct ubus_request *req, int ret);
+typedef void (*ubus_notify_complete_handler_t)(struct ubus_notify_request *req,
+ int idx, int ret);
#define UBUS_OBJECT_TYPE(_name, _methods) \
{ \
.n_policy = ARRAY_SIZE(_policy) \
}
+#define UBUS_METHOD_NOARG(_name, _handler) \
+ { \
+ .name = _name, \
+ .handler = _handler, \
+ }
+
struct ubus_method {
const char *name;
ubus_handler_t handler;
const char *path;
struct ubus_object_type *type;
+ ubus_state_handler_t subscribe_cb;
+ bool has_subscribers;
+
const struct ubus_method *methods;
int n_methods;
};
+struct ubus_subscriber {
+ struct ubus_object obj;
+
+ ubus_handler_t cb;
+ ubus_remove_handler_t remove_cb;
+};
+
struct ubus_event_handler {
struct ubus_object obj;
struct uloop_fd sock;
uint32_t local_id;
- uint32_t request_seq;
+ uint16_t request_seq;
int stack_depth;
void (*connection_lost)(struct ubus_context *ctx);
struct ubus_request_data {
uint32_t object;
uint32_t peer;
- uint32_t seq;
+ uint16_t seq;
+ bool deferred;
};
struct ubus_request {
struct list_head list;
struct list_head pending;
- bool status_msg;
int status_code;
+ bool status_msg;
bool blocked;
bool cancelled;
+ bool notify;
uint32_t peer;
- uint32_t seq;
+ uint16_t seq;
ubus_data_handler_t raw_data_cb;
ubus_data_handler_t data_cb;
void *priv;
};
+struct ubus_notify_request {
+ struct ubus_request req;
+
+ ubus_notify_complete_handler_t status_cb;
+ ubus_notify_complete_handler_t complete_cb;
+
+ uint32_t pending;
+ uint32_t id[UBUS_MAX_NOTIFY_PEERS + 1];
+};
struct ubus_context *ubus_connect(const char *path);
+int ubus_reconnect(struct ubus_context *ctx, const char *path);
void ubus_free(struct ubus_context *ctx);
const char *ubus_strerror(int error);
/* remove the object from the ubus connection */
int ubus_remove_object(struct ubus_context *ctx, struct ubus_object *obj);
+/* add a subscriber notifications from another object */
+int ubus_register_subscriber(struct ubus_context *ctx, struct ubus_subscriber *obj);
+
+static inline int
+ubus_unregister_subscriber(struct ubus_context *ctx, struct ubus_subscriber *obj)
+{
+ return ubus_remove_object(ctx, &obj->obj);
+}
+
+int ubus_subscribe(struct ubus_context *ctx, struct ubus_subscriber *obj, uint32_t id);
+int ubus_unsubscribe(struct ubus_context *ctx, struct ubus_subscriber *obj, uint32_t id);
+
/* ----------- rpc ----------- */
/* invoke a method on a specific object */
int ubus_send_reply(struct ubus_context *ctx, struct ubus_request_data *req,
struct blob_attr *msg);
+static inline void ubus_defer_request(struct ubus_context *ctx,
+ struct ubus_request_data *req,
+ struct ubus_request_data *new_req)
+{
+ memcpy(new_req, req, sizeof(*req));
+ req->deferred = true;
+}
+
+void ubus_complete_deferred_request(struct ubus_context *ctx,
+ struct ubus_request_data *req, int ret);
+
+/*
+ * send a notification to all subscribers of an object
+ * if timeout < 0, no reply is expected from subscribers
+ */
+int ubus_notify(struct ubus_context *ctx, struct ubus_object *obj,
+ const char *type, struct blob_attr *msg, int timeout);
+
+int ubus_notify_async(struct ubus_context *ctx, struct ubus_object *obj,
+ const char *type, struct blob_attr *msg,
+ struct ubus_notify_request *req);
+
+
/* ----------- events ----------- */
int ubus_send_event(struct ubus_context *ctx, const char *id,
{
return ubus_remove_object(ctx, &ev->obj);
}
+
+#endif