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