Add documentation for RADIUS code and some minor cleanup

This commit is contained in:
Jouni Malinen 2009-12-19 16:13:06 +02:00
parent a9f92c487f
commit d04a96b0d6
2 changed files with 54 additions and 25 deletions

View File

@ -1,6 +1,6 @@
/* /*
* hostapd / RADIUS message processing * RADIUS message processing
* Copyright (c) 2002-2008, Jouni Malinen <j@w1.fi> * Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi>
* *
* This program is free software; you can redistribute it and/or modify * This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as * it under the terms of the GNU General Public License version 2 as
@ -12,12 +12,15 @@
* See README and COPYING for more details. * See README and COPYING for more details.
*/ */
#include "includes.h" #include "utils/includes.h"
#include "common.h" #include "utils/common.h"
#include "radius.h"
#include "crypto/md5.h" #include "crypto/md5.h"
#include "crypto/crypto.h" #include "crypto/crypto.h"
#include "radius.h"
static int radius_msg_initialize(struct radius_msg *msg, size_t init_len);
static struct radius_attr_hdr * static struct radius_attr_hdr *
@ -27,6 +30,13 @@ radius_get_attr_hdr(struct radius_msg *msg, int idx)
} }
static void radius_msg_set_hdr(struct radius_msg *msg, u8 code, u8 identifier)
{
msg->hdr->code = code;
msg->hdr->identifier = identifier;
}
struct radius_msg *radius_msg_new(u8 code, u8 identifier) struct radius_msg *radius_msg_new(u8 code, u8 identifier)
{ {
struct radius_msg *msg; struct radius_msg *msg;
@ -46,7 +56,7 @@ struct radius_msg *radius_msg_new(u8 code, u8 identifier)
} }
int radius_msg_initialize(struct radius_msg *msg, size_t init_len) static int radius_msg_initialize(struct radius_msg *msg, size_t init_len)
{ {
if (msg == NULL || init_len < sizeof(struct radius_hdr)) if (msg == NULL || init_len < sizeof(struct radius_hdr))
return -1; return -1;
@ -76,13 +86,6 @@ int radius_msg_initialize(struct radius_msg *msg, size_t init_len)
} }
void radius_msg_set_hdr(struct radius_msg *msg, u8 code, u8 identifier)
{
msg->hdr->code = code;
msg->hdr->identifier = identifier;
}
void radius_msg_free(struct radius_msg *msg) void radius_msg_free(struct radius_msg *msg)
{ {
os_free(msg->buf); os_free(msg->buf);

View File

@ -1,6 +1,6 @@
/* /*
* hostapd / RADIUS message processing * RADIUS message processing
* Copyright (c) 2002-2007, Jouni Malinen <j@w1.fi> * Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi>
* *
* This program is free software; you can redistribute it and/or modify * This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as * it under the terms of the GNU General Public License version 2 as
@ -173,19 +173,47 @@ struct radius_ms_mppe_keys {
}; };
/* RADIUS message structure for new and parsed messages */ /**
* struct radius_msg - RADIUS message structure for new and parsed messages
*/
struct radius_msg { struct radius_msg {
/**
* buf - Allocated buffer for RADIUS message
*/
unsigned char *buf; unsigned char *buf;
size_t buf_size; /* total size allocated for buf */
size_t buf_used; /* bytes used in buf */
/**
* buf_size - Total size of the allocated buf in octets
*/
size_t buf_size;
/**
* buf_used - bytes used in buf
*/
size_t buf_used;
/**
* hdr - Pointer to the RADIUS header in buf
*/
struct radius_hdr *hdr; struct radius_hdr *hdr;
size_t *attr_pos; /* array of indexes to attributes (number of bytes /**
* from buf to the beginning of * attr_pos - Array of indexes to attributes
* struct radius_attr_hdr). */ *
size_t attr_size; /* total size of the attribute pointer array */ * The values are number of bytes from buf to the beginning of
size_t attr_used; /* total number of attributes in the array */ * struct radius_attr_hdr.
*/
size_t *attr_pos;
/**
* attr_size - Total size of the attribute pointer array
*/
size_t attr_size;
/**
* attr_used - Total number of attributes in the array
*/
size_t attr_used;
}; };
@ -203,8 +231,6 @@ struct radius_msg {
#define RADIUS_ADDR_FORMAT "%02x%02x%02x%02x%02x%02x" #define RADIUS_ADDR_FORMAT "%02x%02x%02x%02x%02x%02x"
struct radius_msg *radius_msg_new(u8 code, u8 identifier); struct radius_msg *radius_msg_new(u8 code, u8 identifier);
int radius_msg_initialize(struct radius_msg *msg, size_t init_len);
void radius_msg_set_hdr(struct radius_msg *msg, u8 code, u8 identifier);
void radius_msg_free(struct radius_msg *msg); void radius_msg_free(struct radius_msg *msg);
void radius_msg_dump(struct radius_msg *msg); void radius_msg_dump(struct radius_msg *msg);
int radius_msg_finish(struct radius_msg *msg, const u8 *secret, int radius_msg_finish(struct radius_msg *msg, const u8 *secret,