blob: f0151f8243ec919d2353de859456426e14aba95c (
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
40
41
42
43
44
45
46
47
48
49
50
51
52
|
/** \file request.h
\brief Public interface for libradsec request's. */
/* See LICENSE for licensing information. */
#ifndef _RADSEC_REQUEST_H_
#define _RADSEC_REQUEST_H_ 1
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.
FIXME: Rename to rs_request_add_reqmsg? */
void rs_request_add_reqpkt(struct rs_request *req, struct rs_packet *req_msg);
/** Create a request associated with connection \a conn containing a
newly created RADIUS authentication message, possibly with
\a user_name and \a user_pw attributes. \a user_name and \a user_pw
are optional and can be NULL. If \a user_name and \a user_pw are provided,
\a secret must also be provided. \a secret is used for "hiding" the
password. */
int rs_request_create_authn(struct rs_connection *conn,
struct rs_request **req_out,
const char *user_name,
const char *user_pw,
const char *secret);
/** 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 any request
packet 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);
/** Return request message in request \a req. */
struct rs_packet *rs_request_get_reqmsg(const struct rs_request *req);
#if defined (__cplusplus)
}
#endif
#endif /* _RADSEC_REQUEST_H_ */
|
