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