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