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