More updates
[freeradius.git] / doc / ChangeLog
1 FreeRADIUS 2.1.7 Sun Jan 1 1:1:00 CEST 1970;  , urgency=medium
2         Feature improvements
3         * Full support for CoA and Disconnect packets as per RFC 3576
4           and RFC 5176.  Both receiving and proxying CoA is supported.
5         * Added "src_ipaddr" configuration to "home_server".  See
6           proxy.conf for details.
7         * radsniff now accepts -I, to read from a filename instead of
8           a device.
9         * radsniff also prints matching requests and any responses to those
10           requests when '-r' is used.
11         * Added example of attr_filter for Access-Challenge packets
12         * Added support for udpfromto in DHCP code
13         * radmin can now selectively mark modules alive/dead.
14           See "set module state".
15         * Added customizable messages on login success/fail.
16           See msg_goodpass && msg_badpass in log{} section of radiusd.conf
17         * Document "chase_referrals" and "rebind" in raddb/modules/ldap
18         * Preliminary implementation of DHCP relay.
19         * Made thread pool section optional.  If it doesn't exist,
20           The server will run single-threaded.
21         * Added sample radrelay.conf for people upgrading from 1.x
22         * Made proxying more stable by failing over, rather than
23           rejecting the first request.  See "response_window" in proxy.conf
24         * Allow home_server_pools to exist without realms.
25         * Add dictionary.iea (closes bug #7)
26         * Added support for RFC 5580
27         * Added experimental sql_freetds module from Gabriel Blanchard.
28         * Updated dictionary.foundry
29         * Added sample configuration for MySQL cluster in raddb/sql/ndb
30           See the README file for explanations.
31
32         Bug fixes
33         * Fixed corner case where proxied packets could have extra
34           character in User-Password attribute.  Fix from Niko Tyni.
35         * Extended size of "attribute" field in SQL to 64.
36         * Fixes to ruby module to be more careful about when it builds.
37         * Updated Perl module "configure" script to check for broken
38           Perl installations.
39         * Fix "status_check = none".  It would still send packets
40           in some cases.
41         * Set recursive flag on the proxy mutex, which enables safer
42           cleanup on some platforms.
43         * Copy the EAP username verbatim, rather than escaping it.
44         * Update handling so that robust-proxy-accounting works when
45           all home servers are down for extended periods of time.
46         * Look for DHCP option 53 anywhere in the packet, not just 
47           at the start.
48         * Mark proxy mutex as recursive.  This solves issues on exit
49           with some platforms.
50         * Fix processing of proxy fail handler with virtual servers.
51         * DHCP code now prints out correct src/dst IP addresses
52           when sending packets.
53         * Removed requirement for DHCP to have clients
54         * Fixed handling of DHCP packets with message-type buried in the packet
55         * Fixed corner case with negation in unlang.
56         * Minor fixes to default MySQL & PostgreSQL schemas
57         * Suppress MSCHAP complaints in debugging mode.
58         * Fix SQL module for multiple instance, and possible crash on HUP
59         * Fix permissions for radius.log for sites that change user/group,
60           but which don't create the file before starting radiusd.
61         * Fix double counting of packets when proxying
62         * Make %l work
63         * Fix pthread keys in rlm_perl
64         * Log reasons for EAP failure (closes bug #8)
65         * Load home servers and pools that aren't referenced from a realm.
66         * Handle return codes from virtual attributes in "unlang"
67           (e.g. LDAP-Group).  This makes "!(expr)" work for them.
68         * Enable VMPS to see contents of virtual server again
69         * Fix WiMAX module to be consistent with examples.  (closes bug #10)
70         * Fixed crash with policies dependent on NAS-Port comparisons
71         * Allowed vendor IDs to be be higher than 32767.
72         * Fix crash on startup with certain regexes in "hints" file.
73         * Fix crash in attr_filter module when packets don't exist
74         * Allow detail file reader to be faster when "load_factor = 100"
75         * Add work-around for build failures with errors related to
76           lt__PROGRAM__LTX_preloaded_symbols.  libltdl / libtool are horrible.
77         * Made ldap module "rebind" option aware of older, incompatible
78           versions of OpenLDAP.
79         * Check value of Fall-Through in attr_filter module.
80
81 FreeRADIUS 2.1.6 Mon May 18 10:00:00 CEST 2009;   urgency=medium
82         Feature improvements
83         * radclient exits with 0 on successful (accept / ack), and 1
84           otherwise (no response / reject)
85         * Added support for %{sql:UPDATE ..}, and insert/delete
86           Patch from Arran Cudbard-Bell
87         * Added sample "do not respond" policy.  See raddb/policy.conf
88           and raddb/sites-available/do_not_respond
89         * Cleanups to Suse spec file from Norbert Wegener
90         * New VSAs for Juniper from Bjorn Mork
91         * Include more RFC dictionaries in the default install
92         * More documentation for the WiMAX module
93         * Added "chase_referrals" and "rebind" configuration to rlm_ldap.
94           This helps with Active Directory.  See raddb/modules/ldap
95         * Don't load pre/post-proxy if proxying is disabled.
96         * Added %{md5:...}, which returns MD5 hash in hex.
97         * Added configurable "retry_interval" and "poll_interval"
98           for "detail" listeners.
99         * Added "delete_mppe_keys" configuration option to rlm_wimax.
100           Apparently some WiMAX clients misbehave when they see those keys.
101         * Added experimental rlm_ruby from
102           http://github.com/Antti/freeradius-server/tree/master
103         * Add Tunnel attributes to ldap.attrmap
104         * Enable virtual servers to be reloaded on HUP.  For now, only
105           the "authorize", "authenticate", etc. processing sections are
106           reloaded.  Clients and "listen" sections are NOT reloaded.
107         * Updated "radwatch" script to be more robust.  See scripts/radwatch
108         * Added certificate compatibility notes in raddb/certs/README,
109           for compatibility with different operating systems. (i.e. Windows)
110
111         Bug fixes
112         * Minor changes to allow building without VQP.
113         * Minor fixes from John Center
114         * Fixed raddebug example
115         * Don't crash when deleting attributes via unlang
116         * Be friendlier to very fast clients
117         * Updated the "detail" listener so that it only polls once,
118           and not many times in a row, leaking memory each time...
119         * Update comparison for Packet-Src-IP-Address (etc.) so that
120           the operators other than '==' work.
121         * Did autoconf magic to work around weird libtool bug
122         * Make rlm_perl keep tags for tagged attributes in more situations
123         * Update UID checking for radmin
124         * Added "include_length" field for TTLS.  It's needed for RFC
125           compliance, but not (apparently) for interoperability.
126
127 FreeRADIUS 2.1.5 Sun Jan 1 1:1:00 CEST 2009;  , urgency=medium
128         * Release number skipped due to procedural issues.
129         
130 FreeRADIUS 2.1.4 Tue Mar 10 17:05:00 CEST 2009;  , urgency=medium
131         Feature improvements
132         * Permit multiple "-e" in radmin.
133         * Add support for originating CoA-Request and Disconnect-Request.
134           See raddb/sites-available/originate-coa.
135         * Added "lifetime" and "max_queries" to raddb/sql.conf.
136           This helps address the problem of hung SQL sockets.
137         * Allow packets to be injected via radmin.  See "inject help"
138           in radmin.
139         * Answer VMPS reconfirmation request.  Patch from Hermann Lauer.
140         * Sample logrotate script in scripts/logrotate.freeradius
141         * Add configurable poll interval for "detail" listeners
142         * New "raddebug" command.  This prints debugging information from
143           a running server.  See "man raddebug.
144         * Add "require_message_authenticator" configuration to home_server
145           configuration.  This makes the server add Message-Authenticator
146           to all outgoing Access-Request packets.
147         * Added smsotp module, as contributed by Siemens.
148         * Enabled the administration socket in the default install.
149           See raddb/sites-available/control-socket, and "man radmin"
150         * Handle duplicate clients, such as with replicated or
151           load-balanced SQL servers and "readclients = yes"
152
153         Bug fixes
154         * Clean up control sockets when they are closed, so that we don't
155           leak memory.
156         * Define SUN_LEN for systems that don't have it.
157         * Correct some boundary conditions in the conditional checker ("if")
158           in "unlang".  Bug noted by Arran Cudbard-Bell.
159         * Work around minor building issues in gmake.  This should only
160           have affected developers.
161         * Change how we manage unprivileged user/group, so that we do not
162           create control sockets owned by root.
163         * Fixed more minor issues found by Coverity.
164         * Allow raddb/certs/bootstrap to run when there is no "make"
165           command installed.
166         * In radiusd.conf, run_dir depends on the name of the program,
167           and isn't hard-coded to "..../radiusd"
168         * Check for EOF in more places in the "detail" file reader.
169         * Added Freeswitch dictionary.
170         * Chop ethernet frames in VMPS, rather than droppping packets.
171         * Fix EAP-TLS bug.  Patch from Arnaud Ebalard
172         * Don't lose string for regex-compares in the "users" file.
173         * Expose more functions in rlm_sql to rlm_sqlippool, which 
174           helps on systems where RTLD_GLOBAL is off.
175         * Fix typos in MySQL schemas for ippools.
176         * Remove macro that was causing build issues on some platforms.
177         * Fixed issues with dead home servers.  Bug noted by Chris Moules.
178         * Fixed "access after free" with some dynamic clients.
179
180 FreeRADIUS 2.1.3 Fri Dec 5 17:40:00 CEST 2008;  , urgency=medium
181         Feature improvements
182         * Allow running with "user=radiusd" and binding to secure
183           sockets.
184         * Start sending Status-Server "are you alive" messages earlier,
185           which helps with proxying multiple realms to a home server.
186         * Removed thread pool code from rlm_perl.  It's not necessary.
187         * Added example Perl configuration to raddb/modules/perl
188         * Force OpenSSL to support certificates with SHA256.
189           This seems to be necessary for WiMAX certs.
190
191         Bug fixes
192         * Fix Debian patch to allow it to build.
193         * Fix potential NULL dereference in debugging mode on certain
194           platforms for TTLS and PEAP inner tunnels.
195         * Fix uninitialized memory in handling of vendor definitions
196         * Fix parsing of quoted (but non-string) attributes in the "users"
197           file.
198         * Initialize uknown NAS IP to 255.255.255.255, rather than 0.0.0.0
199         * use SUN_LEN in control socket, to avoid truncation on some
200           platforms.
201         * Correct internal handling of "debug condition" to prevent it
202           from being over-written.
203         * Check return code of regcomp in "unlang", so that invalid
204           regular expressions are caught rather than mishandled.
205         * Make rlm_sql use <ltdl.h>.  Addresses bug #610.
206         * Document list "type = status" better.  Closes bug #580.
207         * Set "default days" for certificates, because OpenSSL won't
208           do it.  This closes bug #615.
209         * Reference correct list in example raddb/modules/ldap.
210           Closes #596.
211         * Increase default schema size for Acct-Session-Id to 64.
212           Closes #540.
213         * Fix use of temporary files in dialup-admin.  Closes #605
214           and addresses CVE-2008-4474.
215         * Addressed a number of minor issues found by Coverity.
216         * Added DHCP option 150 to the dictionary.  Closes #618.
217
218 FreeRADIUS 2.1.2 Thurs Dec 3 10:47:00 CEST 2008;  , urgency=medium
219         Due to packaging issues, 2.1.2 has been pulled from the net.
220
221 FreeRADIUS 2.1.1 Thu Sep 25 11:03:00 CEST 2008;  , urgency=medium
222         Feature improvements
223         * Many more options and features in radmin.  See "man radmin" and
224           raddb/sites-available/control-socket
225         * Many more commands available via the control socket.  Connect
226           via "radmin", and type "help" for more information.
227         * Added dictionary.networkphysics and dictionary.lancom.
228         * Calculate WiMAX MIP keys, and added sample WiMAX SQL tables.
229
230         Bug fixes
231         * Fixed bug that made radmin not work
232         * Fixed Suse && Debian package scripts
233         * Fixed issues with dynamic clients
234         * Fixed configure checks for -lreadline
235         * rlm_sqlippool no longer needs to be linked to rlm_sql.
236         * Add statistics for detail file listeners.  This closes bug #593.
237         * Fixed printing of some WiMAX attributes.
238         * Fix double free on exit() in rlm_attr_filter
239         * Fixed build issues on Solaris.
240         * Fixed fast session resumption for EAP-TLS
241
242 FreeRADIUS 2.1.0 Fri Sep  5 13:20:01 CEST 2008;  , urgency=medium
243         Feature improvements
244         * Clients may now be defined dynamically, based on IP address.
245           See raddb/sites-available/dynamic-clients.
246         * SNMP support is now available through an experimental Perl script.
247           See scripts/snmp-proxy/README
248         * SNMP statistics are available through Status-Server packets.
249           See raddb/sites-available/status
250         * Added more Microsoft attributes from bug #568.
251         * The "linelog" module has more functionality and flexibility.
252           See raddb/modules/linelog.
253         * The debugging output has been sanitized.  It should be much
254           more readable.
255         * Debug logs can now be turned on/off while the server is running, for
256           a user, group, realm, etc.  See the "log" section of radiusd.conf.
257         * Added support for WiMAX Forum attributes.  The dynamic keys
258           are not yet calculated.  See share/dictionary.wimax
259         * Added session resumption for PEAP and TTLS.
260           See raddb/eap.conf, "cache" sub-section.
261         * Added "radmin" command-line tool for administering a running server.
262           See "man radmin" and raddb/sites-available/control-socket.
263
264         Bug fixes
265         * Double escaping of '\\' in the "users" (and some other) files
266           has been fixed.  If you have '\\' in the "users" file, your
267           configuration WILL NEED TO BE CHECKED, AND FIXED!
268         * Parse "security" section in radiusd.conf.  This was accidentally
269           deleted in 2.0.5.  Closes bug #566.
270         * Bind to interface before IP, which allows DHCP sockets to
271           listen on "*" for multiple interfaces.
272         * Fix handling of giaddr in DHCP responses.
273         * Corrected parsing of status_check in home_server so that it works.
274         * Fix hints so that "Puser" works again.
275         * Removed length restrictions on attribute names in the dictionaries.
276         * Update socket code to avoid C compiler optimizations.
277
278 FreeRADIUS 2.0.5 ; Date: 2008/06/07 17:17:00 , urgency=medium
279         Feature improvements
280         * Permit SQL authorize_reply_query to be empty.
281         * Allow setting response packet type in Post-Proxy-Type Fail
282           handler.
283         * Added install-chown target to set correct permission and ownership
284           make RADMIN=radmin RGROUP=radius install-chown
285         * Support for LDAP-Group and other dynamic comparison attributes
286           in unlang.  Developed from a patch by Jason Alderfer.
287         * Added chroot support.  See radiusd.conf for comments.
288         * Allow clients of 0/0.  We do not recommend using this, though.
289         * Moved many module configurations into raddb/modules/*
290         
291         Bug fixes
292         * Allow proxying to virtual servers for accounting packets, too.
293         * Added "num fields" function to PostgreSQL client.
294         * Updated proxy fallback mechanism to validate fallback servers,
295           and to process fallback requests in a child thread.
296         * rlm_realm returns "ok" for LOCAL realms, not "noop".
297         * Fixed some DHCP code handling.  The examples should now work.
298
299 FreeRADIUS 2.0.4 ; Date: 2008/04/30 08:56:40  , urgency=medium
300         Feature improvements
301         * Allow "virtual_server" in "realm" and "home_server" sections.
302           See raddb/proxy.conf and raddb/sites-available/virtual.example.com.
303         * Allow "passwd" module to be listed in "accounting" and "post-auth".
304         * Added "fallback" to "home_server_pool" configuration, to handle
305           the case of all home servers being dead.  See raddb/proxy.conf.
306         * Added sample text to raddb/sites-available/inner-tunnel which
307           can simplify debugging of inner tunnel configurations.
308         * Added regular expression matching in realm names.  See
309           raddb/proxy.conf for examples.
310         * Added simple DHCP server functionality.  For comments, see
311           raddb/sites-available/dhcp.
312         * Added file globbing capabilities to detail file reader
313         * Added sample raddb/sites-available/robust-proxy-accounting
314         * Clients in SQL can now refer to a virtual server.
315           Patch from Michael Bretterklieber.
316         * Added some examples of creating RADIUS administrator in SQL,
317           and assigning appropriate access rights.
318         
319         Bug fixes
320         * Install all files in raddb/sites-available
321         * Allow non-threaded builds.
322         * Don't treat '0x' as special for known attributes that are not
323           of type "octets".
324         * Fix log error in rlm_pap.
325         * Remove documentation about non-existent functionality.
326         * Updated warning messages in debug output.
327         * Fix handling of timeouts in rlm_ldap that affected 64-bit systems.
328           This fix was supposed to go into 2.0.3, but did not make it.
329         * Fix event handling in debug mode for failed proxy requests.
330         * Fix memleak in fifos.  Closes #537.
331         * Fix memleak on blocked threads.  Closes #538.
332         * Perform additional checks on NULL realms.  Closes #541.
333         * Fix handling of "clients" in "listen" section.
334         * When detail file cannot process a packet, sleep for longer
335           to let the rest of the server do something.
336         * Add missing table to raddb/sql/mssql/schema.sql.  Closes #545.
337         * Updated rlm_sql_postgresql to build with PostgreSQL 7.x. 
338           Closes #533.
339         * Fix "postauth" of rlm_ldap to look for LDAP-UserDn in the
340           correct place.
341         * Update rlm_attr_filter for some corner cases.  Closes #543.
342         * Fixed memory leak in libfreeradius event handler.
343         * In the SQL Accounting on/off queries, remove the restriction
344           that the session time had to be zero.
345         
346 FreeRADIUS 2.0.3 ; Date: 2008/03/17 09:22:17  , urgency=medium
347         Feature improvements
348         * Updated raddb/certs/ca.cnf with extensions to allow ca.der
349           to be imported as a CA on Symbian and Windows Mobile devices.
350           Closes bug #524
351         * Enable multiple matches in "hints" via Fall-Through = Yes.
352           Closes bug #477
353         * Added preliminary SQLite driver, contibuted by Apple.
354           Untested, with no sample configuration.  This address bug #470.
355         * Updated logging sub-system so that log messages from libfreeradius
356           can go to the log file, and not stdout.
357         * Added dictionary.rfc5176
358         * EAP module now checks for instance name, and uses that for
359           authentication.  This avoids the need to set Auth-Type when
360           there are multiple instances of the EAP module.
361         * Added Module-Return-Code attribute, which contains the value
362           returned by the previous module (ok/fail/update/etc.)
363
364         Bug fixes
365         * Corrected typos in rlm_dbm.  Closes bugs #521 and #522.
366         * Detail file "listen" sections now work much better.
367         * Don't allow old "log_*" to over-ride new format.  Closes bug #525
368         * Initialize allocated memory in Oracle SQL driver.  This fixes
369           occasional crashes on some systems.  Closes bug #518
370         * Call correct function in rlm_protocol_filter.  This enables the
371           module to build.  Closes bug #512.
372         * Added deprecated flag to build for rlm_krb5.  This allows it to
373           run on 64-bit systems.  Closes bug #491
374         * Corrected error message when parsing invalid configurations
375           so it doesn't crash.  Closes bug #527
376         * Fix handling of timeouts in rlm_ldap that affected 64-bit systems.
377         * Handle $INCLUDE's in "instantiate" section.  Closes #528.
378         * Format updates to "man" pages from Stephen Gran.
379
380 FreeRADIUS 2.0.2 ; Date: 2008/02/14 11:13:48  , urgency=medium
381         Feature improvements
382         * Added notes on how to debug the server in radiusd.conf
383         * Moved all "log_*" in radiusd.conf to log{} section.
384           The old configurations are still accepted, though.
385         * Added ca.der target in raddb/certs/Makefile.  This is
386           needed for importing CA certs into Windows.
387         * Added ability send raw attributes via "Raw-Attribute = 0x0102..."
388           This is available only debug builds.  It can be used
389           to create invalid packets! Use it with care.
390         * Permit "unlang" policies inside of Auth-Type{} sub-sections
391           of the authenticate{} section.  This makes some policies easier
392           to implement.
393         * "listen" sections can now have "type = proxy".  This lets you
394           control which IP is used for sending proxied requests.
395         * Added note on SSL performance to raddb/certs/README
396
397         Bug fixes
398         * Fixed reading of "detail" files.
399         * Allow inner EAP tunneled sessions to be proxied.
400         * Corrected MySQL schemas
401         * syslog now works in log{} section.
402         * Corrected typo in raddb/certs/client.cnf
403         * Updated raddb/sites-available/proxy-inner-tunnel to
404           permit authentication to work.
405         * Ignore zero-length attributes in received packets.
406         * Correct memcpy when dealing with unknown attributes.
407         * Corrected debugging messages in attr_rewrite.
408         * Corrected generation of State attribute in EAP.  This
409           fixes the "failed to remember handler" issues.
410         * Fall back to DEFAULT realm if no realm was found.
411           Based on a patch from Vincent Magnin.
412         * Updated example raddb/sites-available/proxy-inner-tunnel
413         * Corrected behavior of attr_filter to match documentation.
414           This is NOT backwards compatible with previous versions!
415           See "man rlm_attr_filter" for details.
416
417 FreeRADIUS 2.0.1 ; Date: 2008/01/22 13:29:37  , urgency=low
418         Feature improvements
419         * "unlang" has been expanded to do less run-time expansion,
420           and to have better handling of typed data.  See "man unlang"
421           for documentation and new examples.
422         
423         Bug fixes
424         * The 'acct_unique' module has been updated to understand
425           the deprecated (but still used) Client-IP-Address attribute.
426         * The EAP-MSCHAPv2 module no longer leaks MS-CHAP2-Success in
427           packets.
428         * Fixed crash in rlm_dbm.
429         * Fixed parsing of syslog configuration.
430
431 FreeRADIUS 2.0.0 ; Date: 2007/11/24 08:33:09 , urgency=low
432         Feature improvements
433         * Debugging mode is much clearer and easier to read.
434         * A new policy language makes many configurations trivial.
435           See "man unlang" for a complete description.
436         * Virtual servers are now supported.  This permits clear separation
437           of policies.  See raddb/sites-available/README
438         * EAP-TLS (PEAP, EAP-TTLS) and OpenSSL certificates "just work".
439           See raddb/certs/README for details.
440         * Proxying is much more configurable than before.
441           See proxy.conf for documentation on pools, and new config items.
442         * Full support for IPv6.
443         * Much more complete support for the RADIUS SNMP MIBs.
444         * HUP now works.  Only some modules are re-loaded,
445           and the server configuation is *not* reloaded.
446         * "check config" option now works.  See "man radiusd"
447         * radrelay functionality is now included in the server core.
448           See raddb/sites-available/copy-acct-to-home-server
449         * VMPS support.  It is minimal, but functional.
450         * Cleaned up internal API's and names, including library names.
451         
452         Bug fixes
453         * Many.