2 @brief Header file for libradsec. */
3 /* See the file COPYING for licensing information. */
13 RSE_CONN_TYPE_MISMATCH = 5,
23 RS_CONN_TYPE_NONE = 0,
29 typedef unsigned int rs_conn_type_t;
33 struct rs_handle; /* radsec-impl.h */
34 struct rs_connection; /* radsec-impl.h */
35 struct rs_packet; /* radsec-impl.h */
36 struct rs_conn; /* radsec-impl.h */
37 struct rs_attr; /* radsec-impl.h */
38 struct rs_error; /* radsec-impl.h */
39 struct rs_peer; /* radsec-impl.h */
40 struct event_base; /* <event.h> */
42 typedef void * (*rs_calloc_fp)(size_t nmemb, size_t size);
43 typedef void * (*rs_malloc_fp)(size_t size);
44 typedef void (*rs_free_fp)(void *ptr);
45 typedef void * (*rs_realloc_fp)(void *ptr, size_t size);
46 struct rs_alloc_scheme {
50 rs_realloc_fp realloc;
53 typedef void (*rs_conn_connected_cb)(void *user_data /* FIXME: peer? */);
54 typedef void (*rs_conn_disconnected_cb)(void *user_data /* FIXME: reason? */);
55 typedef void (*rs_conn_packet_received_cb)(const struct rs_packet *packet,
57 typedef void (*rs_conn_packet_sent_cb)(void *user_data);
58 struct rs_conn_callbacks {
59 /** Callback invoked when the connection has been established. */
60 rs_conn_connected_cb connected_cb;
61 /** Callback invoked when the connection has been torn down. */
62 rs_conn_disconnected_cb disconnected_cb;
63 /** Callback invoked when a packet was received. */
64 rs_conn_packet_received_cb received_cb;
65 /** Callback invoked when a packet was successfully sent. */
66 rs_conn_packet_sent_cb sent_cb;
69 /* Function prototypes. */
70 int rs_context_create(struct rs_handle **ctx, const char *dict);
71 void rs_context_destroy(struct rs_handle *ctx);
72 int rs_context_set_alloc_scheme(struct rs_handle *ctx, struct rs_alloc_scheme *scheme);
73 int rs_context_config_read(struct rs_handle *ctx, const char *config_file);
75 int rs_conn_create(struct rs_handle *ctx, struct rs_connection **conn);
76 int rs_conn_add_server(struct rs_connection *conn, struct rs_peer **server, rs_conn_type_t type, const char *hostname, int port);
77 int rs_conn_add_listener(struct rs_connection *conn, rs_conn_type_t type, const char *hostname, int port);
78 void rs_conn_destroy(struct rs_connection *conn);
79 int rs_conn_set_eventbase(struct rs_connection *conn, struct event_base *eb);
80 int rs_conn_set_callbacks(struct rs_connection *conn, struct rs_conn_callbacks *cb);
81 int rs_conn_select_server(struct rs_connection *conn, const char *name);
82 int rs_conn_get_current_server(struct rs_connection *conn, const char *name, size_t buflen);
84 void rs_server_set_timeout(struct rs_peer *server, int timeout);
85 void rs_server_set_tries(struct rs_peer *server, int tries);
86 int rs_server_set_secret(struct rs_peer *server, const char *secret);
88 int rs_packet_create_acc_request(struct rs_connection *conn, struct rs_packet **pkt, const char *user_name, const char *user_pw);
89 //int rs_packet_create_acc_accept(cstruct rs_connection *conn, struct rs_packet **pkt);
90 //int rs_packet_create_acc_reject(struct rs_connection *conn, struct rs_packet **pkt);
91 //int rs_packet_create_acc_challenge(struct rs_connection *conn, struct rs_packet **pkt);
92 void rs_packet_destroy(struct rs_packet *pkt);
93 void rs_packet_add_attr(struct rs_packet *pkt, struct rs_attr *attr);
94 //int rs_packet_add_new_attr(struct rs_packet *pkt, const char *attr_name, const char *attr_val);
96 int rs_attr_create(struct rs_connection *conn, struct rs_attr **attr, const char *type, const char *val);
97 void rs_attr_destroy(struct rs_attr *attr);
99 int rs_packet_send(struct rs_connection *conn, struct rs_packet *pkt, void *data);
100 int rs_packet_receive(struct rs_connection *conn, struct rs_packet **pkt_out);
102 int rs_ctx_err_push(struct rs_handle *ctx, int code, const char *fmt, ...);
103 int rs_ctx_err_push_fl(struct rs_handle *ctx, int code, const char *file, int line, const char *fmt, ...);
104 struct rs_error *rs_ctx_err_pop (struct rs_handle *ctx);
105 int rs_conn_err_push(struct rs_connection *conn, int code, const char *fmt, ...);
106 int rs_conn_err_push_fl(struct rs_connection *conn, int code, const char *file, int line, const char *fmt, ...);
107 struct rs_error *rs_conn_err_pop (struct rs_connection *conn);
108 void rs_err_free(struct rs_error *err);
109 char *rs_err_msg(struct rs_error *err, int dofree_flag);
110 int rs_err_code(struct rs_error *err, int dofree_flag);
112 /* Local Variables: */
113 /* c-file-style: "stroustrup" */