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