release-notes-1-4-5-20071025
[openafs.git] / doc / txt / winnotes / afs-changes-since-1.2.txt
1 Since 1.5.1:
2
3  * A deadlock was detected when performing "fs flushall" if the 
4    file server reports VNOVNODE.   The scp->createBufferLock is 
5    already held by the current thread and there is no mechanism 
6    to propagate the knowledge.  Therefore, an alternate mechanism 
7    for clearing the cache must be developed.  A new function 
8    cm_RecycleSCache(scp,flags) has been extracted from 
9    cm_GetNewSCache().  This function performs the task of recycling 
10    an cm_scache_t object.  When called from cm_GetNewSCache() with 
11    no flags the expectation is that there are no associated buffers 
12    that are queued to be read or written.  When called from 
13    cm_Analyze() with the CM_SCACHE_RECYCLEFLAG_DESTROY_BUFFERS
14    flag, any queued buffers will be de-queued and marked as if 
15    the operations were performed so the data can be discarded.
16
17  * CM_ERROR codes were logged as "unknown" by cm_Analyze.
18
19  * In response to VNOVNODE, the parent is only discarded if the current
20    cm_scache_t is not a directory.
21
22  * In the Ioctl FlushFile and FlushVolume functions, there were no
23    checks to protect against flushing the Freelance SCache entries.
24
25  * In FlushFile, the wrong cm_scache_t object was being released.
26
27  * In cm_GetNewSCache, do not allow Freelance SCache entries to be
28    recycled.  Choose a new entry if cm_RecycleSCache fails.
29
30  * Speed up the performance of the cache manager by not 
31    holding the smb_fid_t mutex across calls to cm_SyncOp 
32    and AFS RPCs.
33
34  * Ensure that all smb_fid_t flag references are protected.
35
36  * Remove a deadlock between smb_fid_t mutex and 
37    smb_rctLock introduced in 1.4.1.
38
39  * Fix aklog AFSID lookup to use not send the realm
40    name when the realm is the local realm for the 
41    cell.  The PT Server doesn't strip the realm 
42    name when it is the local realm.
43
44  * Treat "\\afs\*." as an alias for "\\afs\all" 
45
46  * Dynamically adjust the priority of server threads
47    based upon the age of the CIFS request that is 
48    being processed.  The priority is bumped one level
49    for every 15 seconds of processing time.
50
51  * The original openafs contribution mis-used the 
52    cm_GetCallback function.  This function should only
53    be called as a side effect of a call to
54    cm_SyncOp(CM_SCACHESYNC_NEEDCALLBACK).  The way it
55    was being called results in a FetchStatus RPC being 
56    performed even when the client already has a valid
57    callback and does so in a manner that destroys the
58    synchronization of the threads that are calling 
59    cm_SyncOp.  If nothing else this results in a 
60    significant performance penalty.
61
62  * More changes to cleanup of smb_vc_t objects in
63    order to prevent race conditions.
64
65  * Reduce the amount of Power Management event logging
66    to afsd_init.log
67
68  * If the client detects that the IP address has 
69    changed, force the use of new RX connections.  This
70    enables the file server to recognize that the client
71    has moved.
72
73  * Remove a race condition and deadlock associated 
74    with cleanup of smb_vc_t objects.
75
76  * Fix the ANSI filename support.  One function that
77    required it was missing the translations.
78
79 Changes not present in 1.4.1 and since 1.5.0: 1.5.1 released 
80 (24 April 2006)
81
82  * Add a DllMain() function to afspthread.dll.  Perform
83    cleanup of thread local storage, rx queues, critical
84    sections, event handles, etc.  This was implemented
85    to avoid crashes in afspthread.dll when applications
86    which load/unload the dll attempt to terminate.
87
88  * Lock request behavior has been altered.  As of this 
89    release a locally allocated lock will be used whenever
90    the volume is RO or the requesting user's permissions 
91    are 'rl'.  This will allow end users to execute programs
92    from RW volumes when they do not have the 'k' privilege.
93
94    Note that a recent discovery indicates that the 'k' bit
95    is only supposed to control the ability to obtain read 
96    locks.  Write locks are to be controlled by the 'w' and 
97    'i' privilege bits.  
98
99  * Code has been added to enable the cache manager to be
100    able to obtain the AFSID of the authenticated user.
101    This is required to be able to determine when "Insert"
102    privileges should apply.  AFS considers a file to be
103    a new file whenever the owner's AFSID matches the 
104    AFSID of the user.  The current implementation relies
105    on the name specified during the SetToken call to be
106    correct.  This will be replaced in the future with a 
107    new RPC that allows the AFSID of the authenticated 
108    user to be obtained.
109
110  * A 32-bit-tools installer for use on 64-bit systems 
111    is now available.  These tools are for use with 32-bit
112    versions of Kerberos for Windows or JPSoftware's 4NT.
113
114 Since 1.4.1 rc10: 1.4.1 final released (9 April 2006)
115
116  * Remove the use of the "active_vcp" variable.  This variable
117    no longer serves any useful purpose and was the cause of
118    race conditions that produced under counts of the smb_vc_t
119    references.
120
121  * Change default minidump output to include data segments
122
123  * restore access to cm_IoctlGetVolumeStatus and
124    cm_IoctlSetVolumeStatus calls for AFS pioctl operations.
125    Still need to figure out why they are being called
126    for SMB/CIFS IOCTL operations instead of Trans2GetFileInfo.
127
128 Changes not present in 1.4.1: 1.5.0 released (16 Feb 2006)
129
130  * Update build system to include the "sys_name" in the 
131    obj and dest paths.
132
133  * optimize the number of calls to obtain the smb_user_t for a 
134    smb virtual circuit.
135
136  * add logging of server addresses, status and capabilities when
137    pinging the server.
138
139  * prevent multiple threads from pinging the same server simultaneously.
140    instead, threads block and then use the result of the ping that was
141    already taking place.
142
143  * Add registry values to allow the defaults for daemon checks to be altered
144    at startup.  Log values to afsd_init.log.
145
146    daemonCheckDownInterval
147    daemonCheckUpInterval
148    daemonCheckVolInterval
149    daemonCheckCBInterval
150    daemonCheckLockInterval
151    daemonCheckTokenInterval
152
153  * Add EventLog messages for transitions in fs crypt state.
154
155  * Byte range locking (when locks will be obtained from the
156    is still under discussion)
157
158  * 64-bit Windows operating systems now supported 
159    (XP SP2 64-bit, 2003 SP1 64-bit, 2003 R2 64-bit)
160    This is a native 64-bit implementation of OpenAFS for Windows.
161    There is currently no 64-bit version of KFW and therefore 
162    there is no (easy) method for obtaining AFS credentials.  
163    32-bit KFW 3.0 can be used with 32-bit OAFW libraries
164    to obtain AFS tokens but there is not for the feint of 
165    heart.
166
167  * A faster implementation of the fcrypt algorithms improves 
168    performance.
169
170  * The afsd_service.exe now supplies Event Log Message Text.
171    The event log no longer generates warning text due to lack
172    of message configuration.
173
174  * When afs servers are unreachable and network stack returns
175    a WSAEHOSTUNREACHABLE error, the AFS client will immediately 
176    mark the attempted server as being down.   This allows for
177    very fast response to the calling application.  This change
178    has a pronounced improvement when the Windows Explorer is
179    used on disconnected mobile computers.
180
181  * Added DebugOutputString debugging of the RX library
182
183 Since 1.4.1 rc9:  1.4.1 rc10 released (10 March 2006)
184
185  * Fix the rx-lwp implementation to randomly generate rx call
186    identifiers which are supposed to be unique at a given point
187    in time.  This affects some of the command line tools used
188    for debugging but not the AFS Client Service itself which
189    uses the rx-pthreads implementation.
190
191  * xstats_fs_test.exe and xstats_cm_test.exe are now built for
192    Windows although they are not distributed
193
194  * don't generate an exception when logging unexpected SMB packets
195
196  * the data structures used by cm_IoctlGetVolumeStatus and 
197    cm_IoctlSetVolumeStatus are not compatible with the CIFS
198    Get/Set File Information calls so don't bother executing them.
199
200 Since 1.4.1 rc8:
201
202  * Fix data written to registry as part of BackConnectionHostnames
203    data value
204
205  * Fix initialization bug when allocating cm_server_t objects that
206    would cause servers to appear to be down after each allocation
207    or renewal.   Server would appear up after the next check servers
208    cycle.
209
210 Since 1.4.1 rc7: 
211
212  * Windows will return WSAECONNRESET to the next receive packet
213    operation on a socket if an ICMP packet is received in response
214    to a packet that was sent and could not be delivered because
215    the port was unreachable.  We have to treat this as 
216    WSAEWOULDBLOCK so that we can retry the select() check and
217    not mark the connection as bad.
218
219 Since 1.4.1 rc6: 1.4.1 rc7 released (14 Feb 2006)
220
221  * The client manager maintains a least recently used list of
222    all the ACLs.  If an ACL is already the most recently used
223    do not bother to remove it from the list and place it on the
224    front.
225
226  * As part of the process of adding a new server, set the 
227    server is down flag and then perform a ping.  If the server
228    is up, the flag will be reset.  If the server is down, the
229    client will not timeout unnecessarily while attempting to
230    perform real work.
231
232  * If a Mountpoint String is the empty string, return PATH NOT 
233    FOUND.
234
235  * Modify behavior of the Network Provider to avoid querying the
236    profile location if integrated logon is known to be disabled.
237
238  * Correct behavior of 'LogoffPreserveTokens'.  When set, tokens
239    will always be preserved regardless of whether or not integrated
240    logon was used to obtain tokens.  When unset, tokens will be 
241    destroyed regardless of whether integrated logon was used to 
242    obtain the tokens unless the profile is stored in AFS.
243
244  * Disable LogoffTransferToken functionality.  The SMB V3 Logoff
245    message is being delivered even when the user is not logging
246    off of the computer.  
247
248  * Fix a deadlock condition introduced in rc6.
249
250  * Cell names are case-insensitive.  Since the founding of OpenAFS
251    there has been a bug that treated "cell", "Cell", and "CELL" as
252    different cells.  This would result in what appeared to be 
253    random disappearance of user tokens or a failure to authenticate
254    even when tokens were listed by the "tokens" command.
255
256 Since 1.4.1 rc5: 1.4.1 rc6 released (2 Feb 2006)
257
258  * Additional auditing of the smb code revealed that smb ioctl
259    operations were failing to free smb_fid_t objects
260
261  * The File Identifiers assigned to smb_fid_t objects could be
262    given the value 65535 which is 0xFFFF which is also the 
263    INVALID_HANDLE value.  Both 0 and 65535 are now treated as
264    reserved values.
265
266  * Audited all assignments to fields and ensured that they are
267    protected by obtaining the relevant mutex object.
268
269  * Re-wrote the VNOVNODE handling to avoid a potential deadlock
270    if both the current cm_scache_t object and its parent are
271    both returning VNOVNODE.
272
273  * Removed all the logic associated with the 'dead_vcp' variable
274    which must have been added for debugging because its used 
275    was never thread safe and it truly served no purpose.
276
277 Since 1.4.1 rc4: 1.4.1 rc5 released (18 Jan 2006)
278
279  * Check access permissions to the file before the file is 
280    truncated.
281
282  * More improvements to the handling of SMB Virtual Circuits
283    when SMB sessions are closed.
284
285  * Correct a race condition introduced in rc4 that could result
286    in a crash of afsd_service.exe.
287
288 Since 1.4.1 rc3: 1.4.1 rc4 released (11 Jan 2006)
289
290  * Properly handle pre-mature SMB session closures.
291    File handles, tree connections, and user sessions are now
292    freed when the virtual circuit is closed.
293
294  * smb_username_t and smb_user_t objects are now properly reference
295    counted and freed as appropriate.
296
297  * disable to use of AFS file locks.  byte range locking is still
298    implemented but all locks are managed locally.  This prevents
299    multiple processes from editing the same file on the same 
300    machine but it does prevent multiple processes on separate 
301    machines from modifying the file.
302
303 Since 1.4.1 rc2: 1.4.1 RC3 released (4 Jan 2006)
304
305  * A fix to "fs setserverprefs -vlserver".  Multiple calls with
306    the same server parameter would result in a panic condition
307    if the server had not already been contacted by the AFS 
308    client service.
309
310  * Better warnings are written to the afsd.log file when 
311    the Windows RPC Protocols are not properly configured as
312    is often the case on Windows 2000.
313
314  * fix the procmgmt library to restore C RTL signal handlers when 
315    it is being detached from the process prior to process termination.
316
317 Since 1.4.1 rc1: 1.4.1 RC2 released (30 Nov 2005)
318
319  * close a lock leak in the rx library that could be triggered while
320    processing aborts
321
322  * prevent removal of drive mappings in response to afscreds.exe -M
323
324  * add logic to process VNOVNODE in cm_Analyze.  Force re-evaluation of symlink
325    strings and flush the stat cache entry.
326
327  * prevent server objects from being freed if user preferences are set.
328
329  * Update WIX support to 2.0.2419.0
330
331  * Release all locks on the server at service shutdown.
332
333  * A down server should be marked up as long as it responds to the client.
334    It doesn't matter if the server returned an error as long as the error
335    is something other than VRESTARTING.  If there is such an error, all
336    connections on that server should be marked for replacement.
337
338  * Change the check "up" servers period from once per hour to once every
339    ten minutes.  This matches the behavior of the Unix cache manager.
340
341 Post 1.4.0 revisions: 1.4.1 RC1 released (21 Oct 2005)
342  * Byte Range Locking support has been added.  Architectural documentation
343    is located within src/WINNT/afsd/cm_vnodeops.c.   Best efforts are
344    made to enforce Windows mandatory locking model using locally managed
345    byte range locks with full file locks obtained from the file server.
346    Read-only volumes provide the user with an implied locking privilege.
347    Read-write volumes require that a user be granted the locking privilege
348    in order for a lock to be obtained.   As most Windows applications use
349    Shared file access modes, they require the ability to obtain locks in
350    order to access files.
351
352  * Implement error translation functions to convert Universal Error Codes
353    output by modern servers to local errno and winsock error values.
354    This fixes the error message problems using pioctl() calls from fs.exe
355    and the AFS Shell Extension.
356
357 Since 1.4.0 rc8: 1.4.0 final tagged (20 Oct 2005); released (31 Oct 2005)
358  * Allow the AFS Client Service to set the firewall configuration by
359    retrying until after Windows determines the boot period is over.
360
361  * Do not attempt to configure the firewall on Windows 2000, XP pre-SP2,
362    or 2003 pre-SP1
363
364  * Detect IP address changes from within the AFS Client Service for the
365    purpose of checking down servers sooner
366
367  * If the file server or vldb server report RXKADUNKNOWNKEY, return
368    SEC_E_NO_KERB_KEY to Windows.   This provides an indication to the
369    user that there is a Kerberos key problem.  Previously the user would
370    receive no feedback when there was something wrong.
371
372  * Fix the large integer library support to properly handle values greater
373    than 32-bits
374
375 Since 1.4.0 rc7: 1.4.0 rc8 released (15 Oct 2005)
376  * Updated CellServDB
377
378  * Fixed file name pattern matching.  Question marks can match nothing
379    if found at the end of a component.
380
381 Since 1.4.0 rc6: 1.4.0 rc7 released (8 Oct 2005)
382  * Kerberos 5 ticket lifetimes should adhere to KFW Leash lifetimes
383
384  * The MSI installer now has a new Product ID for each build.  This
385    is to allow for automated upgrades.   The Upgrade ID is remaining
386    constant.
387
388  * Volumes that were cached and then subsequently were salvaged,
389    moved or otherwise taken temporarily offline (as opposed to being
390    busy) would become unreachable.  A distinction is now made between
391    a volume being offline and a server being down.
392
393 Since 1.4.0 rc5: 1.4.0 rc6 released (2 Oct 2005)
394
395  * Fixed several AFS Shell Extension issues:
396    - Checking Server Status would only work if a specific cell was
397      specified.
398    - If servers were down, the Server Down dialog would write to 
399      invalid memory and cause explorer.exe to crash
400    - Default Push Buttons were not specified for many dialogs
401    - The extension would be unloaded by the Explorer Shell and
402      never be reloaded under some circumstances. 
403
404  * Fixed the AFS System Tray menu to disappear if another Window
405    was selected before a menu item was selected
406
407  * Added volume owner and group information to "fs examine" output
408
409  * Added fs and registry support for enabling/disabling/clearing 
410    rx statistics gathering.
411
412 Since 1.4.0 rc4: 1.4.0 rc5 released (25 Sep 2005)
413
414  * New Product Code GUIDs issues for 1.4 and 1.5 branches.  Separate
415    GUIDs for each platform.
416
417  * Documentation directory structure and default installation rules
418    for MSI 
419
420  * New OpenAFS for Windows HTML Release Notes installed
421    as part of the documentation set.
422
423  * Add thread id to rx debugging messages
424
425  * When all servers are offline, return a bad network path error
426    immediately.  This is necessary to allow Explorer to do the 
427    right thing and not hang.   The background daemon thread will
428    check the down servers every 30 seconds to see if they are
429    back up.  
430
431 Since 1.4.0 rc3: 1.4.0 rc4 released (14 Sep 2005)
432
433  * The AFSCache file has been modified to store both the
434    serial number of the volume on which the file resides
435    and the SID of the local machine.   If either change,
436    a new UUID is generated.
437
438  * add "fs flushall" command that forces all data buffers
439    to be flushed.
440
441 Since 1.4.0 rc2: 1.4.0 rc3 released (4 Sep 2005)
442
443  * add support for '/' instead of '\' in pioctl() calls
444
445  * Apply AFS Client Admins group protect to AFS Shell Extension
446
447  * Add support for \\afs\<name> to most AFS Shell Extension 
448    commands except the symlink methods. 
449
450  * when installing the Microsoft Loopback Adapter, enable
451    MS Client for Networks and prevent an install failure 
452    by not calling CoInitialize twice in the same thread.
453
454  * reload cell vldb values from the CellServDB every two
455    hours in case it changes
456
457  * When updating cell information from DNS, be sure to set 
458    a new timeout.
459
460  * Add support to allow use of \\AFS\<foo> where <foo> is 
461    either a mount point or symlink.   As <foo> is normally 
462    treated as a share name, we transform it into \\AFS\all\<foo> 
463    for processing.
464
465  * Init 'code' to prevent false errors when integrated logon 
466    is disabled and the service is not running
467
468 Since 1.4.0 rc1: 1.4.0 rc2 released (28 Aug 2005)
469
470  * Removed trace log messages that were hampering performance.
471
472  * Fixed a deadlock that was being triggered by editing Word 
473    documents stored within AFS with WinWord 2003.
474
475  * Bit 3 of the TraceOption registry value is now used to set the
476    default for "fs trace" in the non-Debug builds.  The new default
477    is off for release builds and on for debug builds.
478
479  * Bit 2 of the TraceOption registry value can be used to turn on
480    real-time output of debug log entries to the Windows Debug
481    Output monitor interface.  This data can be viewed with tools
482    such as Sysinternal's DbgView.
483
484 Since 1.3.87: 1.4.0 rc1 released (17 Aug 2005)
485  * When the cache manager reports ALLBUSY or ALLOFFLINE for
486    a resource we should not be returning status codes such
487    as Network Busy or Remote Host Down because these errors
488    will imply that the AFS Client Service is Busy or Down
489    and that is simply not the case.   Instead we will return
490    Bad Network Path as the path is temporarily not available.
491
492    Instead of returning Sharing Paused when there is a
493    timeout error, return Timeout.  Once again, the AFS Client
494    Service is not paused.
495
496  * afscreds.exe would display an Obtain Creds dialog when
497    the expired credentials reminder was triggered even 
498    if there was no network path to the KDC.  This is prevented
499    by adding KDC probe logic to the reminder thread.  
500
501  * afscreds.exe would display expired tokens no differently
502    than unexpired ones.  This would make it difficult for the
503    user to distiguish when the tokens were expired.  For the 
504    English build added a new resource string "(expired) that
505    is displayed instead of the expiration time. 
506
507 Since 1.3.86:
508  * "fs wscell" when executed in freelance mode will return the
509    name of the cell configured in the registry.  The root.afs
510    volume is not loaded from this cell, but it is used for the
511    default for aklog and integrated login.
512
513  * "fs mkmount, fs rmmount, symlink make, symlink remove" will
514    no longer work on \\AFS\all when freelance is being used 
515    unless the user is a member of the "AFS Client Admins" Windows
516    Security group.
517
518  * some more checks performed during persistent cache validation.
519
520 Since 1.3.85:
521  * Optimize calls to cm_CheckServer from cm_Analyze.  Only check
522    down servers for the current cell not all cells.
523
524  * If the scache LRU list becomes corrupted, the AFS Client Service
525    might enter an infinite loop at startup.   Detect the corruption
526    and discard the cache contents in this case.
527
528  * Fixed the Explorer Shell's remove mountpoint functionality.
529
530  * Fixed a deadlock caused by the holder of cm_aclLock attempting to 
531    obtain a mutex lock on a cm_scache_t object whose lock is held by
532    a thread attempting to obtain the cm_aclLock.
533
534 Since 1.3.84:
535  * Really fixed DNS AFSDB queries to ensure that "csail" cannot be
536    misinterpretted as "csail.mit.edu" when the resolver 
537    is configured to append ".mit.edu" to failed DNS queries.
538
539  * Added a new registry key, "LogoffPreserveTokens" (see registry.txt),
540    that can be used to force the preservation of user tokens upon logout.
541
542  * Update the NSIS install scripts to use NSIS 2.07.   This release adds 
543    recommended installation categories: AFS Client, AFS Administrator,
544    AFS Server, AFS Development Kit.  Each category includes a different 
545    default subset of the OpenAFS components.
546
547    The OpenAFS logo is now associated with the NSIS uninstall entry
548    in the Add/Remove Programs control panel.
549
550  * The user name associated with AFS tokens when obtained with
551    integrated login, the afs systray tool, or aklog will always
552    include the full Kerberos 5 user principal name regardless of 
553    whether or not the cell is local to the realm.
554
555  * Modify integrated login so that it does not enter an infinite
556    loop if the service is not set to auto start.
557
558  * Added asetkey.exe used to set a Kerberos 5 key for use by the
559    AFS server daemons
560
561  * Added uninstall.exe to Wix installation
562
563  * More modifications to algorithms used to wake sleeping threads.
564
565 Since 1.3.83:
566
567  * Changes to the algorithms used to wake threads when they are
568    put to sleep because of conflicts over buffer operations.
569
570 Since 1.3.82:
571  * The OpenAFS integrated logon obtains Kerberos 5 tickets as part of 
572    the process of producing AFS tokens.  The tokens are stored within
573    the AFS Client Service but the Kerberos 5 tickets have been discarded.
574    New functionality has been added to temporarily copy the tickets to
575    a file ccache during the short window between the NPLogonNotify and
576    WinLogon Logon Event.  The Logon Event handler starts a process as
577    user, afscpcc.exe, that copies the tickets into the default ccache.
578    The file ccache is then destroyed by the event handler.
579
580  * During synchronization operations on stat cache entries, if threads
581    are forced to sleep it was possible that the threads would not be
582    woken under heavy load.
583
584  * Enforce the delete on close flag specified by the NTCreateX()
585    operation.
586
587  * A race condition in the rx library was fixed that resulted in 
588    a deadlock in rx_NewCall when the RX_CONN_MAKECALL_WAITING flag
589    was cleared when threads were still waiting to use the 
590    connection.   Also, fixed a potential case in which the 
591    connection could be destroyed while threads were waiting to use it.
592
593  * The DNLC freelist has been seen to become corrupted with still 
594    active entries being stored on the freelist.  Changes were made
595    to perform a better job of cleaning entries before placing them
596    onto the freelist; marking them with the correct magic value when
597    purging the list; and allowing the list to be purged on startup
598    if the cache validation fails.
599
600  * Windows Crash Reporting does not get triggered for afsd_service.exe
601    because it provides its own top level exception handler.  This patch 
602    places an explicit call to ReportCrash() on platforms which support 
603    it.  (XP and above.)
604
605    If you configure Crash Reporting via AD Policy to capture crash
606    reports within the domain, then you will receive this output.
607
608  * Generate MiniDumps independent of the Windows Crash Reporting.
609  
610    (a) If an exception occurs,a minidump will be generated at the path
611        %TEMP%\afsd.dmp. The type of minidump defaults to Normal but 
612        can be set to any other type via use of the
613        registry.      
614
615        [HKLM\SOFTWARE\OpenAFS\Client]  MiniDumpType (DWORD)
616
617    (b) MiniDumps can be generated at any time using the "fs minidump"
618        command.   This allows you to generate a minidump without 
619        stopping the process or even requiring the use of a debugger
620        on the system.
621
622   * an RX connection which reports bad ticket now treats it the same way
623     the expired ticket is treated.   The ticket is removed from the 
624     connection and a new anonymous connection is established.
625
626   * fs memdump now requires that the caller be in the AFS Client Admins
627     group
628
629   * additional debugging information is provided in cm_Analyze when the
630     error code is ignored.
631
632   * Fix a regression introduced into the pioctl() client code which
633     will cause a crash in winlogon.exe, explorer.exe and fs.exe if
634     MIT KFW is not installed. (1.3.82a)
635
636   * Remove AFS Gateway option from OpenAFS Control Panel (1.3.82a)
637
638 Since 1.3.81:
639   * Fix a race condition in cm_EndCallbackGrantingCall() that 
640     could leave 'nrevp' pointing to freed memory.  In the process,
641     optimize the processing to ensure that the applications monitoring
642     the status of the stat cache entry are only notified at most 
643     once.
644
645   * Conditionalize access to the Explorer Shell AFS->Mount Point
646     ->Remove menu item.  Disable the item if the selected item(s)
647     are not mount points.
648
649   * Activate AFS RPC (RX) Free Packet Queues stored in Thread
650     Local Storage.  This eliminates thread contention on the
651     global RX free packet queue.  This should improve performance
652     on multi-CPU systems.
653
654   * Fix the IP address filtering code to properly load/unload
655     the IPHelper DLL so that Windows XP/2003 and beyond systems
656     do not have to manually probe the registry.
657
658   * CleanupACLEnt() was not being called consistently with 
659     the cm_scache_t object referred to by the back pointer
660     mutex locked. This could in very rare conditions lead to
661     an invalid memory access.
662
663   * Added a script command to the msi installer "afs_replace"
664     which can be used to replace one version of OpenAFS with
665     another without requiring an uninstall and reinstall if
666     the installed msi is no longer in its original location.
667
668   * Apparently the problem with multi-domain forests with cross-
669     realm trusts to non-Windows realms was not entirely solved.
670     The authentication to the AFS SMB service failed because 
671     the wrong name was being used.  Using ASU as an example,
672     the authentication was being performed with the name
673     "QAAD\user" (an account in the forest root) and not 
674     "user@ASU.EDU (the MIT Kerberos principal used to login with)
675
676     The solution was to add an additional dependency on KFW
677     in order or to be able to easily obtain the client principal 
678     name stored in the MSLSA ccache TGT.  This information is 
679     used in two locations:  
680
681     - the pioctl() function 
682
683     - a new WinLogon Event Handler for the "logon" event.  
684
685     The pioctl function will now be able to use the correct
686     name when calling WNetAddConnection2() and the "logon"
687     event handler will now be able to call WNetAddConnection2().
688     The hope is that the "logon" event handler will be called 
689     before the profile is loaded but I have not guarrantee
690     that will happen. 
691
692 Since 1.3.80:
693   * Fixed a locking error in cm_TryBulkStat() which had the
694     potential of deadlocking the system for the length of time
695     it takes to perform a bulk status fetch operation.
696
697   * Replaced time conversion code (UnixTime <-> FILETIME) to 
698     be completely arithmetic instead of relying on a bizarre
699     algorithm involving a variety of C RTL time functions.
700     This has the side effect that UnixTime and FILETIME which
701     are both stored in UTC are interpretted as UTC throughout
702     the year.  Windows will apply the same localization to AFS
703     as it does to NTFS.  Applications which rely on the ability
704     to sync files between the two file systems will no longer
705     see the timestamps of files in AFS change an hour relative
706     to the files stored in NTFS or Windows based backup devices.
707
708   * Fixed a invalid memory access under a bizarre circumstance.
709     Windows will allow a physical mass media device to be 
710     installed via Plug N Play to the system and will assign it
711     the lowest available drive letter.  This is true even if the
712     drive letter is currently assigned in the user session to
713     a network device via NET USE (or its equivalent.)  When this
714     happens, queries sent to the CIFS server will contain invalid
715     data.  This invalid data was not being caught by the AFS 
716     Client Service and was resulting in a crash when Freelance
717     mode was in use.  
718
719   * Fixed a reference count error when registering callbacks
720     on a stat cache object if the callback was already registered
721
722   * Add a case to cm_Analyze() in order to handle the case where
723     cm_GetConnByMServers() returns CM_ERROR_NOSUCHVOLUME because
724     the server list for the volume is empty.  In this case, force
725     an update of the volume info and retry.
726
727   * Insert a missing cm_EndCallbackGrantingCall() which could
728     result in threads waiting for a callback to complete to never
729     be woken up.
730
731   * In the persistent cache, there is a maximum number of volume
732     entries.  Allow volume entries to be reused if the maximum
733     number have been allocated and their reference count is zero.
734
735   * If we already have a dead virtual connection object, don't 
736     ignore the fact that additional dead vc objects must be taken
737     care of.
738
739   * Removed a deadlock condition introduced in the summer of 2004.
740     Do not hold mx locks around calls to RX functions including
741     rx_NewCall().  That is what reference counts on the rx_connection
742     object are for.
743
744   * Fixed an initialization error in afslogon.dll which could
745     result in random behavior including a failure to terminate
746     the NPLogon function. (1.3.80b)
747
748   * Fixed an error preventing the use of SMB authentication
749     on Windows 2000.  (1.3.80a)
750
751 Since 1.3.77:
752   * Updated CellServDB to Public CellServDB 16 Mar 2005
753
754   * Fixed DNS AFSDB queries to ensure that "csail" cannot be
755     misinterpretted as "csail.mit.edu" when the resolver 
756     is configured to append ".mit.edu" to failed DNS queries.
757
758   * Fixed another case in which the client would replace connections
759     to the host when it was not necessary.  In this case the 
760     situation would occur if cryptall was on and the connections
761     were unauthenticated due to lack of an appropriate token.
762
763   * OpenAFS for Windows has failed to work at sites which are 
764     utilizing a cross-realm trust between an MIT/Heimdal realm
765     and a multi-domain Windows forest when the workstation being
766     accessed is not located in the root domain.  This is caused 
767     by a bug in the workstation which was triggered after the 
768     introduction of Windows 2003 Server.  When the bug is triggered,
769     the workstation attempts to authenticate users to afsd_service.exe
770     by contacting the Domain Controller instead of using the 
771     LSA loopback authentication mechanism.
772
773     One of the reasons this bug occurs is because the workstation    
774     does not have a reliable way of knowing that the service whose
775     netbios name is "AFS" is located on the workstation.  This will
776     be fixed starting in Longhorn Beta 1 by Microsoft.  The 
777     "BackConnectionHostNames" registry value will be used to 
778     indicate that the authentications to that service name should
779     be performed using the loopback authentication mechanism.
780
781     In the meantime, when Logon Caching is enabled, we can force
782     afsd_service.exe to authenticate using the logon cache before
783     contacting the Domain Controller.  This will work with both
784     password and smart card based logons.  
785
786   * The allDown logic in cm_ConnByMServers() was wrong.  The allDown
787     flag should not be cleared if a volume's server reference is 
788     marked as "offline".  In the case where all of the volume's 
789     servers are either "down" or the volumes are "offline", we want
790     cm_Analyze() to process the condition as CM_ERROR_ALLOFFLINE
791     instead of as CM_ERROR_TIMEDOUT.  In fact, CM_ERROR_TIMEDOUT
792     should never occur in practice.
793
794     In the case of CM_ERROR_ALLOFFLINE, cm_Analyze() will sleep for
795     5 seconds, clear the server down and volume busy flags, and 
796     then force an update from the VLDB.  This allows the client to 
797     update the location of a volume if the reason for it being 
798     marked offline is because it is being moved.  Calls to 
799     cm_ConnByMServers() will be retried either until success or
800     the RDRtimeout period is reached.
801
802   * Correct the Power Management code behavior in response to 
803     Standby, Suspend, and Shutdown events.  Instead of flushing the
804     buffers associated with the mounted SMB submounts, simply write
805     all buffers which are marked dirty.
806
807   * Added support for "TheseCells" to afslogon.dll.  "TheseCells"
808     provides a list of cells other than the default cell for which
809     tokens should be obtained using the default Kerberos principal.
810     This functionality is logon domain specific and is only available
811     when using KFW for authentication.
812
813   * Fixed FindNext Invalid Handle error caused by over agressive 
814     attempts at garbage collecting dirSearch entries when the 
815     dirSearch ID wraps from the maximum value to 1.
816
817   * Add support for registry defined server preferences for VLDB and 
818     File servers.  See registry.txt for details.
819
820   * Increased default cache size to 96MB and default number of cache
821     entries to 10,000.
822
823   * Fixed refCount leaks related to directory lookups and pioctl calls.
824
825   * Callbacks revoked during a race condition with an attempt to 
826     obtain the same callback no longer result in an inaccessible
827     stat cache entry.
828
829   * New command line tool:
830
831         afsdacl : Set or reset the DACL to allow starting or stopping
832              the afsd service by any ordinary user.
833
834         Usage : afsdacl [-set | -reset] [-show]
835               -set   : Sets the DACL
836               -reset : Reset the DACL
837               -show  : Show current DACL (SDSF)
838
839   * IP addresses are no longer queried once at startup.  Instead IP
840     addresses are obtained as needed.   Loopback adapter addresses are
841     no longer published to the server.
842
843   * Pay attention to the MIT KFW registry configuration for automatic
844     importation of MSLSA credentials. (SOFTWARE\MIT\Leash32,MsLsaImport)
845
846   * Fix (once again) case-sensitive comparisons which was apparently 
847     broken in 1.3.72.
848
849   * Activate support for vos listvol -format
850
851   * Population of the "AFS Client Admins" group failed on non-English
852     versions of Windows because the name of the "Administrators" group
853     is localized.  Now we lookup the name of the group by using the
854     Administrators Group Alias Relative ID.
855
856   * Multiple cell token acquisition within afscreds.exe was broken in the 
857     case of Kerberos 5 cross realm authentication.  Instead of contacting
858     the KDC associated with the cell's realm, afscreds would obtain a 
859     token from the KDC of the user's realm.  This would result in
860     "invalid kvno errors" while authenticating to the AFS servers.  
861     Unauthenticated access would work.  The symptoms would vary based upon
862     whether or not the VLDB servers had been contacted using unauthenticated
863     connections prior to the user obtaining tokens.
864
865   * The list of ACL entries was becoming corrupted.  It appears as if 
866     an ACL when it expires was not being appropriately cleaned up.  In
867     fact, it was left in the list of ACLs associated with the scache 
868     entry.
869
870   * Changed the default @sys name list to "x86_win32 i386_w2k i386_nt40"
871     for 32-bit x86 systems.  The default for itanium will be "ia64_win64"
872     and "amd64_win64" for amd 64-bit processors.
873
874   * When executing executables, Windows provides a mechanisms by which
875     the normal search for DLLs can be bypassed.  If a file foo.exe is
876     being executed and there exists a file or directory "foo.exe.local" 
877     (the contents are ignored if a file), then Windows will search for
878     DLLs first in the "foo.exe.local" directory and second in the 
879     directory in which the "foo.exe" file is located.  
880
881     Previous releases of OAFW would improperly return 
882     STATUS_NOT_A_DIRECTORY instead of the expected 
883     STATUS_OBJECT_PATH_NOT_FOUND.  This would cause the Windows SMB client
884     to terminate the search for the DLL causing the execution of the 
885     application to fail.
886
887   * Rework the reference counting of smb_vc_t objects.  The references  
888     stored in the waiting locks were not counted.  This could result in
889     an assertion if the reference count drops to zero.
890
891   * "fs wscell" returns "Freelance.Local.Root" for the workstation cell
892     when running in freelance mode.
893
894   * Added support for persistent caching of file contents, stat entries,
895     volume data, cell data, and name lookup data.  When the registry 
896     value, "NonPersistentCaching", is not defined or set to 0 the file 
897     specified by "CachePath" becomes a persistent cache file.   The 
898     size of the cache file is computed at run time.  It has a maximum
899     size of approximately 1.2GB.  The contents of the file will be 
900     validated according to the rules specified by the "ValidateCache"
901     registry value.  
902
903   * Added support for UUIDs.  UUIDs are kept for as long as the 
904     cache file is intact.
905
906   * Added cmdebug.exe and support cache manager debugging callback 
907     interfaces in afsd_service.exe.
908
909     Usage: cmdebug -servers <server machine> [-port <IP port>] [-long] 
910                    [-addrs] [-cache] [-help]
911     Where: -long   print all info
912            -addrs  print only host interfaces
913            -cache  print only cache configuration
914
915   * Symlinks to \\AFS\[all\]... will now be treated the same as 
916     symlinks to /afs/....   However, please use /afs/... as otherwise
917     the symlinks won't work on Unix.
918   
919   * Correct a problem with local CellID allocation for cells whose 
920     server list is obtained via DNS instead of a CellServDB file.  If
921     the DNS information expires the CellID assigned to the entry will
922     be changed.  This causes all of the cm_scache_t objects which refer
923     to the old cellID number to become useless.  Attempts to access 
924     files or directories with cm_scache_t objects using the old cellID
925     will fail since the server list cannot be obtained.
926
927   * Correct deadlock condition in cm_EndCallbackGrantingCall which can
928     be triggered if the volume referenced by the cm_scache_t object is
929     offline.
930
931   * The AFS Service needs to respond to SERVICE_ACCEPT_SHUTDOWN messages
932     in addition to SERVICE_ACCEPT_STOP.
933
934   * Move RPC shutdown until after the SMB and RX shutdown procedures 
935     complete.  Block until RPC shutdown is complete.
936
937   * Modify afslogon.dll (integrated logon) to wait for service if its
938     state is START_PENDING.  If the timeout period occurs, reset to 
939     the retry interval and not the sleep interval.
940
941   * When renewing the server list for a cell obtained via DNS AFSDB
942     records, the cm_cell_t entry must be removed from the list of all 
943     cells.  Otherwise, the list of cells will be corrupted.
944  
945   * In the dcache and scache modules, use the cm_scache_t dataVersion
946     instead of the cm_fakeDirVersion.  
947
948   * Synchronize fs.c with the unix version.
949
950   * The variable used to determine whether a file or virtual memory
951     mapped cache is used was not properly initialized to a default
952     value. If the registry setting "NonPersistentCaching" was not
953     set, the choice would be random.   Properly initialized to be
954     "file".
955
956   * The memory mapped view was never unmapped before closing the file
957     at service shutdown.  This is now properly cleaned up.
958
959   * Default location of Cache file is now %TEMP%\AFSCache
960
961 Since 1.3.76:
962
963   * A bug affecting new installations of 1.3.75/76 would result in
964     the creating of incorrect mountpoints in the freelance root.afs 
965     volume for the default cell.
966
967     If "fs \\afs\all\<cellname>" lists a volume name of "root" instead
968     of "root.cell", you have been affected by the bug.  To correct the
969     problem, execute the following commands:
970
971           fs rmmount \\afs\all\<cellname>
972           fs rmmount \\afs\all\.<cellname>
973         
974           fs mkmount \\afs\all\<cellname> root.cell <cellname>
975           fs mkmount \\afs\all\.<cellname> root.cell <cellname> -rw
976
977 Since 1.3.75:
978
979   * A bug has been fixed in the auto-generation of Freelance root.afs
980     symlinks which produced random entries in the \\AFS\all directory.
981
982   * Support has been added for multi-homed servers
983
984 Since 1.3.74:
985   * Added a new registry value, "StoreAnsiFilenames", which can be used
986     to force the use of ANSI character sets instead of OEM Code Pages.
987     This feature is useful when users require the ability to create 
988     filenames with 8-bit characters and need to access the files from
989     both Latin-1 based Unix systems as well as from Windows.
990
991     Activation of this feature will prevent access to files stored with
992     8-bit OEM characters.
993
994   * Shutdown all SMB threads in a synchronized manner when stopping the 
995     service.
996  
997   * There is currently a maximum cache size of 1.3GB.  The limit is imposed
998     by the largest contiguous block of unused memory within the 2GB process
999     space which can be assigned to the memory mapped file.  Unfortunately,
1000     when the executable digital signature verification code is activated
1001     Windows sees fit to further segment the process memory which in turn
1002     reduces the size of the maximum cache file to less then 800MB.  If
1003     larger cache sizes are desired, a new registry value should be set:
1004
1005       HKLM\SOFTWARE\OpenAFS\Client (DWORD) "VerifyServiceSignature" = 0x0
1006
1007     Setting this value will disable the runtime verification of digital
1008     signatures on afsd_service.exe and the afs dlls which it loads.  It
1009     will not disable the the version number check on those same files.
1010     The signature verification is not a security messure and is only meant
1011     to enhance the ability to afsd_service.exe to detect potential
1012     destablizing mixtures of DLLs from incompatible distributions.
1013
1014     Added code to auto-disable the signature verification check if 
1015     the desired cache size is greater then 700MB.
1016
1017   * Windows' WinTrustVerify(WIN_SPUB_ACTION_PUBLISHED_SOFTWARE) is 
1018     used to verify the validity of the afsd_service.exe binary 
1019     as well as each of the AFS DLLs loaded by the service.  Not only
1020     must the digital signature be valid but the signatures of the 
1021     DLL must be signed by the same entity as the service.
1022
1023   * Implement new functions: cm_freelanceMountPointExists and
1024     cm_freelanceSymlinkExists.  Use them along with other validity
1025     checks in cm_freelanceAddMount and cm_freelanceAddSymlink to
1026     ensure that name collisions do not occur and that empty strings
1027     are not valid file names.
1028
1029     A symlink may not have a name which would resolve to a valid 
1030     cell name.  Doing so would prevent access to the cell.
1031
1032   * Add missing cm_HoldSCacheNoLock call to Freelance mount point
1033     re-initialization code.  The reference counts of the fake root.afs
1034     volume scache object(s) would become invalid when the mount point
1035     or symlink lists were altered.
1036
1037   * Add registry entries to provide mappings from the afsdsbmt.ini
1038     to the new locations for applications which count on the use
1039     of the old Profile file APIs.  These apps are likely to fail
1040     if the user does not have administrator privileges and the 
1041     registry is locked down.
1042
1043   * The afs_config.exe submounts dialog had two errors.  
1044     First, attempts to remove entries failed because the registry
1045     key was being opened without KEY_WRITE privileges.  
1046     Second, when editing a submount entry, changing the name
1047     would add a new key and leave the original one in place. 
1048     Now the original submount will be removed if its name is 
1049     changed.
1050
1051   * In recent months there have been several incidents in which
1052     users have experienced problems starting or accessing 
1053     afsd_service.exe and after significant effort has been spent
1054     it has turned out that they have two versions of AFS on the
1055     machine or an inconsistent set of DLLs.  
1056
1057     Code has now been added to afsd_service.exe which will walk
1058     the list of modules loaded by afsd_service.exe and validate
1059     that the version of the AFS DLLs matches the version of the
1060     afsd_service.exe executable.  If they do not match the service
1061     will not start.  
1062
1063   * When Freelance mode is enabled and there is no registry
1064     key HKLM\SOFTWARE\OpenAFS\Client\Freelance, afsd_service.exe
1065     will attempt to import the afs_freelance.ini file contents.
1066     If the file does not exist, it was creating a dummy file
1067     with a r/o and r/w entry for the default cell and then
1068     importing those values.
1069
1070     This process has been changed.  The temporary file is no
1071     longer created.   Also, both the OpenAFS Client install
1072     directory as well as %WINDIR% are checked for previous
1073     afs_freelance.ini files.
1074
1075   * Added support for VL_GetEntryByNameN().  Still need to add
1076     support for VL_GetEntryByNameU() for multi-homed support.
1077
1078   * Fix a deadlock situation in afscreds.exe when canceling an
1079     auto-generated Obtain Tokens dialog
1080
1081 Since 1.3.72/73:
1082   * Fix the locking of objects during Directory Searches in the
1083     SMB/CIFS server.  The failure to properly lock the reference 
1084     counts was resulting in the premature freeing of smb_dirSearch_t 
1085     objects while they were still in use by the SMB/CIFS client.
1086     This does not solve the "Invalid Handle" problem.
1087
1088   * Fix Find Cell By Name pioctl call to return a valid cell
1089     name for the Freelance fake root.afs volume.  
1090     "Freelance.Local.Root".
1091
1092   * Fix the Explorer Shell Extension Symlinks->Add operation.
1093     The dialog template was missing and the link destination
1094     string was too short.
1095
1096   * Add support for symlinks to Freelance root.afs volume
1097     Stored at HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks
1098        <number>  =  "<linkname>:<relative-path>."
1099     Use symlink.exe to create, list, or remove
1100
1101   * Remove the fallback to the use of KFW's KRB4 library when obtaining
1102     tokens.  We never obtain KRB4 tickets.
1103
1104   * Fix AFS Client Configuration Control Panel to support new SysName
1105     protocol.
1106
1107   * Fix a bug in afsd_service.exe which could result in the SysName
1108     not being read from the registry.
1109
1110 Since 1.3.71:
1111   * Add code to block the issuance of AFS tokens by aklog.exe or
1112     afscreds.exe when the Kerberos 5 principal name contains a dot.
1113
1114   * Modify the IsAdmin() function to always treat the local SYSTEM
1115     account as an AFS client administrator.  Affects fs.exe and 
1116     afs_config.exe.
1117
1118   * Modify the internal handling of Quota Exceeded errors
1119
1120   * Upgrade all reference count fields in the Windows cache manager
1121     and the osi library to use unsigned long instead of signed short.
1122     A similar fix has been applied to the afs rpc (rx) library.
1123
1124   * fix the Windows cache manager to prevent it from replacing the 
1125     rx_connection object associated with the cm_conn_t object on each
1126     and every operation if "fs crypt" was set.  This explains the 
1127     dramatic performance difference when crypt is used vs clear.
1128     The problem: 'cryptall', a boolean flag indicating whether or not 
1129     "fs crypt" is set, was being compared to the rx_connection 
1130     cryptlevel which is either rxkad_clear:0 or rxkad_crypt:2.
1131     1 != 2 and therefore the rx_connection was always destroyed 
1132     and replaced on each and every operation.
1133
1134     Lock the cm_conn_t object around every call to RXAFS_xxxx functions.
1135     It is not safe for the cm_conn_t object to not be locked because
1136     rx_DestroyConnection might be called from another thread if:
1137         - the user's tokens have changed or expired
1138         - the crypt mode has changed
1139
1140     This fix appears to have also taken care of the problems associated
1141     with Overlapped Writes resulting in Delayed Write errors.
1142
1143   * fix NSIS installer's AdminGroup.exe to properly create and
1144     remove groups when given -create or -remove.  The string comparison
1145     test was wrong.
1146
1147   * fs sysname now accepts a list of sysname values 
1148
1149   * added a new registry value HKLM\SOFTWARE\OpenAFS\Client "IoctlDebug"
1150     DWORD which when set to a non-zero value will cause error message
1151     text to be output to stderr from the pioctl() routine.  Useful in 
1152     debugging failures of fs.exe, tokens.exe, etc.
1153
1154   * added a test to the power management code to only perform a 
1155     flush operation if there is at least one network adapter which
1156     is not a loopback adapter.
1157
1158   * Fix bug in loading of registry value HKLM\SOFTWARE\OpenAFS\Client
1159     "EnableKFW".  This value will not be read if the key
1160     HKCU\SOFTWARE\OpenAFS\Client exists; even if the "EnableKFW" 
1161     value under that key does not.
1162
1163   * provide mechanisms to force the use of krb524d for Kerberos 5
1164     ticket to AFS token conversion.  For afslogon.dll and afscreds.exe
1165     there is a new registry value "Use524" and for aklog.exe a new
1166     command line parameter "-m".
1167
1168   * Fix the pattern matching algorithm to properly match patterns
1169     ending with a '*'.
1170
1171   * smb_ReceiveCoreRename() was factored to produce smb_Rename()
1172     which is used by both the original function and the new
1173     smb_ReceiveNTRename().  smb_ReceiveNTRename() supports the
1174     creation of HardLinks in addition to Renaming.  smb_Link() 
1175     is a new function which creates HardLinks via cm_Link().
1176     cm_Link() is a new vnodeops function which creates links
1177     using RXAFS_Link().
1178
1179     smb_ReceiveNTRename() does not support the File Copy and 
1180     Move Cluster Information operations described in its interface.
1181     ReceiveNTRename is under documented in CIFS-TR-1p00_FINAL.pdf.
1182
1183   * When opening files via symlinks, we should follow the symlinks
1184     until we reach the actual file stat cache entry.  The stat cache
1185     entry of the file should then be stored in the FID instead of
1186     stat scache entry of the symlink.
1187
1188   * return bad operation errors for all unimplemented functions
1189     even if we do not know the functions exist.
1190
1191   * Log bad packets and unknown operation packets to the trace log
1192
1193   * Map CM_ERROR_BADOP to STATUS_NOT_SUPPORTED instead of 
1194     0xC09820FF
1195   
1196   * Update list of known CIFS operations to include all those listed
1197     in CIFS-TR-1p00_FINAL.pdf.
1198
1199   * Modify the handling of HKLM\SOFTWARE\OpenAFS\Client\Submounts
1200     to support the REG_EXPAND_SZ type.
1201
1202 Since 1.3.70:
1203   * A new Windows authorization group "AFS Client Admins" is now 
1204     created and populated with the members of the "Administrators"
1205     group.  The group is used to determine which accounts on the
1206     machine may be used to modify the AFS Client Configuration via
1207     the UI and command line tools.  afs_config.exe, fs.exe, 
1208
1209   * Modify the WinLogon Logoff Event Handler to query NT4 domain
1210     controllers for the remote profile path if Active Directory
1211     services are not available.
1212
1213   * Fix aklog.exe to not add the AFS ID to the username
1214
1215   * PTS registration of new users to foreign cells has been added to 
1216      afscreds.exe
1217
1218   * The cm_Daemon thread is used to perform checks for 
1219     down servers, up servers, volumes, callback expirations, 
1220     lock maintenance and token expiration.  Due to a gaff in
1221     larger integer division the thread never performed any 
1222     work.  Instead the current time computation would always
1223     be less then the trigger times.  This had an adverse affect
1224     on the client's ability to maintain communication with servers,
1225     keep volumes up to date, and flush user tokens and acls
1226     when they have expired. This was broken when the 1.3 branch
1227     was modified to support VC7 which no longer included 
1228     largeint.lib
1229
1230   * An initialization problem with the Freelance code was 
1231     detected while fixing the callbackRequest.  The cm_rootSCachep
1232     object is obtained during afsd_InitDaemons() but the callback 
1233     information is incomplete.  The callback information will not
1234     be obtained until cm_MergeStatus is called from within
1235     cm_GetCallback.  Unfortunately, cm_SyncOp did not properly 
1236     test for the conditions under which the callback information
1237     must be obtained.  
1238
1239   * Reports have been filed indicating that callbacks were
1240     being lost.  An examination of the code indicated that the
1241     cm_server_t objects were not being properly reference
1242     counted by the cm_scache_t and cm_callbackRequest_t objects.
1243     In particular, the cm_server_t objects may have been freed
1244     from beneath the cm_conn_t objects.
1245
1246     All of the reference counting is now done via the functions:
1247         cm_GetServer
1248         cm_GetServerNoLock
1249         cm_PutServer
1250         cm_PutServerNoLock
1251     this improves the ability to track the referrals.  
1252
1253     Each cm_BeginCallbackGranting Call now allocates a reference
1254     to the cm_server_t.  The cm_EndCallbackGrantingCall either
1255     frees the reference or transfers it to the cm_scache_t
1256     cbServerp field.  These are then appropriately tracked
1257     through the cm_Analyze call.
1258
1259   * Ensure that the dnlc hash table is the same size as the
1260     dir name hash table (as per original author's note).
1261     Increase the dnlc CM_AFSNCNAMESIZE to a multiple of 8
1262     for compatibility with 64-bit systems.
1263
1264   * fix smb_ApplyV3DirListPatches to properly apply the hidden
1265      attribute to dotfiles when the infoLevel < 0x101 and 
1266      cm_SyncOp has failed.
1267
1268   * Fix the Freelance registry initialization code.  There
1269     was a possibility that some systems could end up with 
1270     garbage in the registry during a clean install.
1271
1272 Since 1.3.66:
1273    * file and directory names beginning with "." will now be given the
1274      hidden attribute when the volume access is anonymous.  this matches
1275      the behavior when the volume access is via an authenticated user.
1276
1277    * Added a change monitor to the HKLM\SOFTWARE\OpenAFS\Client\Freelance
1278      key.  When a change occurs mark the root.afs data as invalid and
1279      for it to be reloaded on the next access.  This allows administrators
1280      to modify the mount point list without restarting the service.
1281      
1282      The freelance client used to provide a fake modification time for
1283      the root.afs volume data and its mount points of 7/09/2001 14:24 EDT.
1284      Added code to extract the last modification time of the Freelance
1285      registry key and use that instead.  The time now represents the 
1286      most recent mount point change.
1287
1288    * PTS registration of new users to foreign cells has been added to 
1289      aklog.exe
1290
1291    * Additional Cache Control and Credential Manager options have been
1292      added to the WiX installer.  See deployment guide for details.
1293
1294    * The CachePath setting is now optionally a REG_EXPAND_SZ type
1295   
1296    * The WiX installer has been upgraded.  Version 2.0.1927.1 is now 
1297      required.
1298
1299    * The loopback installation code may have had a problem updating the
1300      %ETC%\HOSTS file which could have resulted in a premature failure.
1301      Work around code has been added for the case where the file cannot
1302      be deleted.
1303
1304    * The default max chunksize was increased from 15 (32K) to 17 (128K)
1305      because Windows sends 64K blocks when using overlapped writes.
1306
1307    * The default number of server threads was increased from 4 to 25 to
1308      better handle overlapped writes.  
1309
1310    * The "AfscredsShortcutParams" registry value was not being properly
1311      loaded by afscreds.exe.  Therefore, the default value was always being
1312      used instead of the value set by the installer.
1313
1314    * Windows XP provides downgrade attack detection to prevent an attacker
1315      from being able to force the use of NTLM simply by disrupting 
1316      communication with the KDC.  This attack cannot exist between the 
1317      Windows CIFS client and the AFS Client Service.  Therefore, when a
1318      downgrade has been detected the afs pioctl library will force the 
1319      establishment of a new CIFS connection using NTLM.
1320  
1321    * A locking error was discovered surrounding all references to volume
1322      server lists within the cm_cell.c source file. 
1323
1324    * The logged into Windows username was incorrect on Terminal Server
1325      machines.
1326
1327    * A new registry value "NonPersistentCaching" was added to the service
1328      parameters key.  When set to a non-zero value, the afs cache is stored
1329      in the Windows paging file.  There are two limitations to choosing
1330      this option: 
1331         1. when persistent caching is implemented it won't work with 
1332            this flag set since there will be nothing to persist.
1333         2. with this flag set the initial paging allocation cannot be
1334            changed while the service is running
1335
1336    * An initialization bug was discovered in aklog.exe which affected users
1337      who have a domain name for their afs servers which could not be mapped
1338      to a realm
1339
1340 Since 1.3.65:
1341    * afs_config.exe now validates cell names against DNS in addition
1342      to the CellServDB file.
1343
1344    * In order to allow the freelance client to connect to a volume with ID 
1345      equal to 1 on the default cell we changed the fake root.afs volume ID
1346      once again.  This time we choose 0xFFFFFFFF.  In addition, we change
1347      the cell ID of the fake root.afs volume from 1 to 0xFFFFFFFF as well.
1348      It will now be impossible for a volume ID to match that of another 
1349      cell unless the client is connected to 0xFFFFFFFD cells.  That should
1350      be enough room for growth.
1351
1352    * Fix "fs mkmount" command to work with UNC paths and when
1353      started from non-AFS drives.  It is now possible to create a mount
1354      point in the freelance fake root.afs volume with the command
1355
1356         fs mkmount \\AFS\all\<directory-name> <volume-name> <cellname>
1357
1358      For example,
1359         
1360         fs mkmount \\AFS\all\openafs.org root.cell openafs.org
1361         fs mkmount \\AFS\all\.openafs.org root.cell openafs.org -rw
1362
1363    * The algorithm used to re-attempt access to the servers associated with
1364      a volume has been altered to properly address the case in which all 
1365      servers have been marked down.  The previous algorithm did not reset
1366      the server's down flags so the servers were never actually retried.
1367      This caused a problem with active volumes if the network connectivity
1368      was lost as could be the case with a network cable removal, wireless
1369      drop, or laptop hibernation.  With the fix volume access is restored
1370      almost instantenously when network connectivity becomes available.
1371
1372    * Support for SMB/CIFS browsing has been added to the AFS Client Service
1373      SMB server.  It is now possible to use "NET VIEW \\AFS" to obtain a
1374      listing of AFS submounts and freelance mount points.  Support for
1375      NETSHAREENUM, NETSHAREGETINFO, NETSERVERENUM2, NETSERVERGETINFO
1376      significantly enhances the behavior of AFS volumes within the Explorer
1377      Shell.  For instance, "AFS" now shows up as server in the Explorer
1378      with each submount or freelance mount point visible as a share.
1379      The right click menu in each folder now works with full functionality
1380      on a consistent basis.
1381
1382    * The network provider can be configured to have different behavior
1383      depending on the domain that the user logs into.  These settings are
1384      only relevant when using integrated login.  A domain refers to an
1385      Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
1386      local machine (i.e. local account logins).  The domain name that is
1387      used for selecting the domain would be the domain that is passed into
1388      the NPLogonNotify function of the network provider. (see registry.txt
1389      for details)
1390
1391    * Added a new registry value [HKCU\SOFTWARE\OpenAFS\Client] 
1392      "Authentication Cell" which may be used to specify a default 
1393      authentication cell for afscreds.exe which is different from
1394      the default cell for the AFS Client Service daemon.
1395
1396    * Added a Logoff WinLogon Event Notification function to afslogon.dll.
1397      afslogon.dll moved to %WINDIR%\System32\.
1398      New registry entries added to register the dll for Winlogon events.
1399
1400      The logoff event will now force a call to ktc_ForgetAllTokens()
1401      using the context of the user being logged off as long as the 
1402      user's profile is not loaded from within AFS.  If the profile 
1403      was loaded from AFS we can't release the tokens since the Logoff
1404      event is triggered prior to the profile being written back to 
1405      the its source location.  This is now performed in an XP SP2 
1406      safe manner.
1407
1408    * Windows XP SP2 Internet Connection Firewall interoperability
1409      has been added.
1410
1411    * The %WINDIR%\afsdsbmt.ini contains four sections:
1412         Submounts, Drive Mappings, Active Maps and CSC Policies.
1413      The Submounts and CSC policies are now stored in the registry under
1414         [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
1415         [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
1416      The Drive Mappings and Active Maps are stored in the registry under
1417         [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
1418         [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
1419
1420      There is no automatic migration of this data as it would be impossible
1421      to consistently migrate data to user profiles which may not be active
1422      when the machine is updated.
1423
1424    * The %WINDIR%\afs_freelance.ini contains lists of mountpoints for the
1425      fake root.afs volume.  For the same reasons as for the cellservdb file,
1426      this information should not be in %WINDIR%.  This information is now
1427      kept under the registry key
1428         [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
1429
1430      The data from the afs_freelance.ini file will be automatically 
1431      migrated to the registry on first execution of afsd_service.exe
1432
1433    * Keeping the CellServDB file in the location %WINDIR%\afsdcell.ini is 
1434      troublesome for several reasons.  One, it is confusing for those who
1435      expect the file to be named "CellServDB" instead of "afsdcell.ini".
1436      Two, this file is not a Windows Profile formatted file.  Three, 
1437      applications should not be reading or writing to %WINDIR%.  It causes
1438      problems for Windows Terminal Server.
1439
1440      The new location of CellServDB will be the OpenAFS Client install 
1441      directory which is by default C:\Program Files\OpenAFS\Client and can
1442      be determined by querying the registry for 
1443      [HKLM\SOFTWARE\TransarcCorporation\AFS Client\CurrentVersion]PathName
1444
1445      The existing afsdcell.ini will be migrated by the NSIS installer. 
1446      The Wix installer must still be updated to do the same.
1447
1448    * Change NSIS installer to use DNS by default; to remove Integrated Logon
1449      High Security mode; and to add Terminal Services compatibility registry
1450      entries to allow the OpenAFS tools to find the afsdcell.ini and other
1451      configuration files in %WINDIR%.
1452   
1453    * Add support for authenticated SMB connections.   This will remove
1454      the need for high security mode in most situations.  Both NTLM
1455      and Extended Security (GSS SPNEGO) modes are supported.  Effectively,
1456      only NTLM can be used even though Kerberos is now supported.  The
1457      reason is that it is not possible to construct a service principal
1458      which is unique to each individual machine.
1459
1460      SMB Extended Auth does not work on XP SP2 unless one of two registry
1461      modifications are made:
1462
1463      (1) To disable the check for matching host names on loopback connections
1464         set this key.  This does not require a reboot:
1465
1466         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa]
1467             "DisableLoopbackCheck"=dword:00000001
1468
1469      (2) To add the AFS SMB/CIFS service name to an approved list.  This
1470         does require a reboot:
1471
1472         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0]
1473             "BackConnectionHostNames"=multi-sz "AFS" "MACHINE-AFS"
1474
1475      afsd_service.exe will automatically add the current Netbios Name
1476      to the BackConnectionHostNames list and then temporarily disable
1477      the loopback check for one cycle of startup/shutdown of the service.
1478      We assume most folks do not start/stop without a reboot so this 
1479      will be adequate in most cases.
1480
1481    * Fix security hole in afslogon.dll which allowed passwords to be
1482      sent in clear text to the KDC in a misformed principal name.
1483
1484    * Fix cm_GetCell() to properly handle expired dns entries
1485      without crashing
1486
1487    * If Freelance mode is active and the afs_freelance.ini
1488      file does not exist, do not create an empty file.
1489      Instead create a file containing ro and rw mountpoints
1490      to the default cell using the standard conventions.
1491
1492    * Modify the Freelance support to handle the ability
1493      to create rw mount points in the fake root.afs volume.
1494
1495    * Changed the RPC mechanism used for token setting from 
1496      named pipes to local.  Use of named pipes can be restored
1497      by setting the environment variable AFS_RPC_PROTSEQ to
1498      "ncacn_np". 
1499
1500      Named pipes were required when a Windows 9x system was
1501      using a NT system in gateway mode which is incompatible
1502      with our use of local loopback adapters.
1503
1504    * In afscreds.exe, if a username of the form user@REALM is
1505      specified and no password is specified, do not perform a 
1506      kinit operation.  Only perform the aklog functionality.
1507
1508    * Add a new registry value which allows the number of processors
1509      on which afsd_service.exe executes to be restricted.  Valid
1510      values are 1..numOfProcessors
1511
1512        HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
1513           (DWORD) MaxCPUs 
1514
1515 Since 1.3.64:
1516    * A second MSI based installer option is now available.
1517
1518    * Fixed Kerberos 5 kinit functionality in afscreds.exe to properly
1519      request tickets for user/instance@REALM instead of just user@REALM
1520
1521    * Modify the Power Management Notify routine to wait for the Hard Dead
1522      timeout period instead of a fixed 19 seconds.  With the longer timeout
1523      periods Hibernation and Standby could never succeed when network 
1524      connectivity is not available.
1525
1526    * The following fs.exe commands are now restricted to Administrator:
1527      - checkservers with a non-zero timer value
1528      - setcachesize
1529      - newcell
1530      - sysname with a new sysname list
1531      - exportafs 
1532      - setcell
1533      - setserverprefs
1534      - storebehind
1535      - setcrypt
1536      - cscpolicy
1537      - trace
1538
1539      setting the default sysname for a machine should be done via the
1540      registry and not via "fs sysname".
1541
1542    * NSIS installer adds options to install Debugging Symbols
1543      and the Microsoft Loopback Adapter; the user is now also
1544      given the ability to select the afscreds.exe startup options.
1545
1546    * Build system modified to generate symbols for FREE (aka RELEASE)
1547      builds as well as CHECKED (aka DEBUG) builds
1548
1549    * Sites which have a volume ID of 0x20000001 assigned to their
1550      root.cell volumes have been experiencing problems with accessing
1551      the root.cell volume of their cell when Freelance mode has been
1552      active.  This was because 0x20000001 was assigned to the fake
1553      root.afs volume created by freelance.  The fake volume id is
1554      now set to 0x00000001 to prevent conflicts.
1555
1556    * The timeout logic in the AFS Client Service has been wrong
1557      for sometime.  It is based on two different assumptions.
1558      First, the SMB client timeout is a fix value as was the case
1559      with OS/2 Lan Manager.  This assumption is incorrect.  The
1560      SMB timeout in Windows is a dynamic value computed based upon
1561      a fixed minimum timeout to which is added time based upon the
1562      size of the request and the performance characteristics of
1563      the connection.  Second, it is the responsibility of the 
1564      SMB Server to enforce the timeout requirements of the client.
1565      This is untrue.  The SMB Server cannot be expected to know
1566      the requirements of the client.  More importantly, if the 
1567      SMB server uses the SMB client timeout as a value to restrict
1568      its behavior as an RX client, the performance characteristics
1569      of the local SMB session would be used to prematurely terminate
1570      WAN connections with significantly different performance 
1571      characteristics.
1572
1573      The timeout logic has therefore been modified in the following
1574      manner:
1575       . the Lan Manager Workstation (SMB) Session Timeout is used only
1576         as a basis for configuring the Connection Dead Timeout 
1577         and Hard Dead Timeout values.  The Connection Dead Timeout
1578         must be at least 15 seconds longer than the SMB Timeout
1579         and the Hard Dead Timeout must be at least double the 
1580         Connection Dead Timeout.
1581       . New registry entries have been added to allow the Connection
1582         Dead Timeout and Hard Dead Timeout values independent of the
1583         Lan Manager Workstation Session Timeout
1584       . The test to enforce the SMB Client Timeout has been removed.
1585         
1586      One of the side-effects of removing the enforcement of the SMB 
1587      Client Timeout is that regardless of whether or not the SMB client
1588      is available to receive the response (and how would the SMB server
1589      know) the RX protocol response can be used to update the AFS 
1590      Client Service state for ready access by future SMB client 
1591      requests.
1592
1593      This should be the end of the "Server paused or restarting messages"
1594    
1595    * Add support for arbitrary UNC paths to the pioctl() support.
1596      This enables the fs commands as well as the AFS Shell Extension
1597      to work correctly when UNC paths are being used.
1598
1599    * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
1600      DNS if the cell configuration cannot be determined via CellServDB
1601
1602    * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
1603      are ever set more than once at a time
1604  
1605    * Fix the management of lists of cm_cell_t structures when using 
1606      DNS to lookup cell information.  The previous code would fail to
1607      reuse the same cellID for a cell if DNS was used more than once
1608      for a given cell name.  When the ttl expired, a single cm_cell_t
1609      could be inserted into the cm_allCellsp list more than once 
1610      producing a loop.  In addition, the vlServerp list belonging to
1611      the cell was not freed resulting in improper refCounting of the
1612      servers.
1613
1614    * Add DNS support to cm_IoctlNewCell() which previous only examined
1615      the CellServDB file
1616
1617    * Add cm_FreeServer() function and call it from cm_FreeServerList()
1618      to properly garbage collect cm_server_t objects 
1619      
1620    * Add numVCs variable to smb.c to track the number of smb_vc_t 
1621      objects created and use it to initialize the vcID field which 
1622      previously was set to 0 in all objects resulting in FindByID 
1623      collisions.
1624
1625    * Fixed DNS lookups to work consistently throughout the OpenAFS
1626      product instead of just from within the afsd_service.exe
1627
1628    * Added a runtime check to ensure that AFS Client Service SMB
1629      Server is accepting connections before attempting to mount
1630      global drives.
1631
1632    * Read IP addresses for volume servers out of the CellServDB
1633      file if gethostbyname() on the hostname fails.
1634
1635    * Fix getcellconfig() to populate both the Hostnames as well
1636      as IP addresses when loading cell data via DNS
1637
1638    * Increase the Connection Dead Time to 50 from 20 seconds
1639      Increase the Hard Dead Time to 120 from 40 seconds
1640      (matches the Unix values)
1641
1642    * Fixed an assertion validating the number of allocated NCBs
1643
1644    * Fixed the build environment to consistently build for 
1645      Windows 2000 and above.  (APPVER = 5.0)
1646
1647    * Fixed rx_debug to properly validate the receipt in incoming
1648      data with select() and recvfrom().  Do not copy data out of
1649      the socket buffer unless success is indicated.
1650
1651 Since 1.3.63:
1652    * afsd_service.exe will now display a message box to the 
1653      desktop when it terminates due to an IP Address Change.
1654   
1655    * installer no longer deletes AFS Server configuration data
1656      on uninstall
1657
1658    * installer generates a warning dialog if the RPC service 
1659      is not properly configured
1660
1661    * installer compressed with lzma instead of bzip2
1662
1663    * afsd_service.exe shutdown crash solved once and for all
1664  
1665    * reference counting of smb_vc_t data structures improved
1666  
1667    * name space collision of smb_fid_t event objects corrected
1668
1669    * the output of "fs memdump" is now written to 
1670      %WINDIR%\TEMP\afsd_alloc.log
1671
1672    * the file TaAfsApp_1033.dll is now properly installed allowing
1673      the User Manager to start
1674   
1675    * a new algorithm is used for computing filename pattern matches
1676
1677    * afscreds.exe now accepts user names containing instance
1678      fields.
1679
1680    * Fix the Directory Name Lookup Cache to be case-sensitive.
1681      This is crucial in environments in which a Windows client
1682      is accessing a directory with more than one filename that
1683      differs only by case.  If the directory contains "FOO" 
1684      and "Foo".  You want "DEL Foo" to delete the correct one.
1685      We still have a problem in that "DEL foo" will delete a
1686      random filename.  This will be addressed in a future release.
1687
1688    * Fix afscreds.exe -M option (renewMaps) to work when High
1689      Security mode is off.  Also, remember to disable the ActiveMap
1690      flag in afsdsbmt.ini when a drive mapping is removed.
1691
1692    * Updates to NSIS installer script.  AFS Server configuration
1693      data will not be destroyed on un-install or re-install.  
1694      Use a better compression algorithm.
1695    
1696    * afslogon.dll now uses KFW to obtain tokens when available
1697    
1698    * afslogon.dll when given an all uppercase username will
1699      attempt to authenticate with both the uppercase name
1700      and an all lowercase variation
1701
1702    * DST modification removed.  The fix appears to make things
1703      worse after a reboot of the machine.
1704
1705    * fs.exe:  added "cscpolicy" which is used to 
1706      change client side caching policy for AFS shares
1707
1708      Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs] 
1709                          [-documents] [-disable] [-help]
1710
1711    * Several uninitialized variables have been initialized
1712
1713    * It is now possible to obtain tokens using cross realm
1714      Kerberos within afscreds.exe:
1715         cell:      dementia.org
1716         user:      jaltman@ATHENA.MIT.EDU
1717         password:  xxxxxxxx
1718      Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
1719      will will in turn be used to obtain afs@DEMENTIA.ORG.
1720      The resulting token will be stored with the display name 
1721        jaltman@ATHENA.MIT.EDU@dementia.org
1722
1723    * aklog.exe has been added to the client
1724
1725      Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]] 
1726                   [[-p | -path] pathname]
1727                   [-noprdb] [-force]
1728                   [-5 | -4]
1729
1730         -d gives debugging information.
1731         krb_realm is the kerberos realm of a cell.
1732         pathname is the name of a directory to which you wish to authenticate.
1733         -noprdb means don't try to determine AFS ID.
1734         -5 or -4 selects whether to use Kerberos V or Kerberos IV.
1735            (default is Kerberos V)
1736         No commandline arguments means authenticate to the local cell.
1737
1738 Since 1.3.62:
1739    * All of the resource files have been restructured to adhere to
1740      a set of rules IBM implemented for loading string resources.
1741      These rules had either been forgotten or were not discovered
1742      by folks working on the OpenAFS sources.  The end result was
1743      memory corruption.  This is primary item which was preventing
1744      the AFS Server from working.
1745
1746    * Increased the size of the maximum ticket size stored in a token
1747      from 344 bytes to 12,000.  Increased the buffers used to convey
1748      messages between the pioctl() caller and the SMB Server from
1749      1000 bytes to 12,512.  The code appeared to have been writing
1750      above the top of the stack by quite a few number of bytes.
1751      (The increased ticket size is necessary for the next item.)
1752
1753    * When obtaining AFS Tokens via KFW, krb524 is no longer required.
1754      Instead the raw Kerberos 5 ticket is used in its entirety.  This
1755      is extremely important as it allows us to use pure Kerberos 5 KDCs
1756      as the source of the AFS authentication.  The use of up to 12,000 byte
1757      tickets will allow tickets produced by all versions of Microsoft
1758      Active Directory to be used.
1759       - create a user account.       
1760       - designate it DES only
1761       - disable pre-auth
1762       - specify its UPN to be  "afs@realm"
1763       - assign a SPN of "afs/cellname" to the UPN with setspn.exe
1764
1765    * Do not enforce the funky 8dot3 pattern matching rule that the first "."
1766      is special when using long file names.  (you must use "*.*" and not "*")
1767      Instead only enforce it when performing 8dot3 searches. 
1768
1769    * Fixed the DST problem with creation times being set one hour ahead
1770
1771    * Fixed the problem when using \\afs\cell-alias.  For example, 
1772      \\afs\uncc instead of \\afs\uncc.edu.  Do not a new cell struct
1773      for the alias name; instead simply expand the name.  One of the
1774      symptoms of this problem was a loss of acquired tokens.
1775
1776    * Fixed the AFS Shell Extension.  The Symbolic Link menu was empty 
1777      of strings.  (Only English strings provided.)
1778
1779    * Fixed the installer to properly replace in use files.  
1780
1781    * Fixed the build system to cleanup generated component version files
1782
1783    * The release build compiled with MSVC 6.0 compiler to avoid the 
1784      afsd_service.exe shutdown crash.  This does not solve the problem
1785      but simply avoids it for the time being.
1786
1787 Since 1.3.61:
1788
1789  * fix afslogon.dll to not corrupt memory when High Security mode
1790    is not used.  
1791
1792  * fix afsd_service.exe to not attempt to restore the stack when
1793    an exception occurs.  (not safe in multi-threaded programs)
1794
1795  * fix uninstaller to properly remove the CRT and MFC DLLs
1796  
1797  * remove a Message Box from afscreds.exe when getcellconfig()
1798    fails on a kerberos realm which is not a cell
1799
1800 The following is a list of changes to the OpenAFS for Window client
1801 since 1.3.60.
1802
1803  * "fs setserverprefs" will leave afsd service deadlocked
1804
1805  * "vos listaddrs" will core dump
1806
1807  * installer sets the appropriate keys to support Integrated Logon
1808
1809  * installer disables the "Find Lana by Name" functionality as it
1810    was causing headaches for many users
1811
1812  * fix the intermittent crash of the power management thread when
1813    shutting down the AFS Client Service
1814
1815  * optimizes the obtain drive mount list functionality which is 
1816    executed every time the mount tab in afscreds.exe and afs_config.exe
1817    are refreshed.  (this happens a lot)
1818
1819  * fix the service shutdown logic.  add the STOP_PENDING state
1820    and do not accept additional service events after we declare
1821    ourselves STOPPED.
1822
1823 The following is a list of changes to the OpenAFS for Window client
1824 since 1.2.10.
1825
1826 * flexelint was run against the source tree and hundreds (perhaps 
1827   thousands) of corrections were applied to ensure prototypes 
1828   were in use; types were used consistently; variables were 
1829   initialized; unused variables were removed; etc.
1830
1831 * A wide variety of instrumentation was added including the 
1832   ability to produce a stack trace from within afsd_service.exe
1833   when it crashes.
1834
1835 * Dynamic configuration of the RDRtimeout value based upon the
1836   LanMan Workstation Session Timeout
1837
1838 * The mount root no longer needs to be called "/afs".  This 
1839   is now set by a registry value "MountRoot" within the key
1840   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
1841
1842 * The cell list is now only read out of afsdcell.ini when the
1843   file changes instead of each time a cell is resolved.
1844
1845 * Thread synchronization was added to cm_server.c and ktc_nt.c
1846
1847 * All calls to GlobalAlloc()/GlobalFree() were replaced with 
1848   calloc()/free().  The Global functions were needed on Windows 3.x
1849   but have caused a variety of problems on the Win32 platforms.
1850   Avoiding them is highly recommended by several Microsoft 
1851   Knowledgebase articles
1852
1853 * Support for Symbolic Links added to the AFS Shell Extension
1854
1855 * Added a registry value "OverlayEnabled" to determine if
1856   Shell Extension Overlays should be enabled.  
1857   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
1858
1859 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
1860   separate trees for checked and free builds.  Build system supports
1861   a custom directory src\WINNT\extra which can be used as a grafting
1862   location of organization specific additions to the build tree.
1863
1864 * New installer built using NSIS 2.0.  
1865
1866 * Named all kernel objects in order to allow them to be monitored
1867   with tools such as SysInternals' ProcExp.exe.
1868   
1869 * Introduced new EventLog framework for AFSD
1870
1871 * Introduced Power Management interface to AFSD for Standby and 
1872   Hibernate modes to allow cache to be flushed prior to network
1873   disconnect
1874
1875 * Utilize Win32 DNSQuery API instead of internal routines.  This 
1876   allows DNS SRV queries to be sent to all current domain name 
1877   servers.  Not just one specified in an INI file.  DNS is now
1878   always activated.
1879
1880 * "NetbiosName" registry value may be used to specify a fixed
1881   Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
1882   when the loopback adapter is in use.  If you need to use the 
1883   old notation with a loopback adapter installed specify a registry
1884   entry of 
1885
1886      "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
1887
1888 * Refactor all modules which depend on LAN Adapter and NetbiosName
1889   determination in a new library: lanahelper.lib.  This allows for
1890   consistent behavior throughout the product.
1891
1892 * Move the afsd.log and afsd_init.log files to the directory specified
1893   by the "TEMP" environment variable.  This is usually %WINDIR%\TEMP
1894   for services.  Added the Date to the log entries.
1895
1896 * New registry value "RxMaxMTU" used to limit the size of the RX 
1897   packets sent by the AFS Client Service to the Server.  In order
1898   to enable OpenAFS to work across the Cisco IPSec VPN the packet
1899   size must be restricted to 1264 or smaller.  The latest NSIS
1900   installer sets a value of 1260 by default.
1901
1902 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
1903   packets.  This is not needed in order to work across the Cisco
1904   VPN but might be needed for other network environments.  This
1905   value is not set by the NSIS installer.
1906
1907 * New registry value "HideDotFiles" is used to apply the Hidden
1908   attribute to files whose names begin with a '.'.   This value
1909   is set by the NSIS installer.
1910
1911 * New registry value "MaxMpxRequests" allows the maximum number
1912   of multiplexed sessions to be configured at run time.  This
1913   value is not set by the NSIS installer.  The default value is
1914   50.
1915
1916 * New registry value "MaxVCPerServer" allows the maxmimum number
1917   of VCs per server to be configured at run time.  This value is
1918   not set by the NSIS installer.  The default value is 100.
1919
1920 * New registry value "AllSubmount" allows the "all" submount to
1921   be disabled by setting its value to 0x00.
1922
1923 * Allow cells names to be valid mount points 
1924     \\<netbiosName>\<cellname>
1925
1926 * Store the active state of drive mappings in order for afscreds.exe
1927   to restore them upon startup
1928
1929 * Add exception handling to generate a Stack Trace to the afsd_init.log
1930   file if one happens to occur.
1931
1932 * Add lots of logging to help detect the cause of invalid SMB packets
1933
1934 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
1935   conversion of Kerberos 5 "afs" service tickets.  Supports auto-
1936   renewal of expiring tokens as long as afscreds.exe is running.
1937
1938 * New afscreds.exe command line options:
1939     -A = autoinit
1940     -M = renew drive maps
1941     -N = ip address change detection
1942     -Z = unmap drives
1943
1944 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
1945   determines whether or not MIT Kerberos for Windows should be used
1946   to obtain tokens via Kerberos 5 tickets.
1947
1948 * New registry value "AfscredsShortcutParams" in 
1949   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
1950   determines the command line parameters to be specified when "fixing"
1951   the AFS Shortcut in the user's startup folder.
1952
1953 * The "ShowTrayIcon" registry value has been moved from 
1954   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
1955   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
1956   
1957 * The <cell name> registry values used to store the token expiration
1958   reminders have been moved from 
1959   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
1960   {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
1961  
1962 * Obtain the Logon User Name from the Explorer key when available
1963
1964 * new text document doc\txt\winnotes\registry.txt lists all registry
1965   values used by OpenAFS (excluding the AFS Server)
1966
1967 * BUG: rx_securityClass objects were not properly reference 
1968   counted and were never freed.  
1969
1970 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
1971   would be generated.  The existence of a server does not imply
1972   that it is not down.  If all of the servers for a cell are down
1973   return CM_ERROR_NOSUCHVOLUME instead.  This prevents the Explorer
1974   Shell from hanging.
1975
1976 * BUG: the directory name lookup cache failed to free the entries
1977   in the cache when the name cache entries cycled.  The entries
1978   in the cache would become dereferenced without being freed.
1979
1980 * BUG: fs setserverprefs could be executed without Administrator
1981   privileges
1982
1983 * BUG: the number of allocated NCB objects (100) exceeded the number
1984   which could actually be waited upon by the kernel (64).  Any objects
1985   which were utilized above the limit could never have event completions
1986   detected.
1987
1988 * BUG: smb_username_t objects were not being reference counted and 
1989   were not properly freed.
1990
1991 * BUG: smb_tid_t objects could under unusual circumstances be freed
1992   before they were no longer referenced.
1993
1994 * BUG: smb_fid_t object pointer were frequently used even when 
1995   their value could be NULL.   They were not properly released and
1996   therefore they were never freed.
1997
1998 * BUG: smb_packet_t data structures were not completely initialized
1999   upon creation
2000
2001 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
2002   Denied" because that causes the Explorer Shell to try again until
2003   access is obtained.  Instead return "Remote Resources" which allows 
2004   the shell to move on and treat the error as transient.
2005
2006 * BUG: when initializing the NCBreturns structure, separate Event objects
2007   were created for each NCB although a single Event object was supposed
2008   to be shared by all.
2009
2010 * BUG: smb_dirSearch_t objects were not being properly referenced counted
2011   or freed.
2012
2013 * BUG: smb_tran2Packet_t objects were not being properly referenced 
2014   counted or freed.
2015
2016 * BUG: directory path creation did not handle the case of multiple
2017   directories requiring creation in one attempt
2018
2019 * BUG: SMB requests which required an Extended Response were ignored.
2020   This prevented some files from being written to AFS volumes.
2021
2022 * BUG: character strings were being freed even after they were 
2023   inserted into in use data structures
2024
2025 * BUG: inconsistent usernames were used when High Security mode was
2026   enabled.  (there is still much to do in this area)
2027
2028 * BUG: pioctl() calls which require out of band RPC operations were
2029   susceptible to race conditions when performed by multiple processes
2030
2031 * BUG: memory allocation and deallocation crossed instances of the
2032   C Runtime Library producing memory leakage and corruption in 
2033   afscreds and the client configurator.
2034
2035
2036