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