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