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