From: Arran Cudbard-Bell Date: Thu, 19 Jul 2018 01:57:33 +0000 (-0400) Subject: Fixup doxygen headers in src/lib/util X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2f14e30decfa94eef4d768c72ad8d06f978a2e54;p=thirdparty%2Ffreeradius-server.git Fixup doxygen headers in src/lib/util --- diff --git a/src/lib/util/README b/src/lib/util/README deleted file mode 100644 index 1c1da3a9da5..00000000000 --- a/src/lib/util/README +++ /dev/null @@ -1,2 +0,0 @@ - The files in this directory are placed under the LGPL, as given -in the LICENSE file in this directory. diff --git a/src/lib/util/base.h b/src/lib/util/base.h index 8de2c1cdf3a..d303747f3ac 100644 --- a/src/lib/util/base.h +++ b/src/lib/util/base.h @@ -15,21 +15,13 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/* - * $Id$ +/** Structures and prototypes for this utility library * * @file src/lib/util/base.h - * @brief Structures and prototypes for the radius library. * * @copyright 1999-2014 The FreeRADIUS server project */ -/* - * Compiler hinting macros. Included here for 3rd party consumers - * of libradius.h. - * - * @note Defines RCSIDH. - */ #include RCSIDH(libradius_h, "$Id$") diff --git a/src/lib/util/base64.c b/src/lib/util/base64.c index 78b60a4a188..dc783a9b7f6 100644 --- a/src/lib/util/base64.c +++ b/src/lib/util/base64.c @@ -17,12 +17,11 @@ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ -/** - * @file lib/util/base64.c +/** Encode/decode binary data using printable characters * * @see RFC 3548 . * - * @brief Encode/decode binary data using printable characters. + * @file src/lib/util/base64.c * @author Simon Josefsson. */ RCSID("$Id$") diff --git a/src/lib/util/base64.h b/src/lib/util/base64.h index 8ac7c69cdd4..8e0833b8079 100644 --- a/src/lib/util/base64.h +++ b/src/lib/util/base64.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Encode and decode data in base64 format * - * @file lib/util/base64.h - * @brief Encode and decode data in base64 format. + * @file src/lib/util/base64.h * * @author Simon Josefsson * @copyright 2004, 2005, 2006 Free Software Foundation, Inc. diff --git a/src/lib/util/cursor.c b/src/lib/util/cursor.c index 232e51c68c3..6f023783643 100644 --- a/src/lib/util/cursor.c +++ b/src/lib/util/cursor.c @@ -13,11 +13,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Functions to iterate over a sets and subsets of items * - * @file lib/util/cursor.c - * @brief Functions to iterate over a sets and subsets of items. + * @file src/lib/util/cursor.c * * @note Do not modify collections of items pointed to by a cursor * with none fr_cursor_* functions over the lifetime of that cursor. diff --git a/src/lib/util/cursor.h b/src/lib/util/cursor.h index b6e085e84b2..c6da06a7095 100644 --- a/src/lib/util/cursor.h +++ b/src/lib/util/cursor.h @@ -17,11 +17,9 @@ #include #include -/** - * $Id$ +/** Functions to iterate over a sets and subsets of items * - * @file lib/util/cursor.h - * @brief Generic linked list cursor. + * @file src/lib/util/cursor.h * * @copyright 2016 The FreeRADIUS server project */ diff --git a/src/lib/util/debug.c b/src/lib/util/debug.c index f5280a7c43c..b458746b6e0 100644 --- a/src/lib/util/debug.c +++ b/src/lib/util/debug.c @@ -14,14 +14,13 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/debug.c - * @brief Various functions to aid in debugging +/** Functions to help with debugging + * + * @file src/lib/util/debug.c * * @copyright 2013 The FreeRADIUS server project * @copyright 2013 Arran Cudbard-Bell */ - #include #include #include diff --git a/src/lib/util/debug.h b/src/lib/util/debug.h index 12c2cbef061..39897cc9a4c 100644 --- a/src/lib/util/debug.h +++ b/src/lib/util/debug.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/* - * $Id$ +/** Debugging function definitions and structures * - * @file lib/util/debug.h - * @brief Debugging function definitions and structures. + * @file src/lib/util/debug.h * * @copyright 2015-2017 Arran Cudbard-Bell */ diff --git a/src/lib/util/dict.c b/src/lib/util/dict.c index 565e3515976..846cee2e38b 100644 --- a/src/lib/util/dict.c +++ b/src/lib/util/dict.c @@ -14,9 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/dict.c - * @brief Functions to parse FreeRADIUS dictionary file(s). +/** Multi-protocol AVP dictionary API + * + * @file src/lib/util/dict.c * * @copyright 2000,2006 The FreeRADIUS server project */ diff --git a/src/lib/util/dict.h b/src/lib/util/dict.h index 2b417a1f508..31f15610238 100644 --- a/src/lib/util/dict.h +++ b/src/lib/util/dict.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Multi-protocol AVP dictionary API * - * @file lib/util/dict.h - * @brief Multi-protocol attribute dictionary API. + * @file src/lib/util/dict.h * * @copyright 2015 The FreeRADIUS server project */ diff --git a/src/lib/util/dlist.h b/src/lib/util/dlist.h index 555d1687f59..993894cee24 100644 --- a/src/lib/util/dlist.h +++ b/src/lib/util/dlist.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Doubly linked list implementation * - * @file util/dlist.h - * @brief Doubly linked list implementation + * @file src/lib/util/dlist.h * * @copyright 2016 Alan DeKok */ diff --git a/src/lib/util/event.c b/src/lib/util/event.c index eea4ae26e30..b271bfa473e 100644 --- a/src/lib/util/event.c +++ b/src/lib/util/event.c @@ -14,12 +14,14 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/event.c - * @brief Non-thread-safe event handling specific to FreeRADIUS +/** Wrapper around libkqueue to make managing events easier * - * @note By non-thread-safe we mean multiple threads can't insert/delete events concurrently - * into the same event list without synchronization. + * Non-thread-safe event handling specific to FreeRADIUS. + * + * By non-thread-safe we mean multiple threads can't insert/delete + * events concurrently into the same event list without synchronization. + * + * @file src/lib/util/event.c * * @copyright 2007-2016 The FreeRADIUS server project * @copyright 2016 Arran Cudbard-Bell diff --git a/src/lib/util/event.h b/src/lib/util/event.h index 0d7621c4152..a08e01e8d2c 100644 --- a/src/lib/util/event.h +++ b/src/lib/util/event.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Wrapper around libkqueue to make managing events easier * - * @file lib/util/event.h - * @brief A simple event queue. + * @file src/lib/util/event.h * * @copyright 2007 The FreeRADIUS server project * @copyright 2007 Alan DeKok diff --git a/src/lib/util/fifo.c b/src/lib/util/fifo.c index 2889f5aed72..cddc875fa7c 100644 --- a/src/lib/util/fifo.c +++ b/src/lib/util/fifo.c @@ -14,9 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/fifo.c - * @brief Non-thread-safe fifo (FIFO) implementation. +/** Non-thread-safe fifo (FIFO) implementation + * + * @file src/lib/util/fifo.c * * @copyright 2005,2006 The FreeRADIUS server project * @copyright 2005 Alan DeKok diff --git a/src/lib/util/filters.c b/src/lib/util/filters.c index 00990acfeef..f37b7309e64 100644 --- a/src/lib/util/filters.c +++ b/src/lib/util/filters.c @@ -14,9 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/filters.c - * @brief Routines to parse Ascend's filter attributes. +/** Routines to parse Ascend's filter attributes + * + * @file src/lib/util/filters.c * * @copyright 2003,2006 The FreeRADIUS server project */ diff --git a/src/lib/util/fring.c b/src/lib/util/fring.c index 1acb640e4ac..d5114d2944e 100644 --- a/src/lib/util/fring.c +++ b/src/lib/util/fring.c @@ -14,13 +14,13 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/fring.c - * @brief Implementation of a circular buffer with fixed element size. +/** Implementation of a circular buffer with fixed element size * * This offers similar functionality to ring_buffer.c, but uses a fixed * element size, and expects all elements to be talloced. * + * @file src/lib/util/fring.c + * * @copyright 2013 The FreeRADIUS server project * @copyright 2013 Arran Cudbard-Bell */ diff --git a/src/lib/util/fring.h b/src/lib/util/fring.h index eec2a2e3822..569498ad6a7 100644 --- a/src/lib/util/fring.h +++ b/src/lib/util/fring.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/* - * $Id$ +/** Simple ring buffer with fixed element sizes * - * @file lib/util/fring_buffer.h - * @brief Simple ring buffer with fixed element sizes. + * @file src/lib/util/fring_buffer.h * * @copyright 2015-2017 Arran Cudbard-Bell */ diff --git a/src/lib/util/getaddrinfo.c b/src/lib/util/getaddrinfo.c index 110b3678aec..c1bc2163988 100644 --- a/src/lib/util/getaddrinfo.c +++ b/src/lib/util/getaddrinfo.c @@ -14,9 +14,7 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/getaddrinfo.c - * @brief Replacement getaddrinfo functions. +/** Replacement getaddrinfo functions * * These functions are defined and used only if the configure * cannot detect the standard getaddrinfo(), freeaddrinfo(), @@ -25,6 +23,8 @@ * FIXME: getaddrinfo() & getnameinfo() should * return all IPv4 addresses provided by DNS lookup. * + * @file src/lib/util/getaddrinfo.c + * * @copyright 2016 The FreeRADIUS server project */ RCSID("$Id$") diff --git a/src/lib/util/hash.c b/src/lib/util/hash.c index 3e6fce66333..12dda1fc9e5 100644 --- a/src/lib/util/hash.c +++ b/src/lib/util/hash.c @@ -14,19 +14,19 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/hash.c - * @brief Resizable hash tables. +/** Resizable hash tables * - * The weird "reverse" function is based on an idea from - * "Split-Ordered Lists - Lock-free Resizable Hash Tables", with - * modifications so that they're not lock-free. :( + * The weird "reverse" function is based on an idea from + * "Split-Ordered Lists - Lock-free Resizable Hash Tables", with + * modifications so that they're not lock-free. :( * - * However, the split-order idea allows a fast & easy splitting of the - * hash bucket chain when the hash table is resized. Without it, we'd - * have to check & update the pointers for every node in the buck chain, - * rather than being able to move 1/2 of the entries in the chain with - * one update. + * However, the split-order idea allows a fast & easy splitting of the + * hash bucket chain when the hash table is resized. Without it, we'd + * have to check & update the pointers for every node in the buck chain, + * rather than being able to move 1/2 of the entries in the chain with + * one update. + * + * @file src/lib/util/hash.c * * @copyright 2005,2006 The FreeRADIUS server project */ diff --git a/src/lib/util/hash.h b/src/lib/util/hash.h index d29bf945fe4..1ebee159178 100644 --- a/src/lib/util/hash.h +++ b/src/lib/util/hash.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Structures and prototypes for resizable hash tables * - * @file lib/util/hash.h - * @brief Structures and prototypes for fast hashing. + * @file src/lib/util/hash.h * * @copyright 2005,2006 The FreeRADIUS server project */ diff --git a/src/lib/util/heap.c b/src/lib/util/heap.c index 1b85c9345af..ce1169cef71 100644 --- a/src/lib/util/heap.c +++ b/src/lib/util/heap.c @@ -14,9 +14,10 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/heap.c - * @brief Basic heap +/** Functions for a basic binary heaps + * + * @file src/lib/util/heap.c + * * @copyright 2005,2006 The FreeRADIUS server project */ RCSID("$Id$") diff --git a/src/lib/util/heap.h b/src/lib/util/heap.h index f0d48687713..0239432ba72 100644 --- a/src/lib/util/heap.h +++ b/src/lib/util/heap.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Structures and prototypes for binary heaps * - * @file lib/util/heap.h - * @brief Structures and prototypes for binary heaps. + * @file src/lib/util/heap.h * * @copyright 2007 Alan DeKok */ diff --git a/src/lib/util/hmacmd5.c b/src/lib/util/hmacmd5.c index a52fdeded72..8c13d31d609 100644 --- a/src/lib/util/hmacmd5.c +++ b/src/lib/util/hmacmd5.c @@ -14,9 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/hmacmd5.c - * @brief MD5 HMAC not dependent on OpenSSL. +/** MD5 HMAC not dependent on OpenSSL + * + * @file src/lib/util/hmacmd5.c * * @note New code that needs fast or incremental HMACs should use the OpenSSL EVP_* HMAC * interface instead, as that can take advantage of acceleration instructions provided diff --git a/src/lib/util/hmacsha1.c b/src/lib/util/hmacsha1.c index c093fcad9c3..e57506851c3 100644 --- a/src/lib/util/hmacsha1.c +++ b/src/lib/util/hmacsha1.c @@ -14,17 +14,15 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/hmacsha1.c - * @brief SHA1 HMAC not dependent on OpenSSL. +/** SHA1 HMAC not dependent on OpenSSL * * @note New code that needs fast or incremental HMACs should use the OpenSSL EVP_* HMAC * interface instead, as that can take advantage of acceleration instructions provided * by various CPUs (and provides an incremental hashing interface). * - * Adapted from hmacmd5.c (HMAC-MD5). + * Adapted from hmacmd5.c (HMAC-MD5). Test cases from RFC2202. * - * Test cases from RFC2202. + * @file src/lib/util/hmacsha1.c * * @author Michael Richardson * diff --git a/src/lib/util/inet.c b/src/lib/util/inet.c index 3899490f7c6..d10b5b8c4f8 100644 --- a/src/lib/util/inet.c +++ b/src/lib/util/inet.c @@ -13,10 +13,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * @file inet.c - * @brief Functions to parse, print, mask and retrieve IP addresses +/** Functions for parsing, printing, masking and retrieving IP addresses + * + * @file src/lib/util/inet.c * * @author Arran Cudbard-Bell * @copyright 2015 Arran Cudbard-Bell diff --git a/src/lib/util/inet.h b/src/lib/util/inet.h index fcff0463ea6..c70f3126a48 100644 --- a/src/lib/util/inet.h +++ b/src/lib/util/inet.h @@ -15,11 +15,9 @@ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ -/** - * $Id$ +/** Structures and functions for parsing, printing, masking and retrieving IP addresses * - * @file lib/util/inet.h - * @brief Structures and functions for parsing, printing, masking and retrieving IP addresses. + * @file src/lib/util/inet.h * * @author Arran Cudbard-Bell * @copyright 2015 Arran Cudbard-Bell diff --git a/src/lib/util/isaac.c b/src/lib/util/isaac.c index eee08cc808a..937b1f73a6f 100644 --- a/src/lib/util/isaac.c +++ b/src/lib/util/isaac.c @@ -1,12 +1,11 @@ -/** - * $Id$ - * @file inet.c - * @brief Bob Jenkin's random number generator +/** Bob Jenkin's random number generator * * Bob's random number generator, ISAAC. Public Domain. * * http://burtleburtle.net/bob/rand/isaac.html * + * @file src/lib/util/isaac.c + * * @author Bob Jenkins. */ RCSID("$Id$") @@ -14,95 +13,98 @@ RCSID("$Id$") #include #define RANDSIZL (8) /* I recommend 8 for crypto, 4 for simulations */ -#define RANDSIZ (1<>2)&(RANDSIZ-1)]) -#define rngstep(mix,a,b,mm,m,m2,r,x) \ +#define ind(mm,x) ((mm)[(x >> 2) &(RANDSIZ-1)]) +#define rngstep(mix, a, b, mm, m, m2, r, x) \ { \ - x = *m; \ - a = ((a^(mix)) + *(m2++)) & 0xffffffff; \ - *(m++) = y = (ind(mm,x) + a + b) & 0xffffffff; \ - *(r++) = b = (ind(mm,y>>RANDSIZL) + x) & 0xffffffff; \ + x = *m; \ + a = ((a^(mix)) + *(m2++)) & 0xffffffff; \ + *(m++) = y = (ind(mm, x) + a + b) & 0xffffffff; \ + *(r++) = b = (ind(mm, y >> RANDSIZL) + x) & 0xffffffff; \ } void fr_isaac(fr_randctx *ctx) { - register uint32_t a,b,x,y,*m,*mm,*m2,*r,*mend; - mm=ctx->randmem; r=ctx->randrsl; - a = ctx->randa; b = (ctx->randb + (++ctx->randc)) & 0xffffffff; - for (m = mm, mend = m2 = m+(RANDSIZ/2); m>6 , a, b, mm, m, m2, r, x); - rngstep( a<<2 , a, b, mm, m, m2, r, x); - rngstep( a>>16, a, b, mm, m, m2, r, x); - } - for (m2 = mm; m2>6 , a, b, mm, m, m2, r, x); - rngstep( a<<2 , a, b, mm, m, m2, r, x); - rngstep( a>>16, a, b, mm, m, m2, r, x); - } - ctx->randb = b; ctx->randa = a; + register uint32_t a, b, x, y, *m, *mm, *m2, *r, *mend; + + mm = ctx->randmem; + r = ctx->randrsl; + a = ctx->randa; + b = (ctx->randb + (++ctx->randc)) & 0xffffffff; + + for (m = mm, mend = m2 = m + (RANDSIZ / 2); m < mend; ) { + rngstep(a << 13, a, b, mm, m, m2, r, x); + rngstep(a >> 6 , a, b, mm, m, m2, r, x); + rngstep(a << 2 , a, b, mm, m, m2, r, x); + rngstep(a >> 16, a, b, mm, m, m2, r, x); + } + for (m2 = mm; m2 < mend; ) { + rngstep(a << 13, a, b, mm, m, m2, r, x); + rngstep(a >> 6 , a, b, mm, m, m2, r, x); + rngstep(a << 2 , a, b, mm, m, m2, r, x); + rngstep(a >> 16, a, b, mm, m, m2, r, x); + } + ctx->randb = b; + ctx->randa = a; } #define mix(a,b,c,d,e,f,g,h) \ { \ - a^=b<<11; d+=a; b+=c; \ - b^=c>>2; e+=b; c+=d; \ - c^=d<<8; f+=c; d+=e; \ - d^=e>>16; g+=d; e+=f; \ - e^=f<<10; h+=e; f+=g; \ - f^=g>>4; a+=f; g+=h; \ - g^=h<<8; b+=g; h+=a; \ - h^=a>>9; c+=h; a+=b; \ + a ^= b << 11; d += a; b += c; \ + b ^= c >> 2; e += b; c += d; \ + c ^= d << 8; f += c; d += e; \ + d ^= e >> 16; g += d; e += f; \ + e ^= f << 10; h += e; f += g; \ + f ^= g >> 4; a += f; g += h; \ + g ^= h << 8; b += g; h += a; \ + h ^= a >> 9; c += h; a += b; \ } /* if (flag==1), then use the contents of randrsl[] to initialize mm[]. */ void fr_randinit(fr_randctx *ctx, int flag) { - int i; - uint32_t a,b,c,d,e,f,g,h; - uint32_t *m,*r; - ctx->randa = ctx->randb = ctx->randc = 0; - m=ctx->randmem; - r=ctx->randrsl; - a=b=c=d=e=f=g=h=0x9e3779b9; /* the golden ratio */ - - for (i=0; i<4; ++i) { /* scramble it */ - mix(a,b,c,d,e,f,g,h); - } - - if (flag) { - /* initialize using the contents of r[] as the seed */ - for (i=0; irandcnt=RANDSIZ; /* prepare to use the first set of results */ + int i; + uint32_t a, b, c, d, e, f, g, h; + uint32_t *m, *r; + + ctx->randa = ctx->randb = ctx->randc = 0; + m = ctx->randmem; + r = ctx->randrsl; + a = b = c = d = e = f = g = h = 0x9e3779b9; /* the golden ratio */ + + /* scramble it */ + for (i = 0; i < 4; ++i) mix(a, b, c, d, e, f, g, h); + + if (flag) { + /* initialize using the contents of r[] as the seed */ + for (i = 0; i < RANDSIZ; i += 8) { + a += r[i ]; b += r[i + 1]; c +=r [i + 2]; d += r[i + 3]; + e += r[i + 4]; f += r[i + 5]; g +=r [i + 6]; h += r[i + 7]; + mix(a, b, c, d, e, f, g, h); + m[i ] = a; m[i + 1] = b; m[i + 2] = c; m[i + 3] = d; + m[i + 4] = e; m[i + 5] = f; m[i + 6] = g; m[i + 7] = h; + } + /* do a second pass to make all of the seed affect all of m */ + for (i = 0; i < RANDSIZ; i += 8) { + a += m[i ]; b += m[i + 1]; c += m[i + 2]; d += m[i + 3]; + e += m[i + 4]; f += m[i + 5]; g += m[i + 6]; h += m[i + 7]; + mix(a, b, c, d, e, f, g, h); + m[i ] = a; m[i + 1] = b; m[i + 2] = c; m[i + 3] = d; + m[i + 4] = e; m[i + 5] = f; m[i + 6] = g; m[i + 7] = h; + } + } else { + for (i = 0; i < RANDSIZ; i += 8) { + /* fill in mm[] with messy stuff */ + mix(a, b, c, d, e, f, g, h); + m[i ] = a; m[i + 1] = b; m[i + 2] = c; m[i + 3] = d; + m[i + 4] = e; m[i + 5] = f; m[i + 6] = g; m[i + 7] = h; + } + } + + fr_isaac(ctx); /* fill in the first set of results */ + ctx->randcnt = RANDSIZ; /* prepare to use the first set of results */ } @@ -114,19 +116,20 @@ void fr_randinit(fr_randctx *ctx, int flag) */ int main() { - uint32_t i,j; - fr_randctx ctx; - - ctx.randa = ctx.randb = ctx.randc = (uint32_t)0; - - for (i=0; i<256; ++i) ctx.randrsl[i]=(uint32_t)0; - fr_randinit(&ctx, 1); - for (i=0; i<2; ++i) { - fr_isaac(&ctx); - for (j=0; j<256; ++j) { - printf("%.8lx",ctx.randrsl[j]); - if ((j&7)==7) printf("\n"); - } - } + uint32_t i,j; + fr_randctx ctx; + + ctx.randa = ctx.randb = ctx.randc = (uint32_t)0; + + for (i = 0; i < 256; ++i) ctx.randrsl[i] = (uint32_t)0; + + fr_randinit(&ctx, 1); + for (i = 0; i < 2; ++i) { + fr_isaac(&ctx); + for (j = 0; j < 256; ++j) { + printf("%.8lx",ctx.randrsl[j]); + if ((j & 7) == 7) printf("\n"); + } + } } #endif diff --git a/src/lib/util/log.c b/src/lib/util/log.c index bc9403375a3..30c2830b07a 100644 --- a/src/lib/util/log.c +++ b/src/lib/util/log.c @@ -14,9 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/log.c - * @brief Support functions for logging in FreeRADIUS libraries. +/** Support functions for logging in FreeRADIUS libraries + * + * @file src/lib/util/log.c * * @copyright 2003,2006 The FreeRADIUS server project */ diff --git a/src/lib/util/log.h b/src/lib/util/log.h index e676990476c..042bec6fb6a 100644 --- a/src/lib/util/log.h +++ b/src/lib/util/log.h @@ -20,15 +20,12 @@ #include -/** - * $Id$ +/** libfreeradius logging functions * - * @file lib/util/log.h - * @brief libfreeradius logging functions + * @file src/lib/util/log.h * * @copyright 2016 The FreeRADIUS server project */ - extern FILE *fr_log_fp; /* diff --git a/src/lib/util/lsan.h b/src/lib/util/lsan.h index d88d9d9b1fa..8f805fe2d51 100644 --- a/src/lib/util/lsan.h +++ b/src/lib/util/lsan.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Integration with the leak sanitizer interface * - * @file lib/util/lsan.h - * @brief Integration with the leak sanitizer interface + * @file src/lib/util/lsan.h * * @copyright 2018 The FreeRADIUS server project */ diff --git a/src/lib/util/md4.c b/src/lib/util/md4.c index 8e2d57bef5c..a87ec27cf6e 100644 --- a/src/lib/util/md4.c +++ b/src/lib/util/md4.c @@ -1,10 +1,8 @@ -/** - * $Id$ +/** A local MD4 implementation * * @note license is LGPL, but largely derived from a public domain source. * - * @file md4.c - * @brief md4 digest functions. + * @file src/lib/util/md4.c */ RCSID("$Id$") diff --git a/src/lib/util/md4.h b/src/lib/util/md4.h index c528fe1af6e..595e47ad154 100644 --- a/src/lib/util/md4.h +++ b/src/lib/util/md4.h @@ -1,10 +1,9 @@ #pragma once -/** - * $Id$ +/** Structures and prototypes for our local MD4 implementation * * @note license is LGPL, but largely derived from a public domain source. * - * @file lib/util/md4.h + * @file src/lib/util/md4.h * @brief Structures and prototypes for md4. */ RCSIDH(md4_h, "$Id$") diff --git a/src/lib/util/md5.c b/src/lib/util/md5.c index a2fcbf7f975..9640725707a 100644 --- a/src/lib/util/md5.c +++ b/src/lib/util/md5.c @@ -1,12 +1,9 @@ -/** - * $Id$ +/** A local MD5 implementation * * @note license is LGPL, but largely derived from a public domain source. * - * @file md5.c - * @brief md5 digest functions. + * @file src/lib/util/md5.c */ - RCSID("$Id$") #include diff --git a/src/lib/util/md5.h b/src/lib/util/md5.h index c889df92b53..fd9b37daf2f 100644 --- a/src/lib/util/md5.h +++ b/src/lib/util/md5.h @@ -1,11 +1,9 @@ #pragma once -/** - * $Id$ +/** Structures and prototypes for our local MD5 implementation * * @note license is LGPL, but largely derived from a public domain source. * - * @file lib/util/md5.h - * @brief Structures and prototypes for md5. + * @file src/lib/util/md5.h */ RCSIDH(md5_h, "$Id$") diff --git a/src/lib/util/mem.c b/src/lib/util/mem.c index 300eb913efa..772d1c3f0c6 100644 --- a/src/lib/util/mem.c +++ b/src/lib/util/mem.c @@ -1,8 +1,4 @@ /* - * mem.c RADIUS_PACKET alloc/free - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -16,10 +12,14 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** RADIUS_PACKET alloc/free functions + * + * @file src/lib/util/mem.c * * @copyright 2000,2006 The FreeRADIUS server project */ - RCSID("$Id$") #include diff --git a/src/lib/util/misc.c b/src/lib/util/misc.c index 5d17404a6fe..4e9ccf0dc83 100644 --- a/src/lib/util/misc.c +++ b/src/lib/util/misc.c @@ -1,8 +1,4 @@ /* - * misc.c Various miscellaneous functions. - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -16,10 +12,14 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** Various miscellaneous utility functions + * + * @file src/lib/util/misc.c * * @copyright 2000,2006 The FreeRADIUS server project */ - RCSID("$Id$") #include diff --git a/src/lib/util/missing.c b/src/lib/util/missing.c index 0bb13553f16..a5b4c0eee14 100644 --- a/src/lib/util/missing.c +++ b/src/lib/util/missing.c @@ -1,9 +1,4 @@ /* - * missing.c Replacements for functions that are or can be - * missing on some platforms. - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -17,10 +12,14 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** Replacements for functions that are or can be missing on some platforms + * + * @file src/lib/util/missing.c * * @copyright 2000,2006 The FreeRADIUS server project */ - RCSID("$Id$") #include diff --git a/src/lib/util/net.c b/src/lib/util/net.c index 02735bb7bac..5209e906793 100644 --- a/src/lib/util/net.c +++ b/src/lib/util/net.c @@ -13,10 +13,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * @file net.c - * @brief Functions to parse raw packets. +/** Functions for parsing raw network packets + * + * @file src/lib/util/net.c * * @author Arran Cudbard-Bell * @copyright 2014-2015 Arran Cudbard-Bell diff --git a/src/lib/util/net.h b/src/lib/util/net.h index ce8a3ae8963..7bcd267d458 100644 --- a/src/lib/util/net.h +++ b/src/lib/util/net.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Structures and functions for parsing raw network packets * - * @file lib/util/net.h - * @brief Structures and functions for parsing raw network packets. + * @file src/lib/util/net.h * * @author Arran Cudbard-Bell * @copyright 2014 Arran Cudbard-Bell diff --git a/src/lib/util/packet.h b/src/lib/util/packet.h index a6ada82186a..52dda5cecae 100644 --- a/src/lib/util/packet.h +++ b/src/lib/util/packet.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Structures and functions for packet manipulation * - * @file lib/util/packet.h - * @brief Structures and functions for packet manipulation + * @file src/lib/util/packet.h * * @copyright 2001, 2002, 2003, 2004, 2005, 2006 The FreeRADIUS server project */ diff --git a/src/lib/util/pair.c b/src/lib/util/pair.c index a54c1ade337..e6645956e9c 100644 --- a/src/lib/util/pair.c +++ b/src/lib/util/pair.c @@ -1,8 +1,4 @@ /* - * pair.c Functions to handle VALUE_PAIRs - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -16,10 +12,14 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA - * - * @copyright 2000,2006 The FreeRADIUS server project */ +/** AVP manipulation and search API + * + * @file src/lib/util/pair.c + * + * @copyright 2000,2006,2015 The FreeRADIUS server project + */ RCSID("$Id$") #include diff --git a/src/lib/util/pair.h b/src/lib/util/pair.h index 739bc981f10..86cc563f5d7 100644 --- a/src/lib/util/pair.h +++ b/src/lib/util/pair.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** AVP manipulation and search API * - * @file lib/util/pair.h - * @brief AVP manipulation and search API. + * @file src/lib/util/pair.h * * @copyright 2015 The FreeRADIUS server project */ diff --git a/src/lib/util/pair_cursor.c b/src/lib/util/pair_cursor.c index ee6e28f5e27..9921ae7ef66 100644 --- a/src/lib/util/pair_cursor.c +++ b/src/lib/util/pair_cursor.c @@ -13,15 +13,13 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * - * @file lib/util/cursor.c - * @brief Functions to iterate over collections of VALUE_PAIRs +/** Functions to iterate over collections of VALUE_PAIRs * * @note Do not modify collections of VALUE_PAIRs pointed to by a cursor * with none fr_pair_cursor_* functions, during the lifetime of that cursor. * + * @file src/lib/util/pair_cursor.c + * * @author Arran Cudbard-Bell * @copyright 2013-2015 Arran Cudbard-Bell * @copyright 2013-2015 The FreeRADIUS Server Project. diff --git a/src/lib/util/pair_cursor.h b/src/lib/util/pair_cursor.h index c863fbc87de..82659ceaeb6 100644 --- a/src/lib/util/pair_cursor.h +++ b/src/lib/util/pair_cursor.h @@ -14,11 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Functions to iterate over collections of VALUE_PAIRs * - * @file lib/util/cursor.h - * @brief Generic linked list cursor. + * @file src/lib/util/pair_cursor.h * * @copyright 2016 The FreeRADIUS server project */ diff --git a/src/lib/util/pcap.c b/src/lib/util/pcap.c index 2579435ff89..50e2e5b4ed4 100644 --- a/src/lib/util/pcap.c +++ b/src/lib/util/pcap.c @@ -13,10 +13,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * @file lib/util/pcap.c - * @brief Wrappers around libpcap functions +/** Wrappers around libpcap functions + * + * @file src/lib/util/pcap.c * * @author Arran Cudbard-Bell * @copyright 2013 Arran Cudbard-Bell diff --git a/src/lib/util/pcap.h b/src/lib/util/pcap.h index 3c01efa9bd7..9c03a3fbb05 100644 --- a/src/lib/util/pcap.h +++ b/src/lib/util/pcap.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ #ifdef HAVE_LIBPCAP -/** - * $Id$ +/** Prototypes and constants for PCAP functions * - * @file lib/util/pcap.h - * @brief Prototypes and constants for PCAP functions. + * @file src/lib/util/pcap.h * * @author Arran Cudbard-Bell * @copyright 2013 Arran Cudbard-Bell diff --git a/src/lib/util/print.c b/src/lib/util/print.c index 0c410b0820f..7eace77c503 100644 --- a/src/lib/util/print.c +++ b/src/lib/util/print.c @@ -1,8 +1,4 @@ /* - * print.c Routines to print stuff. - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -16,14 +12,17 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** Functions to produce and parse the FreeRADIUS presentation format + * + * @file src/lib/util/print.c * * @copyright 2000,2006 The FreeRADIUS server project */ - RCSID("$Id$") #include - #include /** Checks for utf-8, taken from http://www.w3.org/International/questions/qa-forms-utf-8 diff --git a/src/lib/util/proto.c b/src/lib/util/proto.c index a554b344ae3..c9d93e6896e 100644 --- a/src/lib/util/proto.c +++ b/src/lib/util/proto.c @@ -14,11 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Protocol encoder/decoder support functions * - * @file proto.c - * @brief functions common to protocol encoders/decoders. + * @file src/lib/util/proto.c * * @copyright 2015 The FreeRADIUS server project */ diff --git a/src/lib/util/proto.h b/src/lib/util/proto.h index a6eebb97353..d6bf70ed194 100644 --- a/src/lib/util/proto.h +++ b/src/lib/util/proto.h @@ -1,25 +1,23 @@ #pragma once /* - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Protocol encoder/decoder support functions * - * @file lib/util/proto.h - * @brief Protocol encoder/decoder support functions + * @file src/lib/util/proto.h * * @copyright 2015 The FreeRADIUS server project */ diff --git a/src/lib/util/rand.c b/src/lib/util/rand.c index b8ff10c0d25..5285575d09b 100644 --- a/src/lib/util/rand.c +++ b/src/lib/util/rand.c @@ -14,15 +14,12 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Functions to get randomness * - * @file rand.c - * @brief Functions to get randomness + * @file src/lib/util/rand.c * - * @copyright 1999-2017 The FreeRADIUS server project + * @copyright 1999-2017 The FreeRADIUS server project */ - RCSID("$Id$") #include @@ -32,7 +29,6 @@ RCSID("$Id$") static _Thread_local fr_randctx fr_rand_pool; //!< A pool of pre-generated random integers static _Thread_local bool fr_rand_initialized = false; - /** Seed the random number generator * * May be called any number of times. diff --git a/src/lib/util/rbtree.c b/src/lib/util/rbtree.c index b5bb0ef8354..8cbb26e1a5e 100644 --- a/src/lib/util/rbtree.c +++ b/src/lib/util/rbtree.c @@ -1,8 +1,4 @@ /* - * rbtree.c RED-BLACK balanced binary trees. - * - * Version: $Id$ - * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2.1 of the License, or @@ -16,10 +12,14 @@ * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA - * - * @copyright 2004,2006 The FreeRADIUS server project */ +/** Red/black tree implementation + * + * @file src/lib/util/rbtree.c + * + * @copyright 2004,2006 The FreeRADIUS server project + */ RCSID("$Id$") #include diff --git a/src/lib/util/rbtree.h b/src/lib/util/rbtree.h index 031adfdea0e..497cef79616 100644 --- a/src/lib/util/rbtree.h +++ b/src/lib/util/rbtree.h @@ -1,25 +1,23 @@ #pragma once /* - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Red/black tree implementation * - * @file lib/util/rbtree.h - * @brief Red/black tree implementation + * @file src/lib/util/rbtree.h * * @copyright 2016 The FreeRADIUS server project */ diff --git a/src/lib/util/regex.c b/src/lib/util/regex.c index 4738abd8e36..745631868c5 100644 --- a/src/lib/util/regex.c +++ b/src/lib/util/regex.c @@ -14,13 +14,14 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/regex.c - * @brief regex abstraction functions +/** Wrappers around various regular expression libraries + * + * @file src/lib/util/regex.c * * @copyright 2014 The FreeRADIUS server project * @copyright 2014 Arran Cudbard-Bell */ +RCSID("$Id$") #ifdef HAVE_REGEX #include diff --git a/src/lib/util/regex.h b/src/lib/util/regex.h index 3d244bf0e12..94844d8f922 100644 --- a/src/lib/util/regex.h +++ b/src/lib/util/regex.h @@ -1,25 +1,23 @@ #pragma once /* - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ #ifdef HAVE_REGEX -/** - * $Id$ +/** Wrappers around various regular expression libraries * - * @file lib/util/regex.h - * @brief Wrappers around various regular expression libraries. + * @file src/lib/util/regex.h * * @copyright 2014 The FreeRADIUS server project */ diff --git a/src/lib/util/sha1.c b/src/lib/util/sha1.c index b07304d477a..873b48b8c55 100644 --- a/src/lib/util/sha1.c +++ b/src/lib/util/sha1.c @@ -1,11 +1,11 @@ -/* - * SHA-1 in C - * By Steve Reid - * 100% Public Domain +/** Local implementation of the SHA1 hashing scheme * - * Version: $Id$ + * SHA-1 in C 100% Public Domain + * + * @file src/lib/util/sha1.c + * + * @author Steve Reid */ - RCSID("$Id$") #include diff --git a/src/lib/util/sha1.h b/src/lib/util/sha1.h index 30f29a48f00..752093bee99 100644 --- a/src/lib/util/sha1.h +++ b/src/lib/util/sha1.h @@ -1,9 +1,11 @@ #pragma once -/** - * $Id$ +/** Local implementation of the SHA1 hashing scheme * - * @file lib/util/sha1.h - * @brief Local implementation of the SHA1 hashing scheme. + * SHA-1 in C 100% Public Domain + * + * @file src/lib/util/sha1.h + * + * @author Steve Reid */ #ifdef WITH_OPENSSL_SHA1 # include diff --git a/src/lib/util/snprintf.c b/src/lib/util/snprintf.c index 44a5313df9b..ceee19161f7 100644 --- a/src/lib/util/snprintf.c +++ b/src/lib/util/snprintf.c @@ -1,53 +1,56 @@ - /* - Unix snprintf implementation. - Version 1.4 - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU Library General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - - Revision History: - - 1.4: - * integrate in FreeRADIUS's libradius: - * Fetched from: http://savannah.gnu.org/cgi-bin/viewcvs/mailutils/mailutils/lib/snprintf.c?rev=1.4 - * Fetched from: http://savannah.gnu.org/cgi-bin/viewcvs/mailutils/mailutils/lib/snprintf.h?rev=1.4 - * Replace config.h with autoconf.h - * Protect with HAVE_SNPRINTF and HAVE_VSNPRINTF - 1.3: - * add #include ifdef HAVE_CONFIG_H - * cosmetic change, when exponent is 0 print xxxE+00 - instead of xxxE-00 - 1.2: - * put the program under LGPL. - 1.1: - * added changes from Miles Bader - * corrected a bug with %f - * added support for %#g - * added more comments :-) - 1.0: - * supporting must ANSI syntaxic_sugars - 0.0: - * suppot %s %c %d - - THANKS(for the patches and ideas): - Miles Bader - Cyrille Rustom - Jacek Slabocewiz - Mike Parker(mouse) + * This program is is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or (at + * your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ -*/ +/** Unix snprintf implementation + * + * Version 1.4 + * + * 1.4: + * * integrate in FreeRADIUS's libradius: + * * Fetched from: http://savannah.gnu.org/cgi-bin/viewcvs/mailutils/mailutils/lib/snprintf.c?rev=1.4 + * * Fetched from: http://savannah.gnu.org/cgi-bin/viewcvs/mailutils/mailutils/lib/snprintf.h?rev=1.4 + * * Replace config.h with autoconf.h + * * Protect with HAVE_SNPRINTF and HAVE_VSNPRINTF + * 1.3: + * * add #include ifdef HAVE_CONFIG_H + * * cosmetic change, when exponent is 0 print xxxE+00 + * instead of xxxE-00 + * 1.2: + * * put the program under LGPL. + * + * 1.1: + * * added changes from Miles Bader + * * corrected a bug with %f + * * added support for %#g + * * added more comments :-) + * 1.0: + * * supporting must ANSI syntaxic_sugars + * 0.0: + * * suppot %s %c %d + * + * THANKS(for the patches and ideas): + * Miles Bader + * Cyrille Rustom + * Jacek Slabocewiz + * Mike Parker(mouse) + * + * @file src/lib/util/snprintf.h + * + * @copyright Alain Magloire: alainm@rcsm.ee.mcgill.ca + */ RCSID("$Id$") diff --git a/src/lib/util/snprintf.h b/src/lib/util/snprintf.h index c3f616dea58..2ac0a964986 100644 --- a/src/lib/util/snprintf.h +++ b/src/lib/util/snprintf.h @@ -1,40 +1,33 @@ /* - Unix snprintf implementation. - Version 1.4 - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU Library General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - - Revision History: - see header of snprintf.c. - -format: - int snprintf(holder, sizeof_holder, format, ...) - -Return values: - (sizeof_holder - 1) - - - THANKS(for the patches and ideas): - Miles Bader - Cyrille Rustom - Jacek Slabocewiz - Mike Parker(mouse) - -Alain Magloire: alainm@rcsm.ee.mcgill.ca -*/ + * This program is is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or (at + * your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ +/** Unix snprintf implementation + * + * Version 1.4 + * + * THANKS(for the patches and ideas): + * Miles Bader + * Cyrille Rustom + * Jacek Slabocewiz + * Mike Parker(mouse) + * + * @file src/lib/util/snprintf.h + * + * @copyright Alain Magloire: alainm@rcsm.ee.mcgill.ca + */ #ifndef HAVE_VSNPRINTF RCSIDH(snprintf_h, "$Id$") diff --git a/src/lib/util/socket.c b/src/lib/util/socket.c index 0cf46f456d1..5d5f569221d 100644 --- a/src/lib/util/socket.c +++ b/src/lib/util/socket.c @@ -14,10 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * @file socket.c - * @brief Functions for establishing and managing low level sockets. +/** Functions for establishing and managing low level sockets + * + * @file src/lib/util/socket.c * * @author Arran Cudbard-Bell * @author Alan DeKok diff --git a/src/lib/util/strerror.c b/src/lib/util/strerror.c index 4d2e9f441eb..c285bc88a2c 100644 --- a/src/lib/util/strerror.c +++ b/src/lib/util/strerror.c @@ -14,9 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/strerror.c - * @brief Support functions to allow libraries to provide errors to their callers. +/** Support functions to allow libraries to provide errors to their callers + * + * @file src/lib/util/strerror.c * * @copyright 2017 The FreeRADIUS server project * @copyright 2017 Arran Cudbard-Bell diff --git a/src/lib/util/strlcat.c b/src/lib/util/strlcat.c index 847d6880c4d..c6f7788fb55 100644 --- a/src/lib/util/strlcat.c +++ b/src/lib/util/strlcat.c @@ -1,28 +1,23 @@ /* - * strlcat.c Concatenate strings. - * - * Version: $Id$ + * Permission to use, copy, modify, and distribute this software for any + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. * + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ -/* - * @copyright (c) 1998 Todd C. Miller +/** Implementation of the strlcat function * - * Permission to use, copy, modify, and distribute this software for any - * purpose with or without fee is hereby granted, provided that the above - * copyright notice and this permission notice appear in all copies. + * @file src/lib/util/strlcat.c * - * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. - * - * @copyright 2006 The FreeRADIUS server project + * @copyright (c) 1998 Todd C. Miller */ - RCSID("$Id$") #ifndef HAVE_STRLCAT diff --git a/src/lib/util/strlcpy.c b/src/lib/util/strlcpy.c index 341a8a9a70a..ccd950af727 100644 --- a/src/lib/util/strlcpy.c +++ b/src/lib/util/strlcpy.c @@ -1,28 +1,23 @@ /* - * strlcpy.c Copy strings. - * - * Version: $Id$ + * Permission to use, copy, modify, and distribute this software for any + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. * + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ -/* - * @copyright (c) 1998 Todd C. Miller +/** Local implementation of the strlcpy function * - * Permission to use, copy, modify, and distribute this software for any - * purpose with or without fee is hereby granted, provided that the above - * copyright notice and this permission notice appear in all copies. + * @file src/lib/util/strlcpy.c * - * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. - * - * @copyright 2006 The FreeRADIUS server project + * @copyright (c) 1998 Todd C. Miller */ - RCSID("$Id$") #ifndef HAVE_STRLCPY diff --git a/src/lib/util/syserror.c b/src/lib/util/syserror.c index f2d78169f0b..05584d795e2 100644 --- a/src/lib/util/syserror.c +++ b/src/lib/util/syserror.c @@ -14,10 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/syserror.c - * @brief Support functions to allow libraries to get system errors in a threadsafe - * and easily debuggable way. +/** Support functions to allow libraries to get system errors in a threadsafe and easily debuggable way + * + * @file src/lib/util/syserror.c * * @copyright 2017 The FreeRADIUS server project * @copyright 2017 Arran Cudbard-Bell diff --git a/src/lib/util/talloc.c b/src/lib/util/talloc.c index 134ef527268..e6d8aad9652 100644 --- a/src/lib/util/talloc.c +++ b/src/lib/util/talloc.c @@ -14,14 +14,13 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * @file lib/util/talloc.c - * @brief Functions which we wish were included in the standard talloc distribution. +/** Functions which we wish were included in the standard talloc distribution + * + * @file src/lib/util/talloc.c * * @copyright 2017 The FreeRADIUS server project * @copyright 2017 Arran Cudbard-Bell */ - RCSID("$Id$") #include diff --git a/src/lib/util/talloc.h b/src/lib/util/talloc.h index 5446185aa9a..922cbf98292 100644 --- a/src/lib/util/talloc.h +++ b/src/lib/util/talloc.h @@ -14,6 +14,14 @@ * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ + +/** Functions which we wish were included in the standard talloc distribution + * + * @file src/lib/util/talloc.h + * + * @copyright 2017 The FreeRADIUS server project + * @copyright 2017 Arran Cudbard-Bell + */ #include #include #include diff --git a/src/lib/util/threads.h b/src/lib/util/threads.h index fff2f1390b7..cd089bb5ac8 100644 --- a/src/lib/util/threads.h +++ b/src/lib/util/threads.h @@ -15,11 +15,11 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Macros to abstract Thread Local Storage + * + * Simplifies creating destructors, called when the thread exits * * @file lib/util/threads.h - * @brief Macros to abstract Thread Local Storage * * @copyright 2013-2016 The FreeRADIUS server project */ diff --git a/src/lib/util/token.c b/src/lib/util/token.c index 9adaac8d602..ad33a3c3d4a 100644 --- a/src/lib/util/token.c +++ b/src/lib/util/token.c @@ -1,9 +1,4 @@ /* - * token.c Read the next token from a string. - * Yes it's pretty primitive but effective. - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -17,10 +12,16 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA - * - * @copyright 2000,2006 The FreeRADIUS server project */ +/** Tokenisation code and constants + * + * This is mostly for the attribute filter and user files. + * + * @file src/lib/util/token.c + * + * @copyright 2001,2006 The FreeRADIUS server project + */ RCSID("$Id$") #include diff --git a/src/lib/util/token.h b/src/lib/util/token.h index cb6b24603dd..2fef91dccc9 100644 --- a/src/lib/util/token.h +++ b/src/lib/util/token.h @@ -15,11 +15,11 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Tokenisation code and constants * - * @file lib/util/token.h - * @brief Tokenisation code and constants. + * This is mostly for the attribute filter and user files. + * + * @file src/lib/util/token.h * * @copyright 2001,2006 The FreeRADIUS server project */ diff --git a/src/lib/util/trie.c b/src/lib/util/trie.c index d1b9467e86e..2dddb6219e4 100644 --- a/src/lib/util/trie.c +++ b/src/lib/util/trie.c @@ -1,8 +1,4 @@ /* - * trie.c Path-compressed tries - * - * Version: $Id$ - * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either @@ -16,21 +12,21 @@ * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** Path-compressed prefix tries + * + * @file src/lib/util/trie.c * * @copyright 2017 Alan DeKok */ - RCSID("$Id$") - #include #include #include -#ifdef TESTING #include -#else -#define rad_assert(_x) -#endif + #include #include #include diff --git a/src/lib/util/trie.h b/src/lib/util/trie.h index cded67dff8e..3329fc819de 100644 --- a/src/lib/util/trie.h +++ b/src/lib/util/trie.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Path-compressed prefix tries * - * @file lib/util/trie.h - * @brief Prefix trie. + * @file src/lib/util/trie.h * * @copyright 2017 Alan DeKok */ diff --git a/src/lib/util/types.h b/src/lib/util/types.h index c908538217d..b1d6b7ac4cc 100644 --- a/src/lib/util/types.h +++ b/src/lib/util/types.h @@ -15,11 +15,11 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Types of values contained within an #fr_value_box_t * - * @file lib/util/types.h - * @brief #fr_value_box_t types + * These are in a separate header file to avoid circular dependencies. + * + * @file src/lib/util/types.h * * @copyright 2017 The FreeRADIUS server project */ diff --git a/src/lib/util/udp.c b/src/lib/util/udp.c index c7e63f5ce04..6822f384a5d 100644 --- a/src/lib/util/udp.c +++ b/src/lib/util/udp.c @@ -14,15 +14,12 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Utility functions for managing UDP sockets * - * @file util/udp.c - * @brief Functions to send/receive UDP packets. + * @file src/lib/util/udp.c * * @copyright 2000-2003,2006 The FreeRADIUS server project */ - RCSID("$Id$") #include diff --git a/src/lib/util/udp.h b/src/lib/util/udp.h index db55afb91f8..6999b31e1eb 100644 --- a/src/lib/util/udp.h +++ b/src/lib/util/udp.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Utility functions for managing UDP sockets * - * @file lib/util/udp.h - * @brief Abstraction API for sending and receiving packets on UDP sockets. + * @file src/lib/util/udp.h * * @copyright 2015 The FreeRADIUS server project */ diff --git a/src/lib/util/udpfromto.c b/src/lib/util/udpfromto.c index e6939fe1f48..57234fca202 100644 --- a/src/lib/util/udpfromto.c +++ b/src/lib/util/udpfromto.c @@ -14,10 +14,11 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * @file udpfromto.c - * @brief Like recvfrom, but also stores the destination IP address. Useful on multihomed hosts. +/** API for sending and receiving packets on unconnected UDP sockets + * + * Like recvfrom, but also stores the destination IP address. Useful on multihomed hosts. + * + * @file src/lib/util/udpfromto.c * * @copyright 2007 Alan DeKok * @copyright 2002 Miquel van Smoorenburg diff --git a/src/lib/util/udpfromto.h b/src/lib/util/udpfromto.h index 1448d24c1fc..184bb74232b 100644 --- a/src/lib/util/udpfromto.h +++ b/src/lib/util/udpfromto.h @@ -15,11 +15,11 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** API for sending and receiving packets on unconnected UDP sockets * - * @file lib/util/udpfromto.h - * @brief Abstract API for sending and receiving packets on unconnected UDP sockets. + * Like recvfrom, but also stores the destination IP address. Useful on multihomed hosts. + * + * @file src/lib/util/udpfromto.h * * @copyright 2015 The FreeRADIUS server project */ diff --git a/src/lib/util/value.c b/src/lib/util/value.c index a9166dffd8f..4545c75279a 100644 --- a/src/lib/util/value.c +++ b/src/lib/util/value.c @@ -14,10 +14,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ - * @file value.c - * @brief Manipulate boxed values representing all internal data types. +/** Boxed value structures and functions to manipulate them + * + * @file src/lib/util/value.c * * There are three notional data formats used in the server: * diff --git a/src/lib/util/value.h b/src/lib/util/value.h index 592995c29eb..31ae26da0d0 100644 --- a/src/lib/util/value.h +++ b/src/lib/util/value.h @@ -15,11 +15,9 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Boxed value structures and functions to manipulate them * - * @file lib/util/value.h - * @brief Boxed values and functions to manipulate them. + * @file src/lib/util/value.h * * @copyright 2015-2018 Arran Cudbard-Bell (a.cudbardb@freeradius.org) */ diff --git a/src/lib/util/version.c b/src/lib/util/version.c index c6c5257b9a8..ae8419e2513 100644 --- a/src/lib/util/version.c +++ b/src/lib/util/version.c @@ -1,25 +1,26 @@ /* - * version.c Validate application and library magic numbers. + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. * - * Version: $Id$ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, + * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA - * - * @copyright 1999-2014 The FreeRADIUS server project */ +/** Validate application and library magic numbers + * + * @file src/lib/util/version.c + * + * @copyright 2016 The FreeRADIUS server project + * @copyright 2016 Arran Cudbard-Bell + */ RCSID("$Id$") #include diff --git a/src/lib/util/version.h b/src/lib/util/version.h index 977e763c9c4..37417c21701 100644 --- a/src/lib/util/version.h +++ b/src/lib/util/version.h @@ -1,27 +1,26 @@ #pragma once /* - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/** - * $Id$ +/** Version checking functions * - * @file lib/util/version.h - * @brief Version checking functions + * @file src/lib/util/version.h * * @copyright 2016 The FreeRADIUS server project + * @copyright 2016 Arran Cudbard-Bell */ RCSIDH(version_h, "$Id$")