2 * util.c Various utility functions.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20 * Copyright 2000,2006 The FreeRADIUS server project
23 #include <freeradius-devel/ident.h>
26 #include <freeradius-devel/radiusd.h>
27 #include <freeradius-devel/rad_assert.h>
36 * The signal() function in Solaris 2.5.1 sets SA_NODEFER in
37 * sa_flags, which causes grief if signal() is called in the
38 * handler before the cause of the signal has been cleared.
39 * (Infinite recursion).
41 * The same problem appears on HPUX, so we avoid it, if we can.
43 * Using sigaction() to reset the signal handler fixes the problem,
44 * so where available, we prefer that solution.
47 void (*reset_signal(int signo, void (*func)(int)))(int)
50 struct sigaction act, oact;
52 act.sa_handler = func;
53 sigemptyset(&act.sa_mask);
55 #ifdef SA_INTERRUPT /* SunOS */
56 act.sa_flags |= SA_INTERRUPT;
58 if (sigaction(signo, &act, &oact) < 0)
60 return oact.sa_handler;
64 * re-set by calling the 'signal' function, which
65 * may cause infinite recursion and core dumps due to
68 * However, the system is too dumb to implement sigaction(),
69 * so we don't have a choice.
78 * Per-request data, added by modules...
80 struct request_data_t {
86 void (*free_opaque)(void *);
90 * Add opaque data (with a "free" function) to a REQUEST.
92 * The unique ptr is meant to be a malloc'd module configuration,
93 * and the unique integer allows the caller to have multiple
94 * opaque data associated with a REQUEST.
96 int request_data_add(REQUEST *request,
97 void *unique_ptr, int unique_int,
98 void *opaque, void (*free_opaque)(void *))
100 request_data_t *this, **last, *next;
103 * Some simple sanity checks.
105 if (!request || !opaque) return -1;
108 for (last = &(request->data); *last != NULL; last = &((*last)->next)) {
109 if (((*last)->unique_ptr == unique_ptr) &&
110 ((*last)->unique_int == unique_int)) {
115 if (this->opaque && /* free it, if necessary */
117 this->free_opaque(this->opaque);
118 break; /* replace the existing entry */
122 if (!this) this = rad_malloc(sizeof(*this));
123 memset(this, 0, sizeof(*this));
126 this->unique_ptr = unique_ptr;
127 this->unique_int = unique_int;
128 this->opaque = opaque;
129 this->free_opaque = free_opaque;
138 * Get opaque data from a request.
140 void *request_data_get(REQUEST *request,
141 void *unique_ptr, int unique_int)
143 request_data_t **last;
145 for (last = &(request->data); *last != NULL; last = &((*last)->next)) {
146 if (((*last)->unique_ptr == unique_ptr) &&
147 ((*last)->unique_int == unique_int)) {
148 request_data_t *this = *last;
149 void *ptr = this->opaque;
152 * Remove the entry from the list, and free it.
156 return ptr; /* don't free it, the caller does that */
160 return NULL; /* wasn't found, too bad... */
165 * Get opaque data from a request without removing it.
167 void *request_data_reference(REQUEST *request,
168 void *unique_ptr, int unique_int)
170 request_data_t **last;
172 for (last = &(request->data); *last != NULL; last = &((*last)->next)) {
173 if (((*last)->unique_ptr == unique_ptr) &&
174 ((*last)->unique_int == unique_int)) {
175 request_data_t *this = *last;
176 void *ptr = this->opaque;
182 return NULL; /* wasn't found, too bad... */
187 * Free a REQUEST struct.
189 void request_free(REQUEST **request_ptr)
193 if ((request_ptr == NULL) || !*request_ptr)
196 request = *request_ptr;
199 rad_free(&request->packet);
202 rad_free(&request->proxy);
205 rad_free(&request->reply);
207 if (request->proxy_reply)
208 rad_free(&request->proxy_reply);
210 if (request->config_items)
211 pairfree(&request->config_items);
213 request->username = NULL;
214 request->password = NULL;
217 request_data_t *this, *next;
219 for (this = request->data; this != NULL; this = next) {
221 if (this->opaque && /* free it, if necessary */
223 this->free_opaque(this->opaque);
226 request->data = NULL;
230 (request->root->refcount > 0)) {
231 request->root->refcount--;
232 request->root = NULL;
236 request->magic = 0x01020304; /* set the request to be nonsense */
238 request->client = NULL;
239 request->home_server = NULL;
246 * Check a filename for sanity.
248 * Allow only uppercase/lowercase letters, numbers, and '-_/.'
250 int rad_checkfilename(const char *filename)
252 if (strspn(filename, "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_/.") == strlen(filename)) {
260 * Create possibly many directories.
262 * Note that the input directory name is NOT a constant!
263 * This is so that IF an error is returned, the 'directory' ptr
264 * points to the name of the file which caused the error.
266 int rad_mkdir(char *directory, int mode)
273 * If the directory exists, don't do anything.
275 if (stat(directory, &st) == 0) {
280 * Look for the LAST directory name. Try to create that,
281 * failing on any error.
283 p = strrchr(directory, FR_DIR_SEP);
286 rcode = rad_mkdir(directory, mode);
289 * On error, we leave the directory name as the
290 * one which caused the error.
297 * Reset the directory delimiter, and go ask
298 * the system to make the directory.
306 * Having done everything successfully, we do the
307 * system call to actually go create the directory.
309 return mkdir(directory, mode);
314 * Module malloc() call, which does stuff if the malloc fails.
316 * This call ALWAYS succeeds!
318 void *rad_malloc(size_t size)
320 void *ptr = malloc(size);
323 radlog(L_ERR|L_CONS, "no memory");
331 * Logs an error message and aborts the program
335 void NEVER_RETURNS rad_assert_fail (const char *file, unsigned int line,
338 radlog(L_ERR, "ASSERT FAILED %s[%u]: %s", file, line, expr);
344 * Create a new REQUEST data structure.
346 REQUEST *request_alloc(void)
350 request = rad_malloc(sizeof(REQUEST));
351 memset(request, 0, sizeof(REQUEST));
353 request->magic = REQUEST_MAGIC;
355 request->proxy = NULL;
356 request->reply = NULL;
357 request->proxy_reply = NULL;
358 request->config_items = NULL;
359 request->username = NULL;
360 request->password = NULL;
361 request->timestamp = time(NULL);
362 request->child_pid = NO_SUCH_CHILD_PID;
363 request->options = RAD_REQUEST_OPTION_NONE;
370 * Create a new REQUEST, based on an old one.
372 * This function allows modules to inject fake requests
373 * into the server, for tunneled protocols like TTLS & PEAP.
375 REQUEST *request_alloc_fake(REQUEST *request)
379 fake = request_alloc();
381 fake->number = request->number;
382 fake->child_pid = NO_SUCH_CHILD_PID;
383 fake->parent = request;
384 fake->root = request->root;
385 fake->client = request->client;
388 * For new server support.
390 * FIXME: Key instead off of a "virtual server" data structure.
392 * FIXME: Permit different servers for inner && outer sessions?
394 fake->server = request->server;
396 fake->packet = rad_alloc(0);
402 fake->reply = rad_alloc(0);
408 fake->master_state = REQUEST_ACTIVE;
409 fake->child_state = REQUEST_RUNNING;
412 * Fill in the fake request.
414 fake->packet->sockfd = -1;
415 fake->packet->src_ipaddr = request->packet->src_ipaddr;
416 fake->packet->src_port = request->packet->src_port;
417 fake->packet->dst_ipaddr = request->packet->dst_ipaddr;
418 fake->packet->dst_port = 0;
421 * This isn't STRICTLY required, as the fake request MUST NEVER
422 * be put into the request list. However, it's still reasonable
425 fake->packet->id = fake->number & 0xff;
426 fake->packet->code = request->packet->code;
427 fake->timestamp = request->timestamp;
430 * Required for new identity support
432 fake->listener = request->listener;
435 * Fill in the fake reply, based on the fake request.
437 fake->reply->sockfd = fake->packet->sockfd;
438 fake->reply->src_ipaddr = fake->packet->dst_ipaddr;
439 fake->reply->src_port = fake->packet->dst_port;
440 fake->reply->dst_ipaddr = fake->packet->src_ipaddr;
441 fake->reply->dst_port = fake->packet->src_port;
442 fake->reply->id = fake->packet->id;
443 fake->reply->code = 0; /* UNKNOWN code */
450 * Copy a quoted string.
452 int rad_copy_string(char *to, const char *from)
464 } while (*from && (*from != quote));
466 if (*from != quote) return -1; /* not properly quoted */
479 int rad_copy_variable(char *to, const char *from)
491 sublen = rad_copy_string(to, from);
492 if (sublen < 0) return sublen;
497 case '}': /* end of variable expansion */
501 return length; /* proper end of variable */
509 case '%': /* start of variable expansion */
510 if (from[1] == '{') {
514 sublen = rad_copy_variable(to, from);
515 if (sublen < 0) return sublen;
519 } /* else FIXME: catch %%{ ?*/
529 } /* loop over the input string */
532 * We ended the string before a trailing '}'