summaryrefslogtreecommitdiff
path: root/lib/include/radsec/request.h
blob: ef422b533ecf0de502d80ee40a078e338218dfbe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
/** \file request.h
    \brief Public interface for libradsec request's.  */

/* See the file COPYING for licensing information.  */

struct rs_request;

#if defined (__cplusplus)
extern "C" {
#endif

/** Create a request associated with connection \a conn.  */
int rs_request_create(struct rs_connection *conn, struct rs_request **req_out);
/** Add RADIUS request message \a req_msg to request \a req.  */
void rs_request_add_reqpkt(struct rs_request *req, struct rs_packet *req_msg);

/** Create a request associated with connection \a conn containing a
    RADIUS authentication message with \a user_name and \a user_pw
    attributes.  \a user_name and _user_pw are optional and can be
    NULL.  */
int rs_request_create_authn(struct rs_connection *conn,
			    struct rs_request **req_out,
			    const char *user_name,
			    const char *user_pw);
/** Send request \a req and wait for a matching response.  The
    response is put in \a resp_msg (if not NULL).  NOTE: At present,
    no more than one outstanding request to a given realm is
    supported.  This will change in a future version.  */
int rs_request_send(struct rs_request *req, struct rs_packet **resp_msg);

/** Free all memory allocated by request \a req including the request
    packet and any response package associated with the request.  Note
    that a request must be freed before its associated connection can
    be freed.  */
void rs_request_destroy(struct rs_request *req);

#if defined (__cplusplus)
}
#endif