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