4 * radiusd.h Structures, prototypes and global variables
5 * for the FreeRADIUS server.
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 * Copyright 1999,2000,2002,2003,2004,2005,2006,2007,2008 The FreeRADIUS server project
27 #include <freeradius-devel/ident.h>
28 RCSIDH(radiusd_h, "$Id$")
30 #include <freeradius-devel/libradius.h>
31 #include <freeradius-devel/radpaths.h>
32 #include <freeradius-devel/conf.h>
33 #include <freeradius-devel/conffile.h>
34 #include <freeradius-devel/event.h>
36 typedef struct auth_req REQUEST;
38 #include <freeradius-devel/realms.h>
42 typedef pthread_t child_pid_t;
43 #define child_kill pthread_kill
45 typedef pid_t child_pid_t;
46 #define child_kill kill
49 #define NO_SUCH_CHILD_PID (child_pid_t) (0)
52 #define REQUEST_MAGIC (0xdeadbeef)
58 typedef struct request_data_t request_data_t;
60 typedef struct rad_snmp_client_entry_t rad_snmp_client_entry_t;
62 typedef struct radclient {
68 int message_authenticator;
73 int number; /* internal use only */
74 const CONF_SECTION *cs;
76 rad_snmp_client_entry_t *auth, *acct;
83 * Ordered by priority!
85 typedef enum RAD_LISTEN_TYPE {
99 * For listening on multiple IP's and ports.
101 typedef struct rad_listen_t rad_listen_t;
103 #define REQUEST_DATA_REGEX (0xadbeef00)
104 #define REQUEST_MAX_REGEX (8)
108 uint32_t magic; /* for debugging only */
110 RADIUS_PACKET *packet;
111 RADIUS_PACKET *proxy;
112 RADIUS_PACKET *reply;
113 RADIUS_PACKET *proxy_reply;
114 VALUE_PAIR *config_items;
115 VALUE_PAIR *username;
116 VALUE_PAIR *password;
118 struct main_config_t *root;
120 request_data_t *data;
122 child_pid_t child_pid;
124 int number; /* internal server number */
126 rad_listen_t *listener;
127 rad_listen_t *proxy_listener;
131 int simul_mpp; /* WEIRD: 1 is false, 2 is true */
133 int options; /* miscellanous options */
134 const char *module; /* for debugging unresponsive children */
135 const char *component; /* ditto */
137 struct timeval received;
138 struct timeval when; /* to wake up */
143 RAD_LISTEN_TYPE priority;
146 struct timeval next_when;
147 fr_event_callback_t next_callback;
152 home_server *home_server;
153 home_pool_t *home_pool; /* for dynamic failover */
155 struct timeval proxy_when;
157 int num_proxied_requests;
158 int num_proxied_responses;
162 }; /* REQUEST typedef */
164 #define RAD_REQUEST_OPTION_NONE (0)
166 #define REQUEST_ACTIVE (1)
167 #define REQUEST_STOP_PROCESSING (2)
168 #define REQUEST_COUNTED (3)
170 #define REQUEST_QUEUED (1)
171 #define REQUEST_RUNNING (2)
172 #define REQUEST_PROXIED (3)
173 #define REQUEST_REJECT_DELAY (4)
174 #define REQUEST_CLEANUP_DELAY (5)
175 #define REQUEST_DONE (6)
178 * Function handler for requests.
180 typedef int (*RAD_REQUEST_FUNP)(REQUEST *);
182 typedef struct radclient_list RADCLIENT_LIST;
184 typedef struct pair_list {
190 struct pair_list *next;
191 struct pair_list *lastdefault;
195 typedef int (*rad_listen_recv_t)(rad_listen_t *, RAD_REQUEST_FUNP *, REQUEST **);
196 typedef int (*rad_listen_send_t)(rad_listen_t *, REQUEST *);
197 typedef int (*rad_listen_print_t)(rad_listen_t *, char *, size_t);
198 typedef int (*rad_listen_encode_t)(rad_listen_t *, REQUEST *);
199 typedef int (*rad_listen_decode_t)(rad_listen_t *, REQUEST *);
201 struct rad_listen_t {
202 struct rad_listen_t *next; /* should be rbtree stuff */
205 * For normal sockets.
207 RAD_LISTEN_TYPE type;
211 rad_listen_recv_t recv;
212 rad_listen_send_t send;
213 rad_listen_encode_t encode;
214 rad_listen_decode_t decode;
215 rad_listen_print_t print;
221 typedef enum radlog_dest_t {
230 typedef struct main_config_t {
231 struct main_config *next;
233 fr_ipaddr_t myip; /* from the command-line only */
234 int port; /* from the command-line only */
236 int log_auth_badpass;
237 int log_auth_goodpass;
238 int allow_core_dumps;
243 int max_request_time;
246 #ifdef DELETE_BLOCKED_REQUESTS
247 int kill_unresponsive_children;
251 const char *pid_file;
252 rad_listen_t *listen;
255 radlog_dest_t radlog_dest;
256 CONF_SECTION *config;
261 #define DEBUG if(debug_flag)log_debug
262 #define DEBUG2 if (debug_flag > 1)log_debug
263 #define DEBUG3 if (debug_flag > 2)log_debug
265 #define SECONDS_PER_DAY 86400
266 #define MAX_REQUEST_TIME 30
267 #define CLEANUP_DELAY 5
268 #define MAX_REQUESTS 256
269 #define RETRY_DELAY 5
270 #define RETRY_COUNT 3
271 #define DEAD_TIME 120
286 * This definition of true as NOT false is definitive. :) Making
287 * it '1' can cause problems on stupid platforms. See articles
288 * on C portability for more information.
290 #define TRUE (!FALSE)
293 /* for paircompare_register */
294 typedef int (*RAD_COMPARE_FUNC)(void *instance, REQUEST *,VALUE_PAIR *, VALUE_PAIR *, VALUE_PAIR *, VALUE_PAIR **);
296 typedef enum request_fail_t {
297 REQUEST_FAIL_UNKNOWN = 0,
298 REQUEST_FAIL_NO_THREADS, /* no threads to handle it */
299 REQUEST_FAIL_DECODE, /* rad_decode didn't like it */
300 REQUEST_FAIL_PROXY, /* call to proxy modules failed */
301 REQUEST_FAIL_PROXY_SEND, /* proxy_send didn't like it */
302 REQUEST_FAIL_NO_RESPONSE, /* we weren't told to respond, so we reject */
303 REQUEST_FAIL_HOME_SERVER, /* the home server didn't respond */
304 REQUEST_FAIL_HOME_SERVER2, /* another case of the above */
305 REQUEST_FAIL_HOME_SERVER3, /* another case of the above */
306 REQUEST_FAIL_NORMAL_REJECT, /* authentication failure */
307 REQUEST_FAIL_SERVER_TIMEOUT /* the server took too long to process the request */
313 * We really shouldn't have this many.
315 extern const char *progname;
316 extern int debug_flag;
317 extern const char *radacct_dir;
318 extern const char *radlog_dir;
319 extern const char *radlib_dir;
320 extern const char *radius_dir;
321 extern const char *radius_libdir;
322 extern uint32_t expiration_seconds;
323 extern int log_stripped_names;
324 extern int log_auth_detail;
325 extern const char *radiusd_version;
326 void radius_signal_self(int flag);
328 #define RADIUS_SIGNAL_SELF_NONE (0)
329 #define RADIUS_SIGNAL_SELF_HUP (1 << 0)
330 #define RADIUS_SIGNAL_SELF_TERM (1 << 1)
331 #define RADIUS_SIGNAL_SELF_EXIT (1 << 2)
332 #define RADIUS_SIGNAL_SELF_DETAIL (1 << 3)
333 #define RADIUS_SIGNAL_SELF_NEW_FD (1 << 4)
334 #define RADIUS_SIGNAL_SELF_MAX (1 << 5)
338 * Function prototypes.
342 int rad_accounting(REQUEST *);
345 int rad_check_ts(uint32_t nasaddr, unsigned int port, const char *user,
346 const char *sessionid);
347 int session_zap(REQUEST *request, uint32_t nasaddr,
348 unsigned int port, const char *user,
349 const char *sessionid, uint32_t cliaddr,
350 char proto,int session_time);
354 void debug_pair(VALUE_PAIR *);
355 void debug_pair_list(VALUE_PAIR *);
356 int log_err (char *);
359 void (*reset_signal(int signo, void (*func)(int)))(int);
360 void request_free(REQUEST **request);
361 int rad_mkdir(char *directory, int mode);
362 int rad_checkfilename(const char *filename);
363 void *rad_malloc(size_t size); /* calls exit(1) on error! */
364 REQUEST *request_alloc(void);
365 REQUEST *request_alloc_fake(REQUEST *oldreq);
366 int request_data_add(REQUEST *request,
367 void *unique_ptr, int unique_int,
368 void *opaque, void (*free_opaque)(void *));
369 void *request_data_get(REQUEST *request,
370 void *unique_ptr, int unique_int);
371 void *request_data_reference(REQUEST *request,
372 void *unique_ptr, int unique_int);
373 int rad_copy_string(char *dst, const char *src);
374 int rad_copy_variable(char *dst, const char *from);
377 RADCLIENT_LIST *clients_init(void);
378 void clients_free(RADCLIENT_LIST *clients);
379 RADCLIENT_LIST *clients_parse_section(CONF_SECTION *section);
380 void client_free(RADCLIENT *client);
381 int client_add(RADCLIENT_LIST *clients, RADCLIENT *client);
382 RADCLIENT *client_find(const RADCLIENT_LIST *clients,
383 const fr_ipaddr_t *ipaddr);
384 RADCLIENT *client_findbynumber(const RADCLIENT_LIST *clients,
386 RADCLIENT *client_find_old(const fr_ipaddr_t *ipaddr);
389 int pairlist_read(const char *file, PAIR_LIST **list, int complain);
390 void pairlist_free(PAIR_LIST **);
396 int vradlog(int, const char *, va_list ap);
397 int radlog(int, const char *, ...)
399 __attribute__ ((format (printf, 2, 3)))
402 int log_debug(const char *, ...)
404 __attribute__ ((format (printf, 1, 2)))
407 void vp_listdebug(VALUE_PAIR *vp);
410 char *auth_name(char *buf, size_t buflen, REQUEST *request, int do_cli);
411 int rad_authenticate (REQUEST *);
412 int rad_postauth(REQUEST *);
415 int radius_exec_program(const char *, REQUEST *, int,
416 char *user_msg, int msg_len,
417 VALUE_PAIR *input_pairs,
418 VALUE_PAIR **output_pairs,
422 int timestr_match(char *, time_t);
425 int paircompare_register(int attr, int otherattr,
426 RAD_COMPARE_FUNC func,
428 void paircompare_unregister(int attr, RAD_COMPARE_FUNC func);
429 int paircompare(REQUEST *req, VALUE_PAIR *request, VALUE_PAIR *check,
431 void pairxlatmove(REQUEST *, VALUE_PAIR **to, VALUE_PAIR **from);
432 int radius_compare_vps(REQUEST *request, VALUE_PAIR *check, VALUE_PAIR *vp);
433 int radius_callback_compare(REQUEST *req, VALUE_PAIR *request,
434 VALUE_PAIR *check, VALUE_PAIR *check_pairs,
435 VALUE_PAIR **reply_pairs);
436 VALUE_PAIR *radius_paircreate(REQUEST *request, VALUE_PAIR **vps,
437 int attribute, int type);
438 VALUE_PAIR *radius_pairmake(REQUEST *request, VALUE_PAIR **vps,
439 const char *attribute, const char *value,
443 typedef size_t (*RADIUS_ESCAPE_STRING)(char *out, size_t outlen, const char *in);
445 int radius_xlat(char * out, int outlen, const char *fmt,
446 REQUEST * request, RADIUS_ESCAPE_STRING func);
447 typedef size_t (*RAD_XLAT_FUNC)(void *instance, REQUEST *, char *, char *, size_t, RADIUS_ESCAPE_STRING func);
448 int xlat_register(const char *module, RAD_XLAT_FUNC func,
450 void xlat_unregister(const char *module, RAD_XLAT_FUNC func);
451 void xlat_free(void);
454 extern int thread_pool_init(CONF_SECTION *cs, int spawn_flag);
455 extern int thread_pool_addrequest(REQUEST *, RAD_REQUEST_FUNP);
456 extern pid_t rad_fork(void);
457 extern pid_t rad_waitpid(pid_t pid, int *status);
458 extern int total_active_threads(void);
459 extern void thread_pool_lock(void);
460 extern void thread_pool_unlock(void);
462 #ifndef HAVE_PTHREAD_H
463 #define rad_fork(n) fork()
464 #define rad_waitpid(a,b) waitpid(a,b, 0)
468 /* Define a global config structure */
469 extern struct main_config_t mainconfig;
471 int read_mainconfig(int reload);
472 int free_mainconfig(void);
475 void listen_free(rad_listen_t **head);
476 int listen_init(CONF_SECTION *cs, rad_listen_t **head);
477 rad_listen_t *proxy_new_listener(void);
478 RADCLIENT *client_listener_find(const rad_listen_t *listener,
479 const fr_ipaddr_t *ipaddr);
482 int radius_event_init(CONF_SECTION *cs, int spawn_flag);
483 void radius_event_free(void);
484 int radius_event_process(void);
485 void radius_handle_request(REQUEST *request, RAD_REQUEST_FUNP fun);
486 int received_request(rad_listen_t *listener,
487 RADIUS_PACKET *packet, REQUEST **prequest,
489 REQUEST *received_proxy_response(RADIUS_PACKET *packet);
492 int radius_evaluate_condition(REQUEST *request, int modreturn, int depth,
493 const char **ptr, int evaluate_it, int *presult);
494 int radius_update_attrlist(REQUEST *request, CONF_SECTION *cs,
495 VALUE_PAIR *input_vps, const char *name);
496 void radius_pairmove(REQUEST *request, VALUE_PAIR **to, VALUE_PAIR *from);