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