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