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