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