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