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