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