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