session: introduce api to register session create and destroy callbacks
[project/rpcd.git] / session.h
1 /*
2  * rpcd - UBUS RPC server
3  *
4  *   Copyright (C) 2013 Felix Fietkau <nbd@openwrt.org>
5  *   Copyright (C) 2013 Jo-Philipp Wich <jow@openwrt.org>
6  *
7  * Permission to use, copy, modify, and/or distribute this software for any
8  * purpose with or without fee is hereby granted, provided that the above
9  * copyright notice and this permission notice appear in all copies.
10  *
11  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18  */
19
20 #ifndef __RPC_SESSION_H
21 #define __RPC_SESSION_H
22
23 #include <libubox/avl.h>
24 #include <libubox/blobmsg_json.h>
25
26 #define RPC_SID_LEN     32
27 #define RPC_DEFAULT_SESSION_TIMEOUT     300
28
29 struct rpc_session {
30         struct avl_node avl;
31         char id[RPC_SID_LEN + 1];
32
33         struct uloop_timeout t;
34         struct avl_tree data;
35         struct avl_tree acls;
36
37         int timeout;
38 };
39
40 struct rpc_session_data {
41         struct avl_node avl;
42         struct blob_attr attr[];
43 };
44
45 struct rpc_session_acl_scope {
46         struct avl_node avl;
47         struct avl_tree acls;
48 };
49
50 struct rpc_session_acl {
51         struct avl_node avl;
52         const char *object;
53         const char *function;
54         int sort_len;
55 };
56
57 int rpc_session_api_init(struct ubus_context *ctx);
58
59 bool rpc_session_access(const char *sid, const char *scope,
60                         const char *object, const char *function);
61
62 struct rpc_session_cb {
63         struct list_head list;
64         void (*cb)(struct rpc_session *, void *);
65         void *priv;
66 };
67
68 void rpc_session_create_cb(struct rpc_session_cb *cb);
69 void rpc_session_destroy_cb(struct rpc_session_cb *cb);
70
71 #endif