0c0c10b13666eb9a8861589816aa5747f8c55992
[openafs.git] / doc / txt / winnotes / afs-changes-since-1.2.txt
1 Since 1.5.9903 (1.6pre3)
2  * Fix automatic addition of Freelance cell mount points
3    broken in 1.5.9902.
4
5  * Avoid recursive offline volume checks which could cause
6    a crash due to stack exhaustion.
7
8 Since 1.5.9902 (1.6pre2)
9  * rx calls issued on a busy call channel are now specially
10    handled and logged.  All calls are automatically retried.
11
12  * The vos support for multi-homed servers was incorrectly
13    implemented.  The changes have been reverted.
14
15  * Avoid wasting cm_buf_t objects and associated data buffers
16    for obtaining mountpoint and symlink target strings.  Instead
17    read them directly into the cm_scache_t mountPointTarget
18    buffer.
19
20  * Optimize the evaluation of mountpoint and symlink targets
21    by skipping the FetchStatus and a full round-trip if
22    the cache manager does not have valid status information
23    for the object.
24
25  * Fix the abstraction of cm_FreelanceAddMount() by passing
26    in volume names that do not include the trailing dot.
27
28 Since 1.5.78
29  [there was no 1.6pre1 for Windows]
30
31  * vos commands now manipulate servers by UUID and can
32    recognize multi-homed servers.
33
34  * afs_config will not longer set the Tray Icon State
35    in the registry if the checkbox is not present in
36    the dialog. [RT 128591]
37
38  * Heimdal's roken utility library has been added
39    as \Program Files\Common\afsroken.dll
40
41  * When probing servers to determine if they are up or down
42    no longer issue an RXAFS_GetTime RPC to servers that indicated
43    that they do not understand the RXAFS_GetCapabilities RPC.
44    Since they responded it is known that they are up.
45
46  * AFS Explorer Shell Extension now works from folder
47    backgrounds.  Overlays for mount points and symlinks
48    are present in the dll, but are not registered at present
49    by the installers.
50
51  * Do not use RankServerInterval registry value as the value for
52    PerformanceTuningInterval.
53
54  * CellServDB updated to 13 Dec 2010 release from grand.central.org
55
56  * Add "fs chmod" command and display current mode as part
57    of "fs examine" output.
58
59  * When the data version of a mountpoint or symlink changes,
60    the target string in the cm_scache_t object must be cleared.
61    Otherwise, the new target will not be queried.
62
63  * "fs checkservers" now includes vldb servers in the output
64    and only lists multi-homed servers once.  A multi-homed
65    server that has at least one up interface is no longer
66    considered to be down.
67
68  * When asynchronously storing dirty data buffers to the
69    file server ensure that (a) the cm_scache_t object and
70    the cm_buf_t object are for the same File ID so that
71    locking and signalling work properly; and (b) if the
72    FID no longer exists on the file server, do not panic,
73    just discard the buffer.
74
75  * When processing VNOVOL, VMOVED and VOFFLINE errors perform
76    server comparisons by UUID or address and not simply by
77    cm_server_t pointer.  Otherwise, server failover may not
78    succeed.
79
80  * Do not preserve status information for cm_scache_t objects
81    when the issuing server is multi-homed.
82
83  * Giving up all callbacks when shutting down or suspending
84    the machine is now significantly faster due to the use
85    of an rx_multi implementation.  (This functionality is
86    still off by default and must be activated by a registry
87    value.)
88
89  * Race conditions were possible when updating the state
90    of the cm_volume_t flags and when moving the volumes
91    within the least recently used list.
92
93  * Ensure that the lanahelper library does not perform a
94    NCBRESET of each lan adapter when enumerating the
95    current network bindings.  Correcting this permits OpenAFS
96    to work on Windows 7 when the network adapter settings
97    change.
98
99  * Fix creation of mount points and symlinks as \\AFS\xxxx
100
101
102 Since 1.5.77
103  * Reimplement FetchData and StoreData operations to make
104    use of rx_Writev and rx_Readv which is faster than than
105    multiple calls to rx_Write and rx_Read.  Throughput
106    improvements of up to 20% are possible.
107
108  * Many improvements to the rx rpc stack:
109
110    - RTT measurements
111
112    - Fast recovery is not triggered by packet resend timeouts
113
114    - Socket errors are now detected and reported
115
116    - avoid repetitive memory allocations
117
118    - avoid calling gettimeofday() for every packet
119
120    - reduced dependency on the call->lock
121
122    - When a call receive is completed, ack all of the packets
123      immediately.  Do not wait for the first response packet
124      to be sent.
125
126    - Do not hold the call->lock during rx_Write* and rx_Read*
127      operations when the call fields in use can only be accessed
128      by the application thread.
129
130    - Reduce the default window size from 128 back to 32 because
131      the current overhead from walking packet queues in the rx
132      listener thread significantly hampers the ability to
133      process incoming packets from the network.
134
135    - Only backoff the peer timeout once for a series of naks.
136
137    - Release builds are lean and mean.  All debugging and
138      packet tracking code is disabled.
139
140  * Version number is logged to the Windows Application Event
141    Log as part of the start pending message.
142
143  * MSI installers now backup and restore configuration
144    data during upgrades.
145
146  * Rx pmtu discovery has been disabled by default.  Use
147      HKLM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
148        RxPMTUDiscovery "DWORD"
149    value to re-activate.
150
151  * cm_BkgDaemon event evaluation has been optimized to avoid
152    unnecessary overhead.
153
154  * If a volume is known to be readonly, then locally fail any
155    change request without sending it to the file server.  This
156    avoids triggering the file server's abort threshold.
157
158  * Do not leak cm_volume_t objects from the volume LRU queue.
159
160  * Ensure that cm_NameI errors are acted upon promptly.
161    There are many cases in the SMB server where an error from cm_NameI()
162    was either ignored or not acted upon until several other operations
163    are performed that could result in the same error being repeated.
164    This is a mistake which did not have negative side effects until
165    additional checks for callback status were added recently.
166
167    At present, if a CM_ERROR_ACCESS error is returned and ignored,
168    subsequent attempts to operate on the same cm_scache_t will result
169    in additional queries to the file server that will also end in an
170    abort response.  This can trigger the file server to delay responses
171    to the client.
172
173  * Fix fs mount point and symlink create operations which were
174    failing due to improper directory separator termination.
175
176  * RXAFS_GetVolumeStatus can return VNOVOL, VMOVED, etc.  In
177    order to process them and update volume state a fid must
178    be passed to cm_Analyze().  Use the volume root fid.
179
180  * Negative caching for volume lookups that fail with either
181    VL_NOENT or VL_BADNAME.  The expiration time is five minutes.
182    This prevents volume lookup storms.
183
184  * Provide each volume lookup its own two hour lifetime instead
185    of reseting all volume location information every two hours.
186    This prevents the first smb path evaluation after the volume
187    location data has been discarded from potentially causing an
188    smb client timeout.
189
190 Since 1.5.76
191  * When the SYSTEM account is in use, the SMB connection is
192    not always established as S-1-5-18.  Sometimes it uses an
193    anonymous, S-1-5-7, connection.  In both cases the SMB
194    authentication name is the nul string.  To better identify
195    when an SMB connection is local system, the smb_username_t
196    is now stored as a SID instead of a user name.  When a SID
197    is used, a new flag bit is set SMB_USERNAMEFLAG_SID.
198
199    In smb_SetToken if AFS_PIOCTL_AFSLOGON is set and the user
200    connection is not SYSTEM, the RPC SID is checked.  If RPC
201    SID is SYSTEM, that supercedes the SMB authentication.
202
203  * Replace STATUS_IO_TIMEOUT with RPC_NT_SERVER_TOO_BUSY for
204    CM_ERROR_ALLBUSY.
205
206  * Replace STATUS_PATH_NOT_FOUND with RPC_NT_SERVER_UNAVAILABLE
207    for CM_ERROR_ALLOFFLINE and CM_ERROR_ALLBUSY.
208
209  * Optimize behavior of buf_CleanAsyncLocked().  Avoid searching
210    for the cm_scache_t object by FID if it is already known.
211
212  * If the readonly file attribute is set (stored as a unix mode)
213    then a CreateFile operation should fail if the file is opened
214    for DELETE in combination with any other privilege.
215
216  * If the directory buffer contents are garbage we can crash
217    the service.  Add some simple validation checks to ensure
218    that cm_dirEntry_t objects have the correct flag value and
219    that the name strings are not too long.
220
221  * If the bulkStat errorCode indicates that a particular object
222    is inaccessible due to a VIO error, we must update the server
223    status appropriately in order to permit failover.
224
225  * An RX_MSGSIZE error is returned by the new PMTU detection
226    code.  It is critical that such an error result in a retry of
227    the operation that failed.  Otherwise, the PMTU detection can't
228    work and the server will be marked down.
229    Secondly, it is important that such errors not leak to the
230    application layer.  Map them to CM_ERROR_RETRY in all cases.
231
232  * Translate RX_RESTARTING to the same cache manager error code
233    for all RPC classes.
234
235  * When logging server volume instance errors to the windows
236    application event log, be sure to log the cell as well.
237    Translating from server ip address is non-trivial.  Make it
238    easier for administrators triaging issues to plug the volume
239    and cell info into vos commands.
240
241  * Since unix mode bits are represented in octal in most cases
242    make sure we log them that way.
243
244  * The cm_enforceTrailingDot() function failed if there was a
245    trailing dot followed by white space.
246
247  * Rx: Do not send RX_MSGSIZE if the PMTU size did not change.
248
249 Since 1.5.75
250  * A crash could occur if a single letter share name was
251    dynamically evaluated as matching a cell name.  This was
252    due to a failure to treat the comparison of two nul
253    strings as identical.
254
255  * Docbook validation is performed by xmllint during builds.
256
257  * Volume package bugs in the file server can result in VOFFLINE
258    being returned to the client instead of VNOVOL or VMOVED.  As
259    a result the Unix CM treats VOFFLINE the same as VMOVED and VNOVOL.
260    The Windows client has not.  As a result, bugs in the file server
261    can cause the Windows client to lose if the volume has in fact
262    been moved to another server.
263
264    As part of this change, the volume location list is updated prior
265    to the volume status being applied to the server from which the
266    error was received.
267
268  * If the pages to be flushed are from a readonly or backup volume
269    they can't be dirty.  In this case there is no need to stabilize
270    the pages before they are locked and recycled.
271    Stablilization is performed on the cm_scache_t object so do not
272    stabilize and unstablize for each cm_buf_t object.
273
274  * Over the years the processing of the Freelance callbacks have
275    added functionality that behaves much more like FetchStatus checks
276    to a file server.  If the data version of the object has changed,
277    get the new data.  Given that is the case, we can remove much of
278    the original refresh logic that is rather race prone.   Say goodbye
279    to cm_fakeGettingCallback and cm_fakeDirCallback.
280
281  * When processing a pioctl path with either smb_ParseIoctlPath or
282    smb_ParseIoctlParent, cm_SyncOp(CM_SCACHESYNC_NEEDCALLBACK|GETSTATUS)
283    must be called on the cm_scache_t object to ensure that it is up
284    to date before we permit cm_Lookup or other operations to be performed
285    on it.  Add the cm_SyncOp() call to smb_ParseIoctlPath and
286    smb_ParseIoctlParent to ensure it is done for all pioctl operations.
287
288  * The 32-bit tools installer was displaying client configuration wizard
289    pages.  Since, the 32-bit tools share configuration with the AFS
290    service, the 32-bit tools installer should not be attempting to change
291    client configuration.  Remove said wizard pages from the 32-bit tools
292    installer.
293
294  * cm_data.rootSCachep is a global pointer to the cm_scache_t that
295    represents the root.afs volume root directory.  Throughout the
296    code this cm_scache_t was being used without ensuring that a
297    callback to the volume is in fact valid.
298
299    Under most circumstances this would not be a problem.  However,
300    it is possible for a request to fail due to the lack of a callback
301    at a critical moment.  Add a new function cm_rootScachep() that
302    attempts to ensure that a callback is present (if possible) prior
303    to use the cm_scache_t object.
304
305  * When the contents of the Freelance root directory changes the fake
306    directory buffers are updated and a fakeDirVersion is incremented.
307    The dataVersion of the cm_scache_t object is supposed to be updated
308    on the next access by performing a fake get callback request.
309    Unfortunately, this did not always occur because of a race.  If another
310    Freelance object is updated first, the root directory object would
311    never successfully get a fake callback.
312
313    This patchset ensures that the generation of the fake directory
314    buffer content and the callback are obtained under the same set
315    of locks thereby removing the race.
316
317  * Enforce in afsd_service that tokens can be set for alternate
318    userids only if the SetToken pioctl is called from the
319    Local System account.
320
321 Since 1.5.74
322  * Revise SMB QuerySecurityInfo Response for MS10-020
323
324    MS10-020 (http://support.microsoft.com/kb/980232) has caused
325    many problems for implementors of SMB 1.0 servers and applications
326    that call GetFileSecurity() without checking the return code to
327    determine if the call succeeded.  The gist of the vulnerability
328    was that the SMB redirector would pass any buffer it received
329    to the application regardless of whether or not it was valid.
330    MS10-020 protects the applications by strictly validating the
331    SMB response data structure and the data in the security descriptor
332    that is returned.
333
334    The problem for SMB 1.0 server implementors is that there have
335    been at least three different protocol descriptions for
336    NT_TRANSACT_QUERY_SECURITY_DESC published over the last decade
337    and all of them are incomplete.  Therefore, just about no one but
338    Microsoft has an SMB 1.0 server implementation that produces the
339    exact out that they are expecting to validate.
340
341    The end result is that in an attempt to protect applications from
342    crashing due to invalid input being passed in directly caused
343    dozens of applications to crash by not returning any security
344    descriptor data at all.  Even when the applications didn't crash
345    they might not have been able to save their data.  Cisco WAAS
346    and NetApp DataOnTap systems were most adversely affected and
347    they have had CIFS protocol licenses for many many years.
348
349    To fix OpenAFS here is what needed to be done:
350
351    1. Instead of returning a security descriptor that gives ownership
352       to the NUL SID, give it to the Everyone SID and set the flag
353       that states that everyone has full access.
354
355    2. Validate the input parameters.  In particular, check to ensure
356       that the SMB file descriptor is valid and the file has not
357       been deleted.
358
359    3. Enforce the maximum output data and parameter counts.
360
361    4. Handle buffer overflow and buffertoosmall conditions
362       in the manner that Microsoft expects them to be handled.
363       In particular, note that the parameter data which is returned
364       in the SMB Data Region is not counted in the Data Count.
365       Even if MaxData is 0, we can still return parameters values
366       as long as MaxParm is large enough.
367
368  * Prevent use of AFSCache file contents if mapped to
369    a new address.
370
371  * The Windows version of "fs newcell" did not accept any parameters
372    and behaved quite differently from the Unix version.  Instead of
373    permitting new cell information to be added, the Windows version
374    simply forced the existing cell information to be reacquired.
375
376    This update adds a new pioctl, VIOCNEWCELL2, to support the
377    implementation of a Unix-style "fs newcell".  The functionality
378    added here differs from the Unix version in the following ways:
379
380      1. "fs newcell" with no arguments is still accepted
381         in order to maintain compatibility with prior Windows
382         behavior.
383
384      2. "fs newcell -cell <cell> -dns" instructs the cache manager
385         to add the new cell but obtain the vldb server info from
386         DNS.
387
388      3. "fs newcell -cell <cell> ... -registry" instructs the cache
389         manager to add the new cell and also save the cell configuration
390         data in the registry for use the next time the service restarts.
391
392      4. The -vlport and -fsport options are accepted although the
393         -fsport value is currently unsupported by the cache manager.
394
395  * New registry value "FreelanceImportCellServDB" instructs Freelance
396    to create a mount point for every cell name listed within the
397    CellServDB.
398
399  * Path MTU discovery for Rx is activated.
400
401  * Rx socket input buffer is converted to a circular buffer.
402
403  * Fix usage of cm_FreeServerList().  Do not set the server list
404    pointer to NULL after calling cm_FreeServerList().  Doing so
405    can result in a memory leak.
406
407  * Only enable Rx NAT pings on a single anonymous connection at a
408    time.
409
410  * Fix cm_IoctlSkipQueryOptions() buffer management.  Prevents a
411    potential read beyond end of memory buffer.
412
413  * Reduce requested privileges when reading registry CellServDB
414    to the minimum required.
415
416  * Add support for RPC Pipe Service NetWkstaGetInfo levels
417    101 and 102 which are called on Windows 7 and 2008-R2.
418
419  * Prevent integer overflow during quota percent used calculation
420    in Explorer Shell Extension  (RT 126846)
421
422  * Generate a meaningful error if "fs listacls" or "fs setacls"
423    are executed on the Freelance root.afs volume.
424
425  * RXAFS_InlineBulkStat errors must be processed via cm_Analyze.
426    RXAFS_InlineBulkStatus does not return errors such as EACCES,
427    VNOVOL, VNOVNODE, VOFFLINE, VBUSY, VIO, VMOVED, etc. as an RPC return
428    code.  Instead they are returned in the status info errorCode field
429    for each file.
430
431    Traditionally, the error associated with the first FID in the query
432    list has been returned to the caller of cm_TryBulkStatRPC().
433    However, the error has never been processed through cm_Analyze()
434    which means that the per-vnode processing for VNOVNODE and the volume
435    global processing for VMOVED, VNOVOL, etc. has never been performed.
436    As a result, failover to other .readonly volume instances cannot occur,
437    volume moves will not be handled, and files that have been deleted
438    are not detected.
439
440    This patchset makes the following changes:
441
442    1. If an inline bulk operation has been performed and the inline
443       errorCode is a volume global error, then that error replaces
444       the RPC return code within the cm_Analyze() processing for
445       the RPC.  This will affect whether or not a retry operation
446       is performed.
447
448    2. The variable 'inlinebulk' is reset to 0 at the top of the
449       cm_Analyze() loop in case failover from an inlinebulk capable
450       file to an inlinebulk incapable file server takes place.
451
452    3. The FID that is passed into cm_Analyze() is not a real fid.
453       Instead it consists of the cell and volume but vnode = 0.
454       This ensures that the error (if any) is not applied to the
455       directory object.
456
457    4. If an inline bulk operation was performed, prior to performing
458       the cm_MergeStatus() operation a vnode a check is made to
459       determine if an error was returned for that vnode.  If so,
460       cm_Analyze() is called with no connection, a fake cm_req_t,
461       the fid, and the error.  This permits cm_Analyze() processing
462       to be performed on the file.  
463
464  * Show configuration pages for all types of MSI installations
465
466    The OpenAFS MSI installer wizard used to not show any configuration
467    pages for "Typical" and "Complete" installations.  Setting the
468    workstation cell and logon options during installation required
469    selecting the "Custom" option.  Many users choose the "Typical" option
470    during installation, and thus would never see the configuration pages.
471    Therefore, for these users, the workstation cell was being set to the
472    default.
473
474    This patch makes the workstation cell and logon option configuration
475    pages visible to all types of installations (except silent
476    installations which show no UI).
477
478  * cm_LookupInternal creates Freelance mount points and symlinks
479    when queries cannot be found in the Freelance root.afs directory.
480    If the search name is a full cell name for which vldb information
481    can be obtained, then a mount point is added.  If the search name
482    is a left-most substring or the full cell name with a dot appended
483    to it, then a symlink was created.  This approach created a very
484    poluted Freelance name space.
485
486    This patchset makes the following changes:
487
488     1. Do not create symlinks with a dot appended to the cellname
489
490     2. Do not create symlinks where the left-most substring is not
491        a full dot separated component of the cellname.
492
493     3. Permit lookups to succeed when we would have created a
494        symlink in the past without creating the symlink.
495
496  * BPlus tree lookups are much faster than searching through
497    the native directory format on Windows because the case sensitive
498    hash tables cannot be used successfully.  Permit BPlus trees
499    to be used except when called with cm_BPlusDirFoo as the action
500    function because cm_BPlusDirFoo is used to build the BPlus trees
501    from the native directory format.
502
503  * Symlinks are ending up in the Freelance root.afs directory that
504    end with a dot.  Make sure it cannot happen.
505
506  * cm_FreelanceAddMount and cm_FreelanceAddSymlink is supposed to
507    return the allocated FID of the entry that was added.  However,
508    cm_NameI is called to perform the lookup without forcing an update
509    of the Freelance fake directory.  As a result the entry may not be
510    found.
511
512    Force an update prior to calling cm_NameI() by using
513    cm_clearLocalMountPointChange() and cm_reInitLocalMountPoints()
514    if required.
515
516  * The Freelance fake root directory buffers were not zero-filled.
517    This results in random behavior that can cause the service to
518    terminate unexpectedly.
519
520  * The validation check for the response from the GetVolumeStatus
521    pioctl is incorrect.  The response is not simply a VolumeStatus
522    structure but also several C strings appended to it.
523
524  * When flushing a file, we need to commit the file length changes
525    as well as the dirty buffers.  Call cm_FSync instead of buf_CleanVnode
526    which is called by cm_FSync.
527
528  * Prevent rx_rpc_stats global lock from being a bottleneck in the
529    Rx library.
530
531 Since 1.5.73
532
533  * Avoid a race when updating cell vldb server lists
534    that can result in a crash.
535
536  * Avoid a deadlock when managing CM_SCACHESYNC_STOREDATA
537    state operations for directory objects.
538
539  * Add new Windows Application Event log messages for
540    VBUSY, VRESTARTING, ALL_BUSY, ALL_OFFLINE, and ALL_DOWN.
541    Include message throttling to prevent the same message
542    from being logged repeatedly within a five second window.
543
544  * Reduce lock contention by waiting for cm_buf_t I/O
545    operations to complete before permitting cm_SetupStoreBIOD
546    to analyze a buffer for inclusion in a BIOD.
547
548  * Split the cm_buf_t flags field to separate the flags
549    that are protected by the cm_buf_t mutex from those
550    protected by the buf_globalLock.  This eliminates the need
551    to hold both locks everytime the flags field is accessed.
552    Both locks were not held in the past resulting in race
553    conditions that could result in deadlocks.
554
555  * Add "vos setaddrs" command.
556
557  * Rx library lock contention avoidance between rx_NewCall and
558    rx_EndCall.
559
560  * Rx library races due to inconsistent use of rx_connection
561    conn_data_lock to protect the flags field.
562
563  * Rx library inconsistent use of RX_CALL_TQ_WAIT which could
564    result in deadlocks.
565
566  * Rx library must signal transmit queue waiters when flushing.
567    Otherwise, deadlocks can occur.
568
569  * In cm_UpdateVolumeLocation, avoid searching for a ".readonly"
570    volume on a numeric volume name.
571
572  * File buffer allocations whose offsets are beyond server EOF
573    should be locally allocated and zero filled.  The file server
574    should not be issued a FetchData rpc which is guaranteed to
575    fail.
576
577  * Enable integrated logon to work with Windows 7/2008 when
578    user logons are performed with a non-Domain Kerberos principal.
579
580  * Add Protection Error messages to aklog output.
581
582 Since 1.5.72
583
584  * Prevent the Explorer Shell extension from crashing if
585    symlink creation failed.  (126406)
586
587  * A Rx level NAT ping has been implemented.
588    Add NatPingInterval registry value to
589      HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
590    to permit Nat Ping to be enabled.  The default value is 0 seconds.
591
592  * When a re-initialization is taking place, be sure to reset
593    cm_noLocalMountPoints to 0 in case someone deletes the "Freelance"
594    registry key out from underneath the service.
595
596  * Add krb5 error message translation to aklog, afscreds,
597    afslogon.dll, the network identity manager afs provider
598    and translate_et.
599
600  * Mode bits aren't directly exposed by the Win32 API. We were leaving
601    them to default to 0777 when creating new files and directories.
602    This version introduces two configuration parameters;
603    'UnixModeFileDefault' and 'UnixModeDirDefault' which are DWORD
604    registry entries that are used to set the initial mode bits.
605    If the values are set to 0, then the behavior is identical to what we
606    had before.
607
608  * Minidump files are now produced with a timestamp appended
609    to the name.
610
611  * An SMB request debugging monitor has been added.  When activated
612    the monitor will automatically turn on trace logging if any SMB
613    request has required longer than 60 seconds to complete and will
614    then create a minidump every 60 seconds thereafter until the
615    request completes.
616
617 Since 1.5.71
618
619  * Restore use of DNS AFSDB and SRV records by kaserver clients.
620
621 Since 1.5.70
622
623  * Avoid a potential Freelance deadlock during initial execution 
624    of afsd_service.exe if the old ini file data has to be
625    imported.
626
627  * Three rx library corrections.  (1) Idle data connection
628    processing could timeout if the send window filled and
629    took longer than the idle data timeout period for the
630    transmit window to re-open.  (2) The transmit queue
631    could be emptied prematurely.  A required check for the
632    queue being in use was forgotten.  (3) The function that
633    is supposed to implement a wait for the transmit queue
634    to cease being busy failed to wait.
635
636 Since 1.5.69
637  * Restore use of DNS AFSDB and SRV records which were
638    unintentionally disabled in 1.5.69
639
640 Since 1.5.68
641  * Add a context menu to the NetIdMgr AFS Provider 
642    notification icon.
643
644  * Prevent an empty directory Btree from being created and
645    marked as valid if cm_BPlusDirBuildTree fails.
646
647  * cm_BPlusEnumAlloc should not fail if the enumeration
648    contains zero entries.
649
650  * In cm_BPlusXXX functions, return ENOMEM if malloc() fails.
651
652  * Do not leak the cm_scache_t dirlock if cm_BPlusDirBuildTree
653    fails.
654
655  * fs examine should report owner and group ids as signed values.
656
657  * Protect buffers in smb_WriteData from simultaneous writes.
658
659  * Query network interface MTU values from the registry because
660    the IP Helper GetAdapterAddresses() fails to report a manually
661    configured MTU.
662
663  * Improve performance by not dropping and reacquiring the rx_call
664    lock in rx_WriteProc* and rx_ReadProc*.
665
666  * When configuring the rx library, the network interface MTU
667    must be applied to both the maximum send size as well as the
668    maximum receive size as is done when rx_SetMaxMTU is called
669    by the application.
670
671 There was no 1.5.67 release
672
673 Since 1.5.66
674  * Convert afsauthent.dll to use the xdr_alloc and xdr_free
675    routines from afsrpc.dll in place of malloc and free.
676    This permits the two libraries to be built with different
677    C runtime libraries without crashing.
678
679  * Set the DOS Readonly attribute on a file/directory 
680    whenever the unix mode combined with the mask 0200 
681    is true.  Previously there was a discrepency between
682    the mask used for testing for readonly behavior and
683    that used for setting the attribute.
684
685  * Disable AFSVolSync based .readonly "whole-volume callback"
686    support because the all file servers prior to 1.5.67
687    (and perhaps 1.4.12) do not properly assign a value to
688    the AFSVolSync structure in bulk status RPC responses.
689
690  * Improve the error output from aklog to output the value
691    from krb5 error_message() if the afs_com_err output
692    indicates an unknown value.
693
694  * Hold a lock on the cm_scache_t object when the smb
695    server is assigning a new clientModTime value.
696
697  * Permit custom build version numbers to be set
698    without modifying the src/config/NTMakefile.<platform>
699    files.
700
701  * Add support for binary code signing with cross-signed
702    certificates and arbitrary versions of signtool.exe.
703
704  * Convert VBUSY and VRESTARTING to CM_ERROR_ALLBUSY and
705    do not permit them to be exposed to the smb redirector.
706
707  * Convert STATUS_TIMEOUT responses to STATUS_IO_TIMEOUT
708    to avoid confusion within the smb redirector.
709
710  * Fix the byte order assigned to port numbers associated
711    with AFSDB record lookups.  They must be network byte 
712    order not host byte order.
713
714  * Add dynamic server ranking based on RPC round trip
715    time measurements.
716
717 Since 1.5.65
718  * Official support for Windows 7 and Server 2008 R2
719
720  * Improved Rx RTT computation following the lessons
721    learned by TCP.
722
723  * Prevent a file server bug (FetchData returning an
724    invalid length instead of zero) from causing an
725    "unexpected network error" when writing to files.
726
727  * Promote DNS SRV records as superior to DNS AFSDB
728    records.  Support arbitrary port numbers for vldb
729    servers.
730
731  * Add "fs listacl -cmd" support.
732
733  * Add AFSVolSync based .readonly "whole-volume callback"
734    support.  With this functionality, multiple objects from
735    a .readonly volume can have their status validated by
736    issuing a single RXAFS_FetchStatus RPC.
737
738  * Remove drive mapping functionality and service start/stop
739    from afscreds.exe.
740
741  * Remove drive mapping functionality from afs_config.exe.
742
743  * Adjust SMB error return codes to avoid returning 
744    STATUS_TIMEOUT which results in the SMB redirector
745    disconnecting.
746
747  * Network Identity Manager OpenAFS Provider now provides its
748    own "AFS lock" notification icon to report the status of
749    "have tokens, have no tokens, service not started, service
750    started but inaccessible".  Hovering over the icon lists the
751    cells for which tokens exist (if any) and the OpenAFS version
752    number.  Double-clicking executes the Network Identity Manager
753    default action.
754
755  * When merging the current status for an AFS object, ensure
756    that the volume status for that object is set to 'vl_online'.
757
758  * Permit cm_Analyze to request a retry even when the cm_req_t is
759    flagged CM_REQ_NORETRY if the RPC failed due to RX_CALL_DEAD.
760    The retry will force the use of a new connection.
761
762  * Add digital signatures to resource only dlls as required by
763    Windows 7.
764
765  * Prevent pioctl calls from retrying indefinitely when a sharing
766    violation error occurs.
767
768  * Add {HKLM,HKCU}\SOFTWARE\OpenAFS\Client  DWORD  "ShowMountTab"
769    to restore access to drive mapping functionality in afscreds.exe
770    and afs_config.exe.
771
772  * Permit Rx minimum peer timeout, maximum receive window size and
773    maximum send window size to be configured via the registry.
774
775  * The MSI installer now sets the ARPINSTALLLOCATION as required by
776    Windows 7.
777
778  * DNS lookups set the port numbers in network byte order within
779    the cache manager.
780
781  * Replace use of the 16-bit compatibility API WinExec with
782    ShellExecuteEx in afs_config.exe and afscreds.exe.  WinExec
783    is incompatible with Windows 7 / Server 2008 R2 UAC 
784    functionality.
785
786 Since 1.5.64
787  * Short circuit background volume checks if a shutdown
788    or suspend request is received.
789
790  * Avoid contacting the file server in order to allocate
791    an empty buffer beyond the current length of the file.
792
793  * When a request for streams on a directory or mount 
794    point object is received, do not offer a default stream.
795    This was affecting the saving of roaming profiles.
796
797 Since 1.5.63
798  * Fix Windows 2000 compatibility.  Do not call rand_s() 
799    even if it is compatible with the C run time library
800    version.
801
802  * Fix a data consistency error between the output of 
803    NetWkstaGetInfo and NetServerGetInfo RPCs, specify the Lan 
804    workstation group name "AFS", and report server name as 
805    "AFS" instead of "\\AFS" when the caller asks for "\\AFS".
806
807  * Enable executables to be run from \\AFS on Windows 7.  
808    Return "Name not found" instead of "File not found" when 
809    a directory or file name cannot be found.
810
811  * Prevent cache manager from marking file server "down" when 
812    the data returned in response to either RXAFS_FetchData64 
813    or RXAFS_StoreData64 is invalid.
814
815  * Add pioctl data validation to the AFS Explorer Shell extension.
816
817 Since 1.5.62
818  * After 1.5.62 afslogon.dll would no longer crash but it 
819    also would not load "domain" specific configurations.
820    Fixed.
821
822  * An uninitialized variable was present in the symlink
823    recursion detection loop.
824
825  * Reverse addition of unique per file GUID during 
826    Create/Open responses. Inclusion of the GUID prevents 
827    Cygwin applications (and others) from accessing //afs.
828
829  * Treat "filename::$DATA" as a synonym for "filename".  
830    This addresses the recent report of roaming profiles 
831    failing to save back to the file server.
832
833  * When given a choice between an error from rx_Write() 
834    or RXAFS_EndStoreData(), use the rx_Write() error.  
835    This ensures that over quota and access denied errors 
836    are acted upon.
837
838  * If an error occurs during RXAFS_StoreData operations, 
839    apply that error to all of the buffers in the BIOD. 
840    This ensures that failures will not be retried if they 
841    will only fail again.
842
843  * Do not perform a DNS lookup for a cellname if the 
844    cellname prefix is _._AFS_IOCTL_._.  This will avoid 
845    DNS lookups when the query is for 
846    _._AFS_IOCTL_._.F7E5F580200909010061TTTTNT7TT.{10E39A49-4531-4496-A08E-842D4C440D20}.
847
848  * Fix Freelance root.afs volume object callback processing.  
849    Object synchronization and status merging bugs.
850
851  * Fix Explorer Shell "invalid parameter" bug introduced 
852    in 1.5.62.
853
854  * Log RXKAD errors to the trace log.
855
856  * Prevent simultaneous pioctl calls from multiple processes 
857    from stepping on each other's data.
858
859  * Prevent simultaneous pioctl calls from crashing the 
860    afsd_service.
861
862  * Add data validation to pioctl output processing in 
863    ktc_GetToken and ktc_ListTokens.
864
865  * Add data validation to pioctl output processing in 
866    fs.exe and symlink.exe.
867
868 Since 1.5.61
869  * IMPORTANT: New support for DCE RPC Services: SRVSVC and WKSSVC.
870    No longer will browsing \\AFS produce truncated share names.
871
872  * Registry specified server preferences did not result in
873    the CM_SERVERFLAG_PREF_SET flag being applied to the
874    cm_server_t object.  
875
876  * Avoid unnecessary DNS lookups of share names as cells
877    when it is known that the name cannot be a cell name.
878    Any name that does not contain a dot is skipped.
879
880  * When processing Dfs Referral requests, do not return an
881    error if the server is down or busy; if the volume is
882    offline; the cell vldb cannot be reached; etc.
883    These paths are still \\AFS paths and so the client 
884    should not be sent to search elsewhere for resolution.
885
886  * CRITICAL: Prevent the cm_Daemon thread from terminating when
887    the machine enters the suspend state.  IF the cm_Daemon thread
888    dies, there is nothing to execute down server checks.
889
890  * Prevent use of smb_StartedLock before initialization which
891    can result in a panic in the lock package.
892
893  * Improve error checking in afslogon.dll in order to prevent
894    NULL pointer dereferences within GetLogonDomainOptions()
895    if the Lsa operations fail.
896
897  * Add support to the build system to automatically update
898    a Microsoft Symbol Store.
899
900  * Do not access the cm_conn_t after executing the cm_Analyze
901    loops.  Doing so can result in an access to memory that has
902    been freed.
903
904  * CRITICAL: If a StoreData request offset is not aligned on the 
905    buffer module blockSize, (offset % blockSize) bytes of dirty
906    data will not be written to the file server.
907
908  * CRITICAL: If a StoreData64 request is sent to a file server
909    that does not support large files (>2GB) and the client is 
910    unaware that the server has no large file support, the first 
911    chunksize worth of data will not be written to the file server.
912    This bug was introduced in 1.5.3.   It affects all IBM AFS file
913    servers and all OpenAFS file servers older than 1.4.0.
914
915 Since 1.5.60
916  * If a file server becomes inaccessible while the cache manager has 
917    dirty buffers to write, the afsd_service buf_IncrSync thread can 
918    attempt to use 100% of the cpu.
919
920  * Fix the locking that protects the cm_cell_t lists 
921    (all, name, id, free).
922
923  * Remove cm_cell_t objects from the name and id hash tables before 
924    placing them on the free list.
925
926  * Fix "fs newcell" which was broken in 1.5.60.
927
928  * Do not attempt to synchronize dirty buffers if the associated 
929    volume is known to be unavailable.
930
931  * Log to the Windows Event Log dirty buffers that cannot be written 
932    during the shutdown process.
933
934  * Modify behavior of a Freelance mountpoint target that does not 
935    specify a cell.  Instead of assuming the target volume is in the 
936    Freelance.Local cell, use the workstation "Cell" specified in the 
937    registry. A mountpoint target of "#root.cell." will now mean the 
938    root.cell volume in the workstation cell for the current session.  
939    If the workstation cell changes from "athena.mit.edu" to 
940    "andrew.cmu.edu", the referenced volume will also change without 
941    requiring that the mount point targets be altered.
942
943  * Avoid false infinite loop errors when validating the cm_cell_t 
944    free list during startup.
945
946  * Fix two more locations where xdr_free() should be used instead of 
947    free() to permit a checked built of afsd_service.exe to work with 
948    release builds of afsrpc.dll.
949
950  * Add cm_FindServerByUuid().  Re-implement RXAFS_InitCallBackState3() 
951    to permit the server Uuid to be used to lookup the server object 
952    and from that determine the cell.  This permits callbacks that are 
953    received from alternate addresses to be processed with a known server 
954    object.  Previously a request from an unknown server would clear all 
955    callbacks from all cells.
956
957  * Fix a bug that prevented optimal performance when using a non-zero 
958    value for 'daemonCheckVolCBInterval'.  As a reminder, when 
959    "daemonCheckVolCBInterval" is set to a non-zero value, all .readonly 
960    volume callbacks are automatically renewed 90 minutes before their 
961    expiration.
962
963  * Fix automatic ranking of vldb servers whose values are obtained from 
964    the CellServDB file.
965
966  * Add logging for RX CALL DEAD errors which are generated if the remote 
967    host is unreachable.
968
969  * Add failover for RX CALL TIMEOUT errors when the volume is readonly 
970    or the call is to a vldb server.
971
972  * Add registry based cell search functionality to NetIdMgr, 
973    afs_config.exe, and klog.exe.
974
975  * afsconf_GetCellInfo() has been modified to perform gethostbyname() 
976    lookups on the host names in the CellServDB instead of using the 
977    specified IP addresses.  This provides aklog, pts, vos, etc. the same 
978    CellServDB behavior that the Windows Cache Manager uses.
979
980  * Completely a behind the scenes change.  The snprintf() routines have 
981    been completely rewritten.
982
983  * When updating the stat cache entry callback of a .readonly object 
984    from the volume group object, update the file server reference to 
985    ensure it matches the most update to date callback.
986
987  * Add proper support for processing callbacks from multi-homed file 
988    servers.  Instead of comparing servers by cm_server_t pointer, 
989    compare them by UUID when the UUID is known.
990
991  * During a shutdown short circuit the offline volume check daemon 
992    functionality.
993
994  * Properly track link counts during cm_Link and cm_Unlink operations.
995
996  * Return the error code of RXAFS_FetchData / RXAFS_StoreData in 
997    preference to an error code reported by rx_EndCall.
998
999  * Add "PerFileAccessCheck" registry value to permit testing against 
1000    experimental file servers that include per-file acl support.  This 
1001    value is intentionally undocumented.  It is not to be used by
1002    production environment deployments.
1003
1004  * Log a warning to trace log if a volume group is marked as a DFS 
1005    File Set.  The Windows OpenAFS client does not include DFS support.
1006
1007  * Fix a bug introduced in 1.5.60 that prevents the afs netidmgr 
1008    provider from obtaining tokens when referrals are in play.
1009
1010  * Add "fs chown" and "fs chgrp" commands to permit the owner and 
1011    group of objects stored in AFS to be set from Windows.
1012
1013  * Avoid performing background daemon operations when the machine is 
1014    going into suspend mode.
1015
1016  * Perform offline volume checks in most recently used order.
1017
1018  * Prevent crash when a data version for a cache object goes backwards.
1019
1020  * fs setquota, fs setcachesize, vos setfields, and vos create now 
1021    accept human readable orders of magnitude. (K, M, G)
1022
1023  * fs listquota fixed to permit large quota sizes to be displayed.
1024
1025  * rx packet resend and data packets sent counts were incorrect.
1026
1027  * Multi-thread safe library versions are now being generated and used.  
1028    mtafsubik.lib, mtafsutil.lib, mtafsvldb.lib, mtafsvol.lib.
1029
1030  * Microsoft SMB Redirector (mrxsmb.sys) support for ExtendedSessTimeout
1031    values are now available on XP through Windows 7.  Add functionality
1032    to autodetect if such support is present on the machine.  If so,
1033    configure it if necessary and dynamically adjust the AFS Rx timeout
1034    values accordingly.
1035
1036  * Correct another race condition in the Rx library that could result
1037    in an unexpected panic while freeing the Rx call iovq.
1038
1039 Since 1.5.59
1040  * A fix to the pioctl library to support drive substitution 
1041    to UNC paths.  (SUBST <d:> <\\afs\cell\path>).
1042
1043  * On April 9th Microsoft released a Hot Fix for Windows Server 2003 SP2 
1044    that corrects a deadlock in the smb redirector and also adds new 
1045    functionality that permits the AFS SMB server to be given a longer 
1046    timeout than is normally the case.  New functionality has been added 
1047    to configure these additional LanmanWorkstation\Parameter values.
1048    (This functionality has been backported to XP SP3 and is scheduled
1049    to be released on June 5th.)
1050    
1051  * The BackConnectionHostNames registry value configuration was broken 
1052    when dynamic re-establishment of Netbios Name registrations was added.
1053    Restore it.
1054
1055  * Hidden vos commands are revealed.
1056
1057  * If the "DisableLoopbackCheck" registry value is set, do not unset 
1058    it during the same service session.
1059
1060  * Reorganize code that prevents multiple Store operations to the same 
1061    File.
1062
1063  * Modify IsPathInAfs test in Explorer Shell Extension and fs.exe to 
1064    permit broken symlinks to be treated as being in AFS.
1065
1066  * Fix vos commands that output 64-bit integer values.
1067
1068  * Cygwin Import Libraries are provided in the SDK for all OpenAFS DLLs.
1069    Permits building cygwin applications against OpenAFS libraries. 
1070
1071  * OpenAFS Release Notes, Administrator Guide and User Guide now installed 
1072    as Windows HTML Help (.CHM) files.  
1073
1074  * NSIS installer does a much better job of cleaning up files left 
1075    over from previous installs.
1076
1077  * Fix RT#124787, a race condition between "fs flush <dir>", "fs flushvolume", 
1078    or "fs flushall" and on-going directory operations that can result in 
1079    afsd_service.exe crashing.
1080
1081  * Add support for DNS SRV records in place of AFSDB records.  
1082    _afs3-vlserver._udp.<cellname>.  Priority field is used.  
1083    Weight is currently ignored.
1084
1085  * Add a method of specifying Client CellServDB information within the 
1086    registry that can be used to either override the CellServDB file or 
1087    force the use of DNS lookups for a given cell.
1088
1089    The registry schema is as follows:
1090
1091      HKLM\SOFTWARE\OpenAFS\{Client,Server}\CellServDB\[cellname]\
1092        "LinkedCell" REG_SZ "[cellname]"
1093        "Description" REG_SZ "[comment]"
1094        "ForceDNS" DWORD {0,1}
1095
1096      HKLM\SOFTWARE\OpenAFS\{Client,Server}\CellServDB\[cellname]\[servername]\
1097        "HostName" REG_SZ "[hostname]"  Default: [servername]
1098        "IPv4Address" REG_SZ "[address]"  Used only if gethostbyname() fails.
1099        "IPv6Address" REG_SZ "[address]" <future>
1100        "Comment" REG_SZ "[comment]"
1101        "Rank" DWORD "0..65535"  Default: 0
1102        "Clone" DWORD "{0,1}" <future: server only>
1103        "vlserver" DWORD "7003" <future>
1104        "ptserver" DWORD ... <future>
1105
1106    ForceDNS is implied non-zero if there are no [servername]
1107    keys under the [cellname] key. Otherwise, ForceDNS is zero.
1108    If [servername] keys are specified and none of them evaluate
1109    to a valid server configuration, the return code is success.
1110    This prevents failover to the CellServDB file or DNS.
1111    
1112    Only one of "HostName" or "IPv4Address" is required.  "HostName"
1113    is optional if [servername] is the host name.
1114
1115  * Extend registry based CellServDB functionality to 
1116    afsconf_GetCellInfo() interface used by aklog and many 
1117    other command line utilities.
1118
1119  * libafsconf.dll moved from OpenAFS\Client\Program to OpenAFS\Common
1120    as it is now used by both client and server components.
1121
1122 Since 1.5.58
1123  * PriorityClass of afsd_service.exe process raised to 
1124    "High" to match the priority of the system services 
1125    that are waiting for afsd_service.exe to respond.
1126    Configurable using [TransarcAFSDaemon\Parameters]
1127    DWORD "PriorityClass" value.  (use values from Win32
1128    API)
1129
1130  * Change error reporting of CM_ERROR_BADSHARENAME to
1131    use the correct error (NTSTATUS_BAD_NETWORK_PATH).
1132    The error we were sending would cause the smb 
1133    redirector to drop the connection.
1134
1135  * Change the error reporting of CM_ERROR_ALLOFFLINE
1136    and CM_ERROR_ALLDOWN to return NTSTATUS_PATH_NOT_FOUND.
1137    Previous we would return Bad Network Path which 
1138    would cause the smb redirector to cancel all file
1139    handles on the same "share".
1140
1141  * A debug version of afsd_service.exe can now be used
1142    with a release version of afsrpc.dll (or vice versa).
1143    afsrpc.dll now implements and exports xdr_free().
1144
1145  * Removed all unprotected OutputDebugString() calls as
1146    those calls can block for up to 10 seconds if there 
1147    is contention for the globally shared memory or if
1148    the debugger fails to read data in a timely manner.
1149
1150  * Visual Studio 2008, WDK 6.1 and DDK 6.1 are now 
1151    supported for builds.  The production releases still
1152    use VS 2005.
1153
1154 Since 1.5.57
1155  * Discovered that XP/2003 supports a variant on recvmsg 
1156    called WSARecvMsg.  The input parameters are mostly 
1157    compatible with the Posix recvmsg.  This will save 
1158    multiple memcpy() calls per received packet.
1159
1160  * Discovered that Vista/2008 supports a variant on 
1161    sendmsg called WSASendMsg.  The input parameters 
1162    are mostly compatible with the Posix sendmsg.  This 
1163    will save multiple memcpy() calls per sent packet.
1164
1165  * Exporting rx_ReadProc32, rx_WriteProc32 from afsrpc.dll 
1166    and utilizing rx_ReadProc32 from within the cache manager 
1167    as part of the FetchData operations.  rx_ReadProc32 and 
1168    rx_WriteProc32 are optimized versions of rx_ReadProc and 
1169    rx_WriteProc for use when reading 32-bit integer values.
1170
1171  * The Network Identity Manager AFS provider now reports 
1172    progress events.  These provide a better user experience 
1173    with Network Identity Manager 2.0.
1174
1175  * [RT 124293] A race condition exists which permits the 
1176    scp field of the an smb_fid_t object to become invalid 
1177    after a request on the smb_fid_t has begun.  Remove the 
1178    race by protecting all access to the scp field with the 
1179    smb_fid_t mx mutex and obtaining a local reference on 
1180    the cm_scache_t object for the length of the request.
1181
1182  * [RT 124276] If the vldb is out of sync with the contents 
1183    of the file servers, afsd_service will retry too many 
1184    times when a file server reports a volume as not being 
1185    present.  Now if the list reported by the vldb is the 
1186    same as the previously seen list, then the retry is 
1187    aborted.
1188
1189  * [RT 124276] Read-only volume failover was broken in 
1190    1.5.53 whenever accessing a volume results in VNOVOL or 
1191    VMOVED.
1192
1193  * [RT 124276] Prior to 1.3.70 the volume server reference 
1194    list was not reference counted and would be prematurely 
1195    freed while in use.  When reference counting was added 
1196    in 1.3.70 a bug was introduced that could result in 
1197    service reference list corruption.
1198
1199  * Add Windows Application Event Log warning messages for 
1200    "Client SMB MPX value too large" and 
1201    "Client SMB Buffer Size too small".
1202
1203  * Renaming of files across directory boundaries would result 
1204    in an invalid handle error when attempting to access the 
1205    files after the move.
1206
1207  * Fix the handling of Tran2 Set Path Info RPCs.  Do not fail 
1208    when a smb file descriptor cannot be found.  The whole point 
1209    of using a Path Info function is because an smb file 
1210    descriptor wasn't allocated.
1211
1212  * More edge cases in which dynamic addition of Freelance 
1213    root.afs entries would get the wrong FID or where the 
1214    root.afs directory would not be refreshed.
1215
1216  * Buffer overflow could occur if the workstation cell name was 
1217    longer than 64 characters.  Crashes could occur in 
1218    afscreds.exe, afslogon.dll, and afsd_service.exe.
1219
1220  * VNOSERVICE and VOFFLINE errors were leaking and were exposed 
1221    to the smb client.
1222
1223  * Improve consistency of the bad data version value used for 
1224    cm_scache fields.
1225
1226  * Log file server uuid values as part of the cm_server object 
1227    when available.  Dump the cm_server object list in response 
1228    to "fs memdump".
1229
1230  * Optimize the performance of resetting access control lists 
1231    when tokens are set or removed.
1232
1233  * Fix vos.exe so that it can work with very large volume 
1234    identifiers
1235
1236  * Remove symlink recursion tests and increase max symlink count 
1237    to 64 from 16.
1238
1239 Since 1.5.56
1240  * Undo the "UAC manifest fix" applied to afs_config.exe.
1241
1242  * Fixed some additional race conditions in the Rx library
1243
1244  * Ensure that Freelance allocation of vnodes follow 
1245    the AFS convention of odd vnodes are directories 
1246    and everything else is an even vnode.
1247
1248  * Add Freelance logic to mount point and symlink 
1249    evaluation functions.
1250
1251  * Enhance smb_ParseASCIIBlock() so that it can handle
1252    all of the STRING formats defined by the CIFS Technical
1253    Report 1.0.  
1254
1255  * Validate the output of smb_ParseASCIIBlock() in all
1256    callers.  Return CM_ERROR_BADSMB if the STRING field
1257    cannot be parsed.  CM_ERROR_BADSMB will cause the
1258    contents of the packet to be logged.
1259
1260  * If multiple SMB Raw Write operations were taking 
1261    place at the same time, there could be data corruption
1262    because unique event objects were not generated for 
1263    each Netbios receive operation.
1264
1265 Since 1.5.55
1266
1267  * Fix a race in rxi_WriteProc which could result
1268    in a freed or in use packet being passed to 
1269    rxi_PrepareSendPacket if the call is currently
1270    in a transmit wait state.  Passing a freed packet
1271    will result in a panic.  Passing an in use packet
1272    might result in a call failure or perhaps data
1273    corruption.
1274
1275  * Kerberos referrals broke the NIM AFS provider 
1276    logic for automated configuration of the workstation
1277    cell with a new identity.  Now if a referrals 
1278    response is returned, assume the cell belongs to the
1279    new identify.
1280
1281  * The interface to buf_CleanAsync() and 
1282    buf_CleanAsyncLocked() has been changed to permit 
1283    errors to be propagated to the caller.  
1284
1285  * During an enumeration of a directory, if the btree
1286    has not yet been generated, return an error.
1287
1288  * When mapping CM_ERROR values to NTSTATUS values
1289    do not treat 0 as an error.
1290
1291  * Avoid a cm_scache_t object reference count underflow
1292    when renaming via the SMB interface.
1293
1294  * smb_IsMask() can be called with a non-8.3 input buffer.
1295    Separate smb_IsMask() into smb_Is8Dot3Mask() for 8.3
1296    input buffers and smb_IsMask() for non-8.3 input buffers.
1297
1298  * Add cm_buf_t error state to the "fs memdump" output.
1299
1300  * pioctl drive mapping checks need to take into account
1301    Global Drive Mappings and SUBST assignments.
1302
1303  * Rename operations should not be permitted if the 
1304    destination name collides with an existing name that
1305    differs only by case UNLESS the collision is the object
1306    that is being renamed.
1307
1308  * Increase the maximum number of background daemon threads
1309    to 64.  Leave the default at 4.
1310
1311  * Set the FILE_UNICODE_ON_DISK flag when reporting the 
1312    file system characteristics.
1313
1314  * Report the maximum component name length as 255 even
1315    for Unicode as part of the file system characteristics.
1316
1317  * Add RX debugging information to "fs memdump" output
1318    in checked builds.
1319
1320  * Refcount the cm_server_t objects returned by
1321    cm_FindServerByIP()
1322
1323  * Fix the UAC manifest applied to afs_config.exe
1324
1325  * rxdebug now indicates if any RX_CONN flag is set
1326    not just some of them
1327
1328  * Change the mapping of CM_ERROR_WOULDBLOCK from 
1329    NTSTATUS_LOCK_NOT_GRANTED to NTSTATUS_CANT_WAIT
1330
1331 Since 1.5.54
1332
1333  * Includes #GCO Public CellServDB 07 Nov 2008
1334
1335  * Prevent separate cell entries from being created for
1336    "foobar.org" and "foobar.org." which can happen if
1337    an AFSDB record is found instead of a CellServDB 
1338    record.
1339
1340  * Fix a panic when checking the SMB virtual circuit list.  
1341    If a VC is destroyed while the list is being checked 
1342    it is possible for the next object to become invalid.
1343
1344  * Increased logging to afsd_init.log of netbios name 
1345    related errors.
1346
1347  * Fix a DNLC panic when a UTF-16 string that cannot be 
1348    converted to a utf-8 string is provided as a filename.
1349
1350  * In the NSIS installer, delete old afslogon.dll/afscpcc.exe 
1351    from %windir%\system32 and fix the WinLogon\Notify\AfsLogon 
1352    location to refer directly to the new location in 
1353    %programfiles%\openafs\client\program
1354
1355  * Be more aggressive about responding to Netbios 
1356    NRC_BRIDGE/NRC_NOWILD errors.  Rebind the Netbios name to 
1357    the LANA within the listener thread without performing a 
1358    delete and reset.
1359
1360  * Use the WNet Enumeration of all connected drives as a filter 
1361    in the pioctl GetIoctlHandle operation.  This should remove 
1362    the last situations in which there was a delay when opening 
1363    an Explorer Shell properties menu with the AFS Shell 
1364    Extension.
1365
1366  * Fix the parsing of CellServDB in Windows to handle linked 
1367    cells as is done on Unix.
1368
1369  * Add support for linked cells to the cache manager,
1370    netidmgr afs provider, and aklog.  When two cells are
1371    linked, a volume lookup that fails in one cell is looked
1372    up in the other.  This can be used for construction of 
1373    test cells that override specific volumes; cell renaming;
1374    and cell splitting.
1375
1376  * Increase the length of cell and realm names that can 
1377    be entered in the NIM AFS provider.
1378
1379  * Actively prevent a 32-bit afsd_service.exe from 
1380    executing in the WOW64 environment.
1381
1382  * Protect against invalid IP address values in CellServDB
1383    parsing.
1384
1385 Since 1.5.53
1386
1387  * Fix an Rx panic caused by an attempt to double free
1388    an rx_packet when an error occurs while writing the
1389    packet.
1390
1391  * Fix an exception cause by a race condition when 
1392    processing multiple file change notifications registered
1393    by the Explorer Shell or other applications.
1394
1395  * Modify the Rx debug interface to use var_args and 
1396    permit Rx debugging to be used on 64-bit Windows 
1397    which previously had it disabled.
1398
1399 Since 1.5.52
1400
1401  * Automated lock hierarchy enforcement added to the
1402    osi base lock package.  This permits detection of lock
1403    violations that might but often does not result in 
1404    deadlocks.  Enabled by default in the checked builds.
1405    May be activated in release builds via the registry
1406    value "LockOrderValidation" in the TransarcAFSDaemon
1407    Parameters key.
1408
1409    When a violation is detection an assertion is thrown
1410    generating a dump file and a message indicating which
1411    locks were obtained out of order is logged to the 
1412    Windows Application Event Log.
1413
1414  * Attempt to ensure that a dump file will be generated
1415    whenever the service panics.
1416
1417  * Removed unused lock cm_bufGetMutex
1418
1419  * Many out of order lock acquisitions were detected
1420    using the lock order verifier and were corrected.
1421
1422  * A race condition within the function path cm_GetSCache() ->
1423    cm_GetNewSCache() -> cm_RecycleSCache() permitted a 
1424    cm_scache_t object to be issued simultaneously to two 
1425    threads.   This would eventually result in a panic due 
1426    to the resulting undercount.
1427
1428  * Fix interpretation of the empty string as the ioctl path
1429    to mean the current directory.  "fs lsm", "symlink list", 
1430    etc. now return a "not a ..." error instead of "does not
1431    exist".
1432
1433  * Add SMB_STRF_SRCNULTERM flag to smb_ParseStringXXX functions.
1434    to indicate that the input string is a nul terminated string.
1435    Assign ti when input strings are nul terminated instead of 
1436    length counted. (from 1.5.50)
1437
1438  * The CIFS protocol specification for handling NT_TRANSACT_CREATE
1439    does not match the observed behavor.  The 'nameLength' is specified
1440    in bytes, not in characters.  Fix the implementation to match
1441    the observed behavior. (1.5.50)
1442
1443  * The cm_HaveAccessRights() attempt at deadlock avoidance by 
1444    calling lock_TryRead() on the parent directory cm_scache_t rw-lock
1445    does not avoid the deadlock.  Avoid the deadlock by enforcing the
1446    lock order of the lowest vnode first.  Then remove the infinite 
1447    loop avoidance in cm_SyncOp() that was returning an unwarranted
1448    access denied error.
1449
1450  * File Server lock synchronization was not propertly enforced in 
1451    smb_ReceiveNTCreateX() and smb_ReceiveNTTranCreate().
1452
1453  * Another change to the short name generator.  Plus and equal are 
1454    not valid characters in a short name according to the 
1455    RtlIsNameLegalDOS8Dot3() in kernel mode.  They have been replaced
1456    with left and right brace in order to minimize the impact.
1457
1458  * Fix a race condition that can result in a heap overwrite error if
1459    the number of known file servers or vldb servers increases during
1460    the preparation phase of a cm_CheckServers() operation.
1461
1462  * If the SMB Authentication would fail, a LSA allocated memory 
1463    buffer would be leaked.
1464
1465  * Rewrite the cm_cell_t allocation code to permit cell vldb server
1466    lookups to fail without leaking cm_cell_t objects.
1467
1468  * Add "fs setcrypt auth" to permit the use of rxkad authentication
1469    only mode.  Not documented.
1470
1471  * Initialize Rx mutex and lock objects once and only once as part of
1472    the DLL load process.
1473
1474  * When reporting the Volume Name "AFS" do not include the terminating
1475    NUL in the reported length.  
1476  
1477  * Refresh Volume Location information upon receipt of a VNOVOL error
1478    from the file server and avoid a race condition that prevented the
1479    updated volume location information from being destroyed immediately
1480    after it was acquired.
1481
1482  * In response to VNOVOL and VMOVED, remove the volume id from the server's
1483    volume list so that the volume's up and down status is not affected 
1484    when the machine is shutdown.
1485
1486  * Many fixes to the Rx stack related to packet allocation and deallocation;
1487    Rx debugging; Rx packet tracking across queues; and Rx packet loss caused
1488    by overwriting the rx_call currentPacket pointer when it was already 
1489    referring to a packet.  
1490
1491  * Rx Jumbograms are now off by default.  To re-enable, add "RxJumbo" = "1"
1492    in the TransarcAFSDeamon/Parameters key.
1493
1494  * "fs flush", "fs flushvolume", and "fs flushall" now destroy locally 
1495    constructed directory B+ trees for flushed directory objects.
1496
1497  * When cached pages for directory objects have been locally modified, do
1498    not permit the locally modified pages to be mixed with pages subsequently
1499    obtained from the file server.  Doing so can result in directory 
1500    corruption.
1501
1502  * If Ubix errors are received in response to VL_xxx operations record
1503    the error on the server instance and permit the operation request to 
1504    be retried in case another server is able to answer the query.  We have
1505    seen at least one instance of a cell in which a VL server returned 
1506    UNOQUORUM (possible database truncation) when the other servers were
1507    responding successfully.
1508
1509 Since 1.5.51
1510  * Optimize the assignment of write errors to dirty 
1511    buffers by applying the first error to all buffers 
1512    belonging to the same object instead of trying each 
1513    buffer in turn.
1514
1515  * Add resource version info to xstat_fs_test and xstat_cm_test
1516  
1517  * Fix a delete vs delete[] usage problem in the WiX custom 
1518    handler dll
1519  
1520  * When creating a mount point, validate the volume name to 
1521    make sure it exists.
1522
1523  * When processing a mount point, pay attention to VL_BADNAME 
1524    errors.
1525
1526  * Remove a race condition from cm_volume_t recycling that could 
1527    have resulted in two threads making use of the same object at 
1528    the same time.
1529
1530  * Fix a reference count leak on smb_vc_t objects introduced in 
1531    1.5.50.  Permit the objects to be freed once again.
1532
1533  * Fix the output of "fs memdump" for smb_vc_t objects that was 
1534    broken in 1.5.50.
1535
1536  * Add routines for debugging smb refcount errors.
1537
1538  * When shutting down the cache manager, do not permit AFS 
1539    callback requests to be processed. Doing so can result in 
1540    invalid memory accesses.
1541
1542  * Do not recycle a deleted cm_scache_t object unless the 
1543    refCount is 0.  Doing so can result in a deadlock and 
1544    invalid memory access.
1545
1546  * Minimize the number of RPCs sent to the file server for 
1547    directory bulk status requests. Only request status for 
1548    objects that we are actually reporting on and only if we 
1549    do not already have status for the object and then make 
1550    sure that we return as much as we can at once via the SMB 
1551    interface but not so much that it exceeds the RDR timeout
1552
1553  * Enable bos restricted operations
1554
1555  * Fix the creation of submounts used by the afscreds and afs_config 
1556    drive mapping tabs.
1557  
1558  * Avoid repeated retries when attempting to obtain access rights.  
1559    If the access rights were obtained successfully but do not 
1560    satisfy the request, fail the request.
1561
1562  * Fix error code reported when attempting delete a file on a 
1563    readonly volume or one that is marked with the readonly DOS 
1564    attribute.
1565
1566  * Fix a short name truncation bug.
1567
1568  * Fix a heap corruption error when reading the CellServDB file 
1569    location.
1570
1571  * Fix directory listings when the directory has "lookup" permission 
1572    only and the directory has never been previously accessed.
1573
1574  * Fix several tracking issues for cm_scache_t rw locks.
1575
1576  * Ensure that all buffers used to store cell names are the
1577    correct length.
1578
1579  * Restore Windows 2000 support (broken in 1.5.50).   
1580    LOCALE_INVARIANT was introduced in XP.
1581
1582  * Add RxUdpBufSize registry value.  Default is 256K.
1583
1584  * Avoid multiple deadlocks between cm_freelanceLock and cm_scacheLock
1585
1586  * Do not include trailing NULs when returning file names in 
1587    a directory search response.
1588
1589  * Prevent RX from crashing the afsd_service by attempting
1590    to allocate to many buffers at once when memory is fragmented.
1591
1592  * Avoid a deadlock when freeing cm_server_t objects
1593
1594  * Optimize search cell file.  Do not search to end of file
1595    if the cell has already been found.
1596
1597  * Remove explorer shell extension delay on local disks.
1598
1599  * Automatically pre-allocate 64 Rx packets per thread
1600
1601  * Add smb lock requests and stat cache lock allocations to
1602    the output from fs memdump.
1603
1604 Since 1.5.50
1605  * Fix Large File Support (broken in 1.5.50)
1606
1607  * Fix "fs setacl" (broken in 1.5.50)
1608
1609  * Fix pioctl path evaluation of drive letter
1610    mapped paths. (broken in 1.5.50)
1611
1612  * Fix installation of VC8 Runtime library in the EXE
1613    Retail installer. (broken in 1.5.50)
1614
1615  * Avoid a potential deadlock during Volume Location 
1616    updates if all the file servers are unreachable at 
1617    the time the VL update succeeds.
1618
1619  * Ensure that rx connection object is references 
1620    during VL RPCs.
1621
1622  * Fix propagation of over quota errors during cm_FSync()
1623    calls.
1624
1625 Since 1.5.39 [1.5.50 released 16 July 2008]
1626  * There were no releases between 1.5.39 and 1.5.50.
1627
1628  * FIRST RELEASE WITH UNICODE SUPPORT
1629
1630  * Pioctl interfaces to the cache manager refactored
1631    to provide layering between the SMB specific code
1632    and the general purpose ioctl operation.
1633
1634  * Garbage collect dead SMB virtual circuits as soon
1635    as they are no longer being referenced.  This avoids
1636    problems with outstanding locks not being dropped
1637    when the virtual circuit becomes invalid.
1638
1639  * Remove the IBM Administration Reference documentation
1640    and replace it with the OpenAFS Command Reference 
1641    Manual.  
1642
1643  * Avoid calling rx_SetDeadTime and rx_SetHardDeadTime
1644    functions each time a connection is about to be used.
1645    Do not hold a lock on the rx connection object while
1646    it is being selected.  This avoids a race between 
1647    threads attempting to set the timeout values and 
1648    removes a bottleneck that was hampering performance.
1649
1650  * Ensure that the smb directory attribute is set 
1651    for all directory objects.
1652
1653  * Add vs2008 support to the NSIS installer scripts
1654
1655  * Replace the VC Runtime EXE installer with the MSI
1656    installer in the NSIS installer scripts
1657
1658  * Properly delete the VC7.1 C Runtime libraries.   
1659
1660 Since 1.5.36 [1.5.39 released 23 June 2008]
1661  * There were no 1.5.37 or 1.5.38 releases for Windows
1662
1663  * Use Visual Studio version of vsprintf() instead of 
1664    home grown version that resulted in linking conflicts
1665
1666  * Prevent buserver, ptserver and fileserver from crashing
1667    due to non-portable strftime() format strings.
1668
1669  * Prevent server crashes caused by rx_InitMorePackets()
1670    being called prior to allocation of all of the required
1671    synchronization objects.
1672
1673  * Fixed a memory leak in the internal B+ tree directory.
1674    For objects with non-8.3 names, the 'longname' memory
1675    allocation would be leaked during object deletion or
1676    tree destruction.
1677
1678  * Fixed a memory leak in the background daemon cm_CheckServer() 
1679    routine.  The memory allocated to store the server list
1680    was not freed.  
1681
1682  * Obtain a missing lock around a call to cm_RemoveSCacheFromHashTable(). 
1683
1684  * Correct an abstraction layer violation. cm_scache_t objects 
1685    should be marked deleted in cm_Unlink() and cm_RemoveDir() and not 
1686    in smb_CloseFID(). Cleanup of deleted cm_scache_t objects should be 
1687    performed in cm_ReleaseSCache() when the reference count hits zero. 
1688
1689  * Prototype cm_AdjustScacheLRU() and re-implement it using osi_QAddH().
1690
1691  * Do not reference 'smb_logp' in cm_vnodeops.c.  Use 'afsd_logp'
1692    instead.
1693
1694  * Ensure that scache object 'nextp' pointers are set to NULL
1695    when the objects are removed from the hash table linked list.
1696
1697  * If a dirty buffer cannot be written to the file server because
1698    of an access denied error, mark the error in the cm_buf_t
1699    structure so that it can be dealt with instead of retrying 
1700    forever.
1701
1702 Since 1.5.35
1703  * Update CellServDB file to GCO Public 23 Apr 2008
1704
1705  * Fix a cm_buf_t reference count leak when attempts to write 
1706    dirty buffers to the file server from within cm_IncrSyncer() 
1707    fail.
1708
1709  * Prevent udebug from crashing.
1710
1711  * Activate RX Idle Timeouts.  If the file server is busy for more 
1712    then 30 seconds, attempt to failover to another server without 
1713    marking the busy server down.
1714
1715  * Another VNOVNODE issue fixed.  When writing a dirty buffer
1716    to the file server, if VNOVNODE is received, mark all buffers
1717    as invalid without further attempts to contact the file server.
1718    
1719  * Improved performance on high latency links.
1720
1721 Since 1.5.34
1722  * Fix a bug preventing the re-initialization of the Freelance 
1723    root.cell contents when a change is made.
1724
1725  * Properly return CM_ERROR_NOSUCHFILE when removing a symlink 
1726    or mountpoint that does not exist.
1727
1728  * aklog, afscreds, integrated logon, and the NIM AFS credential 
1729    provider will all attempt to first acquire an afs service ticket 
1730    using the service principal: afs/<cell>@<CLIENT_REALM>.  This 
1731    permits the proper detection of the cell realm when multiple 
1732    realms are local realms for the cell.
1733
1734  * Fix fs commands that re-use file identifiers instead of forcing 
1735    a path evaluation each time.  This was broken in 1.5.33 when 
1736    hashes were added to the cm_fid_t structure.
1737
1738  * Fix symlink and mountpoint removal and then recreation when 
1739    applied to the fake Freelance root.afs volume.
1740
1741  * Fix SMB change notifications for the Freelance root.afs volume 
1742    when creating or removing symlinks and mount points.
1743
1744  * Force DNS AFSDB cell name lookups to lower case if the DNS 
1745    response is not all lower case.
1746
1747  * 32-bit installers are now built with Visual Studio 2005
1748
1749  * All vos.exe commands now support the "-noresolve" option which 
1750    forces the display of IP addresses instead of DNS hostnames.
1751
1752  * No longer hold the cm_volume_t mutex across VL_xxx RPCs.  This 
1753    permits operations that do not require up to date volume 
1754    location data to continue while waiting for the RPC to complete.  
1755    Multiple threads waiting for a volume location update on the 
1756    same volume set no longer trigger multiple calls VL_xxx RPCs.
1757
1758  * Volume server references could be marked offline and never 
1759    reset to the not_busy state.  
1760
1761  * Further optimizations to cm_Analyze() retry logic for 
1762    CM_ERROR_OFFLINE and CM_ERROR_ALLBUSY error handling.
1763
1764 Since 1.5.33
1765  * Optimize the DNLC by applying Interlocked incrementing for 
1766    statistics gathering and enabling greater use of read 
1767    locks instead of write locks
1768
1769  * Further optimize osi_Log operations when logging is disabled 
1770    by removing the need for the function call overhead.
1771
1772  * Add a new lock operation, Convert Read to Write, and apply 
1773    it throughout the cache manager.  This function provides a 
1774    fast transition from a read lock to a write lock when the 
1775    caller is the only reader.
1776
1777  * Fix a timeout problem when opening files or request locks 
1778    when the file in question is already write-locked by another 
1779    machine.
1780
1781  * Fix a deadlock that can occur if "fs flushall" is executed 
1782    while applications are writing to AFS.
1783
1784  * The cache manager would re-read data from the file server 
1785    after file truncation when obtaining buffers to write to the
1786    same file until the first StoreData RPC completes.
1787
1788  * Fixes error handling in cm_NTCheckDelete()
1789
1790  * Replaces cm_scache_t mutex with a read-write lock permitting 
1791    additional parallel access.
1792
1793  * Prevent an cm_scache_t reference undercount when evaluating 
1794    symlinks containing @sys when none of the active sysnames 
1795    match any of the available targets.
1796
1797  * Prevent the leak of a cm_scache_t rwlock if associated symlink 
1798    is too long.
1799
1800  * Set RxMaxMTU registry value to 0 which is the equivalent of 
1801    it not being set at all.
1802
1803  * Reduce contention between BkgDaemon threads
1804
1805  * Prevent CM_SCACHEFLAG_ASYNCSTORE from being reset on a write 
1806    failure
1807
1808  * Convert reference counts on cm_volume_t, cm_conn_t, cm_server_t 
1809    objects to use the faster Interlocked operations which avoid 
1810    the need to hold write locks.
1811
1812  * Permit rxkad errors other than RXKADEXPIRED to be treated as a 
1813    non-fatal error that forces a retry against another service 
1814    (if available.)
1815
1816  * Fix a crash in smb_WriteData that would occur if an application 
1817    opened the file as read-only and then sent a write request anyway.  
1818    (RT 88731)
1819
1820  * Respond to VL_NOENT errors by removing cm_volume_t object and
1821    setting it to be the first object to be recycled.  This is not 
1822    only a more efficient use of resources but it also prevents 
1823    repeated attempts to query the VLDB server for the volume from 
1824    the CheckOfflineVolumes routine.
1825
1826  * Change the defaults for RxEnablePeerStats and RxEnableProcessStats 
1827    back to "on".
1828
1829  * A first cut at a cache manager statistics monitor that can be used 
1830    to determine the necessary cache parameters to support the 
1831    application working set.
1832
1833    Off by default, the performance package can be activated by setting 
1834    "daemonPerformanceTuningInterval" in the service Parameters key.  
1835    As with the other daemon interval values the unit is in seconds.
1836
1837    At service start and each succeeding interval the cache manager 
1838    will write statistics to %TEMP%\afsd_performance.txt showing the 
1839    relative usage of cm_scache_t, cm_volume_t and cm_buf_t objects.  
1840    The FID statistics keep track of all FIDs seen by the cache manager 
1841    during the service session whether or not they are backed by any 
1842    live object in the cache.
1843
1844    These statistics are not stored in the cache file.
1845
1846  * Fix windows event logging broken in 1.5.33.
1847
1848  * Eliminate multiple calls to syscfg_GetIFInfo() which is used to 
1849    populate the IP address list for WhoAreYou/TellMeAboutYourself RPCs
1850    as well as when computing the server preference list.
1851
1852  * When merging status after a StoreData operation prevent data 
1853    buffers from being discarded that we would prefer to keep.  
1854    (Bug introduced in 1.5.33.)
1855
1856  * Modify installers the set RxMaxMTU to 0.
1857
1858  * In the AFS Configuration Panel on the Advanced->Miscellaneous 
1859    dialog, the Background Daemons and Service Threads fields were 
1860    swapped.
1861
1862  * Increase default number of Background Daemons to 4.
1863
1864  * Remove cm_volume_t reference from the cm_scache_t object.  Permit 
1865    cm_volume_t objects to be recycled.
1866
1867  * Windows Error Reporting has shown a number of previously unseen 
1868    stack corruption errors in the Explorer Shell extension.  The 
1869    minidump appeared to indicate the problem was in ParseAcl().  
1870    Reviewing the function it appears that numerous things could go 
1871    wrong if invalid input was provided.  Added error checking and 
1872    data validation.  Hopefully this will address the problem.
1873
1874  * Windows Error Reporting has shown crashes in aklog as a result
1875    of krb5_cc_get_default() failures not being handled.  They are
1876    now handled.
1877
1878 Since 1.5.32
1879  * The Rx library used a 32-bit type for sockets which was
1880    truncating the socket value on 64-bit Windows.  This 
1881    was not an issue in general but became an issue when 
1882    Rx "hot thread" support was enabled.
1883
1884  * Enable "Rx hot thread" support which ensures that while
1885    a received message is being processed that a new thread
1886    is allocated to receive the next message to arrive.
1887
1888  * Increased parallel access to smb_rctLock protected 
1889    resources.  Reduce the number of times that the 
1890    lock is dropped and re-obtained.
1891
1892  * Increased parallel access to cm_scache_t and cm_buf_t
1893    resources by replacing the previous global write lock
1894    protected reference counting mechanism with one built
1895    upon the use of InterlockedIncrement and InterlockedDecrement.
1896
1897  * Implement a hash for cm_fid_t to reduce comparison costs
1898    and inline the cm_FidCmp() function.
1899
1900  * Redefine the BUF_HASH and BUF_FILEHASH in terms of the cm_fid_t 
1901    hash which has a better distribution
1902
1903  * Modify cm_ConsiderPrefetch to evaluate the amount of data in 
1904    the most recent read request instead of the next chunkSize.  
1905    cm_chunkSize can be dozens or hundreds of buffers.  As a result
1906    too much time is spent performing the evaluation.
1907
1908  * Fix the usage of cm_scache_t bufCreateLock.  The purpose of this 
1909    lock is to prevent the creation of new buffers while a truncation 
1910    is being performed.  All references to bufCreateLock have been 
1911    removed except in two places:
1912    i.  a write-lock surrounding the function that calls buf_Truncate()
1913    ii. a read-lock within buf_GetNewLocked() that actually allocates 
1914        new buffers
1915
1916  * Modify the CM_CONFIG_DATA_MAGIC value to include a 
1917    CM_CONFIG_DATA_VERSION number which value be used to force the 
1918    replacement of the cache file contents when incompatible changes 
1919    are made between releases.
1920
1921  * CM_SCACHESYNC_ASYNCSTORE should not be ordered by 
1922    cm_SyncOpCheckContinue
1923
1924  * Avoid calls to multi_Rx if nconns == 0
1925
1926  * Modify smb_WriteData to perform background writes based upon the 
1927    crossing of 'smb_AsyncStoreSize' boundaries instead of cm_chunkSize 
1928    boundaries.  This will slow down writes from the SMB interface but 
1929    will avoid the risk of the CIFS client disconnecting from the AFS 
1930    client SMB server.  The default value for 'smb_AsyncStoreSize'
1931    is 128K.  
1932
1933  * SMB AsyncStore functionality is on by default but can be 
1934    disabled using the registry value:
1935
1936      HKLM\SOFTWARE\OpenAFS\Client DWORD "EnableSMBAsyncStore"
1937
1938    smb_AsyncStoreSize can be adjusted with 
1939
1940      HKLM\SOFTWARE\OpenAFS\Client DWORD "SMBAsyncStoreSize"
1941
1942    The value must be a multiple of the buffer block size 
1943    and cannot be larger than the chunk size.
1944
1945  * Do not leak a read lock on the bufCreateLock
1946
1947  * Do not forget to call cm_SyncOpDone if cm_SyncOp succeeded
1948    in cm_CheckNTOpen()
1949
1950  * In MergeStatus, only remove clean buffers from the hash table.
1951
1952  * Avoid the need to update the data version number on each buffer 
1953    associated with a scache when MergeStatus is called after a 
1954    StoreData by maintaining a range of valid data versions as part 
1955    of the cm_scache_t object.
1956
1957  * Profiling shows large numbers of blocked calls in cm_HoldSCache
1958    from cm_HaveAccess...   We can safely avoid the call so do so.
1959
1960  * Add "ForceAnonVLDB" service parameters registry value.  Default
1961    is 0.  Set to 1 to force the use of anonymous connections to
1962    the VLDB servers.  This is useful when using krb5 tokens and the
1963    VLDB servers have not been updated.
1964
1965 Since 1.5.31
1966  * Do not attempt to search for a cell name that matches one
1967    of the special share names "svrsvc", "wkssvc", "ipc$"
1968
1969  * Issue permission denied warnings from afscreds if attempts
1970    to modify the startup shortcut or registry values fail.
1971    This happens under Vista UAC.
1972
1973  * Do not return BAD_NETWORK_ERROR in response to attempts
1974    to create directories or files in the Freelance root.afs 
1975    volume.  Instead return ACCESS_DENIED.
1976
1977    BAD_NETWORK_ERROR was being sent because the Freelance cell 
1978    has no vldb servers.  Short circuit the error by testing for 
1979    freelance in CreateFile and MakeDir
1980
1981  * Treat srvsvc, wkssvc and ipc$ as pseudo files.  Permit them 
1982    to be opened and closed without actually existing.  For now 
1983    we treat them as equivalent to ioctls but this should 
1984    eventually change.
1985
1986  * Fix RAP processing to not reject names that exist in the 
1987    root.afs volume for GetInfo queries.
1988
1989  * In afscreds, use GetUserNameEx to obtain the username instead 
1990    of searching the registry.  Try UserPrincipalName first and 
1991    fallback to SamCompatible.
1992
1993  * Stop linking to rpcns4.dll which is no longer supported on 
1994    Vista and 2008.  TaAfsAdmSvr is going to have to be 
1995    redesigned.
1996
1997  * When processing dfs referral requests, if the sharename is 
1998    a partial match and therefore will not be added automatically 
1999    to the share list, make sure that we return an error.
2000
2001  * Avoid a crash when logging VNOVOL errors returned from 
2002    cm_CheckOfflineVolume.
2003
2004  * When trace logging is disabled, do not permit osi_LogSaveString 
2005    to perform the string copying.  By disabling the string 
2006    copies, throughput of the service more than doubles.
2007
2008  * when checking offline volumes, update the cell vlserver info
2009    if required and don't perform a check if there are no servers
2010    in the list.
2011
2012  * Add volumes in the vl_unknown state to the list of objects to be
2013    checked as offline or retried when an allbusy error is received
2014    in cm_Analyze.
2015
2016  * Add support for configuring rx_ExtraPackets
2017
2018  * All calls to buf_Get() must be protected by a read lock on the
2019    cm_scache_t bufCreateLock
2020
2021  * When a MergeStatus results in the invalidation of buffers, do
2022    not remove buffers from the hash tables that have active references.
2023
2024  * Upon receiving a VNOVNODE error from a file server, be sure to
2025    invalidate any file locks.  This prevents on-going attempts to
2026    extend the locks and will cause subsequent attempts to access
2027    the file to receive a invalid handle error.
2028
2029  * Prevent smb_ReceiveTran2SearchDir from adding terminating NULs
2030    to directory entry names.
2031
2032  * No longer discard tokens when RXKADBADTICKET error is received.
2033    Instead return STATUS_NO_KERB_KEY error.
2034
2035 Since 1.5.30
2036  * Add "cmdebug <host> -cellservdb" option and client service 
2037    implementation permits querying the vldb server for each 
2038    cell known to the cache manager.  The output is in a form
2039    that permits it to be used as a CellServDB file.
2040
2041  * Add Symlinks->Show option to the AFS Explorer Shell Context
2042    Menu
2043
2044  * Prevent buffer overrun in the cmd parser used by command
2045    line tools such as fs, vos, pts, etc.
2046
2047  * The path ioctl operations have several issues:
2048
2049    (1) the specified path for "fs examine, whereis, whichcell, 
2050        flush" and so always has the follow symlinks and mount 
2051        points semantics.  This makes it impossible to determine 
2052        what the FID of a symlink or mount point is.
2053
2054    (2) "fs examine" out is not the result of a single pioctl 
2055         operation but is actually the combined output of half 
2056         a dozen operations.  Path evaluation is an expensive 
2057         operation.  It would be faster if the caller could
2058         evaluate the FID first and then perform all of the 
2059         rest of the operations by specifying the FID instead 
2060         of the path.
2061
2062    (3) fs output reports all objects as files.  By adding a 
2063        GetFileType pioctl more informative output can be provided 
2064        that indicates what type of object the path evaluates to.
2065
2066    (4) the Windows fs command includes a number of commands that 
2067        do nothing but exist only because the Unix cache manager 
2068        supports them.
2069
2070    A new extendible data structure cm_ioctl_query_opts_t has been 
2071    added which can be optionally specified with pioctls that do not
2072    already require input data.  The first two fields of this structure 
2073    are 'literal' and 'fid'.  The literal field is used to indicate
2074    whether the last component of the path should be evaluated following 
2075    symlinks and mount points.
2076
2077    The fid field permits a fid to be specified.
2078
2079  * A new GetFileType pioctl has been added. The type of objects are 
2080    now output.
2081
2082  * A new "-literal" option is available for "fs examine, flush, whereis, 
2083    and whichcell.
2084
2085  * Unimplemented fs commands have been removed.
2086    
2087  * There are circumstances where a volume object is being accessed and 
2088    the volume is marked indicating that the volume location information 
2089    is out of date but where it is also pointless and perhaps dangerous 
2090    to block waiting for the rpc to complete.  One example is when 
2091    processing the cmdebug requests.  If we know that we are not going 
2092    to use the volume object to contact a server, then we can now set 
2093    the CM_GETVOL_FLAG_NO_RESET flag.
2094
2095  * when moving up in the directory tree we search the recorded fid list 
2096    to find a matching fid that we have already crossed.  we must also 
2097    reset the fid count based upon what we discover.
2098
2099  * Cell names are published as share names.  As a result they are searched
2100    for as part of the Dfs Referral evaluation.  If share "foo" can not be
2101    reached, the CIFS client will fallback to searching for "fo" as well.
2102
2103    Since the freelance client automatically adds a symlink for prefixes
2104    of the cell name, this results in both "foo" and "fo" being added to
2105    the freelance root.afs volume.  This patch prevents that negative side
2106    effect.
2107
2108  * when tracking Kerberos credential cache names be sure to include 
2109    the cache type prefix.
2110
2111  * Microsoft has assigned OpenAFS a network type value
2112
2113  * The algorithms that were used to produce a Netbios name were broken.
2114    The name that was produced when the hostname was too long was in fact
2115    longer than the maximum permitted netbios name.
2116
2117    Also, the "NetbiosName" value was not used as a suffix when the loopback
2118    adapter was not installed.  The hardcoded string "AFS" was used instead.
2119
2120  * avoid another deadlock during server probes initiated by the ipaddr 
2121    change daemon thread.
2122
2123  * prevent the afs client service from crashing when fs newcell is 
2124    executed
2125
2126  * In the NSIS installer, move afslogon.dll, afscpcc.exe and afs_cpa.cpl 
2127    to \Program Files\OpenAFS\Client\Program in order to get them out
2128    of the %windir% tree
2129
2130  * EDQUOT == WSAEDQUOT.   Define it in the right places so that in the 
2131    end STATUS_OUT_OF_QUOTA can be returned to the application.
2132
2133  * Modify the search order for determining the location of CellServDB
2134    and other client configuration files.
2135
2136    1. AFSCONF environment variable
2137    2. registry setting
2138    3. NEW - use All Users\AppData\OpenAFS\Client only if CellServDB exists
2139    4. use Program Files\OpenAFS\Client
2140
2141  * More Vista Power Management tweaks
2142
2143  * Close a socket handle leak in the kauth routines
2144
2145  * Don't hold a cm_volume_t mutex across RPCs
2146
2147  * Convert downTimes to use clock time instead of relative times.
2148    This permits correct comparisons with expiration times.
2149
2150  * Update the Wix installer to properly install the prerequisites 
2151    for translate_et.exe
2152
2153  * Do not translate pioctl paths as they are not converted by the
2154    file system stack.
2155
2156  * Implement multi_rx probes for checking whether servers are up
2157    or down.  Turns probes into a constant time activity instead 
2158    of one dependent upon the number of known servers.
2159
2160  * Treat VNOVOL errors the same as VOFFLINE.  Do not force an
2161    update of the volume location data and retry.  VNOVOL means
2162    that the volume could not be attached.  It doesn't mean that
2163    the volume is not on this server.
2164
2165  * Modify the Explorer Shell AFS Context menu Symlink->Add to
2166    not attempt to validate the target path.   There is no reliable
2167    method of doing so.
2168
2169  * Improve performance of \\afs\<cell><mount-type><volume>\
2170    access by eliminating extraneous attempts to search the 
2171    CellServDB file and DNS AFSDB records.  Share names 
2172    containing '%' or '#' are not valid cell names.
2173
2174  * Return STATUS_RANGE_NOT_LOCKED if the application attempts
2175    to unlock a range that is not currently locked.
2176
2177  * Enable the 32-bit tools to read the 64-bit registry keys
2178    when executing in the WOW64 environment.
2179    
2180
2181 Since 1.5.29
2182  * Fix buffer refcount leak introduced in 1.5.29
2183
2184  * Prevent the NIM AFS Provider from crashing when configured to use 
2185    Kerberos v4 for token acquisition in situations where no Kerberos v4
2186    support is available.  For example, 64-bit KFW or sites that delete
2187    the Kerberos v4 DLL.
2188
2189  * In afsd_init.log, support logging cache sizes greater than 2GB.
2190
2191  * The volume status output of "fs examine" was being determined based
2192    upon the wrong error value.  Instead of using the pioctl() return
2193    code, the errno value must be used.  
2194
2195  * Prevent invalid pts auto-registration attempts by aklog and the 
2196    NIM afs provider when Kerberos referrals are in use.  (krb5 1.6+)
2197
2198  * Add synchronization protection to all of the SMB Listener State 
2199    variables.  This prevents race conditions when the addition or
2200    loss of a network adapter takes place.
2201
2202  * On Vista, there is a race condition between the restart of the 
2203    afs client service and the network adapters.  Ensure that the 
2204    afs client service can handle switching between loopback and 
2205    non-loopback modes of operation.
2206
2207  * Fix FollowBackupPath to work with mount points that are not 
2208    explicitly read/write.
2209
2210  * Fix a deadlock that has been observed on Vista while resuming
2211    after at least four hours of sleep.
2212
2213  * Add new HKLM registry configuration options that can be used 
2214    to provide configuration hints to the NIM AFS Provider when 
2215    creating new identities.  See release notes for details on
2216    HKLM\SOFTWARE\OpenAFS\Client\Realms\.
2217
2218 Since 1.5.28
2219  * Speed up write buffer operations by holding a global read-lock
2220    instead of a write-lock when updating the buffer data version 
2221    number.  The data version is protect by the associated stat
2222    cache mutex.
2223
2224  * Speed up read buffer operations by removing out of date buffers
2225    from the buffer hash tables.
2226
2227  * Protect against a null pointer dereference in afslogon.dll
2228    if QueryAdHomePathFromSid() fails.
2229    
2230  * Remove a race condition while accessing private freelance data
2231    structures.
2232
2233  * Update the buffer data versions when Freelance directory data
2234    changes.
2235
2236  * Complete the implementation of smb_ReceiveTran2GetDFSReferral().
2237    Critical for Vista.  
2238
2239  * Return EAS_NOT_SUPPORTED in response to EA read/store/query 
2240    instead of returning zero length.
2241
2242  * Return ERROR_RETRY when a server sends VBUSY.
2243
2244  * Return PATH_NOT_COVERED instead of BADSHARENAME for DfsLinks when
2245    a volstat plug-in is in use.
2246
2247  * Enhance the volstat interface to support Dfs path mappings.
2248
2249  * Fix "symlink list" to do the right thing for Dfs links
2250
2251  * Fix callback expiration that was broken in 1.5.27.
2252
2253  * Fix a crash at shutdown caused by the lack of synchronization
2254    within the daemon threads (cm_Daemon, cm_BkgDaemon, cm_IPAddrDaemon)
2255
2256  * Hold the cm_server_t mutex while walking or modifying the 
2257    cm_server_vols_t list in order to avoid a race condition.
2258
2259  * Ensure that the cm_server_t refCount is safely modified.
2260
2261  * The pthread library implementations of pthread_cond_wait
2262    and pthread_cond_timedwait were failing to return with 
2263    the mutex held when error conditions occurred.  This could
2264    result in race conditions wherever they are used.  One case
2265    in which problems were seen was the Rx event_handler().
2266
2267  * Prevent cm_GetBuffer() from locking all buffers associated with 
2268    a stat cache object before deciding if the current buffer is up 
2269    to date.
2270
2271  * Fix cm_BkgPrefetch to actually ensure that there is a cm_buf_t 
2272    object for each offset that we will attempt to reserve.
2273
2274  * Reduce the default number of background daemon threads used to 
2275    prefetch or store to one in order to prevent two or more threads 
2276    from stepping on each other.
2277
2278  * Reduce the default chunk size to 256KB in order to prevent read 
2279    timeouts on low bandwidth connections.
2280
2281  * Fix a race condition that could result in threads becoming stranded 
2282    when synchronizing multiple requests on the same stat cache object.
2283
2284 Since 1.5.27
2285  * The GiveUpAllCallBacks functionality that was added in 1.5.21
2286    has been disabled.  It has been disabled because it turns out
2287    that the RPC is improperly implemented in all file servers 
2288    previous to 1.4.6.  The RPC is executed without the proper 
2289    locks being held resulting in data corruption and eventual file
2290    server failure.  The functionality will be re-enabled in a 
2291    a few months.
2292
2293  * a couple of .readonly Volume Callback optimizations were 
2294    implemented:
2295    -  Apply most recent volume callback to all stat cache objects 
2296       in the volume.  This avoids premature callback expirations 
2297       and unnecessary FetchStatus calls.
2298    - Add option to permit attempts to renew .readonly Volume 
2299      Callbacks on a periodic basis to avoid invalidation of stat 
2300      cache data.  [Requires daemonCheckVolCBInterval be set to 
2301      non-zero number of seconds.  1800 (30 minutes) is suggested.]
2302
2303  * Adds support for 64-bit data version values.  Previous releases 
2304    only supported 32-bit values.  Larger values sent by the file server 
2305    would result in rollover.
2306
2307  * aklog and asetkey no longer generate an exception if Kerberos for 
2308    Windows is not installed.
2309
2310  * If the LSA authentication functions report a temporary out of memory 
2311    condition, fail the current authentication and do not cause the AFS 
2312    client service to terminate unexpectedly.
2313
2314  * When the AFS client service is shutting down, prevent the daemon check 
2315    thread from executing additional checks which might attempt to access 
2316    discarded locks or unmapped memory.
2317
2318  * Correct a double free condition in the NIM AFS credentials provider.
2319
2320  * Add "FollowBackupPath" service parameter registry value.   
2321    This provides equivalent functionality to the UNIX afsd -backuptree
2322    option.  When set to a non-zero value, normal mount points originating
2323    in a .backup volume will prefer a .backup volume.
2324
2325 Since 1.5.26
2326  * Fix NSIS uninstall from the .MSI installer.
2327
2328  * Add Stack Frame logging for AMD64
2329
2330  * Add support for EWOULDBLOCK to cm_Analyze.  If the file 
2331    server returns EWOULDBLOCK, retry the request every two 
2332    seconds for up to the RDRtimeout.
2333
2334  * Reorganize the order of the includes to ensure that EWOULDBLOCK 
2335    is not assigned the same value as EIO.
2336
2337  * Update CellServDB to GCO Public 25 Oct 2007
2338
2339  * Add additional validation and error handling code after 
2340    each call to getSlot().  If an invalid slot is returned, 
2341    return NONODE.  If the invalid slot is returned when 
2342    extracting a data node, invalidate the tree.
2343
2344  * Modify compareKeys() to always perform a case-insensitive 
2345    comparison and only perform a case sensistive comparison 
2346    if the case-insensitive one matches.  This ensures the 
2347    ordering is consistently reported.
2348
2349  * Add lock assertions to ensure that all calls are being 
2350    performed with the correct locks being held.  There have been 
2351    some crash reports that provide stack data that does not appear 
2352    to be possible unless there is a race.  However, there are no 
2353    obvious locations where the race is taking place and the test 
2354    suite indicates that all of the correct locks are being held. 
2355    We shall see what happens in the field.
2356
2357  * For consistency replace all calls to findKey in which the range i
2358    s (1,numentries) with calls to getSlot().
2359
2360  * Optimize the depth search loop by testing the slot value in the 
2361    for statement instead of forcing the loop to be broken later.
2362
2363  * Reorganize the locking for cm_BeginDirOp and cm_EndDirOp.
2364    There are a number of locations where locks are obtained, dropped, 
2365    and reobtained.  This reorganization attempts to accomplish several 
2366    things:
2367
2368    (1) be optimistic for the most common case so it will be fast
2369
2370    (2) add consistency checks after each location where locks are 
2371        dropped and re-obtained.  If we lose a race in cm_BeginDirOp 
2372        and the bplus tree is out of date, retry until we get to a 
2373        consistent state that we can use.
2374
2375    (3) Ensure that all operations take place with the correct locks.
2376
2377  * One of the issues that has become a serious problem since the 
2378    addition of the local directory updates is that although cm_SyncOp 
2379    synchronizes operations, it does not preserve the order of requests. 
2380    This has always been a problem in that it has been possible for a 
2381    request to fail to complete due to its worker thread's bad luck. 
2382    When a request takes longer than the Windows SMB Redirector's timeout, 
2383    the SMB Redirector tears down the SMB virtual circuit. 
2384
2385    When using the local directory updates it is really important that 
2386    the directory update operations complete in the order that they were 
2387    sent to the file server. If they don't, then the local directory state 
2388    and the file server state will not match and the local directory state 
2389    must be discarded which in turn forces a new read of the entire 
2390    directory contents over the network. 
2391
2392    This patch adds a new cm_scache_waiter_t object that is used to store 
2393    the current thread, buffer, and syncop flags within a waiters queue 
2394    on each cm_scache_t object. If a thread is forced to sleep in 
2395    cm_SyncOp, upon waking it will check to see if there are any other 
2396    threads waiting that are attempting to perform a similar task ahead 
2397    of it in the queue. If yes, the thread goes back to sleep. If not, 
2398    it goes ahead and enters the cm_SyncOp conflict resolution block. 
2399
2400    This patch has the additional side effect of reducing the number of 
2401    competing threads that must obtain the cm_scache_t mutex and process 
2402    the cm_SyncOp conflict resolution block. As a result, the overall CPU 
2403    utilization of the service and the clock time associated with processing 
2404    requests will be reduced.
2405
2406  * assert that the cm_scache_t mutex is held when calling
2407    buf_ForceDataVersion().
2408
2409  * rename findNode to leafNode in bplus_Lookup
2410
2411  * replace all OutputDebugString calls with osi_LogX calls
2412
2413  * modify bestMatch to special case the return values for leaf nodes.
2414    If an entry is above or below the values available in the leaf node
2415    return BTLOWER or BTUPPER instead of BTERROR.
2416
2417  * In insert and delete operations check for BTLOWER/BTUPPER and isleaf,
2418    if true convert to either slot 0 or Max and perform the insertion.
2419    This produces easier to read code when performing lookups.
2420  
2421  * modify lock_AssertXXX macros to call osi_assertx() and provide a
2422    descriptive message.
2423
2424  * the difference between osi_assert() and osi_assertx() is whether or not
2425    a description is specified as part of the call.  When no message is
2426    specified afsd_notifier() is called with a NULL msgp parameter.  This
2427    results in a null pointer dereference during the EventLog() call.
2428
2429    As a result, none of the information describing the assertion is written
2430    to the log file.
2431
2432    This commit sets a default message for use when no other message is
2433    provided and it replaces all calls to osi_assert with osi_assertx and
2434    adds descriptions.
2435    
2436  * Migrate B+ tree search key into thread local storage
2437
2438 Since 1.5.25
2439  * Fix an uninitialized variable in lana_IsLoopback() which 
2440    could result in a random determination that a loopback 
2441    adapter is not a loopback adapter.  This would result in 
2442    a computed Netbios service name of %MACHINE%-AFS instead
2443    of AFS.  This is a serious problem if the value computed
2444    by the AFS Client Service and the client process pioctl
2445    calls produce different results as it will result in a  
2446    communication failure.
2447
2448  * Fix a crash in the B+ Tree code that results when a file
2449    rename only results in a change of case.
2450
2451  * Fix the pioctl path parsing.  The previous algorithm 
2452    broke the current directory of the client into two parts,
2453    the TIDpath which represented the device root and the
2454    relative path.  The problem is that this is not sufficient
2455    from proper processing of symlinks and mount points.  
2456
2457    What is required is that the last component of the path
2458    must not have the symlink or mount point be evaluated
2459    whereas symlink and mount point evaluation must be performed
2460    for the rest of the relative path.  Therefore, the path is
2461    now split into three parts: TIDpath, intermediate path,
2462    and last component.  
2463
2464    "fs examine" now reports the data of the symlink or mount
2465    point object instead of the target and "symlink list" and
2466    "symlink remove" now works.  The "Explorer Shell Extension"
2467    menu now is displayed for symlink objects.
2468
2469  * More informative symlink.exe error messages.
2470
2471  * When the cmd.exe "del" command is used to remove a symlink,
2472    not only was the link object removed, but the stat cache
2473    object for the target was marked deleted.  This resulted
2474    in cache corruption which would require the destruction
2475    of the cache to correct.
2476
2477  * Add undocumented registry value, "OfflineReadOnlyIsValid"
2478    which results in cached contents from read only volumes
2479    to be treated as valid when there is no callback registered
2480    and all servers are down or all instances are offline.
2481
2482    HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
2483
2484  * Add documented registry value, "AcceptDottedPrincipalNames"
2485    which is used to permit the acquisition of AFS tokens 
2486    using Kerberos v5 principal names which include a dot in
2487    the first component.
2488
2489    {HKLM\HKCU}\Software\OpenAFS\Client
2490
2491  * "fs uuid" does not require "AFS Client Administrator" group
2492    membership to display the current UUID value.
2493
2494 Since 1.5.24
2495  * Update NSIS installer to version 2.30
2496
2497  * Update Wix installer to version 2.0.5325
2498  
2499  * 64-bit KFW support:
2500    - Network Identity Manager plug-in
2501    - 64-bit aklog
2502    - 64-bit krb5 enable afscreds.exe, afs server manager,
2503      etc.
2504
2505  * Enable B+ tree Directory Search by default.
2506
2507  * NIM plug-in is now compatible with FILE: ccaches
2508
2509  * Install instloop.exe into Client/Programs/ even though
2510    it isn't required.   Permit it to be used by organizations
2511    that clone Windows systems.
2512
2513  * On a suspend, only drop callbacks for servers that 
2514    are online.  If the server is offline, maintain the callback
2515    until the server is once again available.
2516
2517  * Prevent against acquisition of a directory write lock when
2518    there are no updates to be performed.  This was resulting 
2519    in a write-lock leak which later on would lead to a deadlock.
2520
2521  * Add configurable file pre-fetch mode.  For files that match
2522    the specified file extensions, pre-fetch the entire file into
2523    the cache.
2524
2525    HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
2526       (MULTI_SZ) PrefetchExecutableExtensions
2527
2528  * Fix the client_osi large integer support so that return values
2529    can be properly assigned to large integer variables.
2530  
2531  * Do not hold cm_scache_t mutex across cm_GetCell() calls 
2532    since cm_GetCell() can block in a RPC.
2533
2534  * Add short file name support to B+ tree searches.
2535
2536  * Resolve a conflict between the desire to notify file servers
2537    that the client workstation is suspending and the desire to
2538    permit objects with valid callbacks when the client suspends
2539    to continue to use those objects from the cache if the client
2540    resumes without network connectivity.
2541
2542  * Fix stack variables to ensure that all buffers storing paths
2543    can handle AFSPATHMAX (1024) characters.  Paths of 256 characters
2544    would cause a stack overflow condition.
2545
2546  * On Vista, force afs_config.exe to run with the highest privileges
2547    available to the end user.  For a user in the Administrators
2548    group running under UAC, this will cause afs_config.exe to be 
2549    be run with full Administrators privileges after the user 
2550    approves the privilege escalation.
2551
2552  * More VNOVNODE handling issues.  If a dirty buffer cannot be 
2553    written due to VNOVNODE, clear the buffer and ignore the error.
2554    If a cm_scache_t object has been marked deleted due to a VNOVNODE
2555    error, the next time the smb_fid_t object that references it is 
2556    used return either NOSUCHFILE or NOSUCHPATH and close the
2557    smb_fid_t object.  Subsequent attempts to use the smb_fid_t will
2558    result in an invalid handle error.
2559
2560  * For Vista, set the RequestExecutionLevel of the NSIS installer
2561    to "admin".
2562
2563  * For the build environment, support the generation of manifests
2564    when using the CL1310 (VS .NET 2003) compiler/linker.
2565
2566  * There was a bug in OutputDebugHexString() which could overflow
2567    a stack buffer resulting in unexpected process termination
2568    of afsd_service.exe if the input Security Token contained
2569    many bytes equivalent to the '%' char.
2570
2571  * Add directory lookup statistics to "fs memdump" output.
2572  
2573
2574 Since 1.5.23
2575  * Windows uses case-insensitive file name pattern matching
2576    but AFS is a case sensitive file system.  The AFS3 directory
2577    format is block based, uses network byte order and 
2578    includes a hash table for fast case sensitive lookups.  
2579    This causes several problems for the Windows AFS client.
2580    (1) Traversing the directory blocks is cpu expensive
2581    (2) A hash table miss does not indicate that the desired
2582        entry does not exist.
2583    (3) Determining whether a non-ambiguous inexact match or
2584        the entry does not exist requires a linear traversal
2585        of the entire directory.  
2586    These issues often result in 100% CPU utilization.
2587
2588    These issues are addressed by building a modified B+ tree for 
2589    each directory and then using the B+ tree for searches.
2590
2591    This feature is disabled by default.  To enable it set
2592    the "BPlusTrees" registry value to 0x01 in the AFS Client
2593    Service Parameters key.
2594
2595  * Correct a null pointer dereference in the symlink recursion
2596    detection code.  (Introduced in 1.5.22)
2597
2598  * Add the Network Identity Manager AFS Provider to AMD64 
2599    builds.
2600
2601 Since 1.5.22
2602
2603  * A new registry value, "BlockSize", can now be used to adjust 
2604    the size of the internal buffers used to store file data.  
2605    The default is 4KB.  When set, the values 1..1024 specify
2606    multiples of 4KB. Values > 1024 specify actual block sizes
2607    and must be multiples of 4KB.  The actual block size in KB 
2608    can not be larger than the chunk size which defaults to 1MB.
2609
2610     HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
2611       (DWORD) BlockSize
2612
2613  * pts.exe and ptserver.exe built with -DSUPERGROUPS
2614
2615  * Service Manager shutdown hints have been added.  The hint 
2616    specifies that it may take the AFS client service up to two
2617    minutes to shutdown. 
2618
2619  * Fix the recursion detection feature introduced in 1.5.22.
2620    The previous implementation broke the evaluation of paths
2621    using ../path or ./path.   It also broke the evaluation of
2622    symlinks to absolute paths.  For example, /afs/cell/path.
2623
2624  * Fix an uninitialized variable in cm_MakeDir that could result
2625    in crash if the requested directory could not be created.
2626
2627  * Fix a the VolumeStatusNotification log messages to save
2628    the input string in the circular log buffer so garbarge 
2629    won't be output to afsd.log when the log is dumped.
2630    
2631
2632  * Increase the SMB Maximum Path length to 260 characters
2633    from 256 as that is what CIFS supports.
2634
2635  * On 64-bit Windows, use a unique description string for 
2636    the 32-bit AFS Shell Extension.
2637
2638 Since 1.5.21
2639
2640  * In the AFS Admin Library, replaced all of the 
2641    Ubik_Call(XXX_RPC,...) calls with Ubik_XXX_RPC(...).  This 
2642    allows parameter checking and proper type conversions to be
2643    performed.  This is crucial when passing parameters that are
2644    64-bit wide on systems in which 'long' is a 32-bit value.
2645    Otherwise, the parameter list on the stack is interpretted
2646    incorrectly and the function not only doesn't succeed but it
2647    might corrupt memory and if lucky crash the application.
2648   
2649    The only program that we care about that uses this library 
2650    is the AFS Server Manager.  Now it doesn't crash.
2651
2652  * Fixed smb directory searches for non-wildcard names.  The 
2653    optimized function should not have set the bulk in progress
2654    flag.  This would adversely affect later directory searches
2655    that required a bulk search.
2656
2657  * Detect infinite recursions (up to 512 stat cache objects
2658    in a chain.)  If an infinite recursion is detected, return
2659    an error to stop the CIFS client from querying us forever.
2660
2661  * Executables executed out of AFS name space can have their
2662    pages swapped out by Windows.  Those pages will be reloaded
2663    when they are required.  However, if the cache manager no
2664    longer has a callback and all of the file servers with 
2665    the volume data are down, then the application will crash
2666    due to the inability to read the required page.  
2667
2668    We now track the down time of each server.  If the callback
2669    expires after the server that issued it went down and all
2670    servers are down, we delay the expiration to permit the data
2671    in the cache to be continue to be used by Windows or an 
2672    application.
2673
2674  * The Windows AFS client has always had very poor performance
2675    with regards to directory management.   In the case of 
2676    directory updates caused by create, rename,and delete operations,
2677    the AFS cache manager will now perform local directory updates
2678    when possible in order to avoid re-reading the directory from
2679    the file server.  This will be done in whenever both of the 
2680    following conditions are true:
2681
2682    - the data version on the directory increased by one as a 
2683      result of the operation
2684
2685    - all of the directory buffers necessary to make the change
2686      are present in the cache
2687
2688  * The error message in the AFS Control Panel describing the 
2689    need to be a Windows Administrator has been replaced with
2690    a message describing the need to be in the AFS Admins Group.
2691
2692  * If the vldb server list is empty when attempting to evaluate
2693    a cell mountpoint it was possible for a crash to occur.  This
2694    can only happen if there is an existing mount point and the
2695    is a failure attempting to load the server list from the 
2696    CellServDB file or via AFSDB queries.
2697
2698  * dirty buffers only have their dirty bytes stored to the file
2699    server instead of the entire chunksize
2700
2701  * the default chunksize has been increased from 128KB to 1MB
2702    
2703
2704 Since 1.5.20
2705
2706  * changed the enum values for cm_serverRef_t state info to use a 
2707    private name space to avoid collisions (srv_)
2708  
2709  * added a srv_deleted state for cm_serverRef_t objects.  This 
2710    state is set when cm_FreeServerList() is called with the 
2711    CM_FREESERVERLIST_DELETE flag set.  cm_FreeServerList() may
2712    not always delete the cm_serverRef_t from the list if it is
2713    still in use by another thread.  the srv_deleted state means
2714    the object's contents are no longer valid and it must be 
2715    skipped.  It will be deleted the next time the object is 
2716    freed and the refcount hits zero.
2717  
2718  * the srv_deleted state is also used when a file server reports
2719    either VNOVOL or VMOVED instead of marking the cm_serverRef_t
2720    as offline.  This is done to prevent additional usage of the 
2721    stale vldb data while waiting for the update volume request
2722    to complete.
2723  
2724  * added a state field to the cm_volume_t object (enum volstate 
2725    vl_ name space) that maintains the state of the volume based
2726    upon the states of all of the cm_serverRef_t and cm_server_t
2727    objects.
2728  
2729  * modified cm_UpdateVolume() to set the state of the cm_volume_t
2730    RW, RO, and BK to either vl_alldown or vl_online.  There can't
2731    be any other states because cm_UpdateVolume() destroys any  
2732    previous knowledge we might have had regarding busy or offline
2733    volume status
2734  
2735  * modified cm_UpdateVolume() to update the volume name in the 
2736    cm_volume_t to the volume base name if the previous value was 
2737    a volume ID.
2738  
2739  * modified cm_FollowMountPoint() to check to see if the volume
2740    name is a volume ID and if so call cm_GetVolumeByID instead 
2741    of cm_GetVolumeByName.  This ensures that volume IDs are always
2742    looked up as numeric values.  There is no longer a need to 
2743    maintain a separate cm_volume_t containing the string representation
2744    of the ID value.
2745  
2746  * Added a flags parameter to cm_GetVolumeByName() and cm_GetVolumeByID().
2747    The first flag is a "CREATE" flag which is set by all existing
2748    calls.  The flag is not set by calls to cm_GetVolumeByID() from
2749    the server probe code when volume status is being updated.  We 
2750    do not want the server probe operation to result in additional 
2751    turnover in the cached volume data.  The second flag is NO_LRU_UPDATE 
2752    which is set when the server probe code updates the volume status.
2753    This flag will be used to prevent the server probe operation from
2754    changing the order of the least recently used queue.
2755  
2756  * Modified cm_GetVolumeByName to ensure that only one cm_volume_t is 
2757    allocated for a given set of normal, readonly, and backup volumes
2758    regardless of whether or not the volume is accessed via name or 
2759    ID number.  The cm_volume_t namep field is always the base name
2760    of the volume. 
2761  
2762  * Added a new volume state, vl_unknown.  This state is used as
2763    the initial state for all cm_volume_t when the cache manager starts, 
2764    for each cm_volume_t at creation, and for each cm_volume_t when
2765    recycling.  The cache manager does not know the state of all 
2766    volumes in the world, only those that are in the cache and for
2767    which it has queried the VLDB and hosting file servers.
2768  
2769  * modified cm_GetVolumeByName() to initialize the state of a 
2770    volume to vl_unknown.  The actual state will be set when a 
2771    cm_VolumeUpdate() call completes successfully.
2772  
2773  * changed name of scache hash table variables to avoid ambiguity
2774    when adding hash tables for volumes
2775  
2776  * fix a buffer overrun in sys\pioctl_nt.c  pioctl().
2777  
2778  * modified cm_UpdateVolume() to handle the case in which there is
2779    no RW volume but there is are RO volumes for a given base name. 
2780    This is done by querying for the ".readonly" volume name if the 
2781    base name does not exist in the VLDB.  We never query for the
2782    .backup name because under the current usage model a .backup 
2783    volume may only exist on the server that the read-write volume
2784    is located.  If there is no RW volume, there can be no .backup.
2785  
2786  * Added four hash tables for cm_volume_t objects to improve the 
2787    search time of cm_GetVolumeByID(), cm_GetVolumeByName() and
2788    cm_ForceUpdateVolume(). One each for Name, RWID, ROID, and 
2789    BKID.  Three ID hash tables are necessary as long as it is
2790    desireable to maintain a single cm_volume_t containing all
2791    of the related RW, RO, and BK volume data.  Having the RW and
2792    RO volume data in the same object is necessary for the 
2793    implementation of cm_GetROVolumeID() which returns either the
2794    RO or RW ID depending upon the existence of RO volume instances.  
2795  
2796  * Added a volume LRU queue so that volume reuse becomes fairer.
2797    This does not replace the all Volumes list which is used when
2798    it is desireable to walk a list of all the volumes whose order
2799    is not going to change out from underneath you which makes it
2800    safe to drop the cm_volumeLock.
2801  
2802  * handles volume hash table updates where volume name to 
2803    volume ID number changes.  The volume name remains 
2804    constant in the cm_volume_t.  if a vos rename is performed, 
2805    the name of the volume will change and the volume IDs will be 
2806    updated.  Subsequent access to the old volume ID will create a 
2807    new cm_volume_t with the new name.
2808  
2809  * Added a daemon thread operation to query the state of volumes
2810    listed as busy or offline.  cm_CheckBusyVolumes() calls 
2811    RXAFS_GetVolumeStatus() for each volume ID that is marked vl_busy 
2812    or vl_offline.   If the volume is now online, the status on the
2813    volume is updated.  The default period is 600 seconds.  This can 
2814    be configured with the BusyVolumeCheckInterval registry value.  
2815  
2816  * Added prototype for smb_IoctlPrepareRead() which was missing a
2817    return type in the function definition.
2818  
2819  * Added volume id lists to the cm_server_t.  These lists are
2820    allocated in blocks of ~32 IDs.  When a cm_PingServer() 
2821    detects a change in server state, the state of the cm_volume_t
2822    is updated.  
2823  
2824  * Added volID to the cm_serverRef_t object.  volID is used
2825    to identify the volume for which the object is a referral.
2826    cm_FreeServerList() uses the volID to remove the volume 
2827    from the cm_server_t.
2828  
2829  * In cm_Analyze, when VNOVOL or VMOVED are received, 
2830    call cm_ForceVolumeUpdate() to force a refresh of the volume 
2831    location data.
2832  
2833  * Added cm_VolumeStatusNotification() which is used at the moment
2834    to log volume status changes to the trace log.  It will also
2835    be used as the access point to the File System Filter driver
2836    notification engine.
2837  
2838  * Added an all cm_scache_t list to cm_data.  This replaces the use
2839    of the stat cache LRU queue when we need to enumerate all 
2840    entries.  The LRU list order is not static and when using it to 
2841    enumerate all entries it can result in items being missed or
2842    items being processed more than once.
2843  
2844  * Modified cm_Analyze(). Instead of reseting the busy or offline
2845    state of a volume and forcing a retry of the operation
2846    cm_Analyze will defer to the background daemon thread that will
2847    update the state once every 600 seconds.
2848  
2849  * Added the automatic generation of a Freelance ".root" read-write
2850    mountpoint that refers to the root.afs volume of the workstation
2851    cellname at the time the mountpoint is created.
2852  
2853  * re-write cm_Analyze to make better use of the known volume
2854    status.  VL_Server queries cannot result in CM_ERROR_ALLOFFLINE
2855    messages.
2856  
2857  * renamed cm_CheckBusyVolumes to cm_CheckOfflineVolumes.  
2858    busy volumes will be reset to srv_non_busy by the function
2859    but there is no mechanism for querying the busy state other
2860    than by attempting to access the resource.
2861  
2862  * cm_Analyze will query the state of an offline volume before
2863    deciding whether or not to retry when all volume instances
2864    are offline.
2865  
2866  * the algorithm used after an IP address list change detection
2867    has been modified.  we now check the state of the VLDB servers,
2868    then reset the rx connections, and finally check the state of 
2869    the file servers.  Previously we flushed the rx connections 
2870    and then checked the servers in whatever random order they 
2871    were first discovered.
2872  
2873  * fix the volume status reported by "fs examine"
2874  
2875  * various improvements to the AFS Network Identity Manager Provider.
2876    - Don't access freed objects after the window has been destroyed.
2877    - Write back the AFS cell list in the identity configuration 
2878      even when its empty.
2879    - Disable all use of the provider when AFS is disabled for a 
2880      particular identity.
2881  
2882  * Fix cm_cell_t leak.  When evaluating a mountpoint that uses an
2883    alias instead of the full cellname, double check the full cell
2884    name and see if we have a matching cell before allocating a new
2885    one.
2886  
2887  * Dump more data with "fs memdump". All volumes and scaches and
2888    now cells.
2889  
2890  * Reverse the order of the all cells list.  This ensures that
2891    the workstation cell is always first in the list.
2892  
2893  * If we recognize the server from which a callback revoke was
2894    received, then we can ensure that we only invalidate the status
2895    information for cm_scache_t objects belonging to that cell.
2896  
2897  * When building for amd64, use APPVER 5.02 as we do not support
2898    64-bit Windows 2000 and explicitly state the machine type in
2899    the link flags.  
2900  
2901  * no longer treat VMWare network adapters as equivalent to a 
2902    loopback adapter.  For some unknown reason, publishing the "AFS"
2903    netbios name on them frequently results in a name collision 
2904    error.
2905  
2906  * Use read locks whenever possible instead of write locks when
2907    walking the allCellsp list.  This permits better use of multiple
2908    CPUs.
2909  
2910  * In 1.5.20 a bug was introduced by the fake status when PRSFS_READ
2911    is not present on the directory optimization.   It would report
2912    mount points and directory objects for which there was no
2913    status information as a zero length file.  Instead we can use 
2914    the vnode number of the object to determine if it should be
2915    considered to be a directory or a file.  If it is odd it is a
2916    directory; even it is a file.
2917  
2918  * Give Back Callbacks to the file servers in response to suspend
2919    and shutdown power management events.  Only give up callbacks
2920    to UP servers and do so with a very short RX dead timeout.
2921    (10 seconds)
2922  
2923  * Fix a race condition in the SMB FID cleanup code that could 
2924    result in a stat cache mutex never being released.
2925  
2926  * Fix the graphics files that are installed as part of the 
2927    IBM Administrators Guide.
2928  
2929  * Change the behavior of pioctl path parsing to not follow 
2930    symlinks or mount points during evaluation.  This results in
2931    the FID being the symlink or mount point and not the object
2932    they point to.  This is consistent with the behavior of the 
2933    UNIX client.
2934
2935  * Enable AFSDB record lookup for command line tools such as
2936    "fs" and "vos".
2937
2938  * CellServDB update 2007-07-05
2939
2940  * Added a Volume Status Plug-in Interface that permits third parties
2941    to receive notifications when the volume state changes occur.
2942
2943  * Ensure that all writes to the afsd_alloc.log file use CR-LF.
2944
2945  * Prevent the afsprocmgmt.dll from being unloaded while the 
2946    background thread it starts is running.
2947
2948  * Avoid a race condition when closing smb_fid_t objects.
2949
2950 Since 1.5.19
2951  * fix install path of IBM Quick Start Guide when installed by
2952    the Wix installer
2953
2954  * fix the client so that it can write into directories with
2955    only 'li' permissions.
2956
2957  * fix installation of 32-bit Shell Extension for 64-bit systems.
2958    Install it under its own HKCR keys.
2959
2960  * modify the wix installer to remove and upgrade install packages
2961    with the same version number.  
2962
2963  * when flushing volume location data every two hours or in 
2964    response to "fs checkvolumes", also flush the mount point 
2965    links in order to force their re-evaluation.
2966
2967  * aklog was copying an uninitialized buffer as part of the 
2968    foreign cell automatic pts registration
2969
2970  * when obtaining directory listings, check for read permission
2971    on the directory.  If read permission does not exist, fake the
2972    status information for the directory entries.  This improves
2973    performance, prevents the client from pounding the file server,
2974    and prevents leakage of cached status information.
2975
2976  * "fs getcacheparms" output was incorrect.
2977
2978  * NetIdMgr AFS Provider should only automatically add token 
2979    acquisition for cell foo.com if the realm of the cell matches
2980    the realm of the identity.
2981
2982  * Fix a null pointer dereference in cm_MergeStatus()
2983
2984 Since 1.5.18
2985
2986  * network identity manager provider:
2987
2988    - Correct for the fact that pr_CreateUser tampers with the 
2989      contents of the username input buffer.
2990
2991    - Take into account that the krb4 credential data structure
2992      does not have separate realm fields for the user and service.
2993      When krb524 is used with a cross-realm ticket, the realm
2994      describes the service not the user.  
2995
2996  * Many integrated logon changes:
2997
2998    - Fix eventlog reporting.  Do not attempt to log an event 
2999      if the event source registration fails.  Use DebugEvent0 
3000      instead of DebugEvent when there are no parameters.
3001
3002    - Modify the LOOKUPKEYCHAIN macro to recognize ERROR_MORE_DATA 
3003      errors.
3004
3005    - Fix the reading of Domain specific configuration for 
3006      LogonScript and TheseCells.  Previously the dwSize value was 
3007      being overwritten so that subsequent RegQueryValueEx call 
3008      would fail.
3009
3010    - Fix a memory leak in the TheseCells reading code.
3011
3012    - Add support for Domain specific "Realm" specification.  The 
3013      realm is the realm to be appended to the username.  When 
3014      logging in as a domain or to the local machine, the specified 
3015      "Domain" name is not going to be a valid realm name.
3016
3017    - Construct a proper principal name based upon the domain 
3018      specified realm for use in obtaining tokens with KFW.
3019
3020    - If the domain specified "TheseCells" list includes the 
3021      default cell, do not obtain tokens twice.
3022
3023  * An unprotected call to the Kerberos v5 function, 
3024    krb5_free_context(), can result in an invalid memory access
3025    exception if the contents of the krb5 profile, krb5.ini, cannot
3026    be parsed correctly.  The error is located within the afskfw
3027    library which is used by afscreds.exe, afssvrmgr.exe, and 
3028    afslogon.dll.  When the error is triggered within afslogon.dll
3029    a blue screen condition can occur when the winlogon.exe system
3030    process terminates unexpectedly.
3031
3032 Since 1.5.17
3033
3034  * Do not stop the afs client service with an assert
3035    if the cell name cannot be determined when responding
3036    to a "fs whereis" command.
3037
3038  * Integrated Logon (afslogon.dll).  No longer attempt 
3039    to preserve Kerberos 5 tickets for the logon session
3040    as that job is now supported by KFW 3.1 and above.
3041
3042  * The Network Identity Manager plug-in will attempt to
3043    remove expired service tickets from the cache.
3044
3045 Since 1.5.16
3046
3047  * CellServDB update - GCO Public CellServDB 09 Mar 2007
3048
3049  * AFS Server Manager and AFS Account Manager data cache
3050    moved from HKCU\Software\TransarcCorporation to 
3051    HKCU\Software\OpenAFS to prevent crashes due to data
3052    format changes.
3053
3054  * Reduce the default UP server probe time from 10 minutes
3055    to 5 minutes to match UNIX.  This will not solve the NAT
3056    port mapping timeout issue because most NATs default to
3057    a value less that 5 minutes and this value ensures that
3058    the afs client server will start probes 5 minutes after
3059    the last probe set ended.  The probe period for any one
3060    server is therefore longer than 5 minutes.  The more
3061    servers in the list the longer the time between probes.
3062
3063  * Before marking a server as down in cm_Analyze, retry the
3064    request using a new rx connection to the server.  If the
3065    cache manager is behind a NAT, it is possible that the 
3066    response from the server is being sent to the original   
3067    address:port from which the rx connection was established.
3068    This will appear to the cache manager as the server being
3069    down when in fact it is not.  Forcing the use of a new rx  
3070    connection will result in the server responding to the    
3071    most recent address:port assigned to the client by the NAT.
3072
3073    If the server is in fact down, it will simply take a little
3074    longer to notice it.   
3075
3076 Since 1.5.15
3077
3078  * Removing a directory that contained entries was failing with
3079    the wrong error code being returned to the CIFS client.
3080
3081  * rxdebug -long 
3082
3083  * rxdebug exponential back-off.  don't take down a server that
3084    is already struggling to respond.
3085
3086  * Network Identity Manager plug-in registers help on the Help
3087    menu if it is supported by NIM.  (KFW 3.2 and above)
3088
3089  * Plug-n-play networking did not always work after coming back
3090    from a Windows Suspend.  The AFS client service failed to 
3091    re-compute the LAN adapter to bind to and instead attempted
3092    to bind to all LAN adapters.  This would polute the public
3093    network with the name "AFS" which could lead to conflicts 
3094    between machines.
3095
3096  * Build installers using Microsoft Hotfixes provided at
3097    http://tinyurl.com/243svk for Visual Studio C RunTime Library
3098    Daylight Savings Time issues.  
3099
3100  * "fs checkserver" does not require admin privileges unless 
3101    the probe interval is being changed.
3102
3103 Since 1.5.14
3104
3105  * A reference leak was discovered in the mountpoint traversal 
3106    functionality which resulted in cm_volume_t objects not becoming
3107    eligible for re-use.  This will trigger a panic condition when
3108    more than the maximum number of volumes is accessed.
3109
3110  * Fixed the success test for the "fs memdump" operation.  Success
3111    is now reported as such.  Added cm_volume_t object information 
3112    to the dump file.
3113
3114  * A data corruption error has been fixed.  Write requests
3115    queued for background processing were not retried upon failure.
3116    This leads to inconsistencies between the contents of the file
3117    in the local cache and the contents of the file on the file 
3118    server.  
3119
3120    The implemented fix is to re-queue any request that has failed
3121    due to timeout, volume busy, volume offline, server busy, or
3122    server offline.  Requests are not processed while all servers
3123    for a volume are inaccessible.  When servers become accessible
3124    the background request will be retried.
3125
3126    In addition, if a background write fails, do not mark the buffers
3127    as clean.  Failure to preserve the dirty flag prevents the buffers
3128    from being written to the file server in the future.
3129
3130    This fix does not address the possibility that the credentials
3131    necessary to perform a write request might expire between the
3132    time the request is queued and when the request can be processed
3133    due to server accessibility.
3134
3135  * The Freelance volume does not support per user ACLs.  The
3136    cm_HaveAccessRights function did not handle this special case.
3137    Requests for privileges greater than read|lookup would result
3138    in afsd_service.exe entering an infinite loop.  ISOBuster is
3139    known to cause this behavior.
3140
3141  * When deleting files, the SMB Server would attempt to obtain
3142    the access permissions for the parent directory instead of 
3143    for the file itself.  This would result in an incorrect 
3144    assessment of whether or not the file can be deleted.
3145
3146  * The Network Identity Manager AFS plug-in has had its string
3147    tables updated for consistency with the language used by NIM.
3148    All credentials are referred to as credentials instead of tokens.
3149    Drop-down combo boxes now in fact drop down.
3150
3151  * The AFS Salvager was not properly being built on Windows.
3152    This is relevant only if the AFS servers are in use.
3153
3154  * The default signal handlers for the AFS servers incorrectly
3155    processed SIGQUIT.  Instead of stopping the server, an
3156    exception was raised.
3157
3158  * Fix another volume refcount leak.  This one was triggered by
3159    an inability to contact the vlservers in order to update the 
3160    file server list.
3161
3162  * Fix checklist control used by the drive mappings tabs in 
3163    afscreds.exe and afs_control.exe.
3164
3165  * Improve output of "fs memdump" related to buffer management.
3166
3167  * Fix refcount leak of cm_buf_t objects when prefetching buffers
3168    already in the process of being fetched.
3169
3170  * Improve cache performance by computing the buffer hash table
3171    size based upon the number of buffers so that the average 
3172    number of entries in a bucket is seven.
3173
3174  * Improve cache performance of read/write data by locally 
3175    updating the dataVersion of all buffers associated with the
3176    file on each StoreData or StoreStatus operation provided that
3177    the dataVersion was incremented by one and the dataVersion of
3178    the buffer matched the original dataVersion of the cached 
3179    status information for the file.
3180
3181  * When recycling cm_scache_t objects, make sure that we 
3182    clear all of the previous fields.  It is no longer the
3183    case that we can assume that the stat cache object is being
3184    obtained only after a successful FetchStatus call.  
3185    InlineBulkStatus will allocate stat cache objects for which
3186    the no status information is available.
3187
3188  * When a file is being opened with the OPEN_ALWAYS disposition,
3189    do not require write permissions when the file already exists
3190    unless of course the file is being opened requesting write 
3191    access.
3192
3193  * When a file has been opened for read-only access, if the 
3194    application requests an exclusive lock, obtain a read-lock
3195    instead of a write-lock.  The purpose of the exclusive lock
3196    in this situation is to prevent changes to the file and the
3197    full file read lock will provide this guarrantee.
3198
3199
3200 Since 1.5.13
3201
3202  * Enforce Unix Mode Write bit to prevent file deletion of read only
3203    files.
3204
3205  * The CIFS READ and LIST permissions use the same value 0x0001.
3206    When a directory is being accessed, check for PRSFS_LOOKUP 
3207    instead of PRSFS_READ.
3208
3209 Since 1.5.12
3210
3211  * Fix computations of short names of mount points.  They were
3212    broken as part of the directory search optimization. (1.5.13a)
3213
3214  * When all buffers are in use, periodically sleep the threads
3215    waiting for a buffer to become free while the global buffer
3216    lock is not being held in order to permit those threads that
3217    can free buffers to do so.
3218
3219  * Power Management improvements.  Maintain a global flag that 
3220    specifies whether or not the service is in a suspend state.
3221    Do not panic if Netbios() returns NRC_BRIDGE meaning that the
3222    lana is no longer valid.  Instead, stop the listener threads
3223    and if all listener threads are stopped, reset the lana_list.
3224    Allow the cm_Daemon() thread to periodically check the state
3225    of the smb listeners.  If they are all stopped and the service
3226    is not suspended, attempt to restart them.  If there are no valid
3227    lanas, return to the stopped state.
3228
3229  * CreateX and NTCreateX use cm_CheckNTOpen() to test whether or not
3230    the user is permitted to obtain read or write locks.  This function
3231    would obtain the lock and then drop it returning whether or not 
3232    the lock could be obtained.  If the lock was in fact required,
3233    CreateX/NTCreateX would then obtain it with cm_Lock().  The problem
3234    of course being that this pattern results in three RPCs to the 
3235    file server (lock, unlock, lock).  This is reduced to one RPC by
3236    implementing cm_CheckNTOpenDone() which frees the allocated byte
3237    range lock from cm_CheckNTOpen() after the cm_Lock() call is 
3238    performed.
3239
3240  * Optimize the SMB FindFirst processing for the case in which there
3241    are no wildcards.   If a cm_Lookup succeeds, generate a response
3242    from the stat cache entry we have a callback for.  Its cheaper 
3243    than walking each buffer of directory data associated with the
3244    directory stat cache entry when we have thousands of directory
3245    entries to search.
3246
3247  * Increase the SMB Ioctl MaxData size to support larger token sizes
3248
3249  * Disable autorun of the AFS Server Wizard when the AFS Server is 
3250    installed.
3251
3252  * Add AFS Server service dependencies on tcpip and PNP_TDI
3253
3254  * Remove the AFS Server Configuration Tool shortcut
3255
3256  * Add Freelance mode awareness to AFS Server Configuration Tool
3257
3258 Since 1.5.11
3259
3260  * Unlike previous versions of the OS, Vista performs a shutdown on
3261    the Microsoft Loopback adapter just like it would on a real adapter.
3262    This causes the smb_Listener threads to trigger a panic during a
3263    suspend/hibernate power event.
3264
3265    The fix is to unbind from the network adapters in response to a
3266    suspend/hibernate power event and then rebind to the adapters
3267    when a resume power event is received.  Note that the resume events
3268    are not reliably delivered so it is possible the afs service will
3269    not be accessible.  However, this is the best we can do.
3270
3271  * don't allow environment variables we set in afslogon.dll to be 
3272    inherited by child processes
3273
3274  * force an rx connection reset if VICECONNBAD or VICETOKENDEAD are
3275    received
3276
3277  * The old dirty buffer synchronization algorithm had a buf_IncrSyncer
3278    thread walking the all buffer list periodically searching for dirty
3279    buffers to write to the file server.  This had several negative
3280    results.  The algorithm ate up ever increasing amounts of CPU time
3281    even when AFS is idle as the size of the cache increases.  Also,
3282    buffers were written to the file server in an order based upon the
3283    original buffer allocation which has nothing to do with the order
3284    in which the buffers became dirty.
3285
3286    The new algorithm maintains a dirty buffer list.  Items are added
3287    when the buffer is originally marked dirty.  A buffer is only
3288    removed from the list by the buf_IncrSyncer when the buffer is no
3289    longer dirty.  If the list is empty the thread goes back to sleep
3290    immediately without additional processing requirements.
3291
3292 Since 1.5.10:
3293
3294  * Enable renaming of directories from the Explorer Shell when
3295    Offline Folders is enabled
3296
3297  * An error is reported in response to the SMB ReceiveCoreFlush 
3298    request when an error has not occurred.
3299
3300 Since 1.5.9:
3301
3302  * optimize dirty buffer flushes in response to suspend operations
3303    do not flush if only loopback adapter is installed
3304    do no retry dirty buffer writes
3305
3306  * do not reset netbios when performing loopback checks.  doing
3307    so will break the existing lana bind
3308
3309  * remove a deadlock in smb3.c QPathInfo 
3310
3311 Since 1.5.8:
3312
3313  * Add NetIDMgr AFS Plug-in
3314
3315  * "Show Tray Icon" checkbox removed from afs_config.exe
3316
3317  * Disable DNS Registrations for the Loopback Adapter and make sure
3318    that Netbios is turned on.
3319
3320  * A reference count leak on stat cache objects was fixed
3321
3322  * For debugging, tread ids of writers are now tracked on locks
3323
3324  * Corrected an incorrect lock that was being held but not
3325    freed in a rare error case
3326
3327  * Changed trace log end of line to CR-LF so it can be read
3328    with notepad.exe
3329
3330  * modify the buffer synchronization thread to write all dirty
3331    buffers and sleep only when there is no work to be done
3332
3333  * improve behavior of cache manager when large numbers of 
3334    temporary files are being created by multiple clients within
3335    the same directory.
3336
3337  * do not permit dirty buffers that belong to deleted files
3338    to be written to the file server.  its a waste of bandwidth
3339
3340  * do not leak stat cache references when the file server
3341    returns VNOVNODE
3342
3343  * afscreds: do not permit an attempt to obtain tokens if the
3344    afs service could not be started.   this was causing stack
3345    overflows on Vista after resuming from a suspend
3346
3347 Since 1.5.7:
3348
3349  * better handling of dot directory
3350
3351  * fs sq and fs mkm now behave as on UNIX
3352
3353  * add license to installers
3354
3355  * Return Invalid Parameter error for unknown InfoLevels in
3356    SMB Tran2 Search Directory.
3357
3358  * Correctly use WSAStartup and WSACleanup within the RX library
3359
3360  * Check that afsd_service.exe is running before performing
3361    a pioctl call.
3362
3363  * Force AFS Shell Extension to load resource DLL using 
3364    afs_shl_ext.dll as a base name.
3365
3366  * (Wix) install afs_shl_ext_XXXX.dll and afs_creds_XXXX.dll in 
3367    OpenAFS\Client\Program
3368
3369  * Fix SMB_SET_FILE_END_OF_FILE_LENGTH
3370
3371  * Do not panic if the maximum number of volume entries are in use
3372    and one of them can be recycled.
3373
3374 Since 1.5.6:
3375
3376  * Fix the code that reads the backconnnectionhostnames value
3377    so that there is not an uninitialized variable
3378
3379 Since 1.5.4/1.5.5:
3380
3381  * integrated logon could cause winlogin.exe to blue screen windows
3382    if it was called with a domain that does not exist on the machine.
3383    this is possible during a sysprep.
3384
3385  * corrections to cm_buf_t handling to ensure that buffers are
3386    removed from queues before they are freed and that holds are
3387    obtained on the next buffer in a chain before releasing the
3388    current one.
3389
3390  * do not generate MessageBox dialogs on network errors.  they 
3391    cause more trouble then they are worth.
3392
3393  * move GlobalAutoMapper into a separate thread so that it does
3394    not prevent service startup if the WNetAddConnection2 call
3395    does not return.
3396
3397  * restrict hard dead and connection timeouts to the CIFS Session
3398    Timeout value.  This is being done to try to prevent virtual 
3399    circuits from being destroyed prematurely.
3400
3401  * Fix the code that writes the backconnectionhostnames value
3402    to ensure that the data buffer is written with the correct 
3403    length.
3404
3405  (there were no windows specific changes between 1.5.4 and 1.5.5)
3406
3407 Since 1.5.3:
3408
3409  * Corrections to the Integrated Logon functionality that permits
3410    Kerberos 5 TGTs to be communicated into the user session.  The
3411    transfer is now more secure and succeeds when the user does not
3412    have read permission to the %SystemRoot%\TEMP directory.
3413
3414  * NSIS installer updated to version 2.18
3415
3416  * WiX installer updated to version 2.0.4221.0
3417
3418  * Updates to the IFS functionality for 64-bit correctness and 
3419    permit compilation.   The IFS functionality works for pioctl()
3420    operations but not much else at this point.
3421
3422  * A major re-write of the OpenAFS implementation of the CIFS Tran2
3423    query and set functions.  
3424
3425  * Ignore the Windows CIFS client session timeout entirely.  Timeout
3426    only after the AFS Hard Dead Timeout period expires.
3427
3428 Since 1.5.2:
3429
3430  * move headers, libraries, and samples from OpenAFS\Client to 
3431    OpenAFS\SDK
3432
3433  * remove the auto-registration of AFS IDs for foreign cells
3434    from integrated logon.  this permits afslogon.dll to avoid 
3435    initializing the RX library.  afslogon.dll is a network 
3436    provider library and as such it is loaded into all applications
3437    which perform a CreateProcessAsUser call.  Initializing the
3438    RX library spawns background threads to listen for inbound
3439    packets.  When the network provider is unloaded from the 
3440    process, the RX library does not cleanup the threads.  If they
3441    continue to execute after the library is unloaded, the process
3442    will crash.
3443
3444  * implement inline bulk status calls.  this will significantly
3445    improve the performance of directory listings.
3446
3447  * prevent a crash when evaluating mountpoints to volumes that do not
3448    exist
3449
3450  * new command: fs uuid [-generate]
3451    displays the current uuid and allows a new one to be generated
3452    on the fly without restarting the afs client service.
3453
3454  * fix the 64-bit installers to properly document the install 
3455    location
3456
3457  * move help files to the proper location so they can be located by
3458    the system tray tool and the control panel.
3459
3460  * "over quota" and "disk full" errors were not being reported to the 
3461    caller.
3462
3463  * largefile support has been added.  Files greater than 31-bits can no
3464    longer be written to file servers which do not support large files.
3465    When file servers support large files, files up to 64-bits can be
3466    read or written.
3467
3468  * cm_SyncOp could return with the input buffer unlocked upon error
3469    which would result in a panic condition.  This bug was introduced
3470    in 1.4.1.
3471
3472  * vlserver failover when freelance mode did not work.  This prevented
3473    the root.afs volume from being loaded if the first vlserver could
3474    not be reached.
3475
3476 Since 1.5.1:
3477
3478  * A bug in the CIFS Standard Info response packet caused directories
3479    to appear as standard files.  This prevented Microsoft Vista from
3480    being able to walk the AFS directory tree.
3481
3482  * Mount points must be reported as directories in response to 
3483    Query Path Info operations.
3484
3485  * A deadlock was detected when performing "fs flushall" if the 
3486    file server reports VNOVNODE.   The scp->createBufferLock is 
3487    already held by the current thread and there is no mechanism 
3488    to propagate the knowledge.  Therefore, an alternate mechanism 
3489    for clearing the cache must be developed.  A new function 
3490    cm_RecycleSCache(scp,flags) has been extracted from 
3491    cm_GetNewSCache().  This function performs the task of recycling 
3492    an cm_scache_t object.  When called from cm_GetNewSCache() with 
3493    no flags the expectation is that there are no associated buffers 
3494    that are queued to be read or written.  When called from 
3495    cm_Analyze() with the CM_SCACHE_RECYCLEFLAG_DESTROY_BUFFERS
3496    flag, any queued buffers will be de-queued and marked as if 
3497    the operations were performed so the data can be discarded.
3498
3499  * CM_ERROR codes were logged as "unknown" by cm_Analyze.
3500
3501  * In response to VNOVNODE, the parent is only discarded if the current
3502    cm_scache_t is not a directory.
3503
3504  * In the Ioctl FlushFile and FlushVolume functions, there were no
3505    checks to protect against flushing the Freelance SCache entries.
3506
3507  * In FlushFile, the wrong cm_scache_t object was being released.
3508
3509  * In cm_GetNewSCache, do not allow Freelance SCache entries to be
3510    recycled.  Choose a new entry if cm_RecycleSCache fails.
3511
3512  * Speed up the performance of the cache manager by not 
3513    holding the smb_fid_t mutex across calls to cm_SyncOp 
3514    and AFS RPCs.
3515
3516  * Ensure that all smb_fid_t flag references are protected.
3517
3518  * Remove a deadlock between smb_fid_t mutex and 
3519    smb_rctLock introduced in 1.4.1.
3520
3521  * Fix aklog AFSID lookup to use not send the realm
3522    name when the realm is the local realm for the 
3523    cell.  The PT Server doesn't strip the realm 
3524    name when it is the local realm.
3525
3526  * Treat "\\afs\*." as an alias for "\\afs\all" 
3527
3528  * Dynamically adjust the priority of server threads
3529    based upon the age of the CIFS request that is 
3530    being processed.  The priority is bumped one level
3531    for every 15 seconds of processing time.
3532
3533  * The original openafs contribution mis-used the 
3534    cm_GetCallback function.  This function should only
3535    be called as a side effect of a call to
3536    cm_SyncOp(CM_SCACHESYNC_NEEDCALLBACK).  The way it
3537    was being called results in a FetchStatus RPC being 
3538    performed even when the client already has a valid
3539    callback and does so in a manner that destroys the
3540    synchronization of the threads that are calling 
3541    cm_SyncOp.  If nothing else this results in a 
3542    significant performance penalty.
3543
3544  * More changes to cleanup of smb_vc_t objects in
3545    order to prevent race conditions.
3546
3547  * Reduce the amount of Power Management event logging
3548    to afsd_init.log
3549
3550  * If the client detects that the IP address has 
3551    changed, force the use of new RX connections.  This
3552    enables the file server to recognize that the client
3553    has moved.
3554
3555  * Remove a race condition and deadlock associated 
3556    with cleanup of smb_vc_t objects.
3557
3558  * Fix the ANSI filename support.  One function that
3559    required it was missing the translations.
3560
3561 Changes not present in 1.4.1 and since 1.5.0: 1.5.1 released 
3562 (24 April 2006)
3563
3564  * Add a DllMain() function to afspthread.dll.  Perform
3565    cleanup of thread local storage, rx queues, critical
3566    sections, event handles, etc.  This was implemented
3567    to avoid crashes in afspthread.dll when applications
3568    which load/unload the dll attempt to terminate.
3569
3570  * Lock request behavior has been altered.  As of this 
3571    release a locally allocated lock will be used whenever
3572    the volume is RO or the requesting user's permissions 
3573    are 'rl'.  This will allow end users to execute programs
3574    from RW volumes when they do not have the 'k' privilege.
3575
3576    Note that a recent discovery indicates that the 'k' bit
3577    is only supposed to control the ability to obtain read 
3578    locks.  Write locks are to be controlled by the 'w' and 
3579    'i' privilege bits.  
3580
3581  * Code has been added to enable the cache manager to be
3582    able to obtain the AFSID of the authenticated user.
3583    This is required to be able to determine when "Insert"
3584    privileges should apply.  AFS considers a file to be
3585    a new file whenever the owner's AFSID matches the 
3586    AFSID of the user.  The current implementation relies
3587    on the name specified during the SetToken call to be
3588    correct.  This will be replaced in the future with a 
3589    new RPC that allows the AFSID of the authenticated 
3590    user to be obtained.
3591
3592  * A 32-bit-tools installer for use on 64-bit systems 
3593    is now available.  These tools are for use with 32-bit
3594    versions of Kerberos for Windows or JPSoftware's 4NT.
3595
3596 Since 1.4.1 rc10: 1.4.1 final released (9 April 2006)
3597
3598  * Remove the use of the "active_vcp" variable.  This variable
3599    no longer serves any useful purpose and was the cause of
3600    race conditions that produced under counts of the smb_vc_t
3601    references.
3602
3603  * Change default minidump output to include data segments
3604
3605  * restore access to cm_IoctlGetVolumeStatus and
3606    cm_IoctlSetVolumeStatus calls for AFS pioctl operations.
3607    Still need to figure out why they are being called
3608    for SMB/CIFS IOCTL operations instead of Trans2GetFileInfo.
3609
3610 Changes not present in 1.4.1: 1.5.0 released (16 Feb 2006)
3611
3612  * Update build system to include the "sys_name" in the 
3613    obj and dest paths.
3614
3615  * optimize the number of calls to obtain the smb_user_t for a 
3616    smb virtual circuit.
3617
3618  * add logging of server addresses, status and capabilities when
3619    pinging the server.
3620
3621  * prevent multiple threads from pinging the same server simultaneously.
3622    instead, threads block and then use the result of the ping that was
3623    already taking place.
3624
3625  * Add registry values to allow the defaults for daemon checks to be altered
3626    at startup.  Log values to afsd_init.log.
3627
3628    daemonCheckDownInterval
3629    daemonCheckUpInterval
3630    daemonCheckVolInterval
3631    daemonCheckCBInterval
3632    daemonCheckLockInterval
3633    daemonCheckTokenInterval
3634
3635  * Add EventLog messages for transitions in fs crypt state.
3636
3637  * Byte range locking (when locks will be obtained from the
3638    is still under discussion)
3639
3640  * 64-bit Windows operating systems now supported 
3641    (XP SP2 64-bit, 2003 SP1 64-bit, 2003 R2 64-bit)
3642    This is a native 64-bit implementation of OpenAFS for Windows.
3643    There is currently no 64-bit version of KFW and therefore 
3644    there is no (easy) method for obtaining AFS credentials.  
3645    32-bit KFW 3.0 can be used with 32-bit OAFW libraries
3646    to obtain AFS tokens but there is not for the feint of 
3647    heart.
3648
3649  * A faster implementation of the fcrypt algorithms improves 
3650    performance.
3651
3652  * The afsd_service.exe now supplies Event Log Message Text.
3653    The event log no longer generates warning text due to lack
3654    of message configuration.
3655
3656  * When afs servers are unreachable and network stack returns
3657    a WSAEHOSTUNREACHABLE error, the AFS client will immediately 
3658    mark the attempted server as being down.   This allows for
3659    very fast response to the calling application.  This change
3660    has a pronounced improvement when the Windows Explorer is
3661    used on disconnected mobile computers.
3662
3663  * Added DebugOutputString debugging of the RX library
3664
3665 Since 1.4.1 rc9:  1.4.1 rc10 released (10 March 2006)
3666
3667  * Fix the rx-lwp implementation to randomly generate rx call
3668    identifiers which are supposed to be unique at a given point
3669    in time.  This affects some of the command line tools used
3670    for debugging but not the AFS Client Service itself which
3671    uses the rx-pthreads implementation.
3672
3673  * xstats_fs_test.exe and xstats_cm_test.exe are now built for
3674    Windows although they are not distributed
3675
3676  * don't generate an exception when logging unexpected SMB packets
3677
3678  * the data structures used by cm_IoctlGetVolumeStatus and 
3679    cm_IoctlSetVolumeStatus are not compatible with the CIFS
3680    Get/Set File Information calls so don't bother executing them.
3681
3682 Since 1.4.1 rc8:
3683
3684  * Fix data written to registry as part of BackConnectionHostnames
3685    data value
3686
3687  * Fix initialization bug when allocating cm_server_t objects that
3688    would cause servers to appear to be down after each allocation
3689    or renewal.   Server would appear up after the next check servers
3690    cycle.
3691
3692 Since 1.4.1 rc7: 
3693
3694  * Windows will return WSAECONNRESET to the next receive packet
3695    operation on a socket if an ICMP packet is received in response
3696    to a packet that was sent and could not be delivered because
3697    the port was unreachable.  We have to treat this as 
3698    WSAEWOULDBLOCK so that we can retry the select() check and
3699    not mark the connection as bad.
3700
3701 Since 1.4.1 rc6: 1.4.1 rc7 released (14 Feb 2006)
3702
3703  * The client manager maintains a least recently used list of
3704    all the ACLs.  If an ACL is already the most recently used
3705    do not bother to remove it from the list and place it on the
3706    front.
3707
3708  * As part of the process of adding a new server, set the 
3709    server is down flag and then perform a ping.  If the server
3710    is up, the flag will be reset.  If the server is down, the
3711    client will not timeout unnecessarily while attempting to
3712    perform real work.
3713
3714  * If a Mountpoint String is the empty string, return PATH NOT 
3715    FOUND.
3716
3717  * Modify behavior of the Network Provider to avoid querying the
3718    profile location if integrated logon is known to be disabled.
3719
3720  * Correct behavior of 'LogoffPreserveTokens'.  When set, tokens
3721    will always be preserved regardless of whether or not integrated
3722    logon was used to obtain tokens.  When unset, tokens will be 
3723    destroyed regardless of whether integrated logon was used to 
3724    obtain the tokens unless the profile is stored in AFS.
3725
3726  * Disable LogoffTransferToken functionality.  The SMB V3 Logoff
3727    message is being delivered even when the user is not logging
3728    off of the computer.  
3729
3730  * Fix a deadlock condition introduced in rc6.
3731
3732  * Cell names are case-insensitive.  Since the founding of OpenAFS
3733    there has been a bug that treated "cell", "Cell", and "CELL" as
3734    different cells.  This would result in what appeared to be 
3735    random disappearance of user tokens or a failure to authenticate
3736    even when tokens were listed by the "tokens" command.
3737
3738 Since 1.4.1 rc5: 1.4.1 rc6 released (2 Feb 2006)
3739
3740  * Additional auditing of the smb code revealed that smb ioctl
3741    operations were failing to free smb_fid_t objects
3742
3743  * The File Identifiers assigned to smb_fid_t objects could be
3744    given the value 65535 which is 0xFFFF which is also the 
3745    INVALID_HANDLE value.  Both 0 and 65535 are now treated as
3746    reserved values.
3747
3748  * Audited all assignments to fields and ensured that they are
3749    protected by obtaining the relevant mutex object.
3750
3751  * Re-wrote the VNOVNODE handling to avoid a potential deadlock
3752    if both the current cm_scache_t object and its parent are
3753    both returning VNOVNODE.
3754
3755  * Removed all the logic associated with the 'dead_vcp' variable
3756    which must have been added for debugging because its used 
3757    was never thread safe and it truly served no purpose.
3758
3759 Since 1.4.1 rc4: 1.4.1 rc5 released (25 Jan 2006)
3760
3761  * Re-enabled LogoffTokenTransfer and LogoffTokenTransferTimeout
3762    registry settings.  Default is ON and 120 seconds.  If set to 
3763    OFF, tokens will not be destroyed.
3764
3765  * Fixed a number of race conditions and reference count problems
3766    associated with global queues.
3767
3768  * Added a method to detect abandoned smb virtual circuits so their
3769    associated file handles, locks, user tokens, and smb session
3770    resources can be released.
3771
3772  * Added a mechanism to allow user tokens to be preserved 
3773    during integrated login and be freed after logoff.
3774
3775  * Check access permissions to the file before the file is 
3776    truncated.
3777
3778  * More improvements to the handling of SMB Virtual Circuits
3779    when SMB sessions are closed.
3780
3781  * Correct a race condition introduced in rc4 that could result
3782    in a crash of afsd_service.exe.
3783
3784 Since 1.4.1 rc3: 1.4.1 rc4 released (11 Jan 2006)
3785
3786  * Properly handle pre-mature SMB session closures.
3787    File handles, tree connections, and user sessions are now
3788    freed when the virtual circuit is closed.
3789
3790  * smb_username_t and smb_user_t objects are now properly reference
3791    counted and freed as appropriate.
3792
3793  * disable to use of AFS file locks.  byte range locking is still
3794    implemented but all locks are managed locally.  This prevents
3795    multiple processes from editing the same file on the same 
3796    machine but it does prevent multiple processes on separate 
3797    machines from modifying the file.
3798
3799 Since 1.4.1 rc2: 1.4.1 RC3 released (4 Jan 2006)
3800
3801  * A fix to "fs setserverprefs -vlserver".  Multiple calls with
3802    the same server parameter would result in a panic condition
3803    if the server had not already been contacted by the AFS 
3804    client service.
3805
3806  * Better warnings are written to the afsd.log file when 
3807    the Windows RPC Protocols are not properly configured as
3808    is often the case on Windows 2000.
3809
3810  * fix the procmgmt library to restore C RTL signal handlers when 
3811    it is being detached from the process prior to process termination.
3812
3813 Since 1.4.1 rc1: 1.4.1 RC2 released (30 Nov 2005)
3814
3815  * close a lock leak in the rx library that could be triggered while
3816    processing aborts
3817
3818  * prevent removal of drive mappings in response to afscreds.exe -M
3819
3820  * add logic to process VNOVNODE in cm_Analyze.  Force re-evaluation of symlink
3821    strings and flush the stat cache entry.
3822
3823  * prevent server objects from being freed if user preferences are set.
3824
3825  * Update WIX support to 2.0.2419.0
3826
3827  * Release all locks on the server at service shutdown.
3828
3829  * A down server should be marked up as long as it responds to the client.
3830    It doesn't matter if the server returned an error as long as the error
3831    is something other than VRESTARTING.  If there is such an error, all
3832    connections on that server should be marked for replacement.
3833
3834  * Change the check "up" servers period from once per hour to once every
3835    ten minutes.  This matches the behavior of the Unix cache manager.
3836
3837 Post 1.4.0 revisions: 1.4.1 RC1 released (21 Oct 2005)
3838  * Byte Range Locking support has been added.  Architectural documentation
3839    is located within src/WINNT/afsd/cm_vnodeops.c.   Best efforts are
3840    made to enforce Windows mandatory locking model using locally managed
3841    byte range locks with full file locks obtained from the file server.
3842    Read-only volumes provide the user with an implied locking privilege.
3843    Read-write volumes require that a user be granted the locking privilege
3844    in order for a lock to be obtained.   As most Windows applications use
3845    Shared file access modes, they require the ability to obtain locks in
3846    order to access files.
3847
3848  * Implement error translation functions to convert Universal Error Codes
3849    output by modern servers to local errno and winsock error values.
3850    This fixes the error message problems using pioctl() calls from fs.exe
3851    and the AFS Shell Extension.
3852
3853 Since 1.4.0 rc8: 1.4.0 final tagged (20 Oct 2005); released (31 Oct 2005)
3854  * Allow the AFS Client Service to set the firewall configuration by
3855    retrying until after Windows determines the boot period is over.
3856
3857  * Do not attempt to configure the firewall on Windows 2000, XP pre-SP2,
3858    or 2003 pre-SP1
3859
3860  * Detect IP address changes from within the AFS Client Service for the
3861    purpose of checking down servers sooner
3862
3863  * If the file server or vldb server report RXKADUNKNOWNKEY, return
3864    SEC_E_NO_KERB_KEY to Windows.   This provides an indication to the
3865    user that there is a Kerberos key problem.  Previously the user would
3866    receive no feedback when there was something wrong.
3867
3868  * Fix the large integer library support to properly handle values greater
3869    than 32-bits
3870
3871 Since 1.4.0 rc7: 1.4.0 rc8 released (15 Oct 2005)
3872  * Updated CellServDB
3873
3874  * Fixed file name pattern matching.  Question marks can match nothing
3875    if found at the end of a component.
3876
3877 Since 1.4.0 rc6: 1.4.0 rc7 released (8 Oct 2005)
3878  * Kerberos 5 ticket lifetimes should adhere to KFW Leash lifetimes
3879
3880  * The MSI installer now has a new Product ID for each build.  This
3881    is to allow for automated upgrades.   The Upgrade ID is remaining
3882    constant.
3883
3884  * Volumes that were cached and then subsequently were salvaged,
3885    moved or otherwise taken temporarily offline (as opposed to being
3886    busy) would become unreachable.  A distinction is now made between
3887    a volume being offline and a server being down.
3888
3889 Since 1.4.0 rc5: 1.4.0 rc6 released (2 Oct 2005)
3890
3891  * Fixed several AFS Shell Extension issues:
3892    - Checking Server Status would only work if a specific cell was
3893      specified.
3894    - If servers were down, the Server Down dialog would write to 
3895      invalid memory and cause explorer.exe to crash
3896    - Default Push Buttons were not specified for many dialogs
3897    - The extension would be unloaded by the Explorer Shell and
3898      never be reloaded under some circumstances. 
3899
3900  * Fixed the AFS System Tray menu to disappear if another Window
3901    was selected before a menu item was selected
3902
3903  * Added volume owner and group information to "fs examine" output
3904
3905  * Added fs and registry support for enabling/disabling/clearing 
3906    rx statistics gathering.
3907
3908 Since 1.4.0 rc4: 1.4.0 rc5 released (25 Sep 2005)
3909
3910  * New Product Code GUIDs issues for 1.4 and 1.5 branches.  Separate
3911    GUIDs for each platform.
3912
3913  * Documentation directory structure and default installation rules
3914    for MSI 
3915
3916  * New OpenAFS for Windows HTML Release Notes installed
3917    as part of the documentation set.
3918
3919  * Add thread id to rx debugging messages
3920
3921  * When all servers are offline, return a bad network path error
3922    immediately.  This is necessary to allow Explorer to do the 
3923    right thing and not hang.   The background daemon thread will
3924    check the down servers every 30 seconds to see if they are
3925    back up.  
3926
3927 Since 1.4.0 rc3: 1.4.0 rc4 released (14 Sep 2005)
3928
3929  * The AFSCache file has been modified to store both the
3930    serial number of the volume on which the file resides
3931    and the SID of the local machine.   If either change,
3932    a new UUID is generated.
3933
3934  * add "fs flushall" command that forces all data buffers
3935    to be flushed.
3936
3937 Since 1.4.0 rc2: 1.4.0 rc3 released (4 Sep 2005)
3938
3939  * add support for '/' instead of '\' in pioctl() calls
3940
3941  * Apply AFS Client Admins group protect to AFS Shell Extension
3942
3943  * Add support for \\afs\<name> to most AFS Shell Extension 
3944    commands except the symlink methods. 
3945
3946  * when installing the Microsoft Loopback Adapter, enable
3947    MS Client for Networks and prevent an install failure 
3948    by not calling CoInitialize twice in the same thread.
3949
3950  * reload cell vldb values from the CellServDB every two
3951    hours in case it changes
3952
3953  * When updating cell information from DNS, be sure to set 
3954    a new timeout.
3955
3956  * Add support to allow use of \\AFS\<foo> where <foo> is 
3957    either a mount point or symlink.   As <foo> is normally 
3958    treated as a share name, we transform it into \\AFS\all\<foo> 
3959    for processing.
3960
3961  * Init 'code' to prevent false errors when integrated logon 
3962    is disabled and the service is not running
3963
3964 Since 1.4.0 rc1: 1.4.0 rc2 released (28 Aug 2005)
3965
3966  * Removed trace log messages that were hampering performance.
3967
3968  * Fixed a deadlock that was being triggered by editing Word 
3969    documents stored within AFS with WinWord 2003.
3970
3971  * Bit 3 of the TraceOption registry value is now used to set the
3972    default for "fs trace" in the non-Debug builds.  The new default
3973    is off for release builds and on for debug builds.
3974
3975  * Bit 2 of the TraceOption registry value can be used to turn on
3976    real-time output of debug log entries to the Windows Debug
3977    Output monitor interface.  This data can be viewed with tools
3978    such as Sysinternal's DbgView.
3979
3980 Since 1.3.87: 1.4.0 rc1 released (17 Aug 2005)
3981  * When the cache manager reports ALLBUSY or ALLOFFLINE for
3982    a resource we should not be returning status codes such
3983    as Network Busy or Remote Host Down because these errors
3984    will imply that the AFS Client Service is Busy or Down
3985    and that is simply not the case.   Instead we will return
3986    Bad Network Path as the path is temporarily not available.
3987
3988    Instead of returning Sharing Paused when there is a
3989    timeout error, return Timeout.  Once again, the AFS Client
3990    Service is not paused.
3991
3992  * afscreds.exe would display an Obtain Creds dialog when
3993    the expired credentials reminder was triggered even 
3994    if there was no network path to the KDC.  This is prevented
3995    by adding KDC probe logic to the reminder thread.  
3996
3997  * afscreds.exe would display expired tokens no differently
3998    than unexpired ones.  This would make it difficult for the
3999    user to distiguish when the tokens were expired.  For the 
4000    English build added a new resource string "(expired) that
4001    is displayed instead of the expiration time. 
4002
4003 Since 1.3.86:
4004  * "fs wscell" when executed in freelance mode will return the
4005    name of the cell configured in the registry.  The root.afs
4006    volume is not loaded from this cell, but it is used for the
4007    default for aklog and integrated login.
4008
4009  * "fs mkmount, fs rmmount, symlink make, symlink remove" will
4010    no longer work on \\AFS\all when freelance is being used 
4011    unless the user is a member of the "AFS Client Admins" Windows
4012    Security group.
4013
4014  * some more checks performed during persistent cache validation.
4015
4016 Since 1.3.85:
4017  * Optimize calls to cm_CheckServer from cm_Analyze.  Only check
4018    down servers for the current cell not all cells.
4019
4020  * If the scache LRU list becomes corrupted, the AFS Client Service
4021    might enter an infinite loop at startup.   Detect the corruption
4022    and discard the cache contents in this case.
4023
4024  * Fixed the Explorer Shell's remove mountpoint functionality.
4025
4026  * Fixed a deadlock caused by the holder of cm_aclLock attempting to 
4027    obtain a mutex lock on a cm_scache_t object whose lock is held by
4028    a thread attempting to obtain the cm_aclLock.
4029
4030 Since 1.3.84:
4031  * Really fixed DNS AFSDB queries to ensure that "csail" cannot be
4032    misinterpretted as "csail.mit.edu" when the resolver 
4033    is configured to append ".mit.edu" to failed DNS queries.
4034
4035  * Added a new registry key, "LogoffPreserveTokens" (see registry.txt),
4036    that can be used to force the preservation of user tokens upon logout.
4037
4038  * Update the NSIS install scripts to use NSIS 2.07.   This release adds 
4039    recommended installation categories: AFS Client, AFS Administrator,
4040    AFS Server, AFS Development Kit.  Each category includes a different 
4041    default subset of the OpenAFS components.
4042
4043    The OpenAFS logo is now associated with the NSIS uninstall entry
4044    in the Add/Remove Programs control panel.
4045
4046  * The user name associated with AFS tokens when obtained with
4047    integrated login, the afs systray tool, or aklog will always
4048    include the full Kerberos 5 user principal name regardless of 
4049    whether or not the cell is local to the realm.
4050
4051  * Modify integrated login so that it does not enter an infinite
4052    loop if the service is not set to auto start.
4053
4054  * Added asetkey.exe used to set a Kerberos 5 key for use by the
4055    AFS server daemons
4056
4057  * Added uninstall.exe to Wix installation
4058
4059  * More modifications to algorithms used to wake sleeping threads.
4060
4061 Since 1.3.83:
4062
4063  * Changes to the algorithms used to wake threads when they are
4064    put to sleep because of conflicts over buffer operations.
4065
4066 Since 1.3.82:
4067  * The OpenAFS integrated logon obtains Kerberos 5 tickets as part of 
4068    the process of producing AFS tokens.  The tokens are stored within
4069    the AFS Client Service but the Kerberos 5 tickets have been discarded.
4070    New functionality has been added to temporarily copy the tickets to
4071    a file ccache during the short window between the NPLogonNotify and
4072    WinLogon Logon Event.  The Logon Event handler starts a process as
4073    user, afscpcc.exe, that copies the tickets into the default ccache.
4074    The file ccache is then destroyed by the event handler.
4075
4076  * During synchronization operations on stat cache entries, if threads
4077    are forced to sleep it was possible that the threads would not be
4078    woken under heavy load.
4079
4080  * Enforce the delete on close flag specified by the NTCreateX()
4081    operation.
4082
4083  * A race condition in the rx library was fixed that resulted in 
4084    a deadlock in rx_NewCall when the RX_CONN_MAKECALL_WAITING flag
4085    was cleared when threads were still waiting to use the 
4086    connection.   Also, fixed a potential case in which the 
4087    connection could be destroyed while threads were waiting to use it.
4088
4089  * The DNLC freelist has been seen to become corrupted with still 
4090    active entries being stored on the freelist.  Changes were made
4091    to perform a better job of cleaning entries before placing them
4092    onto the freelist; marking them with the correct magic value when
4093    purging the list; and allowing the list to be purged on startup
4094    if the cache validation fails.
4095
4096  * Windows Crash Reporting does not get triggered for afsd_service.exe
4097    because it provides its own top level exception handler.  This patch 
4098    places an explicit call to ReportCrash() on platforms which support 
4099    it.  (XP and above.)
4100
4101    If you configure Crash Reporting via AD Policy to capture crash
4102    reports within the domain, then you will receive this output.
4103
4104  * Generate MiniDumps independent of the Windows Crash Reporting.
4105  
4106    (a) If an exception occurs,a minidump will be generated at the path
4107        %TEMP%\afsd.dmp. The type of minidump defaults to Normal but 
4108        can be set to any other type via use of the
4109        registry.      
4110
4111        [HKLM\SOFTWARE\OpenAFS\Client]  MiniDumpType (DWORD)
4112
4113    (b) MiniDumps can be generated at any time using the "fs minidump"
4114        command.   This allows you to generate a minidump without 
4115        stopping the process or even requiring the use of a debugger
4116        on the system.
4117
4118   * an RX connection which reports bad ticket now treats it the same way
4119     the expired ticket is treated.   The ticket is removed from the 
4120     connection and a new anonymous connection is established.
4121
4122   * fs memdump now requires that the caller be in the AFS Client Admins
4123     group
4124
4125   * additional debugging information is provided in cm_Analyze when the
4126     error code is ignored.
4127
4128   * Fix a regression introduced into the pioctl() client code which
4129     will cause a crash in winlogon.exe, explorer.exe and fs.exe if
4130     MIT KFW is not installed. (1.3.82a)
4131
4132   * Remove AFS Gateway option from OpenAFS Control Panel (1.3.82a)
4133
4134 Since 1.3.81:
4135   * Fix a race condition in cm_EndCallbackGrantingCall() that 
4136     could leave 'nrevp' pointing to freed memory.  In the process,
4137     optimize the processing to ensure that the applications monitoring
4138     the status of the stat cache entry are only notified at most 
4139     once.
4140
4141   * Conditionalize access to the Explorer Shell AFS->Mount Point
4142     ->Remove menu item.  Disable the item if the selected item(s)
4143     are not mount points.
4144
4145   * Activate AFS RPC (RX) Free Packet Queues stored in Thread
4146     Local Storage.  This eliminates thread contention on the
4147     global RX free packet queue.  This should improve performance
4148     on multi-CPU systems.
4149
4150   * Fix the IP address filtering code to properly load/unload
4151     the IPHelper DLL so that Windows XP/2003 and beyond systems
4152     do not have to manually probe the registry.
4153
4154   * CleanupACLEnt() was not being called consistently with 
4155     the cm_scache_t object referred to by the back pointer
4156     mutex locked. This could in very rare conditions lead to
4157     an invalid memory access.
4158
4159   * Added a script command to the msi installer "afs_replace"
4160     which can be used to replace one version of OpenAFS with
4161     another without requiring an uninstall and reinstall if
4162     the installed msi is no longer in its original location.
4163
4164   * Apparently the problem with multi-domain forests with cross-
4165     realm trusts to non-Windows realms was not entirely solved.
4166     The authentication to the AFS SMB service failed because 
4167     the wrong name was being used.  Using ASU as an example,
4168     the authentication was being performed with the name
4169     "QAAD\user" (an account in the forest root) and not 
4170     "user@ASU.EDU (the MIT Kerberos principal used to login with)
4171
4172     The solution was to add an additional dependency on KFW
4173     in order or to be able to easily obtain the client principal 
4174     name stored in the MSLSA ccache TGT.  This information is 
4175     used in two locations:  
4176
4177     - the pioctl() function 
4178
4179     - a new WinLogon Event Handler for the "logon" event.  
4180
4181     The pioctl function will now be able to use the correct
4182     name when calling WNetAddConnection2() and the "logon"
4183     event handler will now be able to call WNetAddConnection2().
4184     The hope is that the "logon" event handler will be called 
4185     before the profile is loaded but I have not guarrantee
4186     that will happen. 
4187
4188 Since 1.3.80:
4189   * Fixed a locking error in cm_TryBulkStat() which had the
4190     potential of deadlocking the system for the length of time
4191     it takes to perform a bulk status fetch operation.
4192
4193   * Replaced time conversion code (UnixTime <-> FILETIME) to 
4194     be completely arithmetic instead of relying on a bizarre
4195     algorithm involving a variety of C RTL time functions.
4196     This has the side effect that UnixTime and FILETIME which
4197     are both stored in UTC are interpretted as UTC throughout
4198     the year.  Windows will apply the same localization to AFS
4199     as it does to NTFS.  Applications which rely on the ability
4200     to sync files between the two file systems will no longer
4201     see the timestamps of files in AFS change an hour relative
4202     to the files stored in NTFS or Windows based backup devices.
4203
4204   * Fixed a invalid memory access under a bizarre circumstance.
4205     Windows will allow a physical mass media device to be 
4206     installed via Plug N Play to the system and will assign it
4207     the lowest available drive letter.  This is true even if the
4208     drive letter is currently assigned in the user session to
4209     a network device via NET USE (or its equivalent.)  When this
4210     happens, queries sent to the CIFS server will contain invalid
4211     data.  This invalid data was not being caught by the AFS 
4212     Client Service and was resulting in a crash when Freelance
4213     mode was in use.  
4214
4215   * Fixed a reference count error when registering callbacks
4216     on a stat cache object if the callback was already registered
4217
4218   * Add a case to cm_Analyze() in order to handle the case where
4219     cm_GetConnByMServers() returns CM_ERROR_NOSUCHVOLUME because
4220     the server list for the volume is empty.  In this case, force
4221     an update of the volume info and retry.
4222
4223   * Insert a missing cm_EndCallbackGrantingCall() which could
4224     result in threads waiting for a callback to complete to never
4225     be woken up.
4226
4227   * In the persistent cache, there is a maximum number of volume
4228     entries.  Allow volume entries to be reused if the maximum
4229     number have been allocated and their reference count is zero.
4230
4231   * If we already have a dead virtual connection object, don't 
4232     ignore the fact that additional dead vc objects must be taken
4233     care of.
4234
4235   * Removed a deadlock condition introduced in the summer of 2004.
4236     Do not hold mx locks around calls to RX functions including
4237     rx_NewCall().  That is what reference counts on the rx_connection
4238     object are for.
4239
4240   * Fixed an initialization error in afslogon.dll which could
4241     result in random behavior including a failure to terminate
4242     the NPLogon function. (1.3.80b)
4243
4244   * Fixed an error preventing the use of SMB authentication
4245     on Windows 2000.  (1.3.80a)
4246
4247 Since 1.3.77:
4248   * Updated CellServDB to Public CellServDB 16 Mar 2005
4249
4250   * Fixed DNS AFSDB queries to ensure that "csail" cannot be
4251     misinterpretted as "csail.mit.edu" when the resolver 
4252     is configured to append ".mit.edu" to failed DNS queries.
4253
4254   * Fixed another case in which the client would replace connections
4255     to the host when it was not necessary.  In this case the 
4256     situation would occur if cryptall was on and the connections
4257     were unauthenticated due to lack of an appropriate token.
4258
4259   * OpenAFS for Windows has failed to work at sites which are 
4260     utilizing a cross-realm trust between an MIT/Heimdal realm
4261     and a multi-domain Windows forest when the workstation being
4262     accessed is not located in the root domain.  This is caused 
4263     by a bug in the workstation which was triggered after the 
4264     introduction of Windows 2003 Server.  When the bug is triggered,
4265     the workstation attempts to authenticate users to afsd_service.exe
4266     by contacting the Domain Controller instead of using the 
4267     LSA loopback authentication mechanism.
4268
4269     One of the reasons this bug occurs is because the workstation    
4270     does not have a reliable way of knowing that the service whose
4271     netbios name is "AFS" is located on the workstation.  This will
4272     be fixed starting in Longhorn Beta 1 by Microsoft.  The 
4273     "BackConnectionHostNames" registry value will be used to 
4274     indicate that the authentications to that service name should
4275     be performed using the loopback authentication mechanism.
4276
4277     In the meantime, when Logon Caching is enabled, we can force
4278     afsd_service.exe to authenticate using the logon cache before
4279     contacting the Domain Controller.  This will work with both
4280     password and smart card based logons.  
4281
4282   * The allDown logic in cm_ConnByMServers() was wrong.  The allDown
4283     flag should not be cleared if a volume's server reference is 
4284     marked as "offline".  In the case where all of the volume's 
4285     servers are either "down" or the volumes are "offline", we want
4286     cm_Analyze() to process the condition as CM_ERROR_ALLOFFLINE
4287     instead of as CM_ERROR_TIMEDOUT.  In fact, CM_ERROR_TIMEDOUT
4288     should never occur in practice.
4289
4290     In the case of CM_ERROR_ALLOFFLINE, cm_Analyze() will sleep for
4291     5 seconds, clear the server down and volume busy flags, and 
4292     then force an update from the VLDB.  This allows the client to 
4293     update the location of a volume if the reason for it being 
4294     marked offline is because it is being moved.  Calls to 
4295     cm_ConnByMServers() will be retried either until success or
4296     the RDRtimeout period is reached.
4297
4298   * Correct the Power Management code behavior in response to 
4299     Standby, Suspend, and Shutdown events.  Instead of flushing the
4300     buffers associated with the mounted SMB submounts, simply write
4301     all buffers which are marked dirty.
4302
4303   * Added support for "TheseCells" to afslogon.dll.  "TheseCells"
4304     provides a list of cells other than the default cell for which
4305     tokens should be obtained using the default Kerberos principal.
4306     This functionality is logon domain specific and is only available
4307     when using KFW for authentication.
4308
4309   * Fixed FindNext Invalid Handle error caused by over agressive 
4310     attempts at garbage collecting dirSearch entries when the 
4311     dirSearch ID wraps from the maximum value to 1.
4312
4313   * Add support for registry defined server preferences for VLDB and 
4314     File servers.  See registry.txt for details.
4315
4316   * Increased default cache size to 96MB and default number of cache
4317     entries to 10,000.
4318
4319   * Fixed refCount leaks related to directory lookups and pioctl calls.
4320
4321   * Callbacks revoked during a race condition with an attempt to 
4322     obtain the same callback no longer result in an inaccessible
4323     stat cache entry.
4324
4325   * New command line tool:
4326
4327         afsdacl : Set or reset the DACL to allow starting or stopping
4328              the afsd service by any ordinary user.
4329
4330         Usage : afsdacl [-set | -reset] [-show]
4331               -set   : Sets the DACL
4332               -reset : Reset the DACL
4333               -show  : Show current DACL (SDSF)
4334
4335   * IP addresses are no longer queried once at startup.  Instead IP
4336     addresses are obtained as needed.   Loopback adapter addresses are
4337     no longer published to the server.
4338
4339   * Pay attention to the MIT KFW registry configuration for automatic
4340     importation of MSLSA credentials. (SOFTWARE\MIT\Leash32,MsLsaImport)
4341
4342   * Fix (once again) case-sensitive comparisons which was apparently 
4343     broken in 1.3.72.
4344
4345   * Activate support for vos listvol -format
4346
4347   * Population of the "AFS Client Admins" group failed on non-English
4348     versions of Windows because the name of the "Administrators" group
4349     is localized.  Now we lookup the name of the group by using the
4350     Administrators Group Alias Relative ID.
4351
4352   * Multiple cell token acquisition within afscreds.exe was broken in the 
4353     case of Kerberos 5 cross realm authentication.  Instead of contacting
4354     the KDC associated with the cell's realm, afscreds would obtain a 
4355     token from the KDC of the user's realm.  This would result in
4356     "invalid kvno errors" while authenticating to the AFS servers.  
4357     Unauthenticated access would work.  The symptoms would vary based upon
4358     whether or not the VLDB servers had been contacted using unauthenticated
4359     connections prior to the user obtaining tokens.
4360
4361   * The list of ACL entries was becoming corrupted.  It appears as if 
4362     an ACL when it expires was not being appropriately cleaned up.  In
4363     fact, it was left in the list of ACLs associated with the scache 
4364     entry.
4365
4366   * Changed the default @sys name list to "x86_win32 i386_w2k i386_nt40"
4367     for 32-bit x86 systems.  The default for itanium will be "ia64_win64"
4368     and "amd64_win64" for amd 64-bit processors.
4369
4370   * When executing executables, Windows provides a mechanisms by which
4371     the normal search for DLLs can be bypassed.  If a file foo.exe is
4372     being executed and there exists a file or directory "foo.exe.local" 
4373     (the contents are ignored if a file), then Windows will search for
4374     DLLs first in the "foo.exe.local" directory and second in the 
4375     directory in which the "foo.exe" file is located.  
4376
4377     Previous releases of OAFW would improperly return 
4378     STATUS_NOT_A_DIRECTORY instead of the expected 
4379     STATUS_OBJECT_PATH_NOT_FOUND.  This would cause the Windows SMB client
4380     to terminate the search for the DLL causing the execution of the 
4381     application to fail.
4382
4383   * Rework the reference counting of smb_vc_t objects.  The references  
4384     stored in the waiting locks were not counted.  This could result in
4385     an assertion if the reference count drops to zero.
4386
4387   * "fs wscell" returns "Freelance.Local.Root" for the workstation cell
4388     when running in freelance mode.
4389
4390   * Added support for persistent caching of file contents, stat entries,
4391     volume data, cell data, and name lookup data.  When the registry 
4392     value, "NonPersistentCaching", is not defined or set to 0 the file 
4393     specified by "CachePath" becomes a persistent cache file.   The 
4394     size of the cache file is computed at run time.  It has a maximum
4395     size of approximately 1.2GB.  The contents of the file will be 
4396     validated according to the rules specified by the "ValidateCache"
4397     registry value.  
4398
4399   * Added support for UUIDs.  UUIDs are kept for as long as the 
4400     cache file is intact.
4401
4402   * Added cmdebug.exe and support cache manager debugging callback 
4403     interfaces in afsd_service.exe.
4404
4405     Usage: cmdebug -servers <server machine> [-port <IP port>] [-long] 
4406                    [-addrs] [-cache] [-help]
4407     Where: -long   print all info
4408            -addrs  print only host interfaces
4409            -cache  print only cache configuration
4410
4411   * Symlinks to \\AFS\[all\]... will now be treated the same as 
4412     symlinks to /afs/....   However, please use /afs/... as otherwise
4413     the symlinks won't work on Unix.
4414   
4415   * Correct a problem with local CellID allocation for cells whose 
4416     server list is obtained via DNS instead of a CellServDB file.  If
4417     the DNS information expires the CellID assigned to the entry will
4418     be changed.  This causes all of the cm_scache_t objects which refer
4419     to the old cellID number to become useless.  Attempts to access 
4420     files or directories with cm_scache_t objects using the old cellID
4421     will fail since the server list cannot be obtained.
4422
4423   * Correct deadlock condition in cm_EndCallbackGrantingCall which can
4424     be triggered if the volume referenced by the cm_scache_t object is
4425     offline.
4426
4427   * The AFS Service needs to respond to SERVICE_ACCEPT_SHUTDOWN messages
4428     in addition to SERVICE_ACCEPT_STOP.
4429
4430   * Move RPC shutdown until after the SMB and RX shutdown procedures 
4431     complete.  Block until RPC shutdown is complete.
4432
4433   * Modify afslogon.dll (integrated logon) to wait for service if its
4434     state is START_PENDING.  If the timeout period occurs, reset to 
4435     the retry interval and not the sleep interval.
4436
4437   * When renewing the server list for a cell obtained via DNS AFSDB
4438     records, the cm_cell_t entry must be removed from the list of all 
4439     cells.  Otherwise, the list of cells will be corrupted.
4440  
4441   * In the dcache and scache modules, use the cm_scache_t dataVersion
4442     instead of the cm_fakeDirVersion.  
4443
4444   * Synchronize fs.c with the unix version.
4445
4446   * The variable used to determine whether a file or virtual memory
4447     mapped cache is used was not properly initialized to a default
4448     value. If the registry setting "NonPersistentCaching" was not
4449     set, the choice would be random.   Properly initialized to be
4450     "file".
4451
4452   * The memory mapped view was never unmapped before closing the file
4453     at service shutdown.  This is now properly cleaned up.
4454
4455   * Default location of Cache file is now %TEMP%\AFSCache
4456
4457 Since 1.3.76:
4458
4459   * A bug affecting new installations of 1.3.75/76 would result in
4460     the creating of incorrect mountpoints in the freelance root.afs 
4461     volume for the default cell.
4462
4463     If "fs \\afs\all\<cellname>" lists a volume name of "root" instead
4464     of "root.cell", you have been affected by the bug.  To correct the
4465     problem, execute the following commands:
4466
4467           fs rmmount \\afs\all\<cellname>
4468           fs rmmount \\afs\all\.<cellname>
4469         
4470           fs mkmount \\afs\all\<cellname> root.cell <cellname>
4471           fs mkmount \\afs\all\.<cellname> root.cell <cellname> -rw
4472
4473 Since 1.3.75:
4474
4475   * A bug has been fixed in the auto-generation of Freelance root.afs
4476     symlinks which produced random entries in the \\AFS\all directory.
4477
4478   * Support has been added for multi-homed servers
4479
4480 Since 1.3.74:
4481   * Added a new registry value, "StoreAnsiFilenames", which can be used
4482     to force the use of ANSI character sets instead of OEM Code Pages.
4483     This feature is useful when users require the ability to create 
4484     filenames with 8-bit characters and need to access the files from
4485     both Latin-1 based Unix systems as well as from Windows.
4486
4487     Activation of this feature will prevent access to files stored with
4488     8-bit OEM characters.
4489
4490   * Shutdown all SMB threads in a synchronized manner when stopping the 
4491     service.
4492  
4493   * There is currently a maximum cache size of 1.3GB.  The limit is imposed
4494     by the largest contiguous block of unused memory within the 2GB process
4495     space which can be assigned to the memory mapped file.  Unfortunately,
4496     when the executable digital signature verification code is activated
4497     Windows sees fit to further segment the process memory which in turn
4498     reduces the size of the maximum cache file to less then 800MB.  If
4499     larger cache sizes are desired, a new registry value should be set:
4500
4501       HKLM\SOFTWARE\OpenAFS\Client (DWORD) "VerifyServiceSignature" = 0x0
4502
4503     Setting this value will disable the runtime verification of digital
4504     signatures on afsd_service.exe and the afs dlls which it loads.  It
4505     will not disable the the version number check on those same files.
4506     The signature verification is not a security messure and is only meant
4507     to enhance the ability to afsd_service.exe to detect potential
4508     destablizing mixtures of DLLs from incompatible distributions.
4509
4510     Added code to auto-disable the signature verification check if 
4511     the desired cache size is greater then 700MB.
4512
4513   * Windows' WinTrustVerify(WIN_SPUB_ACTION_PUBLISHED_SOFTWARE) is 
4514     used to verify the validity of the afsd_service.exe binary 
4515     as well as each of the AFS DLLs loaded by the service.  Not only
4516     must the digital signature be valid but the signatures of the 
4517     DLL must be signed by the same entity as the service.
4518
4519   * Implement new functions: cm_freelanceMountPointExists and
4520     cm_freelanceSymlinkExists.  Use them along with other validity
4521     checks in cm_freelanceAddMount and cm_freelanceAddSymlink to
4522     ensure that name collisions do not occur and that empty strings
4523     are not valid file names.
4524
4525     A symlink may not have a name which would resolve to a valid 
4526     cell name.  Doing so would prevent access to the cell.
4527
4528   * Add missing cm_HoldSCacheNoLock call to Freelance mount point
4529     re-initialization code.  The reference counts of the fake root.afs
4530     volume scache object(s) would become invalid when the mount point
4531     or symlink lists were altered.
4532
4533   * Add registry entries to provide mappings from the afsdsbmt.ini
4534     to the new locations for applications which count on the use
4535     of the old Profile file APIs.  These apps are likely to fail
4536     if the user does not have administrator privileges and the 
4537     registry is locked down.
4538
4539   * The afs_config.exe submounts dialog had two errors.  
4540     First, attempts to remove entries failed because the registry
4541     key was being opened without KEY_WRITE privileges.  
4542     Second, when editing a submount entry, changing the name
4543     would add a new key and leave the original one in place. 
4544     Now the original submount will be removed if its name is 
4545     changed.
4546
4547   * In recent months there have been several incidents in which
4548     users have experienced problems starting or accessing 
4549     afsd_service.exe and after significant effort has been spent
4550     it has turned out that they have two versions of AFS on the
4551     machine or an inconsistent set of DLLs.  
4552
4553     Code has now been added to afsd_service.exe which will walk
4554     the list of modules loaded by afsd_service.exe and validate
4555     that the version of the AFS DLLs matches the version of the
4556     afsd_service.exe executable.  If they do not match the service
4557     will not start.  
4558
4559   * When Freelance mode is enabled and there is no registry
4560     key HKLM\SOFTWARE\OpenAFS\Client\Freelance, afsd_service.exe
4561     will attempt to import the afs_freelance.ini file contents.
4562     If the file does not exist, it was creating a dummy file
4563     with a r/o and r/w entry for the default cell and then
4564     importing those values.
4565
4566     This process has been changed.  The temporary file is no
4567     longer created.   Also, both the OpenAFS Client install
4568     directory as well as %WINDIR% are checked for previous
4569     afs_freelance.ini files.
4570
4571   * Added support for VL_GetEntryByNameN().  Still need to add
4572     support for VL_GetEntryByNameU() for multi-homed support.
4573
4574   * Fix a deadlock situation in afscreds.exe when canceling an
4575     auto-generated Obtain Tokens dialog
4576
4577 Since 1.3.72/73:
4578   * Fix the locking of objects during Directory Searches in the
4579     SMB/CIFS server.  The failure to properly lock the reference 
4580     counts was resulting in the premature freeing of smb_dirSearch_t 
4581     objects while they were still in use by the SMB/CIFS client.
4582     This does not solve the "Invalid Handle" problem.
4583
4584   * Fix Find Cell By Name pioctl call to return a valid cell
4585     name for the Freelance fake root.afs volume.  
4586     "Freelance.Local.Root".
4587
4588   * Fix the Explorer Shell Extension Symlinks->Add operation.
4589     The dialog template was missing and the link destination
4590     string was too short.
4591
4592   * Add support for symlinks to Freelance root.afs volume
4593     Stored at HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks
4594        <number>  =  "<linkname>:<relative-path>."
4595     Use symlink.exe to create, list, or remove
4596
4597   * Remove the fallback to the use of KFW's KRB4 library when obtaining
4598     tokens.  We never obtain KRB4 tickets.
4599
4600   * Fix AFS Client Configuration Control Panel to support new SysName
4601     protocol.
4602
4603   * Fix a bug in afsd_service.exe which could result in the SysName
4604     not being read from the registry.
4605
4606 Since 1.3.71:
4607   * Add code to block the issuance of AFS tokens by aklog.exe or
4608     afscreds.exe when the Kerberos 5 principal name contains a dot.
4609
4610   * Modify the IsAdmin() function to always treat the local SYSTEM
4611     account as an AFS client administrator.  Affects fs.exe and 
4612     afs_config.exe.
4613
4614   * Modify the internal handling of Quota Exceeded errors
4615
4616   * Upgrade all reference count fields in the Windows cache manager
4617     and the osi library to use unsigned long instead of signed short.
4618     A similar fix has been applied to the afs rpc (rx) library.
4619
4620   * fix the Windows cache manager to prevent it from replacing the 
4621     rx_connection object associated with the cm_conn_t object on each
4622     and every operation if "fs crypt" was set.  This explains the 
4623     dramatic performance difference when crypt is used vs clear.
4624     The problem: 'cryptall', a boolean flag indicating whether or not 
4625     "fs crypt" is set, was being compared to the rx_connection 
4626     cryptlevel which is either rxkad_clear:0 or rxkad_crypt:2.
4627     1 != 2 and therefore the rx_connection was always destroyed 
4628     and replaced on each and every operation.
4629
4630     Lock the cm_conn_t object around every call to RXAFS_xxxx functions.
4631     It is not safe for the cm_conn_t object to not be locked because
4632     rx_DestroyConnection might be called from another thread if:
4633         - the user's tokens have changed or expired
4634         - the crypt mode has changed
4635
4636     This fix appears to have also taken care of the problems associated
4637     with Overlapped Writes resulting in Delayed Write errors.
4638
4639   * fix NSIS installer's AdminGroup.exe to properly create and
4640     remove groups when given -create or -remove.  The string comparison
4641     test was wrong.
4642
4643   * fs sysname now accepts a list of sysname values 
4644
4645   * added a new registry value HKLM\SOFTWARE\OpenAFS\Client "IoctlDebug"
4646     DWORD which when set to a non-zero value will cause error message
4647     text to be output to stderr from the pioctl() routine.  Useful in 
4648     debugging failures of fs.exe, tokens.exe, etc.
4649
4650   * added a test to the power management code to only perform a 
4651     flush operation if there is at least one network adapter which
4652     is not a loopback adapter.
4653
4654   * Fix bug in loading of registry value HKLM\SOFTWARE\OpenAFS\Client
4655     "EnableKFW".  This value will not be read if the key
4656     HKCU\SOFTWARE\OpenAFS\Client exists; even if the "EnableKFW" 
4657     value under that key does not.
4658
4659   * provide mechanisms to force the use of krb524d for Kerberos 5
4660     ticket to AFS token conversion.  For afslogon.dll and afscreds.exe
4661     there is a new registry value "Use524" and for aklog.exe a new
4662     command line parameter "-m".
4663
4664   * Fix the pattern matching algorithm to properly match patterns
4665     ending with a '*'.
4666
4667   * smb_ReceiveCoreRename() was factored to produce smb_Rename()
4668     which is used by both the original function and the new
4669     smb_ReceiveNTRename().  smb_ReceiveNTRename() supports the
4670     creation of HardLinks in addition to Renaming.  smb_Link() 
4671     is a new function which creates HardLinks via cm_Link().
4672     cm_Link() is a new vnodeops function which creates links
4673     using RXAFS_Link().
4674
4675     smb_ReceiveNTRename() does not support the File Copy and 
4676     Move Cluster Information operations described in its interface.
4677     ReceiveNTRename is under documented in CIFS-TR-1p00_FINAL.pdf.
4678
4679   * When opening files via symlinks, we should follow the symlinks
4680     until we reach the actual file stat cache entry.  The stat cache
4681     entry of the file should then be stored in the FID instead of
4682     stat scache entry of the symlink.
4683
4684   * return bad operation errors for all unimplemented functions
4685     even if we do not know the functions exist.
4686
4687   * Log bad packets and unknown operation packets to the trace log
4688
4689   * Map CM_ERROR_BADOP to STATUS_NOT_SUPPORTED instead of 
4690     0xC09820FF
4691   
4692   * Update list of known CIFS operations to include all those listed
4693     in CIFS-TR-1p00_FINAL.pdf.
4694
4695   * Modify the handling of HKLM\SOFTWARE\OpenAFS\Client\Submounts
4696     to support the REG_EXPAND_SZ type.
4697
4698 Since 1.3.70:
4699   * A new Windows authorization group "AFS Client Admins" is now 
4700     created and populated with the members of the "Administrators"
4701     group.  The group is used to determine which accounts on the
4702     machine may be used to modify the AFS Client Configuration via
4703     the UI and command line tools.  afs_config.exe, fs.exe, 
4704
4705   * Modify the WinLogon Logoff Event Handler to query NT4 domain
4706     controllers for the remote profile path if Active Directory
4707     services are not available.
4708
4709   * Fix aklog.exe to not add the AFS ID to the username
4710
4711   * PTS registration of new users to foreign cells has been added to 
4712      afscreds.exe
4713
4714   * The cm_Daemon thread is used to perform checks for 
4715     down servers, up servers, volumes, callback expirations, 
4716     lock maintenance and token expiration.  Due to a gaff in
4717     larger integer division the thread never performed any 
4718     work.  Instead the current time computation would always
4719     be less then the trigger times.  This had an adverse affect
4720     on the client's ability to maintain communication with servers,
4721     keep volumes up to date, and flush user tokens and acls
4722     when they have expired. This was broken when the 1.3 branch
4723     was modified to support VC7 which no longer included 
4724     largeint.lib
4725
4726   * An initialization problem with the Freelance code was 
4727     detected while fixing the callbackRequest.  The cm_rootSCachep
4728     object is obtained during afsd_InitDaemons() but the callback 
4729     information is incomplete.  The callback information will not
4730     be obtained until cm_MergeStatus is called from within
4731     cm_GetCallback.  Unfortunately, cm_SyncOp did not properly 
4732     test for the conditions under which the callback information
4733     must be obtained.  
4734
4735   * Reports have been filed indicating that callbacks were
4736     being lost.  An examination of the code indicated that the
4737     cm_server_t objects were not being properly reference
4738     counted by the cm_scache_t and cm_callbackRequest_t objects.
4739     In particular, the cm_server_t objects may have been freed
4740     from beneath the cm_conn_t objects.
4741
4742     All of the reference counting is now done via the functions:
4743         cm_GetServer
4744         cm_GetServerNoLock
4745         cm_PutServer
4746         cm_PutServerNoLock
4747     this improves the ability to track the referrals.  
4748
4749     Each cm_BeginCallbackGranting Call now allocates a reference
4750     to the cm_server_t.  The cm_EndCallbackGrantingCall either
4751     frees the reference or transfers it to the cm_scache_t
4752     cbServerp field.  These are then appropriately tracked
4753     through the cm_Analyze call.
4754
4755   * Ensure that the dnlc hash table is the same size as the
4756     dir name hash table (as per original author's note).
4757     Increase the dnlc CM_AFSNCNAMESIZE to a multiple of 8
4758     for compatibility with 64-bit systems.
4759
4760   * fix smb_ApplyV3DirListPatches to properly apply the hidden
4761      attribute to dotfiles when the infoLevel < 0x101 and 
4762      cm_SyncOp has failed.
4763
4764   * Fix the Freelance registry initialization code.  There
4765     was a possibility that some systems could end up with 
4766     garbage in the registry during a clean install.
4767
4768 Since 1.3.66:
4769    * file and directory names beginning with "." will now be given the
4770      hidden attribute when the volume access is anonymous.  this matches
4771      the behavior when the volume access is via an authenticated user.
4772
4773    * Added a change monitor to the HKLM\SOFTWARE\OpenAFS\Client\Freelance
4774      key.  When a change occurs mark the root.afs data as invalid and
4775      for it to be reloaded on the next access.  This allows administrators
4776      to modify the mount point list without restarting the service.
4777      
4778      The freelance client used to provide a fake modification time for
4779      the root.afs volume data and its mount points of 7/09/2001 14:24 EDT.
4780      Added code to extract the last modification time of the Freelance
4781      registry key and use that instead.  The time now represents the 
4782      most recent mount point change.
4783
4784    * PTS registration of new users to foreign cells has been added to 
4785      aklog.exe
4786
4787    * Additional Cache Control and Credential Manager options have been
4788      added to the WiX installer.  See deployment guide for details.
4789
4790    * The CachePath setting is now optionally a REG_EXPAND_SZ type
4791   
4792    * The WiX installer has been upgraded.  Version 2.0.1927.1 is now 
4793      required.
4794
4795    * The loopback installation code may have had a problem updating the
4796      %ETC%\HOSTS file which could have resulted in a premature failure.
4797      Work around code has been added for the case where the file cannot
4798      be deleted.
4799
4800    * The default max chunksize was increased from 15 (32K) to 17 (128K)
4801      because Windows sends 64K blocks when using overlapped writes.
4802
4803    * The default number of server threads was increased from 4 to 25 to
4804      better handle overlapped writes.  
4805
4806    * The "AfscredsShortcutParams" registry value was not being properly
4807      loaded by afscreds.exe.  Therefore, the default value was always being
4808      used instead of the value set by the installer.
4809
4810    * Windows XP provides downgrade attack detection to prevent an attacker
4811      from being able to force the use of NTLM simply by disrupting 
4812      communication with the KDC.  This attack cannot exist between the 
4813      Windows CIFS client and the AFS Client Service.  Therefore, when a
4814      downgrade has been detected the afs pioctl library will force the 
4815      establishment of a new CIFS connection using NTLM.
4816  
4817    * A locking error was discovered surrounding all references to volume
4818      server lists within the cm_cell.c source file. 
4819
4820    * The logged into Windows username was incorrect on Terminal Server
4821      machines.
4822
4823    * A new registry value "NonPersistentCaching" was added to the service
4824      parameters key.  When set to a non-zero value, the afs cache is stored
4825      in the Windows paging file.  There are two limitations to choosing
4826      this option: 
4827         1. when persistent caching is implemented it won't work with 
4828            this flag set since there will be nothing to persist.
4829         2. with this flag set the initial paging allocation cannot be
4830            changed while the service is running
4831
4832    * An initialization bug was discovered in aklog.exe which affected users
4833      who have a domain name for their afs servers which could not be mapped
4834      to a realm
4835
4836 Since 1.3.65:
4837    * afs_config.exe now validates cell names against DNS in addition
4838      to the CellServDB file.
4839
4840    * In order to allow the freelance client to connect to a volume with ID 
4841      equal to 1 on the default cell we changed the fake root.afs volume ID
4842      once again.  This time we choose 0xFFFFFFFF.  In addition, we change
4843      the cell ID of the fake root.afs volume from 1 to 0xFFFFFFFF as well.
4844      It will now be impossible for a volume ID to match that of another 
4845      cell unless the client is connected to 0xFFFFFFFD cells.  That should
4846      be enough room for growth.
4847
4848    * Fix "fs mkmount" command to work with UNC paths and when
4849      started from non-AFS drives.  It is now possible to create a mount
4850      point in the freelance fake root.afs volume with the command
4851
4852         fs mkmount \\AFS\all\<directory-name> <volume-name> <cellname>
4853
4854      For example,
4855         
4856         fs mkmount \\AFS\all\openafs.org root.cell openafs.org
4857         fs mkmount \\AFS\all\.openafs.org root.cell openafs.org -rw
4858
4859    * The algorithm used to re-attempt access to the servers associated with
4860      a volume has been altered to properly address the case in which all 
4861      servers have been marked down.  The previous algorithm did not reset
4862      the server's down flags so the servers were never actually retried.
4863      This caused a problem with active volumes if the network connectivity
4864      was lost as could be the case with a network cable removal, wireless
4865      drop, or laptop hibernation.  With the fix volume access is restored
4866      almost instantenously when network connectivity becomes available.
4867
4868    * Support for SMB/CIFS browsing has been added to the AFS Client Service
4869      SMB server.  It is now possible to use "NET VIEW \\AFS" to obtain a
4870      listing of AFS submounts and freelance mount points.  Support for
4871      NETSHAREENUM, NETSHAREGETINFO, NETSERVERENUM2, NETSERVERGETINFO
4872      significantly enhances the behavior of AFS volumes within the Explorer
4873      Shell.  For instance, "AFS" now shows up as server in the Explorer
4874      with each submount or freelance mount point visible as a share.
4875      The right click menu in each folder now works with full functionality
4876      on a consistent basis.
4877
4878    * The network provider can be configured to have different behavior
4879      depending on the domain that the user logs into.  These settings are
4880      only relevant when using integrated login.  A domain refers to an
4881      Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
4882      local machine (i.e. local account logins).  The domain name that is
4883      used for selecting the domain would be the domain that is passed into
4884      the NPLogonNotify function of the network provider. (see registry.txt
4885      for details)
4886
4887    * Added a new registry value [HKCU\SOFTWARE\OpenAFS\Client] 
4888      "Authentication Cell" which may be used to specify a default 
4889      authentication cell for afscreds.exe which is different from
4890      the default cell for the AFS Client Service daemon.
4891
4892    * Added a Logoff WinLogon Event Notification function to afslogon.dll.
4893      afslogon.dll moved to %WINDIR%\System32\.
4894      New registry entries added to register the dll for Winlogon events.
4895
4896      The logoff event will now force a call to ktc_ForgetAllTokens()
4897      using the context of the user being logged off as long as the 
4898      user's profile is not loaded from within AFS.  If the profile 
4899      was loaded from AFS we can't release the tokens since the Logoff
4900      event is triggered prior to the profile being written back to 
4901      the its source location.  This is now performed in an XP SP2 
4902      safe manner.
4903
4904    * Windows XP SP2 Internet Connection Firewall interoperability
4905      has been added.
4906
4907    * The %WINDIR%\afsdsbmt.ini contains four sections:
4908         Submounts, Drive Mappings, Active Maps and CSC Policies.
4909      The Submounts and CSC policies are now stored in the registry under
4910         [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
4911         [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
4912      The Drive Mappings and Active Maps are stored in the registry under
4913         [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
4914         [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
4915
4916      There is no automatic migration of this data as it would be impossible
4917      to consistently migrate data to user profiles which may not be active
4918      when the machine is updated.
4919
4920    * The %WINDIR%\afs_freelance.ini contains lists of mountpoints for the
4921      fake root.afs volume.  For the same reasons as for the cellservdb file,
4922      this information should not be in %WINDIR%.  This information is now
4923      kept under the registry key
4924         [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
4925
4926      The data from the afs_freelance.ini file will be automatically 
4927      migrated to the registry on first execution of afsd_service.exe
4928
4929    * Keeping the CellServDB file in the location %WINDIR%\afsdcell.ini is 
4930      troublesome for several reasons.  One, it is confusing for those who
4931      expect the file to be named "CellServDB" instead of "afsdcell.ini".
4932      Two, this file is not a Windows Profile formatted file.  Three, 
4933      applications should not be reading or writing to %WINDIR%.  It causes
4934      problems for Windows Terminal Server.
4935
4936      The new location of CellServDB will be the OpenAFS Client install 
4937      directory which is by default C:\Program Files\OpenAFS\Client and can
4938      be determined by querying the registry for 
4939      [HKLM\SOFTWARE\TransarcCorporation\AFS Client\CurrentVersion]PathName
4940
4941      The existing afsdcell.ini will be migrated by the NSIS installer. 
4942      The Wix installer must still be updated to do the same.
4943
4944    * Change NSIS installer to use DNS by default; to remove Integrated Logon
4945      High Security mode; and to add Terminal Services compatibility registry
4946      entries to allow the OpenAFS tools to find the afsdcell.ini and other
4947      configuration files in %WINDIR%.
4948   
4949    * Add support for authenticated SMB connections.   This will remove
4950      the need for high security mode in most situations.  Both NTLM
4951      and Extended Security (GSS SPNEGO) modes are supported.  Effectively,
4952      only NTLM can be used even though Kerberos is now supported.  The
4953      reason is that it is not possible to construct a service principal
4954      which is unique to each individual machine.
4955
4956      SMB Extended Auth does not work on XP SP2 unless one of two registry
4957      modifications are made:
4958
4959      (1) To disable the check for matching host names on loopback connections
4960         set this key.  This does not require a reboot:
4961
4962         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa]
4963             "DisableLoopbackCheck"=dword:00000001
4964
4965      (2) To add the AFS SMB/CIFS service name to an approved list.  This
4966         does require a reboot:
4967
4968         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0]
4969             "BackConnectionHostNames"=multi-sz "AFS" "MACHINE-AFS"
4970
4971      afsd_service.exe will automatically add the current Netbios Name
4972      to the BackConnectionHostNames list and then temporarily disable
4973      the loopback check for one cycle of startup/shutdown of the service.
4974      We assume most folks do not start/stop without a reboot so this 
4975      will be adequate in most cases.
4976
4977    * Fix security hole in afslogon.dll which allowed passwords to be
4978      sent in clear text to the KDC in a misformed principal name.
4979
4980    * Fix cm_GetCell() to properly handle expired dns entries
4981      without crashing
4982
4983    * If Freelance mode is active and the afs_freelance.ini
4984      file does not exist, do not create an empty file.
4985      Instead create a file containing ro and rw mountpoints
4986      to the default cell using the standard conventions.
4987
4988    * Modify the Freelance support to handle the ability
4989      to create rw mount points in the fake root.afs volume.
4990
4991    * Changed the RPC mechanism used for token setting from 
4992      named pipes to local.  Use of named pipes can be restored
4993      by setting the environment variable AFS_RPC_PROTSEQ to
4994      "ncacn_np". 
4995
4996      Named pipes were required when a Windows 9x system was
4997      using a NT system in gateway mode which is incompatible
4998      with our use of local loopback adapters.
4999
5000    * In afscreds.exe, if a username of the form user@REALM is
5001      specified and no password is specified, do not perform a 
5002      kinit operation.  Only perform the aklog functionality.
5003
5004    * Add a new registry value which allows the number of processors
5005      on which afsd_service.exe executes to be restricted.  Valid
5006      values are 1..numOfProcessors
5007
5008        HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
5009           (DWORD) MaxCPUs 
5010
5011 Since 1.3.64:
5012    * A second MSI based installer option is now available.
5013
5014    * Fixed Kerberos 5 kinit functionality in afscreds.exe to properly
5015      request tickets for user/instance@REALM instead of just user@REALM
5016
5017    * Modify the Power Management Notify routine to wait for the Hard Dead
5018      timeout period instead of a fixed 19 seconds.  With the longer timeout
5019      periods Hibernation and Standby could never succeed when network 
5020      connectivity is not available.
5021
5022    * The following fs.exe commands are now restricted to Administrator:
5023      - checkservers with a non-zero timer value
5024      - setcachesize
5025      - newcell
5026      - sysname with a new sysname list
5027      - exportafs 
5028      - setcell
5029      - setserverprefs
5030      - storebehind
5031      - setcrypt
5032      - cscpolicy
5033      - trace
5034
5035      setting the default sysname for a machine should be done via the
5036      registry and not via "fs sysname".
5037
5038    * NSIS installer adds options to install Debugging Symbols
5039      and the Microsoft Loopback Adapter; the user is now also
5040      given the ability to select the afscreds.exe startup options.
5041
5042    * Build system modified to generate symbols for FREE (aka RELEASE)
5043      builds as well as CHECKED (aka DEBUG) builds
5044
5045    * Sites which have a volume ID of 0x20000001 assigned to their
5046      root.cell volumes have been experiencing problems with accessing
5047      the root.cell volume of their cell when Freelance mode has been
5048      active.  This was because 0x20000001 was assigned to the fake
5049      root.afs volume created by freelance.  The fake volume id is
5050      now set to 0x00000001 to prevent conflicts.
5051
5052    * The timeout logic in the AFS Client Service has been wrong
5053      for sometime.  It is based on two different assumptions.
5054      First, the SMB client timeout is a fix value as was the case
5055      with OS/2 Lan Manager.  This assumption is incorrect.  The
5056      SMB timeout in Windows is a dynamic value computed based upon
5057      a fixed minimum timeout to which is added time based upon the
5058      size of the request and the performance characteristics of
5059      the connection.  Second, it is the responsibility of the 
5060      SMB Server to enforce the timeout requirements of the client.
5061      This is untrue.  The SMB Server cannot be expected to know
5062      the requirements of the client.  More importantly, if the 
5063      SMB server uses the SMB client timeout as a value to restrict
5064      its behavior as an RX client, the performance characteristics
5065      of the local SMB session would be used to prematurely terminate
5066      WAN connections with significantly different performance 
5067      characteristics.
5068
5069      The timeout logic has therefore been modified in the following
5070      manner:
5071       . the Lan Manager Workstation (SMB) Session Timeout is used only
5072         as a basis for configuring the Connection Dead Timeout 
5073         and Hard Dead Timeout values.  The Connection Dead Timeout
5074         must be at least 15 seconds longer than the SMB Timeout
5075         and the Hard Dead Timeout must be at least double the 
5076         Connection Dead Timeout.
5077       . New registry entries have been added to allow the Connection
5078         Dead Timeout and Hard Dead Timeout values independent of the
5079         Lan Manager Workstation Session Timeout
5080       . The test to enforce the SMB Client Timeout has been removed.
5081         
5082      One of the side-effects of removing the enforcement of the SMB 
5083      Client Timeout is that regardless of whether or not the SMB client
5084      is available to receive the response (and how would the SMB server
5085      know) the RX protocol response can be used to update the AFS 
5086      Client Service state for ready access by future SMB client 
5087      requests.
5088
5089      This should be the end of the "Server paused or restarting messages"
5090    
5091    * Add support for arbitrary UNC paths to the pioctl() support.
5092      This enables the fs commands as well as the AFS Shell Extension
5093      to work correctly when UNC paths are being used.
5094
5095    * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
5096      DNS if the cell configuration cannot be determined via CellServDB
5097
5098    * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
5099      are ever set more than once at a time
5100  
5101    * Fix the management of lists of cm_cell_t structures when using 
5102      DNS to lookup cell information.  The previous code would fail to
5103      reuse the same cellID for a cell if DNS was used more than once
5104      for a given cell name.  When the ttl expired, a single cm_cell_t
5105      could be inserted into the cm_allCellsp list more than once 
5106      producing a loop.  In addition, the vlServerp list belonging to
5107      the cell was not freed resulting in improper refCounting of the
5108      servers.
5109
5110    * Add DNS support to cm_IoctlNewCell() which previous only examined
5111      the CellServDB file
5112
5113    * Add cm_FreeServer() function and call it from cm_FreeServerList()
5114      to properly garbage collect cm_server_t objects 
5115      
5116    * Add numVCs variable to smb.c to track the number of smb_vc_t 
5117      objects created and use it to initialize the vcID field which 
5118      previously was set to 0 in all objects resulting in FindByID 
5119      collisions.
5120
5121    * Fixed DNS lookups to work consistently throughout the OpenAFS
5122      product instead of just from within the afsd_service.exe
5123
5124    * Added a runtime check to ensure that AFS Client Service SMB
5125      Server is accepting connections before attempting to mount
5126      global drives.
5127
5128    * Read IP addresses for volume servers out of the CellServDB
5129      file if gethostbyname() on the hostname fails.
5130
5131    * Fix getcellconfig() to populate both the Hostnames as well
5132      as IP addresses when loading cell data via DNS
5133
5134    * Increase the Connection Dead Time to 50 from 20 seconds
5135      Increase the Hard Dead Time to 120 from 40 seconds
5136      (matches the Unix values)
5137
5138    * Fixed an assertion validating the number of allocated NCBs
5139
5140    * Fixed the build environment to consistently build for 
5141      Windows 2000 and above.  (APPVER = 5.0)
5142
5143    * Fixed rx_debug to properly validate the receipt in incoming
5144      data with select() and recvfrom().  Do not copy data out of
5145      the socket buffer unless success is indicated.
5146
5147 Since 1.3.63:
5148    * afsd_service.exe will now display a message box to the 
5149      desktop when it terminates due to an IP Address Change.
5150   
5151    * installer no longer deletes AFS Server configuration data
5152      on uninstall
5153
5154    * installer generates a warning dialog if the RPC service 
5155      is not properly configured
5156
5157    * installer compressed with lzma instead of bzip2
5158
5159    * afsd_service.exe shutdown crash solved once and for all
5160  
5161    * reference counting of smb_vc_t data structures improved
5162  
5163    * name space collision of smb_fid_t event objects corrected
5164
5165    * the output of "fs memdump" is now written to 
5166      %WINDIR%\TEMP\afsd_alloc.log
5167
5168    * the file TaAfsApp_1033.dll is now properly installed allowing
5169      the User Manager to start
5170   
5171    * a new algorithm is used for computing filename pattern matches
5172
5173    * afscreds.exe now accepts user names containing instance
5174      fields.
5175
5176    * Fix the Directory Name Lookup Cache to be case-sensitive.
5177      This is crucial in environments in which a Windows client
5178      is accessing a directory with more than one filename that
5179      differs only by case.  If the directory contains "FOO" 
5180      and "Foo".  You want "DEL Foo" to delete the correct one.
5181      We still have a problem in that "DEL foo" will delete a
5182      random filename.  This will be addressed in a future release.
5183
5184    * Fix afscreds.exe -M option (renewMaps) to work when High
5185      Security mode is off.  Also, remember to disable the ActiveMap
5186      flag in afsdsbmt.ini when a drive mapping is removed.
5187
5188    * Updates to NSIS installer script.  AFS Server configuration
5189      data will not be destroyed on un-install or re-install.  
5190      Use a better compression algorithm.
5191    
5192    * afslogon.dll now uses KFW to obtain tokens when available
5193    
5194    * afslogon.dll when given an all uppercase username will
5195      attempt to authenticate with both the uppercase name
5196      and an all lowercase variation
5197
5198    * DST modification removed.  The fix appears to make things
5199      worse after a reboot of the machine.
5200
5201    * fs.exe:  added "cscpolicy" which is used to 
5202      change client side caching policy for AFS shares
5203
5204      Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs] 
5205                          [-documents] [-disable] [-help]
5206
5207    * Several uninitialized variables have been initialized
5208
5209    * It is now possible to obtain tokens using cross realm
5210      Kerberos within afscreds.exe:
5211         cell:      dementia.org
5212         user:      jaltman@ATHENA.MIT.EDU
5213         password:  xxxxxxxx
5214      Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
5215      will will in turn be used to obtain afs@DEMENTIA.ORG.
5216      The resulting token will be stored with the display name 
5217        jaltman@ATHENA.MIT.EDU@dementia.org
5218
5219    * aklog.exe has been added to the client
5220
5221      Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]] 
5222                   [[-p | -path] pathname]
5223                   [-noprdb] [-force]
5224                   [-5 | -4]
5225
5226         -d gives debugging information.
5227         krb_realm is the kerberos realm of a cell.
5228         pathname is the name of a directory to which you wish to authenticate.
5229         -noprdb means don't try to determine AFS ID.
5230         -5 or -4 selects whether to use Kerberos V or Kerberos IV.
5231            (default is Kerberos V)
5232         No commandline arguments means authenticate to the local cell.
5233
5234 Since 1.3.62:
5235    * All of the resource files have been restructured to adhere to
5236      a set of rules IBM implemented for loading string resources.
5237      These rules had either been forgotten or were not discovered
5238      by folks working on the OpenAFS sources.  The end result was
5239      memory corruption.  This is primary item which was preventing
5240      the AFS Server from working.
5241
5242    * Increased the size of the maximum ticket size stored in a token
5243      from 344 bytes to 12,000.  Increased the buffers used to convey
5244      messages between the pioctl() caller and the SMB Server from
5245      1000 bytes to 12,512.  The code appeared to have been writing
5246      above the top of the stack by quite a few number of bytes.
5247      (The increased ticket size is necessary for the next item.)
5248
5249    * When obtaining AFS Tokens via KFW, krb524 is no longer required.
5250      Instead the raw Kerberos 5 ticket is used in its entirety.  This
5251      is extremely important as it allows us to use pure Kerberos 5 KDCs
5252      as the source of the AFS authentication.  The use of up to 12,000 byte
5253      tickets will allow tickets produced by all versions of Microsoft
5254      Active Directory to be used.
5255       - create a user account.       
5256       - designate it DES only
5257       - disable pre-auth
5258       - specify its UPN to be  "afs@realm"
5259       - assign a SPN of "afs/cellname" to the UPN with setspn.exe
5260
5261    * Do not enforce the funky 8dot3 pattern matching rule that the first "."
5262      is special when using long file names.  (you must use "*.*" and not "*")
5263      Instead only enforce it when performing 8dot3 searches. 
5264
5265    * Fixed the DST problem with creation times being set one hour ahead
5266
5267    * Fixed the problem when using \\afs\cell-alias.  For example, 
5268      \\afs\uncc instead of \\afs\uncc.edu.  Do not a new cell struct
5269      for the alias name; instead simply expand the name.  One of the
5270      symptoms of this problem was a loss of acquired tokens.
5271
5272    * Fixed the AFS Shell Extension.  The Symbolic Link menu was empty 
5273      of strings.  (Only English strings provided.)
5274
5275    * Fixed the installer to properly replace in use files.  
5276
5277    * Fixed the build system to cleanup generated component version files
5278
5279    * The release build compiled with MSVC 6.0 compiler to avoid the 
5280      afsd_service.exe shutdown crash.  This does not solve the problem
5281      but simply avoids it for the time being.
5282
5283 Since 1.3.61:
5284
5285  * fix afslogon.dll to not corrupt memory when High Security mode
5286    is not used.  
5287
5288  * fix afsd_service.exe to not attempt to restore the stack when
5289    an exception occurs.  (not safe in multi-threaded programs)
5290
5291  * fix uninstaller to properly remove the CRT and MFC DLLs
5292  
5293  * remove a Message Box from afscreds.exe when getcellconfig()
5294    fails on a kerberos realm which is not a cell
5295
5296 The following is a list of changes to the OpenAFS for Window client
5297 since 1.3.60.
5298
5299  * "fs setserverprefs" will leave afsd service deadlocked
5300
5301  * "vos listaddrs" will core dump
5302
5303  * installer sets the appropriate keys to support Integrated Logon
5304
5305  * installer disables the "Find Lana by Name" functionality as it
5306    was causing headaches for many users
5307
5308  * fix the intermittent crash of the power management thread when
5309    shutting down the AFS Client Service
5310
5311  * optimizes the obtain drive mount list functionality which is 
5312    executed every time the mount tab in afscreds.exe and afs_config.exe
5313    are refreshed.  (this happens a lot)
5314
5315  * fix the service shutdown logic.  add the STOP_PENDING state
5316    and do not accept additional service events after we declare
5317    ourselves STOPPED.
5318
5319 The following is a list of changes to the OpenAFS for Window client
5320 since 1.2.10.
5321
5322 * flexelint was run against the source tree and hundreds (perhaps 
5323   thousands) of corrections were applied to ensure prototypes 
5324   were in use; types were used consistently; variables were 
5325   initialized; unused variables were removed; etc.
5326
5327 * A wide variety of instrumentation was added including the 
5328   ability to produce a stack trace from within afsd_service.exe
5329   when it crashes.
5330
5331 * Dynamic configuration of the RDRtimeout value based upon the
5332   LanMan Workstation Session Timeout
5333
5334 * The mount root no longer needs to be called "/afs".  This 
5335   is now set by a registry value "MountRoot" within the key
5336   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
5337
5338 * The cell list is now only read out of afsdcell.ini when the
5339   file changes instead of each time a cell is resolved.
5340
5341 * Thread synchronization was added to cm_server.c and ktc_nt.c
5342
5343 * All calls to GlobalAlloc()/GlobalFree() were replaced with 
5344   calloc()/free().  The Global functions were needed on Windows 3.x
5345   but have caused a variety of problems on the Win32 platforms.
5346   Avoiding them is highly recommended by several Microsoft 
5347   Knowledgebase articles
5348
5349 * Support for Symbolic Links added to the AFS Shell Extension
5350
5351 * Added a registry value "OverlayEnabled" to determine if
5352   Shell Extension Overlays should be enabled.  
5353   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
5354
5355 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
5356   separate trees for checked and free builds.  Build system supports
5357   a custom directory src\WINNT\extra which can be used as a grafting
5358   location of organization specific additions to the build tree.
5359
5360 * New installer built using NSIS 2.0.  
5361
5362 * Named all kernel objects in order to allow them to be monitored
5363   with tools such as SysInternals' ProcExp.exe.
5364   
5365 * Introduced new EventLog framework for AFSD
5366
5367 * Introduced Power Management interface to AFSD for Standby and 
5368   Hibernate modes to allow cache to be flushed prior to network
5369   disconnect
5370
5371 * Utilize Win32 DNSQuery API instead of internal routines.  This 
5372   allows DNS SRV queries to be sent to all current domain name 
5373   servers.  Not just one specified in an INI file.  DNS is now
5374   always activated.
5375
5376 * "NetbiosName" registry value may be used to specify a fixed
5377   Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
5378   when the loopback adapter is in use.  If you need to use the 
5379   old notation with a loopback adapter installed specify a registry
5380   entry of 
5381
5382      "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
5383
5384 * Refactor all modules which depend on LAN Adapter and NetbiosName
5385   determination in a new library: lanahelper.lib.  This allows for
5386   consistent behavior throughout the product.
5387
5388 * Move the afsd.log and afsd_init.log files to the directory specified
5389   by the "TEMP" environment variable.  This is usually %WINDIR%\TEMP
5390   for services.  Added the Date to the log entries.
5391
5392 * New registry value "RxMaxMTU" used to limit the size of the RX 
5393   packets sent by the AFS Client Service to the Server.  In order
5394   to enable OpenAFS to work across the Cisco IPSec VPN the packet
5395   size must be restricted to 1264 or smaller.  The latest NSIS
5396   installer sets a value of 1260 by default.
5397
5398 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
5399   packets.  This is not needed in order to work across the Cisco
5400   VPN but might be needed for other network environments.  This
5401   value is not set by the NSIS installer.
5402
5403 * New registry value "HideDotFiles" is used to apply the Hidden
5404   attribute to files whose names begin with a '.'.   This value
5405   is set by the NSIS installer.
5406
5407 * New registry value "MaxMpxRequests" allows the maximum number
5408   of multiplexed sessions to be configured at run time.  This
5409   value is not set by the NSIS installer.  The default value is
5410   50.
5411
5412 * New registry value "MaxVCPerServer" allows the maxmimum number
5413   of VCs per server to be configured at run time.  This value is
5414   not set by the NSIS installer.  The default value is 100.
5415
5416 * New registry value "AllSubmount" allows the "all" submount to
5417   be disabled by setting its value to 0x00.
5418
5419 * Allow cells names to be valid mount points 
5420     \\<netbiosName>\<cellname>
5421
5422 * Store the active state of drive mappings in order for afscreds.exe
5423   to restore them upon startup
5424
5425 * Add exception handling to generate a Stack Trace to the afsd_init.log
5426   file if one happens to occur.
5427
5428 * Add lots of logging to help detect the cause of invalid SMB packets
5429
5430 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
5431   conversion of Kerberos 5 "afs" service tickets.  Supports auto-
5432   renewal of expiring tokens as long as afscreds.exe is running.
5433
5434 * New afscreds.exe command line options:
5435     -A = autoinit
5436     -M = renew drive maps
5437     -N = ip address change detection
5438     -Z = unmap drives
5439
5440 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
5441   determines whether or not MIT Kerberos for Windows should be used
5442   to obtain tokens via Kerberos 5 tickets.
5443
5444 * New registry value "AfscredsShortcutParams" in 
5445   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
5446   determines the command line parameters to be specified when "fixing"
5447   the AFS Shortcut in the user's startup folder.
5448
5449 * The "ShowTrayIcon" registry value has been moved from 
5450   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
5451   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
5452   
5453 * The <cell name> registry values used to store the token expiration
5454   reminders have been moved from 
5455   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
5456   {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
5457  
5458 * Obtain the Logon User Name from the Explorer key when available
5459
5460 * new text document doc\txt\winnotes\registry.txt lists all registry
5461   values used by OpenAFS (excluding the AFS Server)
5462
5463 * BUG: rx_securityClass objects were not properly reference 
5464   counted and were never freed.  
5465
5466 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
5467   would be generated.  The existence of a server does not imply
5468   that it is not down.  If all of the servers for a cell are down
5469   return CM_ERROR_NOSUCHVOLUME instead.  This prevents the Explorer
5470   Shell from hanging.
5471
5472 * BUG: the directory name lookup cache failed to free the entries
5473   in the cache when the name cache entries cycled.  The entries
5474   in the cache would become dereferenced without being freed.
5475
5476 * BUG: fs setserverprefs could be executed without Administrator
5477   privileges
5478
5479 * BUG: the number of allocated NCB objects (100) exceeded the number
5480   which could actually be waited upon by the kernel (64).  Any objects
5481   which were utilized above the limit could never have event completions
5482   detected.
5483
5484 * BUG: smb_username_t objects were not being reference counted and 
5485   were not properly freed.
5486
5487 * BUG: smb_tid_t objects could under unusual circumstances be freed
5488   before they were no longer referenced.
5489
5490 * BUG: smb_fid_t object pointer were frequently used even when 
5491   their value could be NULL.   They were not properly released and
5492   therefore they were never freed.
5493
5494 * BUG: smb_packet_t data structures were not completely initialized
5495   upon creation
5496
5497 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
5498   Denied" because that causes the Explorer Shell to try again until
5499   access is obtained.  Instead return "Remote Resources" which allows 
5500   the shell to move on and treat the error as transient.
5501
5502 * BUG: when initializing the NCBreturns structure, separate Event objects
5503   were created for each NCB although a single Event object was supposed
5504   to be shared by all.
5505
5506 * BUG: smb_dirSearch_t objects were not being properly referenced counted
5507   or freed.
5508
5509 * BUG: smb_tran2Packet_t objects were not being properly referenced 
5510   counted or freed.
5511
5512 * BUG: directory path creation did not handle the case of multiple
5513   directories requiring creation in one attempt
5514
5515 * BUG: SMB requests which required an Extended Response were ignored.
5516   This prevented some files from being written to AFS volumes.
5517
5518 * BUG: character strings were being freed even after they were 
5519   inserted into in use data structures
5520
5521 * BUG: inconsistent usernames were used when High Security mode was
5522   enabled.  (there is still much to do in this area)
5523
5524 * BUG: pioctl() calls which require out of band RPC operations were
5525   susceptible to race conditions when performed by multiple processes
5526
5527 * BUG: memory allocation and deallocation crossed instances of the
5528   C Runtime Library producing memory leakage and corruption in 
5529   afscreds and the client configurator.
5530
5531
5532