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