winnotes-20041207
[openafs.git] / doc / txt / winnotes / afs-changes-since-1.2.txt
1 Since 1.3.74:
2   * Added a new registry value, "StoreAnsiFilenames", which can be used
3     to force the use of ANSI character sets instead of OEM Code Pages.
4     This feature is useful when users require the ability to create 
5     filenames with 8-bit characters and need to access the files from
6     both Latin-1 based Unix systems as well as from Windows.
7
8     Activation of this feature will prevent access to files stored with
9     8-bit OEM characters.
10
11   * Shutdown all SMB threads in a synchronized manner when stopping the 
12     service.
13  
14   * There is currently a maximum cache size of 1.3GB.  The limit is imposed
15     by the largest contiguous block of unused memory within the 2GB process
16     space which can be assigned to the memory mapped file.  Unfortunately,
17     when the executable digital signature verification code is activated
18     Windows sees fit to further segment the process memory which in turn
19     reduces the size of the maximum cache file to less then 800MB.  If
20     larger cache sizes are desired, a new registry value should be set:
21
22       HKLM\SOFTWARE\OpenAFS\Client (DWORD) "VerifyServiceSignature" = 0x0
23
24     Setting this value will disable the runtime verification of digital
25     signatures on afsd_service.exe and the afs dlls which it loads.  It
26     will not disable the the version number check on those same files.
27     The signature verification is not a security messure and is only meant
28     to enhance the ability to afsd_service.exe to detect potential
29     destablizing mixtures of DLLs from incompatible distributions.
30
31     Added code to auto-disable the signature verification check if 
32     the desired cache size is greater then 700MB.
33
34   * Windows' WinTrustVerify(WIN_SPUB_ACTION_PUBLISHED_SOFTWARE) is 
35     used to verify the validity of the afsd_service.exe binary 
36     as well as each of the AFS DLLs loaded by the service.  Not only
37     must the digital signature be valid but the signatures of the 
38     DLL must be signed by the same entity as the service.
39
40   * Implement new functions: cm_freelanceMountPointExists and
41     cm_freelanceSymlinkExists.  Use them along with other validity
42     checks in cm_freelanceAddMount and cm_freelanceAddSymlink to
43     ensure that name collisions do not occur and that empty strings
44     are not valid file names.
45
46     A symlink may not have a name which would resolve to a valid 
47     cell name.  Doing so would prevent access to the cell.
48
49   * Add missing cm_HoldSCacheNoLock call to Freelance mount point
50     re-initialization code.  The reference counts of the fake root.afs
51     volume scache object(s) would become invalid when the mount point
52     or symlink lists were altered.
53
54   * Add registry entries to provide mappings from the afsdsbmt.ini
55     to the new locations for applications which count on the use
56     of the old Profile file APIs.  These apps are likely to fail
57     if the user does not have administrator privileges and the 
58     registry is locked down.
59
60   * The afs_config.exe submounts dialog had two errors.  
61     First, attempts to remove entries failed because the registry
62     key was being opened without KEY_WRITE privileges.  
63     Second, when editing a submount entry, changing the name
64     would add a new key and leave the original one in place. 
65     Now the original submount will be removed if its name is 
66     changed.
67
68   * In recent months there have been several incidents in which
69     users have experienced problems starting or accessing 
70     afsd_service.exe and after significant effort has been spent
71     it has turned out that they have two versions of AFS on the
72     machine or an inconsistent set of DLLs.  
73
74     Code has now been added to afsd_service.exe which will walk
75     the list of modules loaded by afsd_service.exe and validate
76     that the version of the AFS DLLs matches the version of the
77     afsd_service.exe executable.  If they do not match the service
78     will not start.  
79
80   * When Freelance mode is enabled and there is no registry
81     key HKLM\SOFTWARE\OpenAFS\Client\Freelance, afsd_service.exe
82     will attempt to import the afs_freelance.ini file contents.
83     If the file does not exist, it was creating a dummy file
84     with a r/o and r/w entry for the default cell and then
85     importing those values.
86
87     This process has been changed.  The temporary file is no
88     longer created.   Also, both the OpenAFS Client install
89     directory as well as %WINDIR% are checked for previous
90     afs_freelance.ini files.
91
92   * Added support for VL_GetEntryByNameN().  Still need to add
93     support for VL_GetEntryByNameU() for multi-homed support.
94
95   * Fix a deadlock situation in afscreds.exe when canceling an
96     auto-generated Obtain Tokens dialog
97
98 Since 1.3.72/73:
99   * Fix the locking of objects during Directory Searches in the
100     SMB/CIFS server.  The failure to properly lock the reference 
101     counts was resulting in the premature freeing of smb_dirSearch_t 
102     objects while they were still in use by the SMB/CIFS client.
103     This does not solve the "Invalid Handle" problem.
104
105   * Fix Find Cell By Name pioctl call to return a valid cell
106     name for the Freelance fake root.afs volume.  
107     "Freelance.Local.Root".
108
109   * Fix the Explorer Shell Extension Symlinks->Add operation.
110     The dialog template was missing and the link destination
111     string was too short.
112
113   * Add support for symlinks to Freelance root.afs volume
114     Stored at HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks
115        <number>  =  "<linkname>:<relative-path>."
116     Use symlink.exe to create, list, or remove
117
118   * Remove the fallback to the use of KFW's KRB4 library when obtaining
119     tokens.  We never obtain KRB4 tickets.
120
121   * Fix AFS Client Configuration Control Panel to support new SysName
122     protocol.
123   * Fix a bug in afsd_service.exe which could result in the SysName
124     not being read from the registry.
125
126 Since 1.3.71:
127   * Add code to block the issuance of AFS tokens by aklog.exe or
128     afscreds.exe when the Kerberos 5 principal name contains a dot.
129
130   * Modify the IsAdmin() function to always treat the local SYSTEM
131     account as an AFS client administrator.  Affects fs.exe and 
132     afs_config.exe.
133
134   * Modify the internal handling of Quota Exceeded errors
135
136   * Upgrade all reference count fields in the Windows cache manager
137     and the osi library to use unsigned long instead of signed short.
138     A similar fix has been applied to the afs rpc (rx) library.
139
140   * fix the Windows cache manager to prevent it from replacing the 
141     rx_connection object associated with the cm_conn_t object on each
142     and every operation if "fs crypt" was set.  This explains the 
143     dramatic performance difference when crypt is used vs clear.
144     The problem: 'cryptall', a boolean flag indicating whether or not 
145     "fs crypt" is set, was being compared to the rx_connection 
146     cryptlevel which is either rxkad_clear:0 or rxkad_crypt:2.
147     1 != 2 and therefore the rx_connection was always destroyed 
148     and replaced on each and every operation.
149
150     Lock the cm_conn_t object around every call to RXAFS_xxxx functions.
151     It is not safe for the cm_conn_t object to not be locked because
152     rx_DestroyConnection might be called from another thread if:
153         - the user's tokens have changed or expired
154         - the crypt mode has changed
155
156     This fix appears to have also taken care of the problems associated
157     with Overlapped Writes resulting in Delayed Write errors.
158
159   * fix NSIS installer's AdminGroup.exe to properly create and
160     remove groups when given -create or -remove.  The string comparison
161     test was wrong.
162
163   * fs sysname now accepts a list of sysname values 
164
165   * added a new registry value HKLM\SOFTWARE\OpenAFS\Client "IoctlDebug"
166     DWORD which when set to a non-zero value will cause error message
167     text to be output to stderr from the pioctl() routine.  Useful in 
168     debugging failures of fs.exe, tokens.exe, etc.
169
170   * added a test to the power management code to only perform a 
171     flush operation if there is at least one network adapter which
172     is not a loopback adapter.
173
174   * Fix bug in loading of registry value HKLM\SOFTWARE\OpenAFS\Client
175     "EnableKFW".  This value will not be read if the key
176     HKCU\SOFTWARE\OpenAFS\Client exists; even if the "EnableKFW" 
177     value under that key does not.
178
179   * provide mechanisms to force the use of krb524d for Kerberos 5
180     ticket to AFS token conversion.  For afslogon.dll and afscreds.exe
181     there is a new registry value "Use524" and for aklog.exe a new
182     command line parameter "-m".
183
184   * Fix the pattern matching algorithm to properly match patterns
185     ending with a '*'.
186
187   * smb_ReceiveCoreRename() was factored to produce smb_Rename()
188     which is used by both the original function and the new
189     smb_ReceiveNTRename().  smb_ReceiveNTRename() supports the
190     creation of HardLinks in addition to Renaming.  smb_Link() 
191     is a new function which creates HardLinks via cm_Link().
192     cm_Link() is a new vnodeops function which creates links
193     using RXAFS_Link().
194
195     smb_ReceiveNTRename() does not support the File Copy and 
196     Move Cluster Information operations described in its interface.
197     ReceiveNTRename is under documented in CIFS-TR-1p00_FINAL.pdf.
198
199   * When opening files via symlinks, we should follow the symlinks
200     until we reach the actual file stat cache entry.  The stat cache
201     entry of the file should then be stored in the FID instead of
202     stat scache entry of the symlink.
203
204   * return bad operation errors for all unimplemented functions
205     even if we do not know the functions exist.
206
207   * Log bad packets and unknown operation packets to the trace log
208
209   * Map CM_ERROR_BADOP to STATUS_NOT_SUPPORTED instead of 
210     0xC09820FF
211   
212   * Update list of known CIFS operations to include all those listed
213     in CIFS-TR-1p00_FINAL.pdf.
214
215   * Modify the handling of HKLM\SOFTWARE\OpenAFS\Client\Submounts
216     to support the REG_EXPAND_SZ type.
217
218 Since 1.3.70:
219   * A new Windows authorization group "AFS Client Admins" is now 
220     created and populated with the members of the "Administrators"
221     group.  The group is used to determine which accounts on the
222     machine may be used to modify the AFS Client Configuration via
223     the UI and command line tools.  afs_config.exe, fs.exe, 
224
225   * Modify the WinLogon Logoff Event Handler to query NT4 domain
226     controllers for the remote profile path if Active Directory
227     services are not available.
228
229   * Fix aklog.exe to not add the AFS ID to the username
230
231   * PTS registration of new users to foreign cells has been added to 
232      afscreds.exe
233
234   * The cm_Daemon thread is used to perform checks for 
235     down servers, up servers, volumes, callback expirations, 
236     lock maintenance and token expiration.  Due to a gaff in
237     larger integer division the thread never performed any 
238     work.  Instead the current time computation would always
239     be less then the trigger times.  This had an adverse affect
240     on the client's ability to maintain communication with servers,
241     keep volumes up to date, and flush user tokens and acls
242     when they have expired. This was broken when the 1.3 branch
243     was modified to support VC7 which no longer included 
244     largeint.lib
245
246   * An initialization problem with the Freelance code was 
247     detected while fixing the callbackRequest.  The cm_rootSCachep
248     object is obtained during afsd_InitDaemons() but the callback 
249     information is incomplete.  The callback information will not
250     be obtained until cm_MergeStatus is called from within
251     cm_GetCallback.  Unfortunately, cm_SyncOp did not properly 
252     test for the conditions under which the callback information
253     must be obtained.  
254
255   * Reports have been filed indicating that callbacks were
256     being lost.  An examination of the code indicated that the
257     cm_server_t objects were not being properly reference
258     counted by the cm_scache_t and cm_callbackRequest_t objects.
259     In particular, the cm_server_t objects may have been freed
260     from beneath the cm_conn_t objects.
261
262     All of the reference counting is now done via the functions:
263         cm_GetServer
264         cm_GetServerNoLock
265         cm_PutServer
266         cm_PutServerNoLock
267     this improves the ability to track the referrals.  
268
269     Each cm_BeginCallbackGranting Call now allocates a reference
270     to the cm_server_t.  The cm_EndCallbackGrantingCall either
271     frees the reference or transfers it to the cm_scache_t
272     cbServerp field.  These are then appropriately tracked
273     through the cm_Analyze call.
274
275   * Ensure that the dnlc hash table is the same size as the
276     dir name hash table (as per original author's note).
277     Increase the dnlc CM_AFSNCNAMESIZE to a multiple of 8
278     for compatibility with 64-bit systems.
279
280   * fix smb_ApplyV3DirListPatches to properly apply the hidden
281      attribute to dotfiles when the infoLevel < 0x101 and 
282      cm_SyncOp has failed.
283
284   * Fix the Freelance registry initialization code.  There
285     was a possibility that some systems could end up with 
286     garbage in the registry during a clean install.
287
288 Since 1.3.66:
289    * file and directory names beginning with "." will now be given the
290      hidden attribute when the volume access is anonymous.  this matches
291      the behavior when the volume access is via an authenticated user.
292
293    * Added a change monitor to the HKLM\SOFTWARE\OpenAFS\Client\Freelance
294      key.  When a change occurs mark the root.afs data as invalid and
295      for it to be reloaded on the next access.  This allows administrators
296      to modify the mount point list without restarting the service.
297      
298      The freelance client used to provide a fake modification time for
299      the root.afs volume data and its mount points of 7/09/2001 14:24 EDT.
300      Added code to extract the last modification time of the Freelance
301      registry key and use that instead.  The time now represents the 
302      most recent mount point change.
303
304    * PTS registration of new users to foreign cells has been added to 
305      aklog.exe
306
307    * Additional Cache Control and Credential Manager options have been
308      added to the WiX installer.  See deployment guide for details.
309
310    * The CachePath setting is now optionally a REG_EXPAND_SZ type
311   
312    * The WiX installer has been upgraded.  Version 2.0.1927.1 is now 
313      required.
314
315    * The loopback installation code may have had a problem updating the
316      %ETC%\HOSTS file which could have resulted in a premature failure.
317      Work around code has been added for the case where the file cannot
318      be deleted.
319
320    * The default max chunksize was increased from 15 (32K) to 17 (128K)
321      because Windows sends 64K blocks when using overlapped writes.
322
323    * The default number of server threads was increased from 4 to 25 to
324      better handle overlapped writes.  
325
326    * The "AfscredsShortcutParams" registry value was not being properly
327      loaded by afscreds.exe.  Therefore, the default value was always being
328      used instead of the value set by the installer.
329
330    * Windows XP provides downgrade attack detection to prevent an attacker
331      from being able to force the use of NTLM simply by disrupting 
332      communication with the KDC.  This attack cannot exist between the 
333      Windows CIFS client and the AFS Client Service.  Therefore, when a
334      downgrade has been detected the afs pioctl library will force the 
335      establishment of a new CIFS connection using NTLM.
336  
337    * A locking error was discovered surrounding all references to volume
338      server lists within the cm_cell.c source file. 
339
340    * The logged into Windows username was incorrect on Terminal Server
341      machines.
342
343    * A new registry value "NonPersistentCaching" was added to the service
344      parameters key.  When set to a non-zero value, the afs cache is stored
345      in the Windows paging file.  There are two limitations to choosing
346      this option: 
347         1. when persistent caching is implemented it won't work with 
348            this flag set since there will be nothing to persist.
349         2. with this flag set the initial paging allocation cannot be
350            changed while the service is running
351
352    * An initialization bug was discovered in aklog.exe which affected users
353      who have a domain name for their afs servers which could not be mapped
354      to a realm
355
356 Since 1.3.65:
357    * afs_config.exe now validates cell names against DNS in addition
358      to the CellServDB file.
359
360    * In order to allow the freelance client to connect to a volume with ID 
361      equal to 1 on the default cell we changed the fake root.afs volume ID
362      once again.  This time we choose 0xFFFFFFFF.  In addition, we change
363      the cell ID of the fake root.afs volume from 1 to 0xFFFFFFFF as well.
364      It will now be impossible for a volume ID to match that of another 
365      cell unless the client is connected to 0xFFFFFFFD cells.  That should
366      be enough room for growth.
367
368    * Fix "fs mkmount" command to work with UNC paths and when
369      started from non-AFS drives.  It is now possible to create a mount
370      point in the freelance fake root.afs volume with the command
371
372         fs mkmount \\AFS\all\<directory-name> <volume-name> <cellname>
373
374      For example,
375         
376         fs mkmount \\AFS\all\openafs.org root.cell openafs.org
377         fs mkmount \\AFS\all\.openafs.org root.cell openafs.org -rw
378
379    * The algorithm used to re-attempt access to the servers associated with
380      a volume has been altered to properly address the case in which all 
381      servers have been marked down.  The previous algorithm did not reset
382      the server's down flags so the servers were never actually retried.
383      This caused a problem with active volumes if the network connectivity
384      was lost as could be the case with a network cable removal, wireless
385      drop, or laptop hibernation.  With the fix volume access is restored
386      almost instantenously when network connectivity becomes available.
387
388    * Support for SMB/CIFS browsing has been added to the AFS Client Service
389      SMB server.  It is now possible to use "NET VIEW \\AFS" to obtain a
390      listing of AFS submounts and freelance mount points.  Support for
391      NETSHAREENUM, NETSHAREGETINFO, NETSERVERENUM2, NETSERVERGETINFO
392      significantly enhances the behavior of AFS volumes within the Explorer
393      Shell.  For instance, "AFS" now shows up as server in the Explorer
394      with each submount or freelance mount point visible as a share.
395      The right click menu in each folder now works with full functionality
396      on a consistent basis.
397
398    * The network provider can be configured to have different behavior
399      depending on the domain that the user logs into.  These settings are
400      only relevant when using integrated login.  A domain refers to an
401      Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
402      local machine (i.e. local account logins).  The domain name that is
403      used for selecting the domain would be the domain that is passed into
404      the NPLogonNotify function of the network provider. (see registry.txt
405      for details)
406
407    * Added a new registry value [HKCU\SOFTWARE\OpenAFS\Client] 
408      "Authentication Cell" which may be used to specify a default 
409      authentication cell for afscreds.exe which is different from
410      the default cell for the AFS Client Service daemon.
411
412    * Added a Logoff WinLogon Event Notification function to afslogon.dll.
413      afslogon.dll moved to %WINDIR%\System32\.
414      New registry entries added to register the dll for Winlogon events.
415
416      The logoff event will now force a call to ktc_ForgetAllTokens()
417      using the context of the user being logged off as long as the 
418      user's profile is not loaded from within AFS.  If the profile 
419      was loaded from AFS we can't release the tokens since the Logoff
420      event is triggered prior to the profile being written back to 
421      the its source location.  This is now performed in an XP SP2 
422      safe manner.
423
424    * Windows XP SP2 Internet Connection Firewall interoperability
425      has been added.
426
427    * The %WINDIR%\afsdsbmt.ini contains four sections:
428         Submounts, Drive Mappings, Active Maps and CSC Policies.
429      The Submounts and CSC policies are now stored in the registry under
430         [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
431         [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
432      The Drive Mappings and Active Maps are stored in the registry under
433         [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
434         [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
435
436      There is no automatic migration of this data as it would be impossible
437      to consistently migrate data to user profiles which may not be active
438      when the machine is updated.
439
440    * The %WINDIR%\afs_freelance.ini contains lists of mountpoints for the
441      fake root.afs volume.  For the same reasons as for the cellservdb file,
442      this information should not be in %WINDIR%.  This information is now
443      kept under the registry key
444         [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
445
446      The data from the afs_freelance.ini file will be automatically 
447      migrated to the registry on first execution of afsd_service.exe
448
449    * Keeping the CellServDB file in the location %WINDIR%\afsdcell.ini is 
450      troublesome for several reasons.  One, it is confusing for those who
451      expect the file to be named "CellServDB" instead of "afsdcell.ini".
452      Two, this file is not a Windows Profile formatted file.  Three, 
453      applications should not be reading or writing to %WINDIR%.  It causes
454      problems for Windows Terminal Server.
455
456      The new location of CellServDB will be the OpenAFS Client install 
457      directory which is by default C:\Program Files\OpenAFS\Client and can
458      be determined by querying the registry for 
459      [HKLM\SOFTWARE\TransarcCorporation\AFS Client\CurrentVersion]PathName
460
461      The existing afsdcell.ini will be migrated by the NSIS installer. 
462      The Wix installer must still be updated to do the same.
463
464    * Change NSIS installer to use DNS by default; to remove Integrated Logon
465      High Security mode; and to add Terminal Services compatibility registry
466      entries to allow the OpenAFS tools to find the afsdcell.ini and other
467      configuration files in %WINDIR%.
468   
469    * Add support for authenticated SMB connections.   This will remove
470      the need for high security mode in most situations.  Both NTLM
471      and Extended Security (GSS SPNEGO) modes are supported.  Effectively,
472      only NTLM can be used even though Kerberos is now supported.  The
473      reason is that it is not possible to construct a service principal
474      which is unique to each individual machine.
475
476      SMB Extended Auth does not work on XP SP2 unless one of two registry
477      modifications are made:
478
479      (1) To disable the check for matching host names on loopback connections
480         set this key.  This does not require a reboot:
481
482         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa]
483             "DisableLoopbackCheck"=dword:00000001
484
485      (2) To add the AFS SMB/CIFS service name to an approved list.  This
486         does require a reboot:
487
488         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0]
489             "BackConnectionHostNames"=multi-sz "AFS" "MACHINE-AFS"
490
491      afsd_service.exe will automatically add the current Netbios Name
492      to the BackConnectionHostNames list and then temporarily disable
493      the loopback check for one cycle of startup/shutdown of the service.
494      We assume most folks do not start/stop without a reboot so this 
495      will be adequate in most cases.
496
497    * Fix security hole in afslogon.dll which allowed passwords to be
498      sent in clear text to the KDC in a misformed principal name.
499
500    * Fix cm_GetCell() to properly handle expired dns entries
501      without crashing
502
503    * If Freelance mode is active and the afs_freelance.ini
504      file does not exist, do not create an empty file.
505      Instead create a file containing ro and rw mountpoints
506      to the default cell using the standard conventions.
507
508    * Modify the Freelance support to handle the ability
509      to create rw mount points in the fake root.afs volume.
510
511    * Changed the RPC mechanism used for token setting from 
512      named pipes to local.  Use of named pipes can be restored
513      by setting the environment variable AFS_RPC_PROTSEQ to
514      "ncacn_np". 
515
516      Named pipes were required when a Windows 9x system was
517      using a NT system in gateway mode which is incompatible
518      with our use of local loopback adapters.
519
520    * In afscreds.exe, if a username of the form user@REALM is
521      specified and no password is specified, do not perform a 
522      kinit operation.  Only perform the aklog functionality.
523
524    * Add a new registry value which allows the number of processors
525      on which afsd_service.exe executes to be restricted.  Valid
526      values are 1..numOfProcessors
527
528        HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
529           (DWORD) MaxCPUs 
530
531 Since 1.3.64:
532    * A second MSI based installer option is now available.
533
534    * Fixed Kerberos 5 kinit functionality in afscreds.exe to properly
535      request tickets for user/instance@REALM instead of just user@REALM
536
537    * Modify the Power Management Notify routine to wait for the Hard Dead
538      timeout period instead of a fixed 19 seconds.  With the longer timeout
539      periods Hibernation and Standby could never succeed when network 
540      connectivity is not available.
541
542    * The following fs.exe commands are now restricted to Administrator:
543      - checkservers with a non-zero timer value
544      - setcachesize
545      - newcell
546      - sysname with a new sysname list
547      - exportafs 
548      - setcell
549      - setserverprefs
550      - storebehind
551      - setcrypt
552      - cscpolicy
553      - trace
554
555      setting the default sysname for a machine should be done via the
556      registry and not via "fs sysname".
557
558    * NSIS installer adds options to install Debugging Symbols
559      and the Microsoft Loopback Adapter; the user is now also
560      given the ability to select the afscreds.exe startup options.
561
562    * Build system modified to generate symbols for FREE (aka RELEASE)
563      builds as well as CHECKED (aka DEBUG) builds
564
565    * Sites which have a volume ID of 0x20000001 assigned to their
566      root.cell volumes have been experiencing problems with accessing
567      the root.cell volume of their cell when Freelance mode has been
568      active.  This was because 0x20000001 was assigned to the fake
569      root.afs volume created by freelance.  The fake volume id is
570      now set to 0x00000001 to prevent conflicts.
571
572    * The timeout logic in the AFS Client Service has been wrong
573      for sometime.  It is based on two different assumptions.
574      First, the SMB client timeout is a fix value as was the case
575      with OS/2 Lan Manager.  This assumption is incorrect.  The
576      SMB timeout in Windows is a dynamic value computed based upon
577      a fixed minimum timeout to which is added time based upon the
578      size of the request and the performance characteristics of
579      the connection.  Second, it is the responsibility of the 
580      SMB Server to enforce the timeout requirements of the client.
581      This is untrue.  The SMB Server cannot be expected to know
582      the requirements of the client.  More importantly, if the 
583      SMB server uses the SMB client timeout as a value to restrict
584      its behavior as an RX client, the performance characteristics
585      of the local SMB session would be used to prematurely terminate
586      WAN connections with significantly different performance 
587      characteristics.
588
589      The timeout logic has therefore been modified in the following
590      manner:
591       . the Lan Manager Workstation (SMB) Session Timeout is used only
592         as a basis for configuring the Connection Dead Timeout 
593         and Hard Dead Timeout values.  The Connection Dead Timeout
594         must be at least 15 seconds longer than the SMB Timeout
595         and the Hard Dead Timeout must be at least double the 
596         Connection Dead Timeout.
597       . New registry entries have been added to allow the Connection
598         Dead Timeout and Hard Dead Timeout values independent of the
599         Lan Manager Workstation Session Timeout
600       . The test to enforce the SMB Client Timeout has been removed.
601         
602      One of the side-effects of removing the enforcement of the SMB 
603      Client Timeout is that regardless of whether or not the SMB client
604      is available to receive the response (and how would the SMB server
605      know) the RX protocol response can be used to update the AFS 
606      Client Service state for ready access by future SMB client 
607      requests.
608
609      This should be the end of the "Server paused or restarting messages"
610    
611    * Add support for arbitrary UNC paths to the pioctl() support.
612      This enables the fs commands as well as the AFS Shell Extension
613      to work correctly when UNC paths are being used.
614
615    * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
616      DNS if the cell configuration cannot be determined via CellServDB
617
618    * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
619      are ever set more than once at a time
620  
621    * Fix the management of lists of cm_cell_t structures when using 
622      DNS to lookup cell information.  The previous code would fail to
623      reuse the same cellID for a cell if DNS was used more than once
624      for a given cell name.  When the ttl expired, a single cm_cell_t
625      could be inserted into the cm_allCellsp list more than once 
626      producing a loop.  In addition, the vlServerp list belonging to
627      the cell was not freed resulting in improper refCounting of the
628      servers.
629
630    * Add DNS support to cm_IoctlNewCell() which previous only examined
631      the CellServDB file
632
633    * Add cm_FreeServer() function and call it from cm_FreeServerList()
634      to properly garbage collect cm_server_t objects 
635      
636    * Add numVCs variable to smb.c to track the number of smb_vc_t 
637      objects created and use it to initialize the vcID field which 
638      previously was set to 0 in all objects resulting in FindByID 
639      collisions.
640
641    * Fixed DNS lookups to work consistently throughout the OpenAFS
642      product instead of just from within the afsd_service.exe
643
644    * Added a runtime check to ensure that AFS Client Service SMB
645      Server is accepting connections before attempting to mount
646      global drives.
647
648    * Read IP addresses for volume servers out of the CellServDB
649      file if gethostbyname() on the hostname fails.
650
651    * Fix getcellconfig() to populate both the Hostnames as well
652      as IP addresses when loading cell data via DNS
653
654    * Increase the Connection Dead Time to 50 from 20 seconds
655      Increase the Hard Dead Time to 120 from 40 seconds
656      (matches the Unix values)
657
658    * Fixed an assertion validating the number of allocated NCBs
659
660    * Fixed the build environment to consistently build for 
661      Windows 2000 and above.  (APPVER = 5.0)
662
663    * Fixed rx_debug to properly validate the receipt in incoming
664      data with select() and recvfrom().  Do not copy data out of
665      the socket buffer unless success is indicated.
666
667 Since 1.3.63:
668    * afsd_service.exe will now display a message box to the 
669      desktop when it terminates due to an IP Address Change.
670   
671    * installer no longer deletes AFS Server configuration data
672      on uninstall
673
674    * installer generates a warning dialog if the RPC service 
675      is not properly configured
676
677    * installer compressed with lzma instead of bzip2
678
679    * afsd_service.exe shutdown crash solved once and for all
680  
681    * reference counting of smb_vc_t data structures improved
682  
683    * name space collision of smb_fid_t event objects corrected
684
685    * the output of "fs memdump" is now written to 
686      %WINDIR%\TEMP\afsd_alloc.log
687
688    * the file TaAfsApp_1033.dll is now properly installed allowing
689      the User Manager to start
690   
691    * a new algorithm is used for computing filename pattern matches
692
693    * afscreds.exe now accepts user names containing instance
694      fields.
695
696    * Fix the Directory Name Lookup Cache to be case-sensitive.
697      This is crucial in environments in which a Windows client
698      is accessing a directory with more than one filename that
699      differs only by case.  If the directory contains "FOO" 
700      and "Foo".  You want "DEL Foo" to delete the correct one.
701      We still have a problem in that "DEL foo" will delete a
702      random filename.  This will be addressed in a future release.
703
704    * Fix afscreds.exe -M option (renewMaps) to work when High
705      Security mode is off.  Also, remember to disable the ActiveMap
706      flag in afsdsbmt.ini when a drive mapping is removed.
707
708    * Updates to NSIS installer script.  AFS Server configuration
709      data will not be destroyed on un-install or re-install.  
710      Use a better compression algorithm.
711    
712    * afslogon.dll now uses KFW to obtain tokens when available
713    
714    * afslogon.dll when given an all uppercase username will
715      attempt to authenticate with both the uppercase name
716      and an all lowercase variation
717
718    * DST modification removed.  The fix appears to make things
719      worse after a reboot of the machine.
720
721    * fs.exe:  added "cscpolicy" which is used to 
722      change client side caching policy for AFS shares
723
724      Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs] 
725                          [-documents] [-disable] [-help]
726
727    * Several uninitialized variables have been initialized
728
729    * It is now possible to obtain tokens using cross realm
730      Kerberos within afscreds.exe:
731         cell:      dementia.org
732         user:      jaltman@ATHENA.MIT.EDU
733         password:  xxxxxxxx
734      Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
735      will will in turn be used to obtain afs@DEMENTIA.ORG.
736      The resulting token will be stored with the display name 
737        jaltman@ATHENA.MIT.EDU@dementia.org
738
739    * aklog.exe has been added to the client
740
741      Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]] 
742                   [[-p | -path] pathname]
743                   [-noprdb] [-force]
744                   [-5 | -4]
745
746         -d gives debugging information.
747         krb_realm is the kerberos realm of a cell.
748         pathname is the name of a directory to which you wish to authenticate.
749         -noprdb means don't try to determine AFS ID.
750         -5 or -4 selects whether to use Kerberos V or Kerberos IV.
751            (default is Kerberos V)
752         No commandline arguments means authenticate to the local cell.
753
754 Since 1.3.62:
755    * All of the resource files have been restructured to adhere to
756      a set of rules IBM implemented for loading string resources.
757      These rules had either been forgotten or were not discovered
758      by folks working on the OpenAFS sources.  The end result was
759      memory corruption.  This is primary item which was preventing
760      the AFS Server from working.
761
762    * Increased the size of the maximum ticket size stored in a token
763      from 344 bytes to 12,000.  Increased the buffers used to convey
764      messages between the pioctl() caller and the SMB Server from
765      1000 bytes to 12,512.  The code appeared to have been writing
766      above the top of the stack by quite a few number of bytes.
767      (The increased ticket size is necessary for the next item.)
768
769    * When obtaining AFS Tokens via KFW, krb524 is no longer required.
770      Instead the raw Kerberos 5 ticket is used in its entirety.  This
771      is extremely important as it allows us to use pure Kerberos 5 KDCs
772      as the source of the AFS authentication.  The use of up to 12,000 byte
773      tickets will allow tickets produced by all versions of Microsoft
774      Active Directory to be used.
775       - create a user account.       
776       - designate it DES only
777       - disable pre-auth
778       - specify its UPN to be  "afs@realm"
779       - assign a SPN of "afs/cellname" to the UPN with setspn.exe
780
781    * Do not enforce the funky 8dot3 pattern matching rule that the first "."
782      is special when using long file names.  (you must use "*.*" and not "*")
783      Instead only enforce it when performing 8dot3 searches. 
784
785    * Fixed the DST problem with creation times being set one hour ahead
786
787    * Fixed the problem when using \\afs\cell-alias.  For example, 
788      \\afs\uncc instead of \\afs\uncc.edu.  Do not a new cell struct
789      for the alias name; instead simply expand the name.  One of the
790      symptoms of this problem was a loss of acquired tokens.
791
792    * Fixed the AFS Shell Extension.  The Symbolic Link menu was empty 
793      of strings.  (Only English strings provided.)
794
795    * Fixed the installer to properly replace in use files.  
796
797    * Fixed the build system to cleanup generated component version files
798
799    * The release build compiled with MSVC 6.0 compiler to avoid the 
800      afsd_service.exe shutdown crash.  This does not solve the problem
801      but simply avoids it for the time being.
802
803 Since 1.3.61:
804
805  * fix afslogon.dll to not corrupt memory when High Security mode
806    is not used.  
807
808  * fix afsd_service.exe to not attempt to restore the stack when
809    an exception occurs.  (not safe in multi-threaded programs)
810
811  * fix uninstaller to properly remove the CRT and MFC DLLs
812  
813  * remove a Message Box from afscreds.exe when getcellconfig()
814    fails on a kerberos realm which is not a cell
815
816 The following is a list of changes to the OpenAFS for Window client
817 since 1.3.60.
818
819  * "fs setserverprefs" will leave afsd service deadlocked
820
821  * "vos listaddrs" will core dump
822
823  * installer sets the appropriate keys to support Integrated Logon
824
825  * installer disables the "Find Lana by Name" functionality as it
826    was causing headaches for many users
827
828  * fix the intermittent crash of the power management thread when
829    shutting down the AFS Client Service
830
831  * optimizes the obtain drive mount list functionality which is 
832    executed every time the mount tab in afscreds.exe and afs_config.exe
833    are refreshed.  (this happens a lot)
834
835  * fix the service shutdown logic.  add the STOP_PENDING state
836    and do not accept additional service events after we declare
837    ourselves STOPPED.
838
839 The following is a list of changes to the OpenAFS for Window client
840 since 1.2.10.
841
842 * flexelint was run against the source tree and hundreds (perhaps 
843   thousands) of corrections were applied to ensure prototypes 
844   were in use; types were used consistently; variables were 
845   initialized; unused variables were removed; etc.
846
847 * A wide variety of instrumentation was added including the 
848   ability to produce a stack trace from within afsd_service.exe
849   when it crashes.
850
851 * Dynamic configuration of the RDRtimeout value based upon the
852   LanMan Workstation Session Timeout
853
854 * The mount root no longer needs to be called "/afs".  This 
855   is now set by a registry value "MountRoot" within the key
856   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
857
858 * The cell list is now only read out of afsdcell.ini when the
859   file changes instead of each time a cell is resolved.
860
861 * Thread synchronization was added to cm_server.c and ktc_nt.c
862
863 * All calls to GlobalAlloc()/GlobalFree() were replaced with 
864   calloc()/free().  The Global functions were needed on Windows 3.x
865   but have caused a variety of problems on the Win32 platforms.
866   Avoiding them is highly recommended by several Microsoft 
867   Knowledgebase articles
868
869 * Support for Symbolic Links added to the AFS Shell Extension
870
871 * Added a registry value "OverlayEnabled" to determine if
872   Shell Extension Overlays should be enabled.  
873   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
874
875 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
876   separate trees for checked and free builds.  Build system supports
877   a custom directory src\WINNT\extra which can be used as a grafting
878   location of organization specific additions to the build tree.
879
880 * New installer built using NSIS 2.0.  
881
882 * Named all kernel objects in order to allow them to be monitored
883   with tools such as SysInternals' ProcExp.exe.
884   
885 * Introduced new EventLog framework for AFSD
886
887 * Introduced Power Management interface to AFSD for Standby and 
888   Hibernate modes to allow cache to be flushed prior to network
889   disconnect
890
891 * Utilize Win32 DNSQuery API instead of internal routines.  This 
892   allows DNS SRV queries to be sent to all current domain name 
893   servers.  Not just one specified in an INI file.  DNS is now
894   always activated.
895
896 * "NetbiosName" registry value may be used to specify a fixed
897   Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
898   when the loopback adapter is in use.  If you need to use the 
899   old notation with a loopback adapter installed specify a registry
900   entry of 
901
902      "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
903
904 * Refactor all modules which depend on LAN Adapter and NetbiosName
905   determination in a new library: lanahelper.lib.  This allows for
906   consistent behavior throughout the product.
907
908 * Move the afsd.log and afsd_init.log files to the directory specified
909   by the "TEMP" environment variable.  This is usually %WINDIR%\TEMP
910   for services.  Added the Date to the log entries.
911
912 * New registry value "RxMaxMTU" used to limit the size of the RX 
913   packets sent by the AFS Client Service to the Server.  In order
914   to enable OpenAFS to work across the Cisco IPSec VPN the packet
915   size must be restricted to 1264 or smaller.  The latest NSIS
916   installer sets a value of 1260 by default.
917
918 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
919   packets.  This is not needed in order to work across the Cisco
920   VPN but might be needed for other network environments.  This
921   value is not set by the NSIS installer.
922
923 * New registry value "HideDotFiles" is used to apply the Hidden
924   attribute to files whose names begin with a '.'.   This value
925   is set by the NSIS installer.
926
927 * New registry value "MaxMpxRequests" allows the maximum number
928   of multiplexed sessions to be configured at run time.  This
929   value is not set by the NSIS installer.  The default value is
930   50.
931
932 * New registry value "MaxVCPerServer" allows the maxmimum number
933   of VCs per server to be configured at run time.  This value is
934   not set by the NSIS installer.  The default value is 100.
935
936 * New registry value "AllSubmount" allows the "all" submount to
937   be disabled by setting its value to 0x00.
938
939 * Allow cells names to be valid mount points 
940     \\<netbiosName>\<cellname>
941
942 * Store the active state of drive mappings in order for afscreds.exe
943   to restore them upon startup
944
945 * Add exception handling to generate a Stack Trace to the afsd_init.log
946   file if one happens to occur.
947
948 * Add lots of logging to help detect the cause of invalid SMB packets
949
950 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
951   conversion of Kerberos 5 "afs" service tickets.  Supports auto-
952   renewal of expiring tokens as long as afscreds.exe is running.
953
954 * New afscreds.exe command line options:
955     -A = autoinit
956     -M = renew drive maps
957     -N = ip address change detection
958     -Z = unmap drives
959
960 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
961   determines whether or not MIT Kerberos for Windows should be used
962   to obtain tokens via Kerberos 5 tickets.
963
964 * New registry value "AfscredsShortcutParams" in 
965   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
966   determines the command line parameters to be specified when "fixing"
967   the AFS Shortcut in the user's startup folder.
968
969 * The "ShowTrayIcon" registry value has been moved from 
970   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
971   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
972   
973 * The <cell name> registry values used to store the token expiration
974   reminders have been moved from 
975   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
976   {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
977  
978 * Obtain the Logon User Name from the Explorer key when available
979
980 * new text document doc\txt\winnotes\registry.txt lists all registry
981   values used by OpenAFS (excluding the AFS Server)
982
983 * BUG: rx_securityClass objects were not properly reference 
984   counted and were never freed.  
985
986 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
987   would be generated.  The existence of a server does not imply
988   that it is not down.  If all of the servers for a cell are down
989   return CM_ERROR_NOSUCHVOLUME instead.  This prevents the Explorer
990   Shell from hanging.
991
992 * BUG: the directory name lookup cache failed to free the entries
993   in the cache when the name cache entries cycled.  The entries
994   in the cache would become dereferenced without being freed.
995
996 * BUG: fs setserverprefs could be executed without Administrator
997   privileges
998
999 * BUG: the number of allocated NCB objects (100) exceeded the number
1000   which could actually be waited upon by the kernel (64).  Any objects
1001   which were utilized above the limit could never have event completions
1002   detected.
1003
1004 * BUG: smb_username_t objects were not being reference counted and 
1005   were not properly freed.
1006
1007 * BUG: smb_tid_t objects could under unusual circumstances be freed
1008   before they were no longer referenced.
1009
1010 * BUG: smb_fid_t object pointer were frequently used even when 
1011   their value could be NULL.   They were not properly released and
1012   therefore they were never freed.
1013
1014 * BUG: smb_packet_t data structures were not completely initialized
1015   upon creation
1016
1017 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
1018   Denied" because that causes the Explorer Shell to try again until
1019   access is obtained.  Instead return "Remote Resources" which allows 
1020   the shell to move on and treat the error as transient.
1021
1022 * BUG: when initializing the NCBreturns structure, separate Event objects
1023   were created for each NCB although a single Event object was supposed
1024   to be shared by all.
1025
1026 * BUG: smb_dirSearch_t objects were not being properly referenced counted
1027   or freed.
1028
1029 * BUG: smb_tran2Packet_t objects were not being properly referenced 
1030   counted or freed.
1031
1032 * BUG: directory path creation did not handle the case of multiple
1033   directories requiring creation in one attempt
1034
1035 * BUG: SMB requests which required an Extended Response were ignored.
1036   This prevented some files from being written to AFS volumes.
1037
1038 * BUG: character strings were being freed even after they were 
1039   inserted into in use data structures
1040
1041 * BUG: inconsistent usernames were used when High Security mode was
1042   enabled.  (there is still much to do in this area)
1043
1044 * BUG: pioctl() calls which require out of band RPC operations were
1045   susceptible to race conditions when performed by multiple processes
1046
1047 * BUG: memory allocation and deallocation crossed instances of the
1048   C Runtime Library producing memory leakage and corruption in 
1049   afscreds and the client configurator.
1050
1051
1052