2 * The timeout logic in the AFS Client Service has been wrong
3 for sometime. It is based on two different assumptions.
4 First, the SMB client timeout is a fix value as was the case
5 with OS/2 Lan Manager. This assumption is incorrect. The
6 SMB timeout in Windows is a dynamic value computed based upon
7 a fixed minimum timeout to which is added time based upon the
8 size of the request and the performance characteristics of
9 the connection. Second, it is the responsibility of the
10 SMB Server to enforce the timeout requirements of the client.
11 This is untrue. The SMB Server cannot be expected to know
12 the requirements of the client. More importantly, if the
13 SMB server uses the SMB client timeout as a value to restrict
14 its behavior as an RX client, the performance characteristics
15 of the local SMB session would be used to prematurely terminate
16 WAN connections with significantly different performance
19 The timeout logic has therefore been modified in the following
21 . the Lan Manager Workstation (SMB) Session Timeout is used only
22 as a basis for configuring the Connection Dead Timeout
23 and Hard Dead Timeout values. The Connection Dead Timeout
24 must be at least 15 seconds longer than the SMB Timeout
25 and the Hard Dead Timeout must be at least double the
26 Connection Dead Timeout.
27 . New registry entries have been added to allow the Connection
28 Dead Timeout and Hard Dead Timeout values independent of the
29 Lan Manager Workstation Session Timeout
30 . The test to enforce the SMB Client Timeout has been removed.
32 One of the side-effects of removing the enforcement of the SMB
33 Client Timeout is that regardless of whether or not the SMB client
34 is available to receive the response (and how would the SMB server
35 know) the RX protocol response can be used to update the AFS
36 Client Service state for ready access by future SMB client
39 This should be the end of the "Server paused or restarting messages"
41 * Fix "fs mkmount" command to work with UNC paths and when
42 started from non-AFS drives
44 * Add support for arbitrary UNC paths to the pioctl() support.
45 This enables the fs commands as well as the AFS Shell Extension
46 to work correctly when UNC paths are being used.
48 * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
49 DNS if the cell configuration cannot be determined via CellServDB
51 * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
52 are ever set more than once at a time
54 * Fix the management of lists of cm_cell_t structures when using
55 DNS to lookup cell information. The previous code would fail to
56 reuse the same cellID for a cell if DNS was used more than once
57 for a given cell name. When the ttl expired, a single cm_cell_t
58 could be inserted into the cm_allCellsp list more than once
59 producing a loop. In addition, the vlServerp list belonging to
60 the cell was not freed resulting in improper refCounting of the
63 * Add DNS support to cm_IoctlNewCell() which previous only examined
66 * Add cm_FreeServer() function and call it from cm_FreeServerList()
67 to properly garbage collect cm_server_t objects
69 * Add numVCs variable to smb.c to track the number of smb_vc_t
70 objects created and use it to initialize the vcID field which
71 previously was set to 0 in all objects resulting in FindByID
74 * Fixed DNS lookups to work consistently throughout the OpenAFS
75 product instead of just from within the afsd_service.exe
77 * Added a runtime check to ensure that AFS Client Service SMB
78 Server is accepting connections before attempting to mount
81 * Read IP addresses for volume servers out of the CellServDB
82 file if gethostbyname() on the hostname fails.
84 * Fix getcellconfig() to populate both the Hostnames as well
85 as IP addresses when loading cell data via DNS
87 * Increase the Connection Dead Time to 50 from 20 seconds
88 Increase the Hard Dead Time to 120 from 40 seconds
89 (matches the Unix values)
91 * Fixed an assertion validating the number of allocated NCBs
93 * Fixed the build environment to consistently build for
94 Windows 2000 and above. (APPVER = 5.0)
96 * Fixed rx_debug to properly validate the receipt in incoming
97 data with select() and recvfrom(). Do not copy data out of
98 the socket buffer unless success is indicated.
101 * afsd_service.exe will now display a message box to the
102 desktop when it terminates due to an IP Address Change.
104 * installer no longer deletes AFS Server configuration data
107 * installer generates a warning dialog if the RPC service
108 is not properly configured
110 * installer compressed with lzma instead of bzip2
112 * afsd_service.exe shutdown crash solved once and for all
114 * reference counting of smb_vc_t data structures improved
116 * name space collision of smb_fid_t event objects corrected
118 * the output of "fs memdump" is now written to
119 %WINDIR%\TEMP\afsd_alloc.log
121 * the file TaAfsApp_1033.dll is now properly installed allowing
122 the User Manager to start
124 * a new algorithm is used for computing filename pattern matches
126 * afscreds.exe now accepts user names containing instance
129 * Fix the Directory Name Lookup Cache to be case-sensitive.
130 This is crucial in environments in which a Windows client
131 is accessing a directory with more than one filename that
132 differs only by case. If the directory contains "FOO"
133 and "Foo". You want "DEL Foo" to delete the correct one.
134 We still have a problem in that "DEL foo" will delete a
135 random filename. This will be addressed in a future release.
137 * Fix afscreds.exe -M option (renewMaps) to work when High
138 Security mode is off. Also, remember to disable the ActiveMap
139 flag in afsdsbmt.ini when a drive mapping is removed.
141 * Updates to NSIS installer script. AFS Server configuration
142 data will not be destroyed on un-install or re-install.
143 Use a better compression algorithm.
145 * afslogon.dll now uses KFW to obtain tokens when available
147 * afslogon.dll when given an all uppercase username will
148 attempt to authenticate with both the uppercase name
149 and an all lowercase variation
151 * DST modification removed. The fix appears to make things
152 worse after a reboot of the machine.
154 * fs.exe: added "cscpolicy" which is used to
155 change client side caching policy for AFS shares
157 Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs]
158 [-documents] [-disable] [-help]
160 * Several uninitialized variables have been initialized
162 * It is now possible to obtain tokens using cross realm
163 Kerberos within afscreds.exe:
165 user: jaltman@ATHENA.MIT.EDU
167 Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
168 will will in turn be used to obtain afs@DEMENTIA.ORG.
169 The resulting token will be stored with the display name
170 jaltman@ATHENA.MIT.EDU@dementia.org
172 * aklog.exe has been added to the client
174 Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]
175 [[-p | -path] pathname]
179 -d gives debugging information.
180 krb_realm is the kerberos realm of a cell.
181 pathname is the name of a directory to which you wish to authenticate.
182 -noprdb means don't try to determine AFS ID.
183 -5 or -4 selects whether to use Kerberos V or Kerberos IV.
184 (default is Kerberos V)
185 No commandline arguments means authenticate to the local cell.
188 * All of the resource files have been restructured to adhere to
189 a set of rules IBM implemented for loading string resources.
190 These rules had either been forgotten or were not discovered
191 by folks working on the OpenAFS sources. The end result was
192 memory corruption. This is primary item which was preventing
193 the AFS Server from working.
195 * Increased the size of the maximum ticket size stored in a token
196 from 344 bytes to 12,000. Increased the buffers used to convey
197 messages between the pioctl() caller and the SMB Server from
198 1000 bytes to 12,512. The code appeared to have been writing
199 above the top of the stack by quite a few number of bytes.
200 (The increased ticket size is necessary for the next item.)
202 * When obtaining AFS Tokens via KFW, krb524 is no longer required.
203 Instead the raw Kerberos 5 ticket is used in its entirety. This
204 is extremely important as it allows us to use pure Kerberos 5 KDCs
205 as the source of the AFS authentication. The use of up to 12,000 byte
206 tickets will allow tickets produced by all versions of Microsoft
207 Active Directory to be used.
208 - create a user account.
209 - designate it DES only
211 - specify its UPN to be "afs@realm"
212 - assign a SPN of "afs/cellname" to the UPN with setspn.exe
214 * Do not enforce the funky 8dot3 pattern matching rule that the first "."
215 is special when using long file names. (you must use "*.*" and not "*")
216 Instead only enforce it when performing 8dot3 searches.
218 * Fixed the DST problem with creation times being set one hour ahead
220 * Fixed the problem when using \\afs\cell-alias. For example,
221 \\afs\uncc instead of \\afs\uncc.edu. Do not a new cell struct
222 for the alias name; instead simply expand the name. One of the
223 symptoms of this problem was a loss of acquired tokens.
225 * Fixed the AFS Shell Extension. The Symbolic Link menu was empty
226 of strings. (Only English strings provided.)
228 * Fixed the installer to properly replace in use files.
230 * Fixed the build system to cleanup generated component version files
232 * The release build compiled with MSVC 6.0 compiler to avoid the
233 afsd_service.exe shutdown crash. This does not solve the problem
234 but simply avoids it for the time being.
238 * fix afslogon.dll to not corrupt memory when High Security mode
241 * fix afsd_service.exe to not attempt to restore the stack when
242 an exception occurs. (not safe in multi-threaded programs)
244 * fix uninstaller to properly remove the CRT and MFC DLLs
246 * remove a Message Box from afscreds.exe when getcellconfig()
247 fails on a kerberos realm which is not a cell
249 The following is a list of changes to the OpenAFS for Window client
252 * "fs setserverprefs" will leave afsd service deadlocked
254 * "vos listaddrs" will core dump
256 * installer sets the appropriate keys to support Integrated Logon
258 * installer disables the "Find Lana by Name" functionality as it
259 was causing headaches for many users
261 * fix the intermittent crash of the power management thread when
262 shutting down the AFS Client Service
264 * optimizes the obtain drive mount list functionality which is
265 executed every time the mount tab in afscreds.exe and afs_config.exe
266 are refreshed. (this happens a lot)
268 * fix the service shutdown logic. add the STOP_PENDING state
269 and do not accept additional service events after we declare
272 The following is a list of changes to the OpenAFS for Window client
275 * flexelint was run against the source tree and hundreds (perhaps
276 thousands) of corrections were applied to ensure prototypes
277 were in use; types were used consistently; variables were
278 initialized; unused variables were removed; etc.
280 * A wide variety of instrumentation was added including the
281 ability to produce a stack trace from within afsd_service.exe
284 * Dynamic configuration of the RDRtimeout value based upon the
285 LanMan Workstation Session Timeout
287 * The mount root no longer needs to be called "/afs". This
288 is now set by a registry value "MountRoot" within the key
289 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
291 * The cell list is now only read out of afsdcell.ini when the
292 file changes instead of each time a cell is resolved.
294 * Thread synchronization was added to cm_server.c and ktc_nt.c
296 * All calls to GlobalAlloc()/GlobalFree() were replaced with
297 calloc()/free(). The Global functions were needed on Windows 3.x
298 but have caused a variety of problems on the Win32 platforms.
299 Avoiding them is highly recommended by several Microsoft
300 Knowledgebase articles
302 * Support for Symbolic Links added to the AFS Shell Extension
304 * Added a registry value "OverlayEnabled" to determine if
305 Shell Extension Overlays should be enabled.
306 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
308 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
309 separate trees for checked and free builds. Build system supports
310 a custom directory src\WINNT\extra which can be used as a grafting
311 location of organization specific additions to the build tree.
313 * New installer built using NSIS 2.0.
315 * Named all kernel objects in order to allow them to be monitored
316 with tools such as SysInternals' ProcExp.exe.
318 * Introduced new EventLog framework for AFSD
320 * Introduced Power Management interface to AFSD for Standby and
321 Hibernate modes to allow cache to be flushed prior to network
324 * Utilize Win32 DNSQuery API instead of internal routines. This
325 allows DNS SRV queries to be sent to all current domain name
326 servers. Not just one specified in an INI file. DNS is now
329 * "NetbiosName" registry value may be used to specify a fixed
330 Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
331 when the loopback adapter is in use. If you need to use the
332 old notation with a loopback adapter installed specify a registry
335 "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
337 * Refactor all modules which depend on LAN Adapter and NetbiosName
338 determination in a new library: lanahelper.lib. This allows for
339 consistent behavior throughout the product.
341 * Move the afsd.log and afsd_init.log files to the directory specified
342 by the "TEMP" environment variable. This is usually %WINDIR%\TEMP
343 for services. Added the Date to the log entries.
345 * New registry value "RxMaxMTU" used to limit the size of the RX
346 packets sent by the AFS Client Service to the Server. In order
347 to enable OpenAFS to work across the Cisco IPSec VPN the packet
348 size must be restricted to 1264 or smaller. The latest NSIS
349 installer sets a value of 1260 by default.
351 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
352 packets. This is not needed in order to work across the Cisco
353 VPN but might be needed for other network environments. This
354 value is not set by the NSIS installer.
356 * New registry value "HideDotFiles" is used to apply the Hidden
357 attribute to files whose names begin with a '.'. This value
358 is set by the NSIS installer.
360 * New registry value "MaxMpxRequests" allows the maximum number
361 of multiplexed sessions to be configured at run time. This
362 value is not set by the NSIS installer. The default value is
365 * New registry value "MaxVCPerServer" allows the maxmimum number
366 of VCs per server to be configured at run time. This value is
367 not set by the NSIS installer. The default value is 100.
369 * New registry value "AllSubmount" allows the "all" submount to
370 be disabled by setting its value to 0x00.
372 * Allow cells names to be valid mount points
373 \\<netbiosName>\<cellname>
375 * Store the active state of drive mappings in order for afscreds.exe
376 to restore them upon startup
378 * Add exception handling to generate a Stack Trace to the afsd_init.log
379 file if one happens to occur.
381 * Add lots of logging to help detect the cause of invalid SMB packets
383 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
384 conversion of Kerberos 5 "afs" service tickets. Supports auto-
385 renewal of expiring tokens as long as afscreds.exe is running.
387 * New afscreds.exe command line options:
389 -M = renew drive maps
390 -N = ip address change detection
393 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client
394 determines whether or not MIT Kerberos for Windows should be used
395 to obtain tokens via Kerberos 5 tickets.
397 * New registry value "AfscredsShortcutParams" in
398 {HKCU,HKLM}SOFTWARE\OpenAFS\Client
399 determines the command line parameters to be specified when "fixing"
400 the AFS Shortcut in the user's startup folder.
402 * The "ShowTrayIcon" registry value has been moved from
403 HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
404 {HKCU,HKLM}SOFTWARE\OpenAFS\Client
406 * The <cell name> registry values used to store the token expiration
407 reminders have been moved from
408 HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
409 {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
411 * Obtain the Logon User Name from the Explorer key when available
413 * new text document doc\txt\winnotes\registry.txt lists all registry
414 values used by OpenAFS (excluding the AFS Server)
416 * BUG: rx_securityClass objects were not properly reference
417 counted and were never freed.
419 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
420 would be generated. The existence of a server does not imply
421 that it is not down. If all of the servers for a cell are down
422 return CM_ERROR_NOSUCHVOLUME instead. This prevents the Explorer
425 * BUG: the directory name lookup cache failed to free the entries
426 in the cache when the name cache entries cycled. The entries
427 in the cache would become dereferenced without being freed.
429 * BUG: fs setserverprefs could be executed without Administrator
432 * BUG: the number of allocated NCB objects (100) exceeded the number
433 which could actually be waited upon by the kernel (64). Any objects
434 which were utilized above the limit could never have event completions
437 * BUG: smb_username_t objects were not being reference counted and
438 were not properly freed.
440 * BUG: smb_tid_t objects could under unusual circumstances be freed
441 before they were no longer referenced.
443 * BUG: smb_fid_t object pointer were frequently used even when
444 their value could be NULL. They were not properly released and
445 therefore they were never freed.
447 * BUG: smb_packet_t data structures were not completely initialized
450 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
451 Denied" because that causes the Explorer Shell to try again until
452 access is obtained. Instead return "Remote Resources" which allows
453 the shell to move on and treat the error as transient.
455 * BUG: when initializing the NCBreturns structure, separate Event objects
456 were created for each NCB although a single Event object was supposed
459 * BUG: smb_dirSearch_t objects were not being properly referenced counted
462 * BUG: smb_tran2Packet_t objects were not being properly referenced
465 * BUG: directory path creation did not handle the case of multiple
466 directories requiring creation in one attempt
468 * BUG: SMB requests which required an Extended Response were ignored.
469 This prevented some files from being written to AFS volumes.
471 * BUG: character strings were being freed even after they were
472 inserted into in use data structures
474 * BUG: inconsistent usernames were used when High Security mode was
475 enabled. (there is still much to do in this area)
477 * BUG: pioctl() calls which require out of band RPC operations were
478 susceptible to race conditions when performed by multiple processes
480 * BUG: memory allocation and deallocation crossed instances of the
481 C Runtime Library producing memory leakage and corruption in
482 afscreds and the client configurator.