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