2 @brief Header file for libradsec. */
3 /* See the file COPYING for licensing information. */
14 RSE_CONN_TYPE_MISMATCH = 5,
15 RSE_FR = 6, /* FreeRADIUS error. */
18 RSE_EVENT = 9, /* libevent error. */
23 RSE_SSLERR = 14, /* OpenSSL error. */
25 RSE_TIMEOUT_CONN = 16, /* Connection timeout. */
26 RSE_INVAL = 17, /* Invalid argument. */
27 RSE_TIMEOUT_IO = 18, /* I/O timeout. */
28 RSE_TIMEOUT = 19, /* High level timeout. */
33 RS_CONN_TYPE_NONE = 0,
39 typedef unsigned int rs_conn_type_t;
42 #if defined (__cplusplus)
47 struct rs_context; /* radsec-impl.h */
48 struct rs_connection; /* radsec-impl.h */
49 struct rs_packet; /* radsec-impl.h */
50 struct rs_conn; /* radsec-impl.h */
51 struct rs_attr; /* radsec-impl.h */
52 struct rs_error; /* radsec-impl.h */
53 struct rs_peer; /* radsec-impl.h */
54 struct radius_packet; /* <freeradius/libradius.h> */
55 struct event_base; /* <event2/event-internal.h> */
57 typedef void *(*rs_calloc_fp) (size_t nmemb, size_t size);
58 typedef void *(*rs_malloc_fp) (size_t size);
59 typedef void (*rs_free_fp) (void *ptr);
60 typedef void *(*rs_realloc_fp) (void *ptr, size_t size);
61 struct rs_alloc_scheme {
65 rs_realloc_fp realloc;
68 typedef void (*rs_conn_connected_cb) (void *user_data /* FIXME: peer? */ );
69 typedef void (*rs_conn_disconnected_cb) (void *user_data /* FIXME: reason? */ );
70 typedef void (*rs_conn_packet_received_cb) (struct rs_packet *packet,
72 typedef void (*rs_conn_packet_sent_cb) (void *user_data);
73 struct rs_conn_callbacks {
74 /** Callback invoked when the connection has been established. */
75 rs_conn_connected_cb connected_cb;
76 /** Callback invoked when the connection has been torn down. */
77 rs_conn_disconnected_cb disconnected_cb;
78 /** Callback invoked when a packet was received. */
79 rs_conn_packet_received_cb received_cb;
80 /** Callback invoked when a packet was successfully sent. */
81 rs_conn_packet_sent_cb sent_cb;
85 /* Function prototypes. */
87 int rs_context_create(struct rs_context **ctx, const char *dict);
88 void rs_context_destroy(struct rs_context *ctx);
89 int rs_context_set_alloc_scheme(struct rs_context *ctx,
90 struct rs_alloc_scheme *scheme);
91 int rs_context_read_config(struct rs_context *ctx, const char *config_file);
94 int rs_conn_create(struct rs_context *ctx,
95 struct rs_connection **conn,
97 void rs_conn_set_type(struct rs_connection *conn, rs_conn_type_t type);
98 int rs_conn_add_listener(struct rs_connection *conn,
100 const char *hostname,
102 int rs_conn_disconnect (struct rs_connection *conn);
103 int rs_conn_destroy(struct rs_connection *conn);
104 int rs_conn_set_eventbase(struct rs_connection *conn, struct event_base *eb);
105 void rs_conn_set_callbacks(struct rs_connection *conn,
106 struct rs_conn_callbacks *cb);
107 void rs_conn_del_callbacks(struct rs_connection *conn);
108 struct rs_conn_callbacks *rs_conn_get_callbacks(struct rs_connection *conn);
109 int rs_conn_select_peer(struct rs_connection *conn, const char *name);
110 int rs_conn_get_current_peer(struct rs_connection *conn,
113 int rs_conn_receive_packet(struct rs_connection *conn,
114 struct rs_packet *request,
115 struct rs_packet **pkt_out);
116 int rs_conn_fd(struct rs_connection *conn);
117 void rs_conn_set_timeout(struct rs_connection *conn, struct timeval *tv);
119 /* Peer -- client and server. */
120 int rs_peer_create(struct rs_connection *conn, struct rs_peer **peer_out);
121 int rs_peer_set_address(struct rs_peer *peer, const char *hostname,
122 const char *service);
123 int rs_peer_set_secret(struct rs_peer *peer, const char *secret);
124 void rs_peer_set_timeout(struct rs_peer *peer, int timeout);
125 void rs_peer_set_retries(struct rs_peer *peer, int retries);
128 int rs_packet_create(struct rs_connection *conn, struct rs_packet **pkt_out);
129 void rs_packet_destroy(struct rs_packet *pkt);
130 void rs_packet_add_attr(struct rs_packet *pkt, struct rs_attr *attr);
131 int rs_packet_send(struct rs_packet *pkt, void *user_data);
132 struct radius_packet *rs_packet_frpkt(struct rs_packet *pkt);
133 int rs_packet_create_authn_request(struct rs_connection *conn,
134 struct rs_packet **pkt,
135 const char *user_name,
136 const char *user_pw);
139 /* FIXME: Replace (or complement) with a wrapper for paircreate(). */
140 int rs_attr_create(struct rs_connection *conn,
141 struct rs_attr **attr,
144 void rs_attr_destroy(struct rs_attr *attr);
147 struct rs_realm *rs_conf_find_realm(struct rs_context *ctx, const char *name);
150 int rs_err_ctx_push(struct rs_context *ctx, int code, const char *fmt, ...);
151 int rs_err_ctx_push_fl(struct rs_context *ctx,
157 struct rs_error *rs_err_ctx_pop(struct rs_context *ctx);
158 int rs_err_conn_push(struct rs_connection *conn,
162 int rs_err_conn_push_fl(struct rs_connection *conn,
168 struct rs_error *rs_err_conn_pop(struct rs_connection *conn);
169 int rs_err_conn_peek_code (struct rs_connection *conn);
170 void rs_err_free(struct rs_error *err);
171 char *rs_err_msg(struct rs_error *err);
172 int rs_err_code(struct rs_error *err, int dofree_flag);
174 #if defined (__cplusplus)
178 /* Local Variables: */
179 /* c-file-style: "stroustrup" */