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