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