trailing spaces aren't necessary
[freeradius.git] / doc / ChangeLog
1 FreeRADIUS 3.0.4 Mon 12 May 2014 15:30:00 EDT urgency=medium
2         Feature improvements
3         * Home server "response_window" can now take fractions of a
4           second.  See proxy.conf.
5         * radmin now supports "show module status", as the counterpart
6           to "set module status"
7         * Added dictionary ericsson.packet.ccore.networks
8         * Add %{tag:} expansion to get the tag value of an attribute.
9         * Report 'application_name' in connections to PostgreSQL servers.
10           FreeRADIUS connections will now appear as
11           'FreeRADIUS <version> - <name>' in pg_stat_activity.
12         * All config item fields are now type checked at compile time
13           to prevent issues similar to #634 occuring again.
14         * Modify pairparsevalue to deal with embedded NULLs better,
15           and use the binary versions of attribute values in rlm_ldap.
16
17         Bug fixes
18         * make case-insensitive regular expressions work again.
19         * Added tests for the above
20         * A few more talloc parenting issues
21         * Fix delayed proxy reply handling.  Closes #637
22         * Fix OpenSSL initialization order when using
23           RADIUS/TLS.  Fixes #646
24         * Don't double-quote strings in debugging messages
25         * Fix foreach / break.  Fixes #639
26         * Chargeable-User-Identifier should be "octets"
27         * Fix typo in mainconfig.  Fixes #634
28         * More rlm_perl fixes.  Fixes #635
29         * Free OpenSSL memory on clean exit.
30         * Fix <attr>[0] !* ANY - Was removing all instances of <attr>
31         * Fix case where multiple attributes were returned from LHS of
32           mapping, as with rlm_ldap. Fixes #652
33         * Fix corner case in cursor where using fr_cursor_next_by_da
34           after calling fr_cursor_remove may of resulted in a read of
35           uninitialised memory.
36         * Don't SEGV if all connections to a database server go away.
37           Fixes #651.
38         * Fix issue where <attr> -= <value> was not removing tagged
39           instances of <attr> equal to <value> (only untagged).
40         * Fix issue where tag values were not being set on attributes
41           created with unlang/ldap update blocks.
42         * Create rlm_sqlcounter attributes as integer64 types instead
43           of integer types, so large counter values can be specified.
44
45 FreeRADIUS 3.0.3 Mon 12 May 2014 15:30:00 EDT urgency=medium
46         Feature improvements
47         * Everything now builds with no warnings from the C compiler,
48           clang static analyzer, or cppcheck.
49         * rlm_ldap now supports defining the LDAP attribute name via
50           backticked expansion (i.e. shell command) in
51           RADIUS <-> LDAP mappings.
52         * rlm_ldap now supports older style generic attributes.
53         * dynamic expansions (e.g. "%{expr:1 + 2}" are now parsed
54           when the server starts.  Syntax errors in the strings
55           are caught, and a descriptive error is printed.
56         * Static regular expressions (e.g. /a*b/) are now parsed
57           when the server starts.  Syntax errors in the strings
58           are caught, and a descriptive error is printed.
59         * dynamic expansions are cached after being parsed.  They are
60           no longer re-parsed at run-time for every request.
61         * regular expressions are now parsed and cached when the server
62           starts.
63         * Added the %{rest:} expansion to rlm_rest, which will send
64           a GET request to the URL passed as the format string.
65           Any body text will be written to the expansion buffer.
66         * rlm_rest now available as a debian package.
67         * When an 'if' condition statically evaluates to true/false,
68           unlang does more static optimization.  For examples, see
69           src/tests/keywords/if-skip
70         * All modules are marked as safe for '-C', which lets the
71           dynamic expansion checks work in more situations.
72         * Added 'none' and 'custom' rlm_rest body types. 'custom'
73           allows sending of arbitrary expanded text and content-type
74           headers.
75         * Added "config" section to Perl.  See mods-available/perl
76         * Added '%v' which expands to the server version - Patch
77           from Alan Buxey.
78         * more mis-matched casts are caught in "if" conditions,
79           and descriptive errors are printed.
80         * Support basic response validation in radclient. This allows
81           administrators to write local test cases for their
82           site-specific configurations.
83         * Removed radconf2xml and radmin "show client config" and
84           "show home_server config".
85         * Forbid running with vulnerable versions of OpenSSL.
86           See "allow_vulnerable_openssl" in the "security"
87           subsection of "radiusd.conf"
88         * Catch underlying "heartbleed" problem, so that nothing bad
89           happens even when using a vulnerable version of OpenSSL.
90         * Add locking API for sql_null, linelog, and detail modules,
91           which should improve performance and work around issues
92           on platforms with bad file locking.
93         * Allow DHCP NAKs to be delayed, via setting
94           reply:FreeRADIUS-Response-Delay = 1
95         * Allow tag and array references anywhere attributes
96           are allowed in "unlang".
97         * many enhancements to radsniff, including output
98           to collectd, ipv6 support and packet loss statistics.
99         * Many dictionary updates (ZTE, Brocade, Motorola).
100         * rlm_yubikey now automatically splits passwords from OTP
101           strings.
102         * The detail file reader is now threaded by default.
103           This should improve performance reading the files.
104
105         Bug fixes
106         * Fix xlat expression %{attribute[n]} so that it actually
107           returns the n'th attribute instead of the first one.
108         * Don't parse string on RHS of update {} when using unary
109           operators (!*).  The RHS should always be ignored.
110         * Check for more optional functions in json-c so we can
111           Build with libjson0, which is the name of the json-c package
112           on debian/ubuntu.
113         * Fix issue in radmin where the main dictionaries would
114           not be loaded which, depending on the configuration, may
115           have caused validation errors.
116         * Fix handling of "%{reply:3GPP-*}"
117         * Fix rlm_perl garbage attributes
118         * Fix oracle SQL queries, which amongst other things still
119           used the old expansion format, which is no longer
120           supported/parsed.
121         * Truncate long format strings and error markers instead of
122           omitting them.
123         * Fix multiple attribute parsing in rlm_rest JSON.
124         * Don't crash in rlm_rest if connect_uri is commented out
125           in the configuration.
126         * Don't double-escape strings to / from Perl.  You may need
127           to double-check your Perl scripts if they use "\" characters.
128           See mods-available/perl for documentation.
129         * Don't re-run "authorize" if a home server fails to respond.
130         * Don't append "0x" to hex output of octets types, for xlat
131           expansions.  This is the same as v2, and makes it easier
132           to concatenate multiple attributes of type "octets"
133         * FreeBSD fixes for execinfo linking.
134         * Make some of the module configurations more consistent.
135         * Fix corner cases where STDOUT wouldn't be closed in
136           daemon mode.
137         * Re-enable "update coa" and originating CoA requests.
138         * Prevent multiple threads writing to the sql query logs.
139         * Fix zombie period calculation.  Closes #579
140         * Properly parent VPs for talloc, when moving them in map2request.
141         * Various fixes for talloc parent / child relationships
142         * Allow rlm_counter to support VSAs.
143         * Normalize return codes for many modules. "do nothing" is noop,
144           not "ok".
145         * Run Post-Proxy-Type Fail.  Closes #576
146         * Fix DHCP destination port for replies to relays.  Closes #591
147         * Do-Not-Respond policy works again  Closes #593
148         * Proxy-To-Virtual-Server works again.  Closes #596
149         * Build fixes for ancient systems.  Closes #607, #608, #609.
150         * %{Module-Return-Code} works again.  Closes #610.
151         * Don't increment statistics for Status-Server responses.
152           Closes #612.
153         * A duplicate request isn't a duplicate if the original one
154           is marked "done".  This should lower retransmissions from
155           clients.
156         * Fix multiple regular expression and glob memory leaks.
157         * Don't allocate any memory in fr_fault() as it can cause malloc
158           to deadlock.
159         * Temporarily set dumpable flag before calling system in fr_fault()
160           else the debugger may not be able to attach.
161         * Set nonblock on all TCP client sockets.
162         * Fix minor buffer overrun in mschapv2 where some attribute strings
163           were not correctly \0 terminated.
164         * Fix crash on authentication failure with MIT kerberos.
165         * Fix code so that octal escape sequences aren't prematurely unescaped
166           in rlm_sql, radclient, preprocess, and other places. This may
167           require configuration changes, as these sequences will no longer
168           need double escaping (\\) of the backslash.
169         * The connection pools no longer have one connection used twice
170           in certain rare conditions.
171         * Use self pipes for internal signals.  The code was there, but was
172           unused.
173         * Don't crash if there are outstanding EAP sessions and were told to
174           exit gracefully.
175         * Fix typo in dictionary.rfc4072
176
177 FreeRADIUS 3.0.2 Fri 21 Mar 2014 08:30:00 EDT urgency=medium
178         Feature improvements
179         * secret keys and LDAP / SQL passwords are now printed as
180           '<<< secret >>>' in debugging mode.  Use -Xx to see the
181           actual passwords.
182         * Print out more information about passwords in -Xx,
183           including hashes, comparisons, etc.
184         * Allow cast (and implicit conversion) of integers to IPv4 addresses
185         * More xlats allow attribute references.  This means they can
186           operate on binary data.  e.g. expr, base64, md5, sha1.
187         * Added more tests.
188         * The dictionaries are now auto-loaded.  raddb/dictionary
189           should no longer have $INCLUDE ${prefix}/share/dictionary
190         * A "panic_action" can be set to have the server dump a gdb
191           log on SEGV or other fatal error.  See radiusd.conf
192         * Add support for SHA-224, SHA-256, SHA-384, SHA-512 to rlm_pap.
193         * Add "%{sha256:}" and "%{sha512:}" xlat functions.
194         * Cache CUI in EAP session resumption.
195         * templates can now have sub-sections, which will be included
196           in the section referencing the template.
197         * Update more dictionaries.
198         * Added more instances of the "always" module, for all return
199           codes.
200         * Suppress broken NASes when proxying.  Retransmits which occur
201           more than once per second are rate-limited to once per second.
202         * Allow '&' in more xlat expansions.
203         * Update PostgreSQL schema and queries to record last updated
204           time, and accounting interim.
205         * Optimize more "if" conditions when the server loads.  This will
206           avoid work at run time.  e.g. ("foo" == "bar") --> FALSE.
207         * Allow removal of all attributes within a list with !* operator.
208         * Allow list to list copies with request qualifiers (outer.).
209         * Add support for ipv4 prefixes and ipv6 addresses and prefixes to
210           %{integer:}.
211         * allow radmin command "set module status <module> <code>"
212           which can be used to forcibly enable/disable modules.
213         * pap module now assumes Cleartext-Password if Password-With-Header
214           doesn't have a {...} header.
215         * Added "unpack" module.  It can unpack binary data from horrible
216           VSA formats.  See raddb/mods-available/unpack
217         * Added example IP Pool for DHCP, using sqlite.  From Matthew Newton
218           See raddb/mods-config/sql/ippool-dhcp/
219
220         Bug fixes
221         * Fix SQL groups.
222         * Fix operation of fr_strerror() with RE*() macros.
223         * Don't assert if the connection we're trying to reconnect
224           is not in_use.
225         * Fix %{mschap:User-Name} xlat.
226         * Allow comparisons of signed integers and of ethernet addresses.
227         * Fix parsing of text-based ascend binary filters.
228         * Fix a few minor Coverity and clang analyzer issues.
229         * Log WARNING and ERROR prefixes only once, not twice.
230         * Fix attribute truncation seen in Perl and other places.
231         * Use correct port when DHCP relaying.
232         * Fix behaviour on FreeBSD where sending packets from an interface
233           bound to an IP address would fail when the server was built with
234           udpfromto.
235         * Don't abort() when freeing home servers on exit.
236         * Fix edge case in pairmove() when some attributes could be over-
237           written.
238         * Do checks for individual sqlite v2 functions so rlm_sqlite builds
239           correctly with more versions of the library.
240         * In heimdal kerberos, create MEMORY ccaches on a per context basis.
241           This prevents issues with the root ccache being used.
242         * Fix corner case with proxying, where home server goes down.
243         * Rate-limit "max_requests" complaint.  We don't want to fill the
244           logs when something goes wrong.
245         * Use /dev/urandom for raddb/certs/random, if it exists.
246         * Issue WARNING that old-style clients should no longer be used.
247         * Auto-set secret to "radsec" for tcp+tls home servers.
248         * Fix double free in home_server_add when there is a parse error
249           on startup.
250         * rlm_unix checks if the dictionaries are broken, instead of crashing
251         * Fix potential memory corruption when normalising salted password
252           hashes from hex, where the combined hash and salt was > 64 bytes.
253         * Register sqlcounter attributes correctly, and other issues with it
254         * treat 127.0.0.1/32 as being identical to 127.0.0.1
255         * Don't mangle error output of SQL drivers like PostgreSQL
256         * Fix usage of "tls = ${tls}".  It could previously cause problems
257           when the reference was used multiple times.
258         * Fix TLS session leak for incoming sockets.
259         * Try harder to clean up memory on exit when using "-mM"
260         * Fix memory leak when home server is down for RadSec connections
261         * rate-limit outgoing connection attempts when the home server
262           is down.  It will retry no more than once per second.
263         * When parsing ipv6 address prefixes, always mask off the host
264           portion.
265         * Fix rlm_counter so that it does not create two reply
266           attributes.
267         * Fix issues with DHCP Sub-TLVs where the value of the first
268           Sub-TLV would appear corrupted, and subsequent TLVs would
269           not appear in debug output.
270         * Initialize scope in IP address parsing
271         * Prevent vendor attributes and RFC space attributes from clashing
272           in rlm_attr_filter.
273         * Set source IP address for DHCP packets from DHCP-Server-IP-Address,
274           or DHCP-DHCP-Server-Identifier, if we're unable to otherwise
275           determine the source IP.
276         * Fix POST attribute parsing in rlm_rest.
277         * Fix JSON attribute parsing in rlm_rest.
278         * Don't append trailing & to POST options in rlm_rest (minor).
279         * Process HTTP 100 Continue messages correctly in rlm_rest
280         * Fix generation of long > 512 byte POST payloads, where attribute
281           values on the chunk boundary may have been omitted in rlm_rest.
282         * Remove duplicate escape sequence parsing in rlm_sqlippool and
283           rlm_sqlcounter which caused issues with escaping %. Escape
284           sequence parsing is now handled purely by the xlat functions.
285         * Ensure %% is treated as a string literal, and so not passed to any
286           xlat escape functions for processing.
287         * Correct calculation of Message-Authenticator
288           for CoA packets.  Closes #556
289
290 FreeRADIUS 3.0.1 Mon 13 Jan 2014 14:30:00 EDT urgency=medium
291         Feature improvements
292         * Add "timeout" to exec, and "ntlm_auth_timeout" to mschap.
293           So that run-away child processes are caught earlier.
294         * Allow TLS clients to use "proto = tls", in which case
295           TLS is required.  The shared secret is then set to "radsec".
296         * More documentation in the tls virtual server.
297         * Add "date" module for date formatting.
298           See raddb/mods-available/date.
299         * Added unit test suite for internal server functionality
300         * When loading "update" sections, check if the RHS is a literal
301           value.  If so, syntax check it immediately.
302         * Update LDAP module documentation and functionality.
303           The generic attribute can now update lists.
304         * Updated dictionary.extreme.
305         * Update sqlippool to do clears as a separate transaction,
306           and at most once per second.  This should help MySQL.
307         * Respect control:Response-Packet-Type for all types of
308           requests.
309         * Add support for SSL encryption to the MySQL driver.
310         * Allow arbitrary connection parameters to be used with the
311           PostgreSQL driver.
312         * Changes to the OpenLDAP schema to fully expose functionality
313           of the new LDAP module.
314         * Update debian packaging to include a freeradius-config
315           package. This package may be provided as a site local
316           package to avoid fighting with the preinstalled config
317           files.
318
319         Bug fixes
320         * Use correct field for ARP setting in DHCP.
321         * Fix crash on debug condition (#454).
322         * Fix a number of minor issues caught by the clang
323           analyzer.
324         * Set WARNING messages to yellow instead of normal text.
325         * Correct debug colorise logic.  Patch from Phil Mayers.
326         * Encode attributes of type "ethernet".  No one uses them,
327           but it makes sense.
328         * Work around regex initialization issues.
329         * Fix build when linking against OpenSSL.
330         * Print IDs as positive numbers, which helps for large DHCP
331           XIDs.
332         * Fix issue with sql_ippool.
333         * sqlcounter now uses 64-bit counters, to deal with 4G overflow.
334         * Fix issues with DHCP subsystem.
335         * Don't build / install disabled modules, or their config
336           files.
337         * Fix build for OSX Mavericks, which hid the header files
338           in a magical place.
339         * Fix LEAP buffer issue.  You should still avoid LEAP.
340         * Mark "unknown" WiMAX attributes as being WiMAX.
341         * Fix typo in packet decoder for fragmented extended attrs
342         * RPM spec fixes.
343         * Fix rlm_perl build issues when not using threads.
344         * Enable %{Response-Packet-Type} again.
345         * Update configuration file parser to handle "bool"
346           consistently.
347         * Update declarations of global boolean variables to use
348           "bool" consistently. This fixes an issue where some
349           modules were instantiated in "config check" mode and
350           did not work correctly.
351         * Make more messages debug instead of info, to avoid
352           polluting the logs with messages that can't be fixed.
353         * Set operator in internal unlang code to suppress spurious
354           warning messages.
355         * Fix debian packaging.
356         * Added "status" to Debian init script.
357         * Fix "update outer.request" to update the outer request.
358         * Don't print TLS debugging messages when not in debug mode.
359         * Correctly manage counters for "limit" sections of TCP / TLS
360           "listen" sockets.
361         * Fix libldap debug output.
362         * Fix rlm_ldap tls functionality.
363         * Initialise OpenSSL globals early to avoid issues with the
364           PostgreSQL library.
365         * Fix typo in sqlcounter expansion code.  Fixes #463
366         * Overwrite previous instances of SQL-User-Name when adding
367           it to the request.
368         * Work around bugs in both MIT and heimdal versions of
369           krb5_copy_context(), which caused segfaults in
370           multithreaded mode.
371         * Provide meaningful error messages if Heimdal krb5 is used.
372         * Fix attribute supression in rlm_detail.
373         * Exit with error code if child fails to complete server
374           initialisation after forking.  This allows init scripts to
375           correctly report whether the server started ok.
376
377 FreeRADIUS 3.0.0 Mon  7 Oct 2013 15:48:14 EDT urgency=medium
378         Feature improvements
379         * Documentation for upgrading from 2.x is in raddb/README.rst
380           Please follow it.  It will make the upgrade easier.
381         * Moved configuration entries in radiusd.conf to make more sense.
382         * Added the "integer64" and "ipv4prefix" data types.
383         * Added RADIUS over TLS (i.e. RadSec). See raddb/sites-available/tls
384         * Updated internal API to support new attributes and formats
385         * Added code to send SNMP Traps.  See raddb/trigger.conf.
386         * Added preliminary support for Apple's Grand Central Dispatch
387         * Added provisions for raddb/dictionary.local, for local changes.
388           See raddb/dictionary for more details.
389         * Added packet/s tracking. See max_pps in the "listen" section.
390         * The %{} expansions and "unlang" conditions are now parsed at server
391           start. Descriptive errors are produced for syntax and format errors.
392         * Casting is now supported for "unlang" comparisons.  See "man unlang"
393           e.g. <ipaddr>127.0.0.1 == Framed-IP-Address.
394         * Direct comparison of attribute references is now supported.
395           e.g. &Foo == &Bar.  This avoids stringification of the attributes.
396         * Direct assignment of attributes is now supported.
397           e.g. Foo := &Bar.  It also works for "octets" data types.
398         * Comparisons of IPv4 and IPv6 prefixes are now supported.
399           The "<" operator means "within the prefix" for comparisons.
400         * New sha1 xlat expansion (thanks to Alan Buxey)
401         * Colourised log messages when logging to stdout.  Look for yellow
402           warnings and red errors.  Doing this will save you a LOT of grief.
403         * If the PCRE library is available, use it (insted of the POSIX
404           functions) to process regular expressions (thanks to Phil Mayers).
405         * -xv now displays all the features the server was built with, and
406           the versions of the core libraries (libtalloc, libssl).
407
408         Module Changes
409         * Moved raddb/modules/ to raddb/mods-available/, and raddb/mods-enabled/,
410           following the examples of other projects.
411         * Additional files for each module are now in raddb/mods-config/.
412           See raddb/mods-config/README.rst for documentation.
413         * Moved "users" to raddb/mods-config/files/authorize
414         * Moved "hints" and "huntgroups" to raddb/mods-config/preprocess/
415         * Moved eap.conf to mods-available/eap
416         * Moved sql.conf to mods-available/sql
417         * Moved TLS configuration for EAP into a common subsection.
418           See raddb/mods-available/eap, "tls-config" section.
419         * Added for MS-CHAP Change Password from Phil Mayers.
420           See raddb/mods-available/mschap, "passchange" subsection.
421         * Added EAP-PWD implementation from Dan Harkins
422         * Added connection pools for modules. This unifies connection
423           management which was previously different for different modules.
424         * SQL now uses the connection pool.  See mods-available/sql
425         * SQL now supports arbitrary Acct-Status-Types.
426           These changes are not compatible with 2.x.
427         * SQL now has full support for SQLite.  See raddb/sql/main/sqlite/
428         * SQLite supports auto-creation of new databases on server startup for
429           bootstrapping purposes.
430         * LDAP now uses the connection pool.  The LDAP module has been
431           completely re-written for performance and simplicity.
432         * LDAP now caches groups.  This makes multiple group checks MUCH
433           faster.
434         * Removed all limitations on 253 octet attributes.  RFC 6929 allows
435           for attributes up to 4K in length.
436         * New rlm_idn module providing an expansion for performing IDNA encoding
437         of internationalized domain names.  Thanks to 'skids'.
438         * New rlm_yubikey module to validate yubikey OTP tokens.
439           See raddb/modules/yubikey
440
441         Bug fixes
442         * All known bug fixes from 2.2.x are included.
443         * Removed "addport" functionality.
444         * Removed many unused or duplicate modules.  See raddb/README.rst.
445
446         Internal / API changes:
447         * All traces of the old build system have been removed.
448           The new build system is faster and simpler.
449         * clang is fully supported.
450         * We now use "talloc" for memory management.  A number of new
451           features required this change.  Thanks to the Samba people!
452         * Many internal APIs have been updated to use talloc.
453         * New API for iterating over VALUE_PAIRs.  This is in preparation
454           for attributes, in version 3.1.
455         * No new code should directly modify any field of a VALUE_PAIR.
456         * VALUE_PAIRs contain pointers to DICT_ATTR instead of containing
457           attribute and vendor fields.  This will allow nested attributes.
458         * Some protocol specific code has been moved out into proto_* modules.
459           More will come in subsequent versions.  See proto_dhcp and proto_vmps.
460         * Standardised internal logging macros.  radlog() should not be used.
461           See src/include/log.h
462         * Use OpenSSL hashing functions when available.
463         * The server now builds with no warnings on most platforms.
464         * New RADIUS encoder/decoder, to support new formats.
465         * Added RFC 6929 "extended attributes", via the new encoder/decoder.
466         * Added full WiMAX support, via the new encoder/decoder.  The old
467           code could not handle some unusual corner cases.