From 23d8384458e4354e419b5245184ab26d5a1c3c1d Mon Sep 17 00:00:00 2001 From: Arran Cudbard-Bell Date: Tue, 22 Jan 2013 00:05:43 +0000 Subject: [PATCH] Add doxygen headers to all module files --- src/modules/rlm_acctlog/Makefile | 11 ++++ src/modules/rlm_acctlog/all.mk | 7 +++ src/modules/rlm_always/rlm_always.c | 12 ++-- src/modules/rlm_attr_filter/rlm_attr_filter.c | 19 +++---- .../rlm_attr_rewrite/rlm_attr_rewrite.c | 55 +++++++++--------- src/modules/rlm_cache/rlm_cache.c | 22 ++++---- src/modules/rlm_chap/rlm_chap.c | 28 ++++------ src/modules/rlm_checkval/rlm_checkval.c | 24 ++++---- src/modules/rlm_counter/rlm_counter.c | 26 ++++----- src/modules/rlm_cram/rlm_cram.c | 53 ++++++++---------- src/modules/rlm_dbm/rlm_dbm.c | 22 ++++---- src/modules/rlm_detail/rlm_detail.c | 20 +++---- src/modules/rlm_dhcp/rlm_dhcp.c | 20 +++---- src/modules/rlm_digest/rlm_digest.c | 22 ++++---- .../rlm_dynamic_clients/rlm_dynamic_clients.c | 22 ++++---- src/modules/rlm_eap/rlm_eap.c | 24 ++++---- src/modules/rlm_eap2/rlm_eap2.c | 20 +++---- src/modules/rlm_example/rlm_example.c | 22 ++++---- src/modules/rlm_exec/rlm_exec.c | 22 ++++---- src/modules/rlm_expiration/rlm_expiration.c | 22 ++++---- src/modules/rlm_expr/rlm_expr.c | 22 ++++---- src/modules/rlm_fastusers/rlm_fastusers.c | 23 ++++---- src/modules/rlm_files/rlm_files.c | 22 ++++---- src/modules/rlm_ippool/rlm_ippool.c | 56 ++++--------------- src/modules/rlm_jradius/rlm_jradius.c | 43 +++++++------- src/modules/rlm_krb5/rlm_krb5.c | 2 +- src/modules/rlm_ldap/rlm_ldap.c | 23 ++++---- src/modules/rlm_logintime/rlm_logintime.c | 22 ++++---- src/modules/rlm_mschap/rlm_mschap.c | 44 +++++++-------- .../rlm_opendirectory/rlm_opendirectory.c | 28 +++++----- src/modules/rlm_otp/rlm_otp.c | 22 ++++---- src/modules/rlm_pam/rlm_pam.c | 35 ++++++------ src/modules/rlm_pap/rlm_pap.c | 24 ++++---- src/modules/rlm_passwd/rlm_passwd.c | 18 +++--- src/modules/rlm_perl/rlm_perl.c | 24 ++++---- src/modules/rlm_policy/rlm_policy.c | 22 ++++---- src/modules/rlm_preprocess/rlm_preprocess.c | 24 ++++---- src/modules/rlm_python/rlm_python.c | 26 +++++---- src/modules/rlm_radutmp/rlm_radutmp.c | 21 ++++--- src/modules/rlm_radutmp/rlm_radutmp2.c | 20 +++---- src/modules/rlm_realm/rlm_realm.c | 21 ++++--- src/modules/rlm_redis/rlm_redis.c | 22 ++++---- src/modules/rlm_rediswho/rlm_rediswho.c | 24 ++++---- src/modules/rlm_replicate/rlm_replicate.c | 20 +++---- src/modules/rlm_rest/rlm_rest.c | 20 +++---- src/modules/rlm_ruby/rlm_ruby.c | 18 +++--- src/modules/rlm_securid/rlm_securid.c | 27 +++++---- src/modules/rlm_sim_files/rlm_sim_files.c | 52 +++++++---------- src/modules/rlm_smsotp/rlm_smsotp.c | 22 ++++---- src/modules/rlm_soh/rlm_soh.c | 20 +++---- src/modules/rlm_sometimes/rlm_sometimes.c | 18 +++--- src/modules/rlm_sql/rlm_sql.c | 28 +++++----- src/modules/rlm_sqlcounter/rlm_sqlcounter.c | 25 ++++----- .../rlm_sqlhpwippool/rlm_sqlhpwippool.c | 39 +++++++------ src/modules/rlm_sqlippool/rlm_sqlippool.c | 26 ++++----- src/modules/rlm_unix/rlm_unix.c | 30 +++++----- src/modules/rlm_utf8/rlm_utf8.c | 21 ++++--- src/modules/rlm_wimax/rlm_wimax.c | 29 +++++----- 58 files changed, 713 insertions(+), 743 deletions(-) create mode 100644 src/modules/rlm_acctlog/Makefile create mode 100644 src/modules/rlm_acctlog/all.mk diff --git a/src/modules/rlm_acctlog/Makefile b/src/modules/rlm_acctlog/Makefile new file mode 100644 index 00000000000..6f6ee9f2506 --- /dev/null +++ b/src/modules/rlm_acctlog/Makefile @@ -0,0 +1,11 @@ +TARGET = rlm_acctlog +SRCS = rlm_acctlog.c +RLM_CFLAGS = +RLM_LIBS = + +include ../rules.mak + +$(LT_OBJS): $(HEADERS) + +install-example: + touch . diff --git a/src/modules/rlm_acctlog/all.mk b/src/modules/rlm_acctlog/all.mk new file mode 100644 index 00000000000..557861eb367 --- /dev/null +++ b/src/modules/rlm_acctlog/all.mk @@ -0,0 +1,7 @@ +TARGETNAME := rlm_acctlog + +ifneq "$(TARGETNAME)" "" +TARGET := $(TARGETNAME).a +endif + +SOURCES := $(TARGETNAME).c diff --git a/src/modules/rlm_always/rlm_always.c b/src/modules/rlm_always/rlm_always.c index a149f974d08..56decf23f0b 100644 --- a/src/modules/rlm_always/rlm_always.c +++ b/src/modules/rlm_always/rlm_always.c @@ -1,6 +1,4 @@ /* - * rlm_always.c - * * 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 @@ -15,9 +13,15 @@ * along with this program; 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 */ - + +/** + * $Id$ + * @file rlm_always.c + * @brief Return preconfigured fixed rcodes. + * + * @copyright 2000,2006 The FreeRADIUS server project + */ #include RCSID("$Id$") diff --git a/src/modules/rlm_attr_filter/rlm_attr_filter.c b/src/modules/rlm_attr_filter/rlm_attr_filter.c index 62b3bedc405..8fe84c15fe4 100644 --- a/src/modules/rlm_attr_filter/rlm_attr_filter.c +++ b/src/modules/rlm_attr_filter/rlm_attr_filter.c @@ -1,10 +1,4 @@ /* - * rlm_attr_filter.c - Filter A/V Pairs received back from proxy reqs - * before sending reply to the NAS/Server that sent - * it to us. - * - * Version: $Id$ - * * This program is is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License, version 2 if the * License as published by the Free Software Foundation. @@ -17,11 +11,16 @@ * 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 (C) 2001,2006 The FreeRADIUS server project - * Copyright (C) 2001 Chris Parker */ - + +/** + * $Id$ + * @file rlm_attr_filter.c + * @brief Filter the contents of a list, allowing only certain attributes. + * + * @copyright (C) 2001,2006 The FreeRADIUS server project + * @copyright (C) 2001 Chris Parker + */ #include RCSID("$Id$") diff --git a/src/modules/rlm_attr_rewrite/rlm_attr_rewrite.c b/src/modules/rlm_attr_rewrite/rlm_attr_rewrite.c index 4dd476ef8b3..88f3285b0ba 100644 --- a/src/modules/rlm_attr_rewrite/rlm_attr_rewrite.c +++ b/src/modules/rlm_attr_rewrite/rlm_attr_rewrite.c @@ -1,12 +1,7 @@ /* - * rlm_attr_rewrite.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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 2002,2006 The FreeRADIUS server project - * Copyright 2002 Kostas Kalevras */ - + +/** + * $Id$ + * @file rlm_attr_rewrite.c + * @brief Rewrite attribute values. + * + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2002 Kostas Kalevras + */ #include RCSID("$Id$") @@ -38,19 +38,24 @@ RCSID("$Id$") #define RLM_REGEX_INPROXYREPLY 4 typedef struct rlm_attr_rewrite_t { - char *attribute; /* The attribute to search for */ - DICT_ATTR *da; /* The attribute definition */ - char *search; /* The pattern to search for */ - int search_len; /* The length of the search pattern */ - char *searchin_str; /* The VALUE_PAIR list to search in. Can be either packet,reply,proxy,proxy_reply or control (plus it's alias 'config') */ - char searchin; /* The same as above just coded as a number for speed */ - char *replace; /* The replacement */ - int replace_len; /* The length of the replacement string */ - int append; /* Switch to control append mode (1,0) */ - int nocase; /* Ignore case */ - int new_attr; /* Boolean. Do we create a new attribute or not? */ - int num_matches; /* Maximum number of matches */ - const char *name; /* The module name */ + char *attribute; //!< The attribute to search for. + DICT_ATTR *da; //!< The attribute definition. + char *search; //!< The pattern to search for. + int search_len; //!< The length of the search pattern. + char *searchin_str; //!< The VALUE_PAIR list to search in. + //!< Can be either packet, reply, proxy, + //!< proxy_reply or control (plus it's alias + //!< 'config'). + char searchin; //!< The same as above just coded as a number + //!< for speed. + char *replace; //!< The replacement. + int replace_len; //!< The length of the replacement string. + int append; //!< Switch to control append mode (1,0). + int nocase; //!< Ignore case. + int new_attr; //!< Boolean. Whether we need to create a new + //!< attr. + int num_matches; //!< Maximum number of matches. + const char *name; //!< The module name. } rlm_attr_rewrite_t; static const CONF_PARSER module_config[] = { diff --git a/src/modules/rlm_cache/rlm_cache.c b/src/modules/rlm_cache/rlm_cache.c index 2c9fb5643fe..215f11b7b86 100644 --- a/src/modules/rlm_cache/rlm_cache.c +++ b/src/modules/rlm_cache/rlm_cache.c @@ -1,12 +1,7 @@ /* - * rlm_cache.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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 2012 The FreeRADIUS server project */ - + +/** + * $Id$ + * @file rlm_cache.c + * @brief Cache values and merge them back into future requests. + * + * @copyright 2012-2013 The FreeRADIUS server project + */ #include RCSID("$Id$") diff --git a/src/modules/rlm_chap/rlm_chap.c b/src/modules/rlm_chap/rlm_chap.c index 77383cb6a99..3606c7d5313 100644 --- a/src/modules/rlm_chap/rlm_chap.c +++ b/src/modules/rlm_chap/rlm_chap.c @@ -1,12 +1,7 @@ /* - * rlm_chap.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,15 +11,16 @@ * 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 2001,2006 The FreeRADIUS server project - * Copyright 2001 Kostas Kalevras - * - * Nov 03 2001, Kostas Kalevras - * - Added authorize() function to set Auth-Type if Chap-Password exists - * - Added module messages when rejecting user */ - + +/** + * $Id$ + * @file rlm_chap.c + * @brief Process chap authentication requests. + * + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2001 Kostas Kalevras + */ #include RCSID("$Id$") diff --git a/src/modules/rlm_checkval/rlm_checkval.c b/src/modules/rlm_checkval/rlm_checkval.c index 01d77617c62..14b04562c45 100644 --- a/src/modules/rlm_checkval/rlm_checkval.c +++ b/src/modules/rlm_checkval/rlm_checkval.c @@ -1,12 +1,7 @@ /* - * rlm_checkval.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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 2003,2006 The FreeRADIUS server project - * Copyright 2003 Kostas Kalevras */ - + +/** + * $Id$ + * @file rlm_checkval.c + * @brief Enables simple value checking. + * + * @copyright 2003,2006 The FreeRADIUS server project + * @copyright 2003 Kostas Kalevras + */ #include RCSID("$Id$") diff --git a/src/modules/rlm_counter/rlm_counter.c b/src/modules/rlm_counter/rlm_counter.c index 2219a251c4c..ebdfe8da5e6 100644 --- a/src/modules/rlm_counter/rlm_counter.c +++ b/src/modules/rlm_counter/rlm_counter.c @@ -1,12 +1,7 @@ /* - * rlm_counter.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,12 +11,17 @@ * 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 2001,2006 The FreeRADIUS server project - * Copyright 2001 Alan DeKok - * Copyright 2001-3 Kostas Kalevras */ - + +/** + * $Id$ + * @file rlm_counter.c + * @brief Provides a packet counter to track data usage and other values. + * + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2001 Alan DeKok + * @copyright 2001-2003 Kostas Kalevras + */ #include RCSID("$Id$") diff --git a/src/modules/rlm_cram/rlm_cram.c b/src/modules/rlm_cram/rlm_cram.c index 7f6e58e5b48..31530de0f18 100644 --- a/src/modules/rlm_cram/rlm_cram.c +++ b/src/modules/rlm_cram/rlm_cram.c @@ -1,12 +1,7 @@ /* - * rlm_cram.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,31 +11,27 @@ * 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 2002,2006 The FreeRADIUS server project */ - -/* - * CRAM mail authentication (APOP, CRAM-MD5) - * by 3APA3A - * - * rlm_cram module is a part of Mail authorization/authentication - * support. - * - * Attributes used (Vendor Code/PEN: 11406, you may change it to your own) - * 101 (Sandy-Mail-Authtype), selects CRAM protocol, possible values: - * 2: CRAM-MD5 - * 3: APOP - * 8: CRAM-MD4 - * 9: CRAM-SHA1 - * 102 (Sandy-Mail-Challenge), contains server's challenge (usually - * text banner) - * 103 (Sandy-Mail-Response), contains client's response, 16 octets - * for APOP/CRAM-MD5/CRAM-MD4, 20 octets for CRAM-SHA1 - * - * (c) 2002 by SANDY (http://www.sandy.ru/) under GPL + +/** + * $Id$ + * @file rlm_cram.c + * @brief CRAM mail authentication (APOP, CRAM-MD5) + @verbatim + Attributes used (Vendor Code/PEN: 11406, you may change it to your own) + 101 (Sandy-Mail-Authtype), selects CRAM protocol, possible values: + 2: CRAM-MD5 + 3: APOP + 8: CRAM-MD4 + 9: CRAM-SHA1 + 102 (Sandy-Mail-Challenge), contains server's challenge (usually + text banner) + 103 (Sandy-Mail-Response), contains client's response, 16 octets + for APOP/CRAM-MD5/CRAM-MD4, 20 octets for CRAM-SHA1 + @endverbatim + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2002 SANDY (http://www.sandy.ru/) under GPLr */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_dbm/rlm_dbm.c b/src/modules/rlm_dbm/rlm_dbm.c index 13c801c6ec3..423e55fb331 100644 --- a/src/modules/rlm_dbm/rlm_dbm.c +++ b/src/modules/rlm_dbm/rlm_dbm.c @@ -1,12 +1,7 @@ /* - * rlm_dbm.c authorize: authorize using ndbm database - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_dbm.c + * @brief Authorize using ndbm database * - * Copyright 2001 Koulik Andrei, Sandy Service - * Copyright 2006 The FreeRADIUS server project + * @copyright 2001 Koulik Andrei, Sandy Service + * @copyright 2006 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_detail/rlm_detail.c b/src/modules/rlm_detail/rlm_detail.c index 8bf6a1259bb..c7314b854af 100644 --- a/src/modules/rlm_detail/rlm_detail.c +++ b/src/modules/rlm_detail/rlm_detail.c @@ -1,12 +1,7 @@ /* - * rlm_detail.c accounting: Write the "detail" files. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_detail.c + * @brief Write plaintext versions of packets to flatfiles. * - * Copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000,2006 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_dhcp/rlm_dhcp.c b/src/modules/rlm_dhcp/rlm_dhcp.c index 6120e7721bc..a3b8bf66415 100644 --- a/src/modules/rlm_dhcp/rlm_dhcp.c +++ b/src/modules/rlm_dhcp/rlm_dhcp.c @@ -1,12 +1,7 @@ /* - * rlm_dhcp.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_dhcp.c + * @brief Will contain dhcp listener code. * - * Copyright 2012 The FreeRADIUS server project + * @copyright 2012 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_digest/rlm_digest.c b/src/modules/rlm_digest/rlm_digest.c index cc2a2478fa2..f4bc1257e86 100644 --- a/src/modules/rlm_digest/rlm_digest.c +++ b/src/modules/rlm_digest/rlm_digest.c @@ -1,12 +1,7 @@ /* - * rlm_chap.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_digest.c + * @brief Handles SIP digest authentication requests from Cisco SIP servers. * - * Copyright 2002,2006 The FreeRADIUS server project - * Copyright 2002 Alan DeKok + * @copyright 2002,2006 The FreeRADIUS server project + * @copyright 2002 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_dynamic_clients/rlm_dynamic_clients.c b/src/modules/rlm_dynamic_clients/rlm_dynamic_clients.c index 5893ff4a656..e9b61de1b63 100644 --- a/src/modules/rlm_dynamic_clients/rlm_dynamic_clients.c +++ b/src/modules/rlm_dynamic_clients/rlm_dynamic_clients.c @@ -1,12 +1,7 @@ /* - * rlm_dynamic_clients.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_dynamic_clients.c + * @brief Reads client definitions from flat files as required. * - * Copyright 2008 The FreeRADIUS server project - * Copyright 2008 Alan DeKok + * @copyright 2008 The FreeRADIUS server project + * @copyright 2008 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_eap/rlm_eap.c b/src/modules/rlm_eap/rlm_eap.c index 87b2c52b495..b59c529c2ee 100644 --- a/src/modules/rlm_eap/rlm_eap.c +++ b/src/modules/rlm_eap/rlm_eap.c @@ -1,12 +1,7 @@ /* - * rlm_eap.c contains handles that are called from modules. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,12 +11,17 @@ * 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$ + * @file rlm_eap.c + * @brief Implements the EAP framework. * - * Copyright 2000-2003,2006 The FreeRADIUS server project - * Copyright 2001 hereUare Communications, Inc. - * Copyright 2003 Alan DeKok + * @copyright 2000-2003,2006 The FreeRADIUS server project + * @copyright 2001 hereUare Communications, Inc. + * @copyright 2003 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_eap2/rlm_eap2.c b/src/modules/rlm_eap2/rlm_eap2.c index a1c23fec17b..9056c3eb35e 100644 --- a/src/modules/rlm_eap2/rlm_eap2.c +++ b/src/modules/rlm_eap2/rlm_eap2.c @@ -1,12 +1,7 @@ /* - * rlm_eap.c contains handles that are called from modules. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_eap2.c + * @brief Uses hostapd library to support some methods not provided by rlm_eap. * - * Copyright 2007 Alan DeKok + * @copyright 2007 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_example/rlm_example.c b/src/modules/rlm_example/rlm_example.c index c009b1f7b51..d52b7a04791 100644 --- a/src/modules/rlm_example/rlm_example.c +++ b/src/modules/rlm_example/rlm_example.c @@ -1,12 +1,7 @@ /* - * rlm_example.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_example.c + * @brief Example module code. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2000 your name + * @copyright 2013 The FreeRADIUS server project + * @copyright 2013 your name \ */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_exec/rlm_exec.c b/src/modules/rlm_exec/rlm_exec.c index edb9f653bbb..c843a540430 100644 --- a/src/modules/rlm_exec/rlm_exec.c +++ b/src/modules/rlm_exec/rlm_exec.c @@ -1,12 +1,7 @@ /* - * rlm_exec.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_exec.c + * @brief Execute commands and parse the results. * - * Copyright 2002,2006 The FreeRADIUS server project - * Copyright 2002 Alan DeKok + * @copyright 2002,2006 The FreeRADIUS server project + * @copyright 2002 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_expiration/rlm_expiration.c b/src/modules/rlm_expiration/rlm_expiration.c index e20a20b48d3..3d4e2f4e617 100644 --- a/src/modules/rlm_expiration/rlm_expiration.c +++ b/src/modules/rlm_expiration/rlm_expiration.c @@ -1,12 +1,7 @@ /* - * rlm_expiration.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_expiration.c + * @brief Lockout user accounts based on control attributes. * - * Copyright 2001,2006 The FreeRADIUS server project - * Copyright 2004 Kostas Kalevras + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2004 Kostas Kalevras */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_expr/rlm_expr.c b/src/modules/rlm_expr/rlm_expr.c index b8ad1c5b17e..a9b0c8acb68 100644 --- a/src/modules/rlm_expr/rlm_expr.c +++ b/src/modules/rlm_expr/rlm_expr.c @@ -1,12 +1,7 @@ /* - * rlm_expr.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_expr.c + * @brief Register many xlat expansions including the expr expansion. * - * Copyright 2002,2006 The FreeRADIUS server project - * Copyright 2002 Alan DeKok + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2002 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_fastusers/rlm_fastusers.c b/src/modules/rlm_fastusers/rlm_fastusers.c index bff0adc3d63..564be4af29a 100644 --- a/src/modules/rlm_fastusers/rlm_fastusers.c +++ b/src/modules/rlm_fastusers/rlm_fastusers.c @@ -1,13 +1,7 @@ /* - * rlm_fastusers.c authorization: Find a user in the hashed "users" file. - * accounting: Do nothing. Auth module only. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -17,11 +11,16 @@ * 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$ + * @file rlm_fastusers.c + * @brief A faster hashed version of rlm_files. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2000 Jeff Carneal + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000 Jeff Carneal */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_files/rlm_files.c b/src/modules/rlm_files/rlm_files.c index 2aff3e0d6b5..92b48744a7f 100644 --- a/src/modules/rlm_files/rlm_files.c +++ b/src/modules/rlm_files/rlm_files.c @@ -1,12 +1,7 @@ /* - * rlm_files.c authorization: Find a user in the "users" file. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_files.c + * @brief Process simple 'users' policy files. * - * Copyright 2002,2006 The FreeRADIUS server project - * Copyright 2000 Jeff Carneal + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000 Jeff Carneal */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_ippool/rlm_ippool.c b/src/modules/rlm_ippool/rlm_ippool.c index 06b398257b3..373060b1034 100644 --- a/src/modules/rlm_ippool/rlm_ippool.c +++ b/src/modules/rlm_ippool/rlm_ippool.c @@ -1,12 +1,7 @@ /* - * rlm_ippool.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,45 +11,16 @@ * 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$ + * @file rlm_ippool.c + * @brief Assign IP addresses from a GDBM database. * - * Copyright 2001,2006 The FreeRADIUS server project - * Copyright 2002 Kostas Kalevras - * - * March 2002, Kostas Kalevras - * - Initial release - * April 2002, Kostas Kalevras - * - Add support for the Pool-Name attribute - * May 2002, Kostas Kalevras - * - Check the return value of a gdbm_fetch() we didn't check - * - Change the nas entry in the ippool_key structure from uint32 to string[64] - * That should allow us to also use the NAS-Identifier attribute - * Sep 2002, Kostas Kalevras - * - Move from authorize to post-auth - * - Use mutex locks when accessing the gdbm files - * - Fail if we don't find nas port information - * Oct 2002, Kostas Kalevras - * - Do a memset(0) on the key.nas before doing searches. Nusty bug - * Jul 2003, Kostas Kalevras - * - Make Multilink work this time - * - Instead of locking file operations, lock transactions. That means we only keep - * one big transaction lock instead of per file locks (mutexes). - * Sep 2003, Kostas Kalevras - * - Fix postauth to not leak ip's - * Add an extra attribute in each entry signifying if we need to delete this - * entry in the accounting phase. This is only true in case we are doing MPPP - * Various other code changes. Code comments should explain things - * Highly experimental at this phase. - * Mar 2004, Kostas Kalevras - * - Add a timestamp and a timeout attribute in ippool_info. When we assign an ip we set timestamp - * to request->timestamp and timeout to %{Session-Timeout:-0}. When we search for a free entry - * we check if timeout has expired. If it has then we free the entry. We also add a maximum - * timeout configuration directive. If it is non zero then we also use that one to free entries. - * Jul 2004, Kostas Kalevras - * - If Pool-Name is set to DEFAULT then always run. - * Mar 2005, Kostas Kalevras - * - Make the key an MD5 of a configurable xlated string. This closes Bug #42 + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2002 Kostas Kalevras */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_jradius/rlm_jradius.c b/src/modules/rlm_jradius/rlm_jradius.c index f8ac47fc820..eebfacf26b2 100644 --- a/src/modules/rlm_jradius/rlm_jradius.c +++ b/src/modules/rlm_jradius/rlm_jradius.c @@ -1,31 +1,32 @@ -/** - * rlm_jradius - The FreeRADIUS JRadius Server Module - * Copyright (C) 2004-2006 PicoPoint, B.V. - * Copyright (c) 2007-2008 David Bird - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * - * 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., - * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * 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 + */ + +/** + * $Id$ + * @file rlm_jradius.c + * @brief Connect to the JRadius policy server. * * This module is used to connect FreeRADIUS to the JRadius server. * JRadius is a Java RADIUS client and server framework, see doc/rlm_jradius * and http://jradius.net/ for more information. * - * Author(s): David Bird - * - * Connection pooling code based on rlm_sql, see rlm_sql/sql.c for copyright and license. + * @todo should integrate with connection API. + * @author David Bird + * @copyright 2004-2006 PicoPoint, B.V. + * @copyright 2007-2008 David Bird */ - #include #include #include diff --git a/src/modules/rlm_krb5/rlm_krb5.c b/src/modules/rlm_krb5/rlm_krb5.c index c4fb9c909a6..76ac16857f3 100644 --- a/src/modules/rlm_krb5/rlm_krb5.c +++ b/src/modules/rlm_krb5/rlm_krb5.c @@ -14,7 +14,7 @@ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ -/* +/** * $Id$ * @file rlm_krb5.c * @brief Module to authenticate against krb5. diff --git a/src/modules/rlm_ldap/rlm_ldap.c b/src/modules/rlm_ldap/rlm_ldap.c index 7631a5c5eda..8fae0888cb8 100644 --- a/src/modules/rlm_ldap/rlm_ldap.c +++ b/src/modules/rlm_ldap/rlm_ldap.c @@ -1,10 +1,7 @@ /* - * rlm_ldap.c LDAP authorization and authentication module. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -14,13 +11,17 @@ * 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$ + * @file rlm_ldap.c + * @brief LDAP authorization and authentication module. * - * Copyright 1999-2012 The FreeRADIUS Server Project. - * - * Copyright 2012 Alan DeKok - * Copyright 2012 Arran Cudbard-Bell + * @copyright 1999-2013 The FreeRADIUS Server Project. + * @copyright 2012 Alan DeKok + * @copyright 2012-2013 Arran Cudbard-Bell */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_logintime/rlm_logintime.c b/src/modules/rlm_logintime/rlm_logintime.c index 2fdffaf10fe..714eb3e057b 100644 --- a/src/modules/rlm_logintime/rlm_logintime.c +++ b/src/modules/rlm_logintime/rlm_logintime.c @@ -1,12 +1,7 @@ /* - * rlm_logintime.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_logintime.c + * @brief Allow login only during a given timeslot. * - * Copyright 2001,2006 The FreeRADIUS server project - * Copyright 2004 Kostas Kalevras + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2004 Kostas Kalevras */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_mschap/rlm_mschap.c b/src/modules/rlm_mschap/rlm_mschap.c index 97709966394..ff20ea7592f 100644 --- a/src/modules/rlm_mschap/rlm_mschap.c +++ b/src/modules/rlm_mschap/rlm_mschap.c @@ -1,12 +1,7 @@ /* - * rlm_mschap.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,12 +11,17 @@ * 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$ + * @file rlm_mschap.c + * @brief Implemented mschap authentication. * - * Copyright 2000,2001,2006 The FreeRADIUS server project + * @copyright 2000,2001,2006 The FreeRADIUS server project */ /* MPPE support from Takahiro Wagatsuma */ - #include RCSID("$Id$") @@ -45,18 +45,18 @@ extern int od_mschap_auth(REQUEST *request, VALUE_PAIR *challenge, VALUE_PAIR * #endif /* Allowable account control bits */ -#define ACB_DISABLED 0x0001 /* 1 = User account disabled */ -#define ACB_HOMDIRREQ 0x0002 /* 1 = Home directory required */ -#define ACB_PWNOTREQ 0x0004 /* 1 = User password not required */ -#define ACB_TEMPDUP 0x0008 /* 1 = Temporary duplicate account */ -#define ACB_NORMAL 0x0010 /* 1 = Normal user account */ -#define ACB_MNS 0x0020 /* 1 = MNS logon user account */ -#define ACB_DOMTRUST 0x0040 /* 1 = Interdomain trust account */ -#define ACB_WSTRUST 0x0080 /* 1 = Workstation trust account */ -#define ACB_SVRTRUST 0x0100 /* 1 = Server trust account */ -#define ACB_PWNOEXP 0x0200 /* 1 = User password does not expire */ -#define ACB_AUTOLOCK 0x0400 /* 1 = Account auto locked */ -#define ACB_PW_EXPIRED 0x00020000 /* 1 = Password Expired */ +#define ACB_DISABLED 0x00010000 //!< User account disabled. +#define ACB_HOMDIRREQ 0x00020000 //!< Home directory required. +#define ACB_PWNOTREQ 0x00040000 //!< User password not required. +#define ACB_TEMPDUP 0x00080000 //!< Temporary duplicate account. +#define ACB_NORMAL 0x00100000 //!< Normal user account. +#define ACB_MNS 0x00200000 //!< MNS logon user account. +#define ACB_DOMTRUST 0x00400000 //!< Interdomain trust account. +#define ACB_WSTRUST 0x00800000 //!< Workstation trust account. +#define ACB_SVRTRUST 0x01000000 //!< Server trust account. +#define ACB_PWNOEXP 0x02000000 //!< User password does not expire. +#define ACB_AUTOLOCK 0x04000000 //!< Account auto locked. +#define ACB_PW_EXPIRED 0x00020000 //!< Password Expired. static int pdb_decode_acct_ctrl(const char *p) { diff --git a/src/modules/rlm_opendirectory/rlm_opendirectory.c b/src/modules/rlm_opendirectory/rlm_opendirectory.c index 9c9c48599ad..27ed2020980 100644 --- a/src/modules/rlm_opendirectory/rlm_opendirectory.c +++ b/src/modules/rlm_opendirectory/rlm_opendirectory.c @@ -1,31 +1,33 @@ /* - * rlm_opendirectory.c - * authentication: Apple Open Directory authentication - * authorization: enforces ACLs - * - * Version: $Id$ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License version 2 only, as published by - * the Free Software Foundation. + * This program is is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * 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 version 2 + * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** + * $Id$ + * @file rlm_opendirectory.c + * @brief Allows authentication against OpenDirectory and enforces ACLS. * - * Copyright 2007 Apple Inc. + * authentication: Apple Open Directory authentication + * authorization: enforces ACLs + * + * @copyright 2007 Apple Inc. */ /* * For a typical Makefile, add linker flag like this: * LDFLAGS = -framework DirectoryService */ - #include #include #include diff --git a/src/modules/rlm_otp/rlm_otp.c b/src/modules/rlm_otp/rlm_otp.c index c9aa8dcb723..fe5842312f1 100644 --- a/src/modules/rlm_otp/rlm_otp.c +++ b/src/modules/rlm_otp/rlm_otp.c @@ -1,10 +1,7 @@ /* - * $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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -14,12 +11,17 @@ * 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$ + * @file rlm_otp.c + * @brief One time password implementation. * - * Copyright 2000,2001,2002 The FreeRADIUS server project - * Copyright 2001,2002 Google, Inc. - * Copyright 2005-2007 TRI-D Systems, Inc. + * @copyright 2000,2001,2002 The FreeRADIUS server project + * @copyright 2001,2002 Google, Inc. + * @copyright 2005-2007 TRI-D Systems, Inc. */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_pam/rlm_pam.c b/src/modules/rlm_pam/rlm_pam.c index db3078c6a3d..10255e3e9bc 100644 --- a/src/modules/rlm_pam/rlm_pam.c +++ b/src/modules/rlm_pam/rlm_pam.c @@ -1,18 +1,7 @@ /* - * pam.c Functions to access the PAM library. This was taken - * from the hacks that miguel a.l. paraz - * did on radiusd-cistron-1.5.3 and migrated to a - * separate file. - * - * That, in fact, was again based on the original stuff - * from Jeph Blaize done in May 1997. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -22,12 +11,22 @@ * 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$ + * @file rlm_pam.c + * @brief Interfaces with the PAM library to allow auth via PAM. + * + * @note This was taken from the hacks that miguel a.l. paraz + * @note did on radiusd-cistron-1.5.3 and migrated to a separate file. + * @note That, in fact, was again based on the original stuff from + * @note Jeph Blaize done in May 1997. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 1997 Jeph Blaize - * Copyright 1999 miguel a.l. paraz + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 1997 Jeph Blaize + * @copyright 1999 miguel a.l. paraz */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_pap/rlm_pap.c b/src/modules/rlm_pap/rlm_pap.c index 5c970615c37..05a37b73c70 100644 --- a/src/modules/rlm_pap/rlm_pap.c +++ b/src/modules/rlm_pap/rlm_pap.c @@ -1,12 +1,7 @@ /* - * rlm_pap.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,12 +11,17 @@ * 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$ + * @file rlm_pap.c + * @brief Hashes plaintext passwords to compare against a prehashed reference. * - * Copyright 2001-2012 The FreeRADIUS server project - * Copyright 2012 Matthew Newton - * Copyright 2001 Kostas Kalevras + * @copyright 2001-2012 The FreeRADIUS server project. + * @copyright 2012 Matthew Newton + * @copyright 2001 Kostas Kalevras */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_passwd/rlm_passwd.c b/src/modules/rlm_passwd/rlm_passwd.c index 4a4d93b515d..3b28c318423 100644 --- a/src/modules/rlm_passwd/rlm_passwd.c +++ b/src/modules/rlm_passwd/rlm_passwd.c @@ -1,10 +1,7 @@ /* - * rlm_passwd.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -14,10 +11,15 @@ * 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$ + * @file rlm_passwd.c + * @brief Enables authentication against unix passwd files. * - * Copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000,2006 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_perl/rlm_perl.c b/src/modules/rlm_perl/rlm_perl.c index 056b0681309..51e1b2bea26 100644 --- a/src/modules/rlm_perl/rlm_perl.c +++ b/src/modules/rlm_perl/rlm_perl.c @@ -1,12 +1,7 @@ - /* - * rlm_perl.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_perl.c + * @brief Translates requests between the server an a perl interpreter. * - * Copyright 2002,2006 The FreeRADIUS server project - * Copyright 2002 Boian Jordanov + * @copyright 2002,2006 The FreeRADIUS server project + * @copyright 2002 Boian Jordanov */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_policy/rlm_policy.c b/src/modules/rlm_policy/rlm_policy.c index 1e9019721a9..9917eaace66 100644 --- a/src/modules/rlm_policy/rlm_policy.c +++ b/src/modules/rlm_policy/rlm_policy.c @@ -1,12 +1,7 @@ /* - * rlm_policy.c Implements a policy language - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_policy.c + * @brief Implements a policy language (which is defunct as should not be used). * - * Copyright 2004 Alan DeKok - * Copyright 2006 The FreeRADIUS server project + * @copyright 2004 Alan DeKok + * @copyright 2006 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_preprocess/rlm_preprocess.c b/src/modules/rlm_preprocess/rlm_preprocess.c index f9180c42518..efbcccb55d4 100644 --- a/src/modules/rlm_preprocess/rlm_preprocess.c +++ b/src/modules/rlm_preprocess/rlm_preprocess.c @@ -1,14 +1,7 @@ /* - * rlm_preprocess.c - * Contains the functions for the "huntgroups" and "hints" - * files. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -18,11 +11,16 @@ * 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$ + * @file rlm_preprocess.c + * @brief Fixes up requests, and processes huntgroups/hints files. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2000 Alan DeKok + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_python/rlm_python.c b/src/modules/rlm_python/rlm_python.c index dcdad51ed25..12e489aee12 100644 --- a/src/modules/rlm_python/rlm_python.c +++ b/src/modules/rlm_python/rlm_python.c @@ -1,11 +1,7 @@ /* - * rlm_python.c - * - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -15,13 +11,19 @@ * 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$ + * @file rlm_python.c + * @brief Translates requests between the server an a python interpreter. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2002 Miguel A.L. Paraz - * Copyright 2002 Imperium Technology, Inc. - * - rewritten by Paul P. Komkoff Jr + * @note Rewritten by Paul P. Komkoff Jr . + * + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2002 Miguel A.L. Paraz + * @copyright 2002 Imperium Technology, Inc. */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_radutmp/rlm_radutmp.c b/src/modules/rlm_radutmp/rlm_radutmp.c index 59dafb01a65..e4d39765f04 100644 --- a/src/modules/rlm_radutmp/rlm_radutmp.c +++ b/src/modules/rlm_radutmp/rlm_radutmp.c @@ -1,12 +1,7 @@ /* - * rlm_radutmp.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,15 @@ * 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$ + * @file rlm_radutmp.c + * @brief Tracks sessions. * - * Copyright 2000,2006 The FreeRADIUS server project - * FIXME add copyrights + * @copyright 2000-2013 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_radutmp/rlm_radutmp2.c b/src/modules/rlm_radutmp/rlm_radutmp2.c index 9ee24b7dba1..eb7b787a848 100644 --- a/src/modules/rlm_radutmp/rlm_radutmp2.c +++ b/src/modules/rlm_radutmp/rlm_radutmp2.c @@ -1,12 +1,7 @@ /* - * rlm_radutmp.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_radutmp2.c + * @brief Tracks sessions. * - * Copyright 2000,2001,2002,2003,2004,2006 The FreeRADIUS server project + * @copyright 2000-2013 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_realm/rlm_realm.c b/src/modules/rlm_realm/rlm_realm.c index 6bda294be66..fe886150626 100644 --- a/src/modules/rlm_realm/rlm_realm.c +++ b/src/modules/rlm_realm/rlm_realm.c @@ -1,12 +1,7 @@ /* - * rlm_realm.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,15 @@ * 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$ + * @file rlm_realm.c + * @brief Parses NAIs and assigns requests to realms. * - * Copyright 2000,2006 The FreeRADIUS server project - * FIXME add copyrights + * @copyright 2000-2013 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_redis/rlm_redis.c b/src/modules/rlm_redis/rlm_redis.c index 9a3f35105d7..2bde1f0e63f 100644 --- a/src/modules/rlm_redis/rlm_redis.c +++ b/src/modules/rlm_redis/rlm_redis.c @@ -1,12 +1,7 @@ /* - * rlm_redis.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_redis.c + * @brief Driver for the REDIS noSQL key value stores. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2011 TekSavvy Solutions + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2011 TekSavvy Solutions */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_rediswho/rlm_rediswho.c b/src/modules/rlm_rediswho/rlm_rediswho.c index 45c543f03e5..0d6f85f354a 100644 --- a/src/modules/rlm_rediswho/rlm_rediswho.c +++ b/src/modules/rlm_rediswho/rlm_rediswho.c @@ -1,12 +1,7 @@ /* - * rlm_rediswho.c rlm_rediswho - FreeRADIUS redis/bashtable "radwho" Module - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -15,12 +10,17 @@ * * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** + * $Id$ + * @file rlm_redis_who.c + * @brief Session tracking using redis. * - * Copyright 2006 The FreeRADIUS server project - * Copyright 2011 TekSavvy Solutions Inc + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2011 TekSavvy Solutions */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_replicate/rlm_replicate.c b/src/modules/rlm_replicate/rlm_replicate.c index a6c4feab694..88288ec429b 100644 --- a/src/modules/rlm_replicate/rlm_replicate.c +++ b/src/modules/rlm_replicate/rlm_replicate.c @@ -1,12 +1,7 @@ /* - * rlm_replicate.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_replicate.c + * @brief Duplicate RADIUS requests. * - * Copyright 2011,2012 The FreeRADIUS server project + * @copyright 2011-2013 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_rest/rlm_rest.c b/src/modules/rlm_rest/rlm_rest.c index 13c37ddc17e..bb6a53ad08a 100644 --- a/src/modules/rlm_rest/rlm_rest.c +++ b/src/modules/rlm_rest/rlm_rest.c @@ -1,12 +1,7 @@ /* - * rlm_rest.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_rest.c + * @brief Integrate FreeRADIUS with RESTfull APIs * - * Copyright 2012 Arran Cudbard-Bell > + * @copyright 2012-2013 Arran Cudbard-Bell */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_ruby/rlm_ruby.c b/src/modules/rlm_ruby/rlm_ruby.c index 3a0bb2b4208..b52a8976dc2 100644 --- a/src/modules/rlm_ruby/rlm_ruby.c +++ b/src/modules/rlm_ruby/rlm_ruby.c @@ -1,11 +1,7 @@ /* - * rlm_ruby.c - * - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -15,8 +11,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 + */ + +/** + * $Id$ + * @file rlm_ruby.c + * @brief Translates requests between the server an a ruby interpreter. * - * Copyright 2008 Andriy Dmytrenko aka Antti, BuzhNET + * @copyright 2008 Andriy Dmytrenko aka Antti, BuzhNET */ #include diff --git a/src/modules/rlm_securid/rlm_securid.c b/src/modules/rlm_securid/rlm_securid.c index 5b930a0c3df..681d5ef11f3 100644 --- a/src/modules/rlm_securid/rlm_securid.c +++ b/src/modules/rlm_securid/rlm_securid.c @@ -1,15 +1,7 @@ /* - * rlm_securid.c - * - * Version: $Id$ - * - * supports "next-token code" and "new-pin" modes - * - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -19,11 +11,18 @@ * 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$ + * @file rlm_securid.c + * @brief Supports auth against SecurID servers using OTP h/w tokens. + * + * Supports "next-token code" and "new-pin" modes. * - * Copyright 2012 The FreeRADIUS server project - * Copyright 2012 Alan DeKok + * @copyright 2012 The FreeRADIUS server project + * @copyright 2012 Alan DeKok */ - #include #include #include diff --git a/src/modules/rlm_sim_files/rlm_sim_files.c b/src/modules/rlm_sim_files/rlm_sim_files.c index cc2826c4190..cdb14c31c16 100644 --- a/src/modules/rlm_sim_files/rlm_sim_files.c +++ b/src/modules/rlm_sim_files/rlm_sim_files.c @@ -1,13 +1,7 @@ /* - * rlm_sim_files.c authorization: Find a SIM user in the "simtriplets" - * file. - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -17,43 +11,37 @@ * 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$ * - * Copyright 2004 Michael Richardson - * Copyright 2006 The FreeRADIUS server project + * @file rlm_sim_files.c + * @brief Parses simtriplets files to provide a data src for eap_sim. * - * (Adapted from rlm_files/rlm_files.c ) - */ - -/* - * this is an authorization-only module that walks the file every time. + * This is an authorization-only module that walks the file every time. * - * this is an example of getting data for rlm_eap_sim from an external + * This is an example of getting data for rlm_eap_sim from an external * place. * - * in a real system, this would be replaced with a lookup to the SS7 + * In a real system, this would be replaced with a lookup to the SS7 * network, but those interfaces are distinctly non-standard, and might - * even be totally proprietary - * - */ - -/* FILE FORMAT - * + * even be totally proprietary. * * The triplets file contains records of the form: +@verbatim +IMSI RAND SRES Kc +232420100000015,30000000000000000000000000000000,30112233,445566778899AABB +@endverbatim * - * IMSI RAND SRES Kc - * 232420100000015,30000000000000000000000000000000,30112233,445566778899AABB - * - * there must be *three* entries for every IMSI for it to be considered valid. - * + * There must be *three* entries for every IMSI for it to be considered valid. * Lines starting with # are ignored. * * Conveniently, this file format is produced by XXXX. - * + * @copyright 2004 Michael Richardson + * @copyright 2006 The FreeRADIUS server project */ - - #include RCSID("$Id$") diff --git a/src/modules/rlm_smsotp/rlm_smsotp.c b/src/modules/rlm_smsotp/rlm_smsotp.c index c0955eead5e..8c4f20ad33c 100644 --- a/src/modules/rlm_smsotp/rlm_smsotp.c +++ b/src/modules/rlm_smsotp/rlm_smsotp.c @@ -1,12 +1,7 @@ /* - * rlm_smsotp.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,16 @@ * 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$ + * @file rlm_smsotp.c + * @brief Supports OTP authentication using SMS. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2009 Siemens AG, Holger Wolff holger.wolff@siemens.com + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2009 Siemens AG, Holger Wolff holger.wolff@siemens.com */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_soh/rlm_soh.c b/src/modules/rlm_soh/rlm_soh.c index 4140fd66566..67721fff4c7 100644 --- a/src/modules/rlm_soh/rlm_soh.c +++ b/src/modules/rlm_soh/rlm_soh.c @@ -1,12 +1,7 @@ /* - * rlm_soh.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,10 +11,15 @@ * 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$ + * @file rlm_soh.c + * @brief Decodes Microsoft's Statement of Health sub-protocol. * - * Copyright 2010 Phil Mayers + * @copyright 2010 Phil Mayers */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_sometimes/rlm_sometimes.c b/src/modules/rlm_sometimes/rlm_sometimes.c index dd945018827..7601dd7054b 100644 --- a/src/modules/rlm_sometimes/rlm_sometimes.c +++ b/src/modules/rlm_sometimes/rlm_sometimes.c @@ -1,10 +1,7 @@ /* - * rlm_sometimes.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -14,10 +11,15 @@ * 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$ + * @file rlm_sometimes.c + * @brief Switches between retuning different return codes. * - * Copyright 2000,2006 The FreeRADIUS server project + * @copyright 2012 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_sql/rlm_sql.c b/src/modules/rlm_sql/rlm_sql.c index 3a59151d0f0..66ed5e77ff3 100644 --- a/src/modules/rlm_sql/rlm_sql.c +++ b/src/modules/rlm_sql/rlm_sql.c @@ -1,14 +1,7 @@ - /* - * rlm_sql.c SQL Module - * Main SQL module file. Most ICRADIUS code is located in sql.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -18,13 +11,18 @@ * 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$ + * @file rlm_sql.c + * @brief Implements SQL 'users' file, and SQL accounting. * - * Copyright 2012 Arran Cudbard-Bell - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2000 Mike Machado - * Copyright 2000 Alan DeKok + * @copyright 2012 Arran Cudbard-Bell + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000 Mike Machado + * @copyright 2000 Alan DeKok */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_sqlcounter/rlm_sqlcounter.c b/src/modules/rlm_sqlcounter/rlm_sqlcounter.c index 683c2d67141..783c0763a13 100644 --- a/src/modules/rlm_sqlcounter/rlm_sqlcounter.c +++ b/src/modules/rlm_sqlcounter/rlm_sqlcounter.c @@ -1,12 +1,7 @@ /* - * rlm_sqlcounter.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,14 +11,16 @@ * 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$ + * @file rlm_sqlcounter.c + * @brief Tracks data usage and other counters using SQL. * - * Copyright 2001,2006 The FreeRADIUS server project - * Copyright 2001 Alan DeKok + * @copyright 2001,2006 The FreeRADIUS server project + * @copyright 2001 Alan DeKok */ - -/* This module is based directly on the rlm_counter module */ - - #include RCSID("$Id$") diff --git a/src/modules/rlm_sqlhpwippool/rlm_sqlhpwippool.c b/src/modules/rlm_sqlhpwippool/rlm_sqlhpwippool.c index 170ecf340ca..b8515922c76 100644 --- a/src/modules/rlm_sqlhpwippool/rlm_sqlhpwippool.c +++ b/src/modules/rlm_sqlhpwippool/rlm_sqlhpwippool.c @@ -1,25 +1,22 @@ /* - * rlm_sqlhpwippool.c - * Chooses an IPv4 address from pools defined in ASN Netvim + * This program is is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * - * Version: $Id$ + * 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 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., 59 Temple - * Place, Suite 330, Boston, MA 02111-1307 USA - * - * Copyright (c) 2005-2006 Pawel Foremski , - * 2000-2006 The FreeRADIUS server project + * 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$ + * @file rlm_sqlhpwippool.c + * @brief Allocates an IPv4 address from pools defined in ASN Netvim. * * Current bugs/limits: * - probably works only with newer versions of MySQL (subqueries) @@ -31,8 +28,10 @@ * - pool names (fetched from database) are not "escaped" * - you have to set encoding of radius.acctuniqueid to same as * netvim.ips.rsv_by + * + * @copyright 2005-2006 Pawel Foremski , + * @copyright 2000-2006 The FreeRADIUS server project */ - #include #include #include diff --git a/src/modules/rlm_sqlippool/rlm_sqlippool.c b/src/modules/rlm_sqlippool/rlm_sqlippool.c index c7479a441d4..7371283889e 100644 --- a/src/modules/rlm_sqlippool/rlm_sqlippool.c +++ b/src/modules/rlm_sqlippool/rlm_sqlippool.c @@ -1,12 +1,7 @@ /* - * rlm_sqlippool.c rlm_sqlippool - FreeRADIUS SQL IP Pool Module - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -15,13 +10,18 @@ * * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA + */ + +/** + * $Id$ + * @file rlm_sqlippool.c + * @brief Allocates an IPv4 address from pools stored in SQL. * - * Copyright 2002 Globe.Net Communications Limited - * Copyright 2006 The FreeRADIUS server project - * Copyright 2006 Suntel Communications + * @copyright 2002 Globe.Net Communications Limited + * @copyright 2006 The FreeRADIUS server project + * @copyright 2006 Suntel Communications */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_unix/rlm_unix.c b/src/modules/rlm_unix/rlm_unix.c index ca832b3c59e..21a0639e56b 100644 --- a/src/modules/rlm_unix/rlm_unix.c +++ b/src/modules/rlm_unix/rlm_unix.c @@ -1,14 +1,7 @@ /* - * rlm_unix.c authentication: Unix user authentication - * accounting: Functions to write radwtmp file. - * Also contains handler for "Group". - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -18,12 +11,21 @@ * 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$ + * @file rlm_unix.c + * @brief Unixy things * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2000 Jeff Carneal - * Copyright 2000 Alan Curry + * authentication: Unix user authentication + * accounting: Functions to write radwtmp file. + * Also contains handler for "Group". + * + * @copyright 2000,2006 The FreeRADIUS server project + * @copyright 2000 Jeff Carneal + * @copyright 2000 Alan Curry */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_utf8/rlm_utf8.c b/src/modules/rlm_utf8/rlm_utf8.c index c71073ad02b..2c031ab48f5 100644 --- a/src/modules/rlm_utf8/rlm_utf8.c +++ b/src/modules/rlm_utf8/rlm_utf8.c @@ -1,12 +1,7 @@ /* - * rlm_utf8.c - * - * 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 is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2 if the + * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -16,11 +11,15 @@ * 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$ + * @file rlm_utf8.c + * @brief Enforce UTF8 encoding in strings. * - * Copyright 2000,2006 The FreeRADIUS server project - * Copyright 2000 your name + * @copyright 2000,2006 The FreeRADIUS server project */ - #include RCSID("$Id$") diff --git a/src/modules/rlm_wimax/rlm_wimax.c b/src/modules/rlm_wimax/rlm_wimax.c index 33fa50cb570..ea747cd97ec 100644 --- a/src/modules/rlm_wimax/rlm_wimax.c +++ b/src/modules/rlm_wimax/rlm_wimax.c @@ -1,20 +1,21 @@ /* - * rlm_wimax.c - * - * Version: $Id$ - * - * Copyright (C) 2008 Alan DeKok + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT + * OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT + * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER + * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR + * IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ + +/** + * $Id$ + * @file rlm_wimax.c + * @brief Supports various WiMax functionality. * - * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, - * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF - * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT - * OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT - * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER - * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR - * IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE - * SOFTWARE. + * @copyright 2008 Alan DeKok */ - #include RCSID("$Id$") -- 2.47.3