Fix -exit patch rebasing mistake
[pkg-k5-afs_openafs.git] / NEWS
bloba53bc6f66bcfcb17cc57e0f6313bf0d58b6f3f5c
1                        User-Visible OpenAFS Changes
3 OpenAFS 1.6.21
5   All platforms
7     * Avoid a possible 100ms transmit delay in the RX protocol when a peer's
8       receive window transitions from closed to open (12627)
10     * Documentation improvements (12476 12477 12559[RT #133339])
12   All server platforms
14     * When bosserver is started with an unknown option, print an error message
15       and exit with a non-zero value rather than failing silently (12631)
17   All DB server platforms
19     * Hold the DB lock while checking for an aborted write transaction (12516)
21   All file server platforms
23     * On demand attach fileservers, don't save or restore a client's host
24       state if CPS ("Current Protection Subdomain") recalculation for it is
25       in progress, to avoid fileserver thread exhaustion (12568)
27     * On demand attach fileservers, avoid flooding the log with error messages,
28       which could happen when the fileserver was restarted while a volume was
29       offline (12569)
31     * Update a volume's "Last Update" time when its content is modified by
32       the salvager, to make the change visible in the output of "vos examine"
33       and to backup services (12633)
35   All client platforms
37     * Corrected the DCentries bucket counts for very large and zero length
38       files in the output of "fs getcacheparms -excessive" (12604 12605)
40     * Fixed a bug that prevented users with GID 2748 and 2750 from executing
41       the "fs sysname" command on clients running afsd with -rmtsys (12607)
43     * Provide a new -inumcalc switch for afsd to allow enabling the alternative
44       MD5 method of inode number calculation, which was previously only
45       possible on Linux and through the sysctl interface (12608 12632)
47   Linux clients
49     * Support for mainline kernel 4.12 and distribution kernels with backports
50       from it (12624 12626)
52     * Re-added the improved algorithm for freeing unused vcaches to reduce
53       memory consumption first introduced with the 1.6.18 release, together
54       with a fix for the issue leading to its removal in 1.6.18.2 (12448..12451)
56   macOS clients
58     * Fixed a crash while stopping the client on macOS 10.12 "Sierra" (12602)
61 OpenAFS 1.6.20.2
63   All platforms
65     * Build fixes required by recent compilers or platforms (12514 12521 12534
66       12536 12538)
68     * Allow the bos server to start successfully in the presence of those, by
69       accepting a now checked return value indicating that the client ThisCell
70       and CellServDB already exist (12522)
72   Linux clients
74     * Support for mainline kernels 4.10 and - most likely - 4.11 and
75       distribution kernels with backports from them (12530 12588..12590 12598)
77     * Support for distribution kernels with partial backports from 4.9 (12535)
78       (RT #134158)
80     * In Red Hat packaging, moved the klog.krb5 manual page into the krb5
81       subpackage (12511)
83     * In Red Hat packaging, prevent systemd from double-starting the client
84       (12587)
86     * Allow aklog to function on current S390/S390x (12499)
88   Solaris clients
90     * Make process authentication groups work on Solaris 11, now using a single
91       group ID (12524..12527)
93     * Fix a BAD TRAP panic on Solaris 11 clients built with Studio 12.5 (12567)
95   macOS clients
97     * Fixed the preference pane for OS X 10.11 and later (12512)
99 OpenAFS 1.6.20.1
101   All platforms
103     * Build fixes required by recent compilers (12482..12484)
105   Linux clients
107     * Support for mainline kernel 4.9 and distribution kernels with
108       backports from it (12478..12480)
110     * In Red Hat packaging, make systemd deal correctly with the client
111       when no userland processes remain after starting it (12481)
112       (RT #133482)
114   macOS
116     * Support for release 10.12 "Sierra" (12431 12432)
118     * Avoid a crash in the Mounts tab of the OpenAFS preference pane (12447)
120 OpenAFS 1.6.20 (Security Release)
122   All platforms
124     * Fix for OPENAFS-SA-2016-003: file and directory names leak due to
125       reuse of directory objects without zeroing the contents
126       (12461 12462 12463 12464 12465)
128 OpenAFS 1.6.19
130   All platforms
132     * Documentation improvements (12304)
133     * Fixes for test failures (12396 12415)
135   All DB server platforms
137     * Avoid potentially writing to an out of date volume location or protection
138       database, or losing a database write, which could happen in rare cases
139       under special conditions during database leader election
140       (12339 12389)
142   Solaris clients
144     * Allow the fsinfo::: DTrace provider to work with AFS files (12371)
146   Linux clients
148     * Don't commit more data to a file than was actually copied during writes,
149       which could happen on architectures with a page size > 4 KiB (12413)
150     * Fixed build on PPC64 with GCC 6.1 (12388) (RT #133407)
151     * Fixed build on x86_64 with recent GCC (12365 12366)
154 OpenAFS 1.6.18.3
156   Linux clients
158     * Support for mainline kernel 4.7 and distribution kernels with
159       backports from it (12348)
161   Solaris clients
163     * Fixed memory mapped I/O on files >= 4 GiB (12349 12350)
165       Note that there is a suspicion that this might break the client
166       on very old Solaris releases (2.6). If it does, the breakage should
167       occur at build time.
169   OS X
171     * Added tooling to build a package for OS X 10.10 "Yosemite" and
172       10.11 "El Capitan" (12335 12351)
175 OpenAFS 1.6.18.2
177   Linux clients
179     * Support for mainline kernel 4.6 and distribution kernels with
180       backports from it (12332)
182     * Switch back to the pre-1.6.18 algorithm for freeing unused vcaches.
183       While the new algorithm is still believed to be correct, it turned
184       out that at least on some kernels, including 4.5 and 4.6, the dentry
185       for the current working directory may be erroneously invalidated.
186       This could lead to errors like "Unable to read current working directory"
187       when a directory wasn't accessed for a few minutes. (12323)
189     * Use a secure URL to retrieve the CellServDB in the script to create
190       the Red Hat source package (12330)
192   FreeBSD
194     * Added sysname IDs for 10.2 and 10.3 to fix the build on those platforms
195       (12322)
198 OpenAFS 1.6.18.1
200   Linux clients
202     * Support for mainline kernel 4.5 and distribution kernels with
203       backports from it (12300..12302)
206 OpenAFS 1.6.18
208   All platforms
210     * Documentation improvements (12224 11675 11613 12197)
212     * Improved diagnostics and error messages (12129 12207 12185 12211 12113
213       12215 12216)
215     * Check that CellServDB entries are valid IPv4 addresses, to avoid
216       occasional hangs or potentially other erratic behaviour due to invalid
217       entries (12210) (RT #131794)
219   All client platforms
221     * Gracefully handle cases where a client shutdown sequence is initiated
222       while the client is already shutting down, rather than cause a panic
223       (12179)
225     * Fixed several bugs that could cause erratic behaviour when the write
226       offset into a file was more than 2 GiB beyond the file's current end
227       on the server (12213 12214)
229   All server platforms
231     * Avoid a possible volserver crash during volume dump or restore due
232       to invalid ACL entries (12127)
234     * Allow recovering from a DAFS fileserver operation which allocates a
235       new vnode but fails to update the vnode index, rather than crashing the
236       server (12209)
238     * Fixed a longstanding bug which could damage the volume location database
239       when "vos changeaddr" was run with "-oldaddr" and "-newaddr" and the
240       old address was present in a multi-homed entry (12089)
242   FreeBSD
244     * Added support for releases 10.2 and 10.3 (12232)
246   Linux clients
248     * Support for mainline kernel 4.4 and distribution kernels with
249       backports from it, alas at a performance penalty (12226 12227 12228)
250       (RT #132677 #132819)
252     * Avoid using excessive amounts of kernel memory for dynamically
253       allocated vcaches, by improving the algorithm to free unused ones
254       (12256 12257)
256     * In Red Hat packaging, make the init script use "ip" if available, with
257       "ifconfig" as a fallback (12193)
259   OS X
261     * Basic support for release 10.11 "El Capitan" (12212)
263   IRIX clients
265     * Fixed kernel module builds with optimization (12198) (RT #131261)
268 OpenAFS 1.6.17 (Security Release)
270   All server platforms
272     * Fix for OPENAFS-SA-2016-001: foreign users can create groups as
273       if they were an administrator (RT #132822) (CVE-2016-2860)
275   All client platforms
277     * Fix for OPENAFS-SA-2016-002: information leakage from sending
278       uninitialized memory over the network.  Multiple call sites
279       were vulnerable, with potential for leaking both kernel and
280       userland stack data (RT #132847)
282     * Update to the GCO CellServDB update from 01 January 2016 (12188)
284   Linux clients
286     * Fix a crash when the root volume is not found and dynroot is not
287       in use, a regression introduced in 1.6.14.1 (12166)
289     * Avoid introducing a dependency on the kernel-devel package corresponding
290       to the currently running system while building the srpm (12195)
292     * Create systemd unit files with mode 0644 instead of 0755
293       (12196) (RT #132662)
295 OpenAFS 1.6.16
297   All platforms
299     * Documentation improvements (11932 12096 12100 12112 12120)
301     * Improved diagnostics and error messages (11586 11587)
303     * Distribute the contributor code of conduct with the stable release (12056)
305   All server platforms
307     * Create PID files in the right location when bosserver is started with
308       the "-pidfiles" argument and transarc paths are not being used (12086)
310     * Several fixes regarding volume dump creation and restore (11433 11553
311       11825 11826 12082)
313     * Avoid a reported bosserver crash, and potentially others, by replacing
314       fixed size buffers with dynamically allocated ones in some user handling
315       functions (11436) (RT #130719)
317     * Obey the "-toname" parameter in "vos clone" operations (11434)
319     * Avoid writing a loopback address into the server CellServDB - search
320       for a non-loopback one, and fail if none is found (12083 12105)
322     * Rebuild the vldb free list with "vldb_check -fix" (12084)
324     * Fixed and improved the "check_sysid" utility (12090)
326     * Fixed and improved the "prdb_check" utility (12101..04)
328   All client platforms
330     * Avoid a potential denial of service issue, by fixing a bug in pioctl
331       logic that allowed a local user to overrun a kernel buffer with a single
332       NUL byte (commit 2ef86372) (RT #132256) (CVE-2015-8312)
334     * Refuse to change multi-homed server entries with "vos changeaddr",
335       unless "-force" is given, to avoid corruption of those entries (12087)
337     * Provide a new vos subcommand "remaddrs" for removing server entries, to
338       replace the slightly confusing "vos changeaddr -remove" (12092 12094)
340     * Make "fs flushall" actually invalidate all cached data (11894)
342     * Prevent spurious call aborts due to erroneous idle timeouts (11594)
344     * Provide a "--disable-gtx" configure switch to avoid building and
345       installing libgtx and its header files as well as the depending
346       "scout" and "afsmonitor" applications (12095)
348     * Fixed building the gtx applications against newer ncurses (12125)
350     * Allow pioctls to work in environments where the syscall emulation
351       pseudo file is created in a read-only pseudo filesystem, like in
352       containers under recent versions of docker (12124)
354   Linux clients
356     * In Red Hat packaging, avoid following a symbolic link when writing
357       the client CellServDB, which could overwrite the server CellServDB,
358       by removing an existing symlink before writing the file (12081)
360     * In Red Hat packaging, avoid a conflict of openafs-debuginfo with
361       krb5-debuginfo by excluding our kpasswd executable from debuginfo
362       processing (12128) (RT #131771)
364 OpenAFS 1.6.15 (Security Release)
366   All client and server platforms
368     * Fix for OPENAFS-SA-2015-007 "Tattletale"
370       When constructing an Rx acknowledgment (ACK) packet, Andrew-derived
371       Rx implementations do not initialize three octets of data that are
372       padding in the C language structure and were inadvertently included
373       in the wire protocol (CVE-2015-7762).  Additionally, OpenAFS Rx in
374       versions 1.5.75 through 1.5.78, 1.6.0 through 1.6.14, and 1.7.0
375       through 1.7.32 include a variable-length padding at the end of the
376       ACK packet, in an attempt to detect the path MTU, but only four octets
377       of the additional padding are initialized (CVE-2015-7763).
379 OpenAFS 1.6.14.1
381   Linux clients
383     * Support kernels up to 4.2
385       Due to changes to internal data structures with this kernel release,
386       the OpenAFS client can no longer reset the link count during path
387       lookups. Since volume root directories must behave like symlinks
388       instead of normal directories in order to satisfy Linux kernel
389       invariants, looking up paths containing more than 40 mount points
390       will fail with ELOOP on such kernels.
392 OpenAFS 1.6.14
394   All server platforms
396     * Prior to the OpenAFS security release 1.6.13, the Volume Location
397       Server (vlserver) RPC VL_ListAttributesN2() supported wildcard volume
398       name lookups via regular expression (regex) pattern matching. This
399       support was completely disabled in 1.6.13 because it was judged to be
400       a security risk due to buffer overruns in the implementation, as well
401       as the possibility of denial of service attacks where certain regular
402       expressions could cause excessive CPU usage in some regex
403       implementations.
405       Unfortunately, after 1.6.13 was released, it was discovered that
406       the native OpenAFS 'backup' system uses the VL_ListAttributesN2()
407       regex support to evaluate configured volume sets. If you use the
408       OpenAFS 'backup' system (or another backup system which relies on it,
409       such as Tivoli Storage Manager (TSM, aka Tivoli ADSM)), and are using
410       volume sets which require regular expressions for the volume name,
411       then those volume sets cannot be resolved by OpenAFS 1.6.13. The next
412       paragraph provides details on how to identify any affected volume sets.
414       OpenAFS backup volume sets may be described by fileserver, partition
415       name, and volume name. The fileserver and partition specifications
416       never require regular expression support. The volume name specification
417       always requires regular expression support except for when specifying
418       _all_ volumes via two special cases: the universal wildcard ".*", or "".
419       For example, volume name "proj" or "*.backup" or "homevol.*" all
420       require regex support - even if the specification contains no wildcard
421       characters and/or exactly matches an existing volume name.
423       As a result of this issue, OpenAFS 1.6.14 replaces the 1.6.13 changes
424       to VL_ListAttributesN2. 1.6.14 prevents the buffer overruns and
425       reenables the regex support, but restricts it to OpenAFS super-users
426       and -localauth only. This is sufficient to restore the OpenAFS 'backup'
427       system's ability to work correctly with any previously supported volume
428       set. The OpenAFS 'backup' commands are already documented to require
429       super-user authorization, so this restriction is moot for the backup
430       system.
432       There are no other direct consumers of the VL_ListAttributesN2() regex
433       support in the OpenAFS tree. However, the VL_ListAttributesN2 RPC is
434       publicly accessible and might be used by third party tools directly or
435       indirectly via OpenAFS's libadmin. Any such tools that issue
436       VL_ListAttributesN2 RPCs must now be executed using super-user or
437       -localauth tokens.
439       None of the other security fixes in OpenAFS 1.6.13 are known to have
440       any issues, and are still included unchanged in OpenAFS 1.6.14.
442       If there are any questions concerning the possible impact of OpenAFS
443       1.6.13 or 1.6.14 at your site, please contact your OpenAFS support
444       provider or the openafs-info@openafs.org mailing list for further
445       assistance.
447 OpenAFS 1.6.13
449   All server platforms
451     * Fix for CVE-2015-3282: vos leaks stack data onto the wire in the
452       clear when creating vldb entries
454     * Workaround for CVE-2015-3283: bos commands can be spoofed, including
455       some which alter server state
457     * Disabled searching the VLDB by volume name regular expression to avoid
458       possible buffer overruns in the volume location server
460   All client platforms
462     * Fix for CVE-2015-3284: pioctls leak kernel memory
464     * Fix for CVE-2015-3285: kernel pioctl support for OSD command passing
465       can trigger a panic
467   Solaris clients
469     * Fix for CVE-2015-3286: Solaris grouplist modifications for PAGs can
470       panic  or overwrite memory
472 OpenAFS 1.6.12
474   All server platforms
476     * Avoid database corruption if a database server is shut down and then
477       brought up again quickly with an altered database (11773 11774)
478       (RT #131997)
480   All client platforms
482     * Fixed a potential buffer overflow in aklog (11808)
484     * Avoid a bogus warning regarding the checkserver daemon, which could be
485       logged during startup when the cache initialization was very fast (11680)
487     * Added documentation of the inaccuracy of the 'partition' field in
488       'fs listquota' output for partitions larger than 2 TiB (11626)
490   Linux clients
492     * Support kernels up to 4.1 (11872 11873)
494     * Avoid spurious EIO errors when writing large chunks of data to
495       mmapped files (11877)
497   OS X
499     * Build fixes required at least on OS X 10.10 Yosemite with the latest
500       XCode (11859 11876 11842..11845 11863 11878 11879)
502 OpenAFS 1.6.11.1
504   Linux clients
506     * Support kernels up to 4.0 (11760 11761)
508   FreeBSD clients
510     * Fixed kernel module build on systems with an updated clang which no
511       longer accepts the -mno-align-long-strings as a no-op (11809)
513 OpenAFS 1.6.11
515   All platforms
517     * Allow aklog to succeed creating native K5 tokens even when mapping
518       the K5 principal to a K4 one fails (11538)
520     * Build fixes (11435 11636)
522   All client platforms
524     * Avoid a potential kernel panic due to connection reference overcounts
525       (11645) (RT #131885)
527     * Avoid potential corruption of files written using memory mapped I/O
528       when the file is larger than the cache (11656) (RT #131976)
530   Linux clients
532     * Support kernels at least up to 3.19 (11549 11550 11569 11570 11595
533       11658..11662 11694 11752)
535       Note: By default this excludes kernels 3.17 to 3.17.2, which will leak
536             an inode reference when an error occurs in d_splice_alias(). The
537             module will build and work, but leak kernel memory, leading to
538             performance degradation and eventually system failure due to
539             memory exhaustion. Since it's impossible to detect this condition
540             automatically, the switch --enable-linux-d_splice_alias-extra-iput
541             must be passed to configure when building the module for those
542             kernels. The same would be necessary for any kernel with backports
543             of commit 908790fa3b779d37365e6b28e3aa0f6e833020c3 or commit
544             95ad5c291313b66a98a44dc92b57e0b37c1dd589 but not the fix in commit
545             51486b900ee92856b977eacfc5bfbe6565028070 in the linux-stable repo
546             (git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git) or
547             the corresponding changes on other branches.
549     * Fixed a regression introduced in OpenAFS release 1.6.10 which could
550       make the spurious "getcwd: cannot access parent directories" problem
551       return (11558 11568) (RT #131780)
553     * Avoid leaking memory when scanning a corrupt directory (11707)
555   OS X clients
557     * Support OS X 10.10 "Yosemite" (11571 11572 11611) (RT #131946)
559   Solaris clients
561     * Avoid reading random data rather than correct cache content when using
562       ZFS as the cache file system on Solaris >= 11, and fix potential similar
563       problems on other platforms (11713 11714)
565   FreeBSD
567     * Build fix for releases >= 11.0 (11610)
569   OpenBSD
571     * Support release 5.4 (11700)
574 OpenAFS 1.6.10
576   All platforms
578     * Don't hide the "version" subcommand in help output (11214)
580     * Documentation improvements (11126 11216 11222 11223 11225 11226)
582     * Improved diagnostics and error messages (11154 11246 11247 11249 11181
583       11182 11183)
585     * Build system improvements (11158 11221 11224 11225 11227..11241 11282
586       11342 11350 11353 11242 11367 11392)
588     * Avoid potentially erratic behaviour under certain error conditions by
589       either avoiding or at least not ignoring them, in various places (11008
590       11010..11065 11112 11148 11196 11530)
592   FreeBSD
594     * Support releases 9.3 and 10.1 (11368 11369 11402 11403 11404)
596     * Makes a disk cache more likely to work on FreeBSD, though such
597       configurations remain not very tested (11448)
599   All server platforms
601     * Added volscan(8) (11252..11280 11387 11388)
603     * Fixed a bug causing subgroups not to function correctly if their
604       ptdb entry had more than one continuation entry (11352)
606     * Logging improvements (10946 11153)
608     * Allow log rotation via copy and truncate (11193)
610     * Avoid a server crash during startup only observed on a single platform
611       and when using a 3rd party library under certain circumstances, which is
612       a collateral effect of the security improvements introduced in OpenAFS
613       release 1.6.5 (11075) (RT #131852)
615   All client platforms
617     * Raised the free space reported for /afs to the maximum possible value of
618       just under 2 TiB - the old value was 9 GiB on most platforms (10984)
620     * Reduced the amount of stack space used (11162 11163 11203 11164..11167
621       11338 11339 11364..11366 11381)
623     * Sped up a periodic client task which could be problematically slow
624       on systems with a large number of PAGs and files in use (11307)
626     * Fixed failure of the up command with large ACLs (11111)
628     * Avoid a potential crash of aklog (11218)
630     * Avoid potential crashes of scout and xstat_fs_test (11155)
632   Linux clients
634     * Support kernels up to 3.16 (11308 11309)
636     * Fixed a regression introduced in OpenAFS release 1.6.6 that made
637       checking for existing write locks incorrectly fail on readonly volumes
638       (11361)
640     * Fixed a regression introduced in OpenAFS release 1.6.8 that could
641       cause VFS cache inconsistencies when a previously-accessed directory
642       entry was removed and recreated with the same name but pointing to a
643       different file on another client (11358)
645     * Use the right path to depmod in Red Hat packaging to avoid dependency
646       calculation incorrectly failing unless a link /sbin -> /usr/sbin is
647       present on the system performing it (11171) (RT #131860)
649     * Do not ignore kernel module build errors (11205)
651 OpenAFS 1.6.9
653   All server platforms
655     * Fix for OPENAFS-SA-2014-002
657 OpenAFS 1.6.8
659   All platforms
661     * Documentation improvements (10751 10875 10931 10897 10883 10954 10955)
663     * Improved diagnostics and error messages (10756 10814 10949)
665     * Fixed a bug in RX that could make errors during packet reception go
666       unnoticed. (10733)
668     * Fixed a bug that made "vos size -dump" display the wrong size for
669       large volumes. (10933)  (RT #131819)
671   All server platforms
673     * Change the default fileserver sync behavior from "delayed" to "onclose".
674       This means that explicit syncing only happens when a volume is detached.
675       (10809)
677     * Added the -offline-timeout and -offline-shutdown-timeout options to the
678       fileserver, to implement interrupting clients accessing volumes we are
679       trying to take offline. (6266 10799)
681   All client platforms
683     * When a client is shut down, it will give up its callbacks. The Windows
684       client has been doing this since 2007. Note that older fileservers
685       (1.3.50 to 1.4.5 and 1.5.0 to 1.5.27) had a bug in the implementation of
686       the relevant RPC that could cause crashes or other undefined behavior
687       when this happens. (6272 8840 10855)
689     * Restored the pre-1.6 behavior of "vos e" being an alias for "vos examine".
690       (10886)
692     * Avoid flooding logs with warnings about byte-range locks, by throttling
693       them per file. Also, make the messages more useful by including the
694       FID. (10836..10839)
696     * Avoid a possible panic during shutdown while tracing. (10932)
698   Linux clients
700     * Fixed a bug that could cause the "getcwd: cannot access parent
701       directories" problem (10804 10984)
703     * Avoid a delay when accessing uncached data in AFS in a confined
704       context under SELinux. (10598)
706     * Red Hat packaging improvements (10600 10767 10807)
708 OpenAFS 1.6.7
710   All server platforms
712     * Fix for OPENAFS-SA-2014-001
714     * Fix for a potential DOS attack against RX servers
716 OpenAFS 1.6.6
718   All platforms
720     * As of this release, OpenAFS no longer ships uncompressed source tarballs.
721       Tarballs are still shipped with both compression formats, gzip and bzip2.
722       (10131)
724     * Documentation improvements (10136 10314 10601)
726     * Improved diagnostics and error messages (9412 10085 10274)
728     * Avoid redefining "assert" in our public header files, which could
729       cause failures when building some applications using them. (10096)
731     * Fixes for parallel builds (10005 10309 10337)
733     * Added a -s switch to afscp (not installed by default) to help simulate
734       a slow client. (9416 9417)
736     * Added a -probe switch to vlclient test program (not installed by default)
737       to ping all vlservers in a cell in parallel. (9570)
739   All server platforms
740     * The fileserver now ignores any vice partitions with a NeverAttach flag
741       file present in the root directory. (RT #130561) (9470 9471)
743     * Restrict forcing CPS ("Current Protection Subdomain") recalculation in
744       the fileserver to administrators. Also fixed a bug that could cause this
745       operation to be incomplete. (9485 9487)
747     * Allow non-DAFS fileservers to attach unusable volumes, restoring pre-1.6
748       behaviour. (RT #131505) (9499)
750     * Restored the pre-1.6 behaviour when running vos examine for a volume
751       currently in a transaction, showing the volume as busy again rather than
752       offline. (9685 9915 9916)
754     * Reduced the minimum time a bos salvage takes from 5 seconds to 1. (9476)
756     * Fixed buserver to not segfault when started with the -servers option.
757       (RT #131706) (10166)
759     * Salvager fixes, addressing a wide variety of possible problems from
760       unnecessary salvaging to aborts (9282 9283 9457 9458 9459 9461 9462 9480
761       9481 10165 10167)
763     * Fixed a bug that could cause saved state information to be discarded
764       when restarting a large or busy fileserver, which negatively impacted
765       performance. (9683)
767     * Fixed a bug that could have caused undefined behaviour in the vlserver
768       in rare cases when a fileserver registered its addresses in the VLDB.
769       (9429)
771     * Added the -preserve-vol-stats switch to volserver, allowing it to keep
772       the access statistics across volume restore and reclone operations
773       instead of resetting them. (9477)
775     * Inserted an exponential delay between retries when bosserver attempts to
776       restart a server process. (9571 10199)
778     * Improved vldb_check (not installed by default) to cope with broken
779       vlentry names and volids, and provide more output to aid debugging.
780       (10268)
782     * Releasing a volume after adding a new RO site no longer touches any of
783       the existing RO sites, if the RW data hasn't changed since the last
784       release. (10174)
786     * Make the copyDate field for RO clones have the same meaning as for
787       remote RO volumes. Previously, the copyDate field for clones was updated
788       every time we released. (9451)
790     * Fixed potentially undefined behaviour in ptserver when too many pts
791       ids are allocated. (10124)
793     * Note that the server side NAT pings feature present in the prereleases
794       was removed before the final release, since no positive feedback
795       was provided during prerelease testing. (9420 10135)
797   Linux servers
799     * Start bosserver with -nofork in the systemd unit file, to allow systemd
800       to track its state (10093)
802   All client platforms
804     * No longer track file locks on read-only volumes. Write locks can't
805       succeed, read locks always will. Avoids log messages about this kind
806       of lock. (8910)
808     * Added the "fs flushall" subcommand, which makes the client discard all
809       cached data. This was previously available on Windows only. (9065 9388
810       9389 9390)
812     * Fixed a bug that could make the client incorrectly believe its cache
813       is up to date. This change could negatively impact AFS <-> DFS
814       translators, should those still be running anywhere. (8898)
816     * Several changes to avoid panicing in certain error conditions.
817       (9131 9287 10354 10355 10356 10357) (partially addressing RT #131747)
819     * Added the -rxmaxfrags switch to afsd, allowing to limit the number
820       of UDP fragments sent or received per RX packet. (9430)
822     * Build fixes for aklog on several platforms (RT #131716) (9917 10107 10275)
824     * Require that the AFS mountpoint specified in the cacheinfo file is
825       an absolute path. Relative paths result in a client that basically
826       works but is not fully functional. (10253)
828     * Fixed a bug that could cause one of the afsd threads to enter an infinite
829       loop (10431 .. 10436)
831   Linux clients
833     * Support Linux kernels up to 3.13 (10241)
835     * Fixed a bug that made readv/writev calls in AFS space fail with Linux
836       kernels where generic_file_aio_read exists but those operations have
837       not been switched to using aio_read/aio_write. This was a regression
838       introduced with release 1.6.3 and affected at least RHEL 5.9 kernels.
839       (10248)
841     * Fixed a similar bug making core dumps fail in AFS space, affecting
842       a much wider range of kernels including the most recent ones.
843       (RT #131729) (10254)
845     * Enhanced the keyring code to make PAGs work correctly on kernels with a
846       distribution specific change to the Linux keyring code. This affected at
847       least SLES 11 SP3 kernels. (10252)
849     * Fixed a bug that could make failures during PAG instantiation go
850       unnoticed. (10255)
852     * Fixed a bug that made compilation fail for Linux kernels without
853       keyring support. This affected at least the SLE 10 SDK and an
854       OEM version of SLES 11 SP1. (10325)
856     * Fixed build for kernels with user namespace support enabled. Likely
857       to be required for Ubuntu 14.04 and eventually other distributions.
858       (10456 10457 10458 10518 10472)
860     * Support RHEL 6.5 kernels, and possibly others with changes backported
861       from recent mainline kernels that touch getname/putname, by no longer
862       using those functions. Previously, the client could cause a kernel
863       panic when syscall auditing was enabled. (10578)
865     * Make tmpfs usable as the cache filesystem again. This had been broken
866       since kernel 3.1 (9950 10193)
868     * When starting the client fails, clean up the backing device information
869       created in sysfs, to avoid error messages during a subsequent start
870       and possible system instability later on (10454)
872     * Update Red Hat packaging to support Fedora >= 20, RHEL >= 7 and
873       ELrepo kernels (10597 10619 10622 10703 10704)
875   OS X Clients
877     * Support OS X 10.9 "Mavericks" (10519 10541 10542 10543 10548 10549)
879   AIX clients
881     * Fixed a bug that caused the 1.6 AIX client to never receive any RX
882       packets in the kernel. (RT #131725)
884   FUSE client
886     * Support Solaris 11 (9454 9455)
888     * Allow other users to access filesystems mounted by root. (9452)
890   FreeBSD
892     * Build tvolser and dvolser on this platform (10122)
893     * Several fixes to catch up with newer releases (10374 .. 10381)
895   NetBSD
897     * Build tsalvaged, tvolser and dvolser on this platform (10121)
898     * Fixed build on NetBSD 5 and newer. (10138)
900 OpenAFS 1.6.5
902 All platforms
904     * Fixes for OpenAFS-SA-2013-0003 and OpenAFS-SA-2013-0004
906 OpenAFS 1.6.4
908 All platforms
910     * Obey the jumbo/nojumbo settings for ubik servers (the DB servers)
911       too. In previous releases, those servers may have used jumbograms
912       even if they were not configured to do so. This change corrects
913       the actual behaviour, and will improve performance and reliability
914       for sites where jumbograms are problematic. It could cause a decrease
915       in performance for sites where jumbograms work, but those can turn
916       them back on manually.
918     * Dozens of fixes for common coding problems like use after free,
919       use of possibly uninitialised memory, reading or writing past the
920       end of arrays and potential NULL pointer derefences. Spotted by
921       code analysis tools or human inspection.
923     * Documentation improvements.
925     * Fixes and improvements to the diagnostic or log messages printed by
926       vos, the fileserver and others.
928     * Build fixes, making parallel builds more reliable with certain
929       configuration options and helping various platforms including
930       recent releases of IRIX, Solaris and several flavours of Linux.
932     * Avoid sending a small amount of data over the wire unencrypted
933       under certain conditions, and emit the correct error message in
934       this case.
936 All server platforms
938     * Avoid generating duplicate IDs for readonly and backup volumes,
939       which could happen under certain conditions.
941     * Allow the fileserver to return volume data like quota or free space,
942       which is available publicly elsewhere, without the additional access
943       check for read permissions on a volume's root directory the fileserver
944       performed before.
946     * The fileserver now emits a log message when it ran out of memory for
947       callbacks.
949     * Avoid several potential fileserver problems, including memory
950       corruption and segmentation faults, due to client bookkeeping.
952     * Avoid known cases of silent data corruption due to background syncs
953       on the fileserver, especially during Copy on Write.
955     * Make the fileserver sync behaviour runtime configurable. Up to 1.4.5,
956       we had synchronous syncs which were safe but really slow. Since 1.4.5,
957       we've had asynchronous syncs which are much faster but believed to
958       be the cause of rare data corruption issues, and while all known cases
959       of these happening are believed to be fixed in the 1.6.3 release, doubts
960       remain. This change allows choosing between those, and in addition allows
961       to turn syncs by the fileserver off altogether, thus relying on the vice
962       partition's backend filesystem and the operating system, or to just
963       execute them when a volume is detached. The default behaviour is
964       unchanged from releases since 1.4.5, but it's highly recommended to
965       consider the additional options this change provides. Future OpenAFS
966       releases will default to "-sync=none".
968     * For dbservers, avoid a situation where misinterpreting transient
969       network errors causes long-term issues with achieving ubik quorum.
971 All UNIX client platforms
973     * Improvements to the detection of an aklog-specific krb5 configuration
974       file, for the purposes of turning on "weak crypto" for aklog.
976     * Fixed a regression introduced in release 1.6.2 which caused the
977       supposedly persistent disk cache to be discarded upon client start.
978       (RT #131655)
980 Linux clients
982     * Support Linux kernels up to 3.10
984     * Fixed two bugs making it impossible to unmount a disk cache filesystem
985       after it has been used by the client. (RT #131613)
987     * Fixed a bug that could cause an oops with kernels 3.6 and later
989 OpenBSD
991     * Improved support for OpenBSD 4.9 to 5.3
993 OpenAFS 1.6.3
995   This release number had to be skipped for technical reasons.
997 OpenAFS 1.6.2.1
999   Linux clients
1001     * Support Linux kernels up to 3.8.
1003     * Make the init script cope with the output of ifconfig on recent Fedora.
1005 OpenAFS 1.6.2
1007   All platforms
1009     * Fix buffer overflows in fileserver and ptserver.
1011     * Abort an rx connection when given an unknown service (Gerrit 7593).
1013     * "idle dead" behavior improvements.
1015     * Documentation updates.
1017   All server platforms
1019     * Fix rare file corruption during background sync (Gerrit 8796).
1021     * Fix corrupting clients' metadata cache during certain errors (Gerrit
1022       6957).
1024     * Avoid saying a volume doesn't exist when accessed as the volume is
1025       going offline (Gerrit 7488).
1027     * Fix fileservers to properly report >2 TiB partitions.
1029     * Fix stale volume info from vos examine on non-DAFS filservers.
1031     * Fix possible volume corruption with vos convertROtoRW.
1033     * Fix bosserver to preserve all command-line options over restart.
1035     * Fix bosserver to properly kill hung processes during shutdown.
1037   All UNIX client platforms
1039     * Fixes for memcache, especially on Solaris.
1041     * Increase the size of the DNS resolver answer buffer to allow sites
1042       with a long response list to use SRV and AFSDB records.
1044     * Fix a crash when a server appears to run out of addresses (Gerrit
1045       7487).
1047     * Fix cache corruption when reading from a file another client is
1048       simultaneously writing to (Gerrit 7994).
1050     * Improve handling of disk cache disk errors.
1052   Linux
1054     * fix DKMS configuration for DKMS 2.2.
1056     * Avoid generating inode number 0 with md5 inodes (Gerrit 7276).
1058     * Fix a crash when reading /proc/fs/openafs/unixusers (Gerrit 7914).
1060     * Make PAG-less access use the real UID of the calling process
1061       instead of the effective UID, when determining what credentials to
1062       use (Gerrit 7931).
1064     * Fix possible abuse of fs mkmount.
1065       Prior to 1.6.2, users could crash a client by nesting volume mounts.
1067     * Fix fileserver memory corruption on RHEL 6
1068       Prior to 1.6.2, fileservers on RHEL 6 may crash under heavy load.
1070     * Fix client page cache corruption on Linux
1071       When multiple clients read and write to a file, the reading client
1072       may see first page (4096 bytes) of a file as nulls.
1074     * Support Linux kernels up to 3.7.
1076     * Support newer glibc versions.
1078     * Improve client systemd unit file.
1080     * Update Red Hat packaging.
1082   OS X
1084     * Fix crashes on shutdown.
1086     * Prevent unloading the module before shutdown completes.
1088     * Security improvement for the OpenAFS preference pane.
1090   Solaris
1092     * Support newer versions of the Sun Studio compiler software.
1094     * Support compiling on newer versions of Solaris 11 and Solaris 10.
1097 OpenAFS 1.6.0 (2011-08-15)
1099   All platforms
1101     * Substantial Rx updates to correct erroneous behavior.
1103     * vos now properly deals with matching sites when servers are
1104       multihomed.
1106     * Don't stop Rx keepalives after an ackall is received, avoiding
1107       spurious connection timeouts. (128848)
1109     * Don't retry Rx calls on channels returning busy errors and improve
1110       Rx busy call channel error handling. (128671)
1112     * Properly enable Rx connection hard timeouts.
1114     * Rx NAT pings are not enabled until peer has answered.
1116     * Initialize rx_multi lock before use.
1118     * Avoid spurious crashes when initializing in "backup" client.
1120     * Revert UUID support in vos.
1122     * pt_util fixed to properly create new databases.
1124     * MTU discovery now properly shut down on call reset.
1126     * Avoid leaking references to hosts during callback break multi-Rx
1127       operations. (129376)
1129     * xstat tools now cope with differing timeval structures between
1130       endpoints.
1132     * Numerous fixes to command argument parsing.
1134     * Documentation updates.
1136   All server platforms
1138     * A file descriptor leak which could result in corrupted files in the
1139       fileserver was fixed. An IMMEDIATE upgrade from previous 1.5 release
1140       fileservers is recommended.
1142     * Fix ptserver supergroups support on 64 bit platforms.
1144     * Demand attach salvaging doesn't use freed volume pointers.
1146     * Properly hold host lock during host enumeration in fileserver.
1148     * Attempt to recovery more quickly from timed out volume release
1149       transactions.
1151     * Auditing now properly byte order swaps IP addresses when printing.
1153     * vos split now has improved error handling.
1155     * Many changes to again support Windows fileservers.
1157     * During volume removal, data removal speed improved.
1159     * Improve CPU utilization during volume attaching by DAFS.
1161     * In salvager check-only mode, avoid potentially fixing a vnode.
1163     * Fix support for large (greater than 2gb) volume special files.
1165     * Salvager will not crash if multiple or bad volume link tables are
1166       encountered.
1168     * Avoid erroneous full dump by remembering which sites were out of
1169       date at the start of the release.
1171     * A deleted volume can now be recreated properly.
1173     * Callbacks are again not broken during whole partition salvages.
1175     * Positional vectored IO fixed for largefile (>2GB) capable systems.
1177     * Fileserver per-client thread usage again properly enforced.
1179     * Anonymous dropbox support improved and drawbacks documented.
1181     * Demand attach: ensure vnodes are not reallocated while in use due to
1182       volume bitmap errors.
1184     * Properly support large volume numbers (larger than 2147483647).
1186     * Allow salvager to be run manually again when DAFS is being
1187       used. (129458)
1189     * Avoid leaking references to hosts during callback break multi-Rx
1190       operations. (129376)
1192     * Demand attach: unlink fileserver state file on standalone salvage.
1194     * Salvager tries harder to detect linktable issues.
1196     * Demand attach: don't attach volumes with special status set.
1198     * Avoid crashing on host table exhaustion. Instead, defer clients.
1200   Microsoft Windows
1202     * afs_config will not longer set the Tray Icon State in the registry
1203       if the checkbox is not present in the dialog. (128591)
1205     * AFS Explorer Shell Extension now works from folder backgrounds.
1206       Overlays for mount points and symlinks are present in the dll, but
1207       are not registered at present by the installers.
1209     * Do not use RankServerInterval registry value as the value for
1210       PerformanceTuningInterval.
1212     * When the data version of a mountpoint or symlink changes, the target
1213       string in the cm_scache_t object must be cleared.
1215     * "fs checkservers" now includes vldb servers in the output and only
1216       lists multi-homed servers once.  A multi-homed server that has at
1217       least one up interface is no longer considered to be down.
1219     * When asynchronously storing dirty data buffers to the file server
1220       ensure that (a) the cm_scache_t object and the cm_buf_t object are
1221       for the same File ID so that locking and signalling work properly;
1222       and (b) if the FID no longer exists on the file server, do not
1223       panic, just discard the buffer.
1225     * When processing VNOVOL, VMOVED and VOFFLINE errors perform server
1226       comparisons by UUID or address and not simply by cm_server_t
1227       pointer.  Otherwise, server failover may not succeed.
1229     * Do not preserve status information for cm_scache_t objects when the
1230       issuing server is multi-homed.
1232     * Giving up all callbacks when shutting down or suspending the machine
1233       is now significantly faster due to the use of an rx_multi
1234       implementation.  (This functionality is still off by default and
1235       must be activated by a registry value.)
1237     * Race conditions were possible when updating the state of the
1238       cm_volume_t flags and when moving the volumes within the least
1239       recently used list.
1241     * Ensure that the lanahelper library does not perform a NCBRESET of
1242       each lan adapter when enumerating the current network bindings.
1243       Correcting this permits OpenAFS to work on Windows 7 when the
1244       network adapter settings change.
1246     * Fix creation of mount points and symlinks as \\AFS\xxxx
1248     * Icon tray state now conditionally set. (128591)
1250     * Properly create new cell mount points in freelance mode.
1252     * Avoid recursive offline volume checks.
1254     * Fix caching of non-existent volumes.  The test to trigger an
1255       immediate CM_ERROR_NOSUCHVOLUME in cm_UpdateVolumeLocation() was
1256       backwards.
1258     * Prevent the background daemon from checking the status of
1259       non-existent volumes.  cm_CheckOfflineVolumes() should skip volume
1260       groups with the CM_VOLUMEFLAG_NOEXIST flag set.
1262     * The afskfw library should return an error immediately if the
1263       krb5_32.dll library cannot be loaded.  Affects afslogon.dll and
1264       afscreds.exe.
1266     * No longer depend on leashw32.dll in afskfw library.
1268     * NPLogonNotify must provide the user password in all calls to
1269       KFW_AFS_get_cred().  It cannot count on a credential cache being
1270       preserved between calls.  Permits tokens to be acquired for all
1271       cells listed in the TheseCells registry value for a domain.
1273     * Improve the trace logging from NPLogonNotify().
1275     * Avoid a race when writing the cm_scache_t mountPointString
1276       when acquiring mount point or symlink target data via
1277       cm_GetData().  The race could result in bogus target
1278       data being cached.
1280     * Permit the use of des-cbc-md5 and des-cbc-md4 enctypes
1281       as DES keys in asetkey.exe.
1283     * aklog supports dotted Kerberos v5 principal names.
1285     * afskfw library always attempts afs/cell@USER-REALM
1287     * afskfw library must test return code from krb5_cc_start_seq_get() or
1288       will trigger a null pointer exception when using Heimdal.
1290     * Lock protected fields must be 32-bit in order to avoid memory
1291       overwrite races.
1293     * Add support for NTFS symlinks.
1295     * Handle file search requests for virtual syscall ioctl file.
1297     * Process SyncOps properly to enforce ordered operations.
1299     * Avoid recursing during NewServer operations.
1301     * Correct lock acquisition order during SMB locking.
1303     * Add shutdown message to event log.
1305     * Check offline volume status by policy rather than on each daemon
1306       thread run.
1308     * Return error on directory object not found instead of crashing.
1310     * Improve error message output.
1312     * afslogin.dll can start afsd_service if it's not starting or started.
1314     * Optimize away release lock RPCs for deleted files.
1316     * Background Daemon will not perform operations on deleted files.
1318     * Resort recently used directories to the top of the LRU if the
1319       directory is larger than the stat cache.
1321     * Resort deleted objects to the bottom of the LRU.
1323     * Use interlocked operations for state and queue fields to allow safe
1324       bit set and clear on multiprocessor systems.
1326   All UNIX client platforms
1328     * Servers now marked down when GetCapabilities returns error.
1330     * In-use vcache count is now properly tracked.
1332     * Check for /afs existance before starting, unless -nomount is
1333       specified.
1335     * Avoid a potential panic when using /afs/.:mount syntax.
1337     * Avoid a panic in memcache mode due to missing CellItems file.
1339     * FUSE client support fixed for non-/afs mounts.
1341     * Avoid a potential deadlock (which times out) when we need to
1342       allocate more callback returns and must flush some already in use.
1344     * Deal with libcom_err conflicts with other packages using it
1345       (e.g. krb5) (128640)
1347     * Fall back to afs3-vlserver SRV record values when afs3-ptserver SRV
1348       record is not available.
1350     * Avoid holding unneeded locks when probing server capabilties.
1352     * Do not attempt page flushes for directories.
1354     * Rx connection reference counting is enabled.
1356     * An Rx connection reference count leak is fixed in bulkstat.
1358     * Handle unparsable directory objects.
1360     * Handle Kerberos cred cache errors in aklog.
1362   AIX
1364     * Fix PAG usage to track by PAG identifier, not group list.
1366   FreeBSD
1368     * Fix socket termination on shutdown.
1370     * Support for 7.2, 7.3, 7.4 and 8.2 included.
1372     * References to vcaches are no longer leaked during root or reclaim.
1374     * Remove support for "Giant" lock as we no longer need to use it.
1376     * Don't sleep with AFS GLOCK.
1378     * Properly enable 64 bit long long support.
1380     * Restore support for FreeBSD 7 (128612)
1382     * Fix locking issues at shutdown and avoid panic at shutdown due to
1383       vcache flushing.
1385     * Support for virtual network stacks.
1387     * New RC script, updated packaging.
1389   IRIX
1391     * Properly create new vnodes to avoid crashing in the client.
1393   Linux
1395     * Support through kernel 2.6.39.  Treat Linux 3.0 as Linux 2.6 for
1396       sysname purposes.
1398     * Use rx_Readv in cache bypass to improve performance.
1400     * Properly handle 0-length replies during cache bypass operations.
1402     * Properly handle non-contiguous readpage cache bypass operations.
1404     * Do proper locking when transitioning to or from cache bypass.
1406     * Avoid extra runs of vcache freeing routine. (128756)
1408     * Perform vcache eviction via a fast path before visiting vcaches
1409       where sleep is needed.
1411     * setpag() errors are now properly reported.
1413     * Avoid attempting to free stat cache entries when we are below
1414       user-specified number of entries in use.
1416     * Properly track user-specified number of stat cache entries to use as
1417       a desired usage target.
1419     * Don't read pages beyond EOF in the cache. (128452)
1421     * Various corrections and improvements to Red Hat packaging, including
1422       modifying the init script to allow deferring for a new binary
1423       restart and properly supporting RHEL6.
1425     * Fix lockup in 2.6.38 due to erroneous kernel feature configure test.
1427     * Improve RPM building tools.
1429     * Attempt to properly handle SELinux in packaging.
1431     * Init script properly returns status as exit code.
1433     * RPM packaging fixes (executable libraries, no postinstall message)
1435     * Kill i386 from RPM packaging.
1437   MacOS
1439     * MacOS 10.7 support.
1441     * Properly handle setpag errors.  PAGs are not supported.
1443     * Check for unloaded kernel extensions when decoding AFS panics.
1445     * Disable "get tokens at login" in prefs pane if AD authentication
1446       plugin is configured.
1448     * aklog AuthorizationPlugin now provided.
1450     * Preferences Pane behavior fixed for 1.6 series (version detection is
1451       used to select default behavior).
1453     * A potential kernel panic during bulkstat operations is
1454       fixed. (128511)
1456     * 64-bit MacOS kernel performance is greatly improved. (128934)
1458     * Properly shut down AFS, closing the Rx socket in the upcall handler
1459       to avoid attempting to process data after we can no longer do so.
1461     * Rework logic for bulk status operations to avoid a potential hang.
1463     * Avoid panic when doing FSEvent synthesis.
1465     * Fix bug when using non-dynroot.
1467     * Update Kerberos support in PreferencesPane.
1469   NetBSD
1471     * Updates for platform support.
1473   OpenBSD
1475     * Bug fixes for issues introduced previously in 1.5 series.
1477     * Support through OpenBSD 4.8.
1479   Solaris
1481     * Switch to ioctl() syscall replacement for Solaris 11 since syscall
1482       65 is not safe.
1484     * Fix support for Solaris pre-10.
1486     * Corrected Solaris 11 startup script.
1488     * vcache mappings freed on shutdown to avoid panic.
1490     * Properly report errors for AFS system call callers.
1492     * Don't leave dangling function references if kernel extension fails
1493       to load.
1495     * Try harder to avoid deadlocks on file-larger-than-cache operations.
1497     * Avoid panic on shutdown when mount failed.
1500 OpenAFS 1.5.78 (2010-11-04)
1502   All platforms
1504     * Revisions to Rx to fix performance issues.
1506     * Make fs getfid behave consistently across all platforms. (128372)
1508     * Properly check IDs handed to pts when creating users or groups so
1509       useful error messages can be provided. (128343)
1511     * Correct byte order handling of port in afsconf_LookupServer for SRV
1512       records.
1514     * Force a full dump when releasing to a site which was previously
1515       marked "don't use", in case the previous clone was out of date.
1517   All server platforms
1519     * Demand salvage of attached volumes now correctly track attachment
1520       state.
1522     * Avoid a potential crash due to failure to hold a lock when attaching
1523       a volume fails.
1525   Microsoft Windows
1527     * Track SMB connections by SID rather than username.
1529     * Error write attempts to known-readonly volumes earlier.
1531     * Validate directory buffers to avoid potential crashes.
1533     * Handle VIO errors from bulkstatus.
1535     * Make PMTU discovery configurable and register error handlers for it.
1537   All UNIX client platforms
1539     * Use larger I/O sizes in memcache to improve performance.
1541     * Avoid potential alignment issues doing I/O for pioctl calls.
1543   FreeBSD
1545     * Avoid panicing if the listener process is not findable.
1547     * Avoid deadlock issues while performing lookups.
1549   Linux
1551     * Handle stale file handle errors for some cache partition types.
1553     * Avoid blocking with xvcache lock when attempting to free in-use
1554       vcaches.
1556     * Build fixes for older kernels.
1558     * Properly configure LWP to use ucontext() on platforms where it
1559       should.
1561     * Eliminate spurious errors from AFS system call returns. (126230)
1563   MacOS
1565     * Attempt to honor configured Kerberos defaults in Preferences Pane.
1568 OpenAFS 1.5.77 (2010-09-08)
1570   All platforms
1572     * Rx path MTU detection will terminate detection in cases where the
1573       minimum required packet size cannot be transferred.
1575     * vos dryrun mode now shows effects for syncvldb single volume case.
1577     * vos dryrun mode now shows "status after" for syncvldb and syncserv.
1579   All server platforms
1581     * RXAFS_GetStatistics64 now returns statistics properly.
1583   Microsoft Windows
1585     * Attempt to properly identify the local system SMB connection for
1586       token tracking.
1588     * Remap timeout and offline errors to proper NT RPC errors.
1590     * Properly fail over to other replicas on bulkstat IO errors.
1592     * Properly error delete-mode createfile if a file is set readonly.
1594     * Validate directory entry buffers to avoid crashing the service.
1596     * Log file modes properly.
1598     * Log cell name when logging server information.
1600   All UNIX client platforms
1602     * cacheout program for discarding callbacks is now built.
1604     * bulkstatus kernel locking is corrected to avoid a potential panic.
1606   Dragonfly BSD
1608     * userspace support update
1610   FreeBSD
1612     * Updated vnode locking for children returned via lookup().
1614     * Avoid file open undercount with needed calls to
1615       FakeOpen/FakeClose().
1617     * Use vnode_pager_setsize to properly track file size during kernel
1618       IO.
1620     * Update system call installation.
1622     * Fix shutdown of Rx kernel listener to avoid potential dereference
1623       after it's gone.
1625     * Avoid closing vnodes during vnode recycle.
1627     * Fix bogus call to FlushVS for vnode reclaims.
1629   Linux
1631     * Packaging updated for current configure options and built files.
1633     * Cache bypass now holds reference on pages during readpage.
1635     * s390x setgroups32 patching update.
1637   MacOS
1639     * DNS resolver is reinitialized on IP address change. (126440)
1642 OpenAFS 1.5.76 (2010-08-16)
1644   All platforms
1646     * Updates to build-time configuration.
1648     * Fix XDR support in Rx to match header definition.
1650     * vos status now shows transaction creation, not action creation.
1652     * Rx avoids reporting loopback adapters when listing interfaces.
1654   All server platforms
1656     * Demand-Attach Fileserver always built and installed (dafileserver,
1657       davolserver, dasalvager).
1659     * Return VNOVOL from fileserver when a volume is deleted.
1661     * Ignore duplicate tags during volume restore operation.
1663     * Update inode array after salvage repairs volume.
1665     * Zero a corrupted header in memory during salvage to avoid further
1666       corruption.
1668     * Fix NAMEI backend to allow low-numbered volumes to work properly.
1670     * ptserver does not include cell name as part of length check for
1671       names.
1673     * Updated error messages for unblessed volumes.
1675     * vlserver avoids buffer overflow with regex pattern
1677     * Attach-time failures now note failures as the rest of the fileserver
1678       would.
1680     * Server argument logging will no longer overflow stack.
1682     * Provide fast-restart-like unsafe-nosalvage option for DAFS.
1684     * Deal with host hash collisions in the fileserver.
1686   Microsoft Windows
1688     * Avoid crashing when interpreting a drive letter as potentially
1689       matching a cell name.
1691     * Properly handle volume package errors.
1693     * Allow page recycling from known-readonly content without ensuring
1694       they are not dirty.
1696     * 32 bit tools installer should not override client configuration.
1698     * Ensure root scache item has a valid callback when use is attempted.
1700     * Freelance directory changes now properly invalidate and replace the
1701       old root object.
1703   All UNIX client platforms
1705     * Support disconnected reconnecting with specified UID for PAGless
1706       platforms.
1708     * Proper disconnected vnode reference tracking.
1710     * Update server site blacklisting to not return success if nothing was
1711       blacklisted.
1713     * Avoid a panic during vcache contention due to CVInit vcache
1714       racing. (127645)
1716   FreeBSD
1718     * Update for network stack in 8.1/9.0.
1720   HP-UX
1722     * Bug fixes.
1724   Linux
1726     * 2.6.36 support
1728     * Disable PMTU error packet handling.
1730     * flock() fixes.
1732     * Debian packaging updated.
1734     * freezer interface updates.
1736   MacOS
1738     * Hold references to disconnected mode written vnodes properly.
1740   Solaris
1742     * Handle NFS translator module references for amd64.
1744     * INODE fileserver backend support now exists for amd64.
1747 OpenAFS 1.5.75 (2010-07-07)
1749   All platforms
1751     * Prevent rx_rpc_stats global lock from being a bottleneck.
1753     * Path MTU discovery is now provided to allow traffic to pass networks
1754       with sub-1500 byte MTUs and poor fragment handling.
1756     * Further reduce Rx NAT ping transmission when enabled.
1758     * Update Kerberos 5-based token handling in rxkad from upstream
1759       Heimdal.  (127554)
1761     * Update version numbers emitted during build to reflect what is
1762       actually being built.
1764     * Add "-human" switch for human-readable units in fs diskfree and
1765       listquota. (124529)
1767     * vos provides reasons for locked volumes when known.
1769     * Do not count retransmission and ping acks as non-idle for Rx
1770       connections.
1772     * Rx: provide service-specific data getter and setter routines.
1774     * Update build-time Kerberos detection.
1776     * Updated userspace AFS client.
1778     * Beginning of a modernized test suite.
1780     * Additional documentation.
1782     * Updated documentation, notably the Administrators Guide.
1784     * Substantial code cleanup.
1786   All server platforms
1788     * Update handling of vnode allocation failures.
1790     * DAFS: allow salvaging volumes not known to the fileserver, to allow
1791       cleanup of data not attached to a current volume.
1793     * Properly handle volumes slated for destruction.
1795     * Handle volumes with many files properly.
1797     * Force core file generation in bosserver by overriding default
1798       resource limits when possible.
1800     * Update vlclient and vldb_check.
1802     * Avoid potentially corrupting a volume on creation if files are left
1803       from previous failed cleanup.
1805     * Note volume changed during salvage as needed.
1807     * DAFS: do not assume invalid addresses are in fileserver address hash
1808       table.
1810     * Avoid tying up fileserver threads with volumes that are being taken
1811       offline.
1813     * Do not set inUse on volumes for non-DAFS other than in fileserver.
1815     * Break origin's callback on target of rename operation.
1817     * Avoid unneeded parent directory link updates during some rename
1818       operations.
1820     * Do not open /dev/console for writing in the fileserver.
1822     * DAFS: avoid spurious restarts when binary restarts are configured.
1824     * Avoid spurious and unneeded calls to sync(), which can slow down the
1825       fileserver.
1827   Microsoft Windows
1829     * Revised SMB QuerySecurityInfo to address issues caused by MS10-020
1830       (http://support.microsoft.com/kb/980232)
1832     * Prevent use of the AFSCache file contents if mapped to a new
1833       address.
1835     * Make fs newcell include behavior compatible with the non-Windows
1836       version.
1838     * Provide a registry option (FreelanceImportCellServDB) to pre-create
1839       mount points in the AFS root for all cells in CellServDB.
1841     * Fix a memory leak in the cm_FreeServerList() routine.
1843     * Reduce privilege when reading registry CellServDB.
1845     * Add support for RPC Pipe Service NetWkstaGetInfo levels needed for
1846       Windows 7.
1848     * Prevent overflow when computing quota percentage in Explorer Shell.
1849       (126846)
1851     * Generate meaningful errors for ACL operations on freelance AFS root.
1853     * Fix error handling on InlineBulkStatus RPCs.
1855     * Show configuration pages for all types of MSI installations.
1857     * Improve freemount AFS root directory handling and operations.
1859     * Properly validate GetVolumeStatus pioctl responses.
1861     * Commit file length changes and dirty buffers when flushing a file.
1863   All UNIX client platforms
1865     * Update version of files for disk cache.
1867     * Do not call afs_FlushVCBs with xvcache lock held, to improve
1868       parallelization.
1870     * Add mariner log messages for creating and removing files.
1872     * Don't hold xvcache lock while creating symlinks, to improve
1873       parallelization.
1875     * Provide -dynroot-sparse mode to not show all cells in CellServDB in
1876       dynroot mode.
1878     * Avoid a potential crash in aklog in linked cell handling.
1880     * Log MTU-caused packet retransmission.
1882     * Prevent crashes caused be fs checkservers while cache is being set
1883       up.
1885     * fs getserverprefs now has a buffer large enough for the default
1886       CellServDB.
1888     * Report server address when logging warnings.
1890     * Avoid panic in GetCapabilities when cell is not known.
1892     * Lock process name and id for advisory lock warnings when possible.
1894     * Handle need for allocating additional Rx packets.
1896     * Properly handle errors from InlineBulkStatus operations.
1898     * Fix errors returned from fcntl() on readonly files locked for write.
1900     * Flush pending changes to the server on LOCK_EX unlock.
1902     * Reflect length changes as a result of callbacks even when file is
1903       open for write.
1905     * Avoid hanging due to error exit when attempting to store a large
1906       file to a non-largefile fileserver.
1908     * Recover from afs_GetVolSlot errors.
1910   FreeBSD
1912     * Bugfixes for kernel VFS and network routines.
1914   IRIX
1916     * Provide makesname().
1918   Linux
1920     * Avoid syscall probes when keyrings are present, by default. (125215)
1922     * Remove "Big Kernel Lock" from VFS operations.
1924     * Use filehandles for all Linux 2.6 versions to avoid need for matched
1925       afsd. (127530)
1927     * Updated RPM packaging.
1929     * Fix dkms configuration provided with RPMs.
1931     * Hold reference on pages during background I/O for cache bypass.
1933     * Fix cache bypass handling of non-largefile fileservers.
1935     * Protect truncate_inode_pages mappings with mutex or semaphore as
1936       needed.
1938     * Fix pagevec use in cache bypass. (127505)
1940     * Updates for 2.6.35
1942   MacOS
1944     * Improve launchd configuration.
1946     * Avoid hanging on recursive cache file lock acquisition when user
1947       notification is enabled.
1949     * Fix and re-enable bulkstat mode.
1951   OpenBSD
1953     * Build updates.
1955   Solaris
1957     * Precluding unmount while AFS is busy.
1959     * Avoid deadlocking when releasing the VFS object.
1961     * Stop network interface poller in kernel on AFS shutdown.
1963     * Avoid issues with lookups on empty directory names. (127356)
1966 OpenAFS 1.5.74 (2010-04-22)
1968   All platforms
1970     * Add "vos setaddrs" command.
1972     * Rx library lock contention avoidance between rx_NewCall and
1973       rx_EndCall.
1975     * Rx library races due to inconsistent use of rx_connection
1976       conn_data_lock to protect the flags field.
1978     * Rx library inconsistent use of RX_CALL_TQ_WAIT which could result in
1979       deadlocks.
1981     * Rx library must signal transmit queue waiters when flushing.
1983     * afsmonitor shows busy counts now.
1985     * afsmonitor displays xstat callback statistics.
1987     * Provide expandgroups for pts mem on a supergroups server.
1989     * Provide supergroup option to liste nested groups during pts mem.
1991   All server platforms
1993     * Avoid volume lock contention during DAFS startup.
1995   Microsoft Windows
1997     * Avoid a race when updating cell vldb server lists that can result in
1998       a crash.
2000     * Avoid a deadlock when managing CM_SCACHESYNC_STOREDATA state
2001       operations for directory objects.
2003     * Add new Windows Application Event log messages for VBUSY,
2004       VRESTARTING, ALL_BUSY, ALL_OFFLINE, and ALL_DOWN.
2006     * Reduce lock contention by waiting for cm_buf_t I/O operations.
2008     * Split the cm_buf_t flags field to separate the flags that are
2009       protected by the cm_buf_t mutex from those protected by the
2010       buf_globalLock.
2012     * In cm_UpdateVolumeLocation, avoid searching for a ".readonly" volume
2013       on a numeric volume name.
2015     * File buffer allocations whose offsets are beyond server EOF should
2016       be locally allocated and zero filled.  The file server should not be
2017       issued a FetchData rpc which is guaranteed to fail.
2019     * Enable integrated logon to work with Windows 7/2008 when user logons
2020       are performed with a non-Domain Kerberos principal.
2022     * Add Protection Error messages to aklog output.
2024   All UNIX client platforms
2026     * Provide a FUSE-interfacing userspace afs client.
2028     * Updates to libuafs userspace cache manager.
2030     * Probe servers using GetCapabilities instead of GetTime, thus
2031       requiring fewer RPCs.
2033     * Fix DNS SRV record handling for cell lookup.
2035   FreeBSD
2037     * Fix sleep/wakeup routines.
2039     * Update for 8.0 release.
2041   Linux
2043     * Handle high memory addresses correctly.
2045   MacOS
2047     * Make 32 bit AFS syscalls work again.
2049     * Work around finder "Duplicate" failure (caused by setting modes on
2050       symlinks).
2052     * Disable bulkstat again (will be re-enabled at or before .75).
2054     * Provide symlink type hints during readdir.
2057 OpenAFS 1.5.73 (2010-03-24)
2059   All platforms
2061     * NAT keepalive support at Rx level.
2063     * Corrected SRV record support for cell name canonicalization.
2065   All server platforms
2067     * Fix volume callback notification to not notify unaffected clients.
2068       (126497)
2070     * Allow root directory recreation by salvager. (94658)
2072     * Numerous DAFS fixes.
2074     * Improvements to callback table overflow handling. (126451)
2076     * bosserver now shuts down cleanly on SIGTERM.
2078   Microsoft Windows
2080     * Prevent the Explorer Shell extension from crashing if symlink
2081       creation failed.  (126406)
2083     * A Rx level NAT ping has been implemented. A registry value enables.
2085     * Adds krb5 error message translation to aklog, afscreds,
2086       afslogon.dll, the network identity manager afs provider and
2087       translate_et.
2089     * Default mode bit settings for file and directory creation are now
2090       provided, and can be configured.
2092     * An SMB request trace facility is provided and can be enabled for
2093       debugging.
2095   All UNIX client platforms
2097     * Rx idle deadtime does not stop file writes.
2099     * Disconnected AFS no longer has a race condition during remove ops.
2101     * Fakestat avoids a condition which could cause it to block on network
2102       activity.
2104     * Several fixes to handle interruptions in vos operations. (33360,
2105       125535)
2107     * Allow more sysnames in a sysname list.
2109     * Attempt to enforce timeouts on AFSDB lookups.
2111   AIX
2113     * Clean up properly on mount failure.
2115     * Add entry to /etc/vfs to allow umount to work.
2117   Linux
2119     * Several issues to deal with older kernels.
2121     * Avoid leaking the global lock in the /proc cellservdb code.
2123     * Keyring destruction now cleans up all tokens.
2125     * Keyring quotas are not enforced against root.
2127   MacOS
2129     * Some FSEvents hinting for authentication events now done. (23781)
2131     * Update uninstaller. (125634)
2133     * Rewrite afssettings and fstab code to avoid licensing issue with
2134       APSL.
2136     * Growl client for user monitoring of AFS events included.
2138     * Properly support insert-only dropboxes.
2140     * Add bulkstat support.
2142     * Include support for moving in Finder across mount points.
2144     * Preferences Pane includes support for Kerberos 5 ticket renewal.
2147 OpenAFS 1.5.72 (2010-02-15)
2149   All platforms
2151     * Provide internationalization support in com_err.
2153     * Fix array length checking to avoid crashes when checking for a
2154       volume type based on name in vos.
2156   All server platforms
2158     * Provide backward compatible "-f" flag to salvager for force mode.
2160   Microsoft Windows
2162     * Restore use of DNS AFSDB and SRV records by kaserver clients.
2164   All UNIX client platforms
2166     * Fix client cache file truncation to not lose chunks when truncating
2167       a large file.
2169     * Ensure a cache writeback hook is installed in the client (bug from
2170       1.5.71).
2172     * Avoid spurious free memory warnings during clean shutdown.
2174     * Fakestat mode avoids AFSDB lookups.
2176     * "fs storebehind" now correctly reports errors on readonly volumes.
2178     * Additional documentation for "fs getcacheparms"
2180     * Forced new uuid generation with "fs uuid -generate" now works
2181       enforced permission correctly.
2183   MacOS
2185     * Add optimized Rx event handler in kernel.
2187     * Installer now allows installing an older version.
2189     * Panic decoder can now deal with MacOS 10.5 again.
2191     * MacOS ._ files are now correctly not looked up as cellnames.
2193   Linux
2195     * To deal with SELinux file labeling, try cache accesses with current
2196       credentials in event of failure.
2198     * Rx XDR encoding bug on i386 Linux is fixed (bug introduced in
2199       1.5.71).
2201   IRIX
2203     * Code compilation fixes.
2205   OpenBSD
2207     * Update for OpenBSD 4.6.
2210 OpenAFS 1.5.69 (2010-01-19)
2212   All platforms
2214     * Configuration of BOSserver no longer defaults to weekly restarts
2215       enabled.
2217     * Provide BOS restricted mode by default.
2219     * Add support for "vos endtrans" command.
2221     * Default to providing full output from vos listvol.
2223     * Correct additional-address tracking in the fileserver.
2225     * Improve Rx performance by not unnecessarily dropping and reacquiring
2226       call locks in read and write processes.
2228     * Avoid crashes when monitoring volserver transactions across
2229       potential transaction garbage collection.
2231     * Numerous warning fixes.
2233   All server platforms
2235     * Avoid saving fileserver state in demand attach fileserver when
2236       panicing.
2238     * Demand attach fileserver allows other callers to schedule salvages.
2240     * Demand attach "bos salvage" now works correctly with restricted
2241       mode.
2243   Microsoft Windows:
2245     * Numerous changes to the client-internal btree directory handling to
2246       prevent errors.
2248     * fs examine reports owner and group ids as signed values (PTS groups
2249       are negative).
2251     * Preclude corruption due to races writing to smb buffers.
2253     * Allow MTU settings in registry to be used.
2255     * Apply MTU to both send and receive sizes.
2257   All UNIX client platforms
2259     * Avoid double-freeing Rx call structure if reading a response from
2260       the file server results in a short read.
2262     * Handle negative lengths in FetchStatus results correctly.
2264     * Properly clean up allocated memory at shutdown.
2266     * Default to AFSDB compiled into the cache manager.
2268     * Avoid inadvertant disclosure of stat() information to clients not so
2269       entitled.
2271     * Correct a bug with AFSDB lookups introduced with SRV record support.
2273   MacOS
2275     * Install kernel panic processing tool in /Library/OpenAFS/Tools.
2277     * Include debugging symbols for kernel extension in additional package.
2279     * Support "Application Firewall" users.
2281     * Avoid ._cellname AFSDB lookups.
2283     * Compile preferences pane as a universal binary.
2285   Linux
2287     * Use splice to speed up storing files.
2289     * When using memcache, avoid duplicating work in readpages.
2291     * Use dget_parent to safely find an inode's parent.
2293     * Disable access time updates in our superblock.
2295     * Avoid crashing doing writeback if no credentials were stashed at
2296       file open.
2298     * Simplify keyring support.
2300     * Properly clean up vcache in event of failed mount.
2302   FreeBSD
2304     * Update for current FreeBSD 8.
2306   Solaris
2308     * Abstractly manipulate groups as now required.
2310     * Abstractly access time instead of using lbolt directly.
2313 OpenAFS 1.5.68 (2009-12-08)
2315   All platforms
2317     * aklog now attempts to convert non-AFS errors to human-readable
2318       strings.
2320     * Make stack not executable when compiling assembler source with GCC.
2322     * Numerous source warning cleanups and code reorganization.
2324   All server platforms
2326     * Compute midnight for volume statistics calculation from local time.
2328     * Salvager now orphans duplicate special inodes when running to allow
2329       recovery in event of a problem, instead of simply ignoring the
2330       issue.
2332     * Support to ensure a server panic attempt leaves a core and thus
2333       restarts in a timely manner, rather than potentially hanging. Use
2334       panic to attempt cleanup before leaving a core when possible.
2336     * Volume sync data reported during bulkstatus is now set correctly.
2338     * Provide better tuning for fileserver file descriptor caching.
2340     * Allow more than 128 threads in fileserver by modifying host
2341       structure in-use tracking.
2343     * Avoid crashes getting volume server status during transaction
2344       cleanup.
2346     * Improved logging of offline volume conditions.
2348     * Correct volume statistics when cloning a volume.
2350     * Avoid referencing host structures in the fileserver which are marked
2351       for deletion.
2353     * Demand attach fileserver corrections to avoid coring during an
2354       aborted startup.
2356     * host array bounds checking corrections to avoid buffer overflow.
2358     * Handle special inodes correctly when promoting an inode fileserver
2359       readonly volume to read-write.
2361   Microsoft Windows
2363     * Set the DOS Readonly attribute on a file/directory whenever the unix
2364       mode combined with the mask 0200 is true.  Previously there was a
2365       discrepency between the mask used for testing for readonly behavior
2366       and that used for setting the attribute.
2368     * Disable AFSVolSync based .readonly "whole-volume callback" support
2369       because the all file servers prior to 1.5.67 (and perhaps 1.4.12) do
2370       not properly assign a value to the AFSVolSync structure in bulk
2371       status RPC responses.
2373     * Improve the error output from aklog to output the value from krb5
2374       error_message() if the afs_com_err output indicates an unknown
2375       value.
2377     * Convert VBUSY and VRESTARTING to CM_ERROR_ALLBUSY and do not permit
2378       them to be exposed to the smb redirector.
2380     * Convert STATUS_TIMEOUT responses to STATUS_IO_TIMEOUT to avoid
2381       confusion within the smb redirector.
2383     * Fix the byte order assigned to port numbers associated with AFSDB
2384       record lookups.  They must be network byte order not host byte
2385       order.
2387     * Add dynamic server ranking based on RPC round trip time
2388       measurements.
2390   All UNIX client platforms
2392     * Additional shutdown-time memory leaks removed.
2394     * Improved logging of resource contention.
2396     * Provide dumping for Rx debug packet tracking support in source.
2398     * Update afscp test client to build, and provide an unlock client.
2400     * Client buffers for directory parsing can now be allocated beyond the
2401       fixed set formerly provided.
2403     * Work around race condition when manipulating read-only volume
2404       callbacks.
2406     * Bugfixes to get PAG value pioctl.
2408     * Bugfixes to SRV record support.
2410   Linux
2412     * Path MTU tracking code cleanup.
2414     * Avoid an oops due to racing with vcache recycling thread.
2416     * Changes to keyring PAG handling: for sufficiently new kernels, use
2417       only keyring-based PAGs, and disable group PAGs entirely.
2419     * Updates to the kernel page cache interface: writing pages will now
2420       not spuriously leak page locks, and will avoid requiring duplicate
2421       work.
2423     * Credential references are now tracked using native atomic counters.
2425     * Kernel mutex/semaphore lock ordering fix to avoid deadlocks.
2427     * Manipulate disk cache with credentials used to initialize it, to
2428       avoid security issues.
2430   MacOS
2432     * Fix fstrace message catalog location.
2434     * Fix kernel fstrace logging.
2437 OpenAFS 1.5.66 (2009-10-25)
2439   All platforms
2441     * Avoid calling exit() in library code.
2443     * Add rx window size and peer timeout tuning APIs.
2445     * Correct rx peer timeout handling to disallow 0ms timeouts.
2447     * Correct calculation of rx RTT by disregarding retransmitted packets.
2449     * vos manpages updated to reflect changes in recent versions.
2451     * GNU-style long options (e.g. --cell) are now supported in all
2452       commands.
2454     * fs listacl can now print a command to recreate the current ACL.
2456   All server platforms
2458     * Fix a race on transaction objects in the volserver which can cause a
2459       crash.
2461     * Avoid destroying and setting to NULL the callback connection when it
2462       could still be being used.
2464     * Correct unlink handling in salvager.
2466     * Improve error messages due to I/O errors in the volserver.
2468     * Correct an issue which caused converted RO to RW volumes on namei
2469       fileservers to not come online immediately.
2471   Microsoft Windows
2473     * Official support for Windows 7 and Server 2008 R2.
2475     * Prevent a file server bug (FetchData returning an invalid length
2476       instead of zero) from causing an "unexpected network error" when
2477       writing to files.
2479     * Promote DNS SRV records as superior to DNS AFSDB records.  Support
2480       arbitrary port numbers for vldb servers.
2482     * Add AFSVolSync based .readonly "whole-volume callback" support.
2483       With this functionality, multiple objects from a .readonly volume
2484       can have their status validated by issuing a single
2485       RXAFS_FetchStatus RPC.
2487     * Remove drive mapping functionality and service start/stop from
2488       afscreds.exe.
2490     * Remove drive mapping functionality from afs_config.exe.
2492     * Use {HKLM,HKCU}\SOFTWARE\OpenAFS\Client DWORD "ShowMountTab" to
2493       restore access to drive mapping functionality in afscreds.exe and
2494       afs_config.exe.
2496     * Adjust SMB error return codes to avoid returning STATUS_TIMEOUT
2497       which results in the SMB redirector disconnecting.
2499     * Network Identity Manager OpenAFS Provider now provides its own "AFS
2500       lock" notification icon to report the status of "have tokens, have
2501       no tokens, service not started, service started but inaccessible".
2502       Hovering over the icon lists the cells for which tokens exist (if
2503       any) and the OpenAFS version number.  Double-clicking executes the
2504       Network Identity Manager default action.
2506     * Prevent pioctl calls from retrying indefinitely when a sharing
2507       violation error occurs.
2509   All UNIX client platforms
2511     * Correct a condition which could discard the error from initializing
2512       a fetch request.
2514     * Avoid using invalid references to afs_Conn connection structures,
2515       and thus potentially producing invalid data when a retry is needed.
2517     * SRV records are now supported for discovering AFS servers.
2519   Linux
2521     * Correct writepage behavior.
2523     * Fix error code handling in the writepage code.
2525     * Avoid leaking page locks, which could potentially hang a machine.
2527   MacOS X
2529     * Preferences Pane improvements.
2531   HP-UX
2533     * Avoiding attempting to handle critical signals in servers, so that
2534       core file handling works correctly.
2537 OpenAFS 1.5.65 (2009-10-06)
2539   All platforms
2541     * Code compilation warning fixes, to enable better finding and
2542       tracking bugs.
2544     * Provide configure-time switch to enable code warning compilation.
2546   All server platforms
2548     * Demand-attach fileserver now makes volume LRU list operations
2549       exclusive operations to avoid races during adding to the list.
2551     * Fileservers now avoid potential "negative length" fetches.
2553     * A leak in host tracking objects in the fileserver has been fixed.
2555     * Salvager now unlinks all files by full path, to deal with the change
2556       to not chdir for core file tracking.
2558     * Salvager avoids asserting if the volume header is unreadable.
2560     * Demand-attach fileserver puts back volume references from fssync
2561       handlers when done.
2563   Microsoft Windows
2565     * Improved service response to suspend and shutdown event
2566       notifications.
2568     * Avoid a bug in the file server that can result in an invalid length
2569       being returned as part of a fetch data response if the client
2570       attempts to read beyond the length of the file.
2572     * Do not publish a default stream object for directories and mount
2573       point objects.  This was impacting the ability of some Windows XP
2574       systems to save roaming profiles.
2576   All UNIX client platforms
2578     * A bug which could cause erroneous handling of lengths on data reads
2579       has been fixed.
2581     * A bug where erroneous length returns from the fileserver could
2582       result in a false error has been fixed.
2584   Linux
2586     * Background page copies are now supported for enhanced disk cache
2587       read performance.
2589     * Blocking readahead is supported in readpages() to reduce overhead.
2591     * Use readpage() instead of read() to access cache data to avail disk
2592       cache users of the kernel backing cache for improved performance.
2594     * Minimize credential handling for improved performance.
2596   MacOS X
2598     * Preferences Pane cleanup.
2600   Solaris
2602     * Provide a fs_pathconf method with sensible defaults.
2604     * Provide a _PC_FILESIZEBITS method to fix some NFS translator
2605       consumers.
2608 OpenAFS 1.5.64 (2009-09-22)
2610   All server platforms
2612     * The demand attach fileserver now puts back volume references gotten
2613       via the fssync interface.
2615     * The demand attach fileserver had a structure reference error, which
2616       has been correected.
2618   Microsoft Windows
2620     * Restores Windows 2000 compatibility.
2622     * Fixes a data consistency error between the output of NetWkstaGetInfo
2623       and NetServerGetInfo RPCs, specify the Lan workstation group name
2624       "AFS", and report server name as "AFS" instead of "\\AFS" when the
2625       caller asks for "\\AFS".
2627     * Enables executables to be run from \\AFS on Windows 7.  Returns
2628       "Name not found" instead of "File not found" when a directory or
2629       file name cannot be found.  This avoids loader errors when system
2630       dlls cannot be located in the executable directory.
2632     * Prevents cache manager from marking the file server "down" when the
2633       data returned in response to either RXAFS_FetchData64 or
2634       RXAFS_StoreData64 is invalid.
2636     * Adds pioctl data validation to the AFS Explorer Shell extension.
2638   All UNIX client platforms
2640     * A bug which could cause a kernel panic in 1.5.63 has been corrected.
2641       This would manifest as a GetDCache panic or oops.
2643   Linux
2645     * aklog -setpag works again with recent kernels when keyring is in
2646       use.
2648   MacOS
2650     * When Fast User Switch is in use, AFS login is now handled correctly
2651       by the integration tool included with the preferences pane.
2653     * Several packaging bugs have been corrected.
2656 OpenAFS 1.5.63 (2009-09-11)
2658   All platforms
2660     * The restorevol command is now documented and installed as a user
2661       command.
2663     * The uss command now properly translates vldb entries to its expected
2664       format when handling them in all cases.
2666     * Documentation now refers to Kerberos instead of kaserver.
2668   All server platforms
2670     * bosserver now handles BosConfig.new when restarting, allowing
2671       configuration to be replaced at restart time rather than with bos
2672       delete and bos create.  Documentation is updated to reflect this.
2674     * The demand attach fileservice not longer potentially hangs trying to
2675       terminate demand-salvages which have already exited.
2677     * The demand attach fileservice has been modified to avoid spurious
2678       'SYNC_putRes: write failed' warnings when some protocol messages
2679       cannot be acknowledged due to the sender terminating the connection.
2681     * In the event of failure to contact the vlserver or ptserver, the
2682       fileserver will not exit and trigger a forced salvage. It will
2683       continue to try in the background to contact the needed services.
2685     * The salvager can now repair certain cases of a damamged vnode index.
2687     * The accessDate metadata for a volume is now updated correctly.
2689   Microsoft Windows
2691     * CRITICAL: Some applications for example those based on Cygwin were
2692       unable to access data stored in the AFS name space.  Explorer Shell
2693       also experienced inconsistent behavior.  This is fixed.
2695     * CRITICAL: Multiple AFS pioctl requests issued nearly simultaneously
2696       by applications could result in pioctl responses being received by
2697       the wrong requester.  This in turn could result in application
2698       crashes.  symlink.exe, fs.exe, afslogon.dll, afscreds.exe, and the
2699       netidmgr afscred.dll plugin were all affected.
2701     * Some XP machines running 1.5.62 had trouble saving roaming profile
2702       data.  This is fixed.
2704     * Integrated Logon (afslogon.dll) did not function with domain
2705       specific configurations.
2707     * Ensure that access denied and over quota errors experienced while
2708       storing data to the file server do not result in on-going retry
2709       attempts.
2711   All UNIX client platforms
2713     * Except on Solaris and AIX, the compiler may now be overriden at
2714       configure time by setting the CC environment variable.
2716     * afsd now properly deals with large cache partitions.
2718   FreeBSD
2720     * Build shared libafsauthent and libafsrpc.
2722   Linux
2724     * Kernel module DKMS support now installs an unstripped module to
2725       allow debugging information to be collected.
2727   MacOS
2729     * Preferences pane properly updates token information.
2731   MacOS 10.6
2733     * klog will now properly handle passwords of 8 or fewer characters
2734       with an AFS string to key on hosts able to run 64 bit binaries.
2736     * A panic at AFS shutdown due to "NO PCB" on a udp_lock has been
2737       addressed.
2739     * The panic decoder script included in the source now properly handles
2740       32 and 64 bit panics.
2742   NetBSD
2744     * Avoid defining AFS_KERBEROS_ENV globally as it creates a circular
2745       dependency.
2747     * Build shared libafsauthent and libafsrpc.
2749   OpenBSD
2751     * Build shared libafsauthent and libafsrpc.
2754 OpenAFS 1.5.62 (2009-08-28)
2756   All platforms
2758     * Numerous invisible changes to improve code maintainability,
2759       portability and enhanceability.
2761   Microsoft Windows
2763     * CRITICAL: Fixes two errors that can result in data loss when storing
2764       data to the file server.
2765       1. Failure to Store Portions of Unaligned Writes
2766       2. Failure to Store Data to File Servers Lacking Large File Support
2767       Read the announcement for more details:
2768         http://www.openafs.org/pipermail/openafs-announce/2009/000305.html
2770     * CRITICAL: The cache manager daemon thread could terminate when the
2771       machine enters suspend mode.  This daemon thread performs the
2772       background check of down servers, offline volumes, callback
2773       expirations, etc.
2775     * CRITICAL: Integrated Logon (afslogon.dll) was terminating
2776       unexpectedly.  Error checking has been improved and NULL pointer
2777       dereferences after Lsa API calls fail have been eliminated.
2779     * For the first time, the OpenAFS SMB Server supports the DCE RPC
2780       services SRVSVC and WKSSVC.  Browsing \\AFS with the Explorer Shell
2781       or NET VIEW will now be faster and provide additional functionality.
2782       No longer will cell names longer than 12 characters be truncated.
2784     * Improvements to DFS Referral request processing have been
2785       implemented.
2787     * Unnecessary DNS lookups of share names are avoided improving
2788       performance.
2790   All UNIX client platforms
2792     * Non-Kerberos PAM modules work correctly again.
2794   MacOS X
2796     * MacOS 10.6 (Snowleopard) is now supported, both 32 and 64 bit mode.
2798     * Updates to the AFSCommander preferences pane.
2800     * Installer now permits cell names with dashes.
2803 OpenAFS 1.5.61 (2009-08-06)
2805   All platforms
2807     * Correct another race condition in the Rx library that could result
2808       in an unexpected panic while freeing the Rx call iovq.
2810     * rx packet resend and data packets sent counts were incorrect.
2812     * fs setquota, fs setcachesize, vos setfields, and vos create now
2813       accept human readable orders of magnitude. (K, M, G)
2815     * fs listquota fixed to permit large quota sizes to be displayed.
2817     * Correct documentation of bosserver permissions requirements.
2819     * Modify vlserver to avoid potentially corrupting the database through
2820       volume id reuse.
2822     * Generalized support for fast Rx timeout due to network
2823       down/unreachable.
2825   All server platforms
2827     * Allow audit logs to be sent via sys5 IPC message queues instead of
2828       logged directly.
2830   Microsoft Windows
2832     * If a file server becomes inaccessible while the cache manager has
2833       dirty buffers to write, the afsd_service buf_IncrSync thread can
2834       attempt to use 100% of the cpu.
2836     * Fix "fs newcell" which was broken in 1.5.60.
2838     * Do not attempt to synchronize dirty buffers if the associated volume
2839       is known to be unavailable.
2841     * Modify behavior of a Freelance mountpoint target that does not
2842       specify a cell.  Instead of assuming the target volume is in the
2843       Freelance.Local cell, use the workstation "Cell" specified in the
2844       registry. A mountpoint target of "#root.cell." will now mean the
2845       root.cell volume in the workstation cell for the current session.
2846       If the workstation cell changes from "athena.mit.edu" to
2847       "andrew.cmu.edu", the referenced volume will also change without
2848       requiring that the mount point targets be altered.
2850     * Add cm_FindServerByUuid().  Re-implement RXAFS_InitCallBackState3()
2851       to permit the server Uuid to be used to lookup the server object and
2852       from that determine the cell.  This permits callbacks that are
2853       received from alternate addresses to be processed with a known
2854       server object.  Previously a request from an unknown server would
2855       clear all callbacks from all cells.
2857     * Fix a bug that prevented optimal performance when using a non-zero
2858       value for 'daemonCheckVolCBInterval'.  As a reminder, when
2859       "daemonCheckVolCBInterval" is set to a non-zero value, all .readonly
2860       volume callbacks are automatically renewed 90 minutes before their
2861       expiration.
2863     * Fix automatic ranking of vldb servers whose values are obtained from
2864       the CellServDB file.
2866     * Add failover for RX CALL TIMEOUT errors when the volume is readonly
2867       or the call is to a vldb server.
2869     * Add registry based cell search functionality to NetIdMgr,
2870       afs_config.exe, and klog.exe.
2872     * afsconf_GetCellInfo() has been modified to perform gethostbyname()
2873       lookups on the host names in the CellServDB instead of using the
2874       specified IP addresses.  This provides aklog, pts, vos, etc. the
2875       same CellServDB behavior that the Windows Cache Manager uses.
2877     * When updating the stat cache entry callback of a .readonly object
2878       from the volume group object, update the file server reference to
2879       ensure it matches the most update to date callback.
2881     * Add proper support for processing callbacks from multi-homed file
2882       servers.  Instead of comparing servers by cm_server_t pointer,
2883       compare them by UUID when the UUID is known.
2885     * During a shutdown short circuit the offline volume check daemon
2886       functionality.
2888     * Return the error code of RXAFS_FetchData / RXAFS_StoreData in
2889       preference to an error code reported by rx_EndCall.
2891     * Add "PerFileAccessCheck" registry value to permit testing against
2892       experimental file servers that include per-file acl support.  This
2893       value is intentionally undocumented.  It is not to be used by
2894       production environment deployments.
2896     * Fix a bug introduced in 1.5.60 that prevents the afs netidmgr
2897       provider from obtaining tokens when referrals are in play.
2899     * Add "fs chown" and "fs chgrp" commands to permit the owner and group
2900       of objects stored in AFS to be set from Windows.
2902     * Avoid performing background daemon operations when the machine is
2903       going into suspend mode.
2905     * Perform offline volume checks in most recently used order.
2907     * Prevent crash when a data version for a cache object goes backwards.
2909     * Multi-thread safe library versions are now being generated and used.
2910       mtafsubik.lib, mtafsutil.lib, mtafsvldb.lib, mtafsvol.lib.
2912     * Microsoft SMB Redirector (mrxsmb.sys) support for
2913       ExtendedSessTimeout values are now available on XP through Windows
2914       7.  Add functionality to autodetect if such support is present on
2915       the machine.  If so, configure it if necessary and dynamically
2916       adjust the AFS Rx timeout values accordingly.
2918   All UNIX client platforms
2920     * Fix out-of-tree source builds.
2922   MacOS
2924     * GUI installer now asks for local cell information.
2926     * AFS Commander preferences pane is now installed by default.
2928   Solaris
2930     * Avoid kernel panics due to null pointer dereferences in the network
2931       interface poller kernel thread.
2934 OpenAFS 1.5.60 (2009-05-31)
2936   All platforms
2938     * Retry volserver transaction creation on failure.
2940     * Allow building HTML and PDF documentation from included XML copies
2941       of User Guide, Admin Guide and Quick Start Guide for Unix.
2943     * Documentation updates and additional documentation.
2945     * Add -encrypt support to pts client.
2947     * Convert MR-AFS fs commands to OSD commands.
2949   All server platforms
2951     * Updated background sync process in fileserver to avoid a race which
2952       could result in a volume being taken offline.
2954   Microsoft Windows
2956     * On April 9th Microsoft released a Hot Fix for Windows Server 2003
2957       SP2 that corrects a deadlock in the smb redirector and also adds new
2958       functionality that permits the AFS SMB server to be given a longer
2959       timeout than is normally the case.  New functionality has been added
2960       to configure these additional LanmanWorkstation\Parameter values.
2961       (This functionality has been backported to XP SP3 and is scheduled
2962       to be released on June 5th.)
2964     * Fix RT#124787, a race condition between "fs flush <dir>", "fs
2965       flushvolume", or "fs flushall" and on-going directory operations
2966       that can result in afsd_service.exe crashing.
2968     * Release Notes, User and Administrator guides are now shipped as
2969       indexed Windows HtmlHelp Files. (.chm).  Shortcuts are provided from
2970       the Start Menu.
2972     * A method of specifying Client CellServDB information within the
2973       registry has been added that can be used to either override the
2974       CellServDB file or force the use of DNS lookups for a given cell.
2975       See the release notes for details.
2977     * The pioctl interface now properly handles drive letter substitution
2978       to UNC paths.  (SUBST <d:> <\\afs\cell\path>)
2980     * The BackConnectionHostNames registry value configuration was broken
2981       when dynamic re-establishment of Netbios Name registrations was
2982       added.  This release restores the functionality.
2984     * All hidden vos.exe commands are now revealed.
2986     * Attempts to store the same dirty file chunk from multiple threads
2987       are now prevented.
2989     * The IsPathInAfs test in Explorer Shell Extension and fs.exe now
2990       permits broken symlinks to be treated as being in AFS.
2992     * vos.exe commands that output 64-bit integer values once again do so.
2993       This was broken in 1.5.59.
2995     * Cygwin Import Libraries are provided in the SDK for all OpenAFS
2996       DLLs.  This permits building cygwin applications against OpenAFS
2997       libraries.
2999     * NSIS installer does a much better job of cleaning up files left over
3000       from previous installs.
3002     * libafsconf.dll moved from Client\Program to Common directory as is
3003       is now used by all modules for CellServDB processing.
3005   All UNIX client platforms
3007     * Write back changes on last store for memcache to avoid discarding
3008       changes.
3010     * Abstract disk cache support to allow for path, fh, inode based
3011       caches with no need for messy ifdef structures each time a new type
3012       is added.
3014   DragonflyBSD
3016     * Support as a userland port.
3018   FreeBSD
3020     * Corrected structure definition for userspace cache manager to allow
3021       builds to complete.
3023   Linux
3025     * Corrected client locking support.
3027     * Updated patch to stop deadlocking in the kernel during mmap.
3029     * Avoid oops when setting up groups for PAGs to match keyrings.
3031     * Use Linux fh-based cache in cases where possible by default.
3033   MacOS 10.3:
3035     * Corrected structure definition for userspace cache manager to allow
3036       builds to complete.
3038   OpenBSD
3040     * Support for OpenBSD 4.5.
3042   Solaris
3044     * Corrected support for server-side vos split interface.
3047 OpenAFS 1.5.59 (2009-04-06)
3049   Microsoft Windows
3051     * Increased service priority class to "High" to match the priority of
3052       system components that are dependent upon the a timely response.
3054     * SMB error responses avoid returning errors that could confuse the
3055       Microsoft SMB redirector into disconnecting the connection to \\AFS.
3057   All UNIX client platforms (except MacOS X 10.4 and 10.5)
3059     * OpenAFS 1.5.59 contains fixes for the client issues addressed by the
3060       security advisories OPENAFS-SA-2009-001 and OPENAFS-SA-2009-002.
3062   Linux platforms
3064     * Support for prerelease Linux 2.6.30 kernels.
3067 OpenAFS 1.5.58 (2009-03-30)
3069   All platforms
3071     * Code cleanup and prototyping.
3073     * Avoid unnecessary blocking in Rx periodic cleanup code.
3075   All server platforms
3077     * Fileserver CopyOnWrite routine optimized for performance.
3079     * Make fileserver callback dumps 64 bit safe.
3081     * Fix byte order issues with fileserver host hashing.
3083     * Fix buffer size issues with butc.
3085     * Fix several Ubik recovery issues.
3087     * Avoid leaking file references in the fileserver.
3089     * Fix a race in DAFS while closing vnodes, and another offlining
3090       volumes.
3092     * volserver interfaces for volume splitting client.
3094   Microsoft Windows
3096     * [RT 124293] A race condition exists which can result in a crash.
3098     * [RT 124276] If the vldb is out of sync with the contents of the file
3099       servers, afsd_service will retry too many times when a file server
3100       reports a volume as not being present.  Now if the list reported by
3101       the vldb is the same as the previously seen list, then the retry is
3102       aborted.
3104     * [RT 124276] Read-only volume failover was broken in 1.5.53 whenever
3105       accessing a volume results in VNOVOL or VMOVED.
3107     * [RT 124276] Prior to 1.3.70 the volume server reference list was not
3108       reference counted and would be prematurely freed while in use.  When
3109       reference counting was added in 1.3.70 a bug was introduced that
3110       could result in service reference list corruption.
3112     * Add Windows Application Event Log warning messages for "Client SMB
3113       MPX value too large" and "Client SMB Buffer Size too small".
3115     * Renaming of files across directory boundaries would result in an
3116       invalid handle error when attempting to access the files after the
3117       move.
3119     * Fix the handling of Tran2 Set Path Info RPCs.  Do not fail when a
3120       smb file descriptor cannot be found.  The whole point of using a
3121       Path Info function is because an smb file descriptor wasn't
3122       allocated.
3124     * More edge cases in which dynamic addition of Freelance root.afs
3125       entries would get the wrong FID or where the root.afs directory
3126       would not be refreshed.
3128     * Buffer overflow could occur if the workstation cell name was longer
3129       than 64 characters.  Crashes could occur in afscreds.exe,
3130       afslogon.dll, and afsd_service.exe.
3132     * VNOSERVICE and VOFFLINE errors were leaking and were exposed to the
3133       smb client.
3135     * Log file server uuid values as part of the cm_server object when
3136       available.  Dump the cm_server object list in response to "fs
3137       memdump".
3139     * Optimize the performance of resetting access control lists when
3140       tokens are set or removed.
3142     * Remove symlink recursion tests and increase max symlink count to 64
3143       from 16.
3145     * Windows specific Rx performance improvements.
3147     * Support for Network Identity Manager 2.0
3149   All UNIX client platforms
3151     * Avoid issues with freeing resources at shutdown.
3153     * Numerous fixes to disconnected AFS.
3155     * Disconnected AFS fixes for replaying changes without double-freeing.
3157     * Attempt to use krb524 principal conversion in aklog if available.
3159   AIX
3161     * Kerberos configuration at build time corrected.
3163   Linux
3165     * Default to dynamic allocation of AFS kernel cache entries to allow
3166       growth for inotify()-pinned entries. (beagle, famd, etc)
3168     * Change client truncation routines to avoid locking issues.
3170     * IA64 port clients fixed on Linux 2.6.
3172     * RPMs now install fstrace message catalog.
3174     * Support through kernel 2.6.29 tested.
3176     * Fix locking issues on CellServDB file in /proc.
3178   OpenBSD
3180     * Support OpenBSD 4.4
3183 OpenAFS 1.5.57 (2009-01-23)
3185   All platforms
3187     * Conditional compilation of rxdebug support is now possible.
3189     * Documentation updates.
3191     * Further race connditions in Rx have been corrected.
3193   All server platforms
3195     * Salvager no longer attempts to recreate headers in the wrong
3196       partition.
3198     * Volumes are properly marked in use on creation and subsequently on
3199       examination with vos.
3201   Microsoft Windows
3203     * Undo the "UAC manifest fix" applied to afs_config.exe.
3205     * Ensure that Freelance allocation of vnodes follow the AFS convention
3206       of odd vnodes are directories and everything else is an even vnode.
3208     * Add Freelance logic to mount point and symlink evaluation functions.
3210     * Enhance smb_ParseASCIIBlock() so that it can handle all of the
3211       STRING formats defined by the CIFS Technical Report 1.0.
3213     * Validate the output of smb_ParseASCIIBlock() in all callers.  Return
3214       CM_ERROR_BADSMB if the STRING field cannot be parsed.
3215       CM_ERROR_BADSMB will cause the contents of the packet to be logged.
3217     * If multiple SMB Raw Write operations were taking place at the same
3218       time, there could be data corruption because unique event objects
3219       were not generated for each Netbios receive operation.
3221   All UNIX client platforms
3223     * Userspace AFS library can now deal with large files when supported
3224       by the platform.
3226     * Numerous updates to disconnected AFS support, including changes to
3227       allow reconnection to work in more circumstances.
3229   FreeBSD
3231     * FreeBSD unstrategy code has been updated.
3233   Linux
3235     * A race during file truncation has been corrected.
3237     * System call probing routines have been updated.
3239     * 2.6.29 is now supported.
3241   MacOS
3243     * 10.3 support has been corrected.
3245   OpenBSD
3247     * Initial OpenBSD 4.4 support.
3249   Solaris
3251     * Updates to allow compiling on newer OpenSolaris are now included.
3254 OpenAFS 1.5.56 (2008-12-30)
3256   All platforms
3258     * libuafs (userspace cache manager) updated to correct several errors.
3260     * Additional rx debugging support is available as a conditional
3261       compile.
3263     * A race condition in Rx leading to a panic has been corrected.
3265     * Rx idle time tracking has been corrected.
3267     * ubik clone server support has been corrected.
3269   All server platforms
3271     * Salvager no longer leaves cores in vice partitions.
3273     * The vol-dump tool now supports dumps larger than 2gb where possible.
3275     * Operations on multiple files now report all FIDs in the audit log.
3277     * butc XBSA support now works correctly on amd64.
3279   Microsoft Windows
3281     * The NetIDMgr AFS Provider automated configuration logic was broken
3282       by the introduction of Kerberos referrals.  If the realm of the
3283       identity cannot be determined, the workstation cell is now assumed
3284       to belong to the newly created identity.
3286     * Avoid a reference count under flow during rename operations.
3288     * Avoid a crash caused by treating an arbitrary length directory
3289       search mask as an 8.3 mask.
3291     * Prevent rename operations if a case insensitive match for the target
3292       name already exists and does not refer to the object being renamed.
3294     * Increase the maximum number of background daemons to 64.
3296     * Fix the UAC manifest applied to afs_config.exe
3298   All UNIX client platforms
3300     * Updates to disconnected AFS support.
3302   FreeBSD
3304     * FreeBSD 7.1 is now supported.
3306     * amd64 FreeBSD is now supported.
3308   Linux
3310     * Generic fh (exportfs API) cache type is now available.
3312     * Avoid some oopses due to backing_dev_info inode fields not being
3313       filled.
3315     * 2.6.28 is now supported.
3317   MacOS
3319     * 10.3 support has been corrected.
3321   Solaris
3323     * Large partition support has been corrected.
3325     * Filesystem-agnostic cache is now available on Solaris 10 and 11.
3328 OpenAFS 1.5.55 (2009-11-10)
3330   All platforms
3332     * Salvager avoids leaving core files in vice partitions.
3334     * NFS translator fixes.
3336     * Unresponsive server handling fixes.
3338     * A volserver race which could result in duplicate transactions is
3339       fixed.
3341   Microsoft Windows
3343     * Fixes a panic caused by corruption of the SMB virtual circuit list.
3344       (race condition)
3346     * Fixes a panic caused by receipt of a UTF-16 string that cannot be
3347       converted to UTF-8.
3349     * Implements a more aggressive recovery algorithm for Netbios errors
3350       that result in loss of communication to the AFS SMB server.
3352     * Improve pioctl response time when testing whether or not a PATH is
3353       in AFS.
3355     * Adds support for linked cells.
3357     * Increases the length of the cell and realm names that can be input
3358       into the Network Identity Manage AFS provider configuration dialog.
3360   All UNIX client platforms
3362     * Disconnected AFS avoids infinite recursion during rmdir.
3364   Linux
3366     * Support for 2.6.28 (not complete for NFS translator modules).
3368     * Support for using exportfs API for filesystem-agnostic cache.
3370     * Disable backing store readahead.
3372     * Avoid deadlocks when writing back mmapped files larger than the
3373       cache.
3375     * Avoid Oops when doing PAG garbage collection.
3378 OpenAFS 1.5.54 (2008-10-08)
3380   All platforms
3382     * Updates for new Tivoli X/Open API finding.
3384     * A double-free is corrected in Rx.
3386   All server platforms
3388     * Ubik cleans up file descriptor cache correctly when doing recovery.
3390     * Enhanced vldb error checker included.
3392   Microsoft Windows
3394     * Prevent a crash that could occur when multiple file / directory
3395       change notifications are processed simultaneously.
3397   MacOS
3399     * AFS claims more free space so Finder will attempt file copies.
3401   Linux
3403     * Avoid spurious ENOENT when calling gwtcwd() on a volume root.
3405     * Avoid spurious ENOTDIR during fakestat.
3408 OpenAFS 1.5.53 (2008-09-26)
3410   All platforms
3412     * rx avoids many packet leaks.
3414     * rx jumbogram disabling now works (and is the default).
3416   All server platforms
3418     * Demand Attach fileserver tries to avoid issues tracking offline
3419       status of volumes.
3421   Microsoft Windows
3423     * Many potential deadlock conditions due to out of order lock
3424       acquisitions have been corrected.
3426     * A race condition resulting in an undercount on the cm_scache_t
3427       reference counts has been corrected.
3429     * An empty string when sent as an ioctl path is now properly
3430       interpreted as meaning the current directory.  This affects "fs
3431       lsm", "symlink list", etc.
3433     * Fix smb string parsing differences where the smb protocol
3434       documentation does not match the actual Windows implementation.
3436     * Random access denied errors fixed.
3438     * A file server lock synchronization issue was corrected in SMB
3439       NTCreateX and NTTranCreate operations.  This bug prevented properly
3440       operation when loading roaming profiles.
3442     * Fix a heap overwrite error during server probe operations if a new
3443       server is added while a probe operation is in progress.
3445     * Fix an LSA memory leak that was the result of an LSA error.
3447     * Do not leak cm_cell_t objects if the VLDB server lookup fails.
3449     * Only initialize rx mutex/lock objects once.
3451     * Do not nul terminate the AFS volume name when reported to Windows.
3453     * Improve VNOVOL error handling.  Prevent updated vl information from
3454       being destroyed immediately after it was acquired.  This bug
3455       prevented proper fail over when volumes are moved or removed from a
3456       server.
3458     * Remove volume id from the server volume list in response to VMOVED
3459       and VNOVOL errors.
3461     * "fs flushXXX" commands now destroy locally built B+ directory trees.
3463     * Prevent mixture of locally modified directory pages and file server
3464       directory pages.
3466     * Fail over to alternate vl servers if a ubik error is returned.
3468   All UNIX client platforms
3470     * Disconnected AFS now supports read-write mode.
3472     * volserver now builds correctly.
3474   AIX
3476     * AIX 6 is now supported.
3478   FreeBSD
3480     * FreeBSD 7 is now supported.
3482   Linux
3484     * cache bypass is now supported.
3486     * 2.6.x kmod compilation now uses kernel compile options always.
3488     * Support through 2.6.27.
3490   MacOS
3492     * Show more space free so Finder doesn't get confused.
3494   Solaris 10
3496     * Default to namei rather than inode.
3499 OpenAFS 1.5.52 (2008-08-18)
3501   All platforms
3503     * Initialize volume updateDate at volume creation.
3505     * Avoid potential corruption of directories during salvage.
3507     * Check for out of memory condition during allocation of additional Rx
3508       packets.
3510   Microsoft Windows
3512     * Restore support for Windows 2000 (broken in 1.5.50).
3514     * Perform additional validation on volume names in mount points during
3515       creation and evaluation.
3517     * Fix several deadlocks, races, and reference count issues.
3519     * Further optimize SMB Directory Search processing and minimize the
3520       number of InlineBulkStatus RPCs sent to the file server.
3522     * Enable "bos restricted" operations.
3524     * Fix the create of submounts used by the AFSCreds and afs_config
3525       drive mapping tabs.
3527     * Fix a short name truncation bug. (1.5.50)
3529     * Fix the error code reported when attempting to delete a file on a
3530       readonly volume or one that is marked with the readonly DOS
3531       attribute.
3533     * Fix a heap corruption error when reading the CellServDB file
3534       location.
3536     * Add the "RxUdpBufSize" registry value.  The new default is 256KB.
3538     * Do not include trailing NULs in the directory search output.
3539       (1.5.50)
3541     * Pre-allocate 64 Rx Packet buffers per thread in order to improve
3542       performance.
3544     * For debugging: add smb lock requests and stat cache lock allocations
3545       to the output from "fs memdump".
3547   NetBSD
3549     * Workaround broken sigwait() to allow fileserver to shut down
3550       correctly pre NetBSD 5.0.
3552   Solaris 10
3554     * Default to namei fileserver; Allow inode fileserver at configure
3555       time by override.
3557   NFS translator
3559     * Try harder to avoid kernel panics for malformed requests.
3562 OpenAFS 1.5.51 (2008-07-29)
3564   All platforms
3566     * salvager tries harder to arrange for clients to get VBUSY while
3567       salvaging single volumes.
3569     * salvager avoids certain corruption when salvaging directories.
3571     * Rx connection clones disabled.
3573   Microsoft Windows
3575     * The 32-bit EXE 1.5.50 installer failed to properly install the C
3576       Runtime library.  When used as an upgrade OpenAFS would continue to
3577       work but when used as a new installation, OpenAFS binaries would
3578       fail to load.
3580     * Fixes the "fs" and "symlink" commands to properly parse Unicode path
3581       prefixes during the pioctl remote procedure call.  This bug would
3582       result in file not found errors for files and directories that
3583       clearly exist.  (Bug introduced in 1.5.50)
3585     * Large File support is disabled. (Bug introduced in 1.5.50)
3587     * Removes the possibility of a deadlock during volume location update
3588       operation if all of the reported file servers are unreachable at the
3589       time of the update.
3591     * Ensures that reference counts are properly incremented/decremented
3592       on Rx connection objects used for volume location RPCs.
3594     * Over Quota errors during cm_FSync() calls would lead to an infinite
3595       loop as the error was never propagated to the caller.
3597   All UNIX client platforms
3599     * Bugfixes to disconnected AFS support in the cache manager.
3602 OpenAFS 1.5.50 (2008-07-16)
3604   All platforms
3606     * volserver puts recloned volumes back online before returning the
3607       volume to the fileserver, avoiding spurious VNOVOL errors.
3609     * Updated TSM X/Open API support available.
3611     * Demand Attach fileserver will not crash due to accesses during
3612       volume cloning.
3614     * Substantial documentation updates.
3616     * Demand Attach fileserver state tracking and analyzer tool
3617       improvements.
3619     * UAFS userspace cachemanager updates.
3621     * Corrected support for anti-meltdown protection in the client.
3623   Microsoft Windows
3625     * UNICODE Character Set Support.
3627     * Pioctl interfaces to the cache manager have been refactored to
3628       provide layering between the SMB specific code and the general
3629       purpose ioctl operation.
3631     * Garbage collect dead SMB virtual circuits as soon as they are no
3632       longer being referenced.  This avoids problems with outstanding
3633       locks not being dropped when the virtual circuit becomes invalid.
3635     * Remove the IBM Administration Reference documentation and replace it
3636       with the OpenAFS Command Reference Manual.
3638     * Avoid calling rx_SetDeadTime and rx_SetHardDeadTime functions each
3639       time a connection is about to be used.  Do not hold a lock on the rx
3640       connection object while it is being selected.  This avoids a race
3641       between threads attempting to set the timeout values and removes a
3642       bottleneck that was hampering performance.
3644     * Ensure that the smb directory attribute is set for all directory
3645       objects.
3647     * Replace the VC Runtime EXE installer with the MSI installer in the
3648       NSIS installer scripts.
3650   Solaris
3652     * Support for updates to OpenSolaris.
3654   Linux
3656     * Correct dentry revalidation for cross-directory renames.
3658     * Updated rpm packaging materials for 1.5 release series and 2.4
3659       kernels.
3661     * Corrected syscall table probing.
3663     * NFS translator updates for current kernels.
3666 OpenAFS 1.5.39 (2008-06-24)
3668   All platforms
3670     * Updates for Demand Attach fileserver.
3672   Microsoft Windows
3674     * Fix two memory leaks.
3676     * Fix one missing lock.
3678     * Handle access denied errors when writing dirty buffers.
3680     * Fix two errors that would cause the *experimental* AFS Servers
3681       to crash.
3684 OpenAFS 1.5.38 (2008-05-24)
3686   All platforms
3688     * Add read-only disconnected support.
3691 OpenAFS 1.5.37 (2008-05-21)
3693   All platforms
3695     * Includes a number of optimizations for testing.
3698 OpenAFS 1.5.36 (2008-05-09)
3700   All platforms
3702     * Rx optimizations now attempt to deal with high latency WANs.
3704     * Client will not wait infinitely for a server which is not providing
3705       data.  Additional servers will be polled without marking the server
3706       which is not providing data down.
3708     * vos move will not erroneously unlock locked vldb entries on failure.
3710   All server platforms
3712     * Fileserver avoids a potential infinite loop when a client
3713       relinquishes an address.
3715     * Fileserver large setting now configures more threads.
3717     * Fileserver properly registers uuids of new clients.
3719     * Ubik servers do not improperly hide updates from clients.
3721     * Fileservers reserve enough file descriptors such that each thread
3722       can cache one to avoid spurious errors.
3724   Microsoft Windows
3726     * Fix a cm_buf_t reference count leak when attempts to write dirty
3727       buffers to the file server from within cm_IncrSyncer() fail.
3729     * Prevent udebug from crashing.
3731     * Another VNOVNODE issue fixed.  When writing a dirty buffer to the
3732       file server, if VNOVNODE is received, mark all buffers as invalid
3733       without further attempts to contact the file server.
3736 =======> Changes back to 1.3 have not yet been incorporated here <=======
3739 OpenAFS 1.3
3741   * -nosettime is now the default for afsd.  Use "-settime" to get the
3742     old behavior.
3744   * OpenBSD is now supported.
3746   * Mountpoint directory information is now only faked for cross-cell
3747     mountpoints when using the -fakestat flag (e.g. for the directories
3748     under /afs, but not for most other volumes mounted inside the cell).
3749     The -fakestat-all switch can be used to fake information for all
3750     mountpoints.
3752   * When fakestat is enabled on MacOSX, the Finder can be used to browse
3753     a fully-populated /afs directory.  However, this precludes reliable
3754     use of entire volumes as MacOS bundles (i.e. containing a Contents
3755     directory in the root of the volume).
3757   * Mountpoint directory information can be faked by the cache manager,
3758     making operations such as stat'ing all cells under /afs much faster.
3759     This is enabled by passing -fakestat to afsd, but might not be stable
3760     on all platforms.
3763 OpenAFS 1.2.9
3765   * The kaserver now defaults to not allowing interrealm authentication,
3766     due to security vulnerabilities in the krb4 protocol.  The new
3767     "-crossrealm" flag to the kaserver is provided to reenable interrealm
3768     authentication if desired.
3770   * RedHat Linux 9.0 is now supported.
3772   * Solaris 9 12/02 is now supported.  Solaris 7 and 8 x86 should now
3773     work again.
3775   * On Linux machines using 2.2 series kernels, 2.2.19 or higher is now
3776     required.
3778   * An OpenAFS 1.2.9 afsd will not work with kernel modules built from
3779     an earlier OpenAFS release.  In general, using a mismatched afsd and
3780     kernel modules set is unsupported; it is not recommended that you use
3781     such a configuration on a regular basis.
3784 OpenAFS 1.2.8
3786   * Mountpoint directory information is now only faked for cross-cell
3787     mountpoits when using the -fakestat flag (e.g. for the directories
3788     under /afs, but not for most other volumes mounted inside the cell).
3789     The -fakestat-all switch can be used to fake information for all
3790     mountpoints.
3792   * HPUX 11.0 is now supported.
3794   * It is now possible for AFS to use Kerberos 5 directly, via rxkad 2b.
3795     See the OpenAFS 1.2.8 Release Notes for more information on using this
3796     capability.
3798   * An NFS translator kernel module is now included and compiled by
3799     default for Solaris only.
3802 OpenAFS 1.2.7
3804   * MacOS X 10.2 is now supported.  FreeBSD 4.3 and later support is
3805     included in this release, but is still under active development and
3806     should only be used by those doing active development on the OpenAFS
3807     FreeBSD client.
3809   * When fakestat is enabled on MacOSX, the Finder can be used to browse a
3810     fully-populated /afs directory.  However, this precludes reliable use
3811     of entire volumes as MacOS bundles (i.e. containing a Contents
3812     directory in the root of the volume).
3814   * The fileserver will now use Rx pings to determine if clients are
3815     reachable prior to allocating resources to them, to prevent asymmetric
3816     clients from consuming all fileserver resources.
3819 OpenAFS 1.2.6
3821   * Mountpoint directory information can be faked by the cache manager,
3822     making operations such as stat'ing all cells under /afs much faster.
3823     This is enabled by passing -fakestat to afsd.
3825   * Solaris 9 FCS and Solaris 7 and 8 x86 are now supported.
3828 OpenAFS 1.2.5
3830   * A remote denial of service attack in the AIX and IRIX clients has been
3831     fixed.  Users of those platforms are strongly encouraged to upgrade.
3833   * Fixed race conditions in fileserver that could result in crash.
3836 OpenAFS 1.2.4
3838   * Server logfiles now more consistant about format in which hosts are
3839     referred to.
3841   * vfsck on Solaris will now allow force runs (using -y flag) even if old
3842     inodes exist.
3845 OpenAFS 1.2.3
3847   * Cell aliases for dynroot can be specified in the CellAlias file in
3848     /usr/vice/etc or /usr/local/etc/openafs, in format "realname alias",
3849     one per line.  They can also be managed at runtime with "fs newalias"
3850     and "fs listaliases".
3853 OpenAFS 1.2.2
3855   * Solaris 9 and Linux PA-RISC are now supported.
3857   * fileserver will not erroneously delay legitimate errors for 3 seconds
3858     after 10 errors are returned (e.g. stat() on a directory you can't
3859     read).
3861   * Rx MTU calculation now works for Irix, Solaris and Linux
3863   * If afsd is started with the -dynroot flag, /afs will be locally
3864     generated from the CellServDB.  AFSDB cells will be mounted
3865     automatically upon access.
3867   * The namei fileserver allows vice "partitions" to be directories
3868     instead of partitions and will attach and display accordingly.
3869     Creating the file "AlwaysAttach" in the /vicepX directory is used as
3870     the trigger to attach it.
3872   * TSM support for butc no longer requires editing a Makefile, simply
3873     specify the --enable-tivoli-tsm configure option.
3875   * Linux builds no longer require source changes every time the kernel
3876     inode structure changes; the OpenAFS sources will now configure itself
3877     to the actual inode structure as defined in the kernel sources.
3880 OpenAFS 1.2.1
3882   * vfsck on Digital UNIX and Solaris will now refuse to fsck mounted
3883     mounted partitions.
3886 OpenAFS 1.2.0
3888   * AFS now supports --prefix and the other directory options of
3889     configure.  By default AFS builds assuming it will be installed in
3890     /usr/local.  In order to get traditional AFS directory paths (/usr/afs
3891     and /usr/vice/etc) use the --enable-transarc-paths option to
3892     configure.  More details on the new directory layout are found in
3893     README.
3896 OpenAFS 1.1.1a
3898   * Windows 95/98/ME/NT/2000 - Consistent versioning:  Installation, AFS
3899     Control Center, Client dialog boxes and properties pages for
3900     executables display a consistent OpenAFS version number.  Installation
3901     detects previous installation and prompts the user for upgrade
3902     options.
3904   * Windows 95/98/ME/NT/2000 - Installation features:  During installation
3905     the user can select the source of the CellservDB file, AFS home cell,
3906     and drive mappings.  During installation a drive path mapping can
3907     include a variable that will be substituted with the current UserName
3908     that is logged in.
3910   * Windows 2000/NT - Integrated logon:  The Integrated Logon feature
3911     works now.
3913   * Windows 95/98/ME - Logon script features:  The Windows 95/98/ME client
3914     now offers a command-line option for starting up the AFS client
3915     without authenication. It is now possilbe to start the AFS client
3916     first and obtain tokens, and map drives all through Windows scripts.
3917     This helps using Windows 95/98/ME client in Kerberos 5 environment.
3919   * Windows 2000/NT - LANA numbers:  AFS client now scans the LANA numbers
3920     to establish the correct NETBIOS connection.  NetBEUI is no longer
3921     needed.  The user no longer needs to find the correct LANA number.
3923   * Windows 2000/NT - OpenAFS naming consistancy:  Further progress has
3924     been made to remove references to "Transarc AFS" and replace with
3925     "OpenAFS".
3928 OpenAFS 1.0
3930   * AFS now builds with configure. The README for building has been
3931     updated and includes full details.
3933   * A client system can now have multiple sysname values for @sys.  They
3934     will be searched in order when looking up files in AFS.  The
3935     -newsysname argument to fs sysname can be repeated to set multiple
3936     sysnames.
3938   * A new system group is created for new cells (system:ptsviewers with id
3939     -203).  If this group exists, members of this group can examine and
3940     read the entire protection database.  They can examine all users and
3941     groups and can get the membership of any group.
3943   * A new program, pt_util has been added to the distribution.  This
3944     program allows users to print the contents of the protection database
3945     or to edit the protection database without running a ptserver.  It can
3946     be used to set up a new cell without ever running in noauth mode.  Run
3947     pt_util -h for help.
3949   * The fs setcrypt and fs getcrypt commands have been added.  These
3950     commands allow the system administrator to require that the client
3951     encrypt all authenticated traffic between the client workstation and
3952     AFS.  The encryption used is weak, but is likely better than sending
3953     unencrypted traffic in most environments.  Some functions, such as
3954     looking for a volume may not be encrypted, but data transfer certainly
3955     is.  By default data is not encrypted.  At this time no significant
3956     experimentation with server performance has been conducted.
3958   * By default AFS is compiled with AFS_AFSDB_ENV, enabling the -afsdb
3959     option to be given to afsd on startup.  If this option is used, then
3960     new cells will be looked up using AFSDB records stored in DNS if they
3961     are not found in CellServDB.  This means that users can create
3962     cross-cell mountpoints in directories they control to access cells not
3963     in root.afs, and that cells in root.afs need not be in the client's
3964     CellServDB.
3966   * AFS database servers can be marked as read-only clones.  Surround the
3967     hostname in square brackets on the bos addhost command and the
3968     database server will never be elected sync site.  This is useful for
3969     cells distributed over a wide region.
3971   * The AFS servers now support the -syslog flag.  This flag causes them
3972     to log to syslog rather than to files.  This flag is not supported on
3973     NT.  For all servers besides the salvager, the flag can also be
3974     specified as -syslog=facility, where facility is an integer facility
3975     code from syslog.h.  A -syslogfacility option is provided for the
3976     salvager to accomplish the same goal.
3978   * If the --enable-fast-restart flag is given when configuring AFS, then
3979     the salvager supports the -dontsalvage flag which causes it to exit
3980     without salvaging any volumes.  If this is configured into the third
3981     command of a fs process, then the fileserver will start without
3982     salvaging.  It will fail to attach volumes that need salvaging and
3983     they can be salvaged manually.  This provides significantly better
3984     server startup performance at the cost of administrative complexity.
3986   * If the --enable-bitmap-later flag is given when configuring AFS, then
3987     the fileserver creates bitmaps for free vnodes on demand, allowing
3988     faster starts.
3990   * If bosserver finds a BosConfig.new file at startup, it reads this file
3991     and renames it to BosConfig.  This allows bosserver to be reconfigured
3992     at next restart.
3994   * The bosserver can be placed in a restricted mode in which AFS
3995     superusers are only granted limited access to the server host. The
3996     following functionality is disabled when restricted mode is in use:
3998       bos exec
3999       bos getlog (except for files with no '/'s in their name)*
4000       bos create *
4001       bos delete
4002       bos install
4003       bos uninstall
4005     specific exceptions are made for functionality that "bos salvage"
4006     uses:
4008     A cron bnode who's name is "salvage-tmp", time is now, and command
4009     begins with "/usr/afs/bin/salvager" may be created. This bnode deletes
4010     itself when complete, so no special "delete" support is needed.  This
4011     functionality may be removed in the future if a "Salvage" RPC is
4012     implimented.
4014     The file with the exact path /usr/afs/logs/SalvageLog may be fetched,
4015     since that is how bos salvage [...] -showlog is implimented.
4017     Restricted mode is enabled using a new bos command (bos setrestricted)
4018     or bossever command line switch (bosserver -restricted). Restricted
4019     mode can be disabled by a) sending the bosserver process a SIGFPE
4020     (which will then allow restricted operations until the next restart or
4021     setrestricted command) or b) editing /usr/afs/local/BosConfig (or
4022     BosConfig.new), and restarting the bosserver.
4024   * The bos UserList of trusted administrators can now contain cross-realm
4025     Kerberos principals.
4027   * udebug now takes --server not --servers.
4029   * Several error messages have been improved to include volume numbers.
4031   * Several new ports have been included for UNIX platforms: Darwin
4032     (ppc_darwin_12 and ppc_darwin_13), Linux 2.4 (i386_linux24), Linux on
4033     the Powerpc (ppc_linux22 and ppc_linux24), Linux on the Sparc
4034     (sparc_linux22, sparc64_linux22 and sparc64_linux24).
4036   * Incomplete FreeBSD and Alpha Linux ports are included.  The FreeBSD
4037     port has a working server and the Alpha Linux port has a partially
4038     working client.
4040   * A native client for Windows 95/98/ME has been added to the
4041     distribution.  With this program, a gateway machine is no longer
4042     required for Windows 9x to access AFS files.  One drive letter will be
4043     created on your machine by default - Z:.  The Z: drive will be the
4044     root of the AFS tree, allowing you to browse all sites that have AFS
4045     servers available.  Additional drive letters can be defined for other
4046     AFS directories.  A Windows Explorer shell extension is included that
4047     allows you to right click on items within an AFS tree to bring up an
4048     "AFS" menu item and perform various operations on a file or directory.
4049     The most useful item is "Access Control Lists", which allows you to
4050     view and edit the permissions of a particular directory.  Command line
4051     tools are also available in the install directory.  These commands
4052     include klog, unlog, tokens, kpasswd, symlink, fs and pts.  The
4053     installable includes a readme file that contains more information on
4054     how to use the client program and known issues.
4056   * Support for large caches in afsd.  Cachefiles are stored in
4057     subdirectories.  The default is 2048 files per subdirectory, which
4058     should work fine in most situations.  You can use the new afsd option
4059     -files_per_subdir to change this number.  Note that the first time you
4060     run afsd with this patch, your cachefiles will get moved into
4061     subdirectories.  If you subsequently run an older version of afsd, you
4062     will lose all your cached files.