2 * Added a new registry value [HKCU\SOFTWARE\OpenAFS\Client]
3 "Authentication Cell" which may be used to specify a default
4 authentication cell for afscreds.exe which is different from
5 the default cell for the AFS Client Service daemon.
7 * Added a Logoff WinLogon Event Notification function to afslogon.dll.
8 afslogon.dll moved to %WINDIR%\System32\.
9 New registry entries added to register the dll for Winlogon events.
11 The logoff event will now force a call to ktc_ForgetAllTokens()
12 using the context of the user being logged off.
14 Need to double check that this code does not prevent profile data
15 from being written back to an afs volume
17 * Windows XP SP2 Internet Connection Firewall interoperability
20 * The %WINDIR%\afsdsbmt.ini contains four sections:
21 Submounts, Drive Mappings, Active Maps and CSC Policies.
22 The Submounts and CSC policies are now stored in the registry under
23 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
24 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
25 The Drive Mappings and Active Maps are stored in the registry under
26 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
27 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
29 There is no automatic migration of this data as it would be impossible
30 to consistently migrate data to user profiles which may not be active
31 when the machine is updated.
33 * The %WINDIR%\afs_freelance.ini contains lists of mountpoints for the
34 fake root.afs volume. For the same reasons as for the cellservdb file,
35 this information should not be in %WINDIR%. This information is now
36 kept under the registry key
37 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
39 The data from the afs_freelance.ini file will be automatically
40 migrated to the registry on first execution of afsd_service.exe
42 * Keeping the CellServDB file in the location %WINDIR%\afsdcell.ini is
43 troublesome for several reasons. One, it is confusing for those who
44 expect the file to be named "CellServDB" instead of "afsdcell.ini".
45 Two, this file is not a Windows Profile formatted file. Three,
46 applications should not be reading or writing to %WINDIR%. It causes
47 problems for Windows Terminal Server.
49 The new location of CellServDB will be the OpenAFS Client install
50 directory which is by default C:\Program Files\OpenAFS\Client and can
51 be determined by querying the registry for
52 [HKLM\SOFTWARE\TransarcCorporation\AFS Client\CurrentVersion]PathName
54 The existing afsdcell.ini will be migrated by the NSIS installer.
55 The Wix installer must still be updated to do the same.
57 * Change NSIS installer to use DNS by default; to remove Integrated Logon
58 High Security mode; and to add Terminal Services compatibility registry
59 entries to allow the OpenAFS tools to find the afsdcell.ini and other
60 configuration files in %WINDIR%.
62 * Add support for authenticated SMB connections. This will remove
63 the need for high security mode in most situations. Both NTLM
64 and Extended Security (GSS SPNEGO) modes are supported. Effectively,
65 only NTLM can be used even though Kerberos is now supported. The
66 reason is that it is not possible to construct a service principal
67 which is unique to each individual machine.
69 SMB Extended Auth does not work on XP SP2 unless one of two registry
70 modifications are made:
72 (1) To disable the check for matching host names on loopback connections
73 set this key. This does not require a reboot:
75 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa]
76 "DisableLoopbackCheck"=dword:00000001
78 (2) To add the AFS SMB/CIFS service name to an approved list. This
79 does require a reboot:
81 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0]
82 "BackConnectionHostNames"=multi-sz "AFS" "MACHINE-AFS"
84 afsd_service.exe will automatically add the current Netbios Name
85 to the BackConnectionHostNames list and then temporarily disable
86 the loopback check for one cycle of startup/shutdown of the service.
87 We assume most folks do not start/stop without a reboot so this
88 will be adequate in most cases.
90 * Fix security hole in afslogon.dll which allowed passwords to be
91 sent in clear text to the KDC in a misformed principal name.
93 * Fix cm_GetCell() to properly handle expired dns entries
96 * If Freelance mode is active and the afs_freelance.ini
97 file does not exist, do not create an empty file.
98 Instead create a file containing ro and rw mountpoints
99 to the default cell using the standard conventions.
101 * Modify the Freelance support to handle the ability
102 to create rw mount points in the fake root.afs volume.
104 * Changed the RPC mechanism used for token setting from
105 named pipes to local. Use of named pipes can be restored
106 by setting the environment variable AFS_RPC_PROTSEQ to
109 Named pipes were required when a Windows 9x system was
110 using a NT system in gateway mode which is incompatible
111 with our use of local loopback adapters.
113 * In afscreds.exe, if a username of the form user@REALM is
114 specified and no password is specified, do not perform a
115 kinit operation. Only perform the aklog functionality.
117 * Add a new registry value which allows the number of processors
118 on which afsd_service.exe executes to be restricted. Valid
119 values are 1..numOfProcessors
121 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
125 * A second MSI based installer option is now available.
127 * Fixed Kerberos 5 kinit functionality in afscreds.exe to properly
128 request tickets for user/instance@REALM instead of just user@REALM
130 * Modify the Power Management Notify routine to wait for the Hard Dead
131 timeout period instead of a fixed 19 seconds. With the longer timeout
132 periods Hibernation and Standby could never succeed when network
133 connectivity is not available.
135 * The following fs.exe commands are now restricted to Administrator:
136 - checkservers with a non-zero timer value
139 - sysname with a new sysname list
148 setting the default sysname for a machine should be done via the
149 registry and not via "fs sysname".
151 * NSIS installer adds options to install Debugging Symbols
152 and the Microsoft Loopback Adapter; the user is now also
153 given the ability to select the afscreds.exe startup options.
155 * Build system modified to generate symbols for FREE (aka RELEASE)
156 builds as well as CHECKED (aka DEBUG) builds
158 * Sites which have a volume ID of 0x20000001 assigned to their
159 root.afs volumes have been experiencing problems with accessing
160 the root.afs volume of their cell when Freelance mode has been
161 active. This was because 0x20000001 was assigned to the fake
162 root.afs volume created by freelance. The fake volume id is
163 now set to 0x00000001 to prevent conflicts.
165 * The timeout logic in the AFS Client Service has been wrong
166 for sometime. It is based on two different assumptions.
167 First, the SMB client timeout is a fix value as was the case
168 with OS/2 Lan Manager. This assumption is incorrect. The
169 SMB timeout in Windows is a dynamic value computed based upon
170 a fixed minimum timeout to which is added time based upon the
171 size of the request and the performance characteristics of
172 the connection. Second, it is the responsibility of the
173 SMB Server to enforce the timeout requirements of the client.
174 This is untrue. The SMB Server cannot be expected to know
175 the requirements of the client. More importantly, if the
176 SMB server uses the SMB client timeout as a value to restrict
177 its behavior as an RX client, the performance characteristics
178 of the local SMB session would be used to prematurely terminate
179 WAN connections with significantly different performance
182 The timeout logic has therefore been modified in the following
184 . the Lan Manager Workstation (SMB) Session Timeout is used only
185 as a basis for configuring the Connection Dead Timeout
186 and Hard Dead Timeout values. The Connection Dead Timeout
187 must be at least 15 seconds longer than the SMB Timeout
188 and the Hard Dead Timeout must be at least double the
189 Connection Dead Timeout.
190 . New registry entries have been added to allow the Connection
191 Dead Timeout and Hard Dead Timeout values independent of the
192 Lan Manager Workstation Session Timeout
193 . The test to enforce the SMB Client Timeout has been removed.
195 One of the side-effects of removing the enforcement of the SMB
196 Client Timeout is that regardless of whether or not the SMB client
197 is available to receive the response (and how would the SMB server
198 know) the RX protocol response can be used to update the AFS
199 Client Service state for ready access by future SMB client
202 This should be the end of the "Server paused or restarting messages"
204 * Fix "fs mkmount" command to work with UNC paths and when
205 started from non-AFS drives
207 * Add support for arbitrary UNC paths to the pioctl() support.
208 This enables the fs commands as well as the AFS Shell Extension
209 to work correctly when UNC paths are being used.
211 * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
212 DNS if the cell configuration cannot be determined via CellServDB
214 * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
215 are ever set more than once at a time
217 * Fix the management of lists of cm_cell_t structures when using
218 DNS to lookup cell information. The previous code would fail to
219 reuse the same cellID for a cell if DNS was used more than once
220 for a given cell name. When the ttl expired, a single cm_cell_t
221 could be inserted into the cm_allCellsp list more than once
222 producing a loop. In addition, the vlServerp list belonging to
223 the cell was not freed resulting in improper refCounting of the
226 * Add DNS support to cm_IoctlNewCell() which previous only examined
229 * Add cm_FreeServer() function and call it from cm_FreeServerList()
230 to properly garbage collect cm_server_t objects
232 * Add numVCs variable to smb.c to track the number of smb_vc_t
233 objects created and use it to initialize the vcID field which
234 previously was set to 0 in all objects resulting in FindByID
237 * Fixed DNS lookups to work consistently throughout the OpenAFS
238 product instead of just from within the afsd_service.exe
240 * Added a runtime check to ensure that AFS Client Service SMB
241 Server is accepting connections before attempting to mount
244 * Read IP addresses for volume servers out of the CellServDB
245 file if gethostbyname() on the hostname fails.
247 * Fix getcellconfig() to populate both the Hostnames as well
248 as IP addresses when loading cell data via DNS
250 * Increase the Connection Dead Time to 50 from 20 seconds
251 Increase the Hard Dead Time to 120 from 40 seconds
252 (matches the Unix values)
254 * Fixed an assertion validating the number of allocated NCBs
256 * Fixed the build environment to consistently build for
257 Windows 2000 and above. (APPVER = 5.0)
259 * Fixed rx_debug to properly validate the receipt in incoming
260 data with select() and recvfrom(). Do not copy data out of
261 the socket buffer unless success is indicated.
264 * afsd_service.exe will now display a message box to the
265 desktop when it terminates due to an IP Address Change.
267 * installer no longer deletes AFS Server configuration data
270 * installer generates a warning dialog if the RPC service
271 is not properly configured
273 * installer compressed with lzma instead of bzip2
275 * afsd_service.exe shutdown crash solved once and for all
277 * reference counting of smb_vc_t data structures improved
279 * name space collision of smb_fid_t event objects corrected
281 * the output of "fs memdump" is now written to
282 %WINDIR%\TEMP\afsd_alloc.log
284 * the file TaAfsApp_1033.dll is now properly installed allowing
285 the User Manager to start
287 * a new algorithm is used for computing filename pattern matches
289 * afscreds.exe now accepts user names containing instance
292 * Fix the Directory Name Lookup Cache to be case-sensitive.
293 This is crucial in environments in which a Windows client
294 is accessing a directory with more than one filename that
295 differs only by case. If the directory contains "FOO"
296 and "Foo". You want "DEL Foo" to delete the correct one.
297 We still have a problem in that "DEL foo" will delete a
298 random filename. This will be addressed in a future release.
300 * Fix afscreds.exe -M option (renewMaps) to work when High
301 Security mode is off. Also, remember to disable the ActiveMap
302 flag in afsdsbmt.ini when a drive mapping is removed.
304 * Updates to NSIS installer script. AFS Server configuration
305 data will not be destroyed on un-install or re-install.
306 Use a better compression algorithm.
308 * afslogon.dll now uses KFW to obtain tokens when available
310 * afslogon.dll when given an all uppercase username will
311 attempt to authenticate with both the uppercase name
312 and an all lowercase variation
314 * DST modification removed. The fix appears to make things
315 worse after a reboot of the machine.
317 * fs.exe: added "cscpolicy" which is used to
318 change client side caching policy for AFS shares
320 Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs]
321 [-documents] [-disable] [-help]
323 * Several uninitialized variables have been initialized
325 * It is now possible to obtain tokens using cross realm
326 Kerberos within afscreds.exe:
328 user: jaltman@ATHENA.MIT.EDU
330 Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
331 will will in turn be used to obtain afs@DEMENTIA.ORG.
332 The resulting token will be stored with the display name
333 jaltman@ATHENA.MIT.EDU@dementia.org
335 * aklog.exe has been added to the client
337 Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]
338 [[-p | -path] pathname]
342 -d gives debugging information.
343 krb_realm is the kerberos realm of a cell.
344 pathname is the name of a directory to which you wish to authenticate.
345 -noprdb means don't try to determine AFS ID.
346 -5 or -4 selects whether to use Kerberos V or Kerberos IV.
347 (default is Kerberos V)
348 No commandline arguments means authenticate to the local cell.
351 * All of the resource files have been restructured to adhere to
352 a set of rules IBM implemented for loading string resources.
353 These rules had either been forgotten or were not discovered
354 by folks working on the OpenAFS sources. The end result was
355 memory corruption. This is primary item which was preventing
356 the AFS Server from working.
358 * Increased the size of the maximum ticket size stored in a token
359 from 344 bytes to 12,000. Increased the buffers used to convey
360 messages between the pioctl() caller and the SMB Server from
361 1000 bytes to 12,512. The code appeared to have been writing
362 above the top of the stack by quite a few number of bytes.
363 (The increased ticket size is necessary for the next item.)
365 * When obtaining AFS Tokens via KFW, krb524 is no longer required.
366 Instead the raw Kerberos 5 ticket is used in its entirety. This
367 is extremely important as it allows us to use pure Kerberos 5 KDCs
368 as the source of the AFS authentication. The use of up to 12,000 byte
369 tickets will allow tickets produced by all versions of Microsoft
370 Active Directory to be used.
371 - create a user account.
372 - designate it DES only
374 - specify its UPN to be "afs@realm"
375 - assign a SPN of "afs/cellname" to the UPN with setspn.exe
377 * Do not enforce the funky 8dot3 pattern matching rule that the first "."
378 is special when using long file names. (you must use "*.*" and not "*")
379 Instead only enforce it when performing 8dot3 searches.
381 * Fixed the DST problem with creation times being set one hour ahead
383 * Fixed the problem when using \\afs\cell-alias. For example,
384 \\afs\uncc instead of \\afs\uncc.edu. Do not a new cell struct
385 for the alias name; instead simply expand the name. One of the
386 symptoms of this problem was a loss of acquired tokens.
388 * Fixed the AFS Shell Extension. The Symbolic Link menu was empty
389 of strings. (Only English strings provided.)
391 * Fixed the installer to properly replace in use files.
393 * Fixed the build system to cleanup generated component version files
395 * The release build compiled with MSVC 6.0 compiler to avoid the
396 afsd_service.exe shutdown crash. This does not solve the problem
397 but simply avoids it for the time being.
401 * fix afslogon.dll to not corrupt memory when High Security mode
404 * fix afsd_service.exe to not attempt to restore the stack when
405 an exception occurs. (not safe in multi-threaded programs)
407 * fix uninstaller to properly remove the CRT and MFC DLLs
409 * remove a Message Box from afscreds.exe when getcellconfig()
410 fails on a kerberos realm which is not a cell
412 The following is a list of changes to the OpenAFS for Window client
415 * "fs setserverprefs" will leave afsd service deadlocked
417 * "vos listaddrs" will core dump
419 * installer sets the appropriate keys to support Integrated Logon
421 * installer disables the "Find Lana by Name" functionality as it
422 was causing headaches for many users
424 * fix the intermittent crash of the power management thread when
425 shutting down the AFS Client Service
427 * optimizes the obtain drive mount list functionality which is
428 executed every time the mount tab in afscreds.exe and afs_config.exe
429 are refreshed. (this happens a lot)
431 * fix the service shutdown logic. add the STOP_PENDING state
432 and do not accept additional service events after we declare
435 The following is a list of changes to the OpenAFS for Window client
438 * flexelint was run against the source tree and hundreds (perhaps
439 thousands) of corrections were applied to ensure prototypes
440 were in use; types were used consistently; variables were
441 initialized; unused variables were removed; etc.
443 * A wide variety of instrumentation was added including the
444 ability to produce a stack trace from within afsd_service.exe
447 * Dynamic configuration of the RDRtimeout value based upon the
448 LanMan Workstation Session Timeout
450 * The mount root no longer needs to be called "/afs". This
451 is now set by a registry value "MountRoot" within the key
452 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
454 * The cell list is now only read out of afsdcell.ini when the
455 file changes instead of each time a cell is resolved.
457 * Thread synchronization was added to cm_server.c and ktc_nt.c
459 * All calls to GlobalAlloc()/GlobalFree() were replaced with
460 calloc()/free(). The Global functions were needed on Windows 3.x
461 but have caused a variety of problems on the Win32 platforms.
462 Avoiding them is highly recommended by several Microsoft
463 Knowledgebase articles
465 * Support for Symbolic Links added to the AFS Shell Extension
467 * Added a registry value "OverlayEnabled" to determine if
468 Shell Extension Overlays should be enabled.
469 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
471 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
472 separate trees for checked and free builds. Build system supports
473 a custom directory src\WINNT\extra which can be used as a grafting
474 location of organization specific additions to the build tree.
476 * New installer built using NSIS 2.0.
478 * Named all kernel objects in order to allow them to be monitored
479 with tools such as SysInternals' ProcExp.exe.
481 * Introduced new EventLog framework for AFSD
483 * Introduced Power Management interface to AFSD for Standby and
484 Hibernate modes to allow cache to be flushed prior to network
487 * Utilize Win32 DNSQuery API instead of internal routines. This
488 allows DNS SRV queries to be sent to all current domain name
489 servers. Not just one specified in an INI file. DNS is now
492 * "NetbiosName" registry value may be used to specify a fixed
493 Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
494 when the loopback adapter is in use. If you need to use the
495 old notation with a loopback adapter installed specify a registry
498 "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
500 * Refactor all modules which depend on LAN Adapter and NetbiosName
501 determination in a new library: lanahelper.lib. This allows for
502 consistent behavior throughout the product.
504 * Move the afsd.log and afsd_init.log files to the directory specified
505 by the "TEMP" environment variable. This is usually %WINDIR%\TEMP
506 for services. Added the Date to the log entries.
508 * New registry value "RxMaxMTU" used to limit the size of the RX
509 packets sent by the AFS Client Service to the Server. In order
510 to enable OpenAFS to work across the Cisco IPSec VPN the packet
511 size must be restricted to 1264 or smaller. The latest NSIS
512 installer sets a value of 1260 by default.
514 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
515 packets. This is not needed in order to work across the Cisco
516 VPN but might be needed for other network environments. This
517 value is not set by the NSIS installer.
519 * New registry value "HideDotFiles" is used to apply the Hidden
520 attribute to files whose names begin with a '.'. This value
521 is set by the NSIS installer.
523 * New registry value "MaxMpxRequests" allows the maximum number
524 of multiplexed sessions to be configured at run time. This
525 value is not set by the NSIS installer. The default value is
528 * New registry value "MaxVCPerServer" allows the maxmimum number
529 of VCs per server to be configured at run time. This value is
530 not set by the NSIS installer. The default value is 100.
532 * New registry value "AllSubmount" allows the "all" submount to
533 be disabled by setting its value to 0x00.
535 * Allow cells names to be valid mount points
536 \\<netbiosName>\<cellname>
538 * Store the active state of drive mappings in order for afscreds.exe
539 to restore them upon startup
541 * Add exception handling to generate a Stack Trace to the afsd_init.log
542 file if one happens to occur.
544 * Add lots of logging to help detect the cause of invalid SMB packets
546 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
547 conversion of Kerberos 5 "afs" service tickets. Supports auto-
548 renewal of expiring tokens as long as afscreds.exe is running.
550 * New afscreds.exe command line options:
552 -M = renew drive maps
553 -N = ip address change detection
556 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client
557 determines whether or not MIT Kerberos for Windows should be used
558 to obtain tokens via Kerberos 5 tickets.
560 * New registry value "AfscredsShortcutParams" in
561 {HKCU,HKLM}SOFTWARE\OpenAFS\Client
562 determines the command line parameters to be specified when "fixing"
563 the AFS Shortcut in the user's startup folder.
565 * The "ShowTrayIcon" registry value has been moved from
566 HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
567 {HKCU,HKLM}SOFTWARE\OpenAFS\Client
569 * The <cell name> registry values used to store the token expiration
570 reminders have been moved from
571 HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
572 {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
574 * Obtain the Logon User Name from the Explorer key when available
576 * new text document doc\txt\winnotes\registry.txt lists all registry
577 values used by OpenAFS (excluding the AFS Server)
579 * BUG: rx_securityClass objects were not properly reference
580 counted and were never freed.
582 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
583 would be generated. The existence of a server does not imply
584 that it is not down. If all of the servers for a cell are down
585 return CM_ERROR_NOSUCHVOLUME instead. This prevents the Explorer
588 * BUG: the directory name lookup cache failed to free the entries
589 in the cache when the name cache entries cycled. The entries
590 in the cache would become dereferenced without being freed.
592 * BUG: fs setserverprefs could be executed without Administrator
595 * BUG: the number of allocated NCB objects (100) exceeded the number
596 which could actually be waited upon by the kernel (64). Any objects
597 which were utilized above the limit could never have event completions
600 * BUG: smb_username_t objects were not being reference counted and
601 were not properly freed.
603 * BUG: smb_tid_t objects could under unusual circumstances be freed
604 before they were no longer referenced.
606 * BUG: smb_fid_t object pointer were frequently used even when
607 their value could be NULL. They were not properly released and
608 therefore they were never freed.
610 * BUG: smb_packet_t data structures were not completely initialized
613 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
614 Denied" because that causes the Explorer Shell to try again until
615 access is obtained. Instead return "Remote Resources" which allows
616 the shell to move on and treat the error as transient.
618 * BUG: when initializing the NCBreturns structure, separate Event objects
619 were created for each NCB although a single Event object was supposed
622 * BUG: smb_dirSearch_t objects were not being properly referenced counted
625 * BUG: smb_tran2Packet_t objects were not being properly referenced
628 * BUG: directory path creation did not handle the case of multiple
629 directories requiring creation in one attempt
631 * BUG: SMB requests which required an Extended Response were ignored.
632 This prevented some files from being written to AFS volumes.
634 * BUG: character strings were being freed even after they were
635 inserted into in use data structures
637 * BUG: inconsistent usernames were used when High Security mode was
638 enabled. (there is still much to do in this area)
640 * BUG: pioctl() calls which require out of band RPC operations were
641 susceptible to race conditions when performed by multiple processes
643 * BUG: memory allocation and deallocation crossed instances of the
644 C Runtime Library producing memory leakage and corruption in
645 afscreds and the client configurator.