Note recent changes
[freeradius.git] / doc / ChangeLog
1 FreeRADIUS 2.1.4 Thu Dec 25 17:40:00 CEST 2008;  , urgency=medium
2         Feature improvements
3         * Permit multiple "-e" in radmin.
4         * Add support for originating CoA-Request and Disconnect-Request.
5           See raddb/sites-available/originate-coa.
6         * Added "lifetime" and "max_queries" to raddb/sql.conf.
7           This helps address the problem of hung SQL sockets.
8         * Change default message digest algorithm for sample certificates
9           to be SHA1.  MD5 is broken.
10
11         Bug fixes
12         * Clean up control sockets when they are closed, so that we don't
13           leak memory.
14         * Define SUN_LEN for systems that don't have it.
15         * Correct some boundary conditions in the conditional checker ("if")
16           in "unlang".  Bug noted by Arran Cudbard-Bell.
17         * Work around minor building issues in gmake.  This should only
18           have affected developers.
19         * Change how we manage unprivileged user/group, so that we do not
20           create control sockets owned by root.
21         * Fixed more minor issues found by Coverity.
22         * Allow raddb/certs/bootstrap to run when there is no "make"
23           command installed.
24         * In radiusd.conf, run_dir depends on the name of the program,
25           and isn't hard-coded to "..../radiusd"
26         * Check for EOF in more places in the "detail" file reader.
27         * Added Freeswitch dictionary.
28         * Chop ethernet frames in VMPS, rather than droppping packets.
29         * Fix EAP-TLS bug.  Patch from Arnaud Ebalard
30         * Don't lose string for regex-compares in the "users" file.
31         * Expose more functions in rlm_sql to rlm_sqlippool, which 
32           helps on systems where RTLD_GLOBAL is off.
33
34 FreeRADIUS 2.1.3 Fri Dec 5 17:40:00 CEST 2008;  , urgency=medium
35         Feature improvements
36         * Allow running with "user=radiusd" and binding to secure
37           sockets.
38         * Start sending Status-Server "are you alive" messages earlier,
39           which helps with proxying multiple realms to a home server.
40         * Removed thread pool code from rlm_perl.  It's not necessary.
41         * Added example Perl configuration to raddb/modules/perl
42         * Force OpenSSL to support certificates with SHA256.
43           This seems to be necessary for WiMAX certs.
44
45         Bug fixes
46         * Fix Debian patch to allow it to build.
47         * Fix potential NULL dereference in debugging mode on certain
48           platforms for TTLS and PEAP inner tunnels.
49         * Fix uninitialized memory in handling of vendor definitions
50         * Fix parsing of quoted (but non-string) attributes in the "users"
51           file.
52         * Initialize uknown NAS IP to 255.255.255.255, rather than 0.0.0.0
53         * use SUN_LEN in control socket, to avoid truncation on some
54           platforms.
55         * Correct internal handling of "debug condition" to prevent it
56           from being over-written.
57         * Check return code of regcomp in "unlang", so that invalid
58           regular expressions are caught rather than mishandled.
59         * Make rlm_sql use <ltdl.h>.  Addresses bug #610.
60         * Document list "type = status" better.  Closes bug #580.
61         * Set "default days" for certificates, because OpenSSL won't
62           do it.  This closes bug #615.
63         * Reference correct list in example raddb/modules/ldap.
64           Closes #596.
65         * Increase default schema size for Acct-Session-Id to 64.
66           Closes #540.
67         * Fix use of temporary files in dialup-admin.  Closes #605
68           and addresses CVE-2008-4474.
69         * Addressed a number of minor issues found by Coverity.
70         * Added DHCP option 150 to the dictionary.  Closes #618.
71
72 FreeRADIUS 2.1.2 Thurs Dec 3 10:47:00 CEST 2008;  , urgency=medium
73         Due to packaging issues, 2.1.2 has been pulled from the net.
74
75 FreeRADIUS 2.1.1 Thu Sep 25 11:03:00 CEST 2008;  , urgency=medium
76         Feature improvements
77         * Many more options and features in radmin.  See "man radmin" and
78           raddb/sites-available/control-socket
79         * Many more commands available via the control socket.  Connect
80           via "radmin", and type "help" for more information.
81         * Added dictionary.networkphysics and dictionary.lancom.
82         * Calculate WiMAX MIP keys, and added sample WiMAX SQL tables.
83
84         Bug fixes
85         * Fixed bug that made radmin not work
86         * Fixed Suse && Debian package scripts
87         * Fixed issues with dynamic clients
88         * Fixed configure checks for -lreadline
89         * rlm_sqlippool no longer needs to be linked to rlm_sql.
90         * Add statistics for detail file listeners.  This closes bug #593.
91         * Fixed printing of some WiMAX attributes.
92         * Fix double free on exit() in rlm_attr_filter
93         * Fixed build issues on Solaris.
94         * Fixed fast session resumption for EAP-TLS
95
96 FreeRADIUS 2.1.0 Fri Sep  5 13:20:01 CEST 2008;  , urgency=medium
97         Feature improvements
98         * Clients may now be defined dynamically, based on IP address.
99           See raddb/sites-available/dynamic-clients.
100         * SNMP support is now available through an experimental Perl script.
101           See scripts/snmp-proxy/README
102         * SNMP statistics are available through Status-Server packets.
103           See raddb/sites-available/status
104         * Added more Microsoft attributes from bug #568.
105         * The "linelog" module has more functionality and flexibility.
106           See raddb/modules/linelog.
107         * The debugging output has been sanitized.  It should be much
108           more readable.
109         * Debug logs can now be turned on/off while the server is running, for
110           a user, group, realm, etc.  See the "log" section of radiusd.conf.
111         * Added support for WiMAX Forum attributes.  The dynamic keys
112           are not yet calculated.  See share/dictionary.wimax
113         * Added session resumption for PEAP and TTLS.
114           See raddb/eap.conf, "cache" sub-section.
115         * Added "radmin" command-line tool for administering a running server.
116           See "man radmin" and raddb/sites-available/control-socket.
117
118         Bug fixes
119         * Double escaping of '\\' in the "users" (and some other) files
120           has been fixed.  If you have '\\' in the "users" file, your
121           configuration WILL NEED TO BE CHECKED, AND FIXED!
122         * Parse "security" section in radiusd.conf.  This was accidentally
123           deleted in 2.0.5.  Closes bug #566.
124         * Bind to interface before IP, which allows DHCP sockets to
125           listen on "*" for multiple interfaces.
126         * Fix handling of giaddr in DHCP responses.
127         * Corrected parsing of status_check in home_server so that it works.
128         * Fix hints so that "Puser" works again.
129         * Removed length restrictions on attribute names in the dictionaries.
130         * Update socket code to avoid C compiler optimizations.
131
132 FreeRADIUS 2.0.5 ; Date: 2008/06/07 17:17:00 , urgency=medium
133         Feature improvements
134         * Permit SQL authorize_reply_query to be empty.
135         * Allow setting response packet type in Post-Proxy-Type Fail
136           handler.
137         * Added install-chown target to set correct permission and ownership
138           make RADMIN=radmin RGROUP=radius install-chown
139         * Support for LDAP-Group and other dynamic comparison attributes
140           in unlang.  Developed from a patch by Jason Alderfer.
141         * Added chroot support.  See radiusd.conf for comments.
142         * Allow clients of 0/0.  We do not recommend using this, though.
143         * Moved many module configurations into raddb/modules/*
144         
145         Bug fixes
146         * Allow proxying to virtual servers for accounting packets, too.
147         * Added "num fields" function to PostgreSQL client.
148         * Updated proxy fallback mechanism to validate fallback servers,
149           and to process fallback requests in a child thread.
150         * rlm_realm returns "ok" for LOCAL realms, not "noop".
151         * Fixed some DHCP code handling.  The examples should now work.
152
153 FreeRADIUS 2.0.4 ; Date: 2008/04/30 08:56:40  , urgency=medium
154         Feature improvements
155         * Allow "virtual_server" in "realm" and "home_server" sections.
156           See raddb/proxy.conf and raddb/sites-available/virtual.example.com.
157         * Allow "passwd" module to be listed in "accounting" and "post-auth".
158         * Added "fallback" to "home_server_pool" configuration, to handle
159           the case of all home servers being dead.  See raddb/proxy.conf.
160         * Added sample text to raddb/sites-available/inner-tunnel which
161           can simplify debugging of inner tunnel configurations.
162         * Added regular expression matching in realm names.  See
163           raddb/proxy.conf for examples.
164         * Added simple DHCP server functionality.  For comments, see
165           raddb/sites-available/dhcp.
166         * Added file globbing capabilities to detail file reader
167         * Added sample raddb/sites-available/robust-proxy-accounting
168         * Clients in SQL can now refer to a virtual server.
169           Patch from Michael Bretterklieber.
170         * Added some examples of creating RADIUS administrator in SQL,
171           and assigning appropriate access rights.
172         
173         Bug fixes
174         * Install all files in raddb/sites-available
175         * Allow non-threaded builds.
176         * Don't treat '0x' as special for known attributes that are not
177           of type "octets".
178         * Fix log error in rlm_pap.
179         * Remove documentation about non-existent functionality.
180         * Updated warning messages in debug output.
181         * Fix handling of timeouts in rlm_ldap that affected 64-bit systems.
182           This fix was supposed to go into 2.0.3, but did not make it.
183         * Fix event handling in debug mode for failed proxy requests.
184         * Fix memleak in fifos.  Closes #537.
185         * Fix memleak on blocked threads.  Closes #538.
186         * Perform additional checks on NULL realms.  Closes #541.
187         * Fix handling of "clients" in "listen" section.
188         * When detail file cannot process a packet, sleep for longer
189           to let the rest of the server do something.
190         * Add missing table to raddb/sql/mssql/schema.sql.  Closes #545.
191         * Updated rlm_sql_postgresql to build with PostgreSQL 7.x. 
192           Closes #533.
193         * Fix "postauth" of rlm_ldap to look for LDAP-UserDn in the
194           correct place.
195         * Update rlm_attr_filter for some corner cases.  Closes #543.
196         * Fixed memory leak in libfreeradius event handler.
197         * In the SQL Accounting on/off queries, remove the restriction
198           that the session time had to be zero.
199         
200 FreeRADIUS 2.0.3 ; Date: 2008/03/17 09:22:17  , urgency=medium
201         Feature improvements
202         * Updated raddb/certs/ca.cnf with extensions to allow ca.der
203           to be imported as a CA on Symbian and Windows Mobile devices.
204           Closes bug #524
205         * Enable multiple matches in "hints" via Fall-Through = Yes.
206           Closes bug #477
207         * Added preliminary SQLite driver, contibuted by Apple.
208           Untested, with no sample configuration.  This address bug #470.
209         * Updated logging sub-system so that log messages from libfreeradius
210           can go to the log file, and not stdout.
211         * Added dictionary.rfc5176
212         * EAP module now checks for instance name, and uses that for
213           authentication.  This avoids the need to set Auth-Type when
214           there are multiple instances of the EAP module.
215         * Added Module-Return-Code attribute, which contains the value
216           returned by the previous module (ok/fail/update/etc.)
217
218         Bug fixes
219         * Corrected typos in rlm_dbm.  Closes bugs #521 and #522.
220         * Detail file "listen" sections now work much better.
221         * Don't allow old "log_*" to over-ride new format.  Closes bug #525
222         * Initialize allocated memory in Oracle SQL driver.  This fixes
223           occasional crashes on some systems.  Closes bug #518
224         * Call correct function in rlm_protocol_filter.  This enables the
225           module to build.  Closes bug #512.
226         * Added deprecated flag to build for rlm_krb5.  This allows it to
227           run on 64-bit systems.  Closes bug #491
228         * Corrected error message when parsing invalid configurations
229           so it doesn't crash.  Closes bug #527
230         * Fix handling of timeouts in rlm_ldap that affected 64-bit systems.
231         * Handle $INCLUDE's in "instantiate" section.  Closes #528.
232         * Format updates to "man" pages from Stephen Gran.
233
234 FreeRADIUS 2.0.2 ; Date: 2008/02/14 11:13:48  , urgency=medium
235         Feature improvements
236         * Added notes on how to debug the server in radiusd.conf
237         * Moved all "log_*" in radiusd.conf to log{} section.
238           The old configurations are still accepted, though.
239         * Added ca.der target in raddb/certs/Makefile.  This is
240           needed for importing CA certs into Windows.
241         * Added ability send raw attributes via "Raw-Attribute = 0x0102..."
242           This is available only debug builds.  It can be used
243           to create invalid packets! Use it with care.
244         * Permit "unlang" policies inside of Auth-Type{} sub-sections
245           of the authenticate{} section.  This makes some policies easier
246           to implement.
247         * "listen" sections can now have "type = proxy".  This lets you
248           control which IP is used for sending proxied requests.
249         * Added note on SSL performance to raddb/certs/README
250
251         Bug fixes
252         * Fixed reading of "detail" files.
253         * Allow inner EAP tunneled sessions to be proxied.
254         * Corrected MySQL schemas
255         * syslog now works in log{} section.
256         * Corrected typo in raddb/certs/client.cnf
257         * Updated raddb/sites-available/proxy-inner-tunnel to
258           permit authentication to work.
259         * Ignore zero-length attributes in received packets.
260         * Correct memcpy when dealing with unknown attributes.
261         * Corrected debugging messages in attr_rewrite.
262         * Corrected generation of State attribute in EAP.  This
263           fixes the "failed to remember handler" issues.
264         * Fall back to DEFAULT realm if no realm was found.
265           Based on a patch from Vincent Magnin.
266         * Updated example raddb/sites-available/proxy-inner-tunnel
267         * Corrected behavior of attr_filter to match documentation.
268           This is NOT backwards compatible with previous versions!
269           See "man rlm_attr_filter" for details.
270
271 FreeRADIUS 2.0.1 ; Date: 2008/01/22 13:29:37  , urgency=low
272         Feature improvements
273         * "unlang" has been expanded to do less run-time expansion,
274           and to have better handling of typed data.  See "man unlang"
275           for documentation and new examples.
276         
277         Bug fixes
278         * The 'acct_unique' module has been updated to understand
279           the deprecated (but still used) Client-IP-Address attribute.
280         * The EAP-MSCHAPv2 module no longer leaks MS-CHAP2-Success in
281           packets.
282         * Fixed crash in rlm_dbm.
283         * Fixed parsing of syslog configuration.
284
285 FreeRADIUS 2.0.0 ; Date: 2007/11/24 08:33:09 , urgency=low
286         Feature improvements
287         * Debugging mode is much clearer and easier to read.
288         * A new policy language makes many configurations trivial.
289           See "man unlang" for a complete description.
290         * Virtual servers are now supported.  This permits clear separation
291           of policies.  See raddb/sites-available/README
292         * EAP-TLS (PEAP, EAP-TTLS) and OpenSSL certificates "just work".
293           See raddb/certs/README for details.
294         * Proxying is much more configurable than before.
295           See proxy.conf for documentation on pools, and new config items.
296         * Full support for IPv6.
297         * Much more complete support for the RADIUS SNMP MIBs.
298         * HUP now works.  Only some modules are re-loaded,
299           and the server configuation is *not* reloaded.
300         * "check config" option now works.  See "man radiusd"
301         * radrelay functionality is now included in the server core.
302           See raddb/sites-available/copy-acct-to-home-server
303         * VMPS support.  It is minimal, but functional.
304         * Cleaned up internal API's and names, including library names.
305         
306         Bug fixes
307         * Many.