Note recent changes
[freeradius.git] / doc / ChangeLog
1 FreeRADIUS 3.0.2 Mon 13 Jan 2014 14:30:00 EDT urgency=medium
2         Feature improvements
3         * Allow cast (and implicit conversion) of integers to IPv4 addresses
4         * More xlats allow attribute references.  This means they can
5           operate on binary data.  e.g. expr, base64, md5, sha1.
6         * Added more tests.
7         * The dictionaries are now auto-loaded.  raddb/dictionary
8           should no longer have $INCLUDE ${prefix}/share/dictionary
9         * A "panic_action" can be set to have the server dump a gdb
10           log on SEGV or other fatal error.
11         * Add support for SHA-224, SHA-256, SHA-384, SHA-512 to rlm_pap.
12         * Add "%{sha256:}" and "%{sha512:}" xlat functions.
13         * Cache CUI in EAP session resumption.
14         * templates can now have sub-sections, which will be included
15           in the section referencing the template.
16         * Update more dictionaries.
17         * Added more instances of the "always" module, for all return
18           codes.
19         * Suppress broken NASes when proxying.  Retransmits which occur
20           more than once per second are limited to only once per second.
21         * Allow '&' in more xlat expansions.
22         * Update PostgreSQL schema and queries to record last updated
23           time, and accounting interim.
24         * Optimize more "if" conditions when the server loads.
25           This avoids work at run time.  e.g. "foo" == "bar" --> FALSE.
26
27         Bug fixes
28         * Fix SQL groups.
29         * Fix operation of fr_strerror() with RE*() macros.
30         * Don't assert if the connection we're trying to reconnect
31           is not in_use.
32         * Fix %{mschap:User-Name} xlat.
33         * Allow comparisons of signed integers and of ethernet addresses.
34         * Fix parsing of text based ascend binary filters.
35         * Fix a few minor Coverity and clang analyzer issues.
36         * Log WARNING and ERROR prefixes only once, not twice.
37         * Fix attribute truncation seen in Perl and other places.
38         * Use correct port when DHCP relaying.
39         * Fix behaviour on FreeBSD where sending packets from an interface
40           bound to an IP address would fail when the server was built with
41           udpfromto.
42         * Don't abort() when freeing home servers on exit.
43         * Fix edge case in pairmove() when some attributes could be over-
44           written.
45         * Do checks for individual sqlite v2 functions so rlm_sqlite builds
46           correctly with more versions of the library.
47         * In heimdal kerberos, create MEMORY ccaches on a per context basis.
48           This prevents issues with the root ccache being used.
49         * Fix corner case with proxying, where home server goes down.
50         * Rate-limit "max_requests" complaint.  We don't want to fill the
51           logs when something goes wrong.
52         * Use /dev/urandom for raddb/certs/random, if it exists.
53         * Issue WARNING that old-style clients should no longer be used.
54         * Auto-set secret to "radsec" for tcp+tls home servers.
55         * Fix double free in home_server_add, when there is a parse error
56           on startup.
57         * rlm_unix checks if the dictionaries are broken.
58         * Fix issues in decoding POST responses in rlm_rest.
59         * Fix potential memory corruption when normalising salted password
60           hashes from hex, where the combined hash and salt was > 64 bytes.
61         * Register rlm_sqlcounter attributes correctly.
62
63 FreeRADIUS 3.0.1 Mon 13 Jan 2014 14:30:00 EDT urgency=medium
64         Feature improvements
65         * Add "timeout" to exec, and "ntlm_auth_timeout" to mschap.
66           So that run-away child processes are caught earlier.
67         * Allow TLS clients to use "proto = tls", in which case
68           TLS is required.  The shared secret is then set to "radsec".
69         * More documentation in the tls virtual server.
70         * Add "date" module for date formatting.
71           See raddb/mods-available/date.
72         * Added unit test suite for internal server functionality
73         * When loading "update" sections, check if the RHS is a literal
74           value.  If so, syntax check it immediately.
75         * Update LDAP module documentation and functionality.
76           The generic attribute can now update lists.
77         * Updated dictionary.extreme.
78         * Update sqlippool to do clears as a separate transaction,
79           and at most once per second.  This should help MySQL.
80         * Respect control:Response-Packet-Type for all types of
81           requests.
82         * Add support for SSL encryption to the MySQL driver.
83         * Allow arbitrary connection parameters to be used with the
84           PostgreSQL driver.
85         * Changes to the OpenLDAP schema to fully expose functionality
86           of the new LDAP module.
87         * Update debian packaging to include a freeradius-config
88           package. This package may be provided as a site local
89           package to avoid fighting with the preinstalled config
90           files.
91
92         Bug fixes
93         * Use correct field for ARP setting in DHCP.
94         * Fix crash on debug condition (#454).
95         * Fix a number of minor issues caught by the clang
96           analyzer.
97         * Set WARNING messages to yellow instead of normal text.
98         * Correct debug colorise logic.  Patch from Phil Mayers.
99         * Encode attributes of type "ethernet".  No one uses them,
100           but it makes sense.
101         * Work around regex initialization issues.
102         * Fix build when linking against OpenSSL.
103         * Print IDs as positive numbers, which helps for large DHCP
104           XIDs.
105         * Fix issue with sql_ippool.
106         * sqlcounter now uses 64-bit counters, to deal with 4G overflow.
107         * Fix issues with DHCP subsystem.
108         * Don't build / install disabled modules, or their config
109           files.
110         * Fix build for OSX Mavericks, which hid the header files
111           in a magical place.
112         * Fix LEAP buffer issue.  You should still avoid LEAP.
113         * Mark "unknown" WiMAX attributes as being WiMAX.
114         * Fix typo in packet decoder for fragmented extended attrs
115         * RPM spec fixes.
116         * Fix rlm_perl build issues when not using threads.
117         * Enable %{Response-Packet-Type} again.
118         * Update configuration file parser to handle "bool"
119           consistently.
120         * Update declarations of global boolean variables to use
121           "bool" consistently. This fixes an issue where some
122           modules were instantiated in "config check" mode and
123           did not work correctly.
124         * Make more messages debug instead of info, to avoid
125           polluting the logs with messages that can't be fixed.
126         * Set operator in internal unlang code to suppress spurious
127           warning messages.
128         * Fix debian packaging.
129         * Added "status" to Debian init script.
130         * Fix "update outer.request" to update the outer request.
131         * Don't print TLS debugging messages when not in debug mode.
132         * Correctly manage counters for "limit" sections of TCP / TLS
133           "listen" sockets.
134         * Fix libldap debug output.
135         * Fix rlm_ldap tls functionality.
136         * Initialise OpenSSL globals early to avoid issues with the
137           PostgreSQL library.
138         * Fix typo in sqlcounter expansion code.  Fixes #463
139         * Overwrite previous instances of SQL-User-Name when adding
140           it to the request.
141         * Work around bugs in both MIT and heimdal versions of
142           krb5_copy_context(), which caused segfaults in
143           multithreaded mode.
144         * Provide meaningful error messages if Heimdal krb5 is used.
145         * Fix attribute supression in rlm_detail.
146         * Exit with error code if child fails to complete server
147           initialisation after forking.  This allows init scripts to
148           correctly report whether the server started ok.
149
150 FreeRADIUS 3.0.0 Mon  7 Oct 2013 15:48:14 EDT urgency=medium
151         Feature improvements
152         * Documentation for upgrading from 2.x is in raddb/README.rst
153           Please follow it.  It will make the upgrade easier.
154         * Moved configuration entries in radiusd.conf to make more sense.
155         * Added the "integer64" and "ipv4prefix" data types.
156         * Added RADIUS over TLS (i.e. RadSec). See raddb/sites-available/tls
157         * Updated internal API to support new attributes and formats
158         * Added code to send SNMP Traps.  See raddb/trigger.conf.
159         * Added preliminary support for Apple's Grand Central Dispatch
160         * Added provisions for raddb/dictionary.local, for local changes.
161           See raddb/dictionary for more details.
162         * Added packet/s tracking. See max_pps in the "listen" section.
163         * The %{} expansions and "unlang" conditions are now parsed at server
164           start. Descriptive errors are produced for syntax and format errors.
165         * Casting is now supported for "unlang" comparisons.  See "man unlang"
166           e.g. <ipaddr>127.0.0.1 == Framed-IP-Address.
167         * Direct comparison of attribute references is now supported.
168           e.g. &Foo == &Bar.  This avoids stringification of the attributes.
169         * Direct assignment of attributes is now supported.
170           e.g. Foo := &Bar.  It also works for "octets" data types.
171         * Comparisons of IPv4 and IPv6 prefixes are now supported.
172           The "<" operator means "within the prefix" for comparisons.
173         * New sha1 xlat expansion (thanks to Alan Buxey)
174         * Colourised log messages when logging to stdout.  Look for yellow
175           warnings and red errors.  Doing this will save you a LOT of grief.
176         * If the PCRE library is available, use it (insted of the POSIX
177           functions) to process regular expressions (thanks to Phil Mayers).
178         * -xv now displays all the features the server was built with, and
179           the versions of the core libraries (libtalloc, libssl).
180
181         Module Changes
182         * Moved raddb/modules/ to raddb/mods-available/, and raddb/mods-enabled/,
183           following the examples of other projects.
184         * Additional files for each module are now in raddb/mods-config/.
185           See raddb/mods-config/README.rst for documentation.
186         * Moved "users" to raddb/mods-config/files/authorize
187         * Moved "hints" and "huntgroups" to raddb/mods-config/preprocess/
188         * Moved eap.conf to mods-available/eap
189         * Moved sql.conf to mods-available/sql
190         * Moved TLS configuration for EAP into a common subsection.
191           See raddb/mods-available/eap, "tls-config" section.
192         * Added for MS-CHAP Change Password from Phil Mayers.
193           See raddb/mods-available/mschap, "passchange" subsection.
194         * Added EAP-PWD implementation from Dan Harkins
195         * Added connection pools for modules. This unifies connection
196           management which was previously different for different modules.
197         * SQL now uses the connection pool.  See mods-available/sql
198         * SQL now supports arbitrary Acct-Status-Types.
199           These changes are not compatible with 2.x.
200         * SQL now has full support for SQLite.  See raddb/sql/main/sqlite/
201         * SQLite supports auto-creation of new databases on server startup for
202           bootstrapping purposes.
203         * LDAP now uses the connection pool.  The LDAP module has been
204           completely re-written for performance and simplicity.
205         * LDAP now caches groups.  This makes multiple group checks MUCH
206           faster.
207         * Removed all limitations on 253 octet attributes.  RFC 6929 allows
208           for attributes up to 4K in length.
209         * New rlm_idn module providing an expansion for performing IDNA encoding
210         of internationalized domain names.  Thanks to 'skids'.
211         * New rlm_yubikey module to validate yubikey OTP tokens.
212           See raddb/modules/yubikey
213
214         Bug fixes
215         * All known bug fixes from 2.2.x are included.
216         * Removed "addport" functionality.
217         * Removed many unused or duplicate modules.  See raddb/README.rst.
218
219         Internal / API changes:
220         * All traces of the old build system have been removed.
221           The new build system is faster and simpler.
222         * clang is fully supported.
223         * We now use "talloc" for memory management.  A number of new
224           features required this change.  Thanks to the Samba people!
225         * Many internal APIs have been updated to use talloc.
226         * New API for iterating over VALUE_PAIRs.  This is in preparation
227           for attributes, in version 3.1.
228         * No new code should directly modify any field of a VALUE_PAIR.
229         * VALUE_PAIRs contain pointers to DICT_ATTR instead of containing
230           attribute and vendor fields.  This will allow nested attributes.
231         * Some protocol specific code has been moved out into proto_* modules.
232           More will come in subsequent versions.  See proto_dhcp and proto_vmps.
233         * Standardised internal logging macros.  radlog() should not be used.
234           See src/include/log.h
235         * Use OpenSSL hashing functions when available.
236         * The server now builds with no warnings on most platforms.
237         * New RADIUS encoder/decoder, to support new formats.
238         * Added RFC 6929 "extended attributes", via the new encoder/decoder.
239         * Added full WiMAX support, via the new encoder/decoder.  The old
240           code could not handle some unusual corner cases.