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