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