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