Update NEWS for 1.6.22
[pkg-k5-afs_openafs.git] / NEWS
blobe489472e9396f5177104f2f74d7f05f31b09ce3a
1                        User-Visible OpenAFS Changes
3 OpenAFS 1.6.22
5   All Platforms
7     * Fix OPENAFS-SA-2017-001: insufficient validation of transport parameters
8       in Rx ack trailer caused integer overflow and assertion failure
10 OpenAFS 1.6.21.1
12   Linux clients
14     * Support for mainline kernel 4.13 and distribution kernels with backports
15       from it (12664)
17     * Fix kernel module build for kernels since 4.12 on S390 (12717)
20 OpenAFS 1.6.21
22   All platforms
24     * Avoid a possible 100ms transmit delay in the RX protocol when a peer's
25       receive window transitions from closed to open (12627)
27     * Documentation improvements (12476 12477 12559[RT #133339])
29   All server platforms
31     * When bosserver is started with an unknown option, print an error message
32       and exit with a non-zero value rather than failing silently (12631)
34   All DB server platforms
36     * Hold the DB lock while checking for an aborted write transaction (12516)
38   All file server platforms
40     * On demand attach fileservers, don't save or restore a client's host
41       state if CPS ("Current Protection Subdomain") recalculation for it is
42       in progress, to avoid fileserver thread exhaustion (12568)
44     * On demand attach fileservers, avoid flooding the log with error messages,
45       which could happen when the fileserver was restarted while a volume was
46       offline (12569)
48     * Update a volume's "Last Update" time when its content is modified by
49       the salvager, to make the change visible in the output of "vos examine"
50       and to backup services (12633)
52   All client platforms
54     * Corrected the DCentries bucket counts for very large and zero length
55       files in the output of "fs getcacheparms -excessive" (12604 12605)
57     * Fixed a bug that prevented users with GID 2748 and 2750 from executing
58       the "fs sysname" command on clients running afsd with -rmtsys (12607)
60     * Provide a new -inumcalc switch for afsd to allow enabling the alternative
61       MD5 method of inode number calculation, which was previously only
62       possible on Linux and through the sysctl interface (12608 12632)
64   Linux clients
66     * Support for mainline kernel 4.12 and distribution kernels with backports
67       from it (12624 12626)
69     * Re-added the improved algorithm for freeing unused vcaches to reduce
70       memory consumption first introduced with the 1.6.18 release, together
71       with a fix for the issue leading to its removal in 1.6.18.2 (12448..12451)
73   macOS clients
75     * Fixed a crash while stopping the client on macOS 10.12 "Sierra" (12602)
78 OpenAFS 1.6.20.2
80   All platforms
82     * Build fixes required by recent compilers or platforms (12514 12521 12534
83       12536 12538)
85     * Allow the bos server to start successfully in the presence of those, by
86       accepting a now checked return value indicating that the client ThisCell
87       and CellServDB already exist (12522)
89   Linux clients
91     * Support for mainline kernels 4.10 and - most likely - 4.11 and
92       distribution kernels with backports from them (12530 12588..12590 12598)
94     * Support for distribution kernels with partial backports from 4.9 (12535)
95       (RT #134158)
97     * In Red Hat packaging, moved the klog.krb5 manual page into the krb5
98       subpackage (12511)
100     * In Red Hat packaging, prevent systemd from double-starting the client
101       (12587)
103     * Allow aklog to function on current S390/S390x (12499)
105   Solaris clients
107     * Make process authentication groups work on Solaris 11, now using a single
108       group ID (12524..12527)
110     * Fix a BAD TRAP panic on Solaris 11 clients built with Studio 12.5 (12567)
112   macOS clients
114     * Fixed the preference pane for OS X 10.11 and later (12512)
116 OpenAFS 1.6.20.1
118   All platforms
120     * Build fixes required by recent compilers (12482..12484)
122   Linux clients
124     * Support for mainline kernel 4.9 and distribution kernels with
125       backports from it (12478..12480)
127     * In Red Hat packaging, make systemd deal correctly with the client
128       when no userland processes remain after starting it (12481)
129       (RT #133482)
131   macOS
133     * Support for release 10.12 "Sierra" (12431 12432)
135     * Avoid a crash in the Mounts tab of the OpenAFS preference pane (12447)
137 OpenAFS 1.6.20 (Security Release)
139   All platforms
141     * Fix for OPENAFS-SA-2016-003: file and directory names leak due to
142       reuse of directory objects without zeroing the contents
143       (12461 12462 12463 12464 12465)
145 OpenAFS 1.6.19
147   All platforms
149     * Documentation improvements (12304)
150     * Fixes for test failures (12396 12415)
152   All DB server platforms
154     * Avoid potentially writing to an out of date volume location or protection
155       database, or losing a database write, which could happen in rare cases
156       under special conditions during database leader election
157       (12339 12389)
159   Solaris clients
161     * Allow the fsinfo::: DTrace provider to work with AFS files (12371)
163   Linux clients
165     * Don't commit more data to a file than was actually copied during writes,
166       which could happen on architectures with a page size > 4 KiB (12413)
167     * Fixed build on PPC64 with GCC 6.1 (12388) (RT #133407)
168     * Fixed build on x86_64 with recent GCC (12365 12366)
171 OpenAFS 1.6.18.3
173   Linux clients
175     * Support for mainline kernel 4.7 and distribution kernels with
176       backports from it (12348)
178   Solaris clients
180     * Fixed memory mapped I/O on files >= 4 GiB (12349 12350)
182       Note that there is a suspicion that this might break the client
183       on very old Solaris releases (2.6). If it does, the breakage should
184       occur at build time.
186   OS X
188     * Added tooling to build a package for OS X 10.10 "Yosemite" and
189       10.11 "El Capitan" (12335 12351)
192 OpenAFS 1.6.18.2
194   Linux clients
196     * Support for mainline kernel 4.6 and distribution kernels with
197       backports from it (12332)
199     * Switch back to the pre-1.6.18 algorithm for freeing unused vcaches.
200       While the new algorithm is still believed to be correct, it turned
201       out that at least on some kernels, including 4.5 and 4.6, the dentry
202       for the current working directory may be erroneously invalidated.
203       This could lead to errors like "Unable to read current working directory"
204       when a directory wasn't accessed for a few minutes. (12323)
206     * Use a secure URL to retrieve the CellServDB in the script to create
207       the Red Hat source package (12330)
209   FreeBSD
211     * Added sysname IDs for 10.2 and 10.3 to fix the build on those platforms
212       (12322)
215 OpenAFS 1.6.18.1
217   Linux clients
219     * Support for mainline kernel 4.5 and distribution kernels with
220       backports from it (12300..12302)
223 OpenAFS 1.6.18
225   All platforms
227     * Documentation improvements (12224 11675 11613 12197)
229     * Improved diagnostics and error messages (12129 12207 12185 12211 12113
230       12215 12216)
232     * Check that CellServDB entries are valid IPv4 addresses, to avoid
233       occasional hangs or potentially other erratic behaviour due to invalid
234       entries (12210) (RT #131794)
236   All client platforms
238     * Gracefully handle cases where a client shutdown sequence is initiated
239       while the client is already shutting down, rather than cause a panic
240       (12179)
242     * Fixed several bugs that could cause erratic behaviour when the write
243       offset into a file was more than 2 GiB beyond the file's current end
244       on the server (12213 12214)
246   All server platforms
248     * Avoid a possible volserver crash during volume dump or restore due
249       to invalid ACL entries (12127)
251     * Allow recovering from a DAFS fileserver operation which allocates a
252       new vnode but fails to update the vnode index, rather than crashing the
253       server (12209)
255     * Fixed a longstanding bug which could damage the volume location database
256       when "vos changeaddr" was run with "-oldaddr" and "-newaddr" and the
257       old address was present in a multi-homed entry (12089)
259   FreeBSD
261     * Added support for releases 10.2 and 10.3 (12232)
263   Linux clients
265     * Support for mainline kernel 4.4 and distribution kernels with
266       backports from it, alas at a performance penalty (12226 12227 12228)
267       (RT #132677 #132819)
269     * Avoid using excessive amounts of kernel memory for dynamically
270       allocated vcaches, by improving the algorithm to free unused ones
271       (12256 12257)
273     * In Red Hat packaging, make the init script use "ip" if available, with
274       "ifconfig" as a fallback (12193)
276   OS X
278     * Basic support for release 10.11 "El Capitan" (12212)
280   IRIX clients
282     * Fixed kernel module builds with optimization (12198) (RT #131261)
285 OpenAFS 1.6.17 (Security Release)
287   All server platforms
289     * Fix for OPENAFS-SA-2016-001: foreign users can create groups as
290       if they were an administrator (RT #132822) (CVE-2016-2860)
292   All client platforms
294     * Fix for OPENAFS-SA-2016-002: information leakage from sending
295       uninitialized memory over the network.  Multiple call sites
296       were vulnerable, with potential for leaking both kernel and
297       userland stack data (RT #132847)
299     * Update to the GCO CellServDB update from 01 January 2016 (12188)
301   Linux clients
303     * Fix a crash when the root volume is not found and dynroot is not
304       in use, a regression introduced in 1.6.14.1 (12166)
306     * Avoid introducing a dependency on the kernel-devel package corresponding
307       to the currently running system while building the srpm (12195)
309     * Create systemd unit files with mode 0644 instead of 0755
310       (12196) (RT #132662)
312 OpenAFS 1.6.16
314   All platforms
316     * Documentation improvements (11932 12096 12100 12112 12120)
318     * Improved diagnostics and error messages (11586 11587)
320     * Distribute the contributor code of conduct with the stable release (12056)
322   All server platforms
324     * Create PID files in the right location when bosserver is started with
325       the "-pidfiles" argument and transarc paths are not being used (12086)
327     * Several fixes regarding volume dump creation and restore (11433 11553
328       11825 11826 12082)
330     * Avoid a reported bosserver crash, and potentially others, by replacing
331       fixed size buffers with dynamically allocated ones in some user handling
332       functions (11436) (RT #130719)
334     * Obey the "-toname" parameter in "vos clone" operations (11434)
336     * Avoid writing a loopback address into the server CellServDB - search
337       for a non-loopback one, and fail if none is found (12083 12105)
339     * Rebuild the vldb free list with "vldb_check -fix" (12084)
341     * Fixed and improved the "check_sysid" utility (12090)
343     * Fixed and improved the "prdb_check" utility (12101..04)
345   All client platforms
347     * Avoid a potential denial of service issue, by fixing a bug in pioctl
348       logic that allowed a local user to overrun a kernel buffer with a single
349       NUL byte (commit 2ef86372) (RT #132256) (CVE-2015-8312)
351     * Refuse to change multi-homed server entries with "vos changeaddr",
352       unless "-force" is given, to avoid corruption of those entries (12087)
354     * Provide a new vos subcommand "remaddrs" for removing server entries, to
355       replace the slightly confusing "vos changeaddr -remove" (12092 12094)
357     * Make "fs flushall" actually invalidate all cached data (11894)
359     * Prevent spurious call aborts due to erroneous idle timeouts (11594)
361     * Provide a "--disable-gtx" configure switch to avoid building and
362       installing libgtx and its header files as well as the depending
363       "scout" and "afsmonitor" applications (12095)
365     * Fixed building the gtx applications against newer ncurses (12125)
367     * Allow pioctls to work in environments where the syscall emulation
368       pseudo file is created in a read-only pseudo filesystem, like in
369       containers under recent versions of docker (12124)
371   Linux clients
373     * In Red Hat packaging, avoid following a symbolic link when writing
374       the client CellServDB, which could overwrite the server CellServDB,
375       by removing an existing symlink before writing the file (12081)
377     * In Red Hat packaging, avoid a conflict of openafs-debuginfo with
378       krb5-debuginfo by excluding our kpasswd executable from debuginfo
379       processing (12128) (RT #131771)
381 OpenAFS 1.6.15 (Security Release)
383   All client and server platforms
385     * Fix for OPENAFS-SA-2015-007 "Tattletale"
387       When constructing an Rx acknowledgment (ACK) packet, Andrew-derived
388       Rx implementations do not initialize three octets of data that are
389       padding in the C language structure and were inadvertently included
390       in the wire protocol (CVE-2015-7762).  Additionally, OpenAFS Rx in
391       versions 1.5.75 through 1.5.78, 1.6.0 through 1.6.14, and 1.7.0
392       through 1.7.32 include a variable-length padding at the end of the
393       ACK packet, in an attempt to detect the path MTU, but only four octets
394       of the additional padding are initialized (CVE-2015-7763).
396 OpenAFS 1.6.14.1
398   Linux clients
400     * Support kernels up to 4.2
402       Due to changes to internal data structures with this kernel release,
403       the OpenAFS client can no longer reset the link count during path
404       lookups. Since volume root directories must behave like symlinks
405       instead of normal directories in order to satisfy Linux kernel
406       invariants, looking up paths containing more than 40 mount points
407       will fail with ELOOP on such kernels.
409 OpenAFS 1.6.14
411   All server platforms
413     * Prior to the OpenAFS security release 1.6.13, the Volume Location
414       Server (vlserver) RPC VL_ListAttributesN2() supported wildcard volume
415       name lookups via regular expression (regex) pattern matching. This
416       support was completely disabled in 1.6.13 because it was judged to be
417       a security risk due to buffer overruns in the implementation, as well
418       as the possibility of denial of service attacks where certain regular
419       expressions could cause excessive CPU usage in some regex
420       implementations.
422       Unfortunately, after 1.6.13 was released, it was discovered that
423       the native OpenAFS 'backup' system uses the VL_ListAttributesN2()
424       regex support to evaluate configured volume sets. If you use the
425       OpenAFS 'backup' system (or another backup system which relies on it,
426       such as Tivoli Storage Manager (TSM, aka Tivoli ADSM)), and are using
427       volume sets which require regular expressions for the volume name,
428       then those volume sets cannot be resolved by OpenAFS 1.6.13. The next
429       paragraph provides details on how to identify any affected volume sets.
431       OpenAFS backup volume sets may be described by fileserver, partition
432       name, and volume name. The fileserver and partition specifications
433       never require regular expression support. The volume name specification
434       always requires regular expression support except for when specifying
435       _all_ volumes via two special cases: the universal wildcard ".*", or "".
436       For example, volume name "proj" or "*.backup" or "homevol.*" all
437       require regex support - even if the specification contains no wildcard
438       characters and/or exactly matches an existing volume name.
440       As a result of this issue, OpenAFS 1.6.14 replaces the 1.6.13 changes
441       to VL_ListAttributesN2. 1.6.14 prevents the buffer overruns and
442       reenables the regex support, but restricts it to OpenAFS super-users
443       and -localauth only. This is sufficient to restore the OpenAFS 'backup'
444       system's ability to work correctly with any previously supported volume
445       set. The OpenAFS 'backup' commands are already documented to require
446       super-user authorization, so this restriction is moot for the backup
447       system.
449       There are no other direct consumers of the VL_ListAttributesN2() regex
450       support in the OpenAFS tree. However, the VL_ListAttributesN2 RPC is
451       publicly accessible and might be used by third party tools directly or
452       indirectly via OpenAFS's libadmin. Any such tools that issue
453       VL_ListAttributesN2 RPCs must now be executed using super-user or
454       -localauth tokens.
456       None of the other security fixes in OpenAFS 1.6.13 are known to have
457       any issues, and are still included unchanged in OpenAFS 1.6.14.
459       If there are any questions concerning the possible impact of OpenAFS
460       1.6.13 or 1.6.14 at your site, please contact your OpenAFS support
461       provider or the openafs-info@openafs.org mailing list for further
462       assistance.
464 OpenAFS 1.6.13
466   All server platforms
468     * Fix for CVE-2015-3282: vos leaks stack data onto the wire in the
469       clear when creating vldb entries
471     * Workaround for CVE-2015-3283: bos commands can be spoofed, including
472       some which alter server state
474     * Disabled searching the VLDB by volume name regular expression to avoid
475       possible buffer overruns in the volume location server
477   All client platforms
479     * Fix for CVE-2015-3284: pioctls leak kernel memory
481     * Fix for CVE-2015-3285: kernel pioctl support for OSD command passing
482       can trigger a panic
484   Solaris clients
486     * Fix for CVE-2015-3286: Solaris grouplist modifications for PAGs can
487       panic  or overwrite memory
489 OpenAFS 1.6.12
491   All server platforms
493     * Avoid database corruption if a database server is shut down and then
494       brought up again quickly with an altered database (11773 11774)
495       (RT #131997)
497   All client platforms
499     * Fixed a potential buffer overflow in aklog (11808)
501     * Avoid a bogus warning regarding the checkserver daemon, which could be
502       logged during startup when the cache initialization was very fast (11680)
504     * Added documentation of the inaccuracy of the 'partition' field in
505       'fs listquota' output for partitions larger than 2 TiB (11626)
507   Linux clients
509     * Support kernels up to 4.1 (11872 11873)
511     * Avoid spurious EIO errors when writing large chunks of data to
512       mmapped files (11877)
514   OS X
516     * Build fixes required at least on OS X 10.10 Yosemite with the latest
517       XCode (11859 11876 11842..11845 11863 11878 11879)
519 OpenAFS 1.6.11.1
521   Linux clients
523     * Support kernels up to 4.0 (11760 11761)
525   FreeBSD clients
527     * Fixed kernel module build on systems with an updated clang which no
528       longer accepts the -mno-align-long-strings as a no-op (11809)
530 OpenAFS 1.6.11
532   All platforms
534     * Allow aklog to succeed creating native K5 tokens even when mapping
535       the K5 principal to a K4 one fails (11538)
537     * Build fixes (11435 11636)
539   All client platforms
541     * Avoid a potential kernel panic due to connection reference overcounts
542       (11645) (RT #131885)
544     * Avoid potential corruption of files written using memory mapped I/O
545       when the file is larger than the cache (11656) (RT #131976)
547   Linux clients
549     * Support kernels at least up to 3.19 (11549 11550 11569 11570 11595
550       11658..11662 11694 11752)
552       Note: By default this excludes kernels 3.17 to 3.17.2, which will leak
553             an inode reference when an error occurs in d_splice_alias(). The
554             module will build and work, but leak kernel memory, leading to
555             performance degradation and eventually system failure due to
556             memory exhaustion. Since it's impossible to detect this condition
557             automatically, the switch --enable-linux-d_splice_alias-extra-iput
558             must be passed to configure when building the module for those
559             kernels. The same would be necessary for any kernel with backports
560             of commit 908790fa3b779d37365e6b28e3aa0f6e833020c3 or commit
561             95ad5c291313b66a98a44dc92b57e0b37c1dd589 but not the fix in commit
562             51486b900ee92856b977eacfc5bfbe6565028070 in the linux-stable repo
563             (git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git) or
564             the corresponding changes on other branches.
566     * Fixed a regression introduced in OpenAFS release 1.6.10 which could
567       make the spurious "getcwd: cannot access parent directories" problem
568       return (11558 11568) (RT #131780)
570     * Avoid leaking memory when scanning a corrupt directory (11707)
572   OS X clients
574     * Support OS X 10.10 "Yosemite" (11571 11572 11611) (RT #131946)
576   Solaris clients
578     * Avoid reading random data rather than correct cache content when using
579       ZFS as the cache file system on Solaris >= 11, and fix potential similar
580       problems on other platforms (11713 11714)
582   FreeBSD
584     * Build fix for releases >= 11.0 (11610)
586   OpenBSD
588     * Support release 5.4 (11700)
591 OpenAFS 1.6.10
593   All platforms
595     * Don't hide the "version" subcommand in help output (11214)
597     * Documentation improvements (11126 11216 11222 11223 11225 11226)
599     * Improved diagnostics and error messages (11154 11246 11247 11249 11181
600       11182 11183)
602     * Build system improvements (11158 11221 11224 11225 11227..11241 11282
603       11342 11350 11353 11242 11367 11392)
605     * Avoid potentially erratic behaviour under certain error conditions by
606       either avoiding or at least not ignoring them, in various places (11008
607       11010..11065 11112 11148 11196 11530)
609   FreeBSD
611     * Support releases 9.3 and 10.1 (11368 11369 11402 11403 11404)
613     * Makes a disk cache more likely to work on FreeBSD, though such
614       configurations remain not very tested (11448)
616   All server platforms
618     * Added volscan(8) (11252..11280 11387 11388)
620     * Fixed a bug causing subgroups not to function correctly if their
621       ptdb entry had more than one continuation entry (11352)
623     * Logging improvements (10946 11153)
625     * Allow log rotation via copy and truncate (11193)
627     * Avoid a server crash during startup only observed on a single platform
628       and when using a 3rd party library under certain circumstances, which is
629       a collateral effect of the security improvements introduced in OpenAFS
630       release 1.6.5 (11075) (RT #131852)
632   All client platforms
634     * Raised the free space reported for /afs to the maximum possible value of
635       just under 2 TiB - the old value was 9 GiB on most platforms (10984)
637     * Reduced the amount of stack space used (11162 11163 11203 11164..11167
638       11338 11339 11364..11366 11381)
640     * Sped up a periodic client task which could be problematically slow
641       on systems with a large number of PAGs and files in use (11307)
643     * Fixed failure of the up command with large ACLs (11111)
645     * Avoid a potential crash of aklog (11218)
647     * Avoid potential crashes of scout and xstat_fs_test (11155)
649   Linux clients
651     * Support kernels up to 3.16 (11308 11309)
653     * Fixed a regression introduced in OpenAFS release 1.6.6 that made
654       checking for existing write locks incorrectly fail on readonly volumes
655       (11361)
657     * Fixed a regression introduced in OpenAFS release 1.6.8 that could
658       cause VFS cache inconsistencies when a previously-accessed directory
659       entry was removed and recreated with the same name but pointing to a
660       different file on another client (11358)
662     * Use the right path to depmod in Red Hat packaging to avoid dependency
663       calculation incorrectly failing unless a link /sbin -> /usr/sbin is
664       present on the system performing it (11171) (RT #131860)
666     * Do not ignore kernel module build errors (11205)
668 OpenAFS 1.6.9
670   All server platforms
672     * Fix for OPENAFS-SA-2014-002
674 OpenAFS 1.6.8
676   All platforms
678     * Documentation improvements (10751 10875 10931 10897 10883 10954 10955)
680     * Improved diagnostics and error messages (10756 10814 10949)
682     * Fixed a bug in RX that could make errors during packet reception go
683       unnoticed. (10733)
685     * Fixed a bug that made "vos size -dump" display the wrong size for
686       large volumes. (10933)  (RT #131819)
688   All server platforms
690     * Change the default fileserver sync behavior from "delayed" to "onclose".
691       This means that explicit syncing only happens when a volume is detached.
692       (10809)
694     * Added the -offline-timeout and -offline-shutdown-timeout options to the
695       fileserver, to implement interrupting clients accessing volumes we are
696       trying to take offline. (6266 10799)
698   All client platforms
700     * When a client is shut down, it will give up its callbacks. The Windows
701       client has been doing this since 2007. Note that older fileservers
702       (1.3.50 to 1.4.5 and 1.5.0 to 1.5.27) had a bug in the implementation of
703       the relevant RPC that could cause crashes or other undefined behavior
704       when this happens. (6272 8840 10855)
706     * Restored the pre-1.6 behavior of "vos e" being an alias for "vos examine".
707       (10886)
709     * Avoid flooding logs with warnings about byte-range locks, by throttling
710       them per file. Also, make the messages more useful by including the
711       FID. (10836..10839)
713     * Avoid a possible panic during shutdown while tracing. (10932)
715   Linux clients
717     * Fixed a bug that could cause the "getcwd: cannot access parent
718       directories" problem (10804 10984)
720     * Avoid a delay when accessing uncached data in AFS in a confined
721       context under SELinux. (10598)
723     * Red Hat packaging improvements (10600 10767 10807)
725 OpenAFS 1.6.7
727   All server platforms
729     * Fix for OPENAFS-SA-2014-001
731     * Fix for a potential DOS attack against RX servers
733 OpenAFS 1.6.6
735   All platforms
737     * As of this release, OpenAFS no longer ships uncompressed source tarballs.
738       Tarballs are still shipped with both compression formats, gzip and bzip2.
739       (10131)
741     * Documentation improvements (10136 10314 10601)
743     * Improved diagnostics and error messages (9412 10085 10274)
745     * Avoid redefining "assert" in our public header files, which could
746       cause failures when building some applications using them. (10096)
748     * Fixes for parallel builds (10005 10309 10337)
750     * Added a -s switch to afscp (not installed by default) to help simulate
751       a slow client. (9416 9417)
753     * Added a -probe switch to vlclient test program (not installed by default)
754       to ping all vlservers in a cell in parallel. (9570)
756   All server platforms
757     * The fileserver now ignores any vice partitions with a NeverAttach flag
758       file present in the root directory. (RT #130561) (9470 9471)
760     * Restrict forcing CPS ("Current Protection Subdomain") recalculation in
761       the fileserver to administrators. Also fixed a bug that could cause this
762       operation to be incomplete. (9485 9487)
764     * Allow non-DAFS fileservers to attach unusable volumes, restoring pre-1.6
765       behaviour. (RT #131505) (9499)
767     * Restored the pre-1.6 behaviour when running vos examine for a volume
768       currently in a transaction, showing the volume as busy again rather than
769       offline. (9685 9915 9916)
771     * Reduced the minimum time a bos salvage takes from 5 seconds to 1. (9476)
773     * Fixed buserver to not segfault when started with the -servers option.
774       (RT #131706) (10166)
776     * Salvager fixes, addressing a wide variety of possible problems from
777       unnecessary salvaging to aborts (9282 9283 9457 9458 9459 9461 9462 9480
778       9481 10165 10167)
780     * Fixed a bug that could cause saved state information to be discarded
781       when restarting a large or busy fileserver, which negatively impacted
782       performance. (9683)
784     * Fixed a bug that could have caused undefined behaviour in the vlserver
785       in rare cases when a fileserver registered its addresses in the VLDB.
786       (9429)
788     * Added the -preserve-vol-stats switch to volserver, allowing it to keep
789       the access statistics across volume restore and reclone operations
790       instead of resetting them. (9477)
792     * Inserted an exponential delay between retries when bosserver attempts to
793       restart a server process. (9571 10199)
795     * Improved vldb_check (not installed by default) to cope with broken
796       vlentry names and volids, and provide more output to aid debugging.
797       (10268)
799     * Releasing a volume after adding a new RO site no longer touches any of
800       the existing RO sites, if the RW data hasn't changed since the last
801       release. (10174)
803     * Make the copyDate field for RO clones have the same meaning as for
804       remote RO volumes. Previously, the copyDate field for clones was updated
805       every time we released. (9451)
807     * Fixed potentially undefined behaviour in ptserver when too many pts
808       ids are allocated. (10124)
810     * Note that the server side NAT pings feature present in the prereleases
811       was removed before the final release, since no positive feedback
812       was provided during prerelease testing. (9420 10135)
814   Linux servers
816     * Start bosserver with -nofork in the systemd unit file, to allow systemd
817       to track its state (10093)
819   All client platforms
821     * No longer track file locks on read-only volumes. Write locks can't
822       succeed, read locks always will. Avoids log messages about this kind
823       of lock. (8910)
825     * Added the "fs flushall" subcommand, which makes the client discard all
826       cached data. This was previously available on Windows only. (9065 9388
827       9389 9390)
829     * Fixed a bug that could make the client incorrectly believe its cache
830       is up to date. This change could negatively impact AFS <-> DFS
831       translators, should those still be running anywhere. (8898)
833     * Several changes to avoid panicing in certain error conditions.
834       (9131 9287 10354 10355 10356 10357) (partially addressing RT #131747)
836     * Added the -rxmaxfrags switch to afsd, allowing to limit the number
837       of UDP fragments sent or received per RX packet. (9430)
839     * Build fixes for aklog on several platforms (RT #131716) (9917 10107 10275)
841     * Require that the AFS mountpoint specified in the cacheinfo file is
842       an absolute path. Relative paths result in a client that basically
843       works but is not fully functional. (10253)
845     * Fixed a bug that could cause one of the afsd threads to enter an infinite
846       loop (10431 .. 10436)
848   Linux clients
850     * Support Linux kernels up to 3.13 (10241)
852     * Fixed a bug that made readv/writev calls in AFS space fail with Linux
853       kernels where generic_file_aio_read exists but those operations have
854       not been switched to using aio_read/aio_write. This was a regression
855       introduced with release 1.6.3 and affected at least RHEL 5.9 kernels.
856       (10248)
858     * Fixed a similar bug making core dumps fail in AFS space, affecting
859       a much wider range of kernels including the most recent ones.
860       (RT #131729) (10254)
862     * Enhanced the keyring code to make PAGs work correctly on kernels with a
863       distribution specific change to the Linux keyring code. This affected at
864       least SLES 11 SP3 kernels. (10252)
866     * Fixed a bug that could make failures during PAG instantiation go
867       unnoticed. (10255)
869     * Fixed a bug that made compilation fail for Linux kernels without
870       keyring support. This affected at least the SLE 10 SDK and an
871       OEM version of SLES 11 SP1. (10325)
873     * Fixed build for kernels with user namespace support enabled. Likely
874       to be required for Ubuntu 14.04 and eventually other distributions.
875       (10456 10457 10458 10518 10472)
877     * Support RHEL 6.5 kernels, and possibly others with changes backported
878       from recent mainline kernels that touch getname/putname, by no longer
879       using those functions. Previously, the client could cause a kernel
880       panic when syscall auditing was enabled. (10578)
882     * Make tmpfs usable as the cache filesystem again. This had been broken
883       since kernel 3.1 (9950 10193)
885     * When starting the client fails, clean up the backing device information
886       created in sysfs, to avoid error messages during a subsequent start
887       and possible system instability later on (10454)
889     * Update Red Hat packaging to support Fedora >= 20, RHEL >= 7 and
890       ELrepo kernels (10597 10619 10622 10703 10704)
892   OS X Clients
894     * Support OS X 10.9 "Mavericks" (10519 10541 10542 10543 10548 10549)
896   AIX clients
898     * Fixed a bug that caused the 1.6 AIX client to never receive any RX
899       packets in the kernel. (RT #131725)
901   FUSE client
903     * Support Solaris 11 (9454 9455)
905     * Allow other users to access filesystems mounted by root. (9452)
907   FreeBSD
909     * Build tvolser and dvolser on this platform (10122)
910     * Several fixes to catch up with newer releases (10374 .. 10381)
912   NetBSD
914     * Build tsalvaged, tvolser and dvolser on this platform (10121)
915     * Fixed build on NetBSD 5 and newer. (10138)
917 OpenAFS 1.6.5
919 All platforms
921     * Fixes for OpenAFS-SA-2013-0003 and OpenAFS-SA-2013-0004
923 OpenAFS 1.6.4
925 All platforms
927     * Obey the jumbo/nojumbo settings for ubik servers (the DB servers)
928       too. In previous releases, those servers may have used jumbograms
929       even if they were not configured to do so. This change corrects
930       the actual behaviour, and will improve performance and reliability
931       for sites where jumbograms are problematic. It could cause a decrease
932       in performance for sites where jumbograms work, but those can turn
933       them back on manually.
935     * Dozens of fixes for common coding problems like use after free,
936       use of possibly uninitialised memory, reading or writing past the
937       end of arrays and potential NULL pointer derefences. Spotted by
938       code analysis tools or human inspection.
940     * Documentation improvements.
942     * Fixes and improvements to the diagnostic or log messages printed by
943       vos, the fileserver and others.
945     * Build fixes, making parallel builds more reliable with certain
946       configuration options and helping various platforms including
947       recent releases of IRIX, Solaris and several flavours of Linux.
949     * Avoid sending a small amount of data over the wire unencrypted
950       under certain conditions, and emit the correct error message in
951       this case.
953 All server platforms
955     * Avoid generating duplicate IDs for readonly and backup volumes,
956       which could happen under certain conditions.
958     * Allow the fileserver to return volume data like quota or free space,
959       which is available publicly elsewhere, without the additional access
960       check for read permissions on a volume's root directory the fileserver
961       performed before.
963     * The fileserver now emits a log message when it ran out of memory for
964       callbacks.
966     * Avoid several potential fileserver problems, including memory
967       corruption and segmentation faults, due to client bookkeeping.
969     * Avoid known cases of silent data corruption due to background syncs
970       on the fileserver, especially during Copy on Write.
972     * Make the fileserver sync behaviour runtime configurable. Up to 1.4.5,
973       we had synchronous syncs which were safe but really slow. Since 1.4.5,
974       we've had asynchronous syncs which are much faster but believed to
975       be the cause of rare data corruption issues, and while all known cases
976       of these happening are believed to be fixed in the 1.6.3 release, doubts
977       remain. This change allows choosing between those, and in addition allows
978       to turn syncs by the fileserver off altogether, thus relying on the vice
979       partition's backend filesystem and the operating system, or to just
980       execute them when a volume is detached. The default behaviour is
981       unchanged from releases since 1.4.5, but it's highly recommended to
982       consider the additional options this change provides. Future OpenAFS
983       releases will default to "-sync=none".
985     * For dbservers, avoid a situation where misinterpreting transient
986       network errors causes long-term issues with achieving ubik quorum.
988 All UNIX client platforms
990     * Improvements to the detection of an aklog-specific krb5 configuration
991       file, for the purposes of turning on "weak crypto" for aklog.
993     * Fixed a regression introduced in release 1.6.2 which caused the
994       supposedly persistent disk cache to be discarded upon client start.
995       (RT #131655)
997 Linux clients
999     * Support Linux kernels up to 3.10
1001     * Fixed two bugs making it impossible to unmount a disk cache filesystem
1002       after it has been used by the client. (RT #131613)
1004     * Fixed a bug that could cause an oops with kernels 3.6 and later
1006 OpenBSD
1008     * Improved support for OpenBSD 4.9 to 5.3
1010 OpenAFS 1.6.3
1012   This release number had to be skipped for technical reasons.
1014 OpenAFS 1.6.2.1
1016   Linux clients
1018     * Support Linux kernels up to 3.8.
1020     * Make the init script cope with the output of ifconfig on recent Fedora.
1022 OpenAFS 1.6.2
1024   All platforms
1026     * Fix buffer overflows in fileserver and ptserver.
1028     * Abort an rx connection when given an unknown service (Gerrit 7593).
1030     * "idle dead" behavior improvements.
1032     * Documentation updates.
1034   All server platforms
1036     * Fix rare file corruption during background sync (Gerrit 8796).
1038     * Fix corrupting clients' metadata cache during certain errors (Gerrit
1039       6957).
1041     * Avoid saying a volume doesn't exist when accessed as the volume is
1042       going offline (Gerrit 7488).
1044     * Fix fileservers to properly report >2 TiB partitions.
1046     * Fix stale volume info from vos examine on non-DAFS filservers.
1048     * Fix possible volume corruption with vos convertROtoRW.
1050     * Fix bosserver to preserve all command-line options over restart.
1052     * Fix bosserver to properly kill hung processes during shutdown.
1054   All UNIX client platforms
1056     * Fixes for memcache, especially on Solaris.
1058     * Increase the size of the DNS resolver answer buffer to allow sites
1059       with a long response list to use SRV and AFSDB records.
1061     * Fix a crash when a server appears to run out of addresses (Gerrit
1062       7487).
1064     * Fix cache corruption when reading from a file another client is
1065       simultaneously writing to (Gerrit 7994).
1067     * Improve handling of disk cache disk errors.
1069   Linux
1071     * fix DKMS configuration for DKMS 2.2.
1073     * Avoid generating inode number 0 with md5 inodes (Gerrit 7276).
1075     * Fix a crash when reading /proc/fs/openafs/unixusers (Gerrit 7914).
1077     * Make PAG-less access use the real UID of the calling process
1078       instead of the effective UID, when determining what credentials to
1079       use (Gerrit 7931).
1081     * Fix possible abuse of fs mkmount.
1082       Prior to 1.6.2, users could crash a client by nesting volume mounts.
1084     * Fix fileserver memory corruption on RHEL 6
1085       Prior to 1.6.2, fileservers on RHEL 6 may crash under heavy load.
1087     * Fix client page cache corruption on Linux
1088       When multiple clients read and write to a file, the reading client
1089       may see first page (4096 bytes) of a file as nulls.
1091     * Support Linux kernels up to 3.7.
1093     * Support newer glibc versions.
1095     * Improve client systemd unit file.
1097     * Update Red Hat packaging.
1099   OS X
1101     * Fix crashes on shutdown.
1103     * Prevent unloading the module before shutdown completes.
1105     * Security improvement for the OpenAFS preference pane.
1107   Solaris
1109     * Support newer versions of the Sun Studio compiler software.
1111     * Support compiling on newer versions of Solaris 11 and Solaris 10.
1114 OpenAFS 1.6.0 (2011-08-15)
1116   All platforms
1118     * Substantial Rx updates to correct erroneous behavior.
1120     * vos now properly deals with matching sites when servers are
1121       multihomed.
1123     * Don't stop Rx keepalives after an ackall is received, avoiding
1124       spurious connection timeouts. (128848)
1126     * Don't retry Rx calls on channels returning busy errors and improve
1127       Rx busy call channel error handling. (128671)
1129     * Properly enable Rx connection hard timeouts.
1131     * Rx NAT pings are not enabled until peer has answered.
1133     * Initialize rx_multi lock before use.
1135     * Avoid spurious crashes when initializing in "backup" client.
1137     * Revert UUID support in vos.
1139     * pt_util fixed to properly create new databases.
1141     * MTU discovery now properly shut down on call reset.
1143     * Avoid leaking references to hosts during callback break multi-Rx
1144       operations. (129376)
1146     * xstat tools now cope with differing timeval structures between
1147       endpoints.
1149     * Numerous fixes to command argument parsing.
1151     * Documentation updates.
1153   All server platforms
1155     * A file descriptor leak which could result in corrupted files in the
1156       fileserver was fixed. An IMMEDIATE upgrade from previous 1.5 release
1157       fileservers is recommended.
1159     * Fix ptserver supergroups support on 64 bit platforms.
1161     * Demand attach salvaging doesn't use freed volume pointers.
1163     * Properly hold host lock during host enumeration in fileserver.
1165     * Attempt to recovery more quickly from timed out volume release
1166       transactions.
1168     * Auditing now properly byte order swaps IP addresses when printing.
1170     * vos split now has improved error handling.
1172     * Many changes to again support Windows fileservers.
1174     * During volume removal, data removal speed improved.
1176     * Improve CPU utilization during volume attaching by DAFS.
1178     * In salvager check-only mode, avoid potentially fixing a vnode.
1180     * Fix support for large (greater than 2gb) volume special files.
1182     * Salvager will not crash if multiple or bad volume link tables are
1183       encountered.
1185     * Avoid erroneous full dump by remembering which sites were out of
1186       date at the start of the release.
1188     * A deleted volume can now be recreated properly.
1190     * Callbacks are again not broken during whole partition salvages.
1192     * Positional vectored IO fixed for largefile (>2GB) capable systems.
1194     * Fileserver per-client thread usage again properly enforced.
1196     * Anonymous dropbox support improved and drawbacks documented.
1198     * Demand attach: ensure vnodes are not reallocated while in use due to
1199       volume bitmap errors.
1201     * Properly support large volume numbers (larger than 2147483647).
1203     * Allow salvager to be run manually again when DAFS is being
1204       used. (129458)
1206     * Avoid leaking references to hosts during callback break multi-Rx
1207       operations. (129376)
1209     * Demand attach: unlink fileserver state file on standalone salvage.
1211     * Salvager tries harder to detect linktable issues.
1213     * Demand attach: don't attach volumes with special status set.
1215     * Avoid crashing on host table exhaustion. Instead, defer clients.
1217   Microsoft Windows
1219     * afs_config will not longer set the Tray Icon State in the registry
1220       if the checkbox is not present in the dialog. (128591)
1222     * AFS Explorer Shell Extension now works from folder backgrounds.
1223       Overlays for mount points and symlinks are present in the dll, but
1224       are not registered at present by the installers.
1226     * Do not use RankServerInterval registry value as the value for
1227       PerformanceTuningInterval.
1229     * When the data version of a mountpoint or symlink changes, the target
1230       string in the cm_scache_t object must be cleared.
1232     * "fs checkservers" now includes vldb servers in the output and only
1233       lists multi-homed servers once.  A multi-homed server that has at
1234       least one up interface is no longer considered to be down.
1236     * When asynchronously storing dirty data buffers to the file server
1237       ensure that (a) the cm_scache_t object and the cm_buf_t object are
1238       for the same File ID so that locking and signalling work properly;
1239       and (b) if the FID no longer exists on the file server, do not
1240       panic, just discard the buffer.
1242     * When processing VNOVOL, VMOVED and VOFFLINE errors perform server
1243       comparisons by UUID or address and not simply by cm_server_t
1244       pointer.  Otherwise, server failover may not succeed.
1246     * Do not preserve status information for cm_scache_t objects when the
1247       issuing server is multi-homed.
1249     * Giving up all callbacks when shutting down or suspending the machine
1250       is now significantly faster due to the use of an rx_multi
1251       implementation.  (This functionality is still off by default and
1252       must be activated by a registry value.)
1254     * Race conditions were possible when updating the state of the
1255       cm_volume_t flags and when moving the volumes within the least
1256       recently used list.
1258     * Ensure that the lanahelper library does not perform a NCBRESET of
1259       each lan adapter when enumerating the current network bindings.
1260       Correcting this permits OpenAFS to work on Windows 7 when the
1261       network adapter settings change.
1263     * Fix creation of mount points and symlinks as \\AFS\xxxx
1265     * Icon tray state now conditionally set. (128591)
1267     * Properly create new cell mount points in freelance mode.
1269     * Avoid recursive offline volume checks.
1271     * Fix caching of non-existent volumes.  The test to trigger an
1272       immediate CM_ERROR_NOSUCHVOLUME in cm_UpdateVolumeLocation() was
1273       backwards.
1275     * Prevent the background daemon from checking the status of
1276       non-existent volumes.  cm_CheckOfflineVolumes() should skip volume
1277       groups with the CM_VOLUMEFLAG_NOEXIST flag set.
1279     * The afskfw library should return an error immediately if the
1280       krb5_32.dll library cannot be loaded.  Affects afslogon.dll and
1281       afscreds.exe.
1283     * No longer depend on leashw32.dll in afskfw library.
1285     * NPLogonNotify must provide the user password in all calls to
1286       KFW_AFS_get_cred().  It cannot count on a credential cache being
1287       preserved between calls.  Permits tokens to be acquired for all
1288       cells listed in the TheseCells registry value for a domain.
1290     * Improve the trace logging from NPLogonNotify().
1292     * Avoid a race when writing the cm_scache_t mountPointString
1293       when acquiring mount point or symlink target data via
1294       cm_GetData().  The race could result in bogus target
1295       data being cached.
1297     * Permit the use of des-cbc-md5 and des-cbc-md4 enctypes
1298       as DES keys in asetkey.exe.
1300     * aklog supports dotted Kerberos v5 principal names.
1302     * afskfw library always attempts afs/cell@USER-REALM
1304     * afskfw library must test return code from krb5_cc_start_seq_get() or
1305       will trigger a null pointer exception when using Heimdal.
1307     * Lock protected fields must be 32-bit in order to avoid memory
1308       overwrite races.
1310     * Add support for NTFS symlinks.
1312     * Handle file search requests for virtual syscall ioctl file.
1314     * Process SyncOps properly to enforce ordered operations.
1316     * Avoid recursing during NewServer operations.
1318     * Correct lock acquisition order during SMB locking.
1320     * Add shutdown message to event log.
1322     * Check offline volume status by policy rather than on each daemon
1323       thread run.
1325     * Return error on directory object not found instead of crashing.
1327     * Improve error message output.
1329     * afslogin.dll can start afsd_service if it's not starting or started.
1331     * Optimize away release lock RPCs for deleted files.
1333     * Background Daemon will not perform operations on deleted files.
1335     * Resort recently used directories to the top of the LRU if the
1336       directory is larger than the stat cache.
1338     * Resort deleted objects to the bottom of the LRU.
1340     * Use interlocked operations for state and queue fields to allow safe
1341       bit set and clear on multiprocessor systems.
1343   All UNIX client platforms
1345     * Servers now marked down when GetCapabilities returns error.
1347     * In-use vcache count is now properly tracked.
1349     * Check for /afs existance before starting, unless -nomount is
1350       specified.
1352     * Avoid a potential panic when using /afs/.:mount syntax.
1354     * Avoid a panic in memcache mode due to missing CellItems file.
1356     * FUSE client support fixed for non-/afs mounts.
1358     * Avoid a potential deadlock (which times out) when we need to
1359       allocate more callback returns and must flush some already in use.
1361     * Deal with libcom_err conflicts with other packages using it
1362       (e.g. krb5) (128640)
1364     * Fall back to afs3-vlserver SRV record values when afs3-ptserver SRV
1365       record is not available.
1367     * Avoid holding unneeded locks when probing server capabilties.
1369     * Do not attempt page flushes for directories.
1371     * Rx connection reference counting is enabled.
1373     * An Rx connection reference count leak is fixed in bulkstat.
1375     * Handle unparsable directory objects.
1377     * Handle Kerberos cred cache errors in aklog.
1379   AIX
1381     * Fix PAG usage to track by PAG identifier, not group list.
1383   FreeBSD
1385     * Fix socket termination on shutdown.
1387     * Support for 7.2, 7.3, 7.4 and 8.2 included.
1389     * References to vcaches are no longer leaked during root or reclaim.
1391     * Remove support for "Giant" lock as we no longer need to use it.
1393     * Don't sleep with AFS GLOCK.
1395     * Properly enable 64 bit long long support.
1397     * Restore support for FreeBSD 7 (128612)
1399     * Fix locking issues at shutdown and avoid panic at shutdown due to
1400       vcache flushing.
1402     * Support for virtual network stacks.
1404     * New RC script, updated packaging.
1406   IRIX
1408     * Properly create new vnodes to avoid crashing in the client.
1410   Linux
1412     * Support through kernel 2.6.39.  Treat Linux 3.0 as Linux 2.6 for
1413       sysname purposes.
1415     * Use rx_Readv in cache bypass to improve performance.
1417     * Properly handle 0-length replies during cache bypass operations.
1419     * Properly handle non-contiguous readpage cache bypass operations.
1421     * Do proper locking when transitioning to or from cache bypass.
1423     * Avoid extra runs of vcache freeing routine. (128756)
1425     * Perform vcache eviction via a fast path before visiting vcaches
1426       where sleep is needed.
1428     * setpag() errors are now properly reported.
1430     * Avoid attempting to free stat cache entries when we are below
1431       user-specified number of entries in use.
1433     * Properly track user-specified number of stat cache entries to use as
1434       a desired usage target.
1436     * Don't read pages beyond EOF in the cache. (128452)
1438     * Various corrections and improvements to Red Hat packaging, including
1439       modifying the init script to allow deferring for a new binary
1440       restart and properly supporting RHEL6.
1442     * Fix lockup in 2.6.38 due to erroneous kernel feature configure test.
1444     * Improve RPM building tools.
1446     * Attempt to properly handle SELinux in packaging.
1448     * Init script properly returns status as exit code.
1450     * RPM packaging fixes (executable libraries, no postinstall message)
1452     * Kill i386 from RPM packaging.
1454   MacOS
1456     * MacOS 10.7 support.
1458     * Properly handle setpag errors.  PAGs are not supported.
1460     * Check for unloaded kernel extensions when decoding AFS panics.
1462     * Disable "get tokens at login" in prefs pane if AD authentication
1463       plugin is configured.
1465     * aklog AuthorizationPlugin now provided.
1467     * Preferences Pane behavior fixed for 1.6 series (version detection is
1468       used to select default behavior).
1470     * A potential kernel panic during bulkstat operations is
1471       fixed. (128511)
1473     * 64-bit MacOS kernel performance is greatly improved. (128934)
1475     * Properly shut down AFS, closing the Rx socket in the upcall handler
1476       to avoid attempting to process data after we can no longer do so.
1478     * Rework logic for bulk status operations to avoid a potential hang.
1480     * Avoid panic when doing FSEvent synthesis.
1482     * Fix bug when using non-dynroot.
1484     * Update Kerberos support in PreferencesPane.
1486   NetBSD
1488     * Updates for platform support.
1490   OpenBSD
1492     * Bug fixes for issues introduced previously in 1.5 series.
1494     * Support through OpenBSD 4.8.
1496   Solaris
1498     * Switch to ioctl() syscall replacement for Solaris 11 since syscall
1499       65 is not safe.
1501     * Fix support for Solaris pre-10.
1503     * Corrected Solaris 11 startup script.
1505     * vcache mappings freed on shutdown to avoid panic.
1507     * Properly report errors for AFS system call callers.
1509     * Don't leave dangling function references if kernel extension fails
1510       to load.
1512     * Try harder to avoid deadlocks on file-larger-than-cache operations.
1514     * Avoid panic on shutdown when mount failed.
1517 OpenAFS 1.5.78 (2010-11-04)
1519   All platforms
1521     * Revisions to Rx to fix performance issues.
1523     * Make fs getfid behave consistently across all platforms. (128372)
1525     * Properly check IDs handed to pts when creating users or groups so
1526       useful error messages can be provided. (128343)
1528     * Correct byte order handling of port in afsconf_LookupServer for SRV
1529       records.
1531     * Force a full dump when releasing to a site which was previously
1532       marked "don't use", in case the previous clone was out of date.
1534   All server platforms
1536     * Demand salvage of attached volumes now correctly track attachment
1537       state.
1539     * Avoid a potential crash due to failure to hold a lock when attaching
1540       a volume fails.
1542   Microsoft Windows
1544     * Track SMB connections by SID rather than username.
1546     * Error write attempts to known-readonly volumes earlier.
1548     * Validate directory buffers to avoid potential crashes.
1550     * Handle VIO errors from bulkstatus.
1552     * Make PMTU discovery configurable and register error handlers for it.
1554   All UNIX client platforms
1556     * Use larger I/O sizes in memcache to improve performance.
1558     * Avoid potential alignment issues doing I/O for pioctl calls.
1560   FreeBSD
1562     * Avoid panicing if the listener process is not findable.
1564     * Avoid deadlock issues while performing lookups.
1566   Linux
1568     * Handle stale file handle errors for some cache partition types.
1570     * Avoid blocking with xvcache lock when attempting to free in-use
1571       vcaches.
1573     * Build fixes for older kernels.
1575     * Properly configure LWP to use ucontext() on platforms where it
1576       should.
1578     * Eliminate spurious errors from AFS system call returns. (126230)
1580   MacOS
1582     * Attempt to honor configured Kerberos defaults in Preferences Pane.
1585 OpenAFS 1.5.77 (2010-09-08)
1587   All platforms
1589     * Rx path MTU detection will terminate detection in cases where the
1590       minimum required packet size cannot be transferred.
1592     * vos dryrun mode now shows effects for syncvldb single volume case.
1594     * vos dryrun mode now shows "status after" for syncvldb and syncserv.
1596   All server platforms
1598     * RXAFS_GetStatistics64 now returns statistics properly.
1600   Microsoft Windows
1602     * Attempt to properly identify the local system SMB connection for
1603       token tracking.
1605     * Remap timeout and offline errors to proper NT RPC errors.
1607     * Properly fail over to other replicas on bulkstat IO errors.
1609     * Properly error delete-mode createfile if a file is set readonly.
1611     * Validate directory entry buffers to avoid crashing the service.
1613     * Log file modes properly.
1615     * Log cell name when logging server information.
1617   All UNIX client platforms
1619     * cacheout program for discarding callbacks is now built.
1621     * bulkstatus kernel locking is corrected to avoid a potential panic.
1623   Dragonfly BSD
1625     * userspace support update
1627   FreeBSD
1629     * Updated vnode locking for children returned via lookup().
1631     * Avoid file open undercount with needed calls to
1632       FakeOpen/FakeClose().
1634     * Use vnode_pager_setsize to properly track file size during kernel
1635       IO.
1637     * Update system call installation.
1639     * Fix shutdown of Rx kernel listener to avoid potential dereference
1640       after it's gone.
1642     * Avoid closing vnodes during vnode recycle.
1644     * Fix bogus call to FlushVS for vnode reclaims.
1646   Linux
1648     * Packaging updated for current configure options and built files.
1650     * Cache bypass now holds reference on pages during readpage.
1652     * s390x setgroups32 patching update.
1654   MacOS
1656     * DNS resolver is reinitialized on IP address change. (126440)
1659 OpenAFS 1.5.76 (2010-08-16)
1661   All platforms
1663     * Updates to build-time configuration.
1665     * Fix XDR support in Rx to match header definition.
1667     * vos status now shows transaction creation, not action creation.
1669     * Rx avoids reporting loopback adapters when listing interfaces.
1671   All server platforms
1673     * Demand-Attach Fileserver always built and installed (dafileserver,
1674       davolserver, dasalvager).
1676     * Return VNOVOL from fileserver when a volume is deleted.
1678     * Ignore duplicate tags during volume restore operation.
1680     * Update inode array after salvage repairs volume.
1682     * Zero a corrupted header in memory during salvage to avoid further
1683       corruption.
1685     * Fix NAMEI backend to allow low-numbered volumes to work properly.
1687     * ptserver does not include cell name as part of length check for
1688       names.
1690     * Updated error messages for unblessed volumes.
1692     * vlserver avoids buffer overflow with regex pattern
1694     * Attach-time failures now note failures as the rest of the fileserver
1695       would.
1697     * Server argument logging will no longer overflow stack.
1699     * Provide fast-restart-like unsafe-nosalvage option for DAFS.
1701     * Deal with host hash collisions in the fileserver.
1703   Microsoft Windows
1705     * Avoid crashing when interpreting a drive letter as potentially
1706       matching a cell name.
1708     * Properly handle volume package errors.
1710     * Allow page recycling from known-readonly content without ensuring
1711       they are not dirty.
1713     * 32 bit tools installer should not override client configuration.
1715     * Ensure root scache item has a valid callback when use is attempted.
1717     * Freelance directory changes now properly invalidate and replace the
1718       old root object.
1720   All UNIX client platforms
1722     * Support disconnected reconnecting with specified UID for PAGless
1723       platforms.
1725     * Proper disconnected vnode reference tracking.
1727     * Update server site blacklisting to not return success if nothing was
1728       blacklisted.
1730     * Avoid a panic during vcache contention due to CVInit vcache
1731       racing. (127645)
1733   FreeBSD
1735     * Update for network stack in 8.1/9.0.
1737   HP-UX
1739     * Bug fixes.
1741   Linux
1743     * 2.6.36 support
1745     * Disable PMTU error packet handling.
1747     * flock() fixes.
1749     * Debian packaging updated.
1751     * freezer interface updates.
1753   MacOS
1755     * Hold references to disconnected mode written vnodes properly.
1757   Solaris
1759     * Handle NFS translator module references for amd64.
1761     * INODE fileserver backend support now exists for amd64.
1764 OpenAFS 1.5.75 (2010-07-07)
1766   All platforms
1768     * Prevent rx_rpc_stats global lock from being a bottleneck.
1770     * Path MTU discovery is now provided to allow traffic to pass networks
1771       with sub-1500 byte MTUs and poor fragment handling.
1773     * Further reduce Rx NAT ping transmission when enabled.
1775     * Update Kerberos 5-based token handling in rxkad from upstream
1776       Heimdal.  (127554)
1778     * Update version numbers emitted during build to reflect what is
1779       actually being built.
1781     * Add "-human" switch for human-readable units in fs diskfree and
1782       listquota. (124529)
1784     * vos provides reasons for locked volumes when known.
1786     * Do not count retransmission and ping acks as non-idle for Rx
1787       connections.
1789     * Rx: provide service-specific data getter and setter routines.
1791     * Update build-time Kerberos detection.
1793     * Updated userspace AFS client.
1795     * Beginning of a modernized test suite.
1797     * Additional documentation.
1799     * Updated documentation, notably the Administrators Guide.
1801     * Substantial code cleanup.
1803   All server platforms
1805     * Update handling of vnode allocation failures.
1807     * DAFS: allow salvaging volumes not known to the fileserver, to allow
1808       cleanup of data not attached to a current volume.
1810     * Properly handle volumes slated for destruction.
1812     * Handle volumes with many files properly.
1814     * Force core file generation in bosserver by overriding default
1815       resource limits when possible.
1817     * Update vlclient and vldb_check.
1819     * Avoid potentially corrupting a volume on creation if files are left
1820       from previous failed cleanup.
1822     * Note volume changed during salvage as needed.
1824     * DAFS: do not assume invalid addresses are in fileserver address hash
1825       table.
1827     * Avoid tying up fileserver threads with volumes that are being taken
1828       offline.
1830     * Do not set inUse on volumes for non-DAFS other than in fileserver.
1832     * Break origin's callback on target of rename operation.
1834     * Avoid unneeded parent directory link updates during some rename
1835       operations.
1837     * Do not open /dev/console for writing in the fileserver.
1839     * DAFS: avoid spurious restarts when binary restarts are configured.
1841     * Avoid spurious and unneeded calls to sync(), which can slow down the
1842       fileserver.
1844   Microsoft Windows
1846     * Revised SMB QuerySecurityInfo to address issues caused by MS10-020
1847       (http://support.microsoft.com/kb/980232)
1849     * Prevent use of the AFSCache file contents if mapped to a new
1850       address.
1852     * Make fs newcell include behavior compatible with the non-Windows
1853       version.
1855     * Provide a registry option (FreelanceImportCellServDB) to pre-create
1856       mount points in the AFS root for all cells in CellServDB.
1858     * Fix a memory leak in the cm_FreeServerList() routine.
1860     * Reduce privilege when reading registry CellServDB.
1862     * Add support for RPC Pipe Service NetWkstaGetInfo levels needed for
1863       Windows 7.
1865     * Prevent overflow when computing quota percentage in Explorer Shell.
1866       (126846)
1868     * Generate meaningful errors for ACL operations on freelance AFS root.
1870     * Fix error handling on InlineBulkStatus RPCs.
1872     * Show configuration pages for all types of MSI installations.
1874     * Improve freemount AFS root directory handling and operations.
1876     * Properly validate GetVolumeStatus pioctl responses.
1878     * Commit file length changes and dirty buffers when flushing a file.
1880   All UNIX client platforms
1882     * Update version of files for disk cache.
1884     * Do not call afs_FlushVCBs with xvcache lock held, to improve
1885       parallelization.
1887     * Add mariner log messages for creating and removing files.
1889     * Don't hold xvcache lock while creating symlinks, to improve
1890       parallelization.
1892     * Provide -dynroot-sparse mode to not show all cells in CellServDB in
1893       dynroot mode.
1895     * Avoid a potential crash in aklog in linked cell handling.
1897     * Log MTU-caused packet retransmission.
1899     * Prevent crashes caused be fs checkservers while cache is being set
1900       up.
1902     * fs getserverprefs now has a buffer large enough for the default
1903       CellServDB.
1905     * Report server address when logging warnings.
1907     * Avoid panic in GetCapabilities when cell is not known.
1909     * Lock process name and id for advisory lock warnings when possible.
1911     * Handle need for allocating additional Rx packets.
1913     * Properly handle errors from InlineBulkStatus operations.
1915     * Fix errors returned from fcntl() on readonly files locked for write.
1917     * Flush pending changes to the server on LOCK_EX unlock.
1919     * Reflect length changes as a result of callbacks even when file is
1920       open for write.
1922     * Avoid hanging due to error exit when attempting to store a large
1923       file to a non-largefile fileserver.
1925     * Recover from afs_GetVolSlot errors.
1927   FreeBSD
1929     * Bugfixes for kernel VFS and network routines.
1931   IRIX
1933     * Provide makesname().
1935   Linux
1937     * Avoid syscall probes when keyrings are present, by default. (125215)
1939     * Remove "Big Kernel Lock" from VFS operations.
1941     * Use filehandles for all Linux 2.6 versions to avoid need for matched
1942       afsd. (127530)
1944     * Updated RPM packaging.
1946     * Fix dkms configuration provided with RPMs.
1948     * Hold reference on pages during background I/O for cache bypass.
1950     * Fix cache bypass handling of non-largefile fileservers.
1952     * Protect truncate_inode_pages mappings with mutex or semaphore as
1953       needed.
1955     * Fix pagevec use in cache bypass. (127505)
1957     * Updates for 2.6.35
1959   MacOS
1961     * Improve launchd configuration.
1963     * Avoid hanging on recursive cache file lock acquisition when user
1964       notification is enabled.
1966     * Fix and re-enable bulkstat mode.
1968   OpenBSD
1970     * Build updates.
1972   Solaris
1974     * Precluding unmount while AFS is busy.
1976     * Avoid deadlocking when releasing the VFS object.
1978     * Stop network interface poller in kernel on AFS shutdown.
1980     * Avoid issues with lookups on empty directory names. (127356)
1983 OpenAFS 1.5.74 (2010-04-22)
1985   All platforms
1987     * Add "vos setaddrs" command.
1989     * Rx library lock contention avoidance between rx_NewCall and
1990       rx_EndCall.
1992     * Rx library races due to inconsistent use of rx_connection
1993       conn_data_lock to protect the flags field.
1995     * Rx library inconsistent use of RX_CALL_TQ_WAIT which could result in
1996       deadlocks.
1998     * Rx library must signal transmit queue waiters when flushing.
2000     * afsmonitor shows busy counts now.
2002     * afsmonitor displays xstat callback statistics.
2004     * Provide expandgroups for pts mem on a supergroups server.
2006     * Provide supergroup option to liste nested groups during pts mem.
2008   All server platforms
2010     * Avoid volume lock contention during DAFS startup.
2012   Microsoft Windows
2014     * Avoid a race when updating cell vldb server lists that can result in
2015       a crash.
2017     * Avoid a deadlock when managing CM_SCACHESYNC_STOREDATA state
2018       operations for directory objects.
2020     * Add new Windows Application Event log messages for VBUSY,
2021       VRESTARTING, ALL_BUSY, ALL_OFFLINE, and ALL_DOWN.
2023     * Reduce lock contention by waiting for cm_buf_t I/O operations.
2025     * Split the cm_buf_t flags field to separate the flags that are
2026       protected by the cm_buf_t mutex from those protected by the
2027       buf_globalLock.
2029     * In cm_UpdateVolumeLocation, avoid searching for a ".readonly" volume
2030       on a numeric volume name.
2032     * File buffer allocations whose offsets are beyond server EOF should
2033       be locally allocated and zero filled.  The file server should not be
2034       issued a FetchData rpc which is guaranteed to fail.
2036     * Enable integrated logon to work with Windows 7/2008 when user logons
2037       are performed with a non-Domain Kerberos principal.
2039     * Add Protection Error messages to aklog output.
2041   All UNIX client platforms
2043     * Provide a FUSE-interfacing userspace afs client.
2045     * Updates to libuafs userspace cache manager.
2047     * Probe servers using GetCapabilities instead of GetTime, thus
2048       requiring fewer RPCs.
2050     * Fix DNS SRV record handling for cell lookup.
2052   FreeBSD
2054     * Fix sleep/wakeup routines.
2056     * Update for 8.0 release.
2058   Linux
2060     * Handle high memory addresses correctly.
2062   MacOS
2064     * Make 32 bit AFS syscalls work again.
2066     * Work around finder "Duplicate" failure (caused by setting modes on
2067       symlinks).
2069     * Disable bulkstat again (will be re-enabled at or before .75).
2071     * Provide symlink type hints during readdir.
2074 OpenAFS 1.5.73 (2010-03-24)
2076   All platforms
2078     * NAT keepalive support at Rx level.
2080     * Corrected SRV record support for cell name canonicalization.
2082   All server platforms
2084     * Fix volume callback notification to not notify unaffected clients.
2085       (126497)
2087     * Allow root directory recreation by salvager. (94658)
2089     * Numerous DAFS fixes.
2091     * Improvements to callback table overflow handling. (126451)
2093     * bosserver now shuts down cleanly on SIGTERM.
2095   Microsoft Windows
2097     * Prevent the Explorer Shell extension from crashing if symlink
2098       creation failed.  (126406)
2100     * A Rx level NAT ping has been implemented. A registry value enables.
2102     * Adds krb5 error message translation to aklog, afscreds,
2103       afslogon.dll, the network identity manager afs provider and
2104       translate_et.
2106     * Default mode bit settings for file and directory creation are now
2107       provided, and can be configured.
2109     * An SMB request trace facility is provided and can be enabled for
2110       debugging.
2112   All UNIX client platforms
2114     * Rx idle deadtime does not stop file writes.
2116     * Disconnected AFS no longer has a race condition during remove ops.
2118     * Fakestat avoids a condition which could cause it to block on network
2119       activity.
2121     * Several fixes to handle interruptions in vos operations. (33360,
2122       125535)
2124     * Allow more sysnames in a sysname list.
2126     * Attempt to enforce timeouts on AFSDB lookups.
2128   AIX
2130     * Clean up properly on mount failure.
2132     * Add entry to /etc/vfs to allow umount to work.
2134   Linux
2136     * Several issues to deal with older kernels.
2138     * Avoid leaking the global lock in the /proc cellservdb code.
2140     * Keyring destruction now cleans up all tokens.
2142     * Keyring quotas are not enforced against root.
2144   MacOS
2146     * Some FSEvents hinting for authentication events now done. (23781)
2148     * Update uninstaller. (125634)
2150     * Rewrite afssettings and fstab code to avoid licensing issue with
2151       APSL.
2153     * Growl client for user monitoring of AFS events included.
2155     * Properly support insert-only dropboxes.
2157     * Add bulkstat support.
2159     * Include support for moving in Finder across mount points.
2161     * Preferences Pane includes support for Kerberos 5 ticket renewal.
2164 OpenAFS 1.5.72 (2010-02-15)
2166   All platforms
2168     * Provide internationalization support in com_err.
2170     * Fix array length checking to avoid crashes when checking for a
2171       volume type based on name in vos.
2173   All server platforms
2175     * Provide backward compatible "-f" flag to salvager for force mode.
2177   Microsoft Windows
2179     * Restore use of DNS AFSDB and SRV records by kaserver clients.
2181   All UNIX client platforms
2183     * Fix client cache file truncation to not lose chunks when truncating
2184       a large file.
2186     * Ensure a cache writeback hook is installed in the client (bug from
2187       1.5.71).
2189     * Avoid spurious free memory warnings during clean shutdown.
2191     * Fakestat mode avoids AFSDB lookups.
2193     * "fs storebehind" now correctly reports errors on readonly volumes.
2195     * Additional documentation for "fs getcacheparms"
2197     * Forced new uuid generation with "fs uuid -generate" now works
2198       enforced permission correctly.
2200   MacOS
2202     * Add optimized Rx event handler in kernel.
2204     * Installer now allows installing an older version.
2206     * Panic decoder can now deal with MacOS 10.5 again.
2208     * MacOS ._ files are now correctly not looked up as cellnames.
2210   Linux
2212     * To deal with SELinux file labeling, try cache accesses with current
2213       credentials in event of failure.
2215     * Rx XDR encoding bug on i386 Linux is fixed (bug introduced in
2216       1.5.71).
2218   IRIX
2220     * Code compilation fixes.
2222   OpenBSD
2224     * Update for OpenBSD 4.6.
2227 OpenAFS 1.5.69 (2010-01-19)
2229   All platforms
2231     * Configuration of BOSserver no longer defaults to weekly restarts
2232       enabled.
2234     * Provide BOS restricted mode by default.
2236     * Add support for "vos endtrans" command.
2238     * Default to providing full output from vos listvol.
2240     * Correct additional-address tracking in the fileserver.
2242     * Improve Rx performance by not unnecessarily dropping and reacquiring
2243       call locks in read and write processes.
2245     * Avoid crashes when monitoring volserver transactions across
2246       potential transaction garbage collection.
2248     * Numerous warning fixes.
2250   All server platforms
2252     * Avoid saving fileserver state in demand attach fileserver when
2253       panicing.
2255     * Demand attach fileserver allows other callers to schedule salvages.
2257     * Demand attach "bos salvage" now works correctly with restricted
2258       mode.
2260   Microsoft Windows:
2262     * Numerous changes to the client-internal btree directory handling to
2263       prevent errors.
2265     * fs examine reports owner and group ids as signed values (PTS groups
2266       are negative).
2268     * Preclude corruption due to races writing to smb buffers.
2270     * Allow MTU settings in registry to be used.
2272     * Apply MTU to both send and receive sizes.
2274   All UNIX client platforms
2276     * Avoid double-freeing Rx call structure if reading a response from
2277       the file server results in a short read.
2279     * Handle negative lengths in FetchStatus results correctly.
2281     * Properly clean up allocated memory at shutdown.
2283     * Default to AFSDB compiled into the cache manager.
2285     * Avoid inadvertant disclosure of stat() information to clients not so
2286       entitled.
2288     * Correct a bug with AFSDB lookups introduced with SRV record support.
2290   MacOS
2292     * Install kernel panic processing tool in /Library/OpenAFS/Tools.
2294     * Include debugging symbols for kernel extension in additional package.
2296     * Support "Application Firewall" users.
2298     * Avoid ._cellname AFSDB lookups.
2300     * Compile preferences pane as a universal binary.
2302   Linux
2304     * Use splice to speed up storing files.
2306     * When using memcache, avoid duplicating work in readpages.
2308     * Use dget_parent to safely find an inode's parent.
2310     * Disable access time updates in our superblock.
2312     * Avoid crashing doing writeback if no credentials were stashed at
2313       file open.
2315     * Simplify keyring support.
2317     * Properly clean up vcache in event of failed mount.
2319   FreeBSD
2321     * Update for current FreeBSD 8.
2323   Solaris
2325     * Abstractly manipulate groups as now required.
2327     * Abstractly access time instead of using lbolt directly.
2330 OpenAFS 1.5.68 (2009-12-08)
2332   All platforms
2334     * aklog now attempts to convert non-AFS errors to human-readable
2335       strings.
2337     * Make stack not executable when compiling assembler source with GCC.
2339     * Numerous source warning cleanups and code reorganization.
2341   All server platforms
2343     * Compute midnight for volume statistics calculation from local time.
2345     * Salvager now orphans duplicate special inodes when running to allow
2346       recovery in event of a problem, instead of simply ignoring the
2347       issue.
2349     * Support to ensure a server panic attempt leaves a core and thus
2350       restarts in a timely manner, rather than potentially hanging. Use
2351       panic to attempt cleanup before leaving a core when possible.
2353     * Volume sync data reported during bulkstatus is now set correctly.
2355     * Provide better tuning for fileserver file descriptor caching.
2357     * Allow more than 128 threads in fileserver by modifying host
2358       structure in-use tracking.
2360     * Avoid crashes getting volume server status during transaction
2361       cleanup.
2363     * Improved logging of offline volume conditions.
2365     * Correct volume statistics when cloning a volume.
2367     * Avoid referencing host structures in the fileserver which are marked
2368       for deletion.
2370     * Demand attach fileserver corrections to avoid coring during an
2371       aborted startup.
2373     * host array bounds checking corrections to avoid buffer overflow.
2375     * Handle special inodes correctly when promoting an inode fileserver
2376       readonly volume to read-write.
2378   Microsoft Windows
2380     * Set the DOS Readonly attribute on a file/directory whenever the unix
2381       mode combined with the mask 0200 is true.  Previously there was a
2382       discrepency between the mask used for testing for readonly behavior
2383       and that used for setting the attribute.
2385     * Disable AFSVolSync based .readonly "whole-volume callback" support
2386       because the all file servers prior to 1.5.67 (and perhaps 1.4.12) do
2387       not properly assign a value to the AFSVolSync structure in bulk
2388       status RPC responses.
2390     * Improve the error output from aklog to output the value from krb5
2391       error_message() if the afs_com_err output indicates an unknown
2392       value.
2394     * Convert VBUSY and VRESTARTING to CM_ERROR_ALLBUSY and do not permit
2395       them to be exposed to the smb redirector.
2397     * Convert STATUS_TIMEOUT responses to STATUS_IO_TIMEOUT to avoid
2398       confusion within the smb redirector.
2400     * Fix the byte order assigned to port numbers associated with AFSDB
2401       record lookups.  They must be network byte order not host byte
2402       order.
2404     * Add dynamic server ranking based on RPC round trip time
2405       measurements.
2407   All UNIX client platforms
2409     * Additional shutdown-time memory leaks removed.
2411     * Improved logging of resource contention.
2413     * Provide dumping for Rx debug packet tracking support in source.
2415     * Update afscp test client to build, and provide an unlock client.
2417     * Client buffers for directory parsing can now be allocated beyond the
2418       fixed set formerly provided.
2420     * Work around race condition when manipulating read-only volume
2421       callbacks.
2423     * Bugfixes to get PAG value pioctl.
2425     * Bugfixes to SRV record support.
2427   Linux
2429     * Path MTU tracking code cleanup.
2431     * Avoid an oops due to racing with vcache recycling thread.
2433     * Changes to keyring PAG handling: for sufficiently new kernels, use
2434       only keyring-based PAGs, and disable group PAGs entirely.
2436     * Updates to the kernel page cache interface: writing pages will now
2437       not spuriously leak page locks, and will avoid requiring duplicate
2438       work.
2440     * Credential references are now tracked using native atomic counters.
2442     * Kernel mutex/semaphore lock ordering fix to avoid deadlocks.
2444     * Manipulate disk cache with credentials used to initialize it, to
2445       avoid security issues.
2447   MacOS
2449     * Fix fstrace message catalog location.
2451     * Fix kernel fstrace logging.
2454 OpenAFS 1.5.66 (2009-10-25)
2456   All platforms
2458     * Avoid calling exit() in library code.
2460     * Add rx window size and peer timeout tuning APIs.
2462     * Correct rx peer timeout handling to disallow 0ms timeouts.
2464     * Correct calculation of rx RTT by disregarding retransmitted packets.
2466     * vos manpages updated to reflect changes in recent versions.
2468     * GNU-style long options (e.g. --cell) are now supported in all
2469       commands.
2471     * fs listacl can now print a command to recreate the current ACL.
2473   All server platforms
2475     * Fix a race on transaction objects in the volserver which can cause a
2476       crash.
2478     * Avoid destroying and setting to NULL the callback connection when it
2479       could still be being used.
2481     * Correct unlink handling in salvager.
2483     * Improve error messages due to I/O errors in the volserver.
2485     * Correct an issue which caused converted RO to RW volumes on namei
2486       fileservers to not come online immediately.
2488   Microsoft Windows
2490     * Official support for Windows 7 and Server 2008 R2.
2492     * Prevent a file server bug (FetchData returning an invalid length
2493       instead of zero) from causing an "unexpected network error" when
2494       writing to files.
2496     * Promote DNS SRV records as superior to DNS AFSDB records.  Support
2497       arbitrary port numbers for vldb servers.
2499     * Add AFSVolSync based .readonly "whole-volume callback" support.
2500       With this functionality, multiple objects from a .readonly volume
2501       can have their status validated by issuing a single
2502       RXAFS_FetchStatus RPC.
2504     * Remove drive mapping functionality and service start/stop from
2505       afscreds.exe.
2507     * Remove drive mapping functionality from afs_config.exe.
2509     * Use {HKLM,HKCU}\SOFTWARE\OpenAFS\Client DWORD "ShowMountTab" to
2510       restore access to drive mapping functionality in afscreds.exe and
2511       afs_config.exe.
2513     * Adjust SMB error return codes to avoid returning STATUS_TIMEOUT
2514       which results in the SMB redirector disconnecting.
2516     * Network Identity Manager OpenAFS Provider now provides its own "AFS
2517       lock" notification icon to report the status of "have tokens, have
2518       no tokens, service not started, service started but inaccessible".
2519       Hovering over the icon lists the cells for which tokens exist (if
2520       any) and the OpenAFS version number.  Double-clicking executes the
2521       Network Identity Manager default action.
2523     * Prevent pioctl calls from retrying indefinitely when a sharing
2524       violation error occurs.
2526   All UNIX client platforms
2528     * Correct a condition which could discard the error from initializing
2529       a fetch request.
2531     * Avoid using invalid references to afs_Conn connection structures,
2532       and thus potentially producing invalid data when a retry is needed.
2534     * SRV records are now supported for discovering AFS servers.
2536   Linux
2538     * Correct writepage behavior.
2540     * Fix error code handling in the writepage code.
2542     * Avoid leaking page locks, which could potentially hang a machine.
2544   MacOS X
2546     * Preferences Pane improvements.
2548   HP-UX
2550     * Avoiding attempting to handle critical signals in servers, so that
2551       core file handling works correctly.
2554 OpenAFS 1.5.65 (2009-10-06)
2556   All platforms
2558     * Code compilation warning fixes, to enable better finding and
2559       tracking bugs.
2561     * Provide configure-time switch to enable code warning compilation.
2563   All server platforms
2565     * Demand-attach fileserver now makes volume LRU list operations
2566       exclusive operations to avoid races during adding to the list.
2568     * Fileservers now avoid potential "negative length" fetches.
2570     * A leak in host tracking objects in the fileserver has been fixed.
2572     * Salvager now unlinks all files by full path, to deal with the change
2573       to not chdir for core file tracking.
2575     * Salvager avoids asserting if the volume header is unreadable.
2577     * Demand-attach fileserver puts back volume references from fssync
2578       handlers when done.
2580   Microsoft Windows
2582     * Improved service response to suspend and shutdown event
2583       notifications.
2585     * Avoid a bug in the file server that can result in an invalid length
2586       being returned as part of a fetch data response if the client
2587       attempts to read beyond the length of the file.
2589     * Do not publish a default stream object for directories and mount
2590       point objects.  This was impacting the ability of some Windows XP
2591       systems to save roaming profiles.
2593   All UNIX client platforms
2595     * A bug which could cause erroneous handling of lengths on data reads
2596       has been fixed.
2598     * A bug where erroneous length returns from the fileserver could
2599       result in a false error has been fixed.
2601   Linux
2603     * Background page copies are now supported for enhanced disk cache
2604       read performance.
2606     * Blocking readahead is supported in readpages() to reduce overhead.
2608     * Use readpage() instead of read() to access cache data to avail disk
2609       cache users of the kernel backing cache for improved performance.
2611     * Minimize credential handling for improved performance.
2613   MacOS X
2615     * Preferences Pane cleanup.
2617   Solaris
2619     * Provide a fs_pathconf method with sensible defaults.
2621     * Provide a _PC_FILESIZEBITS method to fix some NFS translator
2622       consumers.
2625 OpenAFS 1.5.64 (2009-09-22)
2627   All server platforms
2629     * The demand attach fileserver now puts back volume references gotten
2630       via the fssync interface.
2632     * The demand attach fileserver had a structure reference error, which
2633       has been correected.
2635   Microsoft Windows
2637     * Restores Windows 2000 compatibility.
2639     * Fixes a data consistency error between the output of NetWkstaGetInfo
2640       and NetServerGetInfo RPCs, specify the Lan workstation group name
2641       "AFS", and report server name as "AFS" instead of "\\AFS" when the
2642       caller asks for "\\AFS".
2644     * Enables executables to be run from \\AFS on Windows 7.  Returns
2645       "Name not found" instead of "File not found" when a directory or
2646       file name cannot be found.  This avoids loader errors when system
2647       dlls cannot be located in the executable directory.
2649     * Prevents cache manager from marking the file server "down" when the
2650       data returned in response to either RXAFS_FetchData64 or
2651       RXAFS_StoreData64 is invalid.
2653     * Adds pioctl data validation to the AFS Explorer Shell extension.
2655   All UNIX client platforms
2657     * A bug which could cause a kernel panic in 1.5.63 has been corrected.
2658       This would manifest as a GetDCache panic or oops.
2660   Linux
2662     * aklog -setpag works again with recent kernels when keyring is in
2663       use.
2665   MacOS
2667     * When Fast User Switch is in use, AFS login is now handled correctly
2668       by the integration tool included with the preferences pane.
2670     * Several packaging bugs have been corrected.
2673 OpenAFS 1.5.63 (2009-09-11)
2675   All platforms
2677     * The restorevol command is now documented and installed as a user
2678       command.
2680     * The uss command now properly translates vldb entries to its expected
2681       format when handling them in all cases.
2683     * Documentation now refers to Kerberos instead of kaserver.
2685   All server platforms
2687     * bosserver now handles BosConfig.new when restarting, allowing
2688       configuration to be replaced at restart time rather than with bos
2689       delete and bos create.  Documentation is updated to reflect this.
2691     * The demand attach fileservice not longer potentially hangs trying to
2692       terminate demand-salvages which have already exited.
2694     * The demand attach fileservice has been modified to avoid spurious
2695       'SYNC_putRes: write failed' warnings when some protocol messages
2696       cannot be acknowledged due to the sender terminating the connection.
2698     * In the event of failure to contact the vlserver or ptserver, the
2699       fileserver will not exit and trigger a forced salvage. It will
2700       continue to try in the background to contact the needed services.
2702     * The salvager can now repair certain cases of a damamged vnode index.
2704     * The accessDate metadata for a volume is now updated correctly.
2706   Microsoft Windows
2708     * CRITICAL: Some applications for example those based on Cygwin were
2709       unable to access data stored in the AFS name space.  Explorer Shell
2710       also experienced inconsistent behavior.  This is fixed.
2712     * CRITICAL: Multiple AFS pioctl requests issued nearly simultaneously
2713       by applications could result in pioctl responses being received by
2714       the wrong requester.  This in turn could result in application
2715       crashes.  symlink.exe, fs.exe, afslogon.dll, afscreds.exe, and the
2716       netidmgr afscred.dll plugin were all affected.
2718     * Some XP machines running 1.5.62 had trouble saving roaming profile
2719       data.  This is fixed.
2721     * Integrated Logon (afslogon.dll) did not function with domain
2722       specific configurations.
2724     * Ensure that access denied and over quota errors experienced while
2725       storing data to the file server do not result in on-going retry
2726       attempts.
2728   All UNIX client platforms
2730     * Except on Solaris and AIX, the compiler may now be overriden at
2731       configure time by setting the CC environment variable.
2733     * afsd now properly deals with large cache partitions.
2735   FreeBSD
2737     * Build shared libafsauthent and libafsrpc.
2739   Linux
2741     * Kernel module DKMS support now installs an unstripped module to
2742       allow debugging information to be collected.
2744   MacOS
2746     * Preferences pane properly updates token information.
2748   MacOS 10.6
2750     * klog will now properly handle passwords of 8 or fewer characters
2751       with an AFS string to key on hosts able to run 64 bit binaries.
2753     * A panic at AFS shutdown due to "NO PCB" on a udp_lock has been
2754       addressed.
2756     * The panic decoder script included in the source now properly handles
2757       32 and 64 bit panics.
2759   NetBSD
2761     * Avoid defining AFS_KERBEROS_ENV globally as it creates a circular
2762       dependency.
2764     * Build shared libafsauthent and libafsrpc.
2766   OpenBSD
2768     * Build shared libafsauthent and libafsrpc.
2771 OpenAFS 1.5.62 (2009-08-28)
2773   All platforms
2775     * Numerous invisible changes to improve code maintainability,
2776       portability and enhanceability.
2778   Microsoft Windows
2780     * CRITICAL: Fixes two errors that can result in data loss when storing
2781       data to the file server.
2782       1. Failure to Store Portions of Unaligned Writes
2783       2. Failure to Store Data to File Servers Lacking Large File Support
2784       Read the announcement for more details:
2785         http://www.openafs.org/pipermail/openafs-announce/2009/000305.html
2787     * CRITICAL: The cache manager daemon thread could terminate when the
2788       machine enters suspend mode.  This daemon thread performs the
2789       background check of down servers, offline volumes, callback
2790       expirations, etc.
2792     * CRITICAL: Integrated Logon (afslogon.dll) was terminating
2793       unexpectedly.  Error checking has been improved and NULL pointer
2794       dereferences after Lsa API calls fail have been eliminated.
2796     * For the first time, the OpenAFS SMB Server supports the DCE RPC
2797       services SRVSVC and WKSSVC.  Browsing \\AFS with the Explorer Shell
2798       or NET VIEW will now be faster and provide additional functionality.
2799       No longer will cell names longer than 12 characters be truncated.
2801     * Improvements to DFS Referral request processing have been
2802       implemented.
2804     * Unnecessary DNS lookups of share names are avoided improving
2805       performance.
2807   All UNIX client platforms
2809     * Non-Kerberos PAM modules work correctly again.
2811   MacOS X
2813     * MacOS 10.6 (Snowleopard) is now supported, both 32 and 64 bit mode.
2815     * Updates to the AFSCommander preferences pane.
2817     * Installer now permits cell names with dashes.
2820 OpenAFS 1.5.61 (2009-08-06)
2822   All platforms
2824     * Correct another race condition in the Rx library that could result
2825       in an unexpected panic while freeing the Rx call iovq.
2827     * rx packet resend and data packets sent counts were incorrect.
2829     * fs setquota, fs setcachesize, vos setfields, and vos create now
2830       accept human readable orders of magnitude. (K, M, G)
2832     * fs listquota fixed to permit large quota sizes to be displayed.
2834     * Correct documentation of bosserver permissions requirements.
2836     * Modify vlserver to avoid potentially corrupting the database through
2837       volume id reuse.
2839     * Generalized support for fast Rx timeout due to network
2840       down/unreachable.
2842   All server platforms
2844     * Allow audit logs to be sent via sys5 IPC message queues instead of
2845       logged directly.
2847   Microsoft Windows
2849     * If a file server becomes inaccessible while the cache manager has
2850       dirty buffers to write, the afsd_service buf_IncrSync thread can
2851       attempt to use 100% of the cpu.
2853     * Fix "fs newcell" which was broken in 1.5.60.
2855     * Do not attempt to synchronize dirty buffers if the associated volume
2856       is known to be unavailable.
2858     * Modify behavior of a Freelance mountpoint target that does not
2859       specify a cell.  Instead of assuming the target volume is in the
2860       Freelance.Local cell, use the workstation "Cell" specified in the
2861       registry. A mountpoint target of "#root.cell." will now mean the
2862       root.cell volume in the workstation cell for the current session.
2863       If the workstation cell changes from "athena.mit.edu" to
2864       "andrew.cmu.edu", the referenced volume will also change without
2865       requiring that the mount point targets be altered.
2867     * Add cm_FindServerByUuid().  Re-implement RXAFS_InitCallBackState3()
2868       to permit the server Uuid to be used to lookup the server object and
2869       from that determine the cell.  This permits callbacks that are
2870       received from alternate addresses to be processed with a known
2871       server object.  Previously a request from an unknown server would
2872       clear all callbacks from all cells.
2874     * Fix a bug that prevented optimal performance when using a non-zero
2875       value for 'daemonCheckVolCBInterval'.  As a reminder, when
2876       "daemonCheckVolCBInterval" is set to a non-zero value, all .readonly
2877       volume callbacks are automatically renewed 90 minutes before their
2878       expiration.
2880     * Fix automatic ranking of vldb servers whose values are obtained from
2881       the CellServDB file.
2883     * Add failover for RX CALL TIMEOUT errors when the volume is readonly
2884       or the call is to a vldb server.
2886     * Add registry based cell search functionality to NetIdMgr,
2887       afs_config.exe, and klog.exe.
2889     * afsconf_GetCellInfo() has been modified to perform gethostbyname()
2890       lookups on the host names in the CellServDB instead of using the
2891       specified IP addresses.  This provides aklog, pts, vos, etc. the
2892       same CellServDB behavior that the Windows Cache Manager uses.
2894     * When updating the stat cache entry callback of a .readonly object
2895       from the volume group object, update the file server reference to
2896       ensure it matches the most update to date callback.
2898     * Add proper support for processing callbacks from multi-homed file
2899       servers.  Instead of comparing servers by cm_server_t pointer,
2900       compare them by UUID when the UUID is known.
2902     * During a shutdown short circuit the offline volume check daemon
2903       functionality.
2905     * Return the error code of RXAFS_FetchData / RXAFS_StoreData in
2906       preference to an error code reported by rx_EndCall.
2908     * Add "PerFileAccessCheck" registry value to permit testing against
2909       experimental file servers that include per-file acl support.  This
2910       value is intentionally undocumented.  It is not to be used by
2911       production environment deployments.
2913     * Fix a bug introduced in 1.5.60 that prevents the afs netidmgr
2914       provider from obtaining tokens when referrals are in play.
2916     * Add "fs chown" and "fs chgrp" commands to permit the owner and group
2917       of objects stored in AFS to be set from Windows.
2919     * Avoid performing background daemon operations when the machine is
2920       going into suspend mode.
2922     * Perform offline volume checks in most recently used order.
2924     * Prevent crash when a data version for a cache object goes backwards.
2926     * Multi-thread safe library versions are now being generated and used.
2927       mtafsubik.lib, mtafsutil.lib, mtafsvldb.lib, mtafsvol.lib.
2929     * Microsoft SMB Redirector (mrxsmb.sys) support for
2930       ExtendedSessTimeout values are now available on XP through Windows
2931       7.  Add functionality to autodetect if such support is present on
2932       the machine.  If so, configure it if necessary and dynamically
2933       adjust the AFS Rx timeout values accordingly.
2935   All UNIX client platforms
2937     * Fix out-of-tree source builds.
2939   MacOS
2941     * GUI installer now asks for local cell information.
2943     * AFS Commander preferences pane is now installed by default.
2945   Solaris
2947     * Avoid kernel panics due to null pointer dereferences in the network
2948       interface poller kernel thread.
2951 OpenAFS 1.5.60 (2009-05-31)
2953   All platforms
2955     * Retry volserver transaction creation on failure.
2957     * Allow building HTML and PDF documentation from included XML copies
2958       of User Guide, Admin Guide and Quick Start Guide for Unix.
2960     * Documentation updates and additional documentation.
2962     * Add -encrypt support to pts client.
2964     * Convert MR-AFS fs commands to OSD commands.
2966   All server platforms
2968     * Updated background sync process in fileserver to avoid a race which
2969       could result in a volume being taken offline.
2971   Microsoft Windows
2973     * On April 9th Microsoft released a Hot Fix for Windows Server 2003
2974       SP2 that corrects a deadlock in the smb redirector and also adds new
2975       functionality that permits the AFS SMB server to be given a longer
2976       timeout than is normally the case.  New functionality has been added
2977       to configure these additional LanmanWorkstation\Parameter values.
2978       (This functionality has been backported to XP SP3 and is scheduled
2979       to be released on June 5th.)
2981     * Fix RT#124787, a race condition between "fs flush <dir>", "fs
2982       flushvolume", or "fs flushall" and on-going directory operations
2983       that can result in afsd_service.exe crashing.
2985     * Release Notes, User and Administrator guides are now shipped as
2986       indexed Windows HtmlHelp Files. (.chm).  Shortcuts are provided from
2987       the Start Menu.
2989     * A method of specifying Client CellServDB information within the
2990       registry has been added that can be used to either override the
2991       CellServDB file or force the use of DNS lookups for a given cell.
2992       See the release notes for details.
2994     * The pioctl interface now properly handles drive letter substitution
2995       to UNC paths.  (SUBST <d:> <\\afs\cell\path>)
2997     * The BackConnectionHostNames registry value configuration was broken
2998       when dynamic re-establishment of Netbios Name registrations was
2999       added.  This release restores the functionality.
3001     * All hidden vos.exe commands are now revealed.
3003     * Attempts to store the same dirty file chunk from multiple threads
3004       are now prevented.
3006     * The IsPathInAfs test in Explorer Shell Extension and fs.exe now
3007       permits broken symlinks to be treated as being in AFS.
3009     * vos.exe commands that output 64-bit integer values once again do so.
3010       This was broken in 1.5.59.
3012     * Cygwin Import Libraries are provided in the SDK for all OpenAFS
3013       DLLs.  This permits building cygwin applications against OpenAFS
3014       libraries.
3016     * NSIS installer does a much better job of cleaning up files left over
3017       from previous installs.
3019     * libafsconf.dll moved from Client\Program to Common directory as is
3020       is now used by all modules for CellServDB processing.
3022   All UNIX client platforms
3024     * Write back changes on last store for memcache to avoid discarding
3025       changes.
3027     * Abstract disk cache support to allow for path, fh, inode based
3028       caches with no need for messy ifdef structures each time a new type
3029       is added.
3031   DragonflyBSD
3033     * Support as a userland port.
3035   FreeBSD
3037     * Corrected structure definition for userspace cache manager to allow
3038       builds to complete.
3040   Linux
3042     * Corrected client locking support.
3044     * Updated patch to stop deadlocking in the kernel during mmap.
3046     * Avoid oops when setting up groups for PAGs to match keyrings.
3048     * Use Linux fh-based cache in cases where possible by default.
3050   MacOS 10.3:
3052     * Corrected structure definition for userspace cache manager to allow
3053       builds to complete.
3055   OpenBSD
3057     * Support for OpenBSD 4.5.
3059   Solaris
3061     * Corrected support for server-side vos split interface.
3064 OpenAFS 1.5.59 (2009-04-06)
3066   Microsoft Windows
3068     * Increased service priority class to "High" to match the priority of
3069       system components that are dependent upon the a timely response.
3071     * SMB error responses avoid returning errors that could confuse the
3072       Microsoft SMB redirector into disconnecting the connection to \\AFS.
3074   All UNIX client platforms (except MacOS X 10.4 and 10.5)
3076     * OpenAFS 1.5.59 contains fixes for the client issues addressed by the
3077       security advisories OPENAFS-SA-2009-001 and OPENAFS-SA-2009-002.
3079   Linux platforms
3081     * Support for prerelease Linux 2.6.30 kernels.
3084 OpenAFS 1.5.58 (2009-03-30)
3086   All platforms
3088     * Code cleanup and prototyping.
3090     * Avoid unnecessary blocking in Rx periodic cleanup code.
3092   All server platforms
3094     * Fileserver CopyOnWrite routine optimized for performance.
3096     * Make fileserver callback dumps 64 bit safe.
3098     * Fix byte order issues with fileserver host hashing.
3100     * Fix buffer size issues with butc.
3102     * Fix several Ubik recovery issues.
3104     * Avoid leaking file references in the fileserver.
3106     * Fix a race in DAFS while closing vnodes, and another offlining
3107       volumes.
3109     * volserver interfaces for volume splitting client.
3111   Microsoft Windows
3113     * [RT 124293] A race condition exists which can result in a crash.
3115     * [RT 124276] If the vldb is out of sync with the contents of the file
3116       servers, afsd_service will retry too many times when a file server
3117       reports a volume as not being present.  Now if the list reported by
3118       the vldb is the same as the previously seen list, then the retry is
3119       aborted.
3121     * [RT 124276] Read-only volume failover was broken in 1.5.53 whenever
3122       accessing a volume results in VNOVOL or VMOVED.
3124     * [RT 124276] Prior to 1.3.70 the volume server reference list was not
3125       reference counted and would be prematurely freed while in use.  When
3126       reference counting was added in 1.3.70 a bug was introduced that
3127       could result in service reference list corruption.
3129     * Add Windows Application Event Log warning messages for "Client SMB
3130       MPX value too large" and "Client SMB Buffer Size too small".
3132     * Renaming of files across directory boundaries would result in an
3133       invalid handle error when attempting to access the files after the
3134       move.
3136     * Fix the handling of Tran2 Set Path Info RPCs.  Do not fail when a
3137       smb file descriptor cannot be found.  The whole point of using a
3138       Path Info function is because an smb file descriptor wasn't
3139       allocated.
3141     * More edge cases in which dynamic addition of Freelance root.afs
3142       entries would get the wrong FID or where the root.afs directory
3143       would not be refreshed.
3145     * Buffer overflow could occur if the workstation cell name was longer
3146       than 64 characters.  Crashes could occur in afscreds.exe,
3147       afslogon.dll, and afsd_service.exe.
3149     * VNOSERVICE and VOFFLINE errors were leaking and were exposed to the
3150       smb client.
3152     * Log file server uuid values as part of the cm_server object when
3153       available.  Dump the cm_server object list in response to "fs
3154       memdump".
3156     * Optimize the performance of resetting access control lists when
3157       tokens are set or removed.
3159     * Remove symlink recursion tests and increase max symlink count to 64
3160       from 16.
3162     * Windows specific Rx performance improvements.
3164     * Support for Network Identity Manager 2.0
3166   All UNIX client platforms
3168     * Avoid issues with freeing resources at shutdown.
3170     * Numerous fixes to disconnected AFS.
3172     * Disconnected AFS fixes for replaying changes without double-freeing.
3174     * Attempt to use krb524 principal conversion in aklog if available.
3176   AIX
3178     * Kerberos configuration at build time corrected.
3180   Linux
3182     * Default to dynamic allocation of AFS kernel cache entries to allow
3183       growth for inotify()-pinned entries. (beagle, famd, etc)
3185     * Change client truncation routines to avoid locking issues.
3187     * IA64 port clients fixed on Linux 2.6.
3189     * RPMs now install fstrace message catalog.
3191     * Support through kernel 2.6.29 tested.
3193     * Fix locking issues on CellServDB file in /proc.
3195   OpenBSD
3197     * Support OpenBSD 4.4
3200 OpenAFS 1.5.57 (2009-01-23)
3202   All platforms
3204     * Conditional compilation of rxdebug support is now possible.
3206     * Documentation updates.
3208     * Further race connditions in Rx have been corrected.
3210   All server platforms
3212     * Salvager no longer attempts to recreate headers in the wrong
3213       partition.
3215     * Volumes are properly marked in use on creation and subsequently on
3216       examination with vos.
3218   Microsoft Windows
3220     * Undo the "UAC manifest fix" applied to afs_config.exe.
3222     * Ensure that Freelance allocation of vnodes follow the AFS convention
3223       of odd vnodes are directories and everything else is an even vnode.
3225     * Add Freelance logic to mount point and symlink evaluation functions.
3227     * Enhance smb_ParseASCIIBlock() so that it can handle all of the
3228       STRING formats defined by the CIFS Technical Report 1.0.
3230     * Validate the output of smb_ParseASCIIBlock() in all callers.  Return
3231       CM_ERROR_BADSMB if the STRING field cannot be parsed.
3232       CM_ERROR_BADSMB will cause the contents of the packet to be logged.
3234     * If multiple SMB Raw Write operations were taking place at the same
3235       time, there could be data corruption because unique event objects
3236       were not generated for each Netbios receive operation.
3238   All UNIX client platforms
3240     * Userspace AFS library can now deal with large files when supported
3241       by the platform.
3243     * Numerous updates to disconnected AFS support, including changes to
3244       allow reconnection to work in more circumstances.
3246   FreeBSD
3248     * FreeBSD unstrategy code has been updated.
3250   Linux
3252     * A race during file truncation has been corrected.
3254     * System call probing routines have been updated.
3256     * 2.6.29 is now supported.
3258   MacOS
3260     * 10.3 support has been corrected.
3262   OpenBSD
3264     * Initial OpenBSD 4.4 support.
3266   Solaris
3268     * Updates to allow compiling on newer OpenSolaris are now included.
3271 OpenAFS 1.5.56 (2008-12-30)
3273   All platforms
3275     * libuafs (userspace cache manager) updated to correct several errors.
3277     * Additional rx debugging support is available as a conditional
3278       compile.
3280     * A race condition in Rx leading to a panic has been corrected.
3282     * Rx idle time tracking has been corrected.
3284     * ubik clone server support has been corrected.
3286   All server platforms
3288     * Salvager no longer leaves cores in vice partitions.
3290     * The vol-dump tool now supports dumps larger than 2gb where possible.
3292     * Operations on multiple files now report all FIDs in the audit log.
3294     * butc XBSA support now works correctly on amd64.
3296   Microsoft Windows
3298     * The NetIDMgr AFS Provider automated configuration logic was broken
3299       by the introduction of Kerberos referrals.  If the realm of the
3300       identity cannot be determined, the workstation cell is now assumed
3301       to belong to the newly created identity.
3303     * Avoid a reference count under flow during rename operations.
3305     * Avoid a crash caused by treating an arbitrary length directory
3306       search mask as an 8.3 mask.
3308     * Prevent rename operations if a case insensitive match for the target
3309       name already exists and does not refer to the object being renamed.
3311     * Increase the maximum number of background daemons to 64.
3313     * Fix the UAC manifest applied to afs_config.exe
3315   All UNIX client platforms
3317     * Updates to disconnected AFS support.
3319   FreeBSD
3321     * FreeBSD 7.1 is now supported.
3323     * amd64 FreeBSD is now supported.
3325   Linux
3327     * Generic fh (exportfs API) cache type is now available.
3329     * Avoid some oopses due to backing_dev_info inode fields not being
3330       filled.
3332     * 2.6.28 is now supported.
3334   MacOS
3336     * 10.3 support has been corrected.
3338   Solaris
3340     * Large partition support has been corrected.
3342     * Filesystem-agnostic cache is now available on Solaris 10 and 11.
3345 OpenAFS 1.5.55 (2009-11-10)
3347   All platforms
3349     * Salvager avoids leaving core files in vice partitions.
3351     * NFS translator fixes.
3353     * Unresponsive server handling fixes.
3355     * A volserver race which could result in duplicate transactions is
3356       fixed.
3358   Microsoft Windows
3360     * Fixes a panic caused by corruption of the SMB virtual circuit list.
3361       (race condition)
3363     * Fixes a panic caused by receipt of a UTF-16 string that cannot be
3364       converted to UTF-8.
3366     * Implements a more aggressive recovery algorithm for Netbios errors
3367       that result in loss of communication to the AFS SMB server.
3369     * Improve pioctl response time when testing whether or not a PATH is
3370       in AFS.
3372     * Adds support for linked cells.
3374     * Increases the length of the cell and realm names that can be input
3375       into the Network Identity Manage AFS provider configuration dialog.
3377   All UNIX client platforms
3379     * Disconnected AFS avoids infinite recursion during rmdir.
3381   Linux
3383     * Support for 2.6.28 (not complete for NFS translator modules).
3385     * Support for using exportfs API for filesystem-agnostic cache.
3387     * Disable backing store readahead.
3389     * Avoid deadlocks when writing back mmapped files larger than the
3390       cache.
3392     * Avoid Oops when doing PAG garbage collection.
3395 OpenAFS 1.5.54 (2008-10-08)
3397   All platforms
3399     * Updates for new Tivoli X/Open API finding.
3401     * A double-free is corrected in Rx.
3403   All server platforms
3405     * Ubik cleans up file descriptor cache correctly when doing recovery.
3407     * Enhanced vldb error checker included.
3409   Microsoft Windows
3411     * Prevent a crash that could occur when multiple file / directory
3412       change notifications are processed simultaneously.
3414   MacOS
3416     * AFS claims more free space so Finder will attempt file copies.
3418   Linux
3420     * Avoid spurious ENOENT when calling gwtcwd() on a volume root.
3422     * Avoid spurious ENOTDIR during fakestat.
3425 OpenAFS 1.5.53 (2008-09-26)
3427   All platforms
3429     * rx avoids many packet leaks.
3431     * rx jumbogram disabling now works (and is the default).
3433   All server platforms
3435     * Demand Attach fileserver tries to avoid issues tracking offline
3436       status of volumes.
3438   Microsoft Windows
3440     * Many potential deadlock conditions due to out of order lock
3441       acquisitions have been corrected.
3443     * A race condition resulting in an undercount on the cm_scache_t
3444       reference counts has been corrected.
3446     * An empty string when sent as an ioctl path is now properly
3447       interpreted as meaning the current directory.  This affects "fs
3448       lsm", "symlink list", etc.
3450     * Fix smb string parsing differences where the smb protocol
3451       documentation does not match the actual Windows implementation.
3453     * Random access denied errors fixed.
3455     * A file server lock synchronization issue was corrected in SMB
3456       NTCreateX and NTTranCreate operations.  This bug prevented properly
3457       operation when loading roaming profiles.
3459     * Fix a heap overwrite error during server probe operations if a new
3460       server is added while a probe operation is in progress.
3462     * Fix an LSA memory leak that was the result of an LSA error.
3464     * Do not leak cm_cell_t objects if the VLDB server lookup fails.
3466     * Only initialize rx mutex/lock objects once.
3468     * Do not nul terminate the AFS volume name when reported to Windows.
3470     * Improve VNOVOL error handling.  Prevent updated vl information from
3471       being destroyed immediately after it was acquired.  This bug
3472       prevented proper fail over when volumes are moved or removed from a
3473       server.
3475     * Remove volume id from the server volume list in response to VMOVED
3476       and VNOVOL errors.
3478     * "fs flushXXX" commands now destroy locally built B+ directory trees.
3480     * Prevent mixture of locally modified directory pages and file server
3481       directory pages.
3483     * Fail over to alternate vl servers if a ubik error is returned.
3485   All UNIX client platforms
3487     * Disconnected AFS now supports read-write mode.
3489     * volserver now builds correctly.
3491   AIX
3493     * AIX 6 is now supported.
3495   FreeBSD
3497     * FreeBSD 7 is now supported.
3499   Linux
3501     * cache bypass is now supported.
3503     * 2.6.x kmod compilation now uses kernel compile options always.
3505     * Support through 2.6.27.
3507   MacOS
3509     * Show more space free so Finder doesn't get confused.
3511   Solaris 10
3513     * Default to namei rather than inode.
3516 OpenAFS 1.5.52 (2008-08-18)
3518   All platforms
3520     * Initialize volume updateDate at volume creation.
3522     * Avoid potential corruption of directories during salvage.
3524     * Check for out of memory condition during allocation of additional Rx
3525       packets.
3527   Microsoft Windows
3529     * Restore support for Windows 2000 (broken in 1.5.50).
3531     * Perform additional validation on volume names in mount points during
3532       creation and evaluation.
3534     * Fix several deadlocks, races, and reference count issues.
3536     * Further optimize SMB Directory Search processing and minimize the
3537       number of InlineBulkStatus RPCs sent to the file server.
3539     * Enable "bos restricted" operations.
3541     * Fix the create of submounts used by the AFSCreds and afs_config
3542       drive mapping tabs.
3544     * Fix a short name truncation bug. (1.5.50)
3546     * Fix the error code reported when attempting to delete a file on a
3547       readonly volume or one that is marked with the readonly DOS
3548       attribute.
3550     * Fix a heap corruption error when reading the CellServDB file
3551       location.
3553     * Add the "RxUdpBufSize" registry value.  The new default is 256KB.
3555     * Do not include trailing NULs in the directory search output.
3556       (1.5.50)
3558     * Pre-allocate 64 Rx Packet buffers per thread in order to improve
3559       performance.
3561     * For debugging: add smb lock requests and stat cache lock allocations
3562       to the output from "fs memdump".
3564   NetBSD
3566     * Workaround broken sigwait() to allow fileserver to shut down
3567       correctly pre NetBSD 5.0.
3569   Solaris 10
3571     * Default to namei fileserver; Allow inode fileserver at configure
3572       time by override.
3574   NFS translator
3576     * Try harder to avoid kernel panics for malformed requests.
3579 OpenAFS 1.5.51 (2008-07-29)
3581   All platforms
3583     * salvager tries harder to arrange for clients to get VBUSY while
3584       salvaging single volumes.
3586     * salvager avoids certain corruption when salvaging directories.
3588     * Rx connection clones disabled.
3590   Microsoft Windows
3592     * The 32-bit EXE 1.5.50 installer failed to properly install the C
3593       Runtime library.  When used as an upgrade OpenAFS would continue to
3594       work but when used as a new installation, OpenAFS binaries would
3595       fail to load.
3597     * Fixes the "fs" and "symlink" commands to properly parse Unicode path
3598       prefixes during the pioctl remote procedure call.  This bug would
3599       result in file not found errors for files and directories that
3600       clearly exist.  (Bug introduced in 1.5.50)
3602     * Large File support is disabled. (Bug introduced in 1.5.50)
3604     * Removes the possibility of a deadlock during volume location update
3605       operation if all of the reported file servers are unreachable at the
3606       time of the update.
3608     * Ensures that reference counts are properly incremented/decremented
3609       on Rx connection objects used for volume location RPCs.
3611     * Over Quota errors during cm_FSync() calls would lead to an infinite
3612       loop as the error was never propagated to the caller.
3614   All UNIX client platforms
3616     * Bugfixes to disconnected AFS support in the cache manager.
3619 OpenAFS 1.5.50 (2008-07-16)
3621   All platforms
3623     * volserver puts recloned volumes back online before returning the
3624       volume to the fileserver, avoiding spurious VNOVOL errors.
3626     * Updated TSM X/Open API support available.
3628     * Demand Attach fileserver will not crash due to accesses during
3629       volume cloning.
3631     * Substantial documentation updates.
3633     * Demand Attach fileserver state tracking and analyzer tool
3634       improvements.
3636     * UAFS userspace cachemanager updates.
3638     * Corrected support for anti-meltdown protection in the client.
3640   Microsoft Windows
3642     * UNICODE Character Set Support.
3644     * Pioctl interfaces to the cache manager have been refactored to
3645       provide layering between the SMB specific code and the general
3646       purpose ioctl operation.
3648     * Garbage collect dead SMB virtual circuits as soon as they are no
3649       longer being referenced.  This avoids problems with outstanding
3650       locks not being dropped when the virtual circuit becomes invalid.
3652     * Remove the IBM Administration Reference documentation and replace it
3653       with the OpenAFS Command Reference Manual.
3655     * Avoid calling rx_SetDeadTime and rx_SetHardDeadTime functions each
3656       time a connection is about to be used.  Do not hold a lock on the rx
3657       connection object while it is being selected.  This avoids a race
3658       between threads attempting to set the timeout values and removes a
3659       bottleneck that was hampering performance.
3661     * Ensure that the smb directory attribute is set for all directory
3662       objects.
3664     * Replace the VC Runtime EXE installer with the MSI installer in the
3665       NSIS installer scripts.
3667   Solaris
3669     * Support for updates to OpenSolaris.
3671   Linux
3673     * Correct dentry revalidation for cross-directory renames.
3675     * Updated rpm packaging materials for 1.5 release series and 2.4
3676       kernels.
3678     * Corrected syscall table probing.
3680     * NFS translator updates for current kernels.
3683 OpenAFS 1.5.39 (2008-06-24)
3685   All platforms
3687     * Updates for Demand Attach fileserver.
3689   Microsoft Windows
3691     * Fix two memory leaks.
3693     * Fix one missing lock.
3695     * Handle access denied errors when writing dirty buffers.
3697     * Fix two errors that would cause the *experimental* AFS Servers
3698       to crash.
3701 OpenAFS 1.5.38 (2008-05-24)
3703   All platforms
3705     * Add read-only disconnected support.
3708 OpenAFS 1.5.37 (2008-05-21)
3710   All platforms
3712     * Includes a number of optimizations for testing.
3715 OpenAFS 1.5.36 (2008-05-09)
3717   All platforms
3719     * Rx optimizations now attempt to deal with high latency WANs.
3721     * Client will not wait infinitely for a server which is not providing
3722       data.  Additional servers will be polled without marking the server
3723       which is not providing data down.
3725     * vos move will not erroneously unlock locked vldb entries on failure.
3727   All server platforms
3729     * Fileserver avoids a potential infinite loop when a client
3730       relinquishes an address.
3732     * Fileserver large setting now configures more threads.
3734     * Fileserver properly registers uuids of new clients.
3736     * Ubik servers do not improperly hide updates from clients.
3738     * Fileservers reserve enough file descriptors such that each thread
3739       can cache one to avoid spurious errors.
3741   Microsoft Windows
3743     * Fix a cm_buf_t reference count leak when attempts to write dirty
3744       buffers to the file server from within cm_IncrSyncer() fail.
3746     * Prevent udebug from crashing.
3748     * Another VNOVNODE issue fixed.  When writing a dirty buffer to the
3749       file server, if VNOVNODE is received, mark all buffers as invalid
3750       without further attempts to contact the file server.
3753 =======> Changes back to 1.3 have not yet been incorporated here <=======
3756 OpenAFS 1.3
3758   * -nosettime is now the default for afsd.  Use "-settime" to get the
3759     old behavior.
3761   * OpenBSD is now supported.
3763   * Mountpoint directory information is now only faked for cross-cell
3764     mountpoints when using the -fakestat flag (e.g. for the directories
3765     under /afs, but not for most other volumes mounted inside the cell).
3766     The -fakestat-all switch can be used to fake information for all
3767     mountpoints.
3769   * When fakestat is enabled on MacOSX, the Finder can be used to browse
3770     a fully-populated /afs directory.  However, this precludes reliable
3771     use of entire volumes as MacOS bundles (i.e. containing a Contents
3772     directory in the root of the volume).
3774   * Mountpoint directory information can be faked by the cache manager,
3775     making operations such as stat'ing all cells under /afs much faster.
3776     This is enabled by passing -fakestat to afsd, but might not be stable
3777     on all platforms.
3780 OpenAFS 1.2.9
3782   * The kaserver now defaults to not allowing interrealm authentication,
3783     due to security vulnerabilities in the krb4 protocol.  The new
3784     "-crossrealm" flag to the kaserver is provided to reenable interrealm
3785     authentication if desired.
3787   * RedHat Linux 9.0 is now supported.
3789   * Solaris 9 12/02 is now supported.  Solaris 7 and 8 x86 should now
3790     work again.
3792   * On Linux machines using 2.2 series kernels, 2.2.19 or higher is now
3793     required.
3795   * An OpenAFS 1.2.9 afsd will not work with kernel modules built from
3796     an earlier OpenAFS release.  In general, using a mismatched afsd and
3797     kernel modules set is unsupported; it is not recommended that you use
3798     such a configuration on a regular basis.
3801 OpenAFS 1.2.8
3803   * Mountpoint directory information is now only faked for cross-cell
3804     mountpoits when using the -fakestat flag (e.g. for the directories
3805     under /afs, but not for most other volumes mounted inside the cell).
3806     The -fakestat-all switch can be used to fake information for all
3807     mountpoints.
3809   * HPUX 11.0 is now supported.
3811   * It is now possible for AFS to use Kerberos 5 directly, via rxkad 2b.
3812     See the OpenAFS 1.2.8 Release Notes for more information on using this
3813     capability.
3815   * An NFS translator kernel module is now included and compiled by
3816     default for Solaris only.
3819 OpenAFS 1.2.7
3821   * MacOS X 10.2 is now supported.  FreeBSD 4.3 and later support is
3822     included in this release, but is still under active development and
3823     should only be used by those doing active development on the OpenAFS
3824     FreeBSD client.
3826   * When fakestat is enabled on MacOSX, the Finder can be used to browse a
3827     fully-populated /afs directory.  However, this precludes reliable use
3828     of entire volumes as MacOS bundles (i.e. containing a Contents
3829     directory in the root of the volume).
3831   * The fileserver will now use Rx pings to determine if clients are
3832     reachable prior to allocating resources to them, to prevent asymmetric
3833     clients from consuming all fileserver resources.
3836 OpenAFS 1.2.6
3838   * Mountpoint directory information can be faked by the cache manager,
3839     making operations such as stat'ing all cells under /afs much faster.
3840     This is enabled by passing -fakestat to afsd.
3842   * Solaris 9 FCS and Solaris 7 and 8 x86 are now supported.
3845 OpenAFS 1.2.5
3847   * A remote denial of service attack in the AIX and IRIX clients has been
3848     fixed.  Users of those platforms are strongly encouraged to upgrade.
3850   * Fixed race conditions in fileserver that could result in crash.
3853 OpenAFS 1.2.4
3855   * Server logfiles now more consistant about format in which hosts are
3856     referred to.
3858   * vfsck on Solaris will now allow force runs (using -y flag) even if old
3859     inodes exist.
3862 OpenAFS 1.2.3
3864   * Cell aliases for dynroot can be specified in the CellAlias file in
3865     /usr/vice/etc or /usr/local/etc/openafs, in format "realname alias",
3866     one per line.  They can also be managed at runtime with "fs newalias"
3867     and "fs listaliases".
3870 OpenAFS 1.2.2
3872   * Solaris 9 and Linux PA-RISC are now supported.
3874   * fileserver will not erroneously delay legitimate errors for 3 seconds
3875     after 10 errors are returned (e.g. stat() on a directory you can't
3876     read).
3878   * Rx MTU calculation now works for Irix, Solaris and Linux
3880   * If afsd is started with the -dynroot flag, /afs will be locally
3881     generated from the CellServDB.  AFSDB cells will be mounted
3882     automatically upon access.
3884   * The namei fileserver allows vice "partitions" to be directories
3885     instead of partitions and will attach and display accordingly.
3886     Creating the file "AlwaysAttach" in the /vicepX directory is used as
3887     the trigger to attach it.
3889   * TSM support for butc no longer requires editing a Makefile, simply
3890     specify the --enable-tivoli-tsm configure option.
3892   * Linux builds no longer require source changes every time the kernel
3893     inode structure changes; the OpenAFS sources will now configure itself
3894     to the actual inode structure as defined in the kernel sources.
3897 OpenAFS 1.2.1
3899   * vfsck on Digital UNIX and Solaris will now refuse to fsck mounted
3900     mounted partitions.
3903 OpenAFS 1.2.0
3905   * AFS now supports --prefix and the other directory options of
3906     configure.  By default AFS builds assuming it will be installed in
3907     /usr/local.  In order to get traditional AFS directory paths (/usr/afs
3908     and /usr/vice/etc) use the --enable-transarc-paths option to
3909     configure.  More details on the new directory layout are found in
3910     README.
3913 OpenAFS 1.1.1a
3915   * Windows 95/98/ME/NT/2000 - Consistent versioning:  Installation, AFS
3916     Control Center, Client dialog boxes and properties pages for
3917     executables display a consistent OpenAFS version number.  Installation
3918     detects previous installation and prompts the user for upgrade
3919     options.
3921   * Windows 95/98/ME/NT/2000 - Installation features:  During installation
3922     the user can select the source of the CellservDB file, AFS home cell,
3923     and drive mappings.  During installation a drive path mapping can
3924     include a variable that will be substituted with the current UserName
3925     that is logged in.
3927   * Windows 2000/NT - Integrated logon:  The Integrated Logon feature
3928     works now.
3930   * Windows 95/98/ME - Logon script features:  The Windows 95/98/ME client
3931     now offers a command-line option for starting up the AFS client
3932     without authenication. It is now possilbe to start the AFS client
3933     first and obtain tokens, and map drives all through Windows scripts.
3934     This helps using Windows 95/98/ME client in Kerberos 5 environment.
3936   * Windows 2000/NT - LANA numbers:  AFS client now scans the LANA numbers
3937     to establish the correct NETBIOS connection.  NetBEUI is no longer
3938     needed.  The user no longer needs to find the correct LANA number.
3940   * Windows 2000/NT - OpenAFS naming consistancy:  Further progress has
3941     been made to remove references to "Transarc AFS" and replace with
3942     "OpenAFS".
3945 OpenAFS 1.0
3947   * AFS now builds with configure. The README for building has been
3948     updated and includes full details.
3950   * A client system can now have multiple sysname values for @sys.  They
3951     will be searched in order when looking up files in AFS.  The
3952     -newsysname argument to fs sysname can be repeated to set multiple
3953     sysnames.
3955   * A new system group is created for new cells (system:ptsviewers with id
3956     -203).  If this group exists, members of this group can examine and
3957     read the entire protection database.  They can examine all users and
3958     groups and can get the membership of any group.
3960   * A new program, pt_util has been added to the distribution.  This
3961     program allows users to print the contents of the protection database
3962     or to edit the protection database without running a ptserver.  It can
3963     be used to set up a new cell without ever running in noauth mode.  Run
3964     pt_util -h for help.
3966   * The fs setcrypt and fs getcrypt commands have been added.  These
3967     commands allow the system administrator to require that the client
3968     encrypt all authenticated traffic between the client workstation and
3969     AFS.  The encryption used is weak, but is likely better than sending
3970     unencrypted traffic in most environments.  Some functions, such as
3971     looking for a volume may not be encrypted, but data transfer certainly
3972     is.  By default data is not encrypted.  At this time no significant
3973     experimentation with server performance has been conducted.
3975   * By default AFS is compiled with AFS_AFSDB_ENV, enabling the -afsdb
3976     option to be given to afsd on startup.  If this option is used, then
3977     new cells will be looked up using AFSDB records stored in DNS if they
3978     are not found in CellServDB.  This means that users can create
3979     cross-cell mountpoints in directories they control to access cells not
3980     in root.afs, and that cells in root.afs need not be in the client's
3981     CellServDB.
3983   * AFS database servers can be marked as read-only clones.  Surround the
3984     hostname in square brackets on the bos addhost command and the
3985     database server will never be elected sync site.  This is useful for
3986     cells distributed over a wide region.
3988   * The AFS servers now support the -syslog flag.  This flag causes them
3989     to log to syslog rather than to files.  This flag is not supported on
3990     NT.  For all servers besides the salvager, the flag can also be
3991     specified as -syslog=facility, where facility is an integer facility
3992     code from syslog.h.  A -syslogfacility option is provided for the
3993     salvager to accomplish the same goal.
3995   * If the --enable-fast-restart flag is given when configuring AFS, then
3996     the salvager supports the -dontsalvage flag which causes it to exit
3997     without salvaging any volumes.  If this is configured into the third
3998     command of a fs process, then the fileserver will start without
3999     salvaging.  It will fail to attach volumes that need salvaging and
4000     they can be salvaged manually.  This provides significantly better
4001     server startup performance at the cost of administrative complexity.
4003   * If the --enable-bitmap-later flag is given when configuring AFS, then
4004     the fileserver creates bitmaps for free vnodes on demand, allowing
4005     faster starts.
4007   * If bosserver finds a BosConfig.new file at startup, it reads this file
4008     and renames it to BosConfig.  This allows bosserver to be reconfigured
4009     at next restart.
4011   * The bosserver can be placed in a restricted mode in which AFS
4012     superusers are only granted limited access to the server host. The
4013     following functionality is disabled when restricted mode is in use:
4015       bos exec
4016       bos getlog (except for files with no '/'s in their name)*
4017       bos create *
4018       bos delete
4019       bos install
4020       bos uninstall
4022     specific exceptions are made for functionality that "bos salvage"
4023     uses:
4025     A cron bnode who's name is "salvage-tmp", time is now, and command
4026     begins with "/usr/afs/bin/salvager" may be created. This bnode deletes
4027     itself when complete, so no special "delete" support is needed.  This
4028     functionality may be removed in the future if a "Salvage" RPC is
4029     implimented.
4031     The file with the exact path /usr/afs/logs/SalvageLog may be fetched,
4032     since that is how bos salvage [...] -showlog is implimented.
4034     Restricted mode is enabled using a new bos command (bos setrestricted)
4035     or bossever command line switch (bosserver -restricted). Restricted
4036     mode can be disabled by a) sending the bosserver process a SIGFPE
4037     (which will then allow restricted operations until the next restart or
4038     setrestricted command) or b) editing /usr/afs/local/BosConfig (or
4039     BosConfig.new), and restarting the bosserver.
4041   * The bos UserList of trusted administrators can now contain cross-realm
4042     Kerberos principals.
4044   * udebug now takes --server not --servers.
4046   * Several error messages have been improved to include volume numbers.
4048   * Several new ports have been included for UNIX platforms: Darwin
4049     (ppc_darwin_12 and ppc_darwin_13), Linux 2.4 (i386_linux24), Linux on
4050     the Powerpc (ppc_linux22 and ppc_linux24), Linux on the Sparc
4051     (sparc_linux22, sparc64_linux22 and sparc64_linux24).
4053   * Incomplete FreeBSD and Alpha Linux ports are included.  The FreeBSD
4054     port has a working server and the Alpha Linux port has a partially
4055     working client.
4057   * A native client for Windows 95/98/ME has been added to the
4058     distribution.  With this program, a gateway machine is no longer
4059     required for Windows 9x to access AFS files.  One drive letter will be
4060     created on your machine by default - Z:.  The Z: drive will be the
4061     root of the AFS tree, allowing you to browse all sites that have AFS
4062     servers available.  Additional drive letters can be defined for other
4063     AFS directories.  A Windows Explorer shell extension is included that
4064     allows you to right click on items within an AFS tree to bring up an
4065     "AFS" menu item and perform various operations on a file or directory.
4066     The most useful item is "Access Control Lists", which allows you to
4067     view and edit the permissions of a particular directory.  Command line
4068     tools are also available in the install directory.  These commands
4069     include klog, unlog, tokens, kpasswd, symlink, fs and pts.  The
4070     installable includes a readme file that contains more information on
4071     how to use the client program and known issues.
4073   * Support for large caches in afsd.  Cachefiles are stored in
4074     subdirectories.  The default is 2048 files per subdirectory, which
4075     should work fine in most situations.  You can use the new afsd option
4076     -files_per_subdir to change this number.  Note that the first time you
4077     run afsd with this patch, your cachefiles will get moved into
4078     subdirectories.  If you subsequently run an older version of afsd, you
4079     will lose all your cached files.