Postpone resolving of DNS names of server.
[libradsec.git] / lib / include / radsec / radsec-impl.h
1 /** @file libradsec-impl.h
2     @brief Libraray internal header file for libradsec.  */
3
4 /* See the file COPYING for licensing information.  */
5
6 #include <freeradius/libradius.h>
7 #include <event2/util.h>
8 #include <confuse.h>
9 #if defined(RS_ENABLE_TLS)
10 #include <openssl/ssl.h>
11 #endif
12
13 /* Constants.  */
14 #define RS_HEADER_LEN 4
15
16 /* Data types.  */
17 enum rs_cred_type {
18     RS_CRED_NONE = 0,
19     /* TLS pre-shared keys, RFC 4279.  */
20     RS_CRED_TLS_PSK,
21     /* RS_CRED_TLS_DH_PSK, */
22     /* RS_CRED_TLS_RSA_PSK, */
23 };
24 typedef unsigned int rs_cred_type_t;
25
26 enum rs_key_encoding {
27     RS_KEY_ENCODING_UTF8 = 1,
28     RS_KEY_ENCODING_ASCII_HEX = 2,
29 };
30 typedef unsigned int rs_key_encoding_t;
31
32 #if defined (__cplusplus)
33 extern "C" {
34 #endif
35
36 struct rs_credentials {
37     enum rs_cred_type type;
38     char *identity;
39     char *secret;
40     enum rs_key_encoding secret_encoding;
41     unsigned int secret_len;
42 };
43
44 struct rs_error {
45     int code;
46     char buf[1024];
47 };
48
49 /** Configuration object for a connection.  */
50 struct rs_peer {
51     struct rs_connection *conn;
52     struct rs_realm *realm;
53     char *hostname;
54     char *service;
55     char *secret;               /* RADIUS secret.  */
56     struct evutil_addrinfo *addr_cache;
57     struct rs_peer *next;
58 };
59
60 /** Configuration object for a RADIUS realm.  */
61 struct rs_realm {
62     char *name;
63     enum rs_conn_type type;
64     int timeout;
65     int retries;
66     char *cacertfile;
67     char *cacertpath;
68     char *certfile;
69     char *certkeyfile;
70     struct rs_credentials *transport_cred;
71     struct rs_peer *peers;
72     struct rs_realm *next;
73 };
74
75 /** Top configuration object.  */
76 struct rs_config {
77     char *dictionary;
78     struct rs_realm *realms;
79     cfg_t *cfg;
80 };
81
82 struct rs_context {
83     struct rs_config *config;
84     struct rs_alloc_scheme alloc_scheme;
85     struct rs_error *err;
86     fr_randctx fr_randctx;
87 };
88
89 struct rs_connection {
90     struct rs_context *ctx;
91     struct rs_realm *realm;     /* Owned by ctx.  */
92     struct event_base *evb;     /* Event base.  */
93     struct event *tev;          /* Timeout event.  */
94     struct rs_conn_callbacks callbacks;
95     void *user_data;
96     struct rs_peer *peers;
97     struct rs_peer *active_peer;
98     struct rs_error *err;
99     struct timeval timeout;
100     char is_connecting;         /* FIXME: replace with a single state member */
101     char is_connected;          /* FIXME: replace with a single state member */
102     int fd;                     /* Socket.  */
103     int tryagain;               /* For server failover.  */
104     int nextid;                 /* Next RADIUS packet identifier.  */
105     /* TCP transport specifics.  */
106     struct bufferevent *bev;    /* Buffer event.  */
107     /* UDP transport specifics.  */
108     struct event *wev;          /* Write event (for UDP).  */
109     struct event *rev;          /* Read event (for UDP).  */
110     struct rs_packet *out_queue; /* Queue for outgoing UDP packets.  */
111 #if defined(RS_ENABLE_TLS)
112     /* TLS specifics.  */
113     SSL_CTX *tls_ctx;
114     SSL *tls_ssl;
115 #endif
116 };
117
118 enum rs_packet_flags {
119     rs_packet_hdr_read_flag,
120     rs_packet_received_flag,
121     rs_packet_sent_flag,
122 };
123
124 struct rs_packet {
125     struct rs_connection *conn;
126     unsigned int flags;
127     uint8_t hdr[RS_HEADER_LEN];
128     RADIUS_PACKET *rpkt;        /* FreeRADIUS object.  */
129     struct rs_packet *next;     /* Used for UDP output queue.  */
130 };
131
132 #if defined (__cplusplus)
133 }
134 #endif
135
136 /* Convenience macros.  */
137 #define rs_calloc(h, nmemb, size) \
138     (h->alloc_scheme.calloc ? h->alloc_scheme.calloc : calloc)(nmemb, size)
139 #define rs_malloc(h, size) \
140     (h->alloc_scheme.malloc ? h->alloc_scheme.malloc : malloc)(size)
141 #define rs_free(h, ptr) \
142     (h->alloc_scheme.free ? h->alloc_scheme.free : free)(ptr)
143 #define rs_realloc(h, realloc, ptr, size) \
144     (h->alloc_scheme.realloc ? h->alloc_scheme.realloc : realloc)(ptr, size)
145 #define min(a, b) ((a) < (b) ? (a) : (b))
146 #define max(a, b) ((a) > (b) ? (a) : (b))
147
148 /* Local Variables: */
149 /* c-file-style: "stroustrup" */
150 /* End: */