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