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