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