Install callback to request routes when connections established.
[trust_router.git] / include / trp_internal.h
1 #ifndef TRP_INTERNAL_H
2 #define TRP_INTERNAL_H
3
4 #include <pthread.h>
5 #include <talloc.h>
6
7 #include <gsscon.h>
8 #include <tr_mq.h>
9 #include <tr_msg.h>
10 #include <trp_ptable.h>
11 #include <trp_rtable.h>
12 #include <trust_router/trp.h>
13
14 /* info records */
15 /* TRP update record types */
16 typedef struct trp_inforec_route {
17   TR_NAME *comm;
18   TR_NAME *realm;
19   TR_NAME *trust_router;
20   TR_NAME *next_hop;
21   unsigned int next_hop_port;
22   unsigned int metric;
23   unsigned int interval;
24 } TRP_INFOREC_ROUTE;
25
26 /* TODO: define struct trp_msg_info_community */
27
28 typedef union trp_inforec_data {
29   TRP_INFOREC_ROUTE *route;
30   /* TRP_INFOREC_COMM *comm; */
31 } TRP_INFOREC_DATA;
32
33 struct trp_inforec {
34   TRP_INFOREC *next;
35   TRP_INFOREC_TYPE type;
36   TRP_INFOREC_DATA data; /* contains pointer to one of the record types */
37 };
38
39 struct trp_update {
40   TRP_INFOREC *records;
41   TR_NAME *peer; /* who did this update come from? */
42 };
43
44 struct trp_req {
45   TR_NAME *comm;
46   TR_NAME *realm;
47   TR_NAME *peer; /* who did this req come from? */
48 };
49
50
51 typedef struct trps_instance TRPS_INSTANCE;
52
53 typedef enum trp_connection_status {
54   TRP_CONNECTION_CLOSED=0,
55   TRP_CONNECTION_DOWN,  
56   TRP_CONNECTION_AUTHORIZING,  
57   TRP_CONNECTION_UP,
58   TRP_CONNECTION_UNKNOWN,
59 } TRP_CONNECTION_STATUS;
60
61 typedef struct trp_connection TRP_CONNECTION;
62 struct trp_connection {
63   pthread_mutex_t mutex; /* protects status attribute */
64   TRP_CONNECTION *next;
65   pthread_t *thread; /* thread servicing this connection */
66   int fd;
67   TR_NAME *gssname;
68   TR_NAME *peer; /* TODO: why is there a peer and a gssname? jlr */
69   gss_ctx_id_t *gssctx;
70   TRP_CONNECTION_STATUS status;
71   void (*status_change_cb)(TRP_CONNECTION *conn, void *cookie);
72   void *status_change_cookie;
73 };
74
75 typedef TRP_RC (*TRPS_MSG_FUNC)(TRPS_INSTANCE *, TRP_CONNECTION *, TR_MSG *);
76 typedef void (*TRP_RESP_FUNC)();
77 /*typedef int (*TRP_AUTH_FUNC)(gss_name_t client_name, TR_NAME *display_name, void *cookie);*/
78 typedef client_cb_fn TRP_AUTH_FUNC;
79
80 /* function to look up comm/realm entries */
81 typedef TRP_ROUTE *(TRP_LOOKUP_FUNC)(TR_NAME *, TR_NAME *, void *);
82
83
84 /* TRP Client Instance Data */
85 typedef struct trpc_instance TRPC_INSTANCE;
86 struct trpc_instance {
87   TRPC_INSTANCE *next;
88   TR_NAME *gssname;
89   char *server;
90   unsigned int port;
91   TRP_CONNECTION *conn;
92   TR_MQ *mq; /* msgs from master to trpc */
93 };
94
95 /* TRP Server Instance Data */
96 struct trps_instance {
97   char *hostname;
98   unsigned int port;
99   TRP_AUTH_FUNC auth_handler;
100   TRPS_MSG_FUNC msg_handler;
101   void *cookie;
102   TRP_CONNECTION *conn; /* connections from peers */
103   TRPC_INSTANCE *trpc; /* connections to peers */
104   TR_MQ *mq; /* incoming message queue */
105   TRP_PTABLE *ptable; /* peer table */
106   TRP_RTABLE *rtable; /* route table */
107   struct timeval connect_interval; /* interval between connection refreshes */
108   struct timeval update_interval; /* interval between scheduled updates */
109   struct timeval sweep_interval; /* interval between route table sweeps */
110 };
111
112 typedef enum trp_update_type {
113   TRP_UPDATE_SCHEDULED=0,
114   TRP_UPDATE_TRIGGERED,
115   TRP_UPDATE_REQUESTED
116 } TRP_UPDATE_TYPE;
117
118 TRP_CONNECTION *trp_connection_new(TALLOC_CTX *mem_ctx);
119 void trp_connection_free(TRP_CONNECTION *conn);
120 void trp_connection_close(TRP_CONNECTION *conn);
121 int trp_connection_lock(TRP_CONNECTION *conn);
122 int trp_connection_unlock(TRP_CONNECTION *conn);
123 int trp_connection_get_fd(TRP_CONNECTION *conn);
124 void trp_connection_set_fd(TRP_CONNECTION *conn, int fd);
125 TR_NAME *trp_connection_get_peer(TRP_CONNECTION *conn);
126 TR_NAME *trp_connection_get_gssname(TRP_CONNECTION *conn);
127 void trp_connection_set_gssname(TRP_CONNECTION *conn, TR_NAME *gssname);
128 gss_ctx_id_t *trp_connection_get_gssctx(TRP_CONNECTION *conn);
129 void trp_connection_set_gssctx(TRP_CONNECTION *conn, gss_ctx_id_t *gssctx);
130 TRP_CONNECTION_STATUS trp_connection_get_status(TRP_CONNECTION *conn);
131 pthread_t *trp_connection_get_thread(TRP_CONNECTION *conn);
132 void trp_connection_set_thread(TRP_CONNECTION *conn, pthread_t *thread);
133 TRP_CONNECTION *trp_connection_get_next(TRP_CONNECTION *conn);
134 TRP_CONNECTION *trp_connection_remove(TRP_CONNECTION *conn, TRP_CONNECTION *remove);
135 void trp_connection_append(TRP_CONNECTION *conn, TRP_CONNECTION *new);
136 int trp_connection_auth(TRP_CONNECTION *conn, TRP_AUTH_FUNC auth_callback, void *callback_data);
137 TRP_CONNECTION *trp_connection_accept(TALLOC_CTX *mem_ctx, int listen, TR_NAME *gssname);
138 TRP_RC trp_connection_initiate(TRP_CONNECTION *conn, char *server, unsigned int port);
139
140 TRPC_INSTANCE *trpc_new (TALLOC_CTX *mem_ctx);
141 void trpc_free (TRPC_INSTANCE *trpc);
142 TRP_CONNECTION *trpc_get_conn(TRPC_INSTANCE *trpc);
143 void trpc_set_conn(TRPC_INSTANCE *trpc, TRP_CONNECTION *conn);
144 TRPC_INSTANCE *trpc_get_next(TRPC_INSTANCE *trpc);
145 void trpc_set_next(TRPC_INSTANCE *trpc, TRPC_INSTANCE *next);
146 TRPC_INSTANCE *trpc_remove(TRPC_INSTANCE *trpc, TRPC_INSTANCE *remove);
147 void trpc_append(TRPC_INSTANCE *trpc, TRPC_INSTANCE *new);
148 char *trpc_get_server(TRPC_INSTANCE *trpc);
149 void trpc_set_server(TRPC_INSTANCE *trpc, char *server);
150 TR_NAME *trpc_get_gssname(TRPC_INSTANCE *trpc);
151 void trpc_set_gssname(TRPC_INSTANCE *trpc, TR_NAME *gssname);
152 unsigned int trpc_get_port(TRPC_INSTANCE *trpc);
153 void trpc_set_port(TRPC_INSTANCE *trpc, unsigned int port);
154 TRP_CONNECTION_STATUS trpc_get_status(TRPC_INSTANCE *trpc);
155 TR_MQ *trpc_get_mq(TRPC_INSTANCE *trpc);
156 void trpc_set_mq(TRPC_INSTANCE *trpc, TR_MQ *mq);
157 void trpc_mq_add(TRPC_INSTANCE *trpc, TR_MQ_MSG *msg);
158 TR_MQ_MSG *trpc_mq_pop(TRPC_INSTANCE *trpc);
159 void trpc_mq_clear(TRPC_INSTANCE *trpc);
160 void trpc_master_mq_add(TRPC_INSTANCE *trpc, TR_MQ_MSG *msg);
161 TR_MQ_MSG *trpc_master_mq_pop(TRPC_INSTANCE *trpc);
162 TRP_RC trpc_connect(TRPC_INSTANCE *trpc);
163 TRP_RC trpc_send_msg(TRPC_INSTANCE *trpc, const char *msg_content);
164
165 TRPS_INSTANCE *trps_new (TALLOC_CTX *mem_ctx);
166 void trps_free (TRPS_INSTANCE *trps);
167 void trps_set_ptable(TRPS_INSTANCE *trps, TRP_PTABLE *ptable);
168 void trps_set_peer_status_callback(TRPS_INSTANCE *trps, void (*cb)(TRP_PEER *, void *), void *cookie);
169 TRP_RC trps_init_rtable(TRPS_INSTANCE *trps);
170 void trps_clear_rtable(TRPS_INSTANCE *trps);
171 void trps_set_connect_interval(TRPS_INSTANCE *trps, unsigned int interval);
172 unsigned int trps_get_connect_interval(TRPS_INSTANCE *trps);
173 void trps_set_update_interval(TRPS_INSTANCE *trps, unsigned int interval);
174 unsigned int trps_get_update_interval(TRPS_INSTANCE *trps);
175 void trps_set_sweep_interval(TRPS_INSTANCE *trps, unsigned int interval);
176 unsigned int trps_get_sweep_interval(TRPS_INSTANCE *trps);
177 TRPC_INSTANCE *trps_find_trpc(TRPS_INSTANCE *trps, TRP_PEER *peer);
178 TRP_RC trps_send_msg (TRPS_INSTANCE *trps, TRP_PEER *peer, const char *msg);
179 void trps_add_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *new);
180 void trps_remove_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *remove);
181 void trps_add_trpc(TRPS_INSTANCE *trps, TRPC_INSTANCE *trpc);
182 void trps_remove_trpc(TRPS_INSTANCE *trps, TRPC_INSTANCE *remove);
183 int trps_get_listener(TRPS_INSTANCE *trps,
184                       TRPS_MSG_FUNC msg_handler,
185                       TRP_AUTH_FUNC auth_handler,
186                       const char *hostname,
187                       unsigned int port,
188                       void *cookie);
189 TR_MQ_MSG *trps_mq_pop(TRPS_INSTANCE *trps);
190 void trps_mq_add(TRPS_INSTANCE *trps, TR_MQ_MSG *msg);
191 TRP_RC trps_authorize_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *conn);
192 void trps_handle_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *conn);
193 TRP_RC trps_update_active_routes(TRPS_INSTANCE *trps);
194 TRP_RC trps_handle_tr_msg(TRPS_INSTANCE *trps, TR_MSG *tr_msg);
195 TRP_ROUTE *trps_get_route(TRPS_INSTANCE *trps, TR_NAME *comm, TR_NAME *realm, TR_NAME *peer);
196 TRP_ROUTE *trps_get_selected_route(TRPS_INSTANCE *trps, TR_NAME *comm, TR_NAME *realm);
197 TR_NAME *trps_get_next_hop(TRPS_INSTANCE *trps, TR_NAME *comm, TR_NAME *realm);
198 TRP_RC trps_sweep_routes(TRPS_INSTANCE *trps);
199 TRP_RC trps_add_route(TRPS_INSTANCE *trps, TRP_ROUTE *route);
200 TRP_RC trps_add_peer(TRPS_INSTANCE *trps, TRP_PEER *peer);
201 TRP_PEER *trps_get_peer_by_gssname(TRPS_INSTANCE *trps, TR_NAME *gssname);
202 TRP_PEER *trps_get_peer_by_servicename(TRPS_INSTANCE *trps, TR_NAME *servicename);
203 TRP_RC trps_update(TRPS_INSTANCE *trps, TRP_UPDATE_TYPE type);
204 int trps_peer_connected(TRPS_INSTANCE *trps, TRP_PEER *peer);
205 TRP_RC trps_wildcard_route_req(TRPS_INSTANCE *trps, TR_NAME *peer_gssname);
206 #endif /* TRP_INTERNAL_H */