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