note recent changes
[freeradius.git] / doc / ChangeLog
1 FreeRADIUS 3.0.9 Wed 22 Apr 2015 13:30:00 EDT urgency=medium
2         Feature improvements
3         * Make "pool" configurations more consistent, and
4           update documentation for them.
5         * Move connection pool logic to "most recently started",
6           instead of MRU.  This should help with pool stability.
7         * More VSAs for 3GPP2
8         * Added examples of multi-value attributes to rlm_perl.
9         * LDAP-Group and SQL-Group attributes are now dynamically
10           allocated.
11         * Only the "sql" module registers SQL-Group.  Other instances
12           register "instance-name-SQL-Group", similarly to "ldap".
13         * Unknown attributes are now complained about more often
14           when used in unlang statements.  e.g. if (Foo-Bar == 3)
15           used to be a string to string comparison.  It is now a
16           parse error.
17         * Rename RLM_COMPONENT_* to MOD_* in the code.
18           This makes many things easier.
19         * Move to C99 initializers for modules.
20         * Load modules in raddb/mods-enabled.  This allows attributes
21           like "LDAP-Group" to be used in the "files" module,
22           without explicit ordering or listing in "instantiate".
23         * Added 'bootstrap' section to modules.  Third-party modules
24           will need to be updated.
25         * When adding clients from a DB, add them to a virtual server
26           if that virtual server has a "listen" section.  Otherwise,
27           add the clients to the global list.
28         * When reading dynamic clients from a file, don't expire them
29           if the underlying file is unchanged.
30         * Allow the server to originate CoA requests from the post-auth
31           stage.
32         * The server creates ${run_dir} and ${logdir} in daemon mode,
33           if they do not already exist.
34         * Add dictionary for Wi-Fi Alliance Hotspot 2.0.  The server
35           now supports all mandatory and optional attributes for this
36           specification.
37         * HUP now re-loads the configuration only if the files have
38           changed.  If all files are unchanged, HUP re-opens the
39           log file, and does nothing else.
40
41         Bug fixes
42         * Be more careful about unused config item warnings
43           when using -Xx.
44         * Move more defines to be auto-generated.
45         * Allow virtual servers in proxy fallback.
46         * Allow %{module:} to work.
47         * Don't crash in RadSec.  Closes #980.
48         * Return better errors when a unix group / user
49           is not found.
50         * Re-enable detail module "locking" parameter.
51         * Don't crash when logging replies from Status-Server packets.
52         * The couchbase module now uses "update" instead of "map",
53           for consistent with the rest of the server.  See
54           raddb/mods-available/couchbase
55         * Don't require NT-Password for MS-CHAP password changes.
56         * Be a bit more careful about decrypting MS-CHAP-MPPE-Key
57           attributes. Closes #1013.  There is no perfect fix, tho.
58         * Fix security issues with EAP-PWD.
59           See http://freeradius.org/security.html#eap-pwd-2015
60         * Fix dynamic clients read from SQL in non-debug mode
61         * MS-CHAP now allows retries (i.e. password change) when
62           passwords are expired.
63         * Allow "user=radiusd" when the server is already user
64           "radiusd"
65         * suid up/down works on non-Linux systems.  This means
66           that the control socket should have the correct
67           ownership.
68
69 FreeRADIUS 3.0.8 Wed 22 Apr 2015 13:30:00 EDT urgency=medium
70         Feature improvements
71         * Allow syslog_severity to be set in rlm_linelog.
72         * Allow defaults to be set for bulk clients in LDAP and couchbase.
73         * Updates to dhcpclient.  Patches from Nicolas C.
74         * rlm_mschap now supports direct connections to winbind, which
75           is faster than ntlm_auth.  See raddb/mods-available/mschap.
76           Patch from Matthew Newton.
77         * Recommend /dev/urandom for TLS randomness, instead of
78           ${certdir}/random
79         * Allow TLSv1 to be disabled via "disable_tlsv1" in tls{}.
80         * Allow Expanded EAP types where vendor is 0 (IETF) and
81           type is normal EAP type.  Supplicants sending Expanded
82           EAP types like this are broken.
83         * Add support for server side sort controls when searching for
84           user objects in rlm_ldap.
85
86         Bug fixes
87         * Don't complain about "authorize" in "server {}" blocks, but
88           only if there's no "server" block.
89         * Fix cosmetic issue where debug from the first packet read by
90           a detail reader thread would be emited during config parsing.
91         * Fix ASSERT on truncated detail packets.
92         * Don't use main server log functions from within panic_action,
93           as in the case of syslog this would cause deadlocks if the
94           fault was triggered from within a malloc.
95         * Fix issue in "switch" when "correct_escapes = false".
96           Fixes #911.
97         * Fix sqlcounter configuration to use "%%b" instead of "%b",
98           otherwise the new syntax validation will fail.
99         * Allow forward references in configuration items.  Modules
100           aren't always loaded in a sane order.
101         * Fix more escaping issues.  Closes #912.
102         * Decode MAC addresses correctly for VMPS.
103         * Fix memory leak with TLS connections.
104         * Fix state machine threading issues for conflicting packets.
105         * Fix copy_request_to_tunnel issues for tagged attributes.
106         * Allow "ok" to over-ride "updated" inside of Auth-Type sections.
107         * Update state machine so that post-proxy is run though child
108           threads for performance, instead of blocking the main thread.
109         * Allow "netmask" to work again in client definitions.
110         * Relax restrictions on SQL group queries.
111         * track outgoing proxy sockets and clean them up more aggressively.
112         * track proxy statistics, including CoA and Disconnect.
113         * If radmin has a connection failure when running a command,
114           it re-connects and runs the command again.
115         * mark home servers "unknown" less aggressively.
116         * Fix potential SEGV in PostgreSQL driver on error.
117         * Fix issue where fields like nas_type would not be accessible via
118           the %{client:} xlat, for dynamic clients.
119         * Set default busy_timeout (of 200ms) in the sqlite driver, so writes
120           don't cause selects to fail in multithreaded mode. This is user
121           configurable, and may be increased if required.
122         * Convert Password-With-Header attributes to binary (from hex or
123           base64), in the authorize method of rlm_pap.
124         * Fix invalid assert in state.c, that could cause abort in
125           post-auth.
126         * Fix double free when -m flag is used, and connection pools are
127           referenced by multiple modules.
128         * RADIUS over TLS accounting uses the same port as authentication.
129         * Regularized return codes from radmin commands.
130         * Fix RHEL spec file so it works correctly for Centos7 which uses
131           systemd, and didn't like the SystemV init script.
132         * radwho and radlast now have a -D option to load dictionaries
133         * DHCP packets are no longer checked for duplicates.
134         * Don't crash in sql module group comparisons in corner case.
135         * Calculate MPPE keys correctly when using TLS 1.2.
136         * Fix load-balance sections.  Closes #945
137         * TLS certificates are available again in the post-auth section.
138           They are not available for session resumption.
139         * radclient encodes CHAP-Password properly when using -c.
140           Closes #955.
141         * Fix issue in rlm_cache_memcached driver that caused variable
142           length values to be truncated.
143         * Fix track functionality in detail reader, so it no longer
144           fails with a "Failed marking detail request as done: Bad file
145           descriptor" error.
146         * Actually add the peer identity (as User-Name) to the inner
147           tunnel in EAP-PWD requests, so it's available for lookups.
148         * Fixes to PostgreSQL queries.  Patches from Santiago Gimeno.
149
150 FreeRADIUS 3.0.7 Thu 19 Feb 2015 12:00:00 EDT urgency=medium
151         Feature improvements
152         * Allow coa home_servers to be derived from client
153           sections if a coa_server section is provided.
154         * Automatically determine the correct port if no port is
155           provided for a home server.
156         * Allow foreach to operate over lists.
157         * Add compile time features to ${feature.*} and versions
158           of core libraries to ${version.*}.  Feature and version
159           names match output of radiud -xv. %v is now deprecated.
160         * Add support for PATCH method in rlm_rest.
161         * Validate more module xlats on startup, and warn if an
162           xlat expansion is found in a double quoted config item
163           which will not be expanded.
164         * Add support for sub-second timeouts in rlm_rest.
165         * Add support for connection timeouts in rlm_rest.
166         * Add %{jsonquote:<str>} xlat to escape strings for insertion
167           into json documents.
168         * Add %{ldapquote:<str>} xlat to escape strings for insertion
169           into ldap DNs.
170         * Add %{explode:&ref <char>}, splits value of &ref on
171           <char> and creates new &ref type attributes with the
172           fragments.
173         * Allow rlm_ldap to use attribute references for base_dn and
174           filter config items. The attribute references are not
175           escaped, allowing DNs and filters to be created dynamically.
176         * Add %{nexttime:[<int>]h|d|w|y} to calculate the number of
177           seconds before the next <int> hour(s), day(s), week(s),
178           or year(s).
179         * Allow the left side of update sections to be xlat expansions.
180           The result of the expansion is then used to reference the
181           attribute to be modified.
182         * Added %{lpad:&Attribute-Name 7 x} and rpad.  These produce
183           fixed-width output strings, with padding to the left (lpad)
184           or the right (rpad).
185         * For some SQL drivers (MySQL, sqlite) distinguish between
186           constraints violations (on insert), invalid queries, and
187           server errors, and return noop, invalid, and error respectively.
188         * Call SHOW WARNINGS in the MySQL driver and write them to
189           the request log, if libmysqlclient indicates warnings are
190           available on the server.
191         * Forbid the creation of Vendor-Specific for non-standard
192           VSAs.  Use Attr-26 = 0x... instead.
193         * Make dhcpclient work with raw sockets and various other
194           improvements - Contributed by nchaigne
195         * Add support for SSHA2 - Contributed by PDD.
196         * Add perle dictionary - Contributed by Hachmer
197         * Modernise init scripts for RHEL, SUSE and Debian.
198         * radmin now tracks the return code of commands, and exits
199           with status "1" if any command failed to execute.
200         * radmin now sends error messages from the server to
201           stderr, instead of to stdout.
202         * radmin now looks for sockets matching it's UID and GID,
203           rather than just always using the first one it finds.
204         * radmin can how delete clients which are tied to a listener.
205         * Moved RADIUS attribute definitions to src/include/rfc*.h
206         * Move to talloc pools for requests.  For in-memory tests
207           (default config, 'users' file), performance increases by 30%.
208         * In rlm_ldap allow sasl_mech to be specified for admin and
209           user binds. Only non-interactive mechs (like EXTERNAL)
210           are currently supported.
211         * Remove support for ephemeral RSA keys.  They were "export only",
212           and should not be used by anyone.
213         * Syntax errors in the "users" file now produce better
214           error messages.
215
216         Bug fixes
217         * Fix issues parsing LDAP hostnames with non-standard ports.
218         * Fix issues with realms containing regular expressions.
219         * Allow unary negation before parantheses in rlm_expr.
220         * Fix infinite loop in kevent event loop code. Issue only
221           presented on FreeBSD.
222         * Be more careful to define Auth-Types before loading modules.
223         * Link libfreeradius-radius against OpenSSL too, to avoid
224           multi-version symbols in SSL libraries.
225         * When rlm_ldap rebinds a connection, it should use bind
226           credentials from the module that created the connection
227           pool, not credentials from the module referencing it.
228         * Empty server config pairs should be allowed in rlm_ldap
229           instances that reference another module's connection pool.
230         * Mark rlm_always as huppable, so its rcode can be changed
231           via radmin (allows policy toggles).
232         * Emit warnings when ignoring user configured pool values.
233         * Fix issue that would cause radclient to complain
234           intermittently about differing numbers of filters and
235           requests.
236         * Fix cosmetic issues in connection pool logging, that made
237           it appear as if the same connection was being opened
238           multiple times.
239         * Fix threadsafety issues in SQL drivers, where a static
240           buffer was used to store error messages.
241         * Log RERROR, RWARN, RINFO to the global log if request
242           logging is not enabled.
243         * Link to libldap instead of libldap_r. libldap_r
244           is not supported for use by projects outside of OpenLDAP.
245         * Set connection timeout correctly in rlm_sql_mysql.
246         * Build with older versions of libcurl, and use CFLAGS from
247           curl-config.
248         * Honour Packet-Src-Port and Packet-Src-IP-address in radclient.
249         * Initialise ldapai_info_version field, so libldap will report
250           its vendor and version.
251         * Fix log rotation scripts by using the copyrotate option.
252         * Fix issue that caused opening control sockets to always
253           fail on non-Linux systems, if a user or group was set.
254         * Save Session-State after proxying.
255         * Additional fixes for reading CoA/DM requests from detail
256           files.
257         * Create dynamic clients if the dynamic clients virtual server
258           returns ok *or* updated. Emit useful messages for other codes.
259         * Compile bare "authorize" statements, and issue errors saying
260           using them isn't a good idea.
261
262 FreeRADIUS 3.0.6 Wed 17 Dec 2014 16:00:00 EDT urgency=medium
263         Feature improvements
264         * radmin / raddebug conditional errors are printed
265           to the output, instead of being discarded.
266         * raddebug will exit if condition set with -c was invalid.
267         * radmin auto-reconnects if the connection to the server
268           has gone away.
269         * rlm_cache now has submodule support.  See
270           raddb/mods-available/cache
271         * New memcached driver for rlm_cache. See
272           raddb/mods-available/cache
273         * Add support for &Attribute-Name[*] in conditions.
274           See "man unlang" for details.
275         * Add &Attribute-Name[n] which gets the last instance
276           of an attribute e.g. Module-Failure-Message[n].
277         * Allow for redundant string expansions.  See the
278           "instantiate" section of radiusd.conf.
279         * When checking IP addresses in conditions, make the
280           right side be parsed as an IP prefix.
281         * Support JIT compilation of compiled regular expressions
282           when built with libpcre.
283         * Support named capture groups with "%{regex:<name>}"
284           when built with libpcre.
285         * Increase regular expression capture groups from 8 to 32.
286         * Emit error markers for badly formed regular expressions.
287         * Allow 'm' flag to enable multiline mode in regular
288           expressions.
289         * Support limited implicit attribute conversion in update
290           sections.
291         * Support casting between IPv6 and IPv4 where the IPv6
292           address has the v4/v6 mapping prefix (::ffff:).
293
294         Bug fixes
295         * PEAP works again.  As does proxying EAP-MSCHAPv2
296           from inside of a PEAP tunnel.
297         * "group" is allowed inside of "instantiate" sections.
298         * update disconnect {} with
299           disconnect:Packet-Dst-IP-Address now works correctly.
300         * Regular expression comparisons of non string attributes
301           are now disallowed in the files module.  Previously
302           they would silently fail or produce undefined behaviour.
303         * Fix parsing of old regular expressions.  Closes #842
304         * Fix off by one error in ascend filters.  Closes #843.
305         * Handle NT-Hash in rlm_pap.  This allows passwords to
306           have backslashes in them.
307         * Fix infinite loop on "Fall-Through = yes" when
308           processing SQL groups.
309         * Correct the check of SQL query return code.
310         * Run "Post-Auth-Type Reject" if the request was rejected
311           in post-auth
312         * Write "Login OK" only if the post-auth section passed.
313         * Create TLS-Cert-* certificates, even when EAP session
314           caching is disabled.
315         * Finalize the "correct_escapes" with many more tests.
316         * Move to the new OpenLDAP libldap API, fixes more issues
317           with binary values.
318         * Fix potential memory corruption in rlm_ldap if start
319           connections were set to 0, and the server was running
320           in threaded mode. The fix is a workaround for an issue
321           in libldap and was suggested by Howard Chu.
322         * Give parse errors on "%{...", without the closing brace.
323         * Allow spaces in certificate passwords for build rules
324           in raddb/certs//
325         * Make all regular expression evaluation binary safe.
326           Where that's not possible, emit an error if the pattern
327           or subject contains an embedded null byte.
328         * Fix various issues around masking IPv6 addresses.
329         * Give descriptive error if unknown attributes are used
330           in "update" sections.
331         * Deal with cases where ldap_initialize isn't available
332           gracefully, and use it exclusively when it's available.
333
334 FreeRADIUS 3.0.5 Fri 21 Nov 2014 15:30:00 EDT urgency=medium
335         Feature improvements
336         * Large update to Huawei dictionary.
337         * Added dictionary.rfc7155
338         * Regular expressions like /%{User-Name}/ are now parsed
339           and validated when the server starts.
340         * All configuration items which are dynamically expanded
341           are now parsed and validated when the server starts.
342         * %{expr:...} expressions can now do bit shifting and more.
343           See raddb/mods-available/expr.
344         * The detail file reader can now track packets which have
345           had replies, so they are never re-transmitted.  See
346           raddb/sites-available/buffered-sql, the "track" config item.
347         * CoA and Disconnect packets can now be sent to a specific
348           home server by setting control:Packet-Dst-IP-Address and
349           (optionally) control:Packet-Dst-Port.
350         * Allow CoA and Disconnect packets to be read from the
351           detail file.
352         * Allow LDAP to specify arbitrary attributes for dynamic
353           clients.
354         * Convert all unused attributes in the control: list to config
355           pairs in dynamic clients. This allows arbitrary client
356           attributes to be set for dynamic clients too.
357         * rlm_couchbase now supports bulk loading of clients on startup
358           in a similar way to rlm_ldap. Contributed by Aaron Hurt.
359         * Allow one level of backslashes (finally).  See radiusd.conf,
360           "correct_escapes" setting.
361         * Rename dictionary.redback to dictionary.ericsson.ab
362         * Add --disable-openssl-version-check option to configure.
363           So vendors can disable the check.  Patch from
364           Nikolai Kondrashov.
365         * Do context-specific indenting in debug messages.  This makes
366           the debug output easier to read.
367         * Make configuration a separate RPM, just like for Debian.
368         * better decoding of unknown VSAs
369         * When supported by OpenSSL, allow TLS 1.1 and TLS 1.2
370           in EAP methods.
371         * Allow multiple new connections to be spawned simultaneously
372           in the connection pool, to cope with spikes in traffic.
373         * Document retry_delay in connection pools.
374         * Allow checksimul in rlm_couchbase.
375         * Use kqueue on systems which support it.  This allows for
376           better scaling when using many sockets.
377
378         Bug fixes
379         * Parse list qualifiers in generic LDAP 'valuepair_attribute'
380           attributes correctly.
381         * Fix issue where prefix length would be ignored for dynamic
382           or static clients if the address matched INADDR_ANY
383           (0.0.0.0).
384         * Allow null user object filter in rlm_ldap, it's valid to
385           specify a complete object DN and use the base scope.
386         * Don't SEGV if a received attribute value in a JSON structure
387           is null, or a value can't be stringified.
388         * Don't assert if the server returns a JSON content-type and
389           the server hasn't been built with support for JSON.
390           Closes #808.
391         * Set CURLOPT_NOSIGNAL to prevent curl from handling signals
392           and causing a longjmp error when the server was running with
393           threads.
394         * Allow tabs after attribute names in the "users" file.
395           Closes #796.
396         * Free unknown DICT_ATTRs.  Closes #795
397         * Handle unknown attributes in the conditions and "update"
398           sections.  e.g. Attr-1.2.3.4 = foo.
399         * Use correct array size for MS-CHAP new password.
400         * In rlm_rest, check for older versions of libraries at start
401           time, rather than when a packet comes in.
402         * Don't call detach on parse error in rlm_perl.  Closes #802.
403         * Integer fixes for big-endian systems.  Closes #803.
404         * Don't optimize %{Packet-Src-IP-Address}.  Closes #804.
405         * dhcpclient loads dictionaries correclty.  Closes #805.
406         * double quotes are no longer escaped in single-quoted
407           strings.  e.g. 'foo "hello" bar'.
408         * Fixes for proxying to virtual servers broke the detail file
409           reader.  Now they both work.
410         * Typos and fixes from Nikolai Kondrashov.
411         * Fixes to OpenSSL version checks, for cross-platform issues.
412         * cppcheck fixes from Herwin Weststrate.
413         * Fix build for OSX Yosemite
414         * Merge DHCP sub-options.  Closes #812.
415         * Fix decoding of Starent attributes.
416         * When a module asks for a connection, don't return idle
417           connections.
418         * LDAP connection timeouts will now retry, instead of failing.
419         * Prevent race conditions between fork and wait for child.
420           Patch from James Rouzier.
421         * Fix triggers for connection pools.  Patches from
422           Nikolai Kondrashov.
423         * Fix SEGV when comparing non string type check items.
424         * Build with newer versions of libmysqlclient.
425         * make the %{escape:} and %{unescape:} xlat functions UTF8
426           safe.
427         * Don't escape UTF8 chars in SQL query strings.
428         * Fix issue in cached LDAP group comparisons, which caused
429           checks to sometimes fail.
430         * Fix use after free issue in unlang switch evaluation.
431         * Respect operators in rlm_cache when merging into the current
432           request.
433         * Update Cache-Entry-Hits each time rlm_cache is called.
434         * Produce WARN messages if SQL queries are empty strings.
435         * Fix invalid assertion when proxying CoA requests.
436         * Allow empty strings in "case" statements.  Closes #836.
437         * Normalize escaping for string expansions.  i.e. don't do
438           double escaping in rare situations.
439         * Normalize LDAP escaping.  LDAP servers have multiple ways
440           to escape things, so the data has to be normalized before
441           we can compare two LDAP DNs.
442         * Don't go to high debug level if we're proxying inner EAP
443           as EAP.  Closes #839.
444         * Fix rlm_rest state handling.  Closes #835.
445
446 FreeRADIUS 3.0.4 Wed 10 Sep 2014 12:00:00 EDT urgency=medium
447         Feature improvements
448         * Home server "response_window" can now take fractions of a
449           second.  See proxy.conf.
450         * radmin now supports "show module status", as thee counterpart
451           to "set module status"
452         * Added dictionary ericsson.packet.ccore.networks, bluecoat,
453           citrix, compatible, riverbed, ruckus, and RFC 7268.
454         * Add %{tag:} expansion to get the tag value of an attribute.
455         * Report 'application_name' in connections to PostgreSQL servers.
456           FreeRADIUS connections will now appear as
457           'FreeRADIUS <version> - <name>' in pg_stat_activity.
458         * All config item fields are now type checked at compile time
459           to prevent issues similar to #634 occuring again.
460         * Modify pairparsevalue to deal with embedded NULLs better,
461           and use the binary versions of attribute values in rlm_ldap.
462         * "ipaddr" will now use v6 if no v4 address is present.  You should
463           use "ipv4addr" or "ipv6addr" to force v4/v6 addresses.
464         * The above applies to "listen", "home_server", and "client" sections.
465         * "client" sections will allow "ipaddr = 192.192.0/24".  The old
466           "netmask" is still accepted, but the new format is preferred.
467         * Allow custom HTTP headers to be set for rlm_rest requests using
468           control:REST-HTTP-Header (attributes consumed after use).
469         * Extend format of %{rest:} expansion to allow HTTP method and POST
470           data to be specified
471           e.g. %{rest:POST http://example.org/api foo=bar&baz=boink}.
472         * Add %{hmacsha1:&data &key} and %{hmacmd5:&data &key} expansions
473           for signing data in requests.
474         * rlm_cache now consumes its control attributes to make runtime
475           configuration easier.
476         * Add control:Cache-Read-Only which when set to 'yes' will make the
477           cache module merge existing cache data, but not create new entries.
478         * Add %{unescape:} and %{urlunquote:} expansions to reverse escaping
479           and urlquoting.
480         * Add support for aliases in rlm_ldap.
481         * Add support for connection pool sharing to all modules that use
482           the connection pool (pool = <instance>).
483         * "tls" sections now have a "psk_query" configuration item, for dynamic
484           queries to discover a key from a PSK identity.
485         * Preliminary support for EAP channel bindings.
486         * Foundational work for dynamic home servers.  They do not yet work,
487           but this is now only a matter of updating the "realm" module in
488           a future release.
489         * Support &attr[*] syntax to copy all instances of an attribute when
490           used with the += operator in an update section. May be qualified with
491           a tag.
492         * The logintime and expiration modules can now be listed in the
493           post-auth section.  This makes some configurations simpler.
494         * Allow comparison of integer attributes of different sizes,
495           without requiring a cast.
496         * rlm_sqlippool is now IPV6 capable.  Set "ipv6 = yes" to get
497           Framed-IPv6-Prefix returned.  The SQL queries have NOT been updated.
498           Please submit patches.
499         * The debian build now checks for the OpenSSL package with the heartbleed
500           fix, and if found, sets: allow_vulnerable_openssl = 'CVE-2014-0160'
501         * allow bootstrap from multiple files in sqlite driver.
502
503         Bug fixes
504         * make case-insensitive regular expressions work again, and add tests
505           for them.
506         * A few more talloc parenting issues
507         * Fix delayed proxy reply handling.  Closes #637
508         * Fix OpenSSL initialization order when using
509           RADIUS/TLS.  Fixes #646
510         * Don't double-quote strings in debugging messages
511         * Fix foreach / break.  Fixes #639
512         * Chargeable-User-Identifier, ADSL-Agent-Circuit-Id and
513           ADSL-Agent-Remote-Id should be "octets" types in the default
514           dictionary.
515         * Fix typo in mainconfig.  Fixes #634
516         * More rlm_perl fixes.  Fixes #635
517         * Free OpenSSL memory on clean exit.
518         * Fix <attr>[0] !* ANY - Was removing all instances of <attr>
519         * Fix case where multiple attributes were returned from RHS of
520           mapping, as with rlm_ldap. Fixes #652
521         * Fix corner case in cursor where using fr_cursor_next_by_da
522           after calling fr_cursor_remove may of resulted in a read of
523           uninitialised memory.
524         * Don't SEGV if all connections to a database server go away.
525           Fixes #651.
526         * Fix issue where <attr> -= <value> was not removing tagged
527           instances of <attr> equal to <value> (only untagged).
528         * Fix issue where tag values were not being set on attributes
529           created with unlang/ldap update blocks.
530         * Create rlm_sqlcounter attributes as integer64 types instead
531           of integer types, so large counter values can be specified.
532         * Fix issue where specifying a dynamic client IP addresss using
533           FreeRADIUS-Client-IPv6-Prefix or FreeRADIUS-Client-IP-Prefix
534           may have caused a validation error.
535         * Don't print two "&" for messages about attribute or list
536           references in debug output.
537         * Fix urlquote and escape to encode Unicode characters correctly.
538         * Fix redundant-load-balance blocks to try other modules in
539           the group if one fails.
540         * Fix issue with rlm_pap password normalisation where
541           'known good' password strings stored in octets type attributes,
542           would be sometimes misnormalised as base64.
543         * Don't stop processing DHCP options if we find a 0x00 padding
544           option.
545         * Fix issue where modifying the value of an attribute created
546           from a template with a literal value, may have resulted in the
547           template literal being freed.
548         * Fix parenting issues in tls code which may have resulted in
549           memory corruption and crashes.
550         * Fix issue in radsniff where writing to PCAP files and using
551           -R response filters, where the requests would still be written
552           to the PCAP for non matching responses.
553         * Define __APPLE_USE_RFC_2292 so that the server builds with IPv6
554           support on OSX.
555         * Fix LDAP group lookups for named rlm_ldap instances.
556           Note that attribute references should be used when
557           checking LDAP-Group attributes. e.g. if (&LDAP-Group == 'foo').
558         * Delayed attribute references can now be used in unlang
559           existence checks.  i.e. if (&Attribute-Name) { ... }
560         * Fix issues in EAP-PWD.  CVE-2014-4731, CVE-2014-4732, and
561           CVE-2014-4733.  There is no external authentication bypass.
562         * Fix a number of uses of the talloc parent/child reference.
563         * Release connection used for reading bulk clients in rlm_ldap.
564         * rlm_rest is now fail-safe if it's used without any configuration
565         * Pull in build fixes for FreeBSD from ports.
566         * Fix error in sqlite postauth query
567         * Evaluate argument to "switch" statements once, instead of for each
568           "case" statement.
569         * Define sig_t on systems without it.  Closes #765.
570         * Fix boundary issue with rlm_rest.  Closes #768
571         * Optimize "%{Attribute-Name}" in comparisons only if the dictionary
572           types match.
573         * Don't do chmod() in rad_mkdir() if the directory already exists.
574           We might not have permission to change it.
575         * Use getpwnam_r() and getgrnam_r() on systems which support it.
576           Closes #775.
577         * Clients loaded from SQL are now tied to the "listen" section
578           of a virtual server, instead of being global.
579         * Check for -lpcre.  The system might have pcre.h without -lpcre.
580         * When proxying to a virtual server, use the proxy_reply instead
581           of ignoring it.
582         * Fixed typos in DHCP SQL IPPool.
583         * Fix crash when passing multiple arguments to Perl xlat.
584
585 FreeRADIUS 3.0.3 Mon 12 May 2014 15:30:00 EDT urgency=medium
586         Feature improvements
587         * Everything now builds with no warnings from the C compiler,
588           clang static analyzer, or cppcheck.
589         * rlm_ldap now supports defining the LDAP attribute name via
590           backticked expansion (i.e. shell command) in
591           RADIUS <-> LDAP mappings.
592         * rlm_ldap now supports older style generic attributes.
593         * dynamic expansions (e.g. "%{expr:1 + 2}" are now parsed
594           when the server starts.  Syntax errors in the strings
595           are caught, and a descriptive error is printed.
596         * Static regular expressions (e.g. /a*b/) are now parsed
597           when the server starts.  Syntax errors in the strings
598           are caught, and a descriptive error is printed.
599         * dynamic expansions are cached after being parsed.  They are
600           no longer re-parsed at run-time for every request.
601         * regular expressions are now parsed and cached when the server
602           starts.
603         * Added the %{rest:} expansion to rlm_rest, which will send
604           a GET request to the URL passed as the format string.
605           Any body text will be written to the expansion buffer.
606         * rlm_rest now available as a debian package.
607         * When an 'if' condition statically evaluates to true/false,
608           unlang does more static optimization.  For examples, see
609           src/tests/keywords/if-skip
610         * All modules are marked as safe for '-C', which lets the
611           dynamic expansion checks work in more situations.
612         * Added 'none' and 'custom' rlm_rest body types. 'custom'
613           allows sending of arbitrary expanded text and content-type
614           headers.
615         * Added "config" section to Perl.  See mods-available/perl
616         * Added '%v' which expands to the server version - Patch
617           from Alan Buxey.
618         * more mis-matched casts are caught in "if" conditions,
619           and descriptive errors are printed.
620         * Support basic response validation in radclient. This allows
621           administrators to write local test cases for their
622           site-specific configurations.
623         * Removed radconf2xml and radmin "show client config" and
624           "show home_server config".
625         * Forbid running with vulnerable versions of OpenSSL.
626           See "allow_vulnerable_openssl" in the "security"
627           subsection of "radiusd.conf"
628         * Catch underlying "heartbleed" problem, so that nothing bad
629           happens even when using a vulnerable version of OpenSSL.
630         * Add locking API for sql_null, linelog, and detail modules,
631           which should improve performance and work around issues
632           on platforms with bad file locking.
633         * Allow DHCP NAKs to be delayed, via setting
634           reply:FreeRADIUS-Response-Delay = 1
635         * Allow tag and array references anywhere attributes
636           are allowed in "unlang".
637         * many enhancements to radsniff, including output
638           to collectd, ipv6 support and packet loss statistics.
639         * Many dictionary updates (ZTE, Brocade, Motorola).
640         * rlm_yubikey now automatically splits passwords from OTP
641           strings.
642         * The detail file reader is now threaded by default.
643           This should improve performance reading the files.
644
645         Bug fixes
646         * Fix xlat expression %{attribute[n]} so that it actually
647           returns the n'th attribute instead of the first one.
648         * Don't parse string on RHS of update {} when using unary
649           operators (!*).  The RHS should always be ignored.
650         * Check for more optional functions in json-c so we can
651           Build with libjson0, which is the name of the json-c package
652           on debian/ubuntu.
653         * Fix issue in radmin where the main dictionaries would
654           not be loaded which, depending on the configuration, may
655           have caused validation errors.
656         * Fix handling of "%{reply:3GPP-*}"
657         * Fix rlm_perl garbage attributes
658         * Fix oracle SQL queries, which amongst other things still
659           used the old expansion format, which is no longer
660           supported/parsed.
661         * Truncate long format strings and error markers instead of
662           omitting them.
663         * Fix multiple attribute parsing in rlm_rest JSON.
664         * Don't crash in rlm_rest if connect_uri is commented out
665           in the configuration.
666         * Don't double-escape strings to / from Perl.  You may need
667           to double-check your Perl scripts if they use "\" characters.
668           See mods-available/perl for documentation.
669         * Don't re-run "authorize" if a home server fails to respond.
670         * Don't append "0x" to hex output of octets types, for xlat
671           expansions.  This is the same as v2, and makes it easier
672           to concatenate multiple attributes of type "octets"
673         * FreeBSD fixes for execinfo linking.
674         * Make some of the module configurations more consistent.
675         * Fix corner cases where STDOUT wouldn't be closed in
676           daemon mode.
677         * Re-enable "update coa" and originating CoA requests.
678         * Prevent multiple threads writing to the sql query logs.
679         * Fix zombie period calculation.  Closes #579
680         * Properly parent VPs for talloc, when moving them in map2request.
681         * Various fixes for talloc parent / child relationships
682         * Allow rlm_counter to support VSAs.
683         * Normalize return codes for many modules. "do nothing" is noop,
684           not "ok".
685         * Run Post-Proxy-Type Fail.  Closes #576
686         * Fix DHCP destination port for replies to relays.  Closes #591
687         * Do-Not-Respond policy works again  Closes #593
688         * Proxy-To-Virtual-Server works again.  Closes #596
689         * Build fixes for ancient systems.  Closes #607, #608, #609.
690         * %{Module-Return-Code} works again.  Closes #610.
691         * Don't increment statistics for Status-Server responses.
692           Closes #612.
693         * A duplicate request isn't a duplicate if the original one
694           is marked "done".  This should lower retransmissions from
695           clients.
696         * Fix multiple regular expression and glob memory leaks.
697         * Don't allocate any memory in fr_fault() as it can cause malloc
698           to deadlock.
699         * Temporarily set dumpable flag before calling system in fr_fault()
700           else the debugger may not be able to attach.
701         * Set nonblock on all TCP client sockets.
702         * Fix minor buffer overrun in mschapv2 where some attribute strings
703           were not correctly \0 terminated.
704         * Fix crash on authentication failure with MIT kerberos.
705         * Fix code so that octal escape sequences aren't prematurely unescaped
706           in rlm_sql, radclient, preprocess, and other places. This may
707           require configuration changes, as these sequences will no longer
708           need double escaping (\\) of the backslash.
709         * The connection pools no longer have one connection used twice
710           in certain rare conditions.
711         * Use self pipes for internal signals.  The code was there, but was
712           unused.
713         * Don't crash if there are outstanding EAP sessions and were told to
714           exit gracefully.
715         * Fix typo in dictionary.rfc4072
716
717 FreeRADIUS 3.0.2 Fri 21 Mar 2014 08:30:00 EDT urgency=medium
718         Feature improvements
719         * secret keys and LDAP / SQL passwords are now printed as
720           '<<< secret >>>' in debugging mode.  Use -Xx to see the
721           actual passwords.
722         * Print out more information about passwords in -Xx,
723           including hashes, comparisons, etc.
724         * Allow cast (and implicit conversion) of integers to IPv4 addresses
725         * More xlats allow attribute references.  This means they can
726           operate on binary data.  e.g. expr, base64, md5, sha1.
727         * Added more tests.
728         * The dictionaries are now auto-loaded.  raddb/dictionary
729           should no longer have $INCLUDE ${prefix}/share/dictionary
730         * A "panic_action" can be set to have the server dump a gdb
731           log on SEGV or other fatal error.  See radiusd.conf
732         * Add support for SHA-224, SHA-256, SHA-384, SHA-512 to rlm_pap.
733         * Add "%{sha256:}" and "%{sha512:}" xlat functions.
734         * Cache CUI in EAP session resumption.
735         * templates can now have sub-sections, which will be included
736           in the section referencing the template.
737         * Update more dictionaries.
738         * Added more instances of the "always" module, for all return
739           codes.
740         * Suppress broken NASes when proxying.  Retransmits which occur
741           more than once per second are rate-limited to once per second.
742         * Allow '&' in more xlat expansions.
743         * Update PostgreSQL schema and queries to record last updated
744           time, and accounting interim.
745         * Optimize more "if" conditions when the server loads.  This will
746           avoid work at run time.  e.g. ("foo" == "bar") --> FALSE.
747         * Allow removal of all attributes within a list with !* operator.
748         * Allow list to list copies with request qualifiers (outer.).
749         * Add support for ipv4 prefixes and ipv6 addresses and prefixes to
750           %{integer:}.
751         * allow radmin command "set module status <module> <code>"
752           which can be used to forcibly enable/disable modules.
753         * pap module now assumes Cleartext-Password if Password-With-Header
754           doesn't have a {...} header.
755         * Added "unpack" module.  It can unpack binary data from horrible
756           VSA formats.  See raddb/mods-available/unpack
757         * Added example IP Pool for DHCP, using sqlite.  From Matthew Newton
758           See raddb/mods-config/sql/ippool-dhcp/
759
760         Bug fixes
761         * Fix SQL groups.
762         * Fix operation of fr_strerror() with RE*() macros.
763         * Don't assert if the connection we're trying to reconnect
764           is not in_use.
765         * Fix %{mschap:User-Name} xlat.
766         * Allow comparisons of signed integers and of ethernet addresses.
767         * Fix parsing of text-based ascend binary filters.
768         * Fix a few minor Coverity and clang analyzer issues.
769         * Log WARNING and ERROR prefixes only once, not twice.
770         * Fix attribute truncation seen in Perl and other places.
771         * Use correct port when DHCP relaying.
772         * Fix behaviour on FreeBSD where sending packets from an interface
773           bound to an IP address would fail when the server was built with
774           udpfromto.
775         * Don't abort() when freeing home servers on exit.
776         * Fix edge case in pairmove() when some attributes could be over-
777           written.
778         * Do checks for individual sqlite v2 functions so rlm_sqlite builds
779           correctly with more versions of the library.
780         * In heimdal kerberos, create MEMORY ccaches on a per context basis.
781           This prevents issues with the root ccache being used.
782         * Fix corner case with proxying, where home server goes down.
783         * Rate-limit "max_requests" complaint.  We don't want to fill the
784           logs when something goes wrong.
785         * Use /dev/urandom for raddb/certs/random, if it exists.
786         * Issue WARNING that old-style clients should no longer be used.
787         * Auto-set secret to "radsec" for tcp+tls home servers.
788         * Fix double free in home_server_add when there is a parse error
789           on startup.
790         * rlm_unix checks if the dictionaries are broken, instead of crashing
791         * Fix potential memory corruption when normalising salted password
792           hashes from hex, where the combined hash and salt was > 64 bytes.
793         * Register sqlcounter attributes correctly, and other issues with it
794         * treat 127.0.0.1/32 as being identical to 127.0.0.1
795         * Don't mangle error output of SQL drivers like PostgreSQL
796         * Fix usage of "tls = ${tls}".  It could previously cause problems
797           when the reference was used multiple times.
798         * Fix TLS session leak for incoming sockets.
799         * Try harder to clean up memory on exit when using "-mM"
800         * Fix memory leak when home server is down for RadSec connections
801         * rate-limit outgoing connection attempts when the home server
802           is down.  It will retry no more than once per second.
803         * When parsing ipv6 address prefixes, always mask off the host
804           portion.
805         * Fix rlm_counter so that it does not create two reply
806           attributes.
807         * Fix issues with DHCP Sub-TLVs where the value of the first
808           Sub-TLV would appear corrupted, and subsequent TLVs would
809           not appear in debug output.
810         * Initialize scope in IP address parsing
811         * Prevent vendor attributes and RFC space attributes from clashing
812           in rlm_attr_filter.
813         * Set source IP address for DHCP packets from DHCP-Server-IP-Address,
814           or DHCP-DHCP-Server-Identifier, if we're unable to otherwise
815           determine the source IP.
816         * Fix POST attribute parsing in rlm_rest.
817         * Fix JSON attribute parsing in rlm_rest.
818         * Don't append trailing & to POST options in rlm_rest (minor).
819         * Process HTTP 100 Continue messages correctly in rlm_rest
820         * Fix generation of long > 512 byte POST payloads, where attribute
821           values on the chunk boundary may have been omitted in rlm_rest.
822         * Remove duplicate escape sequence parsing in rlm_sqlippool and
823           rlm_sqlcounter which caused issues with escaping %. Escape
824           sequence parsing is now handled purely by the xlat functions.
825         * Ensure %% is treated as a string literal, and so not passed to any
826           xlat escape functions for processing.
827         * Correct calculation of Message-Authenticator
828           for CoA packets.  Closes #556
829
830 FreeRADIUS 3.0.1 Mon 13 Jan 2014 14:30:00 EDT urgency=medium
831         Feature improvements
832         * Add "timeout" to exec, and "ntlm_auth_timeout" to mschap.
833           So that run-away child processes are caught earlier.
834         * Allow TLS clients to use "proto = tls", in which case
835           TLS is required.  The shared secret is then set to "radsec".
836         * More documentation in the tls virtual server.
837         * Add "date" module for date formatting.
838           See raddb/mods-available/date.
839         * Added unit test suite for internal server functionality
840         * When loading "update" sections, check if the RHS is a literal
841           value.  If so, syntax check it immediately.
842         * Update LDAP module documentation and functionality.
843           The generic attribute can now update lists.
844         * Updated dictionary.extreme.
845         * Update sqlippool to do clears as a separate transaction,
846           and at most once per second.  This should help MySQL.
847         * Respect control:Response-Packet-Type for all types of
848           requests.
849         * Add support for SSL encryption to the MySQL driver.
850         * Allow arbitrary connection parameters to be used with the
851           PostgreSQL driver.
852         * Changes to the OpenLDAP schema to fully expose functionality
853           of the new LDAP module.
854         * Update debian packaging to include a freeradius-config
855           package. This package may be provided as a site local
856           package to avoid fighting with the preinstalled config
857           files.
858
859         Bug fixes
860         * Use correct field for ARP setting in DHCP.
861         * Fix crash on debug condition (#454).
862         * Fix a number of minor issues caught by the clang
863           analyzer.
864         * Set WARNING messages to yellow instead of normal text.
865         * Correct debug colorise logic.  Patch from Phil Mayers.
866         * Encode attributes of type "ethernet".  No one uses them,
867           but it makes sense.
868         * Work around regex initialization issues.
869         * Fix build when linking against OpenSSL.
870         * Print IDs as positive numbers, which helps for large DHCP
871           XIDs.
872         * Fix issue with sql_ippool.
873         * sqlcounter now uses 64-bit counters, to deal with 4G overflow.
874         * Fix issues with DHCP subsystem.
875         * Don't build / install disabled modules, or their config
876           files.
877         * Fix build for OSX Mavericks, which hid the header files
878           in a magical place.
879         * Fix LEAP buffer issue.  You should still avoid LEAP.
880         * Mark "unknown" WiMAX attributes as being WiMAX.
881         * Fix typo in packet decoder for fragmented extended attrs
882         * RPM spec fixes.
883         * Fix rlm_perl build issues when not using threads.
884         * Enable %{Response-Packet-Type} again.
885         * Update configuration file parser to handle "bool"
886           consistently.
887         * Update declarations of global boolean variables to use
888           "bool" consistently. This fixes an issue where some
889           modules were instantiated in "config check" mode and
890           did not work correctly.
891         * Make more messages debug instead of info, to avoid
892           polluting the logs with messages that can't be fixed.
893         * Set operator in internal unlang code to suppress spurious
894           warning messages.
895         * Fix debian packaging.
896         * Added "status" to Debian init script.
897         * Fix "update outer.request" to update the outer request.
898         * Don't print TLS debugging messages when not in debug mode.
899         * Correctly manage counters for "limit" sections of TCP / TLS
900           "listen" sockets.
901         * Fix libldap debug output.
902         * Fix rlm_ldap tls functionality.
903         * Initialise OpenSSL globals early to avoid issues with the
904           PostgreSQL library.
905         * Fix typo in sqlcounter expansion code.  Fixes #463
906         * Overwrite previous instances of SQL-User-Name when adding
907           it to the request.
908         * Work around bugs in both MIT and heimdal versions of
909           krb5_copy_context(), which caused segfaults in
910           multithreaded mode.
911         * Provide meaningful error messages if Heimdal krb5 is used.
912         * Fix attribute supression in rlm_detail.
913         * Exit with error code if child fails to complete server
914           initialisation after forking.  This allows init scripts to
915           correctly report whether the server started ok.
916
917 FreeRADIUS 3.0.0 Mon  7 Oct 2013 15:48:14 EDT urgency=medium
918         Feature improvements
919         * Documentation for upgrading from 2.x is in raddb/README.rst
920           Please follow it.  It will make the upgrade easier.
921         * Moved configuration entries in radiusd.conf to make more sense.
922         * Added the "integer64" and "ipv4prefix" data types.
923         * Added RADIUS over TLS (i.e. RadSec). See raddb/sites-available/tls
924         * Updated internal API to support new attributes and formats
925         * Added code to send SNMP Traps.  See raddb/trigger.conf.
926         * Added preliminary support for Apple's Grand Central Dispatch
927         * Added provisions for raddb/dictionary.local, for local changes.
928           See raddb/dictionary for more details.
929         * Added packet/s tracking. See max_pps in the "listen" section.
930         * The %{} expansions and "unlang" conditions are now parsed at server
931           start. Descriptive errors are produced for syntax and format errors.
932         * Casting is now supported for "unlang" comparisons.  See "man unlang"
933           e.g. <ipaddr>127.0.0.1 == Framed-IP-Address.
934         * Direct comparison of attribute references is now supported.
935           e.g. &Foo == &Bar.  This avoids stringification of the attributes.
936         * Direct assignment of attributes is now supported.
937           e.g. Foo := &Bar.  It also works for "octets" data types.
938         * Comparisons of IPv4 and IPv6 prefixes are now supported.
939           The "<" operator means "within the prefix" for comparisons.
940         * New sha1 xlat expansion (thanks to Alan Buxey)
941         * Colourised log messages when logging to stdout.  Look for yellow
942           warnings and red errors.  Doing this will save you a LOT of grief.
943         * If the PCRE library is available, use it (insted of the POSIX
944           functions) to process regular expressions (thanks to Phil Mayers).
945         * -xv now displays all the features the server was built with, and
946           the versions of the core libraries (libtalloc, libssl).
947
948         Module Changes
949         * Moved raddb/modules/ to raddb/mods-available/, and raddb/mods-enabled/,
950           following the examples of other projects.
951         * Additional files for each module are now in raddb/mods-config/.
952           See raddb/mods-config/README.rst for documentation.
953         * Moved "users" to raddb/mods-config/files/authorize
954         * Moved "hints" and "huntgroups" to raddb/mods-config/preprocess/
955         * Moved eap.conf to mods-available/eap
956         * Moved sql.conf to mods-available/sql
957         * Moved TLS configuration for EAP into a common subsection.
958           See raddb/mods-available/eap, "tls-config" section.
959         * Added for MS-CHAP Change Password from Phil Mayers.
960           See raddb/mods-available/mschap, "passchange" subsection.
961         * Added EAP-PWD implementation from Dan Harkins
962         * Added connection pools for modules. This unifies connection
963           management which was previously different for different modules.
964 l       * SQL now uses the connection pool.  See mods-available/sql
965         * SQL now supports arbitrary Acct-Status-Types.
966           These changes are not compatible with 2.x.
967         * SQL now has full support for SQLite.  See raddb/sql/main/sqlite/
968         * SQLite supports auto-creation of new databases on server startup for
969           bootstrapping purposes.
970         * LDAP now uses the connection pool.  The LDAP module has been
971           completely re-written for performance and simplicity.
972         * LDAP now caches groups.  This makes multiple group checks MUCH
973           faster.
974         * Removed all limitations on 253 octet attributes.  RFC 6929 allows
975           for attributes up to 4K in length.
976         * New rlm_idn module providing an expansion for performing IDNA encoding
977         of internationalized domain names.  Thanks to 'skids'.
978         * New rlm_yubikey module to validate yubikey OTP tokens.
979           See raddb/modules/yubikey
980
981         Bug fixes
982         * All known bug fixes from 2.2.x are included.
983         * Removed "addport" functionality.
984         * Removed many unused or duplicate modules.  See raddb/README.rst.
985
986         Internal / API changes:
987         * All traces of the old build system have been removed.
988           The new build system is faster and simpler.
989         * clang is fully supported.
990         * We now use "talloc" for memory management.  A number of new
991           features required this change.  Thanks to the Samba people!
992         * Many internal APIs have been updated to use talloc.
993         * New API for iterating over VALUE_PAIRs.  This is in preparation
994           for attributes, in version 3.1.
995         * No new code should directly modify any field of a VALUE_PAIR.
996         * VALUE_PAIRs contain pointers to DICT_ATTR instead of containing
997           attribute and vendor fields.  This will allow nested attributes.
998         * Some protocol specific code has been moved out into proto_* modules.
999           More will come in subsequent versions.  See proto_dhcp and proto_vmps.
1000         * Standardised internal logging macros.  radlog() should not be used.
1001           See src/include/log.h
1002         * Use OpenSSL hashing functions when available.
1003         * The server now builds with no warnings on most platforms.
1004         * New RADIUS encoder/decoder, to support new formats.
1005         * Added RFC 6929 "extended attributes", via the new encoder/decoder.
1006         * Added full WiMAX support, via the new encoder/decoder.  The old
1007           code could not handle some unusual corner cases.