Rx: properly compute dataPacketsReSent statistic
[openafs.git] / NEWS
1                        User-Visible OpenAFS Changes
2
3 OpenAFS 1.5.75 (2010-07-07)
4
5   All platforms
6
7     * Prevent rx_rpc_stats global lock from being a bottleneck.
8
9     * Path MTU discovery is now provided to allow traffic to pass networks
10       with sub-1500 byte MTUs and poor fragment handling.
11
12     * Further reduce Rx NAT ping transmission when enabled.
13
14     * Update Kerberos 5-based token handling in rxkad from upstream
15       Heimdal.  (127554)
16
17     * Update version numbers emitted during build to reflect what is
18       actually being built.
19
20     * Add "-human" switch for human-readable units in fs diskfree and
21       listquota. (124529)
22
23     * vos provides reasons for locked volumes when known.
24
25     * Do not count retransmission and ping acks as non-idle for Rx
26       connections.
27
28     * Rx: provide service-specific data getter and setter routines.
29
30     * Update build-time Kerberos detection.
31
32     * Updated userspace AFS client.
33
34     * Beginning of a modernized test suite.
35
36     * Additional documentation.
37
38     * Updated documentation, notably the Administrators Guide.
39
40     * Substantial code cleanup.
41
42   All server platforms
43
44     * Update handling of vnode allocation failures.
45
46     * DAFS: allow salvaging volumes not known to the fileserver, to allow
47       cleanup of data not attached to a current volume.
48
49     * Properly handle volumes slated for destruction.
50
51     * Handle volumes with many files properly.
52
53     * Force core file generation in bosserver by overriding default
54       resource limits when possible.
55
56     * Update vlclient and vldb_check.
57
58     * Avoid potentially corrupting a volume on creation if files are left
59       from previous failed cleanup.
60
61     * Note volume changed during salvage as needed.
62
63     * DAFS: do not assume invalid addresses are in fileserver address hash
64       table.
65
66     * Avoid tying up fileserver threads with volumes that are being taken
67       offline.
68
69     * Do not set inUse on volumes for non-DAFS other than in fileserver.
70
71     * Break origin's callback on target of rename operation.
72
73     * Avoid unneeded parent directory link updates during some rename
74       operations.
75
76     * Do not open /dev/console for writing in the fileserver.
77
78     * DAFS: avoid spurious restarts when binary restarts are configured.
79
80     * Avoid spurious and unneeded calls to sync(), which can slow down the
81       fileserver.
82
83   Microsoft Windows
84
85     * Revised SMB QuerySecurityInfo to address issues caused by MS10-020
86       (http://support.microsoft.com/kb/980232)
87
88     * Prevent use of the AFSCache file contents if mapped to a new
89       address.
90
91     * Make fs newcell include behavior compatible with the non-Windows
92       version.
93
94     * Provide a registry option (FreelanceImportCellServDB) to pre-create
95       mount points in the AFS root for all cells in CellServDB.
96
97     * Fix a memory leak in the cm_FreeServerList() routine.
98
99     * Reduce privilege when reading registry CellServDB.
100
101     * Add support for RPC Pipe Service NetWkstaGetInfo levels needed for
102       Windows 7.
103
104     * Prevent overflow when computing quota percentage in Explorer Shell.
105       (126846)
106
107     * Generate meaningful errors for ACL operations on freelance AFS root.
108
109     * Fix error handling on InlineBulkStatus RPCs.
110
111     * Show configuration pages for all types of MSI installations.
112
113     * Improve freemount AFS root directory handling and operations.
114
115     * Properly validate GetVolumeStatus pioctl responses.
116
117     * Commit file length changes and dirty buffers when flushing a file.
118
119   All UNIX client platforms
120
121     * Update version of files for disk cache.
122
123     * Do not call afs_FlushVCBs with xvcache lock held, to improve
124       parallelization.
125
126     * Add mariner log messages for creating and removing files.
127
128     * Don't hold xvcache lock while creating symlinks, to improve
129       parallelization.
130
131     * Provide -dynroot-sparse mode to not show all cells in CellServDB in
132       dynroot mode.
133
134     * Avoid a potential crash in aklog in linked cell handling.
135
136     * Log MTU-caused packet retransmission.
137
138     * Prevent crashes caused be fs checkservers while cache is being set
139       up.
140
141     * fs getserverprefs now has a buffer large enough for the default
142       CellServDB.
143
144     * Report server address when logging warnings.
145
146     * Avoid panic in GetCapabilities when cell is not known.
147
148     * Lock process name and id for advisory lock warnings when possible.
149
150     * Handle need for allocating additional Rx packets.
151
152     * Properly handle errors from InlineBulkStatus operations.
153
154     * Fix errors returned from fcntl() on readonly files locked for write.
155
156     * Flush pending changes to the server on LOCK_EX unlock.
157
158     * Reflect length changes as a result of callbacks even when file is
159       open for write.
160
161     * Avoid hanging due to error exit when attempting to store a large
162       file to a non-largefile fileserver.
163
164     * Recover from afs_GetVolSlot errors.
165
166   FreeBSD
167
168     * Bugfixes for kernel VFS and network routines.
169
170   IRIX
171
172     * Provide makesname().
173
174   Linux
175
176     * Avoid syscall probes when keyrings are present, by default. (125215)
177
178     * Remove "Big Kernel Lock" from VFS operations.
179
180     * Use filehandles for all Linux 2.6 versions to avoid need for matched
181       afsd. (127530)
182
183     * Updated RPM packaging.
184
185     * Fix dkms configuration provided with RPMs.
186
187     * Hold reference on pages during background I/O for cache bypass.
188
189     * Fix cache bypass handling of non-largefile fileservers.
190
191     * Protect truncate_inode_pages mappings with mutex or semaphore as
192       needed.
193
194     * Fix pagevec use in cache bypass. (127505)
195
196     * Updates for 2.6.35
197
198   MacOS
199
200     * Improve launchd configuration.
201
202     * Avoid hanging on recursive cache file lock acquisition when user
203       notification is enabled.
204
205     * Fix and re-enable bulkstat mode.
206
207   OpenBSD
208
209     * Build updates.
210
211   Solaris
212
213     * Precluding unmount while AFS is busy.
214
215     * Avoid deadlocking when releasing the VFS object.
216
217     * Stop network interface poller in kernel on AFS shutdown.
218
219     * Avoid issues with lookups on empty directory names. (127356)
220
221
222 OpenAFS 1.5.74 (2010-04-22)
223
224   All platforms
225
226     * Add "vos setaddrs" command.
227
228     * Rx library lock contention avoidance between rx_NewCall and
229       rx_EndCall.
230
231     * Rx library races due to inconsistent use of rx_connection
232       conn_data_lock to protect the flags field.
233
234     * Rx library inconsistent use of RX_CALL_TQ_WAIT which could result in
235       deadlocks.
236
237     * Rx library must signal transmit queue waiters when flushing.
238
239     * afsmonitor shows busy counts now.
240
241     * afsmonitor displays xstat callback statistics.
242
243     * Provide expandgroups for pts mem on a supergroups server.
244
245     * Provide supergroup option to liste nested groups during pts mem.
246
247   All server platforms
248
249     * Avoid volume lock contention during DAFS startup.
250
251   Microsoft Windows
252
253     * Avoid a race when updating cell vldb server lists that can result in
254       a crash.
255
256     * Avoid a deadlock when managing CM_SCACHESYNC_STOREDATA state
257       operations for directory objects.
258
259     * Add new Windows Application Event log messages for VBUSY,
260       VRESTARTING, ALL_BUSY, ALL_OFFLINE, and ALL_DOWN.
261
262     * Reduce lock contention by waiting for cm_buf_t I/O operations.
263
264     * Split the cm_buf_t flags field to separate the flags that are
265       protected by the cm_buf_t mutex from those protected by the
266       buf_globalLock.
267
268     * In cm_UpdateVolumeLocation, avoid searching for a ".readonly" volume
269       on a numeric volume name.
270
271     * File buffer allocations whose offsets are beyond server EOF should
272       be locally allocated and zero filled.  The file server should not be
273       issued a FetchData rpc which is guaranteed to fail.
274
275     * Enable integrated logon to work with Windows 7/2008 when user logons
276       are performed with a non-Domain Kerberos principal.
277
278     * Add Protection Error messages to aklog output.
279
280   All UNIX client platforms
281
282     * Provide a FUSE-interfacing userspace afs client.
283
284     * Updates to libuafs userspace cache manager.
285
286     * Probe servers using GetCapabilities instead of GetTime, thus
287       requiring fewer RPCs.
288
289     * Fix DNS SRV record handling for cell lookup.
290
291   FreeBSD
292
293     * Fix sleep/wakeup routines.
294
295     * Update for 8.0 release.
296
297   Linux
298
299     * Handle high memory addresses correctly.
300
301   MacOS
302
303     * Make 32 bit AFS syscalls work again.
304
305     * Work around finder "Duplicate" failure (caused by setting modes on
306       symlinks).
307
308     * Disable bulkstat again (will be re-enabled at or before .75).
309
310     * Provide symlink type hints during readdir.
311
312
313 OpenAFS 1.5.73 (2010-03-24)
314
315   All platforms
316
317     * NAT keepalive support at Rx level.
318
319     * Corrected SRV record support for cell name canonicalization.
320
321   All server platforms
322
323     * Fix volume callback notification to not notify unaffected clients.
324       (126497)
325
326     * Allow root directory recreation by salvager. (94658)
327
328     * Numerous DAFS fixes.
329
330     * Improvements to callback table overflow handling. (126451)
331
332     * bosserver now shuts down cleanly on SIGTERM.
333
334   Microsoft Windows
335
336     * Prevent the Explorer Shell extension from crashing if symlink
337       creation failed.  (126406)
338
339     * A Rx level NAT ping has been implemented. A registry value enables.
340
341     * Adds krb5 error message translation to aklog, afscreds,
342       afslogon.dll, the network identity manager afs provider and
343       translate_et.
344
345     * Default mode bit settings for file and directory creation are now
346       provided, and can be configured.
347
348     * An SMB request trace facility is provided and can be enabled for
349       debugging.
350
351   All UNIX client platforms
352
353     * Rx idle deadtime does not stop file writes.
354
355     * Disconnected AFS no longer has a race condition during remove ops.
356
357     * Fakestat avoids a condition which could cause it to block on network
358       activity.
359
360     * Several fixes to handle interruptions in vos operations. (33360,
361       125535)
362
363     * Allow more sysnames in a sysname list.
364
365     * Attempt to enforce timeouts on AFSDB lookups.
366
367   AIX
368
369     * Clean up properly on mount failure.
370
371     * Add entry to /etc/vfs to allow umount to work.
372
373   Linux
374
375     * Several issues to deal with older kernels.
376
377     * Avoid leaking the global lock in the /proc cellservdb code.
378
379     * Keyring destruction now cleans up all tokens.
380
381     * Keyring quotas are not enforced against root.
382
383   MacOS
384
385     * Some FSEvents hinting for authentication events now done. (23781)
386
387     * Update uninstaller. (125634)
388
389     * Rewrite afssettings and fstab code to avoid licensing issue with
390       APSL.
391
392     * Growl client for user monitoring of AFS events included.
393
394     * Properly support insert-only dropboxes.
395
396     * Add bulkstat support.
397
398     * Include support for moving in Finder across mount points.
399
400     * Preferences Pane includes support for Kerberos 5 ticket renewal.
401
402
403 OpenAFS 1.5.72 (2010-02-15)
404
405   All platforms
406
407     * Provide internationalization support in com_err.
408
409     * Fix array length checking to avoid crashes when checking for a
410       volume type based on name in vos.
411
412   All server platforms
413
414     * Provide backward compatible "-f" flag to salvager for force mode.
415
416   Microsoft Windows
417
418     * Restore use of DNS AFSDB and SRV records by kaserver clients.
419
420   All UNIX client platforms
421
422     * Fix client cache file truncation to not lose chunks when truncating
423       a large file.
424
425     * Ensure a cache writeback hook is installed in the client (bug from
426       1.5.71).
427
428     * Avoid spurious free memory warnings during clean shutdown.
429
430     * Fakestat mode avoids AFSDB lookups.
431
432     * "fs storebehind" now correctly reports errors on readonly volumes.
433
434     * Additional documentation for "fs getcacheparms"
435
436     * Forced new uuid generation with "fs uuid -generate" now works
437       enforced permission correctly.
438
439   MacOS
440
441     * Add optimized Rx event handler in kernel.
442
443     * Installer now allows installing an older version.
444
445     * Panic decoder can now deal with MacOS 10.5 again.
446
447     * MacOS ._ files are now correctly not looked up as cellnames.
448
449   Linux
450
451     * To deal with SELinux file labeling, try cache accesses with current
452       credentials in event of failure.
453
454     * Rx XDR encoding bug on i386 Linux is fixed (bug introduced in
455       1.5.71).
456
457   IRIX
458
459     * Code compilation fixes.
460
461   OpenBSD
462
463     * Update for OpenBSD 4.6.
464
465
466 OpenAFS 1.5.69 (2010-01-19)
467
468   All platforms
469
470     * Configuration of BOSserver no longer defaults to weekly restarts
471       enabled.
472
473     * Provide BOS restricted mode by default.
474
475     * Add support for "vos endtrans" command.
476
477     * Default to providing full output from vos listvol.
478
479     * Correct additional-address tracking in the fileserver.
480
481     * Improve Rx performance by not unnecessarily dropping and reacquiring
482       call locks in read and write processes.
483
484     * Avoid crashes when monitoring volserver transactions across
485       potential transaction garbage collection.
486
487     * Numerous warning fixes.
488
489   All server platforms
490
491     * Avoid saving fileserver state in demand attach fileserver when
492       panicing.
493
494     * Demand attach fileserver allows other callers to schedule salvages.
495
496     * Demand attach "bos salvage" now works correctly with restricted
497       mode.
498
499   Microsoft Windows:
500
501     * Numerous changes to the client-internal btree directory handling to
502       prevent errors.
503
504     * fs examine reports owner and group ids as signed values (PTS groups
505       are negative).
506
507     * Preclude corruption due to races writing to smb buffers.
508
509     * Allow MTU settings in registry to be used.
510
511     * Apply MTU to both send and receive sizes.
512
513   All UNIX client platforms
514
515     * Avoid double-freeing Rx call structure if reading a response from
516       the file server results in a short read.
517
518     * Handle negative lengths in FetchStatus results correctly.
519
520     * Properly clean up allocated memory at shutdown.
521
522     * Default to AFSDB compiled into the cache manager.
523
524     * Avoid inadvertant disclosure of stat() information to clients not so
525       entitled.
526
527     * Correct a bug with AFSDB lookups introduced with SRV record support.
528
529   MacOS
530
531     * Install kernel panic processing tool in /Library/OpenAFS/Tools.
532
533     * Include debugging symbols for kernel extension in additional package.
534
535     * Support "Application Firewall" users.
536
537     * Avoid ._cellname AFSDB lookups.
538
539     * Compile preferences pane as a universal binary.
540
541   Linux
542
543     * Use splice to speed up storing files.
544
545     * When using memcache, avoid duplicating work in readpages.
546
547     * Use dget_parent to safely find an inode's parent.
548
549     * Disable access time updates in our superblock.
550
551     * Avoid crashing doing writeback if no credentials were stashed at
552       file open.
553
554     * Simplify keyring support.
555
556     * Properly clean up vcache in event of failed mount.
557
558   FreeBSD
559
560     * Update for current FreeBSD 8.
561
562   Solaris
563
564     * Abstractly manipulate groups as now required.
565
566     * Abstractly access time instead of using lbolt directly.
567
568
569 OpenAFS 1.5.68 (2009-12-08)
570
571   All platforms
572
573     * aklog now attempts to convert non-AFS errors to human-readable
574       strings.
575
576     * Make stack not executable when compiling assembler source with GCC.
577
578     * Numerous source warning cleanups and code reorganization.
579
580   All server platforms
581
582     * Compute midnight for volume statistics calculation from local time.
583
584     * Salvager now orphans duplicate special inodes when running to allow
585       recovery in event of a problem, instead of simply ignoring the
586       issue.
587
588     * Support to ensure a server panic attempt leaves a core and thus
589       restarts in a timely manner, rather than potentially hanging. Use
590       panic to attempt cleanup before leaving a core when possible.
591
592     * Volume sync data reported during bulkstatus is now set correctly.
593
594     * Provide better tuning for fileserver file descriptor caching.
595
596     * Allow more than 128 threads in fileserver by modifying host
597       structure in-use tracking.
598
599     * Avoid crashes getting volume server status during transaction
600       cleanup.
601
602     * Improved logging of offline volume conditions.
603
604     * Correct volume statistics when cloning a volume.
605
606     * Avoid referencing host structures in the fileserver which are marked
607       for deletion.
608
609     * Demand attach fileserver corrections to avoid coring during an
610       aborted startup.
611
612     * host array bounds checking corrections to avoid buffer overflow.
613
614     * Handle special inodes correctly when promoting an inode fileserver
615       readonly volume to read-write.
616
617   Microsoft Windows
618
619     * Set the DOS Readonly attribute on a file/directory whenever the unix
620       mode combined with the mask 0200 is true.  Previously there was a
621       discrepency between the mask used for testing for readonly behavior
622       and that used for setting the attribute.
623
624     * Disable AFSVolSync based .readonly "whole-volume callback" support
625       because the all file servers prior to 1.5.67 (and perhaps 1.4.12) do
626       not properly assign a value to the AFSVolSync structure in bulk
627       status RPC responses.
628
629     * Improve the error output from aklog to output the value from krb5
630       error_message() if the afs_com_err output indicates an unknown
631       value.
632
633     * Convert VBUSY and VRESTARTING to CM_ERROR_ALLBUSY and do not permit
634       them to be exposed to the smb redirector.
635
636     * Convert STATUS_TIMEOUT responses to STATUS_IO_TIMEOUT to avoid
637       confusion within the smb redirector.
638
639     * Fix the byte order assigned to port numbers associated with AFSDB
640       record lookups.  They must be network byte order not host byte
641       order.
642
643     * Add dynamic server ranking based on RPC round trip time
644       measurements.
645
646   All UNIX client platforms
647
648     * Additional shutdown-time memory leaks removed.
649
650     * Improved logging of resource contention.
651
652     * Provide dumping for Rx debug packet tracking support in source.
653
654     * Update afscp test client to build, and provide an unlock client.
655
656     * Client buffers for directory parsing can now be allocated beyond the
657       fixed set formerly provided.
658
659     * Work around race condition when manipulating read-only volume
660       callbacks.
661
662     * Bugfixes to get PAG value pioctl.
663
664     * Bugfixes to SRV record support.
665
666   Linux
667
668     * Path MTU tracking code cleanup.
669
670     * Avoid an oops due to racing with vcache recycling thread.
671
672     * Changes to keyring PAG handling: for sufficiently new kernels, use
673       only keyring-based PAGs, and disable group PAGs entirely.
674
675     * Updates to the kernel page cache interface: writing pages will now
676       not spuriously leak page locks, and will avoid requiring duplicate
677       work.
678
679     * Credential references are now tracked using native atomic counters.
680
681     * Kernel mutex/semaphore lock ordering fix to avoid deadlocks.
682
683     * Manipulate disk cache with credentials used to initialize it, to
684       avoid security issues.
685
686   MacOS
687
688     * Fix fstrace message catalog location.
689
690     * Fix kernel fstrace logging.
691
692
693 OpenAFS 1.5.66 (2009-10-25)
694
695   All platforms
696
697     * Avoid calling exit() in library code.
698
699     * Add rx window size and peer timeout tuning APIs.
700
701     * Correct rx peer timeout handling to disallow 0ms timeouts.
702
703     * Correct calculation of rx RTT by disregarding retransmitted packets.
704
705     * vos manpages updated to reflect changes in recent versions.
706
707     * GNU-style long options (e.g. --cell) are now supported in all
708       commands.
709
710     * fs listacl can now print a command to recreate the current ACL.
711
712   All server platforms
713
714     * Fix a race on transaction objects in the volserver which can cause a
715       crash.
716
717     * Avoid destroying and setting to NULL the callback connection when it
718       could still be being used.
719
720     * Correct unlink handling in salvager.
721
722     * Improve error messages due to I/O errors in the volserver.
723
724     * Correct an issue which caused converted RO to RW volumes on namei
725       fileservers to not come online immediately.
726
727   Microsoft Windows
728
729     * Official support for Windows 7 and Server 2008 R2.
730
731     * Prevent a file server bug (FetchData returning an invalid length
732       instead of zero) from causing an "unexpected network error" when
733       writing to files.
734
735     * Promote DNS SRV records as superior to DNS AFSDB records.  Support
736       arbitrary port numbers for vldb servers.
737
738     * Add AFSVolSync based .readonly "whole-volume callback" support.
739       With this functionality, multiple objects from a .readonly volume
740       can have their status validated by issuing a single
741       RXAFS_FetchStatus RPC.
742
743     * Remove drive mapping functionality and service start/stop from
744       afscreds.exe.
745
746     * Remove drive mapping functionality from afs_config.exe.
747
748     * Use {HKLM,HKCU}\SOFTWARE\OpenAFS\Client DWORD "ShowMountTab" to
749       restore access to drive mapping functionality in afscreds.exe and
750       afs_config.exe.
751
752     * Adjust SMB error return codes to avoid returning STATUS_TIMEOUT
753       which results in the SMB redirector disconnecting.
754
755     * Network Identity Manager OpenAFS Provider now provides its own "AFS
756       lock" notification icon to report the status of "have tokens, have
757       no tokens, service not started, service started but inaccessible".
758       Hovering over the icon lists the cells for which tokens exist (if
759       any) and the OpenAFS version number.  Double-clicking executes the
760       Network Identity Manager default action.
761
762     * Prevent pioctl calls from retrying indefinitely when a sharing
763       violation error occurs.
764
765   All UNIX client platforms
766
767     * Correct a condition which could discard the error from initializing
768       a fetch request.
769
770     * Avoid using invalid references to afs_Conn connection structures,
771       and thus potentially producing invalid data when a retry is needed.
772
773     * SRV records are now supported for discovering AFS servers.
774
775   Linux
776
777     * Correct writepage behavior.
778
779     * Fix error code handling in the writepage code.
780
781     * Avoid leaking page locks, which could potentially hang a machine.
782
783   MacOS X
784
785     * Preferences Pane improvements.
786
787   HP-UX
788
789     * Avoiding attempting to handle critical signals in servers, so that
790       core file handling works correctly.
791
792
793 OpenAFS 1.5.65 (2009-10-06)
794
795   All platforms
796
797     * Code compilation warning fixes, to enable better finding and
798       tracking bugs.
799
800     * Provide configure-time switch to enable code warning compilation.
801
802   All server platforms
803
804     * Demand-attach fileserver now makes volume LRU list operations
805       exclusive operations to avoid races during adding to the list.
806
807     * Fileservers now avoid potential "negative length" fetches.
808
809     * A leak in host tracking objects in the fileserver has been fixed.
810
811     * Salvager now unlinks all files by full path, to deal with the change
812       to not chdir for core file tracking.
813
814     * Salvager avoids asserting if the volume header is unreadable.
815
816     * Demand-attach fileserver puts back volume references from fssync
817       handlers when done.
818
819   Microsoft Windows
820
821     * Improved service response to suspend and shutdown event
822       notifications.
823
824     * Avoid a bug in the file server that can result in an invalid length
825       being returned as part of a fetch data response if the client
826       attempts to read beyond the length of the file.
827
828     * Do not publish a default stream object for directories and mount
829       point objects.  This was impacting the ability of some Windows XP
830       systems to save roaming profiles.
831
832   All UNIX client platforms
833
834     * A bug which could cause erroneous handling of lengths on data reads
835       has been fixed.
836
837     * A bug where erroneous length returns from the fileserver could
838       result in a false error has been fixed.
839
840   Linux
841
842     * Background page copies are now supported for enhanced disk cache
843       read performance.
844
845     * Blocking readahead is supported in readpages() to reduce overhead.
846
847     * Use readpage() instead of read() to access cache data to avail disk
848       cache users of the kernel backing cache for improved performance.
849
850     * Minimize credential handling for improved performance.
851
852   MacOS X
853
854     * Preferences Pane cleanup.
855
856   Solaris
857
858     * Provide a fs_pathconf method with sensible defaults.
859
860     * Provide a _PC_FILESIZEBITS method to fix some NFS translator
861       consumers.
862
863
864 OpenAFS 1.5.64 (2009-09-22)
865
866   All server platforms
867
868     * The demand attach fileserver now puts back volume references gotten
869       via the fssync interface.
870
871     * The demand attach fileserver had a structure reference error, which
872       has been correected.
873
874   Microsoft Windows
875
876     * Restores Windows 2000 compatibility.
877
878     * Fixes a data consistency error between the output of NetWkstaGetInfo
879       and NetServerGetInfo RPCs, specify the Lan workstation group name
880       "AFS", and report server name as "AFS" instead of "\\AFS" when the
881       caller asks for "\\AFS".
882
883     * Enables executables to be run from \\AFS on Windows 7.  Returns
884       "Name not found" instead of "File not found" when a directory or
885       file name cannot be found.  This avoids loader errors when system
886       dlls cannot be located in the executable directory.
887
888     * Prevents cache manager from marking the file server "down" when the
889       data returned in response to either RXAFS_FetchData64 or
890       RXAFS_StoreData64 is invalid.
891
892     * Adds pioctl data validation to the AFS Explorer Shell extension.
893
894   All UNIX client platforms
895
896     * A bug which could cause a kernel panic in 1.5.63 has been corrected.
897       This would manifest as a GetDCache panic or oops.
898
899   Linux
900
901     * aklog -setpag works again with recent kernels when keyring is in
902       use.
903
904   MacOS
905
906     * When Fast User Switch is in use, AFS login is now handled correctly
907       by the integration tool included with the preferences pane.
908
909     * Several packaging bugs have been corrected.
910
911
912 OpenAFS 1.5.63 (2009-09-11)
913
914   All platforms
915
916     * The restorevol command is now documented and installed as a user
917       command.
918
919     * The uss command now properly translates vldb entries to its expected
920       format when handling them in all cases.
921
922     * Documentation now refers to Kerberos instead of kaserver.
923
924   All server platforms
925
926     * bosserver now handles BosConfig.new when restarting, allowing
927       configuration to be replaced at restart time rather than with bos
928       delete and bos create.  Documentation is updated to reflect this.
929
930     * The demand attach fileservice not longer potentially hangs trying to
931       terminate demand-salvages which have already exited.
932
933     * The demand attach fileservice has been modified to avoid spurious
934       'SYNC_putRes: write failed' warnings when some protocol messages
935       cannot be acknowledged due to the sender terminating the connection.
936
937     * In the event of failure to contact the vlserver or ptserver, the
938       fileserver will not exit and trigger a forced salvage. It will
939       continue to try in the background to contact the needed services.
940
941     * The salvager can now repair certain cases of a damamged vnode index.
942
943     * The accessDate metadata for a volume is now updated correctly.
944
945   Microsoft Windows
946
947     * CRITICAL: Some applications for example those based on Cygwin were
948       unable to access data stored in the AFS name space.  Explorer Shell
949       also experienced inconsistent behavior.  This is fixed.
950
951     * CRITICAL: Multiple AFS pioctl requests issued nearly simultaneously
952       by applications could result in pioctl responses being received by
953       the wrong requester.  This in turn could result in application
954       crashes.  symlink.exe, fs.exe, afslogon.dll, afscreds.exe, and the
955       netidmgr afscred.dll plugin were all affected.
956
957     * Some XP machines running 1.5.62 had trouble saving roaming profile
958       data.  This is fixed.
959
960     * Integrated Logon (afslogon.dll) did not function with domain
961       specific configurations.
962
963     * Ensure that access denied and over quota errors experienced while
964       storing data to the file server do not result in on-going retry
965       attempts.
966
967   All UNIX client platforms
968
969     * Except on Solaris and AIX, the compiler may now be overriden at
970       configure time by setting the CC environment variable.
971
972     * afsd now properly deals with large cache partitions.
973
974   FreeBSD
975
976     * Build shared libafsauthent and libafsrpc.
977
978   Linux
979
980     * Kernel module DKMS support now installs an unstripped module to
981       allow debugging information to be collected.
982
983   MacOS
984
985     * Preferences pane properly updates token information.
986
987   MacOS 10.6
988
989     * klog will now properly handle passwords of 8 or fewer characters
990       with an AFS string to key on hosts able to run 64 bit binaries.
991
992     * A panic at AFS shutdown due to "NO PCB" on a udp_lock has been
993       addressed.
994
995     * The panic decoder script included in the source now properly handles
996       32 and 64 bit panics.
997
998   NetBSD
999
1000     * Avoid defining AFS_KERBEROS_ENV globally as it creates a circular
1001       dependency.
1002
1003     * Build shared libafsauthent and libafsrpc.
1004
1005   OpenBSD
1006
1007     * Build shared libafsauthent and libafsrpc.
1008
1009
1010 OpenAFS 1.5.62 (2009-08-28)
1011
1012   All platforms
1013
1014     * Numerous invisible changes to improve code maintainability,
1015       portability and enhanceability.
1016
1017   Microsoft Windows
1018
1019     * CRITICAL: Fixes two errors that can result in data loss when storing
1020       data to the file server.
1021       1. Failure to Store Portions of Unaligned Writes
1022       2. Failure to Store Data to File Servers Lacking Large File Support
1023       Read the announcement for more details:
1024         http://www.openafs.org/pipermail/openafs-announce/2009/000305.html
1025
1026     * CRITICAL: The cache manager daemon thread could terminate when the
1027       machine enters suspend mode.  This daemon thread performs the
1028       background check of down servers, offline volumes, callback
1029       expirations, etc.
1030
1031     * CRITICAL: Integrated Logon (afslogon.dll) was terminating
1032       unexpectedly.  Error checking has been improved and NULL pointer
1033       dereferences after Lsa API calls fail have been eliminated.
1034
1035     * For the first time, the OpenAFS SMB Server supports the DCE RPC
1036       services SRVSVC and WKSSVC.  Browsing \\AFS with the Explorer Shell
1037       or NET VIEW will now be faster and provide additional functionality.
1038       No longer will cell names longer than 12 characters be truncated.
1039
1040     * Improvements to DFS Referral request processing have been
1041       implemented.
1042
1043     * Unnecessary DNS lookups of share names are avoided improving
1044       performance.
1045
1046   All UNIX client platforms
1047
1048     * Non-Kerberos PAM modules work correctly again.
1049
1050   MacOS X
1051
1052     * MacOS 10.6 (Snowleopard) is now supported, both 32 and 64 bit mode.
1053
1054     * Updates to the AFSCommander preferences pane.
1055
1056     * Installer now permits cell names with dashes.
1057
1058
1059 OpenAFS 1.5.61 (2009-08-06)
1060
1061   All platforms
1062
1063     * Correct another race condition in the Rx library that could result
1064       in an unexpected panic while freeing the Rx call iovq.
1065
1066     * rx packet resend and data packets sent counts were incorrect.
1067
1068     * fs setquota, fs setcachesize, vos setfields, and vos create now
1069       accept human readable orders of magnitude. (K, M, G)
1070
1071     * fs listquota fixed to permit large quota sizes to be displayed.
1072
1073     * Correct documentation of bosserver permissions requirements.
1074
1075     * Modify vlserver to avoid potentially corrupting the database through
1076       volume id reuse.
1077
1078     * Generalized support for fast Rx timeout due to network
1079       down/unreachable.
1080
1081   All server platforms
1082
1083     * Allow audit logs to be sent via sys5 IPC message queues instead of
1084       logged directly.
1085
1086   Microsoft Windows
1087
1088     * If a file server becomes inaccessible while the cache manager has
1089       dirty buffers to write, the afsd_service buf_IncrSync thread can
1090       attempt to use 100% of the cpu.
1091
1092     * Fix "fs newcell" which was broken in 1.5.60.
1093
1094     * Do not attempt to synchronize dirty buffers if the associated volume
1095       is known to be unavailable.
1096
1097     * Modify behavior of a Freelance mountpoint target that does not
1098       specify a cell.  Instead of assuming the target volume is in the
1099       Freelance.Local cell, use the workstation "Cell" specified in the
1100       registry. A mountpoint target of "#root.cell." will now mean the
1101       root.cell volume in the workstation cell for the current session.
1102       If the workstation cell changes from "athena.mit.edu" to
1103       "andrew.cmu.edu", the referenced volume will also change without
1104       requiring that the mount point targets be altered.
1105
1106     * Add cm_FindServerByUuid().  Re-implement RXAFS_InitCallBackState3()
1107       to permit the server Uuid to be used to lookup the server object and
1108       from that determine the cell.  This permits callbacks that are
1109       received from alternate addresses to be processed with a known
1110       server object.  Previously a request from an unknown server would
1111       clear all callbacks from all cells.
1112
1113     * Fix a bug that prevented optimal performance when using a non-zero
1114       value for 'daemonCheckVolCBInterval'.  As a reminder, when
1115       "daemonCheckVolCBInterval" is set to a non-zero value, all .readonly
1116       volume callbacks are automatically renewed 90 minutes before their
1117       expiration.
1118
1119     * Fix automatic ranking of vldb servers whose values are obtained from
1120       the CellServDB file.
1121
1122     * Add failover for RX CALL TIMEOUT errors when the volume is readonly
1123       or the call is to a vldb server.
1124
1125     * Add registry based cell search functionality to NetIdMgr,
1126       afs_config.exe, and klog.exe.
1127
1128     * afsconf_GetCellInfo() has been modified to perform gethostbyname()
1129       lookups on the host names in the CellServDB instead of using the
1130       specified IP addresses.  This provides aklog, pts, vos, etc. the
1131       same CellServDB behavior that the Windows Cache Manager uses.
1132
1133     * When updating the stat cache entry callback of a .readonly object
1134       from the volume group object, update the file server reference to
1135       ensure it matches the most update to date callback.
1136
1137     * Add proper support for processing callbacks from multi-homed file
1138       servers.  Instead of comparing servers by cm_server_t pointer,
1139       compare them by UUID when the UUID is known.
1140
1141     * During a shutdown short circuit the offline volume check daemon
1142       functionality.
1143
1144     * Return the error code of RXAFS_FetchData / RXAFS_StoreData in
1145       preference to an error code reported by rx_EndCall.
1146
1147     * Add "PerFileAccessCheck" registry value to permit testing against
1148       experimental file servers that include per-file acl support.  This
1149       value is intentionally undocumented.  It is not to be used by
1150       production environment deployments.
1151
1152     * Fix a bug introduced in 1.5.60 that prevents the afs netidmgr
1153       provider from obtaining tokens when referrals are in play.
1154
1155     * Add "fs chown" and "fs chgrp" commands to permit the owner and group
1156       of objects stored in AFS to be set from Windows.
1157
1158     * Avoid performing background daemon operations when the machine is
1159       going into suspend mode.
1160
1161     * Perform offline volume checks in most recently used order.
1162
1163     * Prevent crash when a data version for a cache object goes backwards.
1164
1165     * Multi-thread safe library versions are now being generated and used.
1166       mtafsubik.lib, mtafsutil.lib, mtafsvldb.lib, mtafsvol.lib.
1167
1168     * Microsoft SMB Redirector (mrxsmb.sys) support for
1169       ExtendedSessTimeout values are now available on XP through Windows
1170       7.  Add functionality to autodetect if such support is present on
1171       the machine.  If so, configure it if necessary and dynamically
1172       adjust the AFS Rx timeout values accordingly.
1173
1174   All UNIX client platforms
1175
1176     * Fix out-of-tree source builds.
1177
1178   MacOS
1179
1180     * GUI installer now asks for local cell information.
1181
1182     * AFS Commander preferences pane is now installed by default.
1183
1184   Solaris
1185
1186     * Avoid kernel panics due to null pointer dereferences in the network
1187       interface poller kernel thread.
1188
1189
1190 OpenAFS 1.5.60 (2009-05-31)
1191
1192   All platforms
1193
1194     * Retry volserver transaction creation on failure.
1195
1196     * Allow building HTML and PDF documentation from included XML copies
1197       of User Guide, Admin Guide and Quick Start Guide for Unix.
1198
1199     * Documentation updates and additional documentation.
1200
1201     * Add -encrypt support to pts client.
1202
1203     * Convert MR-AFS fs commands to OSD commands.
1204
1205   All server platforms
1206
1207     * Updated background sync process in fileserver to avoid a race which
1208       could result in a volume being taken offline.
1209
1210   Microsoft Windows
1211
1212     * On April 9th Microsoft released a Hot Fix for Windows Server 2003
1213       SP2 that corrects a deadlock in the smb redirector and also adds new
1214       functionality that permits the AFS SMB server to be given a longer
1215       timeout than is normally the case.  New functionality has been added
1216       to configure these additional LanmanWorkstation\Parameter values.
1217       (This functionality has been backported to XP SP3 and is scheduled
1218       to be released on June 5th.)
1219
1220     * Fix RT#124787, a race condition between "fs flush <dir>", "fs
1221       flushvolume", or "fs flushall" and on-going directory operations
1222       that can result in afsd_service.exe crashing.
1223
1224     * Release Notes, User and Administrator guides are now shipped as
1225       indexed Windows HtmlHelp Files. (.chm).  Shortcuts are provided from
1226       the Start Menu.
1227
1228     * A method of specifying Client CellServDB information within the
1229       registry has been added that can be used to either override the
1230       CellServDB file or force the use of DNS lookups for a given cell.
1231       See the release notes for details.
1232
1233     * The pioctl interface now properly handles drive letter substitution
1234       to UNC paths.  (SUBST <d:> <\\afs\cell\path>)
1235
1236     * The BackConnectionHostNames registry value configuration was broken
1237       when dynamic re-establishment of Netbios Name registrations was
1238       added.  This release restores the functionality.
1239
1240     * All hidden vos.exe commands are now revealed.
1241
1242     * Attempts to store the same dirty file chunk from multiple threads
1243       are now prevented.
1244
1245     * The IsPathInAfs test in Explorer Shell Extension and fs.exe now
1246       permits broken symlinks to be treated as being in AFS.
1247
1248     * vos.exe commands that output 64-bit integer values once again do so.
1249       This was broken in 1.5.59.
1250
1251     * Cygwin Import Libraries are provided in the SDK for all OpenAFS
1252       DLLs.  This permits building cygwin applications against OpenAFS
1253       libraries.
1254
1255     * NSIS installer does a much better job of cleaning up files left over
1256       from previous installs.
1257
1258     * libafsconf.dll moved from Client\Program to Common directory as is
1259       is now used by all modules for CellServDB processing.
1260
1261   All UNIX client platforms
1262
1263     * Write back changes on last store for memcache to avoid discarding
1264       changes.
1265
1266     * Abstract disk cache support to allow for path, fh, inode based
1267       caches with no need for messy ifdef structures each time a new type
1268       is added.
1269
1270   DragonflyBSD
1271
1272     * Support as a userland port.
1273
1274   FreeBSD
1275
1276     * Corrected structure definition for userspace cache manager to allow
1277       builds to complete.
1278
1279   Linux
1280
1281     * Corrected client locking support.
1282
1283     * Updated patch to stop deadlocking in the kernel during mmap.
1284
1285     * Avoid oops when setting up groups for PAGs to match keyrings.
1286
1287     * Use Linux fh-based cache in cases where possible by default.
1288
1289   MacOS 10.3:
1290
1291     * Corrected structure definition for userspace cache manager to allow
1292       builds to complete.
1293
1294   OpenBSD
1295
1296     * Support for OpenBSD 4.5.
1297
1298   Solaris
1299
1300     * Corrected support for server-side vos split interface.
1301
1302
1303 OpenAFS 1.5.59 (2009-04-06)
1304
1305   Microsoft Windows
1306
1307     * Increased service priority class to "High" to match the priority of
1308       system components that are dependent upon the a timely response.
1309
1310     * SMB error responses avoid returning errors that could confuse the
1311       Microsoft SMB redirector into disconnecting the connection to \\AFS.
1312
1313   All UNIX client platforms (except MacOS X 10.4 and 10.5)
1314
1315     * OpenAFS 1.5.59 contains fixes for the client issues addressed by the
1316       security advisories OPENAFS-SA-2009-001 and OPENAFS-SA-2009-002.
1317
1318   Linux platforms
1319
1320     * Support for prerelease Linux 2.6.30 kernels.
1321
1322
1323 OpenAFS 1.5.58 (2009-03-30)
1324
1325   All platforms
1326
1327     * Code cleanup and prototyping.
1328
1329     * Avoid unnecessary blocking in Rx periodic cleanup code.
1330
1331   All server platforms
1332
1333     * Fileserver CopyOnWrite routine optimized for performance.
1334
1335     * Make fileserver callback dumps 64 bit safe.
1336
1337     * Fix byte order issues with fileserver host hashing.
1338
1339     * Fix buffer size issues with butc.
1340
1341     * Fix several Ubik recovery issues.
1342
1343     * Avoid leaking file references in the fileserver.
1344
1345     * Fix a race in DAFS while closing vnodes, and another offlining
1346       volumes.
1347
1348     * volserver interfaces for volume splitting client.
1349
1350   Microsoft Windows
1351
1352     * [RT 124293] A race condition exists which can result in a crash.
1353
1354     * [RT 124276] If the vldb is out of sync with the contents of the file
1355       servers, afsd_service will retry too many times when a file server
1356       reports a volume as not being present.  Now if the list reported by
1357       the vldb is the same as the previously seen list, then the retry is
1358       aborted.
1359
1360     * [RT 124276] Read-only volume failover was broken in 1.5.53 whenever
1361       accessing a volume results in VNOVOL or VMOVED.
1362
1363     * [RT 124276] Prior to 1.3.70 the volume server reference list was not
1364       reference counted and would be prematurely freed while in use.  When
1365       reference counting was added in 1.3.70 a bug was introduced that
1366       could result in service reference list corruption.
1367
1368     * Add Windows Application Event Log warning messages for "Client SMB
1369       MPX value too large" and "Client SMB Buffer Size too small".
1370
1371     * Renaming of files across directory boundaries would result in an
1372       invalid handle error when attempting to access the files after the
1373       move.
1374
1375     * Fix the handling of Tran2 Set Path Info RPCs.  Do not fail when a
1376       smb file descriptor cannot be found.  The whole point of using a
1377       Path Info function is because an smb file descriptor wasn't
1378       allocated.
1379
1380     * More edge cases in which dynamic addition of Freelance root.afs
1381       entries would get the wrong FID or where the root.afs directory
1382       would not be refreshed.
1383
1384     * Buffer overflow could occur if the workstation cell name was longer
1385       than 64 characters.  Crashes could occur in afscreds.exe,
1386       afslogon.dll, and afsd_service.exe.
1387
1388     * VNOSERVICE and VOFFLINE errors were leaking and were exposed to the
1389       smb client.
1390
1391     * Log file server uuid values as part of the cm_server object when
1392       available.  Dump the cm_server object list in response to "fs
1393       memdump".
1394
1395     * Optimize the performance of resetting access control lists when
1396       tokens are set or removed.
1397
1398     * Remove symlink recursion tests and increase max symlink count to 64
1399       from 16.
1400
1401     * Windows specific Rx performance improvements.
1402
1403     * Support for Network Identity Manager 2.0
1404
1405   All UNIX client platforms
1406
1407     * Avoid issues with freeing resources at shutdown.
1408
1409     * Numerous fixes to disconnected AFS.
1410
1411     * Disconnected AFS fixes for replaying changes without double-freeing.
1412
1413     * Attempt to use krb524 principal conversion in aklog if available.
1414
1415   AIX
1416
1417     * Kerberos configuration at build time corrected.
1418
1419   Linux
1420
1421     * Default to dynamic allocation of AFS kernel cache entries to allow
1422       growth for inotify()-pinned entries. (beagle, famd, etc)
1423
1424     * Change client truncation routines to avoid locking issues.
1425
1426     * IA64 port clients fixed on Linux 2.6.
1427
1428     * RPMs now install fstrace message catalog.
1429
1430     * Support through kernel 2.6.29 tested.
1431
1432     * Fix locking issues on CellServDB file in /proc.
1433
1434   OpenBSD
1435
1436     * Support OpenBSD 4.4
1437
1438
1439 OpenAFS 1.5.57 (2009-01-23)
1440
1441   All platforms
1442
1443     * Conditional compilation of rxdebug support is now possible.
1444
1445     * Documentation updates.
1446
1447     * Further race connditions in Rx have been corrected.
1448
1449   All server platforms
1450
1451     * Salvager no longer attempts to recreate headers in the wrong
1452       partition.
1453
1454     * Volumes are properly marked in use on creation and subsequently on
1455       examination with vos.
1456
1457   Microsoft Windows
1458
1459     * Undo the "UAC manifest fix" applied to afs_config.exe.
1460
1461     * Ensure that Freelance allocation of vnodes follow the AFS convention
1462       of odd vnodes are directories and everything else is an even vnode.
1463
1464     * Add Freelance logic to mount point and symlink evaluation functions.
1465
1466     * Enhance smb_ParseASCIIBlock() so that it can handle all of the
1467       STRING formats defined by the CIFS Technical Report 1.0.
1468
1469     * Validate the output of smb_ParseASCIIBlock() in all callers.  Return
1470       CM_ERROR_BADSMB if the STRING field cannot be parsed.
1471       CM_ERROR_BADSMB will cause the contents of the packet to be logged.
1472
1473     * If multiple SMB Raw Write operations were taking place at the same
1474       time, there could be data corruption because unique event objects
1475       were not generated for each Netbios receive operation.
1476
1477   All UNIX client platforms
1478
1479     * Userspace AFS library can now deal with large files when supported
1480       by the platform.
1481
1482     * Numerous updates to disconnected AFS support, including changes to
1483       allow reconnection to work in more circumstances.
1484
1485   FreeBSD
1486
1487     * FreeBSD unstrategy code has been updated.
1488
1489   Linux
1490
1491     * A race during file truncation has been corrected.
1492
1493     * System call probing routines have been updated.
1494
1495     * 2.6.29 is now supported.
1496
1497   MacOS
1498
1499     * 10.3 support has been corrected.
1500
1501   OpenBSD
1502
1503     * Initial OpenBSD 4.4 support.
1504
1505   Solaris
1506
1507     * Updates to allow compiling on newer OpenSolaris are now included.
1508
1509
1510 OpenAFS 1.5.56 (2008-12-30)
1511
1512   All platforms
1513
1514     * libuafs (userspace cache manager) updated to correct several errors.
1515
1516     * Additional rx debugging support is available as a conditional
1517       compile.
1518
1519     * A race condition in Rx leading to a panic has been corrected.
1520
1521     * Rx idle time tracking has been corrected.
1522
1523     * ubik clone server support has been corrected.
1524
1525   All server platforms
1526
1527     * Salvager no longer leaves cores in vice partitions.
1528
1529     * The vol-dump tool now supports dumps larger than 2gb where possible.
1530
1531     * Operations on multiple files now report all FIDs in the audit log.
1532
1533     * butc XBSA support now works correctly on amd64.
1534
1535   Microsoft Windows
1536
1537     * The NetIDMgr AFS Provider automated configuration logic was broken
1538       by the introduction of Kerberos referrals.  If the realm of the
1539       identity cannot be determined, the workstation cell is now assumed
1540       to belong to the newly created identity.
1541
1542     * Avoid a reference count under flow during rename operations.
1543
1544     * Avoid a crash caused by treating an arbitrary length directory
1545       search mask as an 8.3 mask.
1546
1547     * Prevent rename operations if a case insensitive match for the target
1548       name already exists and does not refer to the object being renamed.
1549
1550     * Increase the maximum number of background daemons to 64.
1551
1552     * Fix the UAC manifest applied to afs_config.exe
1553
1554   All UNIX client platforms
1555
1556     * Updates to disconnected AFS support.
1557
1558   FreeBSD
1559
1560     * FreeBSD 7.1 is now supported.
1561
1562     * amd64 FreeBSD is now supported.
1563
1564   Linux
1565
1566     * Generic fh (exportfs API) cache type is now available.
1567
1568     * Avoid some oopses due to backing_dev_info inode fields not being
1569       filled.
1570
1571     * 2.6.28 is now supported.
1572
1573   MacOS
1574
1575     * 10.3 support has been corrected.
1576
1577   Solaris
1578
1579     * Large partition support has been corrected.
1580
1581     * Filesystem-agnostic cache is now available on Solaris 10 and 11.
1582
1583
1584 OpenAFS 1.5.55 (2009-11-10)
1585
1586   All platforms
1587
1588     * Salvager avoids leaving core files in vice partitions.
1589
1590     * NFS translator fixes.
1591
1592     * Unresponsive server handling fixes.
1593
1594     * A volserver race which could result in duplicate transactions is
1595       fixed.
1596
1597   Microsoft Windows
1598
1599     * Fixes a panic caused by corruption of the SMB virtual circuit list.
1600       (race condition)
1601
1602     * Fixes a panic caused by receipt of a UTF-16 string that cannot be
1603       converted to UTF-8.
1604
1605     * Implements a more aggressive recovery algorithm for Netbios errors
1606       that result in loss of communication to the AFS SMB server.
1607
1608     * Improve pioctl response time when testing whether or not a PATH is
1609       in AFS.
1610
1611     * Adds support for linked cells.
1612
1613     * Increases the length of the cell and realm names that can be input
1614       into the Network Identity Manage AFS provider configuration dialog.
1615
1616   All UNIX client platforms
1617
1618     * Disconnected AFS avoids infinite recursion during rmdir.
1619
1620   Linux
1621
1622     * Support for 2.6.28 (not complete for NFS translator modules).
1623
1624     * Support for using exportfs API for filesystem-agnostic cache.
1625
1626     * Disable backing store readahead.
1627
1628     * Avoid deadlocks when writing back mmapped files larger than the
1629       cache.
1630
1631     * Avoid Oops when doing PAG garbage collection.
1632
1633
1634 OpenAFS 1.5.54 (2008-10-08)
1635
1636   All platforms
1637
1638     * Updates for new Tivoli X/Open API finding.
1639
1640     * A double-free is corrected in Rx.
1641
1642   All server platforms
1643
1644     * Ubik cleans up file descriptor cache correctly when doing recovery.
1645
1646     * Enhanced vldb error checker included.
1647
1648   Microsoft Windows
1649
1650     * Prevent a crash that could occur when multiple file / directory
1651       change notifications are processed simultaneously.
1652
1653   MacOS
1654
1655     * AFS claims more free space so Finder will attempt file copies.
1656
1657   Linux
1658
1659     * Avoid spurious ENOENT when calling gwtcwd() on a volume root.
1660
1661     * Avoid spurious ENOTDIR during fakestat.
1662
1663
1664 OpenAFS 1.5.53 (2008-09-26)
1665
1666   All platforms
1667
1668     * rx avoids many packet leaks.
1669
1670     * rx jumbogram disabling now works (and is the default).
1671
1672   All server platforms
1673
1674     * Demand Attach fileserver tries to avoid issues tracking offline
1675       status of volumes.
1676
1677   Microsoft Windows
1678
1679     * Many potential deadlock conditions due to out of order lock
1680       acquisitions have been corrected.
1681
1682     * A race condition resulting in an undercount on the cm_scache_t
1683       reference counts has been corrected.
1684
1685     * An empty string when sent as an ioctl path is now properly
1686       interpreted as meaning the current directory.  This affects "fs
1687       lsm", "symlink list", etc.
1688
1689     * Fix smb string parsing differences where the smb protocol
1690       documentation does not match the actual Windows implementation.
1691
1692     * Random access denied errors fixed.
1693
1694     * A file server lock synchronization issue was corrected in SMB
1695       NTCreateX and NTTranCreate operations.  This bug prevented properly
1696       operation when loading roaming profiles.
1697
1698     * Fix a heap overwrite error during server probe operations if a new
1699       server is added while a probe operation is in progress.
1700
1701     * Fix an LSA memory leak that was the result of an LSA error.
1702
1703     * Do not leak cm_cell_t objects if the VLDB server lookup fails.
1704
1705     * Only initialize rx mutex/lock objects once.
1706
1707     * Do not nul terminate the AFS volume name when reported to Windows.
1708
1709     * Improve VNOVOL error handling.  Prevent updated vl information from
1710       being destroyed immediately after it was acquired.  This bug
1711       prevented proper fail over when volumes are moved or removed from a
1712       server.
1713
1714     * Remove volume id from the server volume list in response to VMOVED
1715       and VNOVOL errors.
1716
1717     * "fs flushXXX" commands now destroy locally built B+ directory trees.
1718
1719     * Prevent mixture of locally modified directory pages and file server
1720       directory pages.
1721
1722     * Fail over to alternate vl servers if a ubik error is returned.
1723
1724   All UNIX client platforms
1725
1726     * Disconnected AFS now supports read-write mode.
1727
1728     * volserver now builds correctly.
1729
1730   AIX
1731
1732     * AIX 6 is now supported.
1733
1734   FreeBSD
1735
1736     * FreeBSD 7 is now supported.
1737
1738   Linux
1739
1740     * cache bypass is now supported.
1741
1742     * 2.6.x kmod compilation now uses kernel compile options always.
1743
1744     * Support through 2.6.27.
1745
1746   MacOS
1747
1748     * Show more space free so Finder doesn't get confused.
1749
1750   Solaris 10
1751
1752     * Default to namei rather than inode.
1753
1754
1755 OpenAFS 1.5.52 (2008-08-18)
1756
1757   All platforms
1758
1759     * Initialize volume updateDate at volume creation.
1760
1761     * Avoid potential corruption of directories during salvage.
1762
1763     * Check for out of memory condition during allocation of additional Rx
1764       packets.
1765
1766   Microsoft Windows
1767
1768     * Restore support for Windows 2000 (broken in 1.5.50).
1769
1770     * Perform additional validation on volume names in mount points during
1771       creation and evaluation.
1772
1773     * Fix several deadlocks, races, and reference count issues.
1774
1775     * Further optimize SMB Directory Search processing and minimize the
1776       number of InlineBulkStatus RPCs sent to the file server.
1777
1778     * Enable "bos restricted" operations.
1779
1780     * Fix the create of submounts used by the AFSCreds and afs_config
1781       drive mapping tabs.
1782
1783     * Fix a short name truncation bug. (1.5.50)
1784
1785     * Fix the error code reported when attempting to delete a file on a
1786       readonly volume or one that is marked with the readonly DOS
1787       attribute.
1788
1789     * Fix a heap corruption error when reading the CellServDB file
1790       location.
1791
1792     * Add the "RxUdpBufSize" registry value.  The new default is 256KB.
1793
1794     * Do not include trailing NULs in the directory search output.
1795       (1.5.50)
1796
1797     * Pre-allocate 64 Rx Packet buffers per thread in order to improve
1798       performance.
1799
1800     * For debugging: add smb lock requests and stat cache lock allocations
1801       to the output from "fs memdump".
1802
1803   NetBSD
1804
1805     * Workaround broken sigwait() to allow fileserver to shut down
1806       correctly pre NetBSD 5.0.
1807
1808   Solaris 10
1809
1810     * Default to namei fileserver; Allow inode fileserver at configure
1811       time by override.
1812
1813   NFS translator
1814
1815     * Try harder to avoid kernel panics for malformed requests.
1816
1817
1818 OpenAFS 1.5.51 (2008-07-29)
1819
1820   All platforms
1821
1822     * salvager tries harder to arrange for clients to get VBUSY while
1823       salvaging single volumes.
1824
1825     * salvager avoids certain corruption when salvaging directories.
1826
1827     * Rx connection clones disabled.
1828
1829   Microsoft Windows
1830
1831     * The 32-bit EXE 1.5.50 installer failed to properly install the C
1832       Runtime library.  When used as an upgrade OpenAFS would continue to
1833       work but when used as a new installation, OpenAFS binaries would
1834       fail to load.
1835
1836     * Fixes the "fs" and "symlink" commands to properly parse Unicode path
1837       prefixes during the pioctl remote procedure call.  This bug would
1838       result in file not found errors for files and directories that
1839       clearly exist.  (Bug introduced in 1.5.50)
1840
1841     * Large File support is disabled. (Bug introduced in 1.5.50)
1842
1843     * Removes the possibility of a deadlock during volume location update
1844       operation if all of the reported file servers are unreachable at the
1845       time of the update.
1846
1847     * Ensures that reference counts are properly incremented/decremented
1848       on Rx connection objects used for volume location RPCs.
1849
1850     * Over Quota errors during cm_FSync() calls would lead to an infinite
1851       loop as the error was never propagated to the caller.
1852
1853   All UNIX client platforms
1854
1855     * Bugfixes to disconnected AFS support in the cache manager.
1856
1857
1858 OpenAFS 1.5.50 (2008-07-16)
1859
1860   All platforms
1861
1862     * volserver puts recloned volumes back online before returning the
1863       volume to the fileserver, avoiding spurious VNOVOL errors.
1864
1865     * Updated TSM X/Open API support available.
1866
1867     * Demand Attach fileserver will not crash due to accesses during
1868       volume cloning.
1869
1870     * Substantial documentation updates.
1871
1872     * Demand Attach fileserver state tracking and analyzer tool
1873       improvements.
1874
1875     * UAFS userspace cachemanager updates.
1876
1877     * Corrected support for anti-meltdown protection in the client.
1878
1879   Microsoft Windows
1880
1881     * UNICODE Character Set Support.
1882
1883     * Pioctl interfaces to the cache manager have been refactored to
1884       provide layering between the SMB specific code and the general
1885       purpose ioctl operation.
1886
1887     * Garbage collect dead SMB virtual circuits as soon as they are no
1888       longer being referenced.  This avoids problems with outstanding
1889       locks not being dropped when the virtual circuit becomes invalid.
1890
1891     * Remove the IBM Administration Reference documentation and replace it
1892       with the OpenAFS Command Reference Manual.
1893
1894     * Avoid calling rx_SetDeadTime and rx_SetHardDeadTime functions each
1895       time a connection is about to be used.  Do not hold a lock on the rx
1896       connection object while it is being selected.  This avoids a race
1897       between threads attempting to set the timeout values and removes a
1898       bottleneck that was hampering performance.
1899
1900     * Ensure that the smb directory attribute is set for all directory
1901       objects.
1902
1903     * Replace the VC Runtime EXE installer with the MSI installer in the
1904       NSIS installer scripts.
1905
1906   Solaris
1907
1908     * Support for updates to OpenSolaris.
1909
1910   Linux
1911
1912     * Correct dentry revalidation for cross-directory renames.
1913
1914     * Updated rpm packaging materials for 1.5 release series and 2.4
1915       kernels.
1916
1917     * Corrected syscall table probing.
1918
1919     * NFS translator updates for current kernels.
1920
1921
1922 OpenAFS 1.5.39 (2008-06-24)
1923
1924   All platforms
1925
1926     * Updates for Demand Attach fileserver.
1927
1928   Microsoft Windows
1929
1930     * Fix two memory leaks.
1931
1932     * Fix one missing lock.
1933
1934     * Handle access denied errors when writing dirty buffers.
1935
1936     * Fix two errors that would cause the *experimental* AFS Servers
1937       to crash.
1938
1939
1940 OpenAFS 1.5.38 (2008-05-24)
1941
1942   All platforms
1943
1944     * Add read-only disconnected support.
1945
1946
1947 OpenAFS 1.5.37 (2008-05-21)
1948
1949   All platforms
1950
1951     * Includes a number of optimizations for testing.
1952
1953
1954 OpenAFS 1.5.36 (2008-05-09)
1955
1956   All platforms
1957
1958     * Rx optimizations now attempt to deal with high latency WANs.
1959
1960     * Client will not wait infinitely for a server which is not providing
1961       data.  Additional servers will be polled without marking the server
1962       which is not providing data down.
1963
1964     * vos move will not erroneously unlock locked vldb entries on failure.
1965
1966   All server platforms
1967
1968     * Fileserver avoids a potential infinite loop when a client
1969       relinquishes an address.
1970
1971     * Fileserver large setting now configures more threads.
1972
1973     * Fileserver properly registers uuids of new clients.
1974
1975     * Ubik servers do not improperly hide updates from clients.
1976
1977     * Fileservers reserve enough file descriptors such that each thread
1978       can cache one to avoid spurious errors.
1979
1980   Microsoft Windows
1981
1982     * Fix a cm_buf_t reference count leak when attempts to write dirty
1983       buffers to the file server from within cm_IncrSyncer() fail.
1984
1985     * Prevent udebug from crashing.
1986
1987     * Another VNOVNODE issue fixed.  When writing a dirty buffer to the
1988       file server, if VNOVNODE is received, mark all buffers as invalid
1989       without further attempts to contact the file server.
1990
1991
1992 =======> Changes back to 1.3 have not yet been incorporated here <=======
1993
1994
1995 OpenAFS 1.3
1996
1997   * -nosettime is now the default for afsd.  Use "-settime" to get the
1998     old behavior.
1999
2000   * OpenBSD is now supported.
2001
2002   * Mountpoint directory information is now only faked for cross-cell
2003     mountpoints when using the -fakestat flag (e.g. for the directories
2004     under /afs, but not for most other volumes mounted inside the cell).
2005     The -fakestat-all switch can be used to fake information for all
2006     mountpoints.
2007
2008   * When fakestat is enabled on MacOSX, the Finder can be used to browse
2009     a fully-populated /afs directory.  However, this precludes reliable
2010     use of entire volumes as MacOS bundles (i.e. containing a Contents
2011     directory in the root of the volume).
2012
2013   * Mountpoint directory information can be faked by the cache manager,
2014     making operations such as stat'ing all cells under /afs much faster.
2015     This is enabled by passing -fakestat to afsd, but might not be stable
2016     on all platforms.
2017
2018
2019 OpenAFS 1.2.9
2020
2021   * The kaserver now defaults to not allowing interrealm authentication,
2022     due to security vulnerabilities in the krb4 protocol.  The new
2023     "-crossrealm" flag to the kaserver is provided to reenable interrealm
2024     authentication if desired.
2025
2026   * RedHat Linux 9.0 is now supported.
2027
2028   * Solaris 9 12/02 is now supported.  Solaris 7 and 8 x86 should now
2029     work again.
2030
2031   * On Linux machines using 2.2 series kernels, 2.2.19 or higher is now
2032     required.
2033
2034   * An OpenAFS 1.2.9 afsd will not work with kernel modules built from
2035     an earlier OpenAFS release.  In general, using a mismatched afsd and
2036     kernel modules set is unsupported; it is not recommended that you use
2037     such a configuration on a regular basis.
2038
2039
2040 OpenAFS 1.2.8
2041
2042   * Mountpoint directory information is now only faked for cross-cell
2043     mountpoits when using the -fakestat flag (e.g. for the directories
2044     under /afs, but not for most other volumes mounted inside the cell).
2045     The -fakestat-all switch can be used to fake information for all
2046     mountpoints.
2047
2048   * HPUX 11.0 is now supported.
2049
2050   * It is now possible for AFS to use Kerberos 5 directly, via rxkad 2b.
2051     See the OpenAFS 1.2.8 Release Notes for more information on using this
2052     capability.
2053
2054   * An NFS translator kernel module is now included and compiled by
2055     default for Solaris only.
2056
2057
2058 OpenAFS 1.2.7
2059
2060   * MacOS X 10.2 is now supported.  FreeBSD 4.3 and later support is
2061     included in this release, but is still under active development and
2062     should only be used by those doing active development on the OpenAFS
2063     FreeBSD client.
2064
2065   * When fakestat is enabled on MacOSX, the Finder can be used to browse a
2066     fully-populated /afs directory.  However, this precludes reliable use
2067     of entire volumes as MacOS bundles (i.e. containing a Contents
2068     directory in the root of the volume).
2069
2070   * The fileserver will now use Rx pings to determine if clients are
2071     reachable prior to allocating resources to them, to prevent asymmetric
2072     clients from consuming all fileserver resources.
2073
2074
2075 OpenAFS 1.2.6
2076
2077   * Mountpoint directory information can be faked by the cache manager,
2078     making operations such as stat'ing all cells under /afs much faster.
2079     This is enabled by passing -fakestat to afsd.
2080
2081   * Solaris 9 FCS and Solaris 7 and 8 x86 are now supported.
2082
2083
2084 OpenAFS 1.2.5
2085
2086   * A remote denial of service attack in the AIX and IRIX clients has been
2087     fixed.  Users of those platforms are strongly encouraged to upgrade.
2088
2089   * Fixed race conditions in fileserver that could result in crash.
2090
2091
2092 OpenAFS 1.2.4
2093
2094   * Server logfiles now more consistant about format in which hosts are
2095     referred to.
2096
2097   * vfsck on Solaris will now allow force runs (using -y flag) even if old
2098     inodes exist.
2099
2100
2101 OpenAFS 1.2.3
2102
2103   * Cell aliases for dynroot can be specified in the CellAlias file in
2104     /usr/vice/etc or /usr/local/etc/openafs, in format "realname alias",
2105     one per line.  They can also be managed at runtime with "fs newalias"
2106     and "fs listaliases".
2107
2108
2109 OpenAFS 1.2.2
2110
2111   * Solaris 9 and Linux PA-RISC are now supported.
2112
2113   * fileserver will not erroneously delay legitimate errors for 3 seconds
2114     after 10 errors are returned (e.g. stat() on a directory you can't
2115     read).
2116
2117   * Rx MTU calculation now works for Irix, Solaris and Linux
2118
2119   * If afsd is started with the -dynroot flag, /afs will be locally
2120     generated from the CellServDB.  AFSDB cells will be mounted
2121     automatically upon access.
2122
2123   * The namei fileserver allows vice "partitions" to be directories
2124     instead of partitions and will attach and display accordingly.
2125     Creating the file "AlwaysAttach" in the /vicepX directory is used as
2126     the trigger to attach it.
2127
2128   * TSM support for butc no longer requires editing a Makefile, simply
2129     specify the --enable-tivoli-tsm configure option.
2130
2131   * Linux builds no longer require source changes every time the kernel
2132     inode structure changes; the OpenAFS sources will now configure itself
2133     to the actual inode structure as defined in the kernel sources.
2134
2135
2136 OpenAFS 1.2.1
2137
2138   * vfsck on Digital UNIX and Solaris will now refuse to fsck mounted
2139     mounted partitions.
2140
2141
2142 OpenAFS 1.2.0
2143
2144   * AFS now supports --prefix and the other directory options of
2145     configure.  By default AFS builds assuming it will be installed in
2146     /usr/local.  In order to get traditional AFS directory paths (/usr/afs
2147     and /usr/vice/etc) use the --enable-transarc-paths option to
2148     configure.  More details on the new directory layout are found in
2149     README.
2150
2151
2152 OpenAFS 1.1.1a
2153
2154   * Windows 95/98/ME/NT/2000 - Consistent versioning:  Installation, AFS
2155     Control Center, Client dialog boxes and properties pages for
2156     executables display a consistent OpenAFS version number.  Installation
2157     detects previous installation and prompts the user for upgrade
2158     options.
2159
2160   * Windows 95/98/ME/NT/2000 - Installation features:  During installation
2161     the user can select the source of the CellservDB file, AFS home cell,
2162     and drive mappings.  During installation a drive path mapping can
2163     include a variable that will be substituted with the current UserName
2164     that is logged in.
2165
2166   * Windows 2000/NT - Integrated logon:  The Integrated Logon feature
2167     works now.
2168
2169   * Windows 95/98/ME - Logon script features:  The Windows 95/98/ME client
2170     now offers a command-line option for starting up the AFS client
2171     without authenication. It is now possilbe to start the AFS client
2172     first and obtain tokens, and map drives all through Windows scripts.
2173     This helps using Windows 95/98/ME client in Kerberos 5 environment.
2174
2175   * Windows 2000/NT - LANA numbers:  AFS client now scans the LANA numbers
2176     to establish the correct NETBIOS connection.  NetBEUI is no longer
2177     needed.  The user no longer needs to find the correct LANA number.
2178
2179   * Windows 2000/NT - OpenAFS naming consistancy:  Further progress has
2180     been made to remove references to "Transarc AFS" and replace with
2181     "OpenAFS".
2182
2183
2184 OpenAFS 1.0
2185
2186   * AFS now builds with configure. The README for building has been
2187     updated and includes full details.
2188
2189   * A client system can now have multiple sysname values for @sys.  They
2190     will be searched in order when looking up files in AFS.  The
2191     -newsysname argument to fs sysname can be repeated to set multiple
2192     sysnames.
2193
2194   * A new system group is created for new cells (system:ptsviewers with id
2195     -203).  If this group exists, members of this group can examine and
2196     read the entire protection database.  They can examine all users and
2197     groups and can get the membership of any group.
2198
2199   * A new program, pt_util has been added to the distribution.  This
2200     program allows users to print the contents of the protection database
2201     or to edit the protection database without running a ptserver.  It can
2202     be used to set up a new cell without ever running in noauth mode.  Run
2203     pt_util -h for help.
2204
2205   * The fs setcrypt and fs getcrypt commands have been added.  These
2206     commands allow the system administrator to require that the client
2207     encrypt all authenticated traffic between the client workstation and
2208     AFS.  The encryption used is weak, but is likely better than sending
2209     unencrypted traffic in most environments.  Some functions, such as
2210     looking for a volume may not be encrypted, but data transfer certainly
2211     is.  By default data is not encrypted.  At this time no significant
2212     experimentation with server performance has been conducted.
2213
2214   * By default AFS is compiled with AFS_AFSDB_ENV, enabling the -afsdb
2215     option to be given to afsd on startup.  If this option is used, then
2216     new cells will be looked up using AFSDB records stored in DNS if they
2217     are not found in CellServDB.  This means that users can create
2218     cross-cell mountpoints in directories they control to access cells not
2219     in root.afs, and that cells in root.afs need not be in the client's
2220     CellServDB.
2221
2222   * AFS database servers can be marked as read-only clones.  Surround the
2223     hostname in square brackets on the bos addhost command and the
2224     database server will never be elected sync site.  This is useful for
2225     cells distributed over a wide region.
2226
2227   * The AFS servers now support the -syslog flag.  This flag causes them
2228     to log to syslog rather than to files.  This flag is not supported on
2229     NT.  For all servers besides the salvager, the flag can also be
2230     specified as -syslog=facility, where facility is an integer facility
2231     code from syslog.h.  A -syslogfacility option is provided for the
2232     salvager to accomplish the same goal.
2233
2234   * If the --enable-fast-restart flag is given when configuring AFS, then
2235     the salvager supports the -dontsalvage flag which causes it to exit
2236     without salvaging any volumes.  If this is configured into the third
2237     command of a fs process, then the fileserver will start without
2238     salvaging.  It will fail to attach volumes that need salvaging and
2239     they can be salvaged manually.  This provides significantly better
2240     server startup performance at the cost of administrative complexity.
2241
2242   * If the --enable-bitmap-later flag is given when configuring AFS, then
2243     the fileserver creates bitmaps for free vnodes on demand, allowing
2244     faster starts.
2245
2246   * If bosserver finds a BosConfig.new file at startup, it reads this file
2247     and renames it to BosConfig.  This allows bosserver to be reconfigured
2248     at next restart.
2249
2250   * The bosserver can be placed in a restricted mode in which AFS
2251     superusers are only granted limited access to the server host. The
2252     following functionality is disabled when restricted mode is in use:
2253
2254       bos exec
2255       bos getlog (except for files with no '/'s in their name)*
2256       bos create *
2257       bos delete
2258       bos install
2259       bos uninstall
2260
2261     specific exceptions are made for functionality that "bos salvage"
2262     uses:
2263
2264     A cron bnode who's name is "salvage-tmp", time is now, and command
2265     begins with "/usr/afs/bin/salvager" may be created. This bnode deletes
2266     itself when complete, so no special "delete" support is needed.  This
2267     functionality may be removed in the future if a "Salvage" RPC is
2268     implimented.
2269
2270     The file with the exact path /usr/afs/logs/SalvageLog may be fetched,
2271     since that is how bos salvage [...] -showlog is implimented.
2272
2273     Restricted mode is enabled using a new bos command (bos setrestricted)
2274     or bossever command line switch (bosserver -restricted). Restricted
2275     mode can be disabled by a) sending the bosserver process a SIGFPE
2276     (which will then allow restricted operations until the next restart or
2277     setrestricted command) or b) editing /usr/afs/local/BosConfig (or
2278     BosConfig.new), and restarting the bosserver.
2279
2280   * The bos UserList of trusted administrators can now contain cross-realm
2281     Kerberos principals.
2282
2283   * udebug now takes --server not --servers.
2284
2285   * Several error messages have been improved to include volume numbers.
2286
2287   * Several new ports have been included for UNIX platforms: Darwin
2288     (ppc_darwin_12 and ppc_darwin_13), Linux 2.4 (i386_linux24), Linux on
2289     the Powerpc (ppc_linux22 and ppc_linux24), Linux on the Sparc
2290     (sparc_linux22, sparc64_linux22 and sparc64_linux24).
2291
2292   * Incomplete FreeBSD and Alpha Linux ports are included.  The FreeBSD
2293     port has a working server and the Alpha Linux port has a partially
2294     working client.
2295
2296   * A native client for Windows 95/98/ME has been added to the
2297     distribution.  With this program, a gateway machine is no longer
2298     required for Windows 9x to access AFS files.  One drive letter will be
2299     created on your machine by default - Z:.  The Z: drive will be the
2300     root of the AFS tree, allowing you to browse all sites that have AFS
2301     servers available.  Additional drive letters can be defined for other
2302     AFS directories.  A Windows Explorer shell extension is included that
2303     allows you to right click on items within an AFS tree to bring up an
2304     "AFS" menu item and perform various operations on a file or directory.
2305     The most useful item is "Access Control Lists", which allows you to
2306     view and edit the permissions of a particular directory.  Command line
2307     tools are also available in the install directory.  These commands
2308     include klog, unlog, tokens, kpasswd, symlink, fs and pts.  The
2309     installable includes a readme file that contains more information on
2310     how to use the client program and known issues.
2311
2312   * Support for large caches in afsd.  Cachefiles are stored in
2313     subdirectories.  The default is 2048 files per subdirectory, which
2314     should work fine in most situations.  You can use the new afsd option
2315     -files_per_subdir to change this number.  Note that the first time you
2316     run afsd with this patch, your cachefiles will get moved into
2317     subdirectories.  If you subsequently run an older version of afsd, you
2318     will lose all your cached files.