Windows: change log for 1.5.9905
[openafs.git] / doc / txt / winnotes / afs-changes-since-1.2.txt
1 Since 1.5.9904 (1.6pre4)
2  * Fix caching of non-existent volumes.  The test to
3    trigger an immediate CM_ERROR_NOSUCHVOLUME in
4    cm_UpdateVolumeLocation() was backwards.
5
6  * Prevent the background daemon from checking the
7    status of non-existent volumes.  cm_CheckOfflineVolumes()
8    should skip volume groups with the CM_VOLUMEFLAG_NOEXIST
9    flag set.
10
11  * The afskfw library should return an error immediately
12    if the krb5_32.dll library cannot be loaded.  Affects
13    afslogon.dll and afscreds.exe.
14
15  * No longer depend on leashw32.dll in afskfw library.
16
17  * NPLogonNotify must provide the user password in all
18    calls to KFW_AFS_get_cred().  It cannot count on a
19    credential cache being preserved between calls.  Permits
20    tokens to be acquired for all cells listed in the
21    TheseCells registry value for a domain.
22
23  * Improve the trace logging from NPLogonNotify().
24
25  * Avoid a race when writing the cm_scache_t mountPointString
26    when acquiring mount point or symlink target data via
27    cm_GetData().  The race could result in bogus target
28    data being cached.
29
30  * Permit the use of des-cbc-md5 and des-cbc-md4 enctypes
31    as DES keys in asetkey.exe.
32
33 Since 1.5.9903 (1.6pre3)
34  * Fix automatic addition of Freelance cell mount points
35    broken in 1.5.9902.
36
37  * Avoid recursive offline volume checks which could cause
38    a crash due to stack exhaustion.
39
40 Since 1.5.9902 (1.6pre2)
41  * rx calls issued on a busy call channel are now specially
42    handled and logged.  All calls are automatically retried.
43
44  * The vos support for multi-homed servers was incorrectly
45    implemented.  The changes have been reverted.
46
47  * Avoid wasting cm_buf_t objects and associated data buffers
48    for obtaining mountpoint and symlink target strings.  Instead
49    read them directly into the cm_scache_t mountPointTarget
50    buffer.
51
52  * Optimize the evaluation of mountpoint and symlink targets
53    by skipping the FetchStatus and a full round-trip if
54    the cache manager does not have valid status information
55    for the object.
56
57  * Fix the abstraction of cm_FreelanceAddMount() by passing
58    in volume names that do not include the trailing dot.
59
60 Since 1.5.78
61  [there was no 1.6pre1 for Windows]
62
63  * vos commands now manipulate servers by UUID and can
64    recognize multi-homed servers.
65
66  * afs_config will not longer set the Tray Icon State
67    in the registry if the checkbox is not present in
68    the dialog. [RT 128591]
69
70  * Heimdal's roken utility library has been added
71    as \Program Files\Common\afsroken.dll
72
73  * When probing servers to determine if they are up or down
74    no longer issue an RXAFS_GetTime RPC to servers that indicated
75    that they do not understand the RXAFS_GetCapabilities RPC.
76    Since they responded it is known that they are up.
77
78  * AFS Explorer Shell Extension now works from folder
79    backgrounds.  Overlays for mount points and symlinks
80    are present in the dll, but are not registered at present
81    by the installers.
82
83  * Do not use RankServerInterval registry value as the value for
84    PerformanceTuningInterval.
85
86  * CellServDB updated to 13 Dec 2010 release from grand.central.org
87
88  * Add "fs chmod" command and display current mode as part
89    of "fs examine" output.
90
91  * When the data version of a mountpoint or symlink changes,
92    the target string in the cm_scache_t object must be cleared.
93    Otherwise, the new target will not be queried.
94
95  * "fs checkservers" now includes vldb servers in the output
96    and only lists multi-homed servers once.  A multi-homed
97    server that has at least one up interface is no longer
98    considered to be down.
99
100  * When asynchronously storing dirty data buffers to the
101    file server ensure that (a) the cm_scache_t object and
102    the cm_buf_t object are for the same File ID so that
103    locking and signalling work properly; and (b) if the
104    FID no longer exists on the file server, do not panic,
105    just discard the buffer.
106
107  * When processing VNOVOL, VMOVED and VOFFLINE errors perform
108    server comparisons by UUID or address and not simply by
109    cm_server_t pointer.  Otherwise, server failover may not
110    succeed.
111
112  * Do not preserve status information for cm_scache_t objects
113    when the issuing server is multi-homed.
114
115  * Giving up all callbacks when shutting down or suspending
116    the machine is now significantly faster due to the use
117    of an rx_multi implementation.  (This functionality is
118    still off by default and must be activated by a registry
119    value.)
120
121  * Race conditions were possible when updating the state
122    of the cm_volume_t flags and when moving the volumes
123    within the least recently used list.
124
125  * Ensure that the lanahelper library does not perform a
126    NCBRESET of each lan adapter when enumerating the
127    current network bindings.  Correcting this permits OpenAFS
128    to work on Windows 7 when the network adapter settings
129    change.
130
131  * Fix creation of mount points and symlinks as \\AFS\xxxx
132
133
134 Since 1.5.77
135  * Reimplement FetchData and StoreData operations to make
136    use of rx_Writev and rx_Readv which is faster than than
137    multiple calls to rx_Write and rx_Read.  Throughput
138    improvements of up to 20% are possible.
139
140  * Many improvements to the rx rpc stack:
141
142    - RTT measurements
143
144    - Fast recovery is not triggered by packet resend timeouts
145
146    - Socket errors are now detected and reported
147
148    - avoid repetitive memory allocations
149
150    - avoid calling gettimeofday() for every packet
151
152    - reduced dependency on the call->lock
153
154    - When a call receive is completed, ack all of the packets
155      immediately.  Do not wait for the first response packet
156      to be sent.
157
158    - Do not hold the call->lock during rx_Write* and rx_Read*
159      operations when the call fields in use can only be accessed
160      by the application thread.
161
162    - Reduce the default window size from 128 back to 32 because
163      the current overhead from walking packet queues in the rx
164      listener thread significantly hampers the ability to
165      process incoming packets from the network.
166
167    - Only backoff the peer timeout once for a series of naks.
168
169    - Release builds are lean and mean.  All debugging and
170      packet tracking code is disabled.
171
172  * Version number is logged to the Windows Application Event
173    Log as part of the start pending message.
174
175  * MSI installers now backup and restore configuration
176    data during upgrades.
177
178  * Rx pmtu discovery has been disabled by default.  Use
179      HKLM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
180        RxPMTUDiscovery "DWORD"
181    value to re-activate.
182
183  * cm_BkgDaemon event evaluation has been optimized to avoid
184    unnecessary overhead.
185
186  * If a volume is known to be readonly, then locally fail any
187    change request without sending it to the file server.  This
188    avoids triggering the file server's abort threshold.
189
190  * Do not leak cm_volume_t objects from the volume LRU queue.
191
192  * Ensure that cm_NameI errors are acted upon promptly.
193    There are many cases in the SMB server where an error from cm_NameI()
194    was either ignored or not acted upon until several other operations
195    are performed that could result in the same error being repeated.
196    This is a mistake which did not have negative side effects until
197    additional checks for callback status were added recently.
198
199    At present, if a CM_ERROR_ACCESS error is returned and ignored,
200    subsequent attempts to operate on the same cm_scache_t will result
201    in additional queries to the file server that will also end in an
202    abort response.  This can trigger the file server to delay responses
203    to the client.
204
205  * Fix fs mount point and symlink create operations which were
206    failing due to improper directory separator termination.
207
208  * RXAFS_GetVolumeStatus can return VNOVOL, VMOVED, etc.  In
209    order to process them and update volume state a fid must
210    be passed to cm_Analyze().  Use the volume root fid.
211
212  * Negative caching for volume lookups that fail with either
213    VL_NOENT or VL_BADNAME.  The expiration time is five minutes.
214    This prevents volume lookup storms.
215
216  * Provide each volume lookup its own two hour lifetime instead
217    of reseting all volume location information every two hours.
218    This prevents the first smb path evaluation after the volume
219    location data has been discarded from potentially causing an
220    smb client timeout.
221
222 Since 1.5.76
223  * When the SYSTEM account is in use, the SMB connection is
224    not always established as S-1-5-18.  Sometimes it uses an
225    anonymous, S-1-5-7, connection.  In both cases the SMB
226    authentication name is the nul string.  To better identify
227    when an SMB connection is local system, the smb_username_t
228    is now stored as a SID instead of a user name.  When a SID
229    is used, a new flag bit is set SMB_USERNAMEFLAG_SID.
230
231    In smb_SetToken if AFS_PIOCTL_AFSLOGON is set and the user
232    connection is not SYSTEM, the RPC SID is checked.  If RPC
233    SID is SYSTEM, that supercedes the SMB authentication.
234
235  * Replace STATUS_IO_TIMEOUT with RPC_NT_SERVER_TOO_BUSY for
236    CM_ERROR_ALLBUSY.
237
238  * Replace STATUS_PATH_NOT_FOUND with RPC_NT_SERVER_UNAVAILABLE
239    for CM_ERROR_ALLOFFLINE and CM_ERROR_ALLBUSY.
240
241  * Optimize behavior of buf_CleanAsyncLocked().  Avoid searching
242    for the cm_scache_t object by FID if it is already known.
243
244  * If the readonly file attribute is set (stored as a unix mode)
245    then a CreateFile operation should fail if the file is opened
246    for DELETE in combination with any other privilege.
247
248  * If the directory buffer contents are garbage we can crash
249    the service.  Add some simple validation checks to ensure
250    that cm_dirEntry_t objects have the correct flag value and
251    that the name strings are not too long.
252
253  * If the bulkStat errorCode indicates that a particular object
254    is inaccessible due to a VIO error, we must update the server
255    status appropriately in order to permit failover.
256
257  * An RX_MSGSIZE error is returned by the new PMTU detection
258    code.  It is critical that such an error result in a retry of
259    the operation that failed.  Otherwise, the PMTU detection can't
260    work and the server will be marked down.
261    Secondly, it is important that such errors not leak to the
262    application layer.  Map them to CM_ERROR_RETRY in all cases.
263
264  * Translate RX_RESTARTING to the same cache manager error code
265    for all RPC classes.
266
267  * When logging server volume instance errors to the windows
268    application event log, be sure to log the cell as well.
269    Translating from server ip address is non-trivial.  Make it
270    easier for administrators triaging issues to plug the volume
271    and cell info into vos commands.
272
273  * Since unix mode bits are represented in octal in most cases
274    make sure we log them that way.
275
276  * The cm_enforceTrailingDot() function failed if there was a
277    trailing dot followed by white space.
278
279  * Rx: Do not send RX_MSGSIZE if the PMTU size did not change.
280
281 Since 1.5.75
282  * A crash could occur if a single letter share name was
283    dynamically evaluated as matching a cell name.  This was
284    due to a failure to treat the comparison of two nul
285    strings as identical.
286
287  * Docbook validation is performed by xmllint during builds.
288
289  * Volume package bugs in the file server can result in VOFFLINE
290    being returned to the client instead of VNOVOL or VMOVED.  As
291    a result the Unix CM treats VOFFLINE the same as VMOVED and VNOVOL.
292    The Windows client has not.  As a result, bugs in the file server
293    can cause the Windows client to lose if the volume has in fact
294    been moved to another server.
295
296    As part of this change, the volume location list is updated prior
297    to the volume status being applied to the server from which the
298    error was received.
299
300  * If the pages to be flushed are from a readonly or backup volume
301    they can't be dirty.  In this case there is no need to stabilize
302    the pages before they are locked and recycled.
303    Stablilization is performed on the cm_scache_t object so do not
304    stabilize and unstablize for each cm_buf_t object.
305
306  * Over the years the processing of the Freelance callbacks have
307    added functionality that behaves much more like FetchStatus checks
308    to a file server.  If the data version of the object has changed,
309    get the new data.  Given that is the case, we can remove much of
310    the original refresh logic that is rather race prone.   Say goodbye
311    to cm_fakeGettingCallback and cm_fakeDirCallback.
312
313  * When processing a pioctl path with either smb_ParseIoctlPath or
314    smb_ParseIoctlParent, cm_SyncOp(CM_SCACHESYNC_NEEDCALLBACK|GETSTATUS)
315    must be called on the cm_scache_t object to ensure that it is up
316    to date before we permit cm_Lookup or other operations to be performed
317    on it.  Add the cm_SyncOp() call to smb_ParseIoctlPath and
318    smb_ParseIoctlParent to ensure it is done for all pioctl operations.
319
320  * The 32-bit tools installer was displaying client configuration wizard
321    pages.  Since, the 32-bit tools share configuration with the AFS
322    service, the 32-bit tools installer should not be attempting to change
323    client configuration.  Remove said wizard pages from the 32-bit tools
324    installer.
325
326  * cm_data.rootSCachep is a global pointer to the cm_scache_t that
327    represents the root.afs volume root directory.  Throughout the
328    code this cm_scache_t was being used without ensuring that a
329    callback to the volume is in fact valid.
330
331    Under most circumstances this would not be a problem.  However,
332    it is possible for a request to fail due to the lack of a callback
333    at a critical moment.  Add a new function cm_rootScachep() that
334    attempts to ensure that a callback is present (if possible) prior
335    to use the cm_scache_t object.
336
337  * When the contents of the Freelance root directory changes the fake
338    directory buffers are updated and a fakeDirVersion is incremented.
339    The dataVersion of the cm_scache_t object is supposed to be updated
340    on the next access by performing a fake get callback request.
341    Unfortunately, this did not always occur because of a race.  If another
342    Freelance object is updated first, the root directory object would
343    never successfully get a fake callback.
344
345    This patchset ensures that the generation of the fake directory
346    buffer content and the callback are obtained under the same set
347    of locks thereby removing the race.
348
349  * Enforce in afsd_service that tokens can be set for alternate
350    userids only if the SetToken pioctl is called from the
351    Local System account.
352
353 Since 1.5.74
354  * Revise SMB QuerySecurityInfo Response for MS10-020
355
356    MS10-020 (http://support.microsoft.com/kb/980232) has caused
357    many problems for implementors of SMB 1.0 servers and applications
358    that call GetFileSecurity() without checking the return code to
359    determine if the call succeeded.  The gist of the vulnerability
360    was that the SMB redirector would pass any buffer it received
361    to the application regardless of whether or not it was valid.
362    MS10-020 protects the applications by strictly validating the
363    SMB response data structure and the data in the security descriptor
364    that is returned.
365
366    The problem for SMB 1.0 server implementors is that there have
367    been at least three different protocol descriptions for
368    NT_TRANSACT_QUERY_SECURITY_DESC published over the last decade
369    and all of them are incomplete.  Therefore, just about no one but
370    Microsoft has an SMB 1.0 server implementation that produces the
371    exact out that they are expecting to validate.
372
373    The end result is that in an attempt to protect applications from
374    crashing due to invalid input being passed in directly caused
375    dozens of applications to crash by not returning any security
376    descriptor data at all.  Even when the applications didn't crash
377    they might not have been able to save their data.  Cisco WAAS
378    and NetApp DataOnTap systems were most adversely affected and
379    they have had CIFS protocol licenses for many many years.
380
381    To fix OpenAFS here is what needed to be done:
382
383    1. Instead of returning a security descriptor that gives ownership
384       to the NUL SID, give it to the Everyone SID and set the flag
385       that states that everyone has full access.
386
387    2. Validate the input parameters.  In particular, check to ensure
388       that the SMB file descriptor is valid and the file has not
389       been deleted.
390
391    3. Enforce the maximum output data and parameter counts.
392
393    4. Handle buffer overflow and buffertoosmall conditions
394       in the manner that Microsoft expects them to be handled.
395       In particular, note that the parameter data which is returned
396       in the SMB Data Region is not counted in the Data Count.
397       Even if MaxData is 0, we can still return parameters values
398       as long as MaxParm is large enough.
399
400  * Prevent use of AFSCache file contents if mapped to
401    a new address.
402
403  * The Windows version of "fs newcell" did not accept any parameters
404    and behaved quite differently from the Unix version.  Instead of
405    permitting new cell information to be added, the Windows version
406    simply forced the existing cell information to be reacquired.
407
408    This update adds a new pioctl, VIOCNEWCELL2, to support the
409    implementation of a Unix-style "fs newcell".  The functionality
410    added here differs from the Unix version in the following ways:
411
412      1. "fs newcell" with no arguments is still accepted
413         in order to maintain compatibility with prior Windows
414         behavior.
415
416      2. "fs newcell -cell <cell> -dns" instructs the cache manager
417         to add the new cell but obtain the vldb server info from
418         DNS.
419
420      3. "fs newcell -cell <cell> ... -registry" instructs the cache
421         manager to add the new cell and also save the cell configuration
422         data in the registry for use the next time the service restarts.
423
424      4. The -vlport and -fsport options are accepted although the
425         -fsport value is currently unsupported by the cache manager.
426
427  * New registry value "FreelanceImportCellServDB" instructs Freelance
428    to create a mount point for every cell name listed within the
429    CellServDB.
430
431  * Path MTU discovery for Rx is activated.
432
433  * Rx socket input buffer is converted to a circular buffer.
434
435  * Fix usage of cm_FreeServerList().  Do not set the server list
436    pointer to NULL after calling cm_FreeServerList().  Doing so
437    can result in a memory leak.
438
439  * Only enable Rx NAT pings on a single anonymous connection at a
440    time.
441
442  * Fix cm_IoctlSkipQueryOptions() buffer management.  Prevents a
443    potential read beyond end of memory buffer.
444
445  * Reduce requested privileges when reading registry CellServDB
446    to the minimum required.
447
448  * Add support for RPC Pipe Service NetWkstaGetInfo levels
449    101 and 102 which are called on Windows 7 and 2008-R2.
450
451  * Prevent integer overflow during quota percent used calculation
452    in Explorer Shell Extension  (RT 126846)
453
454  * Generate a meaningful error if "fs listacls" or "fs setacls"
455    are executed on the Freelance root.afs volume.
456
457  * RXAFS_InlineBulkStat errors must be processed via cm_Analyze.
458    RXAFS_InlineBulkStatus does not return errors such as EACCES,
459    VNOVOL, VNOVNODE, VOFFLINE, VBUSY, VIO, VMOVED, etc. as an RPC return
460    code.  Instead they are returned in the status info errorCode field
461    for each file.
462
463    Traditionally, the error associated with the first FID in the query
464    list has been returned to the caller of cm_TryBulkStatRPC().
465    However, the error has never been processed through cm_Analyze()
466    which means that the per-vnode processing for VNOVNODE and the volume
467    global processing for VMOVED, VNOVOL, etc. has never been performed.
468    As a result, failover to other .readonly volume instances cannot occur,
469    volume moves will not be handled, and files that have been deleted
470    are not detected.
471
472    This patchset makes the following changes:
473
474    1. If an inline bulk operation has been performed and the inline
475       errorCode is a volume global error, then that error replaces
476       the RPC return code within the cm_Analyze() processing for
477       the RPC.  This will affect whether or not a retry operation
478       is performed.
479
480    2. The variable 'inlinebulk' is reset to 0 at the top of the
481       cm_Analyze() loop in case failover from an inlinebulk capable
482       file to an inlinebulk incapable file server takes place.
483
484    3. The FID that is passed into cm_Analyze() is not a real fid.
485       Instead it consists of the cell and volume but vnode = 0.
486       This ensures that the error (if any) is not applied to the
487       directory object.
488
489    4. If an inline bulk operation was performed, prior to performing
490       the cm_MergeStatus() operation a vnode a check is made to
491       determine if an error was returned for that vnode.  If so,
492       cm_Analyze() is called with no connection, a fake cm_req_t,
493       the fid, and the error.  This permits cm_Analyze() processing
494       to be performed on the file.  
495
496  * Show configuration pages for all types of MSI installations
497
498    The OpenAFS MSI installer wizard used to not show any configuration
499    pages for "Typical" and "Complete" installations.  Setting the
500    workstation cell and logon options during installation required
501    selecting the "Custom" option.  Many users choose the "Typical" option
502    during installation, and thus would never see the configuration pages.
503    Therefore, for these users, the workstation cell was being set to the
504    default.
505
506    This patch makes the workstation cell and logon option configuration
507    pages visible to all types of installations (except silent
508    installations which show no UI).
509
510  * cm_LookupInternal creates Freelance mount points and symlinks
511    when queries cannot be found in the Freelance root.afs directory.
512    If the search name is a full cell name for which vldb information
513    can be obtained, then a mount point is added.  If the search name
514    is a left-most substring or the full cell name with a dot appended
515    to it, then a symlink was created.  This approach created a very
516    poluted Freelance name space.
517
518    This patchset makes the following changes:
519
520     1. Do not create symlinks with a dot appended to the cellname
521
522     2. Do not create symlinks where the left-most substring is not
523        a full dot separated component of the cellname.
524
525     3. Permit lookups to succeed when we would have created a
526        symlink in the past without creating the symlink.
527
528  * BPlus tree lookups are much faster than searching through
529    the native directory format on Windows because the case sensitive
530    hash tables cannot be used successfully.  Permit BPlus trees
531    to be used except when called with cm_BPlusDirFoo as the action
532    function because cm_BPlusDirFoo is used to build the BPlus trees
533    from the native directory format.
534
535  * Symlinks are ending up in the Freelance root.afs directory that
536    end with a dot.  Make sure it cannot happen.
537
538  * cm_FreelanceAddMount and cm_FreelanceAddSymlink is supposed to
539    return the allocated FID of the entry that was added.  However,
540    cm_NameI is called to perform the lookup without forcing an update
541    of the Freelance fake directory.  As a result the entry may not be
542    found.
543
544    Force an update prior to calling cm_NameI() by using
545    cm_clearLocalMountPointChange() and cm_reInitLocalMountPoints()
546    if required.
547
548  * The Freelance fake root directory buffers were not zero-filled.
549    This results in random behavior that can cause the service to
550    terminate unexpectedly.
551
552  * The validation check for the response from the GetVolumeStatus
553    pioctl is incorrect.  The response is not simply a VolumeStatus
554    structure but also several C strings appended to it.
555
556  * When flushing a file, we need to commit the file length changes
557    as well as the dirty buffers.  Call cm_FSync instead of buf_CleanVnode
558    which is called by cm_FSync.
559
560  * Prevent rx_rpc_stats global lock from being a bottleneck in the
561    Rx library.
562
563 Since 1.5.73
564
565  * Avoid a race when updating cell vldb server lists
566    that can result in a crash.
567
568  * Avoid a deadlock when managing CM_SCACHESYNC_STOREDATA
569    state operations for directory objects.
570
571  * Add new Windows Application Event log messages for
572    VBUSY, VRESTARTING, ALL_BUSY, ALL_OFFLINE, and ALL_DOWN.
573    Include message throttling to prevent the same message
574    from being logged repeatedly within a five second window.
575
576  * Reduce lock contention by waiting for cm_buf_t I/O
577    operations to complete before permitting cm_SetupStoreBIOD
578    to analyze a buffer for inclusion in a BIOD.
579
580  * Split the cm_buf_t flags field to separate the flags
581    that are protected by the cm_buf_t mutex from those
582    protected by the buf_globalLock.  This eliminates the need
583    to hold both locks everytime the flags field is accessed.
584    Both locks were not held in the past resulting in race
585    conditions that could result in deadlocks.
586
587  * Add "vos setaddrs" command.
588
589  * Rx library lock contention avoidance between rx_NewCall and
590    rx_EndCall.
591
592  * Rx library races due to inconsistent use of rx_connection
593    conn_data_lock to protect the flags field.
594
595  * Rx library inconsistent use of RX_CALL_TQ_WAIT which could
596    result in deadlocks.
597
598  * Rx library must signal transmit queue waiters when flushing.
599    Otherwise, deadlocks can occur.
600
601  * In cm_UpdateVolumeLocation, avoid searching for a ".readonly"
602    volume on a numeric volume name.
603
604  * File buffer allocations whose offsets are beyond server EOF
605    should be locally allocated and zero filled.  The file server
606    should not be issued a FetchData rpc which is guaranteed to
607    fail.
608
609  * Enable integrated logon to work with Windows 7/2008 when
610    user logons are performed with a non-Domain Kerberos principal.
611
612  * Add Protection Error messages to aklog output.
613
614 Since 1.5.72
615
616  * Prevent the Explorer Shell extension from crashing if
617    symlink creation failed.  (126406)
618
619  * A Rx level NAT ping has been implemented.
620    Add NatPingInterval registry value to
621      HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
622    to permit Nat Ping to be enabled.  The default value is 0 seconds.
623
624  * When a re-initialization is taking place, be sure to reset
625    cm_noLocalMountPoints to 0 in case someone deletes the "Freelance"
626    registry key out from underneath the service.
627
628  * Add krb5 error message translation to aklog, afscreds,
629    afslogon.dll, the network identity manager afs provider
630    and translate_et.
631
632  * Mode bits aren't directly exposed by the Win32 API. We were leaving
633    them to default to 0777 when creating new files and directories.
634    This version introduces two configuration parameters;
635    'UnixModeFileDefault' and 'UnixModeDirDefault' which are DWORD
636    registry entries that are used to set the initial mode bits.
637    If the values are set to 0, then the behavior is identical to what we
638    had before.
639
640  * Minidump files are now produced with a timestamp appended
641    to the name.
642
643  * An SMB request debugging monitor has been added.  When activated
644    the monitor will automatically turn on trace logging if any SMB
645    request has required longer than 60 seconds to complete and will
646    then create a minidump every 60 seconds thereafter until the
647    request completes.
648
649 Since 1.5.71
650
651  * Restore use of DNS AFSDB and SRV records by kaserver clients.
652
653 Since 1.5.70
654
655  * Avoid a potential Freelance deadlock during initial execution 
656    of afsd_service.exe if the old ini file data has to be
657    imported.
658
659  * Three rx library corrections.  (1) Idle data connection
660    processing could timeout if the send window filled and
661    took longer than the idle data timeout period for the
662    transmit window to re-open.  (2) The transmit queue
663    could be emptied prematurely.  A required check for the
664    queue being in use was forgotten.  (3) The function that
665    is supposed to implement a wait for the transmit queue
666    to cease being busy failed to wait.
667
668 Since 1.5.69
669  * Restore use of DNS AFSDB and SRV records which were
670    unintentionally disabled in 1.5.69
671
672 Since 1.5.68
673  * Add a context menu to the NetIdMgr AFS Provider 
674    notification icon.
675
676  * Prevent an empty directory Btree from being created and
677    marked as valid if cm_BPlusDirBuildTree fails.
678
679  * cm_BPlusEnumAlloc should not fail if the enumeration
680    contains zero entries.
681
682  * In cm_BPlusXXX functions, return ENOMEM if malloc() fails.
683
684  * Do not leak the cm_scache_t dirlock if cm_BPlusDirBuildTree
685    fails.
686
687  * fs examine should report owner and group ids as signed values.
688
689  * Protect buffers in smb_WriteData from simultaneous writes.
690
691  * Query network interface MTU values from the registry because
692    the IP Helper GetAdapterAddresses() fails to report a manually
693    configured MTU.
694
695  * Improve performance by not dropping and reacquiring the rx_call
696    lock in rx_WriteProc* and rx_ReadProc*.
697
698  * When configuring the rx library, the network interface MTU
699    must be applied to both the maximum send size as well as the
700    maximum receive size as is done when rx_SetMaxMTU is called
701    by the application.
702
703 There was no 1.5.67 release
704
705 Since 1.5.66
706  * Convert afsauthent.dll to use the xdr_alloc and xdr_free
707    routines from afsrpc.dll in place of malloc and free.
708    This permits the two libraries to be built with different
709    C runtime libraries without crashing.
710
711  * Set the DOS Readonly attribute on a file/directory 
712    whenever the unix mode combined with the mask 0200 
713    is true.  Previously there was a discrepency between
714    the mask used for testing for readonly behavior and
715    that used for setting the attribute.
716
717  * Disable AFSVolSync based .readonly "whole-volume callback"
718    support because the all file servers prior to 1.5.67
719    (and perhaps 1.4.12) do not properly assign a value to
720    the AFSVolSync structure in bulk status RPC responses.
721
722  * Improve the error output from aklog to output the value
723    from krb5 error_message() if the afs_com_err output
724    indicates an unknown value.
725
726  * Hold a lock on the cm_scache_t object when the smb
727    server is assigning a new clientModTime value.
728
729  * Permit custom build version numbers to be set
730    without modifying the src/config/NTMakefile.<platform>
731    files.
732
733  * Add support for binary code signing with cross-signed
734    certificates and arbitrary versions of signtool.exe.
735
736  * Convert VBUSY and VRESTARTING to CM_ERROR_ALLBUSY and
737    do not permit them to be exposed to the smb redirector.
738
739  * Convert STATUS_TIMEOUT responses to STATUS_IO_TIMEOUT
740    to avoid confusion within the smb redirector.
741
742  * Fix the byte order assigned to port numbers associated
743    with AFSDB record lookups.  They must be network byte 
744    order not host byte order.
745
746  * Add dynamic server ranking based on RPC round trip
747    time measurements.
748
749 Since 1.5.65
750  * Official support for Windows 7 and Server 2008 R2
751
752  * Improved Rx RTT computation following the lessons
753    learned by TCP.
754
755  * Prevent a file server bug (FetchData returning an
756    invalid length instead of zero) from causing an
757    "unexpected network error" when writing to files.
758
759  * Promote DNS SRV records as superior to DNS AFSDB
760    records.  Support arbitrary port numbers for vldb
761    servers.
762
763  * Add "fs listacl -cmd" support.
764
765  * Add AFSVolSync based .readonly "whole-volume callback"
766    support.  With this functionality, multiple objects from
767    a .readonly volume can have their status validated by
768    issuing a single RXAFS_FetchStatus RPC.
769
770  * Remove drive mapping functionality and service start/stop
771    from afscreds.exe.
772
773  * Remove drive mapping functionality from afs_config.exe.
774
775  * Adjust SMB error return codes to avoid returning 
776    STATUS_TIMEOUT which results in the SMB redirector
777    disconnecting.
778
779  * Network Identity Manager OpenAFS Provider now provides its
780    own "AFS lock" notification icon to report the status of
781    "have tokens, have no tokens, service not started, service
782    started but inaccessible".  Hovering over the icon lists the
783    cells for which tokens exist (if any) and the OpenAFS version
784    number.  Double-clicking executes the Network Identity Manager
785    default action.
786
787  * When merging the current status for an AFS object, ensure
788    that the volume status for that object is set to 'vl_online'.
789
790  * Permit cm_Analyze to request a retry even when the cm_req_t is
791    flagged CM_REQ_NORETRY if the RPC failed due to RX_CALL_DEAD.
792    The retry will force the use of a new connection.
793
794  * Add digital signatures to resource only dlls as required by
795    Windows 7.
796
797  * Prevent pioctl calls from retrying indefinitely when a sharing
798    violation error occurs.
799
800  * Add {HKLM,HKCU}\SOFTWARE\OpenAFS\Client  DWORD  "ShowMountTab"
801    to restore access to drive mapping functionality in afscreds.exe
802    and afs_config.exe.
803
804  * Permit Rx minimum peer timeout, maximum receive window size and
805    maximum send window size to be configured via the registry.
806
807  * The MSI installer now sets the ARPINSTALLLOCATION as required by
808    Windows 7.
809
810  * DNS lookups set the port numbers in network byte order within
811    the cache manager.
812
813  * Replace use of the 16-bit compatibility API WinExec with
814    ShellExecuteEx in afs_config.exe and afscreds.exe.  WinExec
815    is incompatible with Windows 7 / Server 2008 R2 UAC 
816    functionality.
817
818 Since 1.5.64
819  * Short circuit background volume checks if a shutdown
820    or suspend request is received.
821
822  * Avoid contacting the file server in order to allocate
823    an empty buffer beyond the current length of the file.
824
825  * When a request for streams on a directory or mount 
826    point object is received, do not offer a default stream.
827    This was affecting the saving of roaming profiles.
828
829 Since 1.5.63
830  * Fix Windows 2000 compatibility.  Do not call rand_s() 
831    even if it is compatible with the C run time library
832    version.
833
834  * Fix a data consistency error between the output of 
835    NetWkstaGetInfo and NetServerGetInfo RPCs, specify the Lan 
836    workstation group name "AFS", and report server name as 
837    "AFS" instead of "\\AFS" when the caller asks for "\\AFS".
838
839  * Enable executables to be run from \\AFS on Windows 7.  
840    Return "Name not found" instead of "File not found" when 
841    a directory or file name cannot be found.
842
843  * Prevent cache manager from marking file server "down" when 
844    the data returned in response to either RXAFS_FetchData64 
845    or RXAFS_StoreData64 is invalid.
846
847  * Add pioctl data validation to the AFS Explorer Shell extension.
848
849 Since 1.5.62
850  * After 1.5.62 afslogon.dll would no longer crash but it 
851    also would not load "domain" specific configurations.
852    Fixed.
853
854  * An uninitialized variable was present in the symlink
855    recursion detection loop.
856
857  * Reverse addition of unique per file GUID during 
858    Create/Open responses. Inclusion of the GUID prevents 
859    Cygwin applications (and others) from accessing //afs.
860
861  * Treat "filename::$DATA" as a synonym for "filename".  
862    This addresses the recent report of roaming profiles 
863    failing to save back to the file server.
864
865  * When given a choice between an error from rx_Write() 
866    or RXAFS_EndStoreData(), use the rx_Write() error.  
867    This ensures that over quota and access denied errors 
868    are acted upon.
869
870  * If an error occurs during RXAFS_StoreData operations, 
871    apply that error to all of the buffers in the BIOD. 
872    This ensures that failures will not be retried if they 
873    will only fail again.
874
875  * Do not perform a DNS lookup for a cellname if the 
876    cellname prefix is _._AFS_IOCTL_._.  This will avoid 
877    DNS lookups when the query is for 
878    _._AFS_IOCTL_._.F7E5F580200909010061TTTTNT7TT.{10E39A49-4531-4496-A08E-842D4C440D20}.
879
880  * Fix Freelance root.afs volume object callback processing.  
881    Object synchronization and status merging bugs.
882
883  * Fix Explorer Shell "invalid parameter" bug introduced 
884    in 1.5.62.
885
886  * Log RXKAD errors to the trace log.
887
888  * Prevent simultaneous pioctl calls from multiple processes 
889    from stepping on each other's data.
890
891  * Prevent simultaneous pioctl calls from crashing the 
892    afsd_service.
893
894  * Add data validation to pioctl output processing in 
895    ktc_GetToken and ktc_ListTokens.
896
897  * Add data validation to pioctl output processing in 
898    fs.exe and symlink.exe.
899
900 Since 1.5.61
901  * IMPORTANT: New support for DCE RPC Services: SRVSVC and WKSSVC.
902    No longer will browsing \\AFS produce truncated share names.
903
904  * Registry specified server preferences did not result in
905    the CM_SERVERFLAG_PREF_SET flag being applied to the
906    cm_server_t object.  
907
908  * Avoid unnecessary DNS lookups of share names as cells
909    when it is known that the name cannot be a cell name.
910    Any name that does not contain a dot is skipped.
911
912  * When processing Dfs Referral requests, do not return an
913    error if the server is down or busy; if the volume is
914    offline; the cell vldb cannot be reached; etc.
915    These paths are still \\AFS paths and so the client 
916    should not be sent to search elsewhere for resolution.
917
918  * CRITICAL: Prevent the cm_Daemon thread from terminating when
919    the machine enters the suspend state.  IF the cm_Daemon thread
920    dies, there is nothing to execute down server checks.
921
922  * Prevent use of smb_StartedLock before initialization which
923    can result in a panic in the lock package.
924
925  * Improve error checking in afslogon.dll in order to prevent
926    NULL pointer dereferences within GetLogonDomainOptions()
927    if the Lsa operations fail.
928
929  * Add support to the build system to automatically update
930    a Microsoft Symbol Store.
931
932  * Do not access the cm_conn_t after executing the cm_Analyze
933    loops.  Doing so can result in an access to memory that has
934    been freed.
935
936  * CRITICAL: If a StoreData request offset is not aligned on the 
937    buffer module blockSize, (offset % blockSize) bytes of dirty
938    data will not be written to the file server.
939
940  * CRITICAL: If a StoreData64 request is sent to a file server
941    that does not support large files (>2GB) and the client is 
942    unaware that the server has no large file support, the first 
943    chunksize worth of data will not be written to the file server.
944    This bug was introduced in 1.5.3.   It affects all IBM AFS file
945    servers and all OpenAFS file servers older than 1.4.0.
946
947 Since 1.5.60
948  * If a file server becomes inaccessible while the cache manager has 
949    dirty buffers to write, the afsd_service buf_IncrSync thread can 
950    attempt to use 100% of the cpu.
951
952  * Fix the locking that protects the cm_cell_t lists 
953    (all, name, id, free).
954
955  * Remove cm_cell_t objects from the name and id hash tables before 
956    placing them on the free list.
957
958  * Fix "fs newcell" which was broken in 1.5.60.
959
960  * Do not attempt to synchronize dirty buffers if the associated 
961    volume is known to be unavailable.
962
963  * Log to the Windows Event Log dirty buffers that cannot be written 
964    during the shutdown process.
965
966  * Modify behavior of a Freelance mountpoint target that does not 
967    specify a cell.  Instead of assuming the target volume is in the 
968    Freelance.Local cell, use the workstation "Cell" specified in the 
969    registry. A mountpoint target of "#root.cell." will now mean the 
970    root.cell volume in the workstation cell for the current session.  
971    If the workstation cell changes from "athena.mit.edu" to 
972    "andrew.cmu.edu", the referenced volume will also change without 
973    requiring that the mount point targets be altered.
974
975  * Avoid false infinite loop errors when validating the cm_cell_t 
976    free list during startup.
977
978  * Fix two more locations where xdr_free() should be used instead of 
979    free() to permit a checked built of afsd_service.exe to work with 
980    release builds of afsrpc.dll.
981
982  * Add cm_FindServerByUuid().  Re-implement RXAFS_InitCallBackState3() 
983    to permit the server Uuid to be used to lookup the server object 
984    and from that determine the cell.  This permits callbacks that are 
985    received from alternate addresses to be processed with a known server 
986    object.  Previously a request from an unknown server would clear all 
987    callbacks from all cells.
988
989  * Fix a bug that prevented optimal performance when using a non-zero 
990    value for 'daemonCheckVolCBInterval'.  As a reminder, when 
991    "daemonCheckVolCBInterval" is set to a non-zero value, all .readonly 
992    volume callbacks are automatically renewed 90 minutes before their 
993    expiration.
994
995  * Fix automatic ranking of vldb servers whose values are obtained from 
996    the CellServDB file.
997
998  * Add logging for RX CALL DEAD errors which are generated if the remote 
999    host is unreachable.
1000
1001  * Add failover for RX CALL TIMEOUT errors when the volume is readonly 
1002    or the call is to a vldb server.
1003
1004  * Add registry based cell search functionality to NetIdMgr, 
1005    afs_config.exe, and klog.exe.
1006
1007  * afsconf_GetCellInfo() has been modified to perform gethostbyname() 
1008    lookups on the host names in the CellServDB instead of using the 
1009    specified IP addresses.  This provides aklog, pts, vos, etc. the same 
1010    CellServDB behavior that the Windows Cache Manager uses.
1011
1012  * Completely a behind the scenes change.  The snprintf() routines have 
1013    been completely rewritten.
1014
1015  * When updating the stat cache entry callback of a .readonly object 
1016    from the volume group object, update the file server reference to 
1017    ensure it matches the most update to date callback.
1018
1019  * Add proper support for processing callbacks from multi-homed file 
1020    servers.  Instead of comparing servers by cm_server_t pointer, 
1021    compare them by UUID when the UUID is known.
1022
1023  * During a shutdown short circuit the offline volume check daemon 
1024    functionality.
1025
1026  * Properly track link counts during cm_Link and cm_Unlink operations.
1027
1028  * Return the error code of RXAFS_FetchData / RXAFS_StoreData in 
1029    preference to an error code reported by rx_EndCall.
1030
1031  * Add "PerFileAccessCheck" registry value to permit testing against 
1032    experimental file servers that include per-file acl support.  This 
1033    value is intentionally undocumented.  It is not to be used by
1034    production environment deployments.
1035
1036  * Log a warning to trace log if a volume group is marked as a DFS 
1037    File Set.  The Windows OpenAFS client does not include DFS support.
1038
1039  * Fix a bug introduced in 1.5.60 that prevents the afs netidmgr 
1040    provider from obtaining tokens when referrals are in play.
1041
1042  * Add "fs chown" and "fs chgrp" commands to permit the owner and 
1043    group of objects stored in AFS to be set from Windows.
1044
1045  * Avoid performing background daemon operations when the machine is 
1046    going into suspend mode.
1047
1048  * Perform offline volume checks in most recently used order.
1049
1050  * Prevent crash when a data version for a cache object goes backwards.
1051
1052  * fs setquota, fs setcachesize, vos setfields, and vos create now 
1053    accept human readable orders of magnitude. (K, M, G)
1054
1055  * fs listquota fixed to permit large quota sizes to be displayed.
1056
1057  * rx packet resend and data packets sent counts were incorrect.
1058
1059  * Multi-thread safe library versions are now being generated and used.  
1060    mtafsubik.lib, mtafsutil.lib, mtafsvldb.lib, mtafsvol.lib.
1061
1062  * Microsoft SMB Redirector (mrxsmb.sys) support for ExtendedSessTimeout
1063    values are now available on XP through Windows 7.  Add functionality
1064    to autodetect if such support is present on the machine.  If so,
1065    configure it if necessary and dynamically adjust the AFS Rx timeout
1066    values accordingly.
1067
1068  * Correct another race condition in the Rx library that could result
1069    in an unexpected panic while freeing the Rx call iovq.
1070
1071 Since 1.5.59
1072  * A fix to the pioctl library to support drive substitution 
1073    to UNC paths.  (SUBST <d:> <\\afs\cell\path>).
1074
1075  * On April 9th Microsoft released a Hot Fix for Windows Server 2003 SP2 
1076    that corrects a deadlock in the smb redirector and also adds new 
1077    functionality that permits the AFS SMB server to be given a longer 
1078    timeout than is normally the case.  New functionality has been added 
1079    to configure these additional LanmanWorkstation\Parameter values.
1080    (This functionality has been backported to XP SP3 and is scheduled
1081    to be released on June 5th.)
1082    
1083  * The BackConnectionHostNames registry value configuration was broken 
1084    when dynamic re-establishment of Netbios Name registrations was added.
1085    Restore it.
1086
1087  * Hidden vos commands are revealed.
1088
1089  * If the "DisableLoopbackCheck" registry value is set, do not unset 
1090    it during the same service session.
1091
1092  * Reorganize code that prevents multiple Store operations to the same 
1093    File.
1094
1095  * Modify IsPathInAfs test in Explorer Shell Extension and fs.exe to 
1096    permit broken symlinks to be treated as being in AFS.
1097
1098  * Fix vos commands that output 64-bit integer values.
1099
1100  * Cygwin Import Libraries are provided in the SDK for all OpenAFS DLLs.
1101    Permits building cygwin applications against OpenAFS libraries. 
1102
1103  * OpenAFS Release Notes, Administrator Guide and User Guide now installed 
1104    as Windows HTML Help (.CHM) files.  
1105
1106  * NSIS installer does a much better job of cleaning up files left 
1107    over from previous installs.
1108
1109  * Fix RT#124787, a race condition between "fs flush <dir>", "fs flushvolume", 
1110    or "fs flushall" and on-going directory operations that can result in 
1111    afsd_service.exe crashing.
1112
1113  * Add support for DNS SRV records in place of AFSDB records.  
1114    _afs3-vlserver._udp.<cellname>.  Priority field is used.  
1115    Weight is currently ignored.
1116
1117  * Add a method of specifying Client CellServDB information within the 
1118    registry that can be used to either override the CellServDB file or 
1119    force the use of DNS lookups for a given cell.
1120
1121    The registry schema is as follows:
1122
1123      HKLM\SOFTWARE\OpenAFS\{Client,Server}\CellServDB\[cellname]\
1124        "LinkedCell" REG_SZ "[cellname]"
1125        "Description" REG_SZ "[comment]"
1126        "ForceDNS" DWORD {0,1}
1127
1128      HKLM\SOFTWARE\OpenAFS\{Client,Server}\CellServDB\[cellname]\[servername]\
1129        "HostName" REG_SZ "[hostname]"  Default: [servername]
1130        "IPv4Address" REG_SZ "[address]"  Used only if gethostbyname() fails.
1131        "IPv6Address" REG_SZ "[address]" <future>
1132        "Comment" REG_SZ "[comment]"
1133        "Rank" DWORD "0..65535"  Default: 0
1134        "Clone" DWORD "{0,1}" <future: server only>
1135        "vlserver" DWORD "7003" <future>
1136        "ptserver" DWORD ... <future>
1137
1138    ForceDNS is implied non-zero if there are no [servername]
1139    keys under the [cellname] key. Otherwise, ForceDNS is zero.
1140    If [servername] keys are specified and none of them evaluate
1141    to a valid server configuration, the return code is success.
1142    This prevents failover to the CellServDB file or DNS.
1143    
1144    Only one of "HostName" or "IPv4Address" is required.  "HostName"
1145    is optional if [servername] is the host name.
1146
1147  * Extend registry based CellServDB functionality to 
1148    afsconf_GetCellInfo() interface used by aklog and many 
1149    other command line utilities.
1150
1151  * libafsconf.dll moved from OpenAFS\Client\Program to OpenAFS\Common
1152    as it is now used by both client and server components.
1153
1154 Since 1.5.58
1155  * PriorityClass of afsd_service.exe process raised to 
1156    "High" to match the priority of the system services 
1157    that are waiting for afsd_service.exe to respond.
1158    Configurable using [TransarcAFSDaemon\Parameters]
1159    DWORD "PriorityClass" value.  (use values from Win32
1160    API)
1161
1162  * Change error reporting of CM_ERROR_BADSHARENAME to
1163    use the correct error (NTSTATUS_BAD_NETWORK_PATH).
1164    The error we were sending would cause the smb 
1165    redirector to drop the connection.
1166
1167  * Change the error reporting of CM_ERROR_ALLOFFLINE
1168    and CM_ERROR_ALLDOWN to return NTSTATUS_PATH_NOT_FOUND.
1169    Previous we would return Bad Network Path which 
1170    would cause the smb redirector to cancel all file
1171    handles on the same "share".
1172
1173  * A debug version of afsd_service.exe can now be used
1174    with a release version of afsrpc.dll (or vice versa).
1175    afsrpc.dll now implements and exports xdr_free().
1176
1177  * Removed all unprotected OutputDebugString() calls as
1178    those calls can block for up to 10 seconds if there 
1179    is contention for the globally shared memory or if
1180    the debugger fails to read data in a timely manner.
1181
1182  * Visual Studio 2008, WDK 6.1 and DDK 6.1 are now 
1183    supported for builds.  The production releases still
1184    use VS 2005.
1185
1186 Since 1.5.57
1187  * Discovered that XP/2003 supports a variant on recvmsg 
1188    called WSARecvMsg.  The input parameters are mostly 
1189    compatible with the Posix recvmsg.  This will save 
1190    multiple memcpy() calls per received packet.
1191
1192  * Discovered that Vista/2008 supports a variant on 
1193    sendmsg called WSASendMsg.  The input parameters 
1194    are mostly compatible with the Posix sendmsg.  This 
1195    will save multiple memcpy() calls per sent packet.
1196
1197  * Exporting rx_ReadProc32, rx_WriteProc32 from afsrpc.dll 
1198    and utilizing rx_ReadProc32 from within the cache manager 
1199    as part of the FetchData operations.  rx_ReadProc32 and 
1200    rx_WriteProc32 are optimized versions of rx_ReadProc and 
1201    rx_WriteProc for use when reading 32-bit integer values.
1202
1203  * The Network Identity Manager AFS provider now reports 
1204    progress events.  These provide a better user experience 
1205    with Network Identity Manager 2.0.
1206
1207  * [RT 124293] A race condition exists which permits the 
1208    scp field of the an smb_fid_t object to become invalid 
1209    after a request on the smb_fid_t has begun.  Remove the 
1210    race by protecting all access to the scp field with the 
1211    smb_fid_t mx mutex and obtaining a local reference on 
1212    the cm_scache_t object for the length of the request.
1213
1214  * [RT 124276] If the vldb is out of sync with the contents 
1215    of the file servers, afsd_service will retry too many 
1216    times when a file server reports a volume as not being 
1217    present.  Now if the list reported by the vldb is the 
1218    same as the previously seen list, then the retry is 
1219    aborted.
1220
1221  * [RT 124276] Read-only volume failover was broken in 
1222    1.5.53 whenever accessing a volume results in VNOVOL or 
1223    VMOVED.
1224
1225  * [RT 124276] Prior to 1.3.70 the volume server reference 
1226    list was not reference counted and would be prematurely 
1227    freed while in use.  When reference counting was added 
1228    in 1.3.70 a bug was introduced that could result in 
1229    service reference list corruption.
1230
1231  * Add Windows Application Event Log warning messages for 
1232    "Client SMB MPX value too large" and 
1233    "Client SMB Buffer Size too small".
1234
1235  * Renaming of files across directory boundaries would result 
1236    in an invalid handle error when attempting to access the 
1237    files after the move.
1238
1239  * Fix the handling of Tran2 Set Path Info RPCs.  Do not fail 
1240    when a smb file descriptor cannot be found.  The whole point 
1241    of using a Path Info function is because an smb file 
1242    descriptor wasn't allocated.
1243
1244  * More edge cases in which dynamic addition of Freelance 
1245    root.afs entries would get the wrong FID or where the 
1246    root.afs directory would not be refreshed.
1247
1248  * Buffer overflow could occur if the workstation cell name was 
1249    longer than 64 characters.  Crashes could occur in 
1250    afscreds.exe, afslogon.dll, and afsd_service.exe.
1251
1252  * VNOSERVICE and VOFFLINE errors were leaking and were exposed 
1253    to the smb client.
1254
1255  * Improve consistency of the bad data version value used for 
1256    cm_scache fields.
1257
1258  * Log file server uuid values as part of the cm_server object 
1259    when available.  Dump the cm_server object list in response 
1260    to "fs memdump".
1261
1262  * Optimize the performance of resetting access control lists 
1263    when tokens are set or removed.
1264
1265  * Fix vos.exe so that it can work with very large volume 
1266    identifiers
1267
1268  * Remove symlink recursion tests and increase max symlink count 
1269    to 64 from 16.
1270
1271 Since 1.5.56
1272  * Undo the "UAC manifest fix" applied to afs_config.exe.
1273
1274  * Fixed some additional race conditions in the Rx library
1275
1276  * Ensure that Freelance allocation of vnodes follow 
1277    the AFS convention of odd vnodes are directories 
1278    and everything else is an even vnode.
1279
1280  * Add Freelance logic to mount point and symlink 
1281    evaluation functions.
1282
1283  * Enhance smb_ParseASCIIBlock() so that it can handle
1284    all of the STRING formats defined by the CIFS Technical
1285    Report 1.0.  
1286
1287  * Validate the output of smb_ParseASCIIBlock() in all
1288    callers.  Return CM_ERROR_BADSMB if the STRING field
1289    cannot be parsed.  CM_ERROR_BADSMB will cause the
1290    contents of the packet to be logged.
1291
1292  * If multiple SMB Raw Write operations were taking 
1293    place at the same time, there could be data corruption
1294    because unique event objects were not generated for 
1295    each Netbios receive operation.
1296
1297 Since 1.5.55
1298
1299  * Fix a race in rxi_WriteProc which could result
1300    in a freed or in use packet being passed to 
1301    rxi_PrepareSendPacket if the call is currently
1302    in a transmit wait state.  Passing a freed packet
1303    will result in a panic.  Passing an in use packet
1304    might result in a call failure or perhaps data
1305    corruption.
1306
1307  * Kerberos referrals broke the NIM AFS provider 
1308    logic for automated configuration of the workstation
1309    cell with a new identity.  Now if a referrals 
1310    response is returned, assume the cell belongs to the
1311    new identify.
1312
1313  * The interface to buf_CleanAsync() and 
1314    buf_CleanAsyncLocked() has been changed to permit 
1315    errors to be propagated to the caller.  
1316
1317  * During an enumeration of a directory, if the btree
1318    has not yet been generated, return an error.
1319
1320  * When mapping CM_ERROR values to NTSTATUS values
1321    do not treat 0 as an error.
1322
1323  * Avoid a cm_scache_t object reference count underflow
1324    when renaming via the SMB interface.
1325
1326  * smb_IsMask() can be called with a non-8.3 input buffer.
1327    Separate smb_IsMask() into smb_Is8Dot3Mask() for 8.3
1328    input buffers and smb_IsMask() for non-8.3 input buffers.
1329
1330  * Add cm_buf_t error state to the "fs memdump" output.
1331
1332  * pioctl drive mapping checks need to take into account
1333    Global Drive Mappings and SUBST assignments.
1334
1335  * Rename operations should not be permitted if the 
1336    destination name collides with an existing name that
1337    differs only by case UNLESS the collision is the object
1338    that is being renamed.
1339
1340  * Increase the maximum number of background daemon threads
1341    to 64.  Leave the default at 4.
1342
1343  * Set the FILE_UNICODE_ON_DISK flag when reporting the 
1344    file system characteristics.
1345
1346  * Report the maximum component name length as 255 even
1347    for Unicode as part of the file system characteristics.
1348
1349  * Add RX debugging information to "fs memdump" output
1350    in checked builds.
1351
1352  * Refcount the cm_server_t objects returned by
1353    cm_FindServerByIP()
1354
1355  * Fix the UAC manifest applied to afs_config.exe
1356
1357  * rxdebug now indicates if any RX_CONN flag is set
1358    not just some of them
1359
1360  * Change the mapping of CM_ERROR_WOULDBLOCK from 
1361    NTSTATUS_LOCK_NOT_GRANTED to NTSTATUS_CANT_WAIT
1362
1363 Since 1.5.54
1364
1365  * Includes #GCO Public CellServDB 07 Nov 2008
1366
1367  * Prevent separate cell entries from being created for
1368    "foobar.org" and "foobar.org." which can happen if
1369    an AFSDB record is found instead of a CellServDB 
1370    record.
1371
1372  * Fix a panic when checking the SMB virtual circuit list.  
1373    If a VC is destroyed while the list is being checked 
1374    it is possible for the next object to become invalid.
1375
1376  * Increased logging to afsd_init.log of netbios name 
1377    related errors.
1378
1379  * Fix a DNLC panic when a UTF-16 string that cannot be 
1380    converted to a utf-8 string is provided as a filename.
1381
1382  * In the NSIS installer, delete old afslogon.dll/afscpcc.exe 
1383    from %windir%\system32 and fix the WinLogon\Notify\AfsLogon 
1384    location to refer directly to the new location in 
1385    %programfiles%\openafs\client\program
1386
1387  * Be more aggressive about responding to Netbios 
1388    NRC_BRIDGE/NRC_NOWILD errors.  Rebind the Netbios name to 
1389    the LANA within the listener thread without performing a 
1390    delete and reset.
1391
1392  * Use the WNet Enumeration of all connected drives as a filter 
1393    in the pioctl GetIoctlHandle operation.  This should remove 
1394    the last situations in which there was a delay when opening 
1395    an Explorer Shell properties menu with the AFS Shell 
1396    Extension.
1397
1398  * Fix the parsing of CellServDB in Windows to handle linked 
1399    cells as is done on Unix.
1400
1401  * Add support for linked cells to the cache manager,
1402    netidmgr afs provider, and aklog.  When two cells are
1403    linked, a volume lookup that fails in one cell is looked
1404    up in the other.  This can be used for construction of 
1405    test cells that override specific volumes; cell renaming;
1406    and cell splitting.
1407
1408  * Increase the length of cell and realm names that can 
1409    be entered in the NIM AFS provider.
1410
1411  * Actively prevent a 32-bit afsd_service.exe from 
1412    executing in the WOW64 environment.
1413
1414  * Protect against invalid IP address values in CellServDB
1415    parsing.
1416
1417 Since 1.5.53
1418
1419  * Fix an Rx panic caused by an attempt to double free
1420    an rx_packet when an error occurs while writing the
1421    packet.
1422
1423  * Fix an exception cause by a race condition when 
1424    processing multiple file change notifications registered
1425    by the Explorer Shell or other applications.
1426
1427  * Modify the Rx debug interface to use var_args and 
1428    permit Rx debugging to be used on 64-bit Windows 
1429    which previously had it disabled.
1430
1431 Since 1.5.52
1432
1433  * Automated lock hierarchy enforcement added to the
1434    osi base lock package.  This permits detection of lock
1435    violations that might but often does not result in 
1436    deadlocks.  Enabled by default in the checked builds.
1437    May be activated in release builds via the registry
1438    value "LockOrderValidation" in the TransarcAFSDaemon
1439    Parameters key.
1440
1441    When a violation is detection an assertion is thrown
1442    generating a dump file and a message indicating which
1443    locks were obtained out of order is logged to the 
1444    Windows Application Event Log.
1445
1446  * Attempt to ensure that a dump file will be generated
1447    whenever the service panics.
1448
1449  * Removed unused lock cm_bufGetMutex
1450
1451  * Many out of order lock acquisitions were detected
1452    using the lock order verifier and were corrected.
1453
1454  * A race condition within the function path cm_GetSCache() ->
1455    cm_GetNewSCache() -> cm_RecycleSCache() permitted a 
1456    cm_scache_t object to be issued simultaneously to two 
1457    threads.   This would eventually result in a panic due 
1458    to the resulting undercount.
1459
1460  * Fix interpretation of the empty string as the ioctl path
1461    to mean the current directory.  "fs lsm", "symlink list", 
1462    etc. now return a "not a ..." error instead of "does not
1463    exist".
1464
1465  * Add SMB_STRF_SRCNULTERM flag to smb_ParseStringXXX functions.
1466    to indicate that the input string is a nul terminated string.
1467    Assign ti when input strings are nul terminated instead of 
1468    length counted. (from 1.5.50)
1469
1470  * The CIFS protocol specification for handling NT_TRANSACT_CREATE
1471    does not match the observed behavor.  The 'nameLength' is specified
1472    in bytes, not in characters.  Fix the implementation to match
1473    the observed behavior. (1.5.50)
1474
1475  * The cm_HaveAccessRights() attempt at deadlock avoidance by 
1476    calling lock_TryRead() on the parent directory cm_scache_t rw-lock
1477    does not avoid the deadlock.  Avoid the deadlock by enforcing the
1478    lock order of the lowest vnode first.  Then remove the infinite 
1479    loop avoidance in cm_SyncOp() that was returning an unwarranted
1480    access denied error.
1481
1482  * File Server lock synchronization was not propertly enforced in 
1483    smb_ReceiveNTCreateX() and smb_ReceiveNTTranCreate().
1484
1485  * Another change to the short name generator.  Plus and equal are 
1486    not valid characters in a short name according to the 
1487    RtlIsNameLegalDOS8Dot3() in kernel mode.  They have been replaced
1488    with left and right brace in order to minimize the impact.
1489
1490  * Fix a race condition that can result in a heap overwrite error if
1491    the number of known file servers or vldb servers increases during
1492    the preparation phase of a cm_CheckServers() operation.
1493
1494  * If the SMB Authentication would fail, a LSA allocated memory 
1495    buffer would be leaked.
1496
1497  * Rewrite the cm_cell_t allocation code to permit cell vldb server
1498    lookups to fail without leaking cm_cell_t objects.
1499
1500  * Add "fs setcrypt auth" to permit the use of rxkad authentication
1501    only mode.  Not documented.
1502
1503  * Initialize Rx mutex and lock objects once and only once as part of
1504    the DLL load process.
1505
1506  * When reporting the Volume Name "AFS" do not include the terminating
1507    NUL in the reported length.  
1508  
1509  * Refresh Volume Location information upon receipt of a VNOVOL error
1510    from the file server and avoid a race condition that prevented the
1511    updated volume location information from being destroyed immediately
1512    after it was acquired.
1513
1514  * In response to VNOVOL and VMOVED, remove the volume id from the server's
1515    volume list so that the volume's up and down status is not affected 
1516    when the machine is shutdown.
1517
1518  * Many fixes to the Rx stack related to packet allocation and deallocation;
1519    Rx debugging; Rx packet tracking across queues; and Rx packet loss caused
1520    by overwriting the rx_call currentPacket pointer when it was already 
1521    referring to a packet.  
1522
1523  * Rx Jumbograms are now off by default.  To re-enable, add "RxJumbo" = "1"
1524    in the TransarcAFSDeamon/Parameters key.
1525
1526  * "fs flush", "fs flushvolume", and "fs flushall" now destroy locally 
1527    constructed directory B+ trees for flushed directory objects.
1528
1529  * When cached pages for directory objects have been locally modified, do
1530    not permit the locally modified pages to be mixed with pages subsequently
1531    obtained from the file server.  Doing so can result in directory 
1532    corruption.
1533
1534  * If Ubix errors are received in response to VL_xxx operations record
1535    the error on the server instance and permit the operation request to 
1536    be retried in case another server is able to answer the query.  We have
1537    seen at least one instance of a cell in which a VL server returned 
1538    UNOQUORUM (possible database truncation) when the other servers were
1539    responding successfully.
1540
1541 Since 1.5.51
1542  * Optimize the assignment of write errors to dirty 
1543    buffers by applying the first error to all buffers 
1544    belonging to the same object instead of trying each 
1545    buffer in turn.
1546
1547  * Add resource version info to xstat_fs_test and xstat_cm_test
1548  
1549  * Fix a delete vs delete[] usage problem in the WiX custom 
1550    handler dll
1551  
1552  * When creating a mount point, validate the volume name to 
1553    make sure it exists.
1554
1555  * When processing a mount point, pay attention to VL_BADNAME 
1556    errors.
1557
1558  * Remove a race condition from cm_volume_t recycling that could 
1559    have resulted in two threads making use of the same object at 
1560    the same time.
1561
1562  * Fix a reference count leak on smb_vc_t objects introduced in 
1563    1.5.50.  Permit the objects to be freed once again.
1564
1565  * Fix the output of "fs memdump" for smb_vc_t objects that was 
1566    broken in 1.5.50.
1567
1568  * Add routines for debugging smb refcount errors.
1569
1570  * When shutting down the cache manager, do not permit AFS 
1571    callback requests to be processed. Doing so can result in 
1572    invalid memory accesses.
1573
1574  * Do not recycle a deleted cm_scache_t object unless the 
1575    refCount is 0.  Doing so can result in a deadlock and 
1576    invalid memory access.
1577
1578  * Minimize the number of RPCs sent to the file server for 
1579    directory bulk status requests. Only request status for 
1580    objects that we are actually reporting on and only if we 
1581    do not already have status for the object and then make 
1582    sure that we return as much as we can at once via the SMB 
1583    interface but not so much that it exceeds the RDR timeout
1584
1585  * Enable bos restricted operations
1586
1587  * Fix the creation of submounts used by the afscreds and afs_config 
1588    drive mapping tabs.
1589  
1590  * Avoid repeated retries when attempting to obtain access rights.  
1591    If the access rights were obtained successfully but do not 
1592    satisfy the request, fail the request.
1593
1594  * Fix error code reported when attempting delete a file on a 
1595    readonly volume or one that is marked with the readonly DOS 
1596    attribute.
1597
1598  * Fix a short name truncation bug.
1599
1600  * Fix a heap corruption error when reading the CellServDB file 
1601    location.
1602
1603  * Fix directory listings when the directory has "lookup" permission 
1604    only and the directory has never been previously accessed.
1605
1606  * Fix several tracking issues for cm_scache_t rw locks.
1607
1608  * Ensure that all buffers used to store cell names are the
1609    correct length.
1610
1611  * Restore Windows 2000 support (broken in 1.5.50).   
1612    LOCALE_INVARIANT was introduced in XP.
1613
1614  * Add RxUdpBufSize registry value.  Default is 256K.
1615
1616  * Avoid multiple deadlocks between cm_freelanceLock and cm_scacheLock
1617
1618  * Do not include trailing NULs when returning file names in 
1619    a directory search response.
1620
1621  * Prevent RX from crashing the afsd_service by attempting
1622    to allocate to many buffers at once when memory is fragmented.
1623
1624  * Avoid a deadlock when freeing cm_server_t objects
1625
1626  * Optimize search cell file.  Do not search to end of file
1627    if the cell has already been found.
1628
1629  * Remove explorer shell extension delay on local disks.
1630
1631  * Automatically pre-allocate 64 Rx packets per thread
1632
1633  * Add smb lock requests and stat cache lock allocations to
1634    the output from fs memdump.
1635
1636 Since 1.5.50
1637  * Fix Large File Support (broken in 1.5.50)
1638
1639  * Fix "fs setacl" (broken in 1.5.50)
1640
1641  * Fix pioctl path evaluation of drive letter
1642    mapped paths. (broken in 1.5.50)
1643
1644  * Fix installation of VC8 Runtime library in the EXE
1645    Retail installer. (broken in 1.5.50)
1646
1647  * Avoid a potential deadlock during Volume Location 
1648    updates if all the file servers are unreachable at 
1649    the time the VL update succeeds.
1650
1651  * Ensure that rx connection object is references 
1652    during VL RPCs.
1653
1654  * Fix propagation of over quota errors during cm_FSync()
1655    calls.
1656
1657 Since 1.5.39 [1.5.50 released 16 July 2008]
1658  * There were no releases between 1.5.39 and 1.5.50.
1659
1660  * FIRST RELEASE WITH UNICODE SUPPORT
1661
1662  * Pioctl interfaces to the cache manager refactored
1663    to provide layering between the SMB specific code
1664    and the general purpose ioctl operation.
1665
1666  * Garbage collect dead SMB virtual circuits as soon
1667    as they are no longer being referenced.  This avoids
1668    problems with outstanding locks not being dropped
1669    when the virtual circuit becomes invalid.
1670
1671  * Remove the IBM Administration Reference documentation
1672    and replace it with the OpenAFS Command Reference 
1673    Manual.  
1674
1675  * Avoid calling rx_SetDeadTime and rx_SetHardDeadTime
1676    functions each time a connection is about to be used.
1677    Do not hold a lock on the rx connection object while
1678    it is being selected.  This avoids a race between 
1679    threads attempting to set the timeout values and 
1680    removes a bottleneck that was hampering performance.
1681
1682  * Ensure that the smb directory attribute is set 
1683    for all directory objects.
1684
1685  * Add vs2008 support to the NSIS installer scripts
1686
1687  * Replace the VC Runtime EXE installer with the MSI
1688    installer in the NSIS installer scripts
1689
1690  * Properly delete the VC7.1 C Runtime libraries.   
1691
1692 Since 1.5.36 [1.5.39 released 23 June 2008]
1693  * There were no 1.5.37 or 1.5.38 releases for Windows
1694
1695  * Use Visual Studio version of vsprintf() instead of 
1696    home grown version that resulted in linking conflicts
1697
1698  * Prevent buserver, ptserver and fileserver from crashing
1699    due to non-portable strftime() format strings.
1700
1701  * Prevent server crashes caused by rx_InitMorePackets()
1702    being called prior to allocation of all of the required
1703    synchronization objects.
1704
1705  * Fixed a memory leak in the internal B+ tree directory.
1706    For objects with non-8.3 names, the 'longname' memory
1707    allocation would be leaked during object deletion or
1708    tree destruction.
1709
1710  * Fixed a memory leak in the background daemon cm_CheckServer() 
1711    routine.  The memory allocated to store the server list
1712    was not freed.  
1713
1714  * Obtain a missing lock around a call to cm_RemoveSCacheFromHashTable(). 
1715
1716  * Correct an abstraction layer violation. cm_scache_t objects 
1717    should be marked deleted in cm_Unlink() and cm_RemoveDir() and not 
1718    in smb_CloseFID(). Cleanup of deleted cm_scache_t objects should be 
1719    performed in cm_ReleaseSCache() when the reference count hits zero. 
1720
1721  * Prototype cm_AdjustScacheLRU() and re-implement it using osi_QAddH().
1722
1723  * Do not reference 'smb_logp' in cm_vnodeops.c.  Use 'afsd_logp'
1724    instead.
1725
1726  * Ensure that scache object 'nextp' pointers are set to NULL
1727    when the objects are removed from the hash table linked list.
1728
1729  * If a dirty buffer cannot be written to the file server because
1730    of an access denied error, mark the error in the cm_buf_t
1731    structure so that it can be dealt with instead of retrying 
1732    forever.
1733
1734 Since 1.5.35
1735  * Update CellServDB file to GCO Public 23 Apr 2008
1736
1737  * Fix a cm_buf_t reference count leak when attempts to write 
1738    dirty buffers to the file server from within cm_IncrSyncer() 
1739    fail.
1740
1741  * Prevent udebug from crashing.
1742
1743  * Activate RX Idle Timeouts.  If the file server is busy for more 
1744    then 30 seconds, attempt to failover to another server without 
1745    marking the busy server down.
1746
1747  * Another VNOVNODE issue fixed.  When writing a dirty buffer
1748    to the file server, if VNOVNODE is received, mark all buffers
1749    as invalid without further attempts to contact the file server.
1750    
1751  * Improved performance on high latency links.
1752
1753 Since 1.5.34
1754  * Fix a bug preventing the re-initialization of the Freelance 
1755    root.cell contents when a change is made.
1756
1757  * Properly return CM_ERROR_NOSUCHFILE when removing a symlink 
1758    or mountpoint that does not exist.
1759
1760  * aklog, afscreds, integrated logon, and the NIM AFS credential 
1761    provider will all attempt to first acquire an afs service ticket 
1762    using the service principal: afs/<cell>@<CLIENT_REALM>.  This 
1763    permits the proper detection of the cell realm when multiple 
1764    realms are local realms for the cell.
1765
1766  * Fix fs commands that re-use file identifiers instead of forcing 
1767    a path evaluation each time.  This was broken in 1.5.33 when 
1768    hashes were added to the cm_fid_t structure.
1769
1770  * Fix symlink and mountpoint removal and then recreation when 
1771    applied to the fake Freelance root.afs volume.
1772
1773  * Fix SMB change notifications for the Freelance root.afs volume 
1774    when creating or removing symlinks and mount points.
1775
1776  * Force DNS AFSDB cell name lookups to lower case if the DNS 
1777    response is not all lower case.
1778
1779  * 32-bit installers are now built with Visual Studio 2005
1780
1781  * All vos.exe commands now support the "-noresolve" option which 
1782    forces the display of IP addresses instead of DNS hostnames.
1783
1784  * No longer hold the cm_volume_t mutex across VL_xxx RPCs.  This 
1785    permits operations that do not require up to date volume 
1786    location data to continue while waiting for the RPC to complete.  
1787    Multiple threads waiting for a volume location update on the 
1788    same volume set no longer trigger multiple calls VL_xxx RPCs.
1789
1790  * Volume server references could be marked offline and never 
1791    reset to the not_busy state.  
1792
1793  * Further optimizations to cm_Analyze() retry logic for 
1794    CM_ERROR_OFFLINE and CM_ERROR_ALLBUSY error handling.
1795
1796 Since 1.5.33
1797  * Optimize the DNLC by applying Interlocked incrementing for 
1798    statistics gathering and enabling greater use of read 
1799    locks instead of write locks
1800
1801  * Further optimize osi_Log operations when logging is disabled 
1802    by removing the need for the function call overhead.
1803
1804  * Add a new lock operation, Convert Read to Write, and apply 
1805    it throughout the cache manager.  This function provides a 
1806    fast transition from a read lock to a write lock when the 
1807    caller is the only reader.
1808
1809  * Fix a timeout problem when opening files or request locks 
1810    when the file in question is already write-locked by another 
1811    machine.
1812
1813  * Fix a deadlock that can occur if "fs flushall" is executed 
1814    while applications are writing to AFS.
1815
1816  * The cache manager would re-read data from the file server 
1817    after file truncation when obtaining buffers to write to the
1818    same file until the first StoreData RPC completes.
1819
1820  * Fixes error handling in cm_NTCheckDelete()
1821
1822  * Replaces cm_scache_t mutex with a read-write lock permitting 
1823    additional parallel access.
1824
1825  * Prevent an cm_scache_t reference undercount when evaluating 
1826    symlinks containing @sys when none of the active sysnames 
1827    match any of the available targets.
1828
1829  * Prevent the leak of a cm_scache_t rwlock if associated symlink 
1830    is too long.
1831
1832  * Set RxMaxMTU registry value to 0 which is the equivalent of 
1833    it not being set at all.
1834
1835  * Reduce contention between BkgDaemon threads
1836
1837  * Prevent CM_SCACHEFLAG_ASYNCSTORE from being reset on a write 
1838    failure
1839
1840  * Convert reference counts on cm_volume_t, cm_conn_t, cm_server_t 
1841    objects to use the faster Interlocked operations which avoid 
1842    the need to hold write locks.
1843
1844  * Permit rxkad errors other than RXKADEXPIRED to be treated as a 
1845    non-fatal error that forces a retry against another service 
1846    (if available.)
1847
1848  * Fix a crash in smb_WriteData that would occur if an application 
1849    opened the file as read-only and then sent a write request anyway.  
1850    (RT 88731)
1851
1852  * Respond to VL_NOENT errors by removing cm_volume_t object and
1853    setting it to be the first object to be recycled.  This is not 
1854    only a more efficient use of resources but it also prevents 
1855    repeated attempts to query the VLDB server for the volume from 
1856    the CheckOfflineVolumes routine.
1857
1858  * Change the defaults for RxEnablePeerStats and RxEnableProcessStats 
1859    back to "on".
1860
1861  * A first cut at a cache manager statistics monitor that can be used 
1862    to determine the necessary cache parameters to support the 
1863    application working set.
1864
1865    Off by default, the performance package can be activated by setting 
1866    "daemonPerformanceTuningInterval" in the service Parameters key.  
1867    As with the other daemon interval values the unit is in seconds.
1868
1869    At service start and each succeeding interval the cache manager 
1870    will write statistics to %TEMP%\afsd_performance.txt showing the 
1871    relative usage of cm_scache_t, cm_volume_t and cm_buf_t objects.  
1872    The FID statistics keep track of all FIDs seen by the cache manager 
1873    during the service session whether or not they are backed by any 
1874    live object in the cache.
1875
1876    These statistics are not stored in the cache file.
1877
1878  * Fix windows event logging broken in 1.5.33.
1879
1880  * Eliminate multiple calls to syscfg_GetIFInfo() which is used to 
1881    populate the IP address list for WhoAreYou/TellMeAboutYourself RPCs
1882    as well as when computing the server preference list.
1883
1884  * When merging status after a StoreData operation prevent data 
1885    buffers from being discarded that we would prefer to keep.  
1886    (Bug introduced in 1.5.33.)
1887
1888  * Modify installers the set RxMaxMTU to 0.
1889
1890  * In the AFS Configuration Panel on the Advanced->Miscellaneous 
1891    dialog, the Background Daemons and Service Threads fields were 
1892    swapped.
1893
1894  * Increase default number of Background Daemons to 4.
1895
1896  * Remove cm_volume_t reference from the cm_scache_t object.  Permit 
1897    cm_volume_t objects to be recycled.
1898
1899  * Windows Error Reporting has shown a number of previously unseen 
1900    stack corruption errors in the Explorer Shell extension.  The 
1901    minidump appeared to indicate the problem was in ParseAcl().  
1902    Reviewing the function it appears that numerous things could go 
1903    wrong if invalid input was provided.  Added error checking and 
1904    data validation.  Hopefully this will address the problem.
1905
1906  * Windows Error Reporting has shown crashes in aklog as a result
1907    of krb5_cc_get_default() failures not being handled.  They are
1908    now handled.
1909
1910 Since 1.5.32
1911  * The Rx library used a 32-bit type for sockets which was
1912    truncating the socket value on 64-bit Windows.  This 
1913    was not an issue in general but became an issue when 
1914    Rx "hot thread" support was enabled.
1915
1916  * Enable "Rx hot thread" support which ensures that while
1917    a received message is being processed that a new thread
1918    is allocated to receive the next message to arrive.
1919
1920  * Increased parallel access to smb_rctLock protected 
1921    resources.  Reduce the number of times that the 
1922    lock is dropped and re-obtained.
1923
1924  * Increased parallel access to cm_scache_t and cm_buf_t
1925    resources by replacing the previous global write lock
1926    protected reference counting mechanism with one built
1927    upon the use of InterlockedIncrement and InterlockedDecrement.
1928
1929  * Implement a hash for cm_fid_t to reduce comparison costs
1930    and inline the cm_FidCmp() function.
1931
1932  * Redefine the BUF_HASH and BUF_FILEHASH in terms of the cm_fid_t 
1933    hash which has a better distribution
1934
1935  * Modify cm_ConsiderPrefetch to evaluate the amount of data in 
1936    the most recent read request instead of the next chunkSize.  
1937    cm_chunkSize can be dozens or hundreds of buffers.  As a result
1938    too much time is spent performing the evaluation.
1939
1940  * Fix the usage of cm_scache_t bufCreateLock.  The purpose of this 
1941    lock is to prevent the creation of new buffers while a truncation 
1942    is being performed.  All references to bufCreateLock have been 
1943    removed except in two places:
1944    i.  a write-lock surrounding the function that calls buf_Truncate()
1945    ii. a read-lock within buf_GetNewLocked() that actually allocates 
1946        new buffers
1947
1948  * Modify the CM_CONFIG_DATA_MAGIC value to include a 
1949    CM_CONFIG_DATA_VERSION number which value be used to force the 
1950    replacement of the cache file contents when incompatible changes 
1951    are made between releases.
1952
1953  * CM_SCACHESYNC_ASYNCSTORE should not be ordered by 
1954    cm_SyncOpCheckContinue
1955
1956  * Avoid calls to multi_Rx if nconns == 0
1957
1958  * Modify smb_WriteData to perform background writes based upon the 
1959    crossing of 'smb_AsyncStoreSize' boundaries instead of cm_chunkSize 
1960    boundaries.  This will slow down writes from the SMB interface but 
1961    will avoid the risk of the CIFS client disconnecting from the AFS 
1962    client SMB server.  The default value for 'smb_AsyncStoreSize'
1963    is 128K.  
1964
1965  * SMB AsyncStore functionality is on by default but can be 
1966    disabled using the registry value:
1967
1968      HKLM\SOFTWARE\OpenAFS\Client DWORD "EnableSMBAsyncStore"
1969
1970    smb_AsyncStoreSize can be adjusted with 
1971
1972      HKLM\SOFTWARE\OpenAFS\Client DWORD "SMBAsyncStoreSize"
1973
1974    The value must be a multiple of the buffer block size 
1975    and cannot be larger than the chunk size.
1976
1977  * Do not leak a read lock on the bufCreateLock
1978
1979  * Do not forget to call cm_SyncOpDone if cm_SyncOp succeeded
1980    in cm_CheckNTOpen()
1981
1982  * In MergeStatus, only remove clean buffers from the hash table.
1983
1984  * Avoid the need to update the data version number on each buffer 
1985    associated with a scache when MergeStatus is called after a 
1986    StoreData by maintaining a range of valid data versions as part 
1987    of the cm_scache_t object.
1988
1989  * Profiling shows large numbers of blocked calls in cm_HoldSCache
1990    from cm_HaveAccess...   We can safely avoid the call so do so.
1991
1992  * Add "ForceAnonVLDB" service parameters registry value.  Default
1993    is 0.  Set to 1 to force the use of anonymous connections to
1994    the VLDB servers.  This is useful when using krb5 tokens and the
1995    VLDB servers have not been updated.
1996
1997 Since 1.5.31
1998  * Do not attempt to search for a cell name that matches one
1999    of the special share names "svrsvc", "wkssvc", "ipc$"
2000
2001  * Issue permission denied warnings from afscreds if attempts
2002    to modify the startup shortcut or registry values fail.
2003    This happens under Vista UAC.
2004
2005  * Do not return BAD_NETWORK_ERROR in response to attempts
2006    to create directories or files in the Freelance root.afs 
2007    volume.  Instead return ACCESS_DENIED.
2008
2009    BAD_NETWORK_ERROR was being sent because the Freelance cell 
2010    has no vldb servers.  Short circuit the error by testing for 
2011    freelance in CreateFile and MakeDir
2012
2013  * Treat srvsvc, wkssvc and ipc$ as pseudo files.  Permit them 
2014    to be opened and closed without actually existing.  For now 
2015    we treat them as equivalent to ioctls but this should 
2016    eventually change.
2017
2018  * Fix RAP processing to not reject names that exist in the 
2019    root.afs volume for GetInfo queries.
2020
2021  * In afscreds, use GetUserNameEx to obtain the username instead 
2022    of searching the registry.  Try UserPrincipalName first and 
2023    fallback to SamCompatible.
2024
2025  * Stop linking to rpcns4.dll which is no longer supported on 
2026    Vista and 2008.  TaAfsAdmSvr is going to have to be 
2027    redesigned.
2028
2029  * When processing dfs referral requests, if the sharename is 
2030    a partial match and therefore will not be added automatically 
2031    to the share list, make sure that we return an error.
2032
2033  * Avoid a crash when logging VNOVOL errors returned from 
2034    cm_CheckOfflineVolume.
2035
2036  * When trace logging is disabled, do not permit osi_LogSaveString 
2037    to perform the string copying.  By disabling the string 
2038    copies, throughput of the service more than doubles.
2039
2040  * when checking offline volumes, update the cell vlserver info
2041    if required and don't perform a check if there are no servers
2042    in the list.
2043
2044  * Add volumes in the vl_unknown state to the list of objects to be
2045    checked as offline or retried when an allbusy error is received
2046    in cm_Analyze.
2047
2048  * Add support for configuring rx_ExtraPackets
2049
2050  * All calls to buf_Get() must be protected by a read lock on the
2051    cm_scache_t bufCreateLock
2052
2053  * When a MergeStatus results in the invalidation of buffers, do
2054    not remove buffers from the hash tables that have active references.
2055
2056  * Upon receiving a VNOVNODE error from a file server, be sure to
2057    invalidate any file locks.  This prevents on-going attempts to
2058    extend the locks and will cause subsequent attempts to access
2059    the file to receive a invalid handle error.
2060
2061  * Prevent smb_ReceiveTran2SearchDir from adding terminating NULs
2062    to directory entry names.
2063
2064  * No longer discard tokens when RXKADBADTICKET error is received.
2065    Instead return STATUS_NO_KERB_KEY error.
2066
2067 Since 1.5.30
2068  * Add "cmdebug <host> -cellservdb" option and client service 
2069    implementation permits querying the vldb server for each 
2070    cell known to the cache manager.  The output is in a form
2071    that permits it to be used as a CellServDB file.
2072
2073  * Add Symlinks->Show option to the AFS Explorer Shell Context
2074    Menu
2075
2076  * Prevent buffer overrun in the cmd parser used by command
2077    line tools such as fs, vos, pts, etc.
2078
2079  * The path ioctl operations have several issues:
2080
2081    (1) the specified path for "fs examine, whereis, whichcell, 
2082        flush" and so always has the follow symlinks and mount 
2083        points semantics.  This makes it impossible to determine 
2084        what the FID of a symlink or mount point is.
2085
2086    (2) "fs examine" out is not the result of a single pioctl 
2087         operation but is actually the combined output of half 
2088         a dozen operations.  Path evaluation is an expensive 
2089         operation.  It would be faster if the caller could
2090         evaluate the FID first and then perform all of the 
2091         rest of the operations by specifying the FID instead 
2092         of the path.
2093
2094    (3) fs output reports all objects as files.  By adding a 
2095        GetFileType pioctl more informative output can be provided 
2096        that indicates what type of object the path evaluates to.
2097
2098    (4) the Windows fs command includes a number of commands that 
2099        do nothing but exist only because the Unix cache manager 
2100        supports them.
2101
2102    A new extendible data structure cm_ioctl_query_opts_t has been 
2103    added which can be optionally specified with pioctls that do not
2104    already require input data.  The first two fields of this structure 
2105    are 'literal' and 'fid'.  The literal field is used to indicate
2106    whether the last component of the path should be evaluated following 
2107    symlinks and mount points.
2108
2109    The fid field permits a fid to be specified.
2110
2111  * A new GetFileType pioctl has been added. The type of objects are 
2112    now output.
2113
2114  * A new "-literal" option is available for "fs examine, flush, whereis, 
2115    and whichcell.
2116
2117  * Unimplemented fs commands have been removed.
2118    
2119  * There are circumstances where a volume object is being accessed and 
2120    the volume is marked indicating that the volume location information 
2121    is out of date but where it is also pointless and perhaps dangerous 
2122    to block waiting for the rpc to complete.  One example is when 
2123    processing the cmdebug requests.  If we know that we are not going 
2124    to use the volume object to contact a server, then we can now set 
2125    the CM_GETVOL_FLAG_NO_RESET flag.
2126
2127  * when moving up in the directory tree we search the recorded fid list 
2128    to find a matching fid that we have already crossed.  we must also 
2129    reset the fid count based upon what we discover.
2130
2131  * Cell names are published as share names.  As a result they are searched
2132    for as part of the Dfs Referral evaluation.  If share "foo" can not be
2133    reached, the CIFS client will fallback to searching for "fo" as well.
2134
2135    Since the freelance client automatically adds a symlink for prefixes
2136    of the cell name, this results in both "foo" and "fo" being added to
2137    the freelance root.afs volume.  This patch prevents that negative side
2138    effect.
2139
2140  * when tracking Kerberos credential cache names be sure to include 
2141    the cache type prefix.
2142
2143  * Microsoft has assigned OpenAFS a network type value
2144
2145  * The algorithms that were used to produce a Netbios name were broken.
2146    The name that was produced when the hostname was too long was in fact
2147    longer than the maximum permitted netbios name.
2148
2149    Also, the "NetbiosName" value was not used as a suffix when the loopback
2150    adapter was not installed.  The hardcoded string "AFS" was used instead.
2151
2152  * avoid another deadlock during server probes initiated by the ipaddr 
2153    change daemon thread.
2154
2155  * prevent the afs client service from crashing when fs newcell is 
2156    executed
2157
2158  * In the NSIS installer, move afslogon.dll, afscpcc.exe and afs_cpa.cpl 
2159    to \Program Files\OpenAFS\Client\Program in order to get them out
2160    of the %windir% tree
2161
2162  * EDQUOT == WSAEDQUOT.   Define it in the right places so that in the 
2163    end STATUS_OUT_OF_QUOTA can be returned to the application.
2164
2165  * Modify the search order for determining the location of CellServDB
2166    and other client configuration files.
2167
2168    1. AFSCONF environment variable
2169    2. registry setting
2170    3. NEW - use All Users\AppData\OpenAFS\Client only if CellServDB exists
2171    4. use Program Files\OpenAFS\Client
2172
2173  * More Vista Power Management tweaks
2174
2175  * Close a socket handle leak in the kauth routines
2176
2177  * Don't hold a cm_volume_t mutex across RPCs
2178
2179  * Convert downTimes to use clock time instead of relative times.
2180    This permits correct comparisons with expiration times.
2181
2182  * Update the Wix installer to properly install the prerequisites 
2183    for translate_et.exe
2184
2185  * Do not translate pioctl paths as they are not converted by the
2186    file system stack.
2187
2188  * Implement multi_rx probes for checking whether servers are up
2189    or down.  Turns probes into a constant time activity instead 
2190    of one dependent upon the number of known servers.
2191
2192  * Treat VNOVOL errors the same as VOFFLINE.  Do not force an
2193    update of the volume location data and retry.  VNOVOL means
2194    that the volume could not be attached.  It doesn't mean that
2195    the volume is not on this server.
2196
2197  * Modify the Explorer Shell AFS Context menu Symlink->Add to
2198    not attempt to validate the target path.   There is no reliable
2199    method of doing so.
2200
2201  * Improve performance of \\afs\<cell><mount-type><volume>\
2202    access by eliminating extraneous attempts to search the 
2203    CellServDB file and DNS AFSDB records.  Share names 
2204    containing '%' or '#' are not valid cell names.
2205
2206  * Return STATUS_RANGE_NOT_LOCKED if the application attempts
2207    to unlock a range that is not currently locked.
2208
2209  * Enable the 32-bit tools to read the 64-bit registry keys
2210    when executing in the WOW64 environment.
2211    
2212
2213 Since 1.5.29
2214  * Fix buffer refcount leak introduced in 1.5.29
2215
2216  * Prevent the NIM AFS Provider from crashing when configured to use 
2217    Kerberos v4 for token acquisition in situations where no Kerberos v4
2218    support is available.  For example, 64-bit KFW or sites that delete
2219    the Kerberos v4 DLL.
2220
2221  * In afsd_init.log, support logging cache sizes greater than 2GB.
2222
2223  * The volume status output of "fs examine" was being determined based
2224    upon the wrong error value.  Instead of using the pioctl() return
2225    code, the errno value must be used.  
2226
2227  * Prevent invalid pts auto-registration attempts by aklog and the 
2228    NIM afs provider when Kerberos referrals are in use.  (krb5 1.6+)
2229
2230  * Add synchronization protection to all of the SMB Listener State 
2231    variables.  This prevents race conditions when the addition or
2232    loss of a network adapter takes place.
2233
2234  * On Vista, there is a race condition between the restart of the 
2235    afs client service and the network adapters.  Ensure that the 
2236    afs client service can handle switching between loopback and 
2237    non-loopback modes of operation.
2238
2239  * Fix FollowBackupPath to work with mount points that are not 
2240    explicitly read/write.
2241
2242  * Fix a deadlock that has been observed on Vista while resuming
2243    after at least four hours of sleep.
2244
2245  * Add new HKLM registry configuration options that can be used 
2246    to provide configuration hints to the NIM AFS Provider when 
2247    creating new identities.  See release notes for details on
2248    HKLM\SOFTWARE\OpenAFS\Client\Realms\.
2249
2250 Since 1.5.28
2251  * Speed up write buffer operations by holding a global read-lock
2252    instead of a write-lock when updating the buffer data version 
2253    number.  The data version is protect by the associated stat
2254    cache mutex.
2255
2256  * Speed up read buffer operations by removing out of date buffers
2257    from the buffer hash tables.
2258
2259  * Protect against a null pointer dereference in afslogon.dll
2260    if QueryAdHomePathFromSid() fails.
2261    
2262  * Remove a race condition while accessing private freelance data
2263    structures.
2264
2265  * Update the buffer data versions when Freelance directory data
2266    changes.
2267
2268  * Complete the implementation of smb_ReceiveTran2GetDFSReferral().
2269    Critical for Vista.  
2270
2271  * Return EAS_NOT_SUPPORTED in response to EA read/store/query 
2272    instead of returning zero length.
2273
2274  * Return ERROR_RETRY when a server sends VBUSY.
2275
2276  * Return PATH_NOT_COVERED instead of BADSHARENAME for DfsLinks when
2277    a volstat plug-in is in use.
2278
2279  * Enhance the volstat interface to support Dfs path mappings.
2280
2281  * Fix "symlink list" to do the right thing for Dfs links
2282
2283  * Fix callback expiration that was broken in 1.5.27.
2284
2285  * Fix a crash at shutdown caused by the lack of synchronization
2286    within the daemon threads (cm_Daemon, cm_BkgDaemon, cm_IPAddrDaemon)
2287
2288  * Hold the cm_server_t mutex while walking or modifying the 
2289    cm_server_vols_t list in order to avoid a race condition.
2290
2291  * Ensure that the cm_server_t refCount is safely modified.
2292
2293  * The pthread library implementations of pthread_cond_wait
2294    and pthread_cond_timedwait were failing to return with 
2295    the mutex held when error conditions occurred.  This could
2296    result in race conditions wherever they are used.  One case
2297    in which problems were seen was the Rx event_handler().
2298
2299  * Prevent cm_GetBuffer() from locking all buffers associated with 
2300    a stat cache object before deciding if the current buffer is up 
2301    to date.
2302
2303  * Fix cm_BkgPrefetch to actually ensure that there is a cm_buf_t 
2304    object for each offset that we will attempt to reserve.
2305
2306  * Reduce the default number of background daemon threads used to 
2307    prefetch or store to one in order to prevent two or more threads 
2308    from stepping on each other.
2309
2310  * Reduce the default chunk size to 256KB in order to prevent read 
2311    timeouts on low bandwidth connections.
2312
2313  * Fix a race condition that could result in threads becoming stranded 
2314    when synchronizing multiple requests on the same stat cache object.
2315
2316 Since 1.5.27
2317  * The GiveUpAllCallBacks functionality that was added in 1.5.21
2318    has been disabled.  It has been disabled because it turns out
2319    that the RPC is improperly implemented in all file servers 
2320    previous to 1.4.6.  The RPC is executed without the proper 
2321    locks being held resulting in data corruption and eventual file
2322    server failure.  The functionality will be re-enabled in a 
2323    a few months.
2324
2325  * a couple of .readonly Volume Callback optimizations were 
2326    implemented:
2327    -  Apply most recent volume callback to all stat cache objects 
2328       in the volume.  This avoids premature callback expirations 
2329       and unnecessary FetchStatus calls.
2330    - Add option to permit attempts to renew .readonly Volume 
2331      Callbacks on a periodic basis to avoid invalidation of stat 
2332      cache data.  [Requires daemonCheckVolCBInterval be set to 
2333      non-zero number of seconds.  1800 (30 minutes) is suggested.]
2334
2335  * Adds support for 64-bit data version values.  Previous releases 
2336    only supported 32-bit values.  Larger values sent by the file server 
2337    would result in rollover.
2338
2339  * aklog and asetkey no longer generate an exception if Kerberos for 
2340    Windows is not installed.
2341
2342  * If the LSA authentication functions report a temporary out of memory 
2343    condition, fail the current authentication and do not cause the AFS 
2344    client service to terminate unexpectedly.
2345
2346  * When the AFS client service is shutting down, prevent the daemon check 
2347    thread from executing additional checks which might attempt to access 
2348    discarded locks or unmapped memory.
2349
2350  * Correct a double free condition in the NIM AFS credentials provider.
2351
2352  * Add "FollowBackupPath" service parameter registry value.   
2353    This provides equivalent functionality to the UNIX afsd -backuptree
2354    option.  When set to a non-zero value, normal mount points originating
2355    in a .backup volume will prefer a .backup volume.
2356
2357 Since 1.5.26
2358  * Fix NSIS uninstall from the .MSI installer.
2359
2360  * Add Stack Frame logging for AMD64
2361
2362  * Add support for EWOULDBLOCK to cm_Analyze.  If the file 
2363    server returns EWOULDBLOCK, retry the request every two 
2364    seconds for up to the RDRtimeout.
2365
2366  * Reorganize the order of the includes to ensure that EWOULDBLOCK 
2367    is not assigned the same value as EIO.
2368
2369  * Update CellServDB to GCO Public 25 Oct 2007
2370
2371  * Add additional validation and error handling code after 
2372    each call to getSlot().  If an invalid slot is returned, 
2373    return NONODE.  If the invalid slot is returned when 
2374    extracting a data node, invalidate the tree.
2375
2376  * Modify compareKeys() to always perform a case-insensitive 
2377    comparison and only perform a case sensistive comparison 
2378    if the case-insensitive one matches.  This ensures the 
2379    ordering is consistently reported.
2380
2381  * Add lock assertions to ensure that all calls are being 
2382    performed with the correct locks being held.  There have been 
2383    some crash reports that provide stack data that does not appear 
2384    to be possible unless there is a race.  However, there are no 
2385    obvious locations where the race is taking place and the test 
2386    suite indicates that all of the correct locks are being held. 
2387    We shall see what happens in the field.
2388
2389  * For consistency replace all calls to findKey in which the range i
2390    s (1,numentries) with calls to getSlot().
2391
2392  * Optimize the depth search loop by testing the slot value in the 
2393    for statement instead of forcing the loop to be broken later.
2394
2395  * Reorganize the locking for cm_BeginDirOp and cm_EndDirOp.
2396    There are a number of locations where locks are obtained, dropped, 
2397    and reobtained.  This reorganization attempts to accomplish several 
2398    things:
2399
2400    (1) be optimistic for the most common case so it will be fast
2401
2402    (2) add consistency checks after each location where locks are 
2403        dropped and re-obtained.  If we lose a race in cm_BeginDirOp 
2404        and the bplus tree is out of date, retry until we get to a 
2405        consistent state that we can use.
2406
2407    (3) Ensure that all operations take place with the correct locks.
2408
2409  * One of the issues that has become a serious problem since the 
2410    addition of the local directory updates is that although cm_SyncOp 
2411    synchronizes operations, it does not preserve the order of requests. 
2412    This has always been a problem in that it has been possible for a 
2413    request to fail to complete due to its worker thread's bad luck. 
2414    When a request takes longer than the Windows SMB Redirector's timeout, 
2415    the SMB Redirector tears down the SMB virtual circuit. 
2416
2417    When using the local directory updates it is really important that 
2418    the directory update operations complete in the order that they were 
2419    sent to the file server. If they don't, then the local directory state 
2420    and the file server state will not match and the local directory state 
2421    must be discarded which in turn forces a new read of the entire 
2422    directory contents over the network. 
2423
2424    This patch adds a new cm_scache_waiter_t object that is used to store 
2425    the current thread, buffer, and syncop flags within a waiters queue 
2426    on each cm_scache_t object. If a thread is forced to sleep in 
2427    cm_SyncOp, upon waking it will check to see if there are any other 
2428    threads waiting that are attempting to perform a similar task ahead 
2429    of it in the queue. If yes, the thread goes back to sleep. If not, 
2430    it goes ahead and enters the cm_SyncOp conflict resolution block. 
2431
2432    This patch has the additional side effect of reducing the number of 
2433    competing threads that must obtain the cm_scache_t mutex and process 
2434    the cm_SyncOp conflict resolution block. As a result, the overall CPU 
2435    utilization of the service and the clock time associated with processing 
2436    requests will be reduced.
2437
2438  * assert that the cm_scache_t mutex is held when calling
2439    buf_ForceDataVersion().
2440
2441  * rename findNode to leafNode in bplus_Lookup
2442
2443  * replace all OutputDebugString calls with osi_LogX calls
2444
2445  * modify bestMatch to special case the return values for leaf nodes.
2446    If an entry is above or below the values available in the leaf node
2447    return BTLOWER or BTUPPER instead of BTERROR.
2448
2449  * In insert and delete operations check for BTLOWER/BTUPPER and isleaf,
2450    if true convert to either slot 0 or Max and perform the insertion.
2451    This produces easier to read code when performing lookups.
2452  
2453  * modify lock_AssertXXX macros to call osi_assertx() and provide a
2454    descriptive message.
2455
2456  * the difference between osi_assert() and osi_assertx() is whether or not
2457    a description is specified as part of the call.  When no message is
2458    specified afsd_notifier() is called with a NULL msgp parameter.  This
2459    results in a null pointer dereference during the EventLog() call.
2460
2461    As a result, none of the information describing the assertion is written
2462    to the log file.
2463
2464    This commit sets a default message for use when no other message is
2465    provided and it replaces all calls to osi_assert with osi_assertx and
2466    adds descriptions.
2467    
2468  * Migrate B+ tree search key into thread local storage
2469
2470 Since 1.5.25
2471  * Fix an uninitialized variable in lana_IsLoopback() which 
2472    could result in a random determination that a loopback 
2473    adapter is not a loopback adapter.  This would result in 
2474    a computed Netbios service name of %MACHINE%-AFS instead
2475    of AFS.  This is a serious problem if the value computed
2476    by the AFS Client Service and the client process pioctl
2477    calls produce different results as it will result in a  
2478    communication failure.
2479
2480  * Fix a crash in the B+ Tree code that results when a file
2481    rename only results in a change of case.
2482
2483  * Fix the pioctl path parsing.  The previous algorithm 
2484    broke the current directory of the client into two parts,
2485    the TIDpath which represented the device root and the
2486    relative path.  The problem is that this is not sufficient
2487    from proper processing of symlinks and mount points.  
2488
2489    What is required is that the last component of the path
2490    must not have the symlink or mount point be evaluated
2491    whereas symlink and mount point evaluation must be performed
2492    for the rest of the relative path.  Therefore, the path is
2493    now split into three parts: TIDpath, intermediate path,
2494    and last component.  
2495
2496    "fs examine" now reports the data of the symlink or mount
2497    point object instead of the target and "symlink list" and
2498    "symlink remove" now works.  The "Explorer Shell Extension"
2499    menu now is displayed for symlink objects.
2500
2501  * More informative symlink.exe error messages.
2502
2503  * When the cmd.exe "del" command is used to remove a symlink,
2504    not only was the link object removed, but the stat cache
2505    object for the target was marked deleted.  This resulted
2506    in cache corruption which would require the destruction
2507    of the cache to correct.
2508
2509  * Add undocumented registry value, "OfflineReadOnlyIsValid"
2510    which results in cached contents from read only volumes
2511    to be treated as valid when there is no callback registered
2512    and all servers are down or all instances are offline.
2513
2514    HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
2515
2516  * Add documented registry value, "AcceptDottedPrincipalNames"
2517    which is used to permit the acquisition of AFS tokens 
2518    using Kerberos v5 principal names which include a dot in
2519    the first component.
2520
2521    {HKLM\HKCU}\Software\OpenAFS\Client
2522
2523  * "fs uuid" does not require "AFS Client Administrator" group
2524    membership to display the current UUID value.
2525
2526 Since 1.5.24
2527  * Update NSIS installer to version 2.30
2528
2529  * Update Wix installer to version 2.0.5325
2530  
2531  * 64-bit KFW support:
2532    - Network Identity Manager plug-in
2533    - 64-bit aklog
2534    - 64-bit krb5 enable afscreds.exe, afs server manager,
2535      etc.
2536
2537  * Enable B+ tree Directory Search by default.
2538
2539  * NIM plug-in is now compatible with FILE: ccaches
2540
2541  * Install instloop.exe into Client/Programs/ even though
2542    it isn't required.   Permit it to be used by organizations
2543    that clone Windows systems.
2544
2545  * On a suspend, only drop callbacks for servers that 
2546    are online.  If the server is offline, maintain the callback
2547    until the server is once again available.
2548
2549  * Prevent against acquisition of a directory write lock when
2550    there are no updates to be performed.  This was resulting 
2551    in a write-lock leak which later on would lead to a deadlock.
2552
2553  * Add configurable file pre-fetch mode.  For files that match
2554    the specified file extensions, pre-fetch the entire file into
2555    the cache.
2556
2557    HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
2558       (MULTI_SZ) PrefetchExecutableExtensions
2559
2560  * Fix the client_osi large integer support so that return values
2561    can be properly assigned to large integer variables.
2562  
2563  * Do not hold cm_scache_t mutex across cm_GetCell() calls 
2564    since cm_GetCell() can block in a RPC.
2565
2566  * Add short file name support to B+ tree searches.
2567
2568  * Resolve a conflict between the desire to notify file servers
2569    that the client workstation is suspending and the desire to
2570    permit objects with valid callbacks when the client suspends
2571    to continue to use those objects from the cache if the client
2572    resumes without network connectivity.
2573
2574  * Fix stack variables to ensure that all buffers storing paths
2575    can handle AFSPATHMAX (1024) characters.  Paths of 256 characters
2576    would cause a stack overflow condition.
2577
2578  * On Vista, force afs_config.exe to run with the highest privileges
2579    available to the end user.  For a user in the Administrators
2580    group running under UAC, this will cause afs_config.exe to be 
2581    be run with full Administrators privileges after the user 
2582    approves the privilege escalation.
2583
2584  * More VNOVNODE handling issues.  If a dirty buffer cannot be 
2585    written due to VNOVNODE, clear the buffer and ignore the error.
2586    If a cm_scache_t object has been marked deleted due to a VNOVNODE
2587    error, the next time the smb_fid_t object that references it is 
2588    used return either NOSUCHFILE or NOSUCHPATH and close the
2589    smb_fid_t object.  Subsequent attempts to use the smb_fid_t will
2590    result in an invalid handle error.
2591
2592  * For Vista, set the RequestExecutionLevel of the NSIS installer
2593    to "admin".
2594
2595  * For the build environment, support the generation of manifests
2596    when using the CL1310 (VS .NET 2003) compiler/linker.
2597
2598  * There was a bug in OutputDebugHexString() which could overflow
2599    a stack buffer resulting in unexpected process termination
2600    of afsd_service.exe if the input Security Token contained
2601    many bytes equivalent to the '%' char.
2602
2603  * Add directory lookup statistics to "fs memdump" output.
2604  
2605
2606 Since 1.5.23
2607  * Windows uses case-insensitive file name pattern matching
2608    but AFS is a case sensitive file system.  The AFS3 directory
2609    format is block based, uses network byte order and 
2610    includes a hash table for fast case sensitive lookups.  
2611    This causes several problems for the Windows AFS client.
2612    (1) Traversing the directory blocks is cpu expensive
2613    (2) A hash table miss does not indicate that the desired
2614        entry does not exist.
2615    (3) Determining whether a non-ambiguous inexact match or
2616        the entry does not exist requires a linear traversal
2617        of the entire directory.  
2618    These issues often result in 100% CPU utilization.
2619
2620    These issues are addressed by building a modified B+ tree for 
2621    each directory and then using the B+ tree for searches.
2622
2623    This feature is disabled by default.  To enable it set
2624    the "BPlusTrees" registry value to 0x01 in the AFS Client
2625    Service Parameters key.
2626
2627  * Correct a null pointer dereference in the symlink recursion
2628    detection code.  (Introduced in 1.5.22)
2629
2630  * Add the Network Identity Manager AFS Provider to AMD64 
2631    builds.
2632
2633 Since 1.5.22
2634
2635  * A new registry value, "BlockSize", can now be used to adjust 
2636    the size of the internal buffers used to store file data.  
2637    The default is 4KB.  When set, the values 1..1024 specify
2638    multiples of 4KB. Values > 1024 specify actual block sizes
2639    and must be multiples of 4KB.  The actual block size in KB 
2640    can not be larger than the chunk size which defaults to 1MB.
2641
2642     HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
2643       (DWORD) BlockSize
2644
2645  * pts.exe and ptserver.exe built with -DSUPERGROUPS
2646
2647  * Service Manager shutdown hints have been added.  The hint 
2648    specifies that it may take the AFS client service up to two
2649    minutes to shutdown. 
2650
2651  * Fix the recursion detection feature introduced in 1.5.22.
2652    The previous implementation broke the evaluation of paths
2653    using ../path or ./path.   It also broke the evaluation of
2654    symlinks to absolute paths.  For example, /afs/cell/path.
2655
2656  * Fix an uninitialized variable in cm_MakeDir that could result
2657    in crash if the requested directory could not be created.
2658
2659  * Fix a the VolumeStatusNotification log messages to save
2660    the input string in the circular log buffer so garbarge 
2661    won't be output to afsd.log when the log is dumped.
2662    
2663
2664  * Increase the SMB Maximum Path length to 260 characters
2665    from 256 as that is what CIFS supports.
2666
2667  * On 64-bit Windows, use a unique description string for 
2668    the 32-bit AFS Shell Extension.
2669
2670 Since 1.5.21
2671
2672  * In the AFS Admin Library, replaced all of the 
2673    Ubik_Call(XXX_RPC,...) calls with Ubik_XXX_RPC(...).  This 
2674    allows parameter checking and proper type conversions to be
2675    performed.  This is crucial when passing parameters that are
2676    64-bit wide on systems in which 'long' is a 32-bit value.
2677    Otherwise, the parameter list on the stack is interpretted
2678    incorrectly and the function not only doesn't succeed but it
2679    might corrupt memory and if lucky crash the application.
2680   
2681    The only program that we care about that uses this library 
2682    is the AFS Server Manager.  Now it doesn't crash.
2683
2684  * Fixed smb directory searches for non-wildcard names.  The 
2685    optimized function should not have set the bulk in progress
2686    flag.  This would adversely affect later directory searches
2687    that required a bulk search.
2688
2689  * Detect infinite recursions (up to 512 stat cache objects
2690    in a chain.)  If an infinite recursion is detected, return
2691    an error to stop the CIFS client from querying us forever.
2692
2693  * Executables executed out of AFS name space can have their
2694    pages swapped out by Windows.  Those pages will be reloaded
2695    when they are required.  However, if the cache manager no
2696    longer has a callback and all of the file servers with 
2697    the volume data are down, then the application will crash
2698    due to the inability to read the required page.  
2699
2700    We now track the down time of each server.  If the callback
2701    expires after the server that issued it went down and all
2702    servers are down, we delay the expiration to permit the data
2703    in the cache to be continue to be used by Windows or an 
2704    application.
2705
2706  * The Windows AFS client has always had very poor performance
2707    with regards to directory management.   In the case of 
2708    directory updates caused by create, rename,and delete operations,
2709    the AFS cache manager will now perform local directory updates
2710    when possible in order to avoid re-reading the directory from
2711    the file server.  This will be done in whenever both of the 
2712    following conditions are true:
2713
2714    - the data version on the directory increased by one as a 
2715      result of the operation
2716
2717    - all of the directory buffers necessary to make the change
2718      are present in the cache
2719
2720  * The error message in the AFS Control Panel describing the 
2721    need to be a Windows Administrator has been replaced with
2722    a message describing the need to be in the AFS Admins Group.
2723
2724  * If the vldb server list is empty when attempting to evaluate
2725    a cell mountpoint it was possible for a crash to occur.  This
2726    can only happen if there is an existing mount point and the
2727    is a failure attempting to load the server list from the 
2728    CellServDB file or via AFSDB queries.
2729
2730  * dirty buffers only have their dirty bytes stored to the file
2731    server instead of the entire chunksize
2732
2733  * the default chunksize has been increased from 128KB to 1MB
2734    
2735
2736 Since 1.5.20
2737
2738  * changed the enum values for cm_serverRef_t state info to use a 
2739    private name space to avoid collisions (srv_)
2740  
2741  * added a srv_deleted state for cm_serverRef_t objects.  This 
2742    state is set when cm_FreeServerList() is called with the 
2743    CM_FREESERVERLIST_DELETE flag set.  cm_FreeServerList() may
2744    not always delete the cm_serverRef_t from the list if it is
2745    still in use by another thread.  the srv_deleted state means
2746    the object's contents are no longer valid and it must be 
2747    skipped.  It will be deleted the next time the object is 
2748    freed and the refcount hits zero.
2749  
2750  * the srv_deleted state is also used when a file server reports
2751    either VNOVOL or VMOVED instead of marking the cm_serverRef_t
2752    as offline.  This is done to prevent additional usage of the 
2753    stale vldb data while waiting for the update volume request
2754    to complete.
2755  
2756  * added a state field to the cm_volume_t object (enum volstate 
2757    vl_ name space) that maintains the state of the volume based
2758    upon the states of all of the cm_serverRef_t and cm_server_t
2759    objects.
2760  
2761  * modified cm_UpdateVolume() to set the state of the cm_volume_t
2762    RW, RO, and BK to either vl_alldown or vl_online.  There can't
2763    be any other states because cm_UpdateVolume() destroys any  
2764    previous knowledge we might have had regarding busy or offline
2765    volume status
2766  
2767  * modified cm_UpdateVolume() to update the volume name in the 
2768    cm_volume_t to the volume base name if the previous value was 
2769    a volume ID.
2770  
2771  * modified cm_FollowMountPoint() to check to see if the volume
2772    name is a volume ID and if so call cm_GetVolumeByID instead 
2773    of cm_GetVolumeByName.  This ensures that volume IDs are always
2774    looked up as numeric values.  There is no longer a need to 
2775    maintain a separate cm_volume_t containing the string representation
2776    of the ID value.
2777  
2778  * Added a flags parameter to cm_GetVolumeByName() and cm_GetVolumeByID().
2779    The first flag is a "CREATE" flag which is set by all existing
2780    calls.  The flag is not set by calls to cm_GetVolumeByID() from
2781    the server probe code when volume status is being updated.  We 
2782    do not want the server probe operation to result in additional 
2783    turnover in the cached volume data.  The second flag is NO_LRU_UPDATE 
2784    which is set when the server probe code updates the volume status.
2785    This flag will be used to prevent the server probe operation from
2786    changing the order of the least recently used queue.
2787  
2788  * Modified cm_GetVolumeByName to ensure that only one cm_volume_t is 
2789    allocated for a given set of normal, readonly, and backup volumes
2790    regardless of whether or not the volume is accessed via name or 
2791    ID number.  The cm_volume_t namep field is always the base name
2792    of the volume. 
2793  
2794  * Added a new volume state, vl_unknown.  This state is used as
2795    the initial state for all cm_volume_t when the cache manager starts, 
2796    for each cm_volume_t at creation, and for each cm_volume_t when
2797    recycling.  The cache manager does not know the state of all 
2798    volumes in the world, only those that are in the cache and for
2799    which it has queried the VLDB and hosting file servers.
2800  
2801  * modified cm_GetVolumeByName() to initialize the state of a 
2802    volume to vl_unknown.  The actual state will be set when a 
2803    cm_VolumeUpdate() call completes successfully.
2804  
2805  * changed name of scache hash table variables to avoid ambiguity
2806    when adding hash tables for volumes
2807  
2808  * fix a buffer overrun in sys\pioctl_nt.c  pioctl().
2809  
2810  * modified cm_UpdateVolume() to handle the case in which there is
2811    no RW volume but there is are RO volumes for a given base name. 
2812    This is done by querying for the ".readonly" volume name if the 
2813    base name does not exist in the VLDB.  We never query for the
2814    .backup name because under the current usage model a .backup 
2815    volume may only exist on the server that the read-write volume
2816    is located.  If there is no RW volume, there can be no .backup.
2817  
2818  * Added four hash tables for cm_volume_t objects to improve the 
2819    search time of cm_GetVolumeByID(), cm_GetVolumeByName() and
2820    cm_ForceUpdateVolume(). One each for Name, RWID, ROID, and 
2821    BKID.  Three ID hash tables are necessary as long as it is
2822    desireable to maintain a single cm_volume_t containing all
2823    of the related RW, RO, and BK volume data.  Having the RW and
2824    RO volume data in the same object is necessary for the 
2825    implementation of cm_GetROVolumeID() which returns either the
2826    RO or RW ID depending upon the existence of RO volume instances.  
2827  
2828  * Added a volume LRU queue so that volume reuse becomes fairer.
2829    This does not replace the all Volumes list which is used when
2830    it is desireable to walk a list of all the volumes whose order
2831    is not going to change out from underneath you which makes it
2832    safe to drop the cm_volumeLock.
2833  
2834  * handles volume hash table updates where volume name to 
2835    volume ID number changes.  The volume name remains 
2836    constant in the cm_volume_t.  if a vos rename is performed, 
2837    the name of the volume will change and the volume IDs will be 
2838    updated.  Subsequent access to the old volume ID will create a 
2839    new cm_volume_t with the new name.
2840  
2841  * Added a daemon thread operation to query the state of volumes
2842    listed as busy or offline.  cm_CheckBusyVolumes() calls 
2843    RXAFS_GetVolumeStatus() for each volume ID that is marked vl_busy 
2844    or vl_offline.   If the volume is now online, the status on the
2845    volume is updated.  The default period is 600 seconds.  This can 
2846    be configured with the BusyVolumeCheckInterval registry value.  
2847  
2848  * Added prototype for smb_IoctlPrepareRead() which was missing a
2849    return type in the function definition.
2850  
2851  * Added volume id lists to the cm_server_t.  These lists are
2852    allocated in blocks of ~32 IDs.  When a cm_PingServer() 
2853    detects a change in server state, the state of the cm_volume_t
2854    is updated.  
2855  
2856  * Added volID to the cm_serverRef_t object.  volID is used
2857    to identify the volume for which the object is a referral.
2858    cm_FreeServerList() uses the volID to remove the volume 
2859    from the cm_server_t.
2860  
2861  * In cm_Analyze, when VNOVOL or VMOVED are received, 
2862    call cm_ForceVolumeUpdate() to force a refresh of the volume 
2863    location data.
2864  
2865  * Added cm_VolumeStatusNotification() which is used at the moment
2866    to log volume status changes to the trace log.  It will also
2867    be used as the access point to the File System Filter driver
2868    notification engine.
2869  
2870  * Added an all cm_scache_t list to cm_data.  This replaces the use
2871    of the stat cache LRU queue when we need to enumerate all 
2872    entries.  The LRU list order is not static and when using it to 
2873    enumerate all entries it can result in items being missed or
2874    items being processed more than once.
2875  
2876  * Modified cm_Analyze(). Instead of reseting the busy or offline
2877    state of a volume and forcing a retry of the operation
2878    cm_Analyze will defer to the background daemon thread that will
2879    update the state once every 600 seconds.
2880  
2881  * Added the automatic generation of a Freelance ".root" read-write
2882    mountpoint that refers to the root.afs volume of the workstation
2883    cellname at the time the mountpoint is created.
2884  
2885  * re-write cm_Analyze to make better use of the known volume
2886    status.  VL_Server queries cannot result in CM_ERROR_ALLOFFLINE
2887    messages.
2888  
2889  * renamed cm_CheckBusyVolumes to cm_CheckOfflineVolumes.  
2890    busy volumes will be reset to srv_non_busy by the function
2891    but there is no mechanism for querying the busy state other
2892    than by attempting to access the resource.
2893  
2894  * cm_Analyze will query the state of an offline volume before
2895    deciding whether or not to retry when all volume instances
2896    are offline.
2897  
2898  * the algorithm used after an IP address list change detection
2899    has been modified.  we now check the state of the VLDB servers,
2900    then reset the rx connections, and finally check the state of 
2901    the file servers.  Previously we flushed the rx connections 
2902    and then checked the servers in whatever random order they 
2903    were first discovered.
2904  
2905  * fix the volume status reported by "fs examine"
2906  
2907  * various improvements to the AFS Network Identity Manager Provider.
2908    - Don't access freed objects after the window has been destroyed.
2909    - Write back the AFS cell list in the identity configuration 
2910      even when its empty.
2911    - Disable all use of the provider when AFS is disabled for a 
2912      particular identity.
2913  
2914  * Fix cm_cell_t leak.  When evaluating a mountpoint that uses an
2915    alias instead of the full cellname, double check the full cell
2916    name and see if we have a matching cell before allocating a new
2917    one.
2918  
2919  * Dump more data with "fs memdump". All volumes and scaches and
2920    now cells.
2921  
2922  * Reverse the order of the all cells list.  This ensures that
2923    the workstation cell is always first in the list.
2924  
2925  * If we recognize the server from which a callback revoke was
2926    received, then we can ensure that we only invalidate the status
2927    information for cm_scache_t objects belonging to that cell.
2928  
2929  * When building for amd64, use APPVER 5.02 as we do not support
2930    64-bit Windows 2000 and explicitly state the machine type in
2931    the link flags.  
2932  
2933  * no longer treat VMWare network adapters as equivalent to a 
2934    loopback adapter.  For some unknown reason, publishing the "AFS"
2935    netbios name on them frequently results in a name collision 
2936    error.
2937  
2938  * Use read locks whenever possible instead of write locks when
2939    walking the allCellsp list.  This permits better use of multiple
2940    CPUs.
2941  
2942  * In 1.5.20 a bug was introduced by the fake status when PRSFS_READ
2943    is not present on the directory optimization.   It would report
2944    mount points and directory objects for which there was no
2945    status information as a zero length file.  Instead we can use 
2946    the vnode number of the object to determine if it should be
2947    considered to be a directory or a file.  If it is odd it is a
2948    directory; even it is a file.
2949  
2950  * Give Back Callbacks to the file servers in response to suspend
2951    and shutdown power management events.  Only give up callbacks
2952    to UP servers and do so with a very short RX dead timeout.
2953    (10 seconds)
2954  
2955  * Fix a race condition in the SMB FID cleanup code that could 
2956    result in a stat cache mutex never being released.
2957  
2958  * Fix the graphics files that are installed as part of the 
2959    IBM Administrators Guide.
2960  
2961  * Change the behavior of pioctl path parsing to not follow 
2962    symlinks or mount points during evaluation.  This results in
2963    the FID being the symlink or mount point and not the object
2964    they point to.  This is consistent with the behavior of the 
2965    UNIX client.
2966
2967  * Enable AFSDB record lookup for command line tools such as
2968    "fs" and "vos".
2969
2970  * CellServDB update 2007-07-05
2971
2972  * Added a Volume Status Plug-in Interface that permits third parties
2973    to receive notifications when the volume state changes occur.
2974
2975  * Ensure that all writes to the afsd_alloc.log file use CR-LF.
2976
2977  * Prevent the afsprocmgmt.dll from being unloaded while the 
2978    background thread it starts is running.
2979
2980  * Avoid a race condition when closing smb_fid_t objects.
2981
2982 Since 1.5.19
2983  * fix install path of IBM Quick Start Guide when installed by
2984    the Wix installer
2985
2986  * fix the client so that it can write into directories with
2987    only 'li' permissions.
2988
2989  * fix installation of 32-bit Shell Extension for 64-bit systems.
2990    Install it under its own HKCR keys.
2991
2992  * modify the wix installer to remove and upgrade install packages
2993    with the same version number.  
2994
2995  * when flushing volume location data every two hours or in 
2996    response to "fs checkvolumes", also flush the mount point 
2997    links in order to force their re-evaluation.
2998
2999  * aklog was copying an uninitialized buffer as part of the 
3000    foreign cell automatic pts registration
3001
3002  * when obtaining directory listings, check for read permission
3003    on the directory.  If read permission does not exist, fake the
3004    status information for the directory entries.  This improves
3005    performance, prevents the client from pounding the file server,
3006    and prevents leakage of cached status information.
3007
3008  * "fs getcacheparms" output was incorrect.
3009
3010  * NetIdMgr AFS Provider should only automatically add token 
3011    acquisition for cell foo.com if the realm of the cell matches
3012    the realm of the identity.
3013
3014  * Fix a null pointer dereference in cm_MergeStatus()
3015
3016 Since 1.5.18
3017
3018  * network identity manager provider:
3019
3020    - Correct for the fact that pr_CreateUser tampers with the 
3021      contents of the username input buffer.
3022
3023    - Take into account that the krb4 credential data structure
3024      does not have separate realm fields for the user and service.
3025      When krb524 is used with a cross-realm ticket, the realm
3026      describes the service not the user.  
3027
3028  * Many integrated logon changes:
3029
3030    - Fix eventlog reporting.  Do not attempt to log an event 
3031      if the event source registration fails.  Use DebugEvent0 
3032      instead of DebugEvent when there are no parameters.
3033
3034    - Modify the LOOKUPKEYCHAIN macro to recognize ERROR_MORE_DATA 
3035      errors.
3036
3037    - Fix the reading of Domain specific configuration for 
3038      LogonScript and TheseCells.  Previously the dwSize value was 
3039      being overwritten so that subsequent RegQueryValueEx call 
3040      would fail.
3041
3042    - Fix a memory leak in the TheseCells reading code.
3043
3044    - Add support for Domain specific "Realm" specification.  The 
3045      realm is the realm to be appended to the username.  When 
3046      logging in as a domain or to the local machine, the specified 
3047      "Domain" name is not going to be a valid realm name.
3048
3049    - Construct a proper principal name based upon the domain 
3050      specified realm for use in obtaining tokens with KFW.
3051
3052    - If the domain specified "TheseCells" list includes the 
3053      default cell, do not obtain tokens twice.
3054
3055  * An unprotected call to the Kerberos v5 function, 
3056    krb5_free_context(), can result in an invalid memory access
3057    exception if the contents of the krb5 profile, krb5.ini, cannot
3058    be parsed correctly.  The error is located within the afskfw
3059    library which is used by afscreds.exe, afssvrmgr.exe, and 
3060    afslogon.dll.  When the error is triggered within afslogon.dll
3061    a blue screen condition can occur when the winlogon.exe system
3062    process terminates unexpectedly.
3063
3064 Since 1.5.17
3065
3066  * Do not stop the afs client service with an assert
3067    if the cell name cannot be determined when responding
3068    to a "fs whereis" command.
3069
3070  * Integrated Logon (afslogon.dll).  No longer attempt 
3071    to preserve Kerberos 5 tickets for the logon session
3072    as that job is now supported by KFW 3.1 and above.
3073
3074  * The Network Identity Manager plug-in will attempt to
3075    remove expired service tickets from the cache.
3076
3077 Since 1.5.16
3078
3079  * CellServDB update - GCO Public CellServDB 09 Mar 2007
3080
3081  * AFS Server Manager and AFS Account Manager data cache
3082    moved from HKCU\Software\TransarcCorporation to 
3083    HKCU\Software\OpenAFS to prevent crashes due to data
3084    format changes.
3085
3086  * Reduce the default UP server probe time from 10 minutes
3087    to 5 minutes to match UNIX.  This will not solve the NAT
3088    port mapping timeout issue because most NATs default to
3089    a value less that 5 minutes and this value ensures that
3090    the afs client server will start probes 5 minutes after
3091    the last probe set ended.  The probe period for any one
3092    server is therefore longer than 5 minutes.  The more
3093    servers in the list the longer the time between probes.
3094
3095  * Before marking a server as down in cm_Analyze, retry the
3096    request using a new rx connection to the server.  If the
3097    cache manager is behind a NAT, it is possible that the 
3098    response from the server is being sent to the original   
3099    address:port from which the rx connection was established.
3100    This will appear to the cache manager as the server being
3101    down when in fact it is not.  Forcing the use of a new rx  
3102    connection will result in the server responding to the    
3103    most recent address:port assigned to the client by the NAT.
3104
3105    If the server is in fact down, it will simply take a little
3106    longer to notice it.   
3107
3108 Since 1.5.15
3109
3110  * Removing a directory that contained entries was failing with
3111    the wrong error code being returned to the CIFS client.
3112
3113  * rxdebug -long 
3114
3115  * rxdebug exponential back-off.  don't take down a server that
3116    is already struggling to respond.
3117
3118  * Network Identity Manager plug-in registers help on the Help
3119    menu if it is supported by NIM.  (KFW 3.2 and above)
3120
3121  * Plug-n-play networking did not always work after coming back
3122    from a Windows Suspend.  The AFS client service failed to 
3123    re-compute the LAN adapter to bind to and instead attempted
3124    to bind to all LAN adapters.  This would polute the public
3125    network with the name "AFS" which could lead to conflicts 
3126    between machines.
3127
3128  * Build installers using Microsoft Hotfixes provided at
3129    http://tinyurl.com/243svk for Visual Studio C RunTime Library
3130    Daylight Savings Time issues.  
3131
3132  * "fs checkserver" does not require admin privileges unless 
3133    the probe interval is being changed.
3134
3135 Since 1.5.14
3136
3137  * A reference leak was discovered in the mountpoint traversal 
3138    functionality which resulted in cm_volume_t objects not becoming
3139    eligible for re-use.  This will trigger a panic condition when
3140    more than the maximum number of volumes is accessed.
3141
3142  * Fixed the success test for the "fs memdump" operation.  Success
3143    is now reported as such.  Added cm_volume_t object information 
3144    to the dump file.
3145
3146  * A data corruption error has been fixed.  Write requests
3147    queued for background processing were not retried upon failure.
3148    This leads to inconsistencies between the contents of the file
3149    in the local cache and the contents of the file on the file 
3150    server.  
3151
3152    The implemented fix is to re-queue any request that has failed
3153    due to timeout, volume busy, volume offline, server busy, or
3154    server offline.  Requests are not processed while all servers
3155    for a volume are inaccessible.  When servers become accessible
3156    the background request will be retried.
3157
3158    In addition, if a background write fails, do not mark the buffers
3159    as clean.  Failure to preserve the dirty flag prevents the buffers
3160    from being written to the file server in the future.
3161
3162    This fix does not address the possibility that the credentials
3163    necessary to perform a write request might expire between the
3164    time the request is queued and when the request can be processed
3165    due to server accessibility.
3166
3167  * The Freelance volume does not support per user ACLs.  The
3168    cm_HaveAccessRights function did not handle this special case.
3169    Requests for privileges greater than read|lookup would result
3170    in afsd_service.exe entering an infinite loop.  ISOBuster is
3171    known to cause this behavior.
3172
3173  * When deleting files, the SMB Server would attempt to obtain
3174    the access permissions for the parent directory instead of 
3175    for the file itself.  This would result in an incorrect 
3176    assessment of whether or not the file can be deleted.
3177
3178  * The Network Identity Manager AFS plug-in has had its string
3179    tables updated for consistency with the language used by NIM.
3180    All credentials are referred to as credentials instead of tokens.
3181    Drop-down combo boxes now in fact drop down.
3182
3183  * The AFS Salvager was not properly being built on Windows.
3184    This is relevant only if the AFS servers are in use.
3185
3186  * The default signal handlers for the AFS servers incorrectly
3187    processed SIGQUIT.  Instead of stopping the server, an
3188    exception was raised.
3189
3190  * Fix another volume refcount leak.  This one was triggered by
3191    an inability to contact the vlservers in order to update the 
3192    file server list.
3193
3194  * Fix checklist control used by the drive mappings tabs in 
3195    afscreds.exe and afs_control.exe.
3196
3197  * Improve output of "fs memdump" related to buffer management.
3198
3199  * Fix refcount leak of cm_buf_t objects when prefetching buffers
3200    already in the process of being fetched.
3201
3202  * Improve cache performance by computing the buffer hash table
3203    size based upon the number of buffers so that the average 
3204    number of entries in a bucket is seven.
3205
3206  * Improve cache performance of read/write data by locally 
3207    updating the dataVersion of all buffers associated with the
3208    file on each StoreData or StoreStatus operation provided that
3209    the dataVersion was incremented by one and the dataVersion of
3210    the buffer matched the original dataVersion of the cached 
3211    status information for the file.
3212
3213  * When recycling cm_scache_t objects, make sure that we 
3214    clear all of the previous fields.  It is no longer the
3215    case that we can assume that the stat cache object is being
3216    obtained only after a successful FetchStatus call.  
3217    InlineBulkStatus will allocate stat cache objects for which
3218    the no status information is available.
3219
3220  * When a file is being opened with the OPEN_ALWAYS disposition,
3221    do not require write permissions when the file already exists
3222    unless of course the file is being opened requesting write 
3223    access.
3224
3225  * When a file has been opened for read-only access, if the 
3226    application requests an exclusive lock, obtain a read-lock
3227    instead of a write-lock.  The purpose of the exclusive lock
3228    in this situation is to prevent changes to the file and the
3229    full file read lock will provide this guarrantee.
3230
3231
3232 Since 1.5.13
3233
3234  * Enforce Unix Mode Write bit to prevent file deletion of read only
3235    files.
3236
3237  * The CIFS READ and LIST permissions use the same value 0x0001.
3238    When a directory is being accessed, check for PRSFS_LOOKUP 
3239    instead of PRSFS_READ.
3240
3241 Since 1.5.12
3242
3243  * Fix computations of short names of mount points.  They were
3244    broken as part of the directory search optimization. (1.5.13a)
3245
3246  * When all buffers are in use, periodically sleep the threads
3247    waiting for a buffer to become free while the global buffer
3248    lock is not being held in order to permit those threads that
3249    can free buffers to do so.
3250
3251  * Power Management improvements.  Maintain a global flag that 
3252    specifies whether or not the service is in a suspend state.
3253    Do not panic if Netbios() returns NRC_BRIDGE meaning that the
3254    lana is no longer valid.  Instead, stop the listener threads
3255    and if all listener threads are stopped, reset the lana_list.
3256    Allow the cm_Daemon() thread to periodically check the state
3257    of the smb listeners.  If they are all stopped and the service
3258    is not suspended, attempt to restart them.  If there are no valid
3259    lanas, return to the stopped state.
3260
3261  * CreateX and NTCreateX use cm_CheckNTOpen() to test whether or not
3262    the user is permitted to obtain read or write locks.  This function
3263    would obtain the lock and then drop it returning whether or not 
3264    the lock could be obtained.  If the lock was in fact required,
3265    CreateX/NTCreateX would then obtain it with cm_Lock().  The problem
3266    of course being that this pattern results in three RPCs to the 
3267    file server (lock, unlock, lock).  This is reduced to one RPC by
3268    implementing cm_CheckNTOpenDone() which frees the allocated byte
3269    range lock from cm_CheckNTOpen() after the cm_Lock() call is 
3270    performed.
3271
3272  * Optimize the SMB FindFirst processing for the case in which there
3273    are no wildcards.   If a cm_Lookup succeeds, generate a response
3274    from the stat cache entry we have a callback for.  Its cheaper 
3275    than walking each buffer of directory data associated with the
3276    directory stat cache entry when we have thousands of directory
3277    entries to search.
3278
3279  * Increase the SMB Ioctl MaxData size to support larger token sizes
3280
3281  * Disable autorun of the AFS Server Wizard when the AFS Server is 
3282    installed.
3283
3284  * Add AFS Server service dependencies on tcpip and PNP_TDI
3285
3286  * Remove the AFS Server Configuration Tool shortcut
3287
3288  * Add Freelance mode awareness to AFS Server Configuration Tool
3289
3290 Since 1.5.11
3291
3292  * Unlike previous versions of the OS, Vista performs a shutdown on
3293    the Microsoft Loopback adapter just like it would on a real adapter.
3294    This causes the smb_Listener threads to trigger a panic during a
3295    suspend/hibernate power event.
3296
3297    The fix is to unbind from the network adapters in response to a
3298    suspend/hibernate power event and then rebind to the adapters
3299    when a resume power event is received.  Note that the resume events
3300    are not reliably delivered so it is possible the afs service will
3301    not be accessible.  However, this is the best we can do.
3302
3303  * don't allow environment variables we set in afslogon.dll to be 
3304    inherited by child processes
3305
3306  * force an rx connection reset if VICECONNBAD or VICETOKENDEAD are
3307    received
3308
3309  * The old dirty buffer synchronization algorithm had a buf_IncrSyncer
3310    thread walking the all buffer list periodically searching for dirty
3311    buffers to write to the file server.  This had several negative
3312    results.  The algorithm ate up ever increasing amounts of CPU time
3313    even when AFS is idle as the size of the cache increases.  Also,
3314    buffers were written to the file server in an order based upon the
3315    original buffer allocation which has nothing to do with the order
3316    in which the buffers became dirty.
3317
3318    The new algorithm maintains a dirty buffer list.  Items are added
3319    when the buffer is originally marked dirty.  A buffer is only
3320    removed from the list by the buf_IncrSyncer when the buffer is no
3321    longer dirty.  If the list is empty the thread goes back to sleep
3322    immediately without additional processing requirements.
3323
3324 Since 1.5.10:
3325
3326  * Enable renaming of directories from the Explorer Shell when
3327    Offline Folders is enabled
3328
3329  * An error is reported in response to the SMB ReceiveCoreFlush 
3330    request when an error has not occurred.
3331
3332 Since 1.5.9:
3333
3334  * optimize dirty buffer flushes in response to suspend operations
3335    do not flush if only loopback adapter is installed
3336    do no retry dirty buffer writes
3337
3338  * do not reset netbios when performing loopback checks.  doing
3339    so will break the existing lana bind
3340
3341  * remove a deadlock in smb3.c QPathInfo 
3342
3343 Since 1.5.8:
3344
3345  * Add NetIDMgr AFS Plug-in
3346
3347  * "Show Tray Icon" checkbox removed from afs_config.exe
3348
3349  * Disable DNS Registrations for the Loopback Adapter and make sure
3350    that Netbios is turned on.
3351
3352  * A reference count leak on stat cache objects was fixed
3353
3354  * For debugging, tread ids of writers are now tracked on locks
3355
3356  * Corrected an incorrect lock that was being held but not
3357    freed in a rare error case
3358
3359  * Changed trace log end of line to CR-LF so it can be read
3360    with notepad.exe
3361
3362  * modify the buffer synchronization thread to write all dirty
3363    buffers and sleep only when there is no work to be done
3364
3365  * improve behavior of cache manager when large numbers of 
3366    temporary files are being created by multiple clients within
3367    the same directory.
3368
3369  * do not permit dirty buffers that belong to deleted files
3370    to be written to the file server.  its a waste of bandwidth
3371
3372  * do not leak stat cache references when the file server
3373    returns VNOVNODE
3374
3375  * afscreds: do not permit an attempt to obtain tokens if the
3376    afs service could not be started.   this was causing stack
3377    overflows on Vista after resuming from a suspend
3378
3379 Since 1.5.7:
3380
3381  * better handling of dot directory
3382
3383  * fs sq and fs mkm now behave as on UNIX
3384
3385  * add license to installers
3386
3387  * Return Invalid Parameter error for unknown InfoLevels in
3388    SMB Tran2 Search Directory.
3389
3390  * Correctly use WSAStartup and WSACleanup within the RX library
3391
3392  * Check that afsd_service.exe is running before performing
3393    a pioctl call.
3394
3395  * Force AFS Shell Extension to load resource DLL using 
3396    afs_shl_ext.dll as a base name.
339