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