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