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