2 * Copyright (c) 2016, JANET(UK)
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the name of JANET(UK) nor the names of its contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
24 * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
25 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
26 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
27 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
29 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
31 * OF THE POSSIBILITY OF SUCH DAMAGE.
35 #ifndef TRP_INTERNAL_H
36 #define TRP_INTERNAL_H
47 #include <trp_ptable.h>
48 #include <trp_route.h>
49 #include <trp_rtable.h>
52 #include <trust_router/trp.h>
54 /* what clock do we use with clock_gettime() ? */
55 #define TRP_CLOCK CLOCK_MONOTONIC
58 /* TRP update record types */
59 typedef struct trp_inforec_route {
60 TR_NAME *trust_router;
61 int trust_router_port;
65 unsigned int interval;
68 typedef struct trp_inforec_comm {
69 TR_COMM_TYPE comm_type;
73 TR_NAME *owner_contact;
74 time_t expiration_interval; /* Minutes to key expiration; only valid for an APC */
76 unsigned int interval;
79 typedef union trp_inforec_data {
80 TRP_INFOREC_ROUTE *route;
81 TRP_INFOREC_COMM *comm;
86 TRP_INFOREC_TYPE type;
87 TRP_INFOREC_DATA *data; /* contains pointer to one of the record types */
94 TR_NAME *peer; /* who did this update come from? */
100 TR_NAME *peer; /* who did this req come from? */
104 typedef struct trps_instance TRPS_INSTANCE;
106 typedef enum trp_connection_status {
107 TRP_CONNECTION_CLOSED=0,
109 TRP_CONNECTION_AUTHORIZING,
111 TRP_CONNECTION_UNKNOWN,
112 } TRP_CONNECTION_STATUS;
114 typedef struct trp_connection TRP_CONNECTION;
115 struct trp_connection {
116 pthread_mutex_t mutex; /* protects status attribute */
117 TRP_CONNECTION *next;
118 pthread_t *thread; /* thread servicing this connection */
120 TR_NAME *gssname; /* the gss service name we presented for passive auth */
121 TR_NAME *peer; /* gssname of incoming peer */
122 gss_ctx_id_t *gssctx;
123 TRP_CONNECTION_STATUS status;
124 void (*status_change_cb)(TRP_CONNECTION *conn, void *cookie);
125 void *status_change_cookie;
128 typedef TRP_RC (*TRPS_MSG_FUNC)(TRPS_INSTANCE *, TRP_CONNECTION *, TR_MSG *);
129 typedef void (*TRP_RESP_FUNC)();
130 /*typedef int (*TRP_AUTH_FUNC)(gss_name_t client_name, TR_NAME *display_name, void *cookie);*/
131 typedef client_cb_fn TRP_AUTH_FUNC;
133 /* function to look up comm/realm entries */
134 typedef TRP_ROUTE *(TRP_LOOKUP_FUNC)(TR_NAME *, TR_NAME *, void *);
137 /* TRP Client Instance Data */
138 typedef struct trpc_instance TRPC_INSTANCE;
139 struct trpc_instance {
144 TRP_CONNECTION *conn;
145 TR_MQ *mq; /* msgs from master to trpc */
148 /* TRP Server Instance Data */
149 struct trps_instance {
152 int tids_port; /* used for route advertisements; must agree with our tids configuration */
153 TRP_AUTH_FUNC auth_handler;
154 TRPS_MSG_FUNC msg_handler;
156 TRP_CONNECTION *conn; /* connections from peers */
157 TRPC_INSTANCE *trpc; /* connections to peers */
158 TR_MQ *mq; /* incoming message queue */
159 TRP_PTABLE *ptable; /* peer table */
160 TRP_RTABLE *rtable; /* route table */
161 TR_COMM_TABLE *ctable; /* community table */
162 struct timeval connect_interval; /* interval between connection refreshes */
163 struct timeval update_interval; /* interval between scheduled updates */
164 struct timeval sweep_interval; /* interval between route table sweeps */
167 typedef enum trp_update_type {
168 TRP_UPDATE_SCHEDULED=0,
169 TRP_UPDATE_TRIGGERED,
173 TRP_CONNECTION *trp_connection_new(TALLOC_CTX *mem_ctx);
174 void trp_connection_free(TRP_CONNECTION *conn);
175 void trp_connection_close(TRP_CONNECTION *conn);
176 int trp_connection_lock(TRP_CONNECTION *conn);
177 int trp_connection_unlock(TRP_CONNECTION *conn);
178 int trp_connection_get_fd(TRP_CONNECTION *conn);
179 void trp_connection_set_fd(TRP_CONNECTION *conn, int fd);
180 TR_NAME *trp_connection_get_peer(TRP_CONNECTION *conn);
181 TR_NAME *trp_connection_get_gssname(TRP_CONNECTION *conn);
182 void trp_connection_set_gssname(TRP_CONNECTION *conn, TR_NAME *gssname);
183 gss_ctx_id_t *trp_connection_get_gssctx(TRP_CONNECTION *conn);
184 void trp_connection_set_gssctx(TRP_CONNECTION *conn, gss_ctx_id_t *gssctx);
185 TRP_CONNECTION_STATUS trp_connection_get_status(TRP_CONNECTION *conn);
186 pthread_t *trp_connection_get_thread(TRP_CONNECTION *conn);
187 void trp_connection_set_thread(TRP_CONNECTION *conn, pthread_t *thread);
188 TRP_CONNECTION *trp_connection_get_next(TRP_CONNECTION *conn);
189 TRP_CONNECTION *trp_connection_remove(TRP_CONNECTION *conn, TRP_CONNECTION *remove);
190 void trp_connection_append(TRP_CONNECTION *conn, TRP_CONNECTION *new);
191 int trp_connection_auth(TRP_CONNECTION *conn, TRP_AUTH_FUNC auth_callback, void *callback_data);
192 TRP_CONNECTION *trp_connection_accept(TALLOC_CTX *mem_ctx, int listen, TR_NAME *gss_servicename);
193 TRP_RC trp_connection_initiate(TRP_CONNECTION *conn, char *server, int port);
195 TRPC_INSTANCE *trpc_new (TALLOC_CTX *mem_ctx);
196 void trpc_free (TRPC_INSTANCE *trpc);
197 TRP_CONNECTION *trpc_get_conn(TRPC_INSTANCE *trpc);
198 void trpc_set_conn(TRPC_INSTANCE *trpc, TRP_CONNECTION *conn);
199 TRPC_INSTANCE *trpc_get_next(TRPC_INSTANCE *trpc);
200 void trpc_set_next(TRPC_INSTANCE *trpc, TRPC_INSTANCE *next);
201 TRPC_INSTANCE *trpc_remove(TRPC_INSTANCE *trpc, TRPC_INSTANCE *remove);
202 void trpc_append(TRPC_INSTANCE *trpc, TRPC_INSTANCE *new);
203 char *trpc_get_server(TRPC_INSTANCE *trpc);
204 void trpc_set_server(TRPC_INSTANCE *trpc, char *server);
205 TR_NAME *trpc_get_gssname(TRPC_INSTANCE *trpc);
206 void trpc_set_gssname(TRPC_INSTANCE *trpc, TR_NAME *gssname);
207 unsigned int trpc_get_port(TRPC_INSTANCE *trpc);
208 void trpc_set_port(TRPC_INSTANCE *trpc, int port);
209 TRP_CONNECTION_STATUS trpc_get_status(TRPC_INSTANCE *trpc);
210 TR_MQ *trpc_get_mq(TRPC_INSTANCE *trpc);
211 void trpc_set_mq(TRPC_INSTANCE *trpc, TR_MQ *mq);
212 void trpc_mq_add(TRPC_INSTANCE *trpc, TR_MQ_MSG *msg);
213 TR_MQ_MSG *trpc_mq_pop(TRPC_INSTANCE *trpc, struct timespec *ts_abort);
214 void trpc_mq_clear(TRPC_INSTANCE *trpc);
215 void trpc_master_mq_add(TRPC_INSTANCE *trpc, TR_MQ_MSG *msg);
216 TR_MQ_MSG *trpc_master_mq_pop(TRPC_INSTANCE *trpc);
217 TRP_RC trpc_connect(TRPC_INSTANCE *trpc);
218 TRP_RC trpc_send_msg(TRPC_INSTANCE *trpc, const char *msg_content);
220 TRPS_INSTANCE *trps_new (TALLOC_CTX *mem_ctx);
221 void trps_free (TRPS_INSTANCE *trps);
222 void trps_set_ctable(TRPS_INSTANCE *trps, TR_COMM_TABLE *comm);
223 void trps_set_ptable(TRPS_INSTANCE *trps, TRP_PTABLE *ptable);
224 void trps_set_peer_status_callback(TRPS_INSTANCE *trps, void (*cb)(TRP_PEER *, void *), void *cookie);
225 TR_NAME *trps_dup_label(TRPS_INSTANCE *trps);
226 TRP_RC trps_init_rtable(TRPS_INSTANCE *trps);
227 void trps_clear_rtable(TRPS_INSTANCE *trps);
228 void trps_set_connect_interval(TRPS_INSTANCE *trps, unsigned int interval);
229 unsigned int trps_get_connect_interval(TRPS_INSTANCE *trps);
230 void trps_set_update_interval(TRPS_INSTANCE *trps, unsigned int interval);
231 unsigned int trps_get_update_interval(TRPS_INSTANCE *trps);
232 void trps_set_sweep_interval(TRPS_INSTANCE *trps, unsigned int interval);
233 unsigned int trps_get_sweep_interval(TRPS_INSTANCE *trps);
234 TRPC_INSTANCE *trps_find_trpc(TRPS_INSTANCE *trps, TRP_PEER *peer);
235 TRP_RC trps_send_msg (TRPS_INSTANCE *trps, TRP_PEER *peer, const char *msg);
236 void trps_add_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *new);
237 void trps_remove_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *remove);
238 void trps_add_trpc(TRPS_INSTANCE *trps, TRPC_INSTANCE *trpc);
239 void trps_remove_trpc(TRPS_INSTANCE *trps, TRPC_INSTANCE *remove);
240 int trps_get_listener(TRPS_INSTANCE *trps,
241 TRPS_MSG_FUNC msg_handler,
242 TRP_AUTH_FUNC auth_handler,
243 const char *hostname,
248 TR_MQ_MSG *trps_mq_pop(TRPS_INSTANCE *trps);
249 void trps_mq_add(TRPS_INSTANCE *trps, TR_MQ_MSG *msg);
250 TRP_RC trps_authorize_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *conn);
251 void trps_handle_connection(TRPS_INSTANCE *trps, TRP_CONNECTION *conn);
252 TRP_RC trps_update_active_routes(TRPS_INSTANCE *trps);
253 TRP_RC trps_handle_tr_msg(TRPS_INSTANCE *trps, TR_MSG *tr_msg);
254 TRP_ROUTE *trps_get_route(TRPS_INSTANCE *trps, TR_NAME *comm, TR_NAME *realm, TR_NAME *peer);
255 TRP_ROUTE *trps_get_selected_route(TRPS_INSTANCE *trps, TR_NAME *comm, TR_NAME *realm);
256 TR_NAME *trps_get_next_hop(TRPS_INSTANCE *trps, TR_NAME *comm, TR_NAME *realm);
257 TRP_RC trps_sweep_routes(TRPS_INSTANCE *trps);
258 TRP_RC trps_sweep_ctable(TRPS_INSTANCE *trps);
259 TRP_RC trps_add_route(TRPS_INSTANCE *trps, TRP_ROUTE *route);
260 TRP_RC trps_add_peer(TRPS_INSTANCE *trps, TRP_PEER *peer);
261 TRP_PEER *trps_get_peer_by_gssname(TRPS_INSTANCE *trps, TR_NAME *gssname);
262 TRP_PEER *trps_get_peer_by_servicename(TRPS_INSTANCE *trps, TR_NAME *servicename);
263 TRP_RC trps_update(TRPS_INSTANCE *trps, TRP_UPDATE_TYPE type);
264 int trps_peer_connected(TRPS_INSTANCE *trps, TRP_PEER *peer);
265 TRP_RC trps_wildcard_route_req(TRPS_INSTANCE *trps, TR_NAME *peer_gssname);
267 TRP_INFOREC *trp_inforec_new(TALLOC_CTX *mem_ctx, TRP_INFOREC_TYPE type);
268 void trp_inforec_free(TRP_INFOREC *rec);
269 TRP_INFOREC *trp_inforec_get_next(TRP_INFOREC *rec);
270 void trp_inforec_set_next(TRP_INFOREC *rec, TRP_INFOREC *next_rec);
271 TRP_INFOREC_TYPE trp_inforec_get_type(TRP_INFOREC *rec);
272 void trp_inforec_set_type(TRP_INFOREC *rec, TRP_INFOREC_TYPE type);
273 TR_NAME *trp_inforec_get_comm(TRP_INFOREC *rec);
274 TR_NAME *trp_inforec_dup_comm(TRP_INFOREC *rec);
275 TRP_RC trp_inforec_set_comm(TRP_INFOREC *rec, TR_NAME *comm);
276 TR_NAME *trp_inforec_get_realm(TRP_INFOREC *rec);
277 TR_NAME *trp_inforec_dup_realm(TRP_INFOREC *rec);
278 TRP_RC trp_inforec_set_realm(TRP_INFOREC *rec, TR_NAME *realm);
279 TR_NAME *trp_inforec_get_trust_router(TRP_INFOREC *rec);
280 int trp_inforec_get_trust_router_port(TRP_INFOREC *rec);
281 TR_NAME *trp_inforec_dup_trust_router(TRP_INFOREC *rec);
282 TRP_RC trp_inforec_set_trust_router(TRP_INFOREC *rec, TR_NAME *trust_router, int port);
283 TR_NAME *trp_inforec_get_next_hop(TRP_INFOREC *rec);
284 int trp_inforec_get_next_hop_port(TRP_INFOREC *rec);
285 TR_NAME *trp_inforec_dup_next_hop(TRP_INFOREC *rec);
286 TRP_RC trp_inforec_set_next_hop(TRP_INFOREC *rec, TR_NAME *next_hop, int port);
287 unsigned int trp_inforec_get_metric(TRP_INFOREC *rec);
288 TRP_RC trp_inforec_set_metric(TRP_INFOREC *rec, unsigned int metric);
289 unsigned int trp_inforec_get_interval(TRP_INFOREC *rec);
290 TRP_RC trp_inforec_set_interval(TRP_INFOREC *rec, unsigned int interval);
291 TR_NAME *trp_inforec_get_owner_realm(TRP_INFOREC *rec);
292 TRP_RC trp_inforec_set_owner_realm(TRP_INFOREC *rec, TR_NAME *name);
293 TR_NAME *trp_inforec_get_owner_contact(TRP_INFOREC *rec);
294 TRP_RC trp_inforec_set_owner_contact(TRP_INFOREC *rec, TR_NAME *name);
295 json_t *trp_inforec_get_provenance(TRP_INFOREC *rec);
296 TRP_RC trp_inforec_set_provenance(TRP_INFOREC *rec, json_t *prov);
297 TRP_INFOREC_TYPE trp_inforec_type_from_string(const char *s);
298 const char *trp_inforec_type_to_string(TRP_INFOREC_TYPE msgtype);
299 time_t trp_inforec_get_exp_interval(TRP_INFOREC *rec);
300 TRP_RC trp_inforec_set_exp_interval(TRP_INFOREC *rec, time_t expint);
301 TR_COMM_TYPE trp_inforec_get_comm_type(TRP_INFOREC *rec);
302 TRP_RC trp_inforec_set_comm_type(TRP_INFOREC *rec, TR_COMM_TYPE type);
303 TR_REALM_ROLE trp_inforec_get_role(TRP_INFOREC *rec);
304 TRP_RC trp_inforec_set_role(TRP_INFOREC *rec, TR_REALM_ROLE role);
305 TR_APC *trp_inforec_get_apcs(TRP_INFOREC *rec);
306 TRP_RC trp_inforec_set_apcs(TRP_INFOREC *rec, TR_APC *apcs);
307 TR_NAME *trp_inforec_dup_origin(TRP_INFOREC *rec);
309 #endif /* TRP_INTERNAL_H */