Separate helper for shutdown module check
[pkg-k5-afs_openafs/adeason.git] / NEWS
blob24d156045eed0d8d4b53f2a03a3b48f2f050e347
1                        User-Visible OpenAFS Changes
3 OpenAFS 1.6.10
5   All platforms
7     * Don't hide the "version" subcommand in help output (11214)
9     * Documentation improvements (11126 11216 11222 11223 11225 11226)
11     * Improved diagnostics and error messages (11154 11246 11247 11249 11181
12       11182 11183)
14     * Build system improvements (11158 11221 11224 11225 11227..11241 11282
15       11342 11350 11353 11242 11367 11392)
17     * Avoid potentially erratic behaviour under certain error conditions by
18       either avoiding or at least not ignoring them, in various places (11008
19       11010..11065 11112 11148 11196 11530)
21   FreeBSD
23     * Support releases 9.3 and 10.1 (11368 11369 11402 11403 11404)
25     * Makes a disk cache more likely to work on FreeBSD, though such
26       configurations remain not very tested (11448)
28   All server platforms
30     * Added volscan(8) (11252..11280 11387 11388)
32     * Fixed a bug causing subgroups not to function correctly if their
33       ptdb entry had more than one continuation entry (11352)
35     * Logging improvements (10946 11153)
37     * Allow log rotation via copy and truncate (11193)
39     * Avoid a server crash during startup only observed on a single platform
40       and when using a 3rd party library under certain circumstances, which is
41       a collateral effect of the security improvements introduced in OpenAFS
42       release 1.6.5 (11075) (RT #131852)
44   All client platforms
46     * Raised the free space reported for /afs to the maximum possible value of
47       just under 2 TiB - the old value was 9 GiB on most platforms (10984)
49     * Reduced the amount of stack space used (11162 11163 11203 11164..11167
50       11338 11339 11364..11366 11381)
52     * Sped up a periodic client task which could be problematically slow
53       on systems with a large number of PAGs and files in use (11307)
55     * Fixed failure of the up command with large ACLs (11111)
57     * Avoid a potential crash of aklog (11218)
59     * Avoid potential crashes of scout and xstat_fs_test (11155)
61   Linux clients
63     * Support kernels up to 3.16 (11308 11309)
65     * Fixed a regression introduced in OpenAFS release 1.6.6 that made
66       checking for existing write locks incorrectly fail on readonly volumes
67       (11361)
69     * Fixed a regression introduced in OpenAFS release 1.6.8 that could
70       cause VFS cache inconsistencies when a previously-accessed directory
71       entry was removed and recreated with the same name but pointing to a
72       different file on another client (11358)
74     * Use the right path to depmod in Red Hat packaging to avoid dependency
75       calculation incorrectly failing unless a link /sbin -> /usr/sbin is
76       present on the system performing it (11171) (RT #131860)
78     * Do not ignore kernel module build errors (11205)
80 OpenAFS 1.6.9
82   All server platforms
84     * Fix for OPENAFS-SA-2014-002
86 OpenAFS 1.6.8
88   All platforms
90     * Documentation improvements (10751 10875 10931 10897 10883 10954 10955)
92     * Improved diagnostics and error messages (10756 10814 10949)
94     * Fixed a bug in RX that could make errors during packet reception go
95       unnoticed. (10733)
97     * Fixed a bug that made "vos size -dump" display the wrong size for
98       large volumes. (10933)  (RT #131819)
100   All server platforms
102     * Change the default fileserver sync behavior from "delayed" to "onclose".
103       This means that explicit syncing only happens when a volume is detached.
104       (10809)
106     * Added the -offline-timeout and -offline-shutdown-timeout options to the
107       fileserver, to implement interrupting clients accessing volumes we are
108       trying to take offline. (6266 10799)
110   All client platforms
112     * When a client is shut down, it will give up its callbacks. The Windows
113       client has been doing this since 2007. Note that older fileservers
114       (1.3.50 to 1.4.5 and 1.5.0 to 1.5.27) had a bug in the implementation of
115       the relevant RPC that could cause crashes or other undefined behavior
116       when this happens. (6272 8840 10855)
118     * Restored the pre-1.6 behavior of "vos e" being an alias for "vos examine".
119       (10886)
121     * Avoid flooding logs with warnings about byte-range locks, by throttling
122       them per file. Also, make the messages more useful by including the
123       FID. (10836..10839)
125     * Avoid a possible panic during shutdown while tracing. (10932)
127   Linux clients
129     * Fixed a bug that could cause the "getcwd: cannot access parent
130       directories" problem (10804 10984)
132     * Avoid a delay when accessing uncached data in AFS in a confined
133       context under SELinux. (10598)
135     * Red Hat packaging improvements (10600 10767 10807)
137 OpenAFS 1.6.7
139   All server platforms
141     * Fix for OPENAFS-SA-2014-001
143     * Fix for a potential DOS attack against RX servers
145 OpenAFS 1.6.6
147   All platforms
149     * As of this release, OpenAFS no longer ships uncompressed source tarballs.
150       Tarballs are still shipped with both compression formats, gzip and bzip2.
151       (10131)
153     * Documentation improvements (10136 10314 10601)
155     * Improved diagnostics and error messages (9412 10085 10274)
157     * Avoid redefining "assert" in our public header files, which could
158       cause failures when building some applications using them. (10096)
160     * Fixes for parallel builds (10005 10309 10337)
162     * Added a -s switch to afscp (not installed by default) to help simulate
163       a slow client. (9416 9417)
165     * Added a -probe switch to vlclient test program (not installed by default)
166       to ping all vlservers in a cell in parallel. (9570)
168   All server platforms
169     * The fileserver now ignores any vice partitions with a NeverAttach flag
170       file present in the root directory. (RT #130561) (9470 9471)
172     * Restrict forcing CPS ("Current Protection Subdomain") recalculation in
173       the fileserver to administrators. Also fixed a bug that could cause this
174       operation to be incomplete. (9485 9487)
176     * Allow non-DAFS fileservers to attach unusable volumes, restoring pre-1.6
177       behaviour. (RT #131505) (9499)
179     * Restored the pre-1.6 behaviour when running vos examine for a volume
180       currently in a transaction, showing the volume as busy again rather than
181       offline. (9685 9915 9916)
183     * Reduced the minimum time a bos salvage takes from 5 seconds to 1. (9476)
185     * Fixed buserver to not segfault when started with the -servers option.
186       (RT #131706) (10166)
188     * Salvager fixes, addressing a wide variety of possible problems from
189       unnecessary salvaging to aborts (9282 9283 9457 9458 9459 9461 9462 9480
190       9481 10165 10167)
192     * Fixed a bug that could cause saved state information to be discarded
193       when restarting a large or busy fileserver, which negatively impacted
194       performance. (9683)
196     * Fixed a bug that could have caused undefined behaviour in the vlserver
197       in rare cases when a fileserver registered its addresses in the VLDB.
198       (9429)
200     * Added the -preserve-vol-stats switch to volserver, allowing it to keep
201       the access statistics across volume restore and reclone operations
202       instead of resetting them. (9477)
204     * Inserted an exponential delay between retries when bosserver attempts to
205       restart a server process. (9571 10199)
207     * Improved vldb_check (not installed by default) to cope with broken
208       vlentry names and volids, and provide more output to aid debugging.
209       (10268)
211     * Releasing a volume after adding a new RO site no longer touches any of
212       the existing RO sites, if the RW data hasn't changed since the last
213       release. (10174)
215     * Make the copyDate field for RO clones have the same meaning as for
216       remote RO volumes. Previously, the copyDate field for clones was updated
217       every time we released. (9451)
219     * Fixed potentially undefined behaviour in ptserver when too many pts
220       ids are allocated. (10124)
222     * Note that the server side NAT pings feature present in the prereleases
223       was removed before the final release, since no positive feedback
224       was provided during prerelease testing. (9420 10135)
226   Linux servers
228     * Start bosserver with -nofork in the systemd unit file, to allow systemd
229       to track its state (10093)
231   All client platforms
233     * No longer track file locks on read-only volumes. Write locks can't
234       succeed, read locks always will. Avoids log messages about this kind
235       of lock. (8910)
237     * Added the "fs flushall" subcommand, which makes the client discard all
238       cached data. This was previously available on Windows only. (9065 9388
239       9389 9390)
241     * Fixed a bug that could make the client incorrectly believe its cache
242       is up to date. This change could negatively impact AFS <-> DFS
243       translators, should those still be running anywhere. (8898)
245     * Several changes to avoid panicing in certain error conditions.
246       (9131 9287 10354 10355 10356 10357) (partially addressing RT #131747)
248     * Added the -rxmaxfrags switch to afsd, allowing to limit the number
249       of UDP fragments sent or received per RX packet. (9430)
251     * Build fixes for aklog on several platforms (RT #131716) (9917 10107 10275)
253     * Require that the AFS mountpoint specified in the cacheinfo file is
254       an absolute path. Relative paths result in a client that basically
255       works but is not fully functional. (10253)
257     * Fixed a bug that could cause one of the afsd threads to enter an infinite
258       loop (10431 .. 10436)
260   Linux clients
262     * Support Linux kernels up to 3.13 (10241)
264     * Fixed a bug that made readv/writev calls in AFS space fail with Linux
265       kernels where generic_file_aio_read exists but those operations have
266       not been switched to using aio_read/aio_write. This was a regression
267       introduced with release 1.6.3 and affected at least RHEL 5.9 kernels.
268       (10248)
270     * Fixed a similar bug making core dumps fail in AFS space, affecting
271       a much wider range of kernels including the most recent ones.
272       (RT #131729) (10254)
274     * Enhanced the keyring code to make PAGs work correctly on kernels with a
275       distribution specific change to the Linux keyring code. This affected at
276       least SLES 11 SP3 kernels. (10252)
278     * Fixed a bug that could make failures during PAG instantiation go
279       unnoticed. (10255)
281     * Fixed a bug that made compilation fail for Linux kernels without
282       keyring support. This affected at least the SLE 10 SDK and an
283       OEM version of SLES 11 SP1. (10325)
285     * Fixed build for kernels with user namespace support enabled. Likely
286       to be required for Ubuntu 14.04 and eventually other distributions.
287       (10456 10457 10458 10518 10472)
289     * Support RHEL 6.5 kernels, and possibly others with changes backported
290       from recent mainline kernels that touch getname/putname, by no longer
291       using those functions. Previously, the client could cause a kernel
292       panic when syscall auditing was enabled. (10578)
294     * Make tmpfs usable as the cache filesystem again. This had been broken
295       since kernel 3.1 (9950 10193)
297     * When starting the client fails, clean up the backing device information
298       created in sysfs, to avoid error messages during a subsequent start
299       and possible system instability later on (10454)
301     * Update Red Hat packaging to support Fedora >= 20, RHEL >= 7 and
302       ELrepo kernels (10597 10619 10622 10703 10704)
304   OS X Clients
306     * Support OS X 10.9 "Mavericks" (10519 10541 10542 10543 10548 10549)
308   AIX clients
310     * Fixed a bug that caused the 1.6 AIX client to never receive any RX
311       packets in the kernel. (RT #131725)
313   FUSE client
315     * Support Solaris 11 (9454 9455)
317     * Allow other users to access filesystems mounted by root. (9452)
319   FreeBSD
321     * Build tvolser and dvolser on this platform (10122)
322     * Several fixes to catch up with newer releases (10374 .. 10381)
324   NetBSD
326     * Build tsalvaged, tvolser and dvolser on this platform (10121)
327     * Fixed build on NetBSD 5 and newer. (10138)
329 OpenAFS 1.6.5
331 All platforms
333     * Fixes for OpenAFS-SA-2013-0003 and OpenAFS-SA-2013-0004
335 OpenAFS 1.6.4
337 All platforms
339     * Obey the jumbo/nojumbo settings for ubik servers (the DB servers)
340       too. In previous releases, those servers may have used jumbograms
341       even if they were not configured to do so. This change corrects
342       the actual behaviour, and will improve performance and reliability
343       for sites where jumbograms are problematic. It could cause a decrease
344       in performance for sites where jumbograms work, but those can turn
345       them back on manually.
347     * Dozens of fixes for common coding problems like use after free,
348       use of possibly uninitialised memory, reading or writing past the
349       end of arrays and potential NULL pointer derefences. Spotted by
350       code analysis tools or human inspection.
352     * Documentation improvements.
354     * Fixes and improvements to the diagnostic or log messages printed by
355       vos, the fileserver and others.
357     * Build fixes, making parallel builds more reliable with certain
358       configuration options and helping various platforms including
359       recent releases of IRIX, Solaris and several flavours of Linux.
361     * Avoid sending a small amount of data over the wire unencrypted
362       under certain conditions, and emit the correct error message in
363       this case.
365 All server platforms
367     * Avoid generating duplicate IDs for readonly and backup volumes,
368       which could happen under certain conditions.
370     * Allow the fileserver to return volume data like quota or free space,
371       which is available publicly elsewhere, without the additional access
372       check for read permissions on a volume's root directory the fileserver
373       performed before.
375     * The fileserver now emits a log message when it ran out of memory for
376       callbacks.
378     * Avoid several potential fileserver problems, including memory
379       corruption and segmentation faults, due to client bookkeeping.
381     * Avoid known cases of silent data corruption due to background syncs
382       on the fileserver, especially during Copy on Write.
384     * Make the fileserver sync behaviour runtime configurable. Up to 1.4.5,
385       we had synchronous syncs which were safe but really slow. Since 1.4.5,
386       we've had asynchronous syncs which are much faster but believed to
387       be the cause of rare data corruption issues, and while all known cases
388       of these happening are believed to be fixed in the 1.6.3 release, doubts
389       remain. This change allows choosing between those, and in addition allows
390       to turn syncs by the fileserver off altogether, thus relying on the vice
391       partition's backend filesystem and the operating system, or to just
392       execute them when a volume is detached. The default behaviour is
393       unchanged from releases since 1.4.5, but it's highly recommended to
394       consider the additional options this change provides. Future OpenAFS
395       releases will default to "-sync=none".
397     * For dbservers, avoid a situation where misinterpreting transient
398       network errors causes long-term issues with achieving ubik quorum.
400 All UNIX client platforms
402     * Improvements to the detection of an aklog-specific krb5 configuration
403       file, for the purposes of turning on "weak crypto" for aklog.
405     * Fixed a regression introduced in release 1.6.2 which caused the
406       supposedly persistent disk cache to be discarded upon client start.
407       (RT #131655)
409 Linux clients
411     * Support Linux kernels up to 3.10
413     * Fixed two bugs making it impossible to unmount a disk cache filesystem
414       after it has been used by the client. (RT #131613)
416     * Fixed a bug that could cause an oops with kernels 3.6 and later
418 OpenBSD
420     * Improved support for OpenBSD 4.9 to 5.3
422 OpenAFS 1.6.3
424   This release number had to be skipped for technical reasons.
426 OpenAFS 1.6.2.1
428   Linux clients
430     * Support Linux kernels up to 3.8.
432     * Make the init script cope with the output of ifconfig on recent Fedora.
434 OpenAFS 1.6.2
436   All platforms
438     * Fix buffer overflows in fileserver and ptserver.
440     * Abort an rx connection when given an unknown service (Gerrit 7593).
442     * "idle dead" behavior improvements.
444     * Documentation updates.
446   All server platforms
448     * Fix rare file corruption during background sync (Gerrit 8796).
450     * Fix corrupting clients' metadata cache during certain errors (Gerrit
451       6957).
453     * Avoid saying a volume doesn't exist when accessed as the volume is
454       going offline (Gerrit 7488).
456     * Fix fileservers to properly report >2 TiB partitions.
458     * Fix stale volume info from vos examine on non-DAFS filservers.
460     * Fix possible volume corruption with vos convertROtoRW.
462     * Fix bosserver to preserve all command-line options over restart.
464     * Fix bosserver to properly kill hung processes during shutdown.
466   All UNIX client platforms
468     * Fixes for memcache, especially on Solaris.
470     * Increase the size of the DNS resolver answer buffer to allow sites
471       with a long response list to use SRV and AFSDB records.
473     * Fix a crash when a server appears to run out of addresses (Gerrit
474       7487).
476     * Fix cache corruption when reading from a file another client is
477       simultaneously writing to (Gerrit 7994).
479     * Improve handling of disk cache disk errors.
481   Linux
483     * fix DKMS configuration for DKMS 2.2.
485     * Avoid generating inode number 0 with md5 inodes (Gerrit 7276).
487     * Fix a crash when reading /proc/fs/openafs/unixusers (Gerrit 7914).
489     * Make PAG-less access use the real UID of the calling process
490       instead of the effective UID, when determining what credentials to
491       use (Gerrit 7931).
493     * Fix possible abuse of fs mkmount.
494       Prior to 1.6.2, users could crash a client by nesting volume mounts.
496     * Fix fileserver memory corruption on RHEL 6
497       Prior to 1.6.2, fileservers on RHEL 6 may crash under heavy load.
499     * Fix client page cache corruption on Linux
500       When multiple clients read and write to a file, the reading client
501       may see first page (4096 bytes) of a file as nulls.
503     * Support Linux kernels up to 3.7.
505     * Support newer glibc versions.
507     * Improve client systemd unit file.
509     * Update Red Hat packaging.
511   OS X
513     * Fix crashes on shutdown.
515     * Prevent unloading the module before shutdown completes.
517     * Security improvement for the OpenAFS preference pane.
519   Solaris
521     * Support newer versions of the Sun Studio compiler software.
523     * Support compiling on newer versions of Solaris 11 and Solaris 10.
526 OpenAFS 1.6.0 (2011-08-15)
528   All platforms
530     * Substantial Rx updates to correct erroneous behavior.
532     * vos now properly deals with matching sites when servers are
533       multihomed.
535     * Don't stop Rx keepalives after an ackall is received, avoiding
536       spurious connection timeouts. (128848)
538     * Don't retry Rx calls on channels returning busy errors and improve
539       Rx busy call channel error handling. (128671)
541     * Properly enable Rx connection hard timeouts.
543     * Rx NAT pings are not enabled until peer has answered.
545     * Initialize rx_multi lock before use.
547     * Avoid spurious crashes when initializing in "backup" client.
549     * Revert UUID support in vos.
551     * pt_util fixed to properly create new databases.
553     * MTU discovery now properly shut down on call reset.
555     * Avoid leaking references to hosts during callback break multi-Rx
556       operations. (129376)
558     * xstat tools now cope with differing timeval structures between
559       endpoints.
561     * Numerous fixes to command argument parsing.
563     * Documentation updates.
565   All server platforms
567     * A file descriptor leak which could result in corrupted files in the
568       fileserver was fixed. An IMMEDIATE upgrade from previous 1.5 release
569       fileservers is recommended.
571     * Fix ptserver supergroups support on 64 bit platforms.
573     * Demand attach salvaging doesn't use freed volume pointers.
575     * Properly hold host lock during host enumeration in fileserver.
577     * Attempt to recovery more quickly from timed out volume release
578       transactions.
580     * Auditing now properly byte order swaps IP addresses when printing.
582     * vos split now has improved error handling.
584     * Many changes to again support Windows fileservers.
586     * During volume removal, data removal speed improved.
588     * Improve CPU utilization during volume attaching by DAFS.
590     * In salvager check-only mode, avoid potentially fixing a vnode.
592     * Fix support for large (greater than 2gb) volume special files.
594     * Salvager will not crash if multiple or bad volume link tables are
595       encountered.
597     * Avoid erroneous full dump by remembering which sites were out of
598       date at the start of the release.
600     * A deleted volume can now be recreated properly.
602     * Callbacks are again not broken during whole partition salvages.
604     * Positional vectored IO fixed for largefile (>2GB) capable systems.
606     * Fileserver per-client thread usage again properly enforced.
608     * Anonymous dropbox support improved and drawbacks documented.
610     * Demand attach: ensure vnodes are not reallocated while in use due to
611       volume bitmap errors.
613     * Properly support large volume numbers (larger than 2147483647).
615     * Allow salvager to be run manually again when DAFS is being
616       used. (129458)
618     * Avoid leaking references to hosts during callback break multi-Rx
619       operations. (129376)
621     * Demand attach: unlink fileserver state file on standalone salvage.
623     * Salvager tries harder to detect linktable issues.
625     * Demand attach: don't attach volumes with special status set.
627     * Avoid crashing on host table exhaustion. Instead, defer clients.
629   Microsoft Windows
631     * afs_config will not longer set the Tray Icon State in the registry
632       if the checkbox is not present in the dialog. (128591)
634     * AFS Explorer Shell Extension now works from folder backgrounds.
635       Overlays for mount points and symlinks are present in the dll, but
636       are not registered at present by the installers.
638     * Do not use RankServerInterval registry value as the value for
639       PerformanceTuningInterval.
641     * When the data version of a mountpoint or symlink changes, the target
642       string in the cm_scache_t object must be cleared.
644     * "fs checkservers" now includes vldb servers in the output and only
645       lists multi-homed servers once.  A multi-homed server that has at
646       least one up interface is no longer considered to be down.
648     * When asynchronously storing dirty data buffers to the file server
649       ensure that (a) the cm_scache_t object and the cm_buf_t object are
650       for the same File ID so that locking and signalling work properly;
651       and (b) if the FID no longer exists on the file server, do not
652       panic, just discard the buffer.
654     * When processing VNOVOL, VMOVED and VOFFLINE errors perform server
655       comparisons by UUID or address and not simply by cm_server_t
656       pointer.  Otherwise, server failover may not succeed.
658     * Do not preserve status information for cm_scache_t objects when the
659       issuing server is multi-homed.
661     * Giving up all callbacks when shutting down or suspending the machine
662       is now significantly faster due to the use of an rx_multi
663       implementation.  (This functionality is still off by default and
664       must be activated by a registry value.)
666     * Race conditions were possible when updating the state of the
667       cm_volume_t flags and when moving the volumes within the least
668       recently used list.
670     * Ensure that the lanahelper library does not perform a NCBRESET of
671       each lan adapter when enumerating the current network bindings.
672       Correcting this permits OpenAFS to work on Windows 7 when the
673       network adapter settings change.
675     * Fix creation of mount points and symlinks as \\AFS\xxxx
677     * Icon tray state now conditionally set. (128591)
679     * Properly create new cell mount points in freelance mode.
681     * Avoid recursive offline volume checks.
683     * Fix caching of non-existent volumes.  The test to trigger an
684       immediate CM_ERROR_NOSUCHVOLUME in cm_UpdateVolumeLocation() was
685       backwards.
687     * Prevent the background daemon from checking the status of
688       non-existent volumes.  cm_CheckOfflineVolumes() should skip volume
689       groups with the CM_VOLUMEFLAG_NOEXIST flag set.
691     * The afskfw library should return an error immediately if the
692       krb5_32.dll library cannot be loaded.  Affects afslogon.dll and
693       afscreds.exe.
695     * No longer depend on leashw32.dll in afskfw library.
697     * NPLogonNotify must provide the user password in all calls to
698       KFW_AFS_get_cred().  It cannot count on a credential cache being
699       preserved between calls.  Permits tokens to be acquired for all
700       cells listed in the TheseCells registry value for a domain.
702     * Improve the trace logging from NPLogonNotify().
704     * Avoid a race when writing the cm_scache_t mountPointString
705       when acquiring mount point or symlink target data via
706       cm_GetData().  The race could result in bogus target
707       data being cached.
709     * Permit the use of des-cbc-md5 and des-cbc-md4 enctypes
710       as DES keys in asetkey.exe.
712     * aklog supports dotted Kerberos v5 principal names.
714     * afskfw library always attempts afs/cell@USER-REALM
716     * afskfw library must test return code from krb5_cc_start_seq_get() or
717       will trigger a null pointer exception when using Heimdal.
719     * Lock protected fields must be 32-bit in order to avoid memory
720       overwrite races.
722     * Add support for NTFS symlinks.
724     * Handle file search requests for virtual syscall ioctl file.
726     * Process SyncOps properly to enforce ordered operations.
728     * Avoid recursing during NewServer operations.
730     * Correct lock acquisition order during SMB locking.
732     * Add shutdown message to event log.
734     * Check offline volume status by policy rather than on each daemon
735       thread run.
737     * Return error on directory object not found instead of crashing.
739     * Improve error message output.
741     * afslogin.dll can start afsd_service if it's not starting or started.
743     * Optimize away release lock RPCs for deleted files.
745     * Background Daemon will not perform operations on deleted files.
747     * Resort recently used directories to the top of the LRU if the
748       directory is larger than the stat cache.
750     * Resort deleted objects to the bottom of the LRU.
752     * Use interlocked operations for state and queue fields to allow safe
753       bit set and clear on multiprocessor systems.
755   All UNIX client platforms
757     * Servers now marked down when GetCapabilities returns error.
759     * In-use vcache count is now properly tracked.
761     * Check for /afs existance before starting, unless -nomount is
762       specified.
764     * Avoid a potential panic when using /afs/.:mount syntax.
766     * Avoid a panic in memcache mode due to missing CellItems file.
768     * FUSE client support fixed for non-/afs mounts.
770     * Avoid a potential deadlock (which times out) when we need to
771       allocate more callback returns and must flush some already in use.
773     * Deal with libcom_err conflicts with other packages using it
774       (e.g. krb5) (128640)
776     * Fall back to afs3-vlserver SRV record values when afs3-ptserver SRV
777       record is not available.
779     * Avoid holding unneeded locks when probing server capabilties.
781     * Do not attempt page flushes for directories.
783     * Rx connection reference counting is enabled.
785     * An Rx connection reference count leak is fixed in bulkstat.
787     * Handle unparsable directory objects.
789     * Handle Kerberos cred cache errors in aklog.
791   AIX
793     * Fix PAG usage to track by PAG identifier, not group list.
795   FreeBSD
797     * Fix socket termination on shutdown.
799     * Support for 7.2, 7.3, 7.4 and 8.2 included.
801     * References to vcaches are no longer leaked during root or reclaim.
803     * Remove support for "Giant" lock as we no longer need to use it.
805     * Don't sleep with AFS GLOCK.
807     * Properly enable 64 bit long long support.
809     * Restore support for FreeBSD 7 (128612)
811     * Fix locking issues at shutdown and avoid panic at shutdown due to
812       vcache flushing.
814     * Support for virtual network stacks.
816     * New RC script, updated packaging.
818   IRIX
820     * Properly create new vnodes to avoid crashing in the client.
822   Linux
824     * Support through kernel 2.6.39.  Treat Linux 3.0 as Linux 2.6 for
825       sysname purposes.
827     * Use rx_Readv in cache bypass to improve performance.
829     * Properly handle 0-length replies during cache bypass operations.
831     * Properly handle non-contiguous readpage cache bypass operations.
833     * Do proper locking when transitioning to or from cache bypass.
835     * Avoid extra runs of vcache freeing routine. (128756)
837     * Perform vcache eviction via a fast path before visiting vcaches
838       where sleep is needed.
840     * setpag() errors are now properly reported.
842     * Avoid attempting to free stat cache entries when we are below
843       user-specified number of entries in use.
845     * Properly track user-specified number of stat cache entries to use as
846       a desired usage target.
848     * Don't read pages beyond EOF in the cache. (128452)
850     * Various corrections and improvements to Red Hat packaging, including
851       modifying the init script to allow deferring for a new binary
852       restart and properly supporting RHEL6.
854     * Fix lockup in 2.6.38 due to erroneous kernel feature configure test.
856     * Improve RPM building tools.
858     * Attempt to properly handle SELinux in packaging.
860     * Init script properly returns status as exit code.
862     * RPM packaging fixes (executable libraries, no postinstall message)
864     * Kill i386 from RPM packaging.
866   MacOS
868     * MacOS 10.7 support.
870     * Properly handle setpag errors.  PAGs are not supported.
872     * Check for unloaded kernel extensions when decoding AFS panics.
874     * Disable "get tokens at login" in prefs pane if AD authentication
875       plugin is configured.
877     * aklog AuthorizationPlugin now provided.
879     * Preferences Pane behavior fixed for 1.6 series (version detection is
880       used to select default behavior).
882     * A potential kernel panic during bulkstat operations is
883       fixed. (128511)
885     * 64-bit MacOS kernel performance is greatly improved. (128934)
887     * Properly shut down AFS, closing the Rx socket in the upcall handler
888       to avoid attempting to process data after we can no longer do so.
890     * Rework logic for bulk status operations to avoid a potential hang.
892     * Avoid panic when doing FSEvent synthesis.
894     * Fix bug when using non-dynroot.
896     * Update Kerberos support in PreferencesPane.
898   NetBSD
900     * Updates for platform support.
902   OpenBSD
904     * Bug fixes for issues introduced previously in 1.5 series.
906     * Support through OpenBSD 4.8.
908   Solaris
910     * Switch to ioctl() syscall replacement for Solaris 11 since syscall
911       65 is not safe.
913     * Fix support for Solaris pre-10.
915     * Corrected Solaris 11 startup script.
917     * vcache mappings freed on shutdown to avoid panic.
919     * Properly report errors for AFS system call callers.
921     * Don't leave dangling function references if kernel extension fails
922       to load.
924     * Try harder to avoid deadlocks on file-larger-than-cache operations.
926     * Avoid panic on shutdown when mount failed.
929 OpenAFS 1.5.78 (2010-11-04)
931   All platforms
933     * Revisions to Rx to fix performance issues.
935     * Make fs getfid behave consistently across all platforms. (128372)
937     * Properly check IDs handed to pts when creating users or groups so
938       useful error messages can be provided. (128343)
940     * Correct byte order handling of port in afsconf_LookupServer for SRV
941       records.
943     * Force a full dump when releasing to a site which was previously
944       marked "don't use", in case the previous clone was out of date.
946   All server platforms
948     * Demand salvage of attached volumes now correctly track attachment
949       state.
951     * Avoid a potential crash due to failure to hold a lock when attaching
952       a volume fails.
954   Microsoft Windows
956     * Track SMB connections by SID rather than username.
958     * Error write attempts to known-readonly volumes earlier.
960     * Validate directory buffers to avoid potential crashes.
962     * Handle VIO errors from bulkstatus.
964     * Make PMTU discovery configurable and register error handlers for it.
966   All UNIX client platforms
968     * Use larger I/O sizes in memcache to improve performance.
970     * Avoid potential alignment issues doing I/O for pioctl calls.
972   FreeBSD
974     * Avoid panicing if the listener process is not findable.
976     * Avoid deadlock issues while performing lookups.
978   Linux
980     * Handle stale file handle errors for some cache partition types.
982     * Avoid blocking with xvcache lock when attempting to free in-use
983       vcaches.
985     * Build fixes for older kernels.
987     * Properly configure LWP to use ucontext() on platforms where it
988       should.
990     * Eliminate spurious errors from AFS system call returns. (126230)
992   MacOS
994     * Attempt to honor configured Kerberos defaults in Preferences Pane.
997 OpenAFS 1.5.77 (2010-09-08)
999   All platforms
1001     * Rx path MTU detection will terminate detection in cases where the
1002       minimum required packet size cannot be transferred.
1004     * vos dryrun mode now shows effects for syncvldb single volume case.
1006     * vos dryrun mode now shows "status after" for syncvldb and syncserv.
1008   All server platforms
1010     * RXAFS_GetStatistics64 now returns statistics properly.
1012   Microsoft Windows
1014     * Attempt to properly identify the local system SMB connection for
1015       token tracking.
1017     * Remap timeout and offline errors to proper NT RPC errors.
1019     * Properly fail over to other replicas on bulkstat IO errors.
1021     * Properly error delete-mode createfile if a file is set readonly.
1023     * Validate directory entry buffers to avoid crashing the service.
1025     * Log file modes properly.
1027     * Log cell name when logging server information.
1029   All UNIX client platforms
1031     * cacheout program for discarding callbacks is now built.
1033     * bulkstatus kernel locking is corrected to avoid a potential panic.
1035   Dragonfly BSD
1037     * userspace support update
1039   FreeBSD
1041     * Updated vnode locking for children returned via lookup().
1043     * Avoid file open undercount with needed calls to
1044       FakeOpen/FakeClose().
1046     * Use vnode_pager_setsize to properly track file size during kernel
1047       IO.
1049     * Update system call installation.
1051     * Fix shutdown of Rx kernel listener to avoid potential dereference
1052       after it's gone.
1054     * Avoid closing vnodes during vnode recycle.
1056     * Fix bogus call to FlushVS for vnode reclaims.
1058   Linux
1060     * Packaging updated for current configure options and built files.
1062     * Cache bypass now holds reference on pages during readpage.
1064     * s390x setgroups32 patching update.
1066   MacOS
1068     * DNS resolver is reinitialized on IP address change. (126440)
1071 OpenAFS 1.5.76 (2010-08-16)
1073   All platforms
1075     * Updates to build-time configuration.
1077     * Fix XDR support in Rx to match header definition.
1079     * vos status now shows transaction creation, not action creation.
1081     * Rx avoids reporting loopback adapters when listing interfaces.
1083   All server platforms
1085     * Demand-Attach Fileserver always built and installed (dafileserver,
1086       davolserver, dasalvager).
1088     * Return VNOVOL from fileserver when a volume is deleted.
1090     * Ignore duplicate tags during volume restore operation.
1092     * Update inode array after salvage repairs volume.
1094     * Zero a corrupted header in memory during salvage to avoid further
1095       corruption.
1097     * Fix NAMEI backend to allow low-numbered volumes to work properly.
1099     * ptserver does not include cell name as part of length check for
1100       names.
1102     * Updated error messages for unblessed volumes.
1104     * vlserver avoids buffer overflow with regex pattern
1106     * Attach-time failures now note failures as the rest of the fileserver
1107       would.
1109     * Server argument logging will no longer overflow stack.
1111     * Provide fast-restart-like unsafe-nosalvage option for DAFS.
1113     * Deal with host hash collisions in the fileserver.
1115   Microsoft Windows
1117     * Avoid crashing when interpreting a drive letter as potentially
1118       matching a cell name.
1120     * Properly handle volume package errors.
1122     * Allow page recycling from known-readonly content without ensuring
1123       they are not dirty.
1125     * 32 bit tools installer should not override client configuration.
1127     * Ensure root scache item has a valid callback when use is attempted.
1129     * Freelance directory changes now properly invalidate and replace the
1130       old root object.
1132   All UNIX client platforms
1134     * Support disconnected reconnecting with specified UID for PAGless
1135       platforms.
1137     * Proper disconnected vnode reference tracking.
1139     * Update server site blacklisting to not return success if nothing was
1140       blacklisted.
1142     * Avoid a panic during vcache contention due to CVInit vcache
1143       racing. (127645)
1145   FreeBSD
1147     * Update for network stack in 8.1/9.0.
1149   HP-UX
1151     * Bug fixes.
1153   Linux
1155     * 2.6.36 support
1157     * Disable PMTU error packet handling.
1159     * flock() fixes.
1161     * Debian packaging updated.
1163     * freezer interface updates.
1165   MacOS
1167     * Hold references to disconnected mode written vnodes properly.
1169   Solaris
1171     * Handle NFS translator module references for amd64.
1173     * INODE fileserver backend support now exists for amd64.
1176 OpenAFS 1.5.75 (2010-07-07)
1178   All platforms
1180     * Prevent rx_rpc_stats global lock from being a bottleneck.
1182     * Path MTU discovery is now provided to allow traffic to pass networks
1183       with sub-1500 byte MTUs and poor fragment handling.
1185     * Further reduce Rx NAT ping transmission when enabled.
1187     * Update Kerberos 5-based token handling in rxkad from upstream
1188       Heimdal.  (127554)
1190     * Update version numbers emitted during build to reflect what is
1191       actually being built.
1193     * Add "-human" switch for human-readable units in fs diskfree and
1194       listquota. (124529)
1196     * vos provides reasons for locked volumes when known.
1198     * Do not count retransmission and ping acks as non-idle for Rx
1199       connections.
1201     * Rx: provide service-specific data getter and setter routines.
1203     * Update build-time Kerberos detection.
1205     * Updated userspace AFS client.
1207     * Beginning of a modernized test suite.
1209     * Additional documentation.
1211     * Updated documentation, notably the Administrators Guide.
1213     * Substantial code cleanup.
1215   All server platforms
1217     * Update handling of vnode allocation failures.
1219     * DAFS: allow salvaging volumes not known to the fileserver, to allow
1220       cleanup of data not attached to a current volume.
1222     * Properly handle volumes slated for destruction.
1224     * Handle volumes with many files properly.
1226     * Force core file generation in bosserver by overriding default
1227       resource limits when possible.
1229     * Update vlclient and vldb_check.
1231     * Avoid potentially corrupting a volume on creation if files are left
1232       from previous failed cleanup.
1234     * Note volume changed during salvage as needed.
1236     * DAFS: do not assume invalid addresses are in fileserver address hash
1237       table.
1239     * Avoid tying up fileserver threads with volumes that are being taken
1240       offline.
1242     * Do not set inUse on volumes for non-DAFS other than in fileserver.
1244     * Break origin's callback on target of rename operation.
1246     * Avoid unneeded parent directory link updates during some rename
1247       operations.
1249     * Do not open /dev/console for writing in the fileserver.
1251     * DAFS: avoid spurious restarts when binary restarts are configured.
1253     * Avoid spurious and unneeded calls to sync(), which can slow down the
1254       fileserver.
1256   Microsoft Windows
1258     * Revised SMB QuerySecurityInfo to address issues caused by MS10-020
1259       (http://support.microsoft.com/kb/980232)
1261     * Prevent use of the AFSCache file contents if mapped to a new
1262       address.
1264     * Make fs newcell include behavior compatible with the non-Windows
1265       version.
1267     * Provide a registry option (FreelanceImportCellServDB) to pre-create
1268       mount points in the AFS root for all cells in CellServDB.
1270     * Fix a memory leak in the cm_FreeServerList() routine.
1272     * Reduce privilege when reading registry CellServDB.
1274     * Add support for RPC Pipe Service NetWkstaGetInfo levels needed for
1275       Windows 7.
1277     * Prevent overflow when computing quota percentage in Explorer Shell.
1278       (126846)
1280     * Generate meaningful errors for ACL operations on freelance AFS root.
1282     * Fix error handling on InlineBulkStatus RPCs.
1284     * Show configuration pages for all types of MSI installations.
1286     * Improve freemount AFS root directory handling and operations.
1288     * Properly validate GetVolumeStatus pioctl responses.
1290     * Commit file length changes and dirty buffers when flushing a file.
1292   All UNIX client platforms
1294     * Update version of files for disk cache.
1296     * Do not call afs_FlushVCBs with xvcache lock held, to improve
1297       parallelization.
1299     * Add mariner log messages for creating and removing files.
1301     * Don't hold xvcache lock while creating symlinks, to improve
1302       parallelization.
1304     * Provide -dynroot-sparse mode to not show all cells in CellServDB in
1305       dynroot mode.
1307     * Avoid a potential crash in aklog in linked cell handling.
1309     * Log MTU-caused packet retransmission.
1311     * Prevent crashes caused be fs checkservers while cache is being set
1312       up.
1314     * fs getserverprefs now has a buffer large enough for the default
1315       CellServDB.
1317     * Report server address when logging warnings.
1319     * Avoid panic in GetCapabilities when cell is not known.
1321     * Lock process name and id for advisory lock warnings when possible.
1323     * Handle need for allocating additional Rx packets.
1325     * Properly handle errors from InlineBulkStatus operations.
1327     * Fix errors returned from fcntl() on readonly files locked for write.
1329     * Flush pending changes to the server on LOCK_EX unlock.
1331     * Reflect length changes as a result of callbacks even when file is
1332       open for write.
1334     * Avoid hanging due to error exit when attempting to store a large
1335       file to a non-largefile fileserver.
1337     * Recover from afs_GetVolSlot errors.
1339   FreeBSD
1341     * Bugfixes for kernel VFS and network routines.
1343   IRIX
1345     * Provide makesname().
1347   Linux
1349     * Avoid syscall probes when keyrings are present, by default. (125215)
1351     * Remove "Big Kernel Lock" from VFS operations.
1353     * Use filehandles for all Linux 2.6 versions to avoid need for matched
1354       afsd. (127530)
1356     * Updated RPM packaging.
1358     * Fix dkms configuration provided with RPMs.
1360     * Hold reference on pages during background I/O for cache bypass.
1362     * Fix cache bypass handling of non-largefile fileservers.
1364     * Protect truncate_inode_pages mappings with mutex or semaphore as
1365       needed.
1367     * Fix pagevec use in cache bypass. (127505)
1369     * Updates for 2.6.35
1371   MacOS
1373     * Improve launchd configuration.
1375     * Avoid hanging on recursive cache file lock acquisition when user
1376       notification is enabled.
1378     * Fix and re-enable bulkstat mode.
1380   OpenBSD
1382     * Build updates.
1384   Solaris
1386     * Precluding unmount while AFS is busy.
1388     * Avoid deadlocking when releasing the VFS object.
1390     * Stop network interface poller in kernel on AFS shutdown.
1392     * Avoid issues with lookups on empty directory names. (127356)
1395 OpenAFS 1.5.74 (2010-04-22)
1397   All platforms
1399     * Add "vos setaddrs" command.
1401     * Rx library lock contention avoidance between rx_NewCall and
1402       rx_EndCall.
1404     * Rx library races due to inconsistent use of rx_connection
1405       conn_data_lock to protect the flags field.
1407     * Rx library inconsistent use of RX_CALL_TQ_WAIT which could result in
1408       deadlocks.
1410     * Rx library must signal transmit queue waiters when flushing.
1412     * afsmonitor shows busy counts now.
1414     * afsmonitor displays xstat callback statistics.
1416     * Provide expandgroups for pts mem on a supergroups server.
1418     * Provide supergroup option to liste nested groups during pts mem.
1420   All server platforms
1422     * Avoid volume lock contention during DAFS startup.
1424   Microsoft Windows
1426     * Avoid a race when updating cell vldb server lists that can result in
1427       a crash.
1429     * Avoid a deadlock when managing CM_SCACHESYNC_STOREDATA state
1430       operations for directory objects.
1432     * Add new Windows Application Event log messages for VBUSY,
1433       VRESTARTING, ALL_BUSY, ALL_OFFLINE, and ALL_DOWN.
1435     * Reduce lock contention by waiting for cm_buf_t I/O operations.
1437     * Split the cm_buf_t flags field to separate the flags that are
1438       protected by the cm_buf_t mutex from those protected by the
1439       buf_globalLock.
1441     * In cm_UpdateVolumeLocation, avoid searching for a ".readonly" volume
1442       on a numeric volume name.
1444     * File buffer allocations whose offsets are beyond server EOF should
1445       be locally allocated and zero filled.  The file server should not be
1446       issued a FetchData rpc which is guaranteed to fail.
1448     * Enable integrated logon to work with Windows 7/2008 when user logons
1449       are performed with a non-Domain Kerberos principal.
1451     * Add Protection Error messages to aklog output.
1453   All UNIX client platforms
1455     * Provide a FUSE-interfacing userspace afs client.
1457     * Updates to libuafs userspace cache manager.
1459     * Probe servers using GetCapabilities instead of GetTime, thus
1460       requiring fewer RPCs.
1462     * Fix DNS SRV record handling for cell lookup.
1464   FreeBSD
1466     * Fix sleep/wakeup routines.
1468     * Update for 8.0 release.
1470   Linux
1472     * Handle high memory addresses correctly.
1474   MacOS
1476     * Make 32 bit AFS syscalls work again.
1478     * Work around finder "Duplicate" failure (caused by setting modes on
1479       symlinks).
1481     * Disable bulkstat again (will be re-enabled at or before .75).
1483     * Provide symlink type hints during readdir.
1486 OpenAFS 1.5.73 (2010-03-24)
1488   All platforms
1490     * NAT keepalive support at Rx level.
1492     * Corrected SRV record support for cell name canonicalization.
1494   All server platforms
1496     * Fix volume callback notification to not notify unaffected clients.
1497       (126497)
1499     * Allow root directory recreation by salvager. (94658)
1501     * Numerous DAFS fixes.
1503     * Improvements to callback table overflow handling. (126451)
1505     * bosserver now shuts down cleanly on SIGTERM.
1507   Microsoft Windows
1509     * Prevent the Explorer Shell extension from crashing if symlink
1510       creation failed.  (126406)
1512     * A Rx level NAT ping has been implemented. A registry value enables.
1514     * Adds krb5 error message translation to aklog, afscreds,
1515       afslogon.dll, the network identity manager afs provider and
1516       translate_et.
1518     * Default mode bit settings for file and directory creation are now
1519       provided, and can be configured.
1521     * An SMB request trace facility is provided and can be enabled for
1522       debugging.
1524   All UNIX client platforms
1526     * Rx idle deadtime does not stop file writes.
1528     * Disconnected AFS no longer has a race condition during remove ops.
1530     * Fakestat avoids a condition which could cause it to block on network
1531       activity.
1533     * Several fixes to handle interruptions in vos operations. (33360,
1534       125535)
1536     * Allow more sysnames in a sysname list.
1538     * Attempt to enforce timeouts on AFSDB lookups.
1540   AIX
1542     * Clean up properly on mount failure.
1544     * Add entry to /etc/vfs to allow umount to work.
1546   Linux
1548     * Several issues to deal with older kernels.
1550     * Avoid leaking the global lock in the /proc cellservdb code.
1552     * Keyring destruction now cleans up all tokens.
1554     * Keyring quotas are not enforced against root.
1556   MacOS
1558     * Some FSEvents hinting for authentication events now done. (23781)
1560     * Update uninstaller. (125634)
1562     * Rewrite afssettings and fstab code to avoid licensing issue with
1563       APSL.
1565     * Growl client for user monitoring of AFS events included.
1567     * Properly support insert-only dropboxes.
1569     * Add bulkstat support.
1571     * Include support for moving in Finder across mount points.
1573     * Preferences Pane includes support for Kerberos 5 ticket renewal.
1576 OpenAFS 1.5.72 (2010-02-15)
1578   All platforms
1580     * Provide internationalization support in com_err.
1582     * Fix array length checking to avoid crashes when checking for a
1583       volume type based on name in vos.
1585   All server platforms
1587     * Provide backward compatible "-f" flag to salvager for force mode.
1589   Microsoft Windows
1591     * Restore use of DNS AFSDB and SRV records by kaserver clients.
1593   All UNIX client platforms
1595     * Fix client cache file truncation to not lose chunks when truncating
1596       a large file.
1598     * Ensure a cache writeback hook is installed in the client (bug from
1599       1.5.71).
1601     * Avoid spurious free memory warnings during clean shutdown.
1603     * Fakestat mode avoids AFSDB lookups.
1605     * "fs storebehind" now correctly reports errors on readonly volumes.
1607     * Additional documentation for "fs getcacheparms"
1609     * Forced new uuid generation with "fs uuid -generate" now works
1610       enforced permission correctly.
1612   MacOS
1614     * Add optimized Rx event handler in kernel.
1616     * Installer now allows installing an older version.
1618     * Panic decoder can now deal with MacOS 10.5 again.
1620     * MacOS ._ files are now correctly not looked up as cellnames.
1622   Linux
1624     * To deal with SELinux file labeling, try cache accesses with current
1625       credentials in event of failure.
1627     * Rx XDR encoding bug on i386 Linux is fixed (bug introduced in
1628       1.5.71).
1630   IRIX
1632     * Code compilation fixes.
1634   OpenBSD
1636     * Update for OpenBSD 4.6.
1639 OpenAFS 1.5.69 (2010-01-19)
1641   All platforms
1643     * Configuration of BOSserver no longer defaults to weekly restarts
1644       enabled.
1646     * Provide BOS restricted mode by default.
1648     * Add support for "vos endtrans" command.
1650     * Default to providing full output from vos listvol.
1652     * Correct additional-address tracking in the fileserver.
1654     * Improve Rx performance by not unnecessarily dropping and reacquiring
1655       call locks in read and write processes.
1657     * Avoid crashes when monitoring volserver transactions across
1658       potential transaction garbage collection.
1660     * Numerous warning fixes.
1662   All server platforms
1664     * Avoid saving fileserver state in demand attach fileserver when
1665       panicing.
1667     * Demand attach fileserver allows other callers to schedule salvages.
1669     * Demand attach "bos salvage" now works correctly with restricted
1670       mode.
1672   Microsoft Windows:
1674     * Numerous changes to the client-internal btree directory handling to
1675       prevent errors.
1677     * fs examine reports owner and group ids as signed values (PTS groups
1678       are negative).
1680     * Preclude corruption due to races writing to smb buffers.
1682     * Allow MTU settings in registry to be used.
1684     * Apply MTU to both send and receive sizes.
1686   All UNIX client platforms
1688     * Avoid double-freeing Rx call structure if reading a response from
1689       the file server results in a short read.
1691     * Handle negative lengths in FetchStatus results correctly.
1693     * Properly clean up allocated memory at shutdown.
1695     * Default to AFSDB compiled into the cache manager.
1697     * Avoid inadvertant disclosure of stat() information to clients not so
1698       entitled.
1700     * Correct a bug with AFSDB lookups introduced with SRV record support.
1702   MacOS
1704     * Install kernel panic processing tool in /Library/OpenAFS/Tools.
1706     * Include debugging symbols for kernel extension in additional package.
1708     * Support "Application Firewall" users.
1710     * Avoid ._cellname AFSDB lookups.
1712     * Compile preferences pane as a universal binary.
1714   Linux
1716     * Use splice to speed up storing files.
1718     * When using memcache, avoid duplicating work in readpages.
1720     * Use dget_parent to safely find an inode's parent.
1722     * Disable access time updates in our superblock.
1724     * Avoid crashing doing writeback if no credentials were stashed at
1725       file open.
1727     * Simplify keyring support.
1729     * Properly clean up vcache in event of failed mount.
1731   FreeBSD
1733     * Update for current FreeBSD 8.
1735   Solaris
1737     * Abstractly manipulate groups as now required.
1739     * Abstractly access time instead of using lbolt directly.
1742 OpenAFS 1.5.68 (2009-12-08)
1744   All platforms
1746     * aklog now attempts to convert non-AFS errors to human-readable
1747       strings.
1749     * Make stack not executable when compiling assembler source with GCC.
1751     * Numerous source warning cleanups and code reorganization.
1753   All server platforms
1755     * Compute midnight for volume statistics calculation from local time.
1757     * Salvager now orphans duplicate special inodes when running to allow
1758       recovery in event of a problem, instead of simply ignoring the
1759       issue.
1761     * Support to ensure a server panic attempt leaves a core and thus
1762       restarts in a timely manner, rather than potentially hanging. Use
1763       panic to attempt cleanup before leaving a core when possible.
1765     * Volume sync data reported during bulkstatus is now set correctly.
1767     * Provide better tuning for fileserver file descriptor caching.
1769     * Allow more than 128 threads in fileserver by modifying host
1770       structure in-use tracking.
1772     * Avoid crashes getting volume server status during transaction
1773       cleanup.
1775     * Improved logging of offline volume conditions.
1777     * Correct volume statistics when cloning a volume.
1779     * Avoid referencing host structures in the fileserver which are marked
1780       for deletion.
1782     * Demand attach fileserver corrections to avoid coring during an
1783       aborted startup.
1785     * host array bounds checking corrections to avoid buffer overflow.
1787     * Handle special inodes correctly when promoting an inode fileserver
1788       readonly volume to read-write.
1790   Microsoft Windows
1792     * Set the DOS Readonly attribute on a file/directory whenever the unix
1793       mode combined with the mask 0200 is true.  Previously there was a
1794       discrepency between the mask used for testing for readonly behavior
1795       and that used for setting the attribute.
1797     * Disable AFSVolSync based .readonly "whole-volume callback" support
1798       because the all file servers prior to 1.5.67 (and perhaps 1.4.12) do
1799       not properly assign a value to the AFSVolSync structure in bulk
1800       status RPC responses.
1802     * Improve the error output from aklog to output the value from krb5
1803       error_message() if the afs_com_err output indicates an unknown
1804       value.
1806     * Convert VBUSY and VRESTARTING to CM_ERROR_ALLBUSY and do not permit
1807       them to be exposed to the smb redirector.
1809     * Convert STATUS_TIMEOUT responses to STATUS_IO_TIMEOUT to avoid
1810       confusion within the smb redirector.
1812     * Fix the byte order assigned to port numbers associated with AFSDB
1813       record lookups.  They must be network byte order not host byte
1814       order.
1816     * Add dynamic server ranking based on RPC round trip time
1817       measurements.
1819   All UNIX client platforms
1821     * Additional shutdown-time memory leaks removed.
1823     * Improved logging of resource contention.
1825     * Provide dumping for Rx debug packet tracking support in source.
1827     * Update afscp test client to build, and provide an unlock client.
1829     * Client buffers for directory parsing can now be allocated beyond the
1830       fixed set formerly provided.
1832     * Work around race condition when manipulating read-only volume
1833       callbacks.
1835     * Bugfixes to get PAG value pioctl.
1837     * Bugfixes to SRV record support.
1839   Linux
1841     * Path MTU tracking code cleanup.
1843     * Avoid an oops due to racing with vcache recycling thread.
1845     * Changes to keyring PAG handling: for sufficiently new kernels, use
1846       only keyring-based PAGs, and disable group PAGs entirely.
1848     * Updates to the kernel page cache interface: writing pages will now
1849       not spuriously leak page locks, and will avoid requiring duplicate
1850       work.
1852     * Credential references are now tracked using native atomic counters.
1854     * Kernel mutex/semaphore lock ordering fix to avoid deadlocks.
1856     * Manipulate disk cache with credentials used to initialize it, to
1857       avoid security issues.
1859   MacOS
1861     * Fix fstrace message catalog location.
1863     * Fix kernel fstrace logging.
1866 OpenAFS 1.5.66 (2009-10-25)
1868   All platforms
1870     * Avoid calling exit() in library code.
1872     * Add rx window size and peer timeout tuning APIs.
1874     * Correct rx peer timeout handling to disallow 0ms timeouts.
1876     * Correct calculation of rx RTT by disregarding retransmitted packets.
1878     * vos manpages updated to reflect changes in recent versions.
1880     * GNU-style long options (e.g. --cell) are now supported in all
1881       commands.
1883     * fs listacl can now print a command to recreate the current ACL.
1885   All server platforms
1887     * Fix a race on transaction objects in the volserver which can cause a
1888       crash.
1890     * Avoid destroying and setting to NULL the callback connection when it
1891       could still be being used.
1893     * Correct unlink handling in salvager.
1895     * Improve error messages due to I/O errors in the volserver.
1897     * Correct an issue which caused converted RO to RW volumes on namei
1898       fileservers to not come online immediately.
1900   Microsoft Windows
1902     * Official support for Windows 7 and Server 2008 R2.
1904     * Prevent a file server bug (FetchData returning an invalid length
1905       instead of zero) from causing an "unexpected network error" when
1906       writing to files.
1908     * Promote DNS SRV records as superior to DNS AFSDB records.  Support
1909       arbitrary port numbers for vldb servers.
1911     * Add AFSVolSync based .readonly "whole-volume callback" support.
1912       With this functionality, multiple objects from a .readonly volume
1913       can have their status validated by issuing a single
1914       RXAFS_FetchStatus RPC.
1916     * Remove drive mapping functionality and service start/stop from
1917       afscreds.exe.
1919     * Remove drive mapping functionality from afs_config.exe.
1921     * Use {HKLM,HKCU}\SOFTWARE\OpenAFS\Client DWORD "ShowMountTab" to
1922       restore access to drive mapping functionality in afscreds.exe and
1923       afs_config.exe.
1925     * Adjust SMB error return codes to avoid returning STATUS_TIMEOUT
1926       which results in the SMB redirector disconnecting.
1928     * Network Identity Manager OpenAFS Provider now provides its own "AFS
1929       lock" notification icon to report the status of "have tokens, have
1930       no tokens, service not started, service started but inaccessible".
1931       Hovering over the icon lists the cells for which tokens exist (if
1932       any) and the OpenAFS version number.  Double-clicking executes the
1933       Network Identity Manager default action.
1935     * Prevent pioctl calls from retrying indefinitely when a sharing
1936       violation error occurs.
1938   All UNIX client platforms
1940     * Correct a condition which could discard the error from initializing
1941       a fetch request.
1943     * Avoid using invalid references to afs_Conn connection structures,
1944       and thus potentially producing invalid data when a retry is needed.
1946     * SRV records are now supported for discovering AFS servers.
1948   Linux
1950     * Correct writepage behavior.
1952     * Fix error code handling in the writepage code.
1954     * Avoid leaking page locks, which could potentially hang a machine.
1956   MacOS X
1958     * Preferences Pane improvements.
1960   HP-UX
1962     * Avoiding attempting to handle critical signals in servers, so that
1963       core file handling works correctly.
1966 OpenAFS 1.5.65 (2009-10-06)
1968   All platforms
1970     * Code compilation warning fixes, to enable better finding and
1971       tracking bugs.
1973     * Provide configure-time switch to enable code warning compilation.
1975   All server platforms
1977     * Demand-attach fileserver now makes volume LRU list operations
1978       exclusive operations to avoid races during adding to the list.
1980     * Fileservers now avoid potential "negative length" fetches.
1982     * A leak in host tracking objects in the fileserver has been fixed.
1984     * Salvager now unlinks all files by full path, to deal with the change
1985       to not chdir for core file tracking.
1987     * Salvager avoids asserting if the volume header is unreadable.
1989     * Demand-attach fileserver puts back volume references from fssync
1990       handlers when done.
1992   Microsoft Windows
1994     * Improved service response to suspend and shutdown event
1995       notifications.
1997     * Avoid a bug in the file server that can result in an invalid length
1998       being returned as part of a fetch data response if the client
1999       attempts to read beyond the length of the file.
2001     * Do not publish a default stream object for directories and mount
2002       point objects.  This was impacting the ability of some Windows XP
2003       systems to save roaming profiles.
2005   All UNIX client platforms
2007     * A bug which could cause erroneous handling of lengths on data reads
2008       has been fixed.
2010     * A bug where erroneous length returns from the fileserver could
2011       result in a false error has been fixed.
2013   Linux
2015     * Background page copies are now supported for enhanced disk cache
2016       read performance.
2018     * Blocking readahead is supported in readpages() to reduce overhead.
2020     * Use readpage() instead of read() to access cache data to avail disk
2021       cache users of the kernel backing cache for improved performance.
2023     * Minimize credential handling for improved performance.
2025   MacOS X
2027     * Preferences Pane cleanup.
2029   Solaris
2031     * Provide a fs_pathconf method with sensible defaults.
2033     * Provide a _PC_FILESIZEBITS method to fix some NFS translator
2034       consumers.
2037 OpenAFS 1.5.64 (2009-09-22)
2039   All server platforms
2041     * The demand attach fileserver now puts back volume references gotten
2042       via the fssync interface.
2044     * The demand attach fileserver had a structure reference error, which
2045       has been correected.
2047   Microsoft Windows
2049     * Restores Windows 2000 compatibility.
2051     * Fixes a data consistency error between the output of NetWkstaGetInfo
2052       and NetServerGetInfo RPCs, specify the Lan workstation group name
2053       "AFS", and report server name as "AFS" instead of "\\AFS" when the
2054       caller asks for "\\AFS".
2056     * Enables executables to be run from \\AFS on Windows 7.  Returns
2057       "Name not found" instead of "File not found" when a directory or
2058       file name cannot be found.  This avoids loader errors when system
2059       dlls cannot be located in the executable directory.
2061     * Prevents cache manager from marking the file server "down" when the
2062       data returned in response to either RXAFS_FetchData64 or
2063       RXAFS_StoreData64 is invalid.
2065     * Adds pioctl data validation to the AFS Explorer Shell extension.
2067   All UNIX client platforms
2069     * A bug which could cause a kernel panic in 1.5.63 has been corrected.
2070       This would manifest as a GetDCache panic or oops.
2072   Linux
2074     * aklog -setpag works again with recent kernels when keyring is in
2075       use.
2077   MacOS
2079     * When Fast User Switch is in use, AFS login is now handled correctly
2080       by the integration tool included with the preferences pane.
2082     * Several packaging bugs have been corrected.
2085 OpenAFS 1.5.63 (2009-09-11)
2087   All platforms
2089     * The restorevol command is now documented and installed as a user
2090       command.
2092     * The uss command now properly translates vldb entries to its expected
2093       format when handling them in all cases.
2095     * Documentation now refers to Kerberos instead of kaserver.
2097   All server platforms
2099     * bosserver now handles BosConfig.new when restarting, allowing
2100       configuration to be replaced at restart time rather than with bos
2101       delete and bos create.  Documentation is updated to reflect this.
2103     * The demand attach fileservice not longer potentially hangs trying to
2104       terminate demand-salvages which have already exited.
2106     * The demand attach fileservice has been modified to avoid spurious
2107       'SYNC_putRes: write failed' warnings when some protocol messages
2108       cannot be acknowledged due to the sender terminating the connection.
2110     * In the event of failure to contact the vlserver or ptserver, the
2111       fileserver will not exit and trigger a forced salvage. It will
2112       continue to try in the background to contact the needed services.
2114     * The salvager can now repair certain cases of a damamged vnode index.
2116     * The accessDate metadata for a volume is now updated correctly.
2118   Microsoft Windows
2120     * CRITICAL: Some applications for example those based on Cygwin were
2121       unable to access data stored in the AFS name space.  Explorer Shell
2122       also experienced inconsistent behavior.  This is fixed.
2124     * CRITICAL: Multiple AFS pioctl requests issued nearly simultaneously
2125       by applications could result in pioctl responses being received by
2126       the wrong requester.  This in turn could result in application
2127       crashes.  symlink.exe, fs.exe, afslogon.dll, afscreds.exe, and the
2128       netidmgr afscred.dll plugin were all affected.
2130     * Some XP machines running 1.5.62 had trouble saving roaming profile
2131       data.  This is fixed.
2133     * Integrated Logon (afslogon.dll) did not function with domain
2134       specific configurations.
2136     * Ensure that access denied and over quota errors experienced while
2137       storing data to the file server do not result in on-going retry
2138       attempts.
2140   All UNIX client platforms
2142     * Except on Solaris and AIX, the compiler may now be overriden at
2143       configure time by setting the CC environment variable.
2145     * afsd now properly deals with large cache partitions.
2147   FreeBSD
2149     * Build shared libafsauthent and libafsrpc.
2151   Linux
2153     * Kernel module DKMS support now installs an unstripped module to
2154       allow debugging information to be collected.
2156   MacOS
2158     * Preferences pane properly updates token information.
2160   MacOS 10.6
2162     * klog will now properly handle passwords of 8 or fewer characters
2163       with an AFS string to key on hosts able to run 64 bit binaries.
2165     * A panic at AFS shutdown due to "NO PCB" on a udp_lock has been
2166       addressed.
2168     * The panic decoder script included in the source now properly handles
2169       32 and 64 bit panics.
2171   NetBSD
2173     * Avoid defining AFS_KERBEROS_ENV globally as it creates a circular
2174       dependency.
2176     * Build shared libafsauthent and libafsrpc.
2178   OpenBSD
2180     * Build shared libafsauthent and libafsrpc.
2183 OpenAFS 1.5.62 (2009-08-28)
2185   All platforms
2187     * Numerous invisible changes to improve code maintainability,
2188       portability and enhanceability.
2190   Microsoft Windows
2192     * CRITICAL: Fixes two errors that can result in data loss when storing
2193       data to the file server.
2194       1. Failure to Store Portions of Unaligned Writes
2195       2. Failure to Store Data to File Servers Lacking Large File Support
2196       Read the announcement for more details:
2197         http://www.openafs.org/pipermail/openafs-announce/2009/000305.html
2199     * CRITICAL: The cache manager daemon thread could terminate when the
2200       machine enters suspend mode.  This daemon thread performs the
2201       background check of down servers, offline volumes, callback
2202       expirations, etc.
2204     * CRITICAL: Integrated Logon (afslogon.dll) was terminating
2205       unexpectedly.  Error checking has been improved and NULL pointer
2206       dereferences after Lsa API calls fail have been eliminated.
2208     * For the first time, the OpenAFS SMB Server supports the DCE RPC
2209       services SRVSVC and WKSSVC.  Browsing \\AFS with the Explorer Shell
2210       or NET VIEW will now be faster and provide additional functionality.
2211       No longer will cell names longer than 12 characters be truncated.
2213     * Improvements to DFS Referral request processing have been
2214       implemented.
2216     * Unnecessary DNS lookups of share names are avoided improving
2217       performance.
2219   All UNIX client platforms
2221     * Non-Kerberos PAM modules work correctly again.
2223   MacOS X
2225     * MacOS 10.6 (Snowleopard) is now supported, both 32 and 64 bit mode.
2227     * Updates to the AFSCommander preferences pane.
2229     * Installer now permits cell names with dashes.
2232 OpenAFS 1.5.61 (2009-08-06)
2234   All platforms
2236     * Correct another race condition in the Rx library that could result
2237       in an unexpected panic while freeing the Rx call iovq.
2239     * rx packet resend and data packets sent counts were incorrect.
2241     * fs setquota, fs setcachesize, vos setfields, and vos create now
2242       accept human readable orders of magnitude. (K, M, G)
2244     * fs listquota fixed to permit large quota sizes to be displayed.
2246     * Correct documentation of bosserver permissions requirements.
2248     * Modify vlserver to avoid potentially corrupting the database through
2249       volume id reuse.
2251     * Generalized support for fast Rx timeout due to network
2252       down/unreachable.
2254   All server platforms
2256     * Allow audit logs to be sent via sys5 IPC message queues instead of
2257       logged directly.
2259   Microsoft Windows
2261     * If a file server becomes inaccessible while the cache manager has
2262       dirty buffers to write, the afsd_service buf_IncrSync thread can
2263       attempt to use 100% of the cpu.
2265     * Fix "fs newcell" which was broken in 1.5.60.
2267     * Do not attempt to synchronize dirty buffers if the associated volume
2268       is known to be unavailable.
2270     * Modify behavior of a Freelance mountpoint target that does not
2271       specify a cell.  Instead of assuming the target volume is in the
2272       Freelance.Local cell, use the workstation "Cell" specified in the
2273       registry. A mountpoint target of "#root.cell." will now mean the
2274       root.cell volume in the workstation cell for the current session.
2275       If the workstation cell changes from "athena.mit.edu" to
2276       "andrew.cmu.edu", the referenced volume will also change without
2277       requiring that the mount point targets be altered.
2279     * Add cm_FindServerByUuid().  Re-implement RXAFS_InitCallBackState3()
2280       to permit the server Uuid to be used to lookup the server object and
2281       from that determine the cell.  This permits callbacks that are
2282       received from alternate addresses to be processed with a known
2283       server object.  Previously a request from an unknown server would
2284       clear all callbacks from all cells.
2286     * Fix a bug that prevented optimal performance when using a non-zero
2287       value for 'daemonCheckVolCBInterval'.  As a reminder, when
2288       "daemonCheckVolCBInterval" is set to a non-zero value, all .readonly
2289       volume callbacks are automatically renewed 90 minutes before their
2290       expiration.
2292     * Fix automatic ranking of vldb servers whose values are obtained from
2293       the CellServDB file.
2295     * Add failover for RX CALL TIMEOUT errors when the volume is readonly
2296       or the call is to a vldb server.
2298     * Add registry based cell search functionality to NetIdMgr,
2299       afs_config.exe, and klog.exe.
2301     * afsconf_GetCellInfo() has been modified to perform gethostbyname()
2302       lookups on the host names in the CellServDB instead of using the
2303       specified IP addresses.  This provides aklog, pts, vos, etc. the
2304       same CellServDB behavior that the Windows Cache Manager uses.
2306     * When updating the stat cache entry callback of a .readonly object
2307       from the volume group object, update the file server reference to
2308       ensure it matches the most update to date callback.
2310     * Add proper support for processing callbacks from multi-homed file
2311       servers.  Instead of comparing servers by cm_server_t pointer,
2312       compare them by UUID when the UUID is known.
2314     * During a shutdown short circuit the offline volume check daemon
2315       functionality.
2317     * Return the error code of RXAFS_FetchData / RXAFS_StoreData in
2318       preference to an error code reported by rx_EndCall.
2320     * Add "PerFileAccessCheck" registry value to permit testing against
2321       experimental file servers that include per-file acl support.  This
2322       value is intentionally undocumented.  It is not to be used by
2323       production environment deployments.
2325     * Fix a bug introduced in 1.5.60 that prevents the afs netidmgr
2326       provider from obtaining tokens when referrals are in play.
2328     * Add "fs chown" and "fs chgrp" commands to permit the owner and group
2329       of objects stored in AFS to be set from Windows.
2331     * Avoid performing background daemon operations when the machine is
2332       going into suspend mode.
2334     * Perform offline volume checks in most recently used order.
2336     * Prevent crash when a data version for a cache object goes backwards.
2338     * Multi-thread safe library versions are now being generated and used.
2339       mtafsubik.lib, mtafsutil.lib, mtafsvldb.lib, mtafsvol.lib.
2341     * Microsoft SMB Redirector (mrxsmb.sys) support for
2342       ExtendedSessTimeout values are now available on XP through Windows
2343       7.  Add functionality to autodetect if such support is present on
2344       the machine.  If so, configure it if necessary and dynamically
2345       adjust the AFS Rx timeout values accordingly.
2347   All UNIX client platforms
2349     * Fix out-of-tree source builds.
2351   MacOS
2353     * GUI installer now asks for local cell information.
2355     * AFS Commander preferences pane is now installed by default.
2357   Solaris
2359     * Avoid kernel panics due to null pointer dereferences in the network
2360       interface poller kernel thread.
2363 OpenAFS 1.5.60 (2009-05-31)
2365   All platforms
2367     * Retry volserver transaction creation on failure.
2369     * Allow building HTML and PDF documentation from included XML copies
2370       of User Guide, Admin Guide and Quick Start Guide for Unix.
2372     * Documentation updates and additional documentation.
2374     * Add -encrypt support to pts client.
2376     * Convert MR-AFS fs commands to OSD commands.
2378   All server platforms
2380     * Updated background sync process in fileserver to avoid a race which
2381       could result in a volume being taken offline.
2383   Microsoft Windows
2385     * On April 9th Microsoft released a Hot Fix for Windows Server 2003
2386       SP2 that corrects a deadlock in the smb redirector and also adds new
2387       functionality that permits the AFS SMB server to be given a longer
2388       timeout than is normally the case.  New functionality has been added
2389       to configure these additional LanmanWorkstation\Parameter values.
2390       (This functionality has been backported to XP SP3 and is scheduled
2391       to be released on June 5th.)
2393     * Fix RT#124787, a race condition between "fs flush <dir>", "fs
2394       flushvolume", or "fs flushall" and on-going directory operations
2395       that can result in afsd_service.exe crashing.
2397     * Release Notes, User and Administrator guides are now shipped as
2398       indexed Windows HtmlHelp Files. (.chm).  Shortcuts are provided from
2399       the Start Menu.
2401     * A method of specifying Client CellServDB information within the
2402       registry has been added that can be used to either override the
2403       CellServDB file or force the use of DNS lookups for a given cell.
2404       See the release notes for details.
2406     * The pioctl interface now properly handles drive letter substitution
2407       to UNC paths.  (SUBST <d:> <\\afs\cell\path>)
2409     * The BackConnectionHostNames registry value configuration was broken
2410       when dynamic re-establishment of Netbios Name registrations was
2411       added.  This release restores the functionality.
2413     * All hidden vos.exe commands are now revealed.
2415     * Attempts to store the same dirty file chunk from multiple threads
2416       are now prevented.
2418     * The IsPathInAfs test in Explorer Shell Extension and fs.exe now
2419       permits broken symlinks to be treated as being in AFS.
2421     * vos.exe commands that output 64-bit integer values once again do so.
2422       This was broken in 1.5.59.
2424     * Cygwin Import Libraries are provided in the SDK for all OpenAFS
2425       DLLs.  This permits building cygwin applications against OpenAFS
2426       libraries.
2428     * NSIS installer does a much better job of cleaning up files left over
2429       from previous installs.
2431     * libafsconf.dll moved from Client\Program to Common directory as is
2432       is now used by all modules for CellServDB processing.
2434   All UNIX client platforms
2436     * Write back changes on last store for memcache to avoid discarding
2437       changes.
2439     * Abstract disk cache support to allow for path, fh, inode based
2440       caches with no need for messy ifdef structures each time a new type
2441       is added.
2443   DragonflyBSD
2445     * Support as a userland port.
2447   FreeBSD
2449     * Corrected structure definition for userspace cache manager to allow
2450       builds to complete.
2452   Linux
2454     * Corrected client locking support.
2456     * Updated patch to stop deadlocking in the kernel during mmap.
2458     * Avoid oops when setting up groups for PAGs to match keyrings.
2460     * Use Linux fh-based cache in cases where possible by default.
2462   MacOS 10.3:
2464     * Corrected structure definition for userspace cache manager to allow
2465       builds to complete.
2467   OpenBSD
2469     * Support for OpenBSD 4.5.
2471   Solaris
2473     * Corrected support for server-side vos split interface.
2476 OpenAFS 1.5.59 (2009-04-06)
2478   Microsoft Windows
2480     * Increased service priority class to "High" to match the priority of
2481       system components that are dependent upon the a timely response.
2483     * SMB error responses avoid returning errors that could confuse the
2484       Microsoft SMB redirector into disconnecting the connection to \\AFS.
2486   All UNIX client platforms (except MacOS X 10.4 and 10.5)
2488     * OpenAFS 1.5.59 contains fixes for the client issues addressed by the
2489       security advisories OPENAFS-SA-2009-001 and OPENAFS-SA-2009-002.
2491   Linux platforms
2493     * Support for prerelease Linux 2.6.30 kernels.
2496 OpenAFS 1.5.58 (2009-03-30)
2498   All platforms
2500     * Code cleanup and prototyping.
2502     * Avoid unnecessary blocking in Rx periodic cleanup code.
2504   All server platforms
2506     * Fileserver CopyOnWrite routine optimized for performance.
2508     * Make fileserver callback dumps 64 bit safe.
2510     * Fix byte order issues with fileserver host hashing.
2512     * Fix buffer size issues with butc.
2514     * Fix several Ubik recovery issues.
2516     * Avoid leaking file references in the fileserver.
2518     * Fix a race in DAFS while closing vnodes, and another offlining
2519       volumes.
2521     * volserver interfaces for volume splitting client.
2523   Microsoft Windows
2525     * [RT 124293] A race condition exists which can result in a crash.
2527     * [RT 124276] If the vldb is out of sync with the contents of the file
2528       servers, afsd_service will retry too many times when a file server
2529       reports a volume as not being present.  Now if the list reported by
2530       the vldb is the same as the previously seen list, then the retry is
2531       aborted.
2533     * [RT 124276] Read-only volume failover was broken in 1.5.53 whenever
2534       accessing a volume results in VNOVOL or VMOVED.
2536     * [RT 124276] Prior to 1.3.70 the volume server reference list was not
2537       reference counted and would be prematurely freed while in use.  When
2538       reference counting was added in 1.3.70 a bug was introduced that
2539       could result in service reference list corruption.
2541     * Add Windows Application Event Log warning messages for "Client SMB
2542       MPX value too large" and "Client SMB Buffer Size too small".
2544     * Renaming of files across directory boundaries would result in an
2545       invalid handle error when attempting to access the files after the
2546       move.
2548     * Fix the handling of Tran2 Set Path Info RPCs.  Do not fail when a
2549       smb file descriptor cannot be found.  The whole point of using a
2550       Path Info function is because an smb file descriptor wasn't
2551       allocated.
2553     * More edge cases in which dynamic addition of Freelance root.afs
2554       entries would get the wrong FID or where the root.afs directory
2555       would not be refreshed.
2557     * Buffer overflow could occur if the workstation cell name was longer
2558       than 64 characters.  Crashes could occur in afscreds.exe,
2559       afslogon.dll, and afsd_service.exe.
2561     * VNOSERVICE and VOFFLINE errors were leaking and were exposed to the
2562       smb client.
2564     * Log file server uuid values as part of the cm_server object when
2565       available.  Dump the cm_server object list in response to "fs
2566       memdump".
2568     * Optimize the performance of resetting access control lists when
2569       tokens are set or removed.
2571     * Remove symlink recursion tests and increase max symlink count to 64
2572       from 16.
2574     * Windows specific Rx performance improvements.
2576     * Support for Network Identity Manager 2.0
2578   All UNIX client platforms
2580     * Avoid issues with freeing resources at shutdown.
2582     * Numerous fixes to disconnected AFS.
2584     * Disconnected AFS fixes for replaying changes without double-freeing.
2586     * Attempt to use krb524 principal conversion in aklog if available.
2588   AIX
2590     * Kerberos configuration at build time corrected.
2592   Linux
2594     * Default to dynamic allocation of AFS kernel cache entries to allow
2595       growth for inotify()-pinned entries. (beagle, famd, etc)
2597     * Change client truncation routines to avoid locking issues.
2599     * IA64 port clients fixed on Linux 2.6.
2601     * RPMs now install fstrace message catalog.
2603     * Support through kernel 2.6.29 tested.
2605     * Fix locking issues on CellServDB file in /proc.
2607   OpenBSD
2609     * Support OpenBSD 4.4
2612 OpenAFS 1.5.57 (2009-01-23)
2614   All platforms
2616     * Conditional compilation of rxdebug support is now possible.
2618     * Documentation updates.
2620     * Further race connditions in Rx have been corrected.
2622   All server platforms
2624     * Salvager no longer attempts to recreate headers in the wrong
2625       partition.
2627     * Volumes are properly marked in use on creation and subsequently on
2628       examination with vos.
2630   Microsoft Windows
2632     * Undo the "UAC manifest fix" applied to afs_config.exe.
2634     * Ensure that Freelance allocation of vnodes follow the AFS convention
2635       of odd vnodes are directories and everything else is an even vnode.
2637     * Add Freelance logic to mount point and symlink evaluation functions.
2639     * Enhance smb_ParseASCIIBlock() so that it can handle all of the
2640       STRING formats defined by the CIFS Technical Report 1.0.
2642     * Validate the output of smb_ParseASCIIBlock() in all callers.  Return
2643       CM_ERROR_BADSMB if the STRING field cannot be parsed.
2644       CM_ERROR_BADSMB will cause the contents of the packet to be logged.
2646     * If multiple SMB Raw Write operations were taking place at the same
2647       time, there could be data corruption because unique event objects
2648       were not generated for each Netbios receive operation.
2650   All UNIX client platforms
2652     * Userspace AFS library can now deal with large files when supported
2653       by the platform.
2655     * Numerous updates to disconnected AFS support, including changes to
2656       allow reconnection to work in more circumstances.
2658   FreeBSD
2660     * FreeBSD unstrategy code has been updated.
2662   Linux
2664     * A race during file truncation has been corrected.
2666     * System call probing routines have been updated.
2668     * 2.6.29 is now supported.
2670   MacOS
2672     * 10.3 support has been corrected.
2674   OpenBSD
2676     * Initial OpenBSD 4.4 support.
2678   Solaris
2680     * Updates to allow compiling on newer OpenSolaris are now included.
2683 OpenAFS 1.5.56 (2008-12-30)
2685   All platforms
2687     * libuafs (userspace cache manager) updated to correct several errors.
2689     * Additional rx debugging support is available as a conditional
2690       compile.
2692     * A race condition in Rx leading to a panic has been corrected.
2694     * Rx idle time tracking has been corrected.
2696     * ubik clone server support has been corrected.
2698   All server platforms
2700     * Salvager no longer leaves cores in vice partitions.
2702     * The vol-dump tool now supports dumps larger than 2gb where possible.
2704     * Operations on multiple files now report all FIDs in the audit log.
2706     * butc XBSA support now works correctly on amd64.
2708   Microsoft Windows
2710     * The NetIDMgr AFS Provider automated configuration logic was broken
2711       by the introduction of Kerberos referrals.  If the realm of the
2712       identity cannot be determined, the workstation cell is now assumed
2713       to belong to the newly created identity.
2715     * Avoid a reference count under flow during rename operations.
2717     * Avoid a crash caused by treating an arbitrary length directory
2718       search mask as an 8.3 mask.
2720     * Prevent rename operations if a case insensitive match for the target
2721       name already exists and does not refer to the object being renamed.
2723     * Increase the maximum number of background daemons to 64.
2725     * Fix the UAC manifest applied to afs_config.exe
2727   All UNIX client platforms
2729     * Updates to disconnected AFS support.
2731   FreeBSD
2733     * FreeBSD 7.1 is now supported.
2735     * amd64 FreeBSD is now supported.
2737   Linux
2739     * Generic fh (exportfs API) cache type is now available.
2741     * Avoid some oopses due to backing_dev_info inode fields not being
2742       filled.
2744     * 2.6.28 is now supported.
2746   MacOS
2748     * 10.3 support has been corrected.
2750   Solaris
2752     * Large partition support has been corrected.
2754     * Filesystem-agnostic cache is now available on Solaris 10 and 11.
2757 OpenAFS 1.5.55 (2009-11-10)
2759   All platforms
2761     * Salvager avoids leaving core files in vice partitions.
2763     * NFS translator fixes.
2765     * Unresponsive server handling fixes.
2767     * A volserver race which could result in duplicate transactions is
2768       fixed.
2770   Microsoft Windows
2772     * Fixes a panic caused by corruption of the SMB virtual circuit list.
2773       (race condition)
2775     * Fixes a panic caused by receipt of a UTF-16 string that cannot be
2776       converted to UTF-8.
2778     * Implements a more aggressive recovery algorithm for Netbios errors
2779       that result in loss of communication to the AFS SMB server.
2781     * Improve pioctl response time when testing whether or not a PATH is
2782       in AFS.
2784     * Adds support for linked cells.
2786     * Increases the length of the cell and realm names that can be input
2787       into the Network Identity Manage AFS provider configuration dialog.
2789   All UNIX client platforms
2791     * Disconnected AFS avoids infinite recursion during rmdir.
2793   Linux
2795     * Support for 2.6.28 (not complete for NFS translator modules).
2797     * Support for using exportfs API for filesystem-agnostic cache.
2799     * Disable backing store readahead.
2801     * Avoid deadlocks when writing back mmapped files larger than the
2802       cache.
2804     * Avoid Oops when doing PAG garbage collection.
2807 OpenAFS 1.5.54 (2008-10-08)
2809   All platforms
2811     * Updates for new Tivoli X/Open API finding.
2813     * A double-free is corrected in Rx.
2815   All server platforms
2817     * Ubik cleans up file descriptor cache correctly when doing recovery.
2819     * Enhanced vldb error checker included.
2821   Microsoft Windows
2823     * Prevent a crash that could occur when multiple file / directory
2824       change notifications are processed simultaneously.
2826   MacOS
2828     * AFS claims more free space so Finder will attempt file copies.
2830   Linux
2832     * Avoid spurious ENOENT when calling gwtcwd() on a volume root.
2834     * Avoid spurious ENOTDIR during fakestat.
2837 OpenAFS 1.5.53 (2008-09-26)
2839   All platforms
2841     * rx avoids many packet leaks.
2843     * rx jumbogram disabling now works (and is the default).
2845   All server platforms
2847     * Demand Attach fileserver tries to avoid issues tracking offline
2848       status of volumes.
2850   Microsoft Windows
2852     * Many potential deadlock conditions due to out of order lock
2853       acquisitions have been corrected.
2855     * A race condition resulting in an undercount on the cm_scache_t
2856       reference counts has been corrected.
2858     * An empty string when sent as an ioctl path is now properly
2859       interpreted as meaning the current directory.  This affects "fs
2860       lsm", "symlink list", etc.
2862     * Fix smb string parsing differences where the smb protocol
2863       documentation does not match the actual Windows implementation.
2865     * Random access denied errors fixed.
2867     * A file server lock synchronization issue was corrected in SMB
2868       NTCreateX and NTTranCreate operations.  This bug prevented properly
2869       operation when loading roaming profiles.
2871     * Fix a heap overwrite error during server probe operations if a new
2872       server is added while a probe operation is in progress.
2874     * Fix an LSA memory leak that was the result of an LSA error.
2876     * Do not leak cm_cell_t objects if the VLDB server lookup fails.
2878     * Only initialize rx mutex/lock objects once.
2880     * Do not nul terminate the AFS volume name when reported to Windows.
2882     * Improve VNOVOL error handling.  Prevent updated vl information from
2883       being destroyed immediately after it was acquired.  This bug
2884       prevented proper fail over when volumes are moved or removed from a
2885       server.
2887     * Remove volume id from the server volume list in response to VMOVED
2888       and VNOVOL errors.
2890     * "fs flushXXX" commands now destroy locally built B+ directory trees.
2892     * Prevent mixture of locally modified directory pages and file server
2893       directory pages.
2895     * Fail over to alternate vl servers if a ubik error is returned.
2897   All UNIX client platforms
2899     * Disconnected AFS now supports read-write mode.
2901     * volserver now builds correctly.
2903   AIX
2905     * AIX 6 is now supported.
2907   FreeBSD
2909     * FreeBSD 7 is now supported.
2911   Linux
2913     * cache bypass is now supported.
2915     * 2.6.x kmod compilation now uses kernel compile options always.
2917     * Support through 2.6.27.
2919   MacOS
2921     * Show more space free so Finder doesn't get confused.
2923   Solaris 10
2925     * Default to namei rather than inode.
2928 OpenAFS 1.5.52 (2008-08-18)
2930   All platforms
2932     * Initialize volume updateDate at volume creation.
2934     * Avoid potential corruption of directories during salvage.
2936     * Check for out of memory condition during allocation of additional Rx
2937       packets.
2939   Microsoft Windows
2941     * Restore support for Windows 2000 (broken in 1.5.50).
2943     * Perform additional validation on volume names in mount points during
2944       creation and evaluation.
2946     * Fix several deadlocks, races, and reference count issues.
2948     * Further optimize SMB Directory Search processing and minimize the
2949       number of InlineBulkStatus RPCs sent to the file server.
2951     * Enable "bos restricted" operations.
2953     * Fix the create of submounts used by the AFSCreds and afs_config
2954       drive mapping tabs.
2956     * Fix a short name truncation bug. (1.5.50)
2958     * Fix the error code reported when attempting to delete a file on a
2959       readonly volume or one that is marked with the readonly DOS
2960       attribute.
2962     * Fix a heap corruption error when reading the CellServDB file
2963       location.
2965     * Add the "RxUdpBufSize" registry value.  The new default is 256KB.
2967     * Do not include trailing NULs in the directory search output.
2968       (1.5.50)
2970     * Pre-allocate 64 Rx Packet buffers per thread in order to improve
2971       performance.
2973     * For debugging: add smb lock requests and stat cache lock allocations
2974       to the output from "fs memdump".
2976   NetBSD
2978     * Workaround broken sigwait() to allow fileserver to shut down
2979       correctly pre NetBSD 5.0.
2981   Solaris 10
2983     * Default to namei fileserver; Allow inode fileserver at configure
2984       time by override.
2986   NFS translator
2988     * Try harder to avoid kernel panics for malformed requests.
2991 OpenAFS 1.5.51 (2008-07-29)
2993   All platforms
2995     * salvager tries harder to arrange for clients to get VBUSY while
2996       salvaging single volumes.
2998     * salvager avoids certain corruption when salvaging directories.
3000     * Rx connection clones disabled.
3002   Microsoft Windows
3004     * The 32-bit EXE 1.5.50 installer failed to properly install the C
3005       Runtime library.  When used as an upgrade OpenAFS would continue to
3006       work but when used as a new installation, OpenAFS binaries would
3007       fail to load.
3009     * Fixes the "fs" and "symlink" commands to properly parse Unicode path
3010       prefixes during the pioctl remote procedure call.  This bug would
3011       result in file not found errors for files and directories that
3012       clearly exist.  (Bug introduced in 1.5.50)
3014     * Large File support is disabled. (Bug introduced in 1.5.50)
3016     * Removes the possibility of a deadlock during volume location update
3017       operation if all of the reported file servers are unreachable at the
3018       time of the update.
3020     * Ensures that reference counts are properly incremented/decremented
3021       on Rx connection objects used for volume location RPCs.
3023     * Over Quota errors during cm_FSync() calls would lead to an infinite
3024       loop as the error was never propagated to the caller.
3026   All UNIX client platforms
3028     * Bugfixes to disconnected AFS support in the cache manager.
3031 OpenAFS 1.5.50 (2008-07-16)
3033   All platforms
3035     * volserver puts recloned volumes back online before returning the
3036       volume to the fileserver, avoiding spurious VNOVOL errors.
3038     * Updated TSM X/Open API support available.
3040     * Demand Attach fileserver will not crash due to accesses during
3041       volume cloning.
3043     * Substantial documentation updates.
3045     * Demand Attach fileserver state tracking and analyzer tool
3046       improvements.
3048     * UAFS userspace cachemanager updates.
3050     * Corrected support for anti-meltdown protection in the client.
3052   Microsoft Windows
3054     * UNICODE Character Set Support.
3056     * Pioctl interfaces to the cache manager have been refactored to
3057       provide layering between the SMB specific code and the general
3058       purpose ioctl operation.
3060     * Garbage collect dead SMB virtual circuits as soon as they are no
3061       longer being referenced.  This avoids problems with outstanding
3062       locks not being dropped when the virtual circuit becomes invalid.
3064     * Remove the IBM Administration Reference documentation and replace it
3065       with the OpenAFS Command Reference Manual.
3067     * Avoid calling rx_SetDeadTime and rx_SetHardDeadTime functions each
3068       time a connection is about to be used.  Do not hold a lock on the rx
3069       connection object while it is being selected.  This avoids a race
3070       between threads attempting to set the timeout values and removes a
3071       bottleneck that was hampering performance.
3073     * Ensure that the smb directory attribute is set for all directory
3074       objects.
3076     * Replace the VC Runtime EXE installer with the MSI installer in the
3077       NSIS installer scripts.
3079   Solaris
3081     * Support for updates to OpenSolaris.
3083   Linux
3085     * Correct dentry revalidation for cross-directory renames.
3087     * Updated rpm packaging materials for 1.5 release series and 2.4
3088       kernels.
3090     * Corrected syscall table probing.
3092     * NFS translator updates for current kernels.
3095 OpenAFS 1.5.39 (2008-06-24)
3097   All platforms
3099     * Updates for Demand Attach fileserver.
3101   Microsoft Windows
3103     * Fix two memory leaks.
3105     * Fix one missing lock.
3107     * Handle access denied errors when writing dirty buffers.
3109     * Fix two errors that would cause the *experimental* AFS Servers
3110       to crash.
3113 OpenAFS 1.5.38 (2008-05-24)
3115   All platforms
3117     * Add read-only disconnected support.
3120 OpenAFS 1.5.37 (2008-05-21)
3122   All platforms
3124     * Includes a number of optimizations for testing.
3127 OpenAFS 1.5.36 (2008-05-09)
3129   All platforms
3131     * Rx optimizations now attempt to deal with high latency WANs.
3133     * Client will not wait infinitely for a server which is not providing
3134       data.  Additional servers will be polled without marking the server
3135       which is not providing data down.
3137     * vos move will not erroneously unlock locked vldb entries on failure.
3139   All server platforms
3141     * Fileserver avoids a potential infinite loop when a client
3142       relinquishes an address.
3144     * Fileserver large setting now configures more threads.
3146     * Fileserver properly registers uuids of new clients.
3148     * Ubik servers do not improperly hide updates from clients.
3150     * Fileservers reserve enough file descriptors such that each thread
3151       can cache one to avoid spurious errors.
3153   Microsoft Windows
3155     * Fix a cm_buf_t reference count leak when attempts to write dirty
3156       buffers to the file server from within cm_IncrSyncer() fail.
3158     * Prevent udebug from crashing.
3160     * Another VNOVNODE issue fixed.  When writing a dirty buffer to the
3161       file server, if VNOVNODE is received, mark all buffers as invalid
3162       without further attempts to contact the file server.
3165 =======> Changes back to 1.3 have not yet been incorporated here <=======
3168 OpenAFS 1.3
3170   * -nosettime is now the default for afsd.  Use "-settime" to get the
3171     old behavior.
3173   * OpenBSD is now supported.
3175   * Mountpoint directory information is now only faked for cross-cell
3176     mountpoints when using the -fakestat flag (e.g. for the directories
3177     under /afs, but not for most other volumes mounted inside the cell).
3178     The -fakestat-all switch can be used to fake information for all
3179     mountpoints.
3181   * When fakestat is enabled on MacOSX, the Finder can be used to browse
3182     a fully-populated /afs directory.  However, this precludes reliable
3183     use of entire volumes as MacOS bundles (i.e. containing a Contents
3184     directory in the root of the volume).
3186   * Mountpoint directory information can be faked by the cache manager,
3187     making operations such as stat'ing all cells under /afs much faster.
3188     This is enabled by passing -fakestat to afsd, but might not be stable
3189     on all platforms.
3192 OpenAFS 1.2.9
3194   * The kaserver now defaults to not allowing interrealm authentication,
3195     due to security vulnerabilities in the krb4 protocol.  The new
3196     "-crossrealm" flag to the kaserver is provided to reenable interrealm
3197     authentication if desired.
3199   * RedHat Linux 9.0 is now supported.
3201   * Solaris 9 12/02 is now supported.  Solaris 7 and 8 x86 should now
3202     work again.
3204   * On Linux machines using 2.2 series kernels, 2.2.19 or higher is now
3205     required.
3207   * An OpenAFS 1.2.9 afsd will not work with kernel modules built from
3208     an earlier OpenAFS release.  In general, using a mismatched afsd and
3209     kernel modules set is unsupported; it is not recommended that you use
3210     such a configuration on a regular basis.
3213 OpenAFS 1.2.8
3215   * Mountpoint directory information is now only faked for cross-cell
3216     mountpoits when using the -fakestat flag (e.g. for the directories
3217     under /afs, but not for most other volumes mounted inside the cell).
3218     The -fakestat-all switch can be used to fake information for all
3219     mountpoints.
3221   * HPUX 11.0 is now supported.
3223   * It is now possible for AFS to use Kerberos 5 directly, via rxkad 2b.
3224     See the OpenAFS 1.2.8 Release Notes for more information on using this
3225     capability.
3227   * An NFS translator kernel module is now included and compiled by
3228     default for Solaris only.
3231 OpenAFS 1.2.7
3233   * MacOS X 10.2 is now supported.  FreeBSD 4.3 and later support is
3234     included in this release, but is still under active development and
3235     should only be used by those doing active development on the OpenAFS
3236     FreeBSD client.
3238   * When fakestat is enabled on MacOSX, the Finder can be used to browse a
3239     fully-populated /afs directory.  However, this precludes reliable use
3240     of entire volumes as MacOS bundles (i.e. containing a Contents
3241     directory in the root of the volume).
3243   * The fileserver will now use Rx pings to determine if clients are
3244     reachable prior to allocating resources to them, to prevent asymmetric
3245     clients from consuming all fileserver resources.
3248 OpenAFS 1.2.6
3250   * Mountpoint directory information can be faked by the cache manager,
3251     making operations such as stat'ing all cells under /afs much faster.
3252     This is enabled by passing -fakestat to afsd.
3254   * Solaris 9 FCS and Solaris 7 and 8 x86 are now supported.
3257 OpenAFS 1.2.5
3259   * A remote denial of service attack in the AIX and IRIX clients has been
3260     fixed.  Users of those platforms are strongly encouraged to upgrade.
3262   * Fixed race conditions in fileserver that could result in crash.
3265 OpenAFS 1.2.4
3267   * Server logfiles now more consistant about format in which hosts are
3268     referred to.
3270   * vfsck on Solaris will now allow force runs (using -y flag) even if old
3271     inodes exist.
3274 OpenAFS 1.2.3
3276   * Cell aliases for dynroot can be specified in the CellAlias file in
3277     /usr/vice/etc or /usr/local/etc/openafs, in format "realname alias",
3278     one per line.  They can also be managed at runtime with "fs newalias"
3279     and "fs listaliases".
3282 OpenAFS 1.2.2
3284   * Solaris 9 and Linux PA-RISC are now supported.
3286   * fileserver will not erroneously delay legitimate errors for 3 seconds
3287     after 10 errors are returned (e.g. stat() on a directory you can't
3288     read).
3290   * Rx MTU calculation now works for Irix, Solaris and Linux
3292   * If afsd is started with the -dynroot flag, /afs will be locally
3293     generated from the CellServDB.  AFSDB cells will be mounted
3294     automatically upon access.
3296   * The namei fileserver allows vice "partitions" to be directories
3297     instead of partitions and will attach and display accordingly.
3298     Creating the file "AlwaysAttach" in the /vicepX directory is used as
3299     the trigger to attach it.
3301   * TSM support for butc no longer requires editing a Makefile, simply
3302     specify the --enable-tivoli-tsm configure option.
3304   * Linux builds no longer require source changes every time the kernel
3305     inode structure changes; the OpenAFS sources will now configure itself
3306     to the actual inode structure as defined in the kernel sources.
3309 OpenAFS 1.2.1
3311   * vfsck on Digital UNIX and Solaris will now refuse to fsck mounted
3312     mounted partitions.
3315 OpenAFS 1.2.0
3317   * AFS now supports --prefix and the other directory options of
3318     configure.  By default AFS builds assuming it will be installed in
3319     /usr/local.  In order to get traditional AFS directory paths (/usr/afs
3320     and /usr/vice/etc) use the --enable-transarc-paths option to
3321     configure.  More details on the new directory layout are found in
3322     README.
3325 OpenAFS 1.1.1a
3327   * Windows 95/98/ME/NT/2000 - Consistent versioning:  Installation, AFS
3328     Control Center, Client dialog boxes and properties pages for
3329     executables display a consistent OpenAFS version number.  Installation
3330     detects previous installation and prompts the user for upgrade
3331     options.
3333   * Windows 95/98/ME/NT/2000 - Installation features:  During installation
3334     the user can select the source of the CellservDB file, AFS home cell,
3335     and drive mappings.  During installation a drive path mapping can
3336     include a variable that will be substituted with the current UserName
3337     that is logged in.
3339   * Windows 2000/NT - Integrated logon:  The Integrated Logon feature
3340     works now.
3342   * Windows 95/98/ME - Logon script features:  The Windows 95/98/ME client
3343     now offers a command-line option for starting up the AFS client
3344     without authenication. It is now possilbe to start the AFS client
3345     first and obtain tokens, and map drives all through Windows scripts.
3346     This helps using Windows 95/98/ME client in Kerberos 5 environment.
3348   * Windows 2000/NT - LANA numbers:  AFS client now scans the LANA numbers
3349     to establish the correct NETBIOS connection.  NetBEUI is no longer
3350     needed.  The user no longer needs to find the correct LANA number.
3352   * Windows 2000/NT - OpenAFS naming consistancy:  Further progress has
3353     been made to remove references to "Transarc AFS" and replace with
3354     "OpenAFS".
3357 OpenAFS 1.0
3359   * AFS now builds with configure. The README for building has been
3360     updated and includes full details.
3362   * A client system can now have multiple sysname values for @sys.  They
3363     will be searched in order when looking up files in AFS.  The
3364     -newsysname argument to fs sysname can be repeated to set multiple
3365     sysnames.
3367   * A new system group is created for new cells (system:ptsviewers with id
3368     -203).  If this group exists, members of this group can examine and
3369     read the entire protection database.  They can examine all users and
3370     groups and can get the membership of any group.
3372   * A new program, pt_util has been added to the distribution.  This
3373     program allows users to print the contents of the protection database
3374     or to edit the protection database without running a ptserver.  It can
3375     be used to set up a new cell without ever running in noauth mode.  Run
3376     pt_util -h for help.
3378   * The fs setcrypt and fs getcrypt commands have been added.  These
3379     commands allow the system administrator to require that the client
3380     encrypt all authenticated traffic between the client workstation and
3381     AFS.  The encryption used is weak, but is likely better than sending
3382     unencrypted traffic in most environments.  Some functions, such as
3383     looking for a volume may not be encrypted, but data transfer certainly
3384     is.  By default data is not encrypted.  At this time no significant
3385     experimentation with server performance has been conducted.
3387   * By default AFS is compiled with AFS_AFSDB_ENV, enabling the -afsdb
3388     option to be given to afsd on startup.  If this option is used, then
3389     new cells will be looked up using AFSDB records stored in DNS if they
3390     are not found in CellServDB.  This means that users can create
3391     cross-cell mountpoints in directories they control to access cells not
3392     in root.afs, and that cells in root.afs need not be in the client's
3393     CellServDB.
3395   * AFS database servers can be marked as read-only clones.  Surround the
3396     hostname in square brackets on the bos addhost command and the
3397     database server will never be elected sync site.  This is useful for
3398     cells distributed over a wide region.
3400   * The AFS servers now support the -syslog flag.  This flag causes them
3401     to log to syslog rather than to files.  This flag is not supported on
3402     NT.  For all servers besides the salvager, the flag can also be
3403     specified as -syslog=facility, where facility is an integer facility
3404     code from syslog.h.  A -syslogfacility option is provided for the
3405     salvager to accomplish the same goal.
3407   * If the --enable-fast-restart flag is given when configuring AFS, then
3408     the salvager supports the -dontsalvage flag which causes it to exit
3409     without salvaging any volumes.  If this is configured into the third
3410     command of a fs process, then the fileserver will start without
3411     salvaging.  It will fail to attach volumes that need salvaging and
3412     they can be salvaged manually.  This provides significantly better
3413     server startup performance at the cost of administrative complexity.
3415   * If the --enable-bitmap-later flag is given when configuring AFS, then
3416     the fileserver creates bitmaps for free vnodes on demand, allowing
3417     faster starts.
3419   * If bosserver finds a BosConfig.new file at startup, it reads this file
3420     and renames it to BosConfig.  This allows bosserver to be reconfigured
3421     at next restart.
3423   * The bosserver can be placed in a restricted mode in which AFS
3424     superusers are only granted limited access to the server host. The
3425     following functionality is disabled when restricted mode is in use:
3427       bos exec
3428       bos getlog (except for files with no '/'s in their name)*
3429       bos create *
3430       bos delete
3431       bos install
3432       bos uninstall
3434     specific exceptions are made for functionality that "bos salvage"
3435     uses:
3437     A cron bnode who's name is "salvage-tmp", time is now, and command
3438     begins with "/usr/afs/bin/salvager" may be created. This bnode deletes
3439     itself when complete, so no special "delete" support is needed.  This
3440     functionality may be removed in the future if a "Salvage" RPC is
3441     implimented.
3443     The file with the exact path /usr/afs/logs/SalvageLog may be fetched,
3444     since that is how bos salvage [...] -showlog is implimented.
3446     Restricted mode is enabled using a new bos command (bos setrestricted)
3447     or bossever command line switch (bosserver -restricted). Restricted
3448     mode can be disabled by a) sending the bosserver process a SIGFPE
3449     (which will then allow restricted operations until the next restart or
3450     setrestricted command) or b) editing /usr/afs/local/BosConfig (or
3451     BosConfig.new), and restarting the bosserver.
3453   * The bos UserList of trusted administrators can now contain cross-realm
3454     Kerberos principals.
3456   * udebug now takes --server not --servers.
3458   * Several error messages have been improved to include volume numbers.
3460   * Several new ports have been included for UNIX platforms: Darwin
3461     (ppc_darwin_12 and ppc_darwin_13), Linux 2.4 (i386_linux24), Linux on
3462     the Powerpc (ppc_linux22 and ppc_linux24), Linux on the Sparc
3463     (sparc_linux22, sparc64_linux22 and sparc64_linux24).
3465   * Incomplete FreeBSD and Alpha Linux ports are included.  The FreeBSD
3466     port has a working server and the Alpha Linux port has a partially
3467     working client.
3469   * A native client for Windows 95/98/ME has been added to the
3470     distribution.  With this program, a gateway machine is no longer
3471     required for Windows 9x to access AFS files.  One drive letter will be
3472     created on your machine by default - Z:.  The Z: drive will be the
3473     root of the AFS tree, allowing you to browse all sites that have AFS
3474     servers available.  Additional drive letters can be defined for other
3475     AFS directories.  A Windows Explorer shell extension is included that
3476     allows you to right click on items within an AFS tree to bring up an
3477     "AFS" menu item and perform various operations on a file or directory.
3478     The most useful item is "Access Control Lists", which allows you to
3479     view and edit the permissions of a particular directory.  Command line
3480     tools are also available in the install directory.  These commands
3481     include klog, unlog, tokens, kpasswd, symlink, fs and pts.  The
3482     installable includes a readme file that contains more information on
3483     how to use the client program and known issues.
3485   * Support for large caches in afsd.  Cachefiles are stored in
3486     subdirectories.  The default is 2048 files per subdirectory, which
3487     should work fine in most situations.  You can use the new afsd option
3488     -files_per_subdir to change this number.  Note that the first time you
3489     run afsd with this patch, your cachefiles will get moved into
3490     subdirectories.  If you subsequently run an older version of afsd, you
3491     will lose all your cached files.