1 Since 1.4.1 rc4: 1.4.1 rc5 released (20 Jan 2006)
3 * Check access permissions to the file before the file is
6 * More improvements to the handling of SMB Virtual Circuits
7 when SMB sessions are closed.
9 * Correct a race condition introduced in rc4 that could result
10 in a crash of afsd_service.exe.
12 Since 1.4.1 rc3: 1.4.1 rc4 released (11 Jan 2006)
14 * Properly handle pre-mature SMB session closures.
15 File handles, tree connections, and user sessions are now
16 freed when the virtual circuit is closed.
18 * smb_username_t and smb_user_t objects are now properly reference
19 counted and freed as appropriate.
21 * disable to use of AFS file locks. Byte range locking is still
22 implemented but all locks are managed locally. This prevents
23 multiple processes from editing the same file on the same
24 machine but it does prevent multiple processes on separate
25 machines from modifying the file.
27 Since 1.4.1 rc2: 1.4.1 RC3 released (4 Jan 2006)
29 * A fix to "fs setserverprefs -vlserver". Multiple calls with
30 the same server parameter would result in a panic condition
31 if the server had not already been contacted by the AFS
34 * Better warnings are written to the afsd.log file when
35 the Windows RPC Protocols are not properly configured as
36 is often the case on Windows 2000.
38 * fix the procmgmt library to restore C RTL signal handlers when
39 it is being detached from the process prior to process termination.
41 Since 1.4.1 rc1: 1.4.1 RC2 released (30 Nov 2005)
43 * close a lock leak in the rx library that could be triggered while
46 * prevent removal of drive mappings in response to afscreds.exe -M
48 * add logic to process VNOVNODE in cm_Analyze. Force re-evaluation of symlink
49 strings and flush the stat cache entry.
51 * prevent server objects from being freed if user preferences are set.
53 * Update WIX support to 2.0.2419.0
55 * Release all locks on the server at service shutdown.
57 * A down server should be marked up as long as it responds to the client.
58 It doesn't matter if the server returned an error as long as the error
59 is something other than VRESTARTING. If there is such an error, all
60 connections on that server should be marked for replacement.
62 * Change the check "up" servers period from once per hour to once every
63 ten minutes. This matches the behavior of the Unix cache manager.
65 Post 1.4.0 revisions: 1.4.1 RC1 released (21 Oct 2005)
66 * Byte Range Locking support has been added. Architectural documentation
67 is located within src/WINNT/afsd/cm_vnodeops.c. Best efforts are
68 made to enforce Windows mandatory locking model using locally managed
69 byte range locks with full file locks obtained from the file server.
70 Read-only volumes provide the user with an implied locking privilege.
71 Read-write volumes require that a user be granted the locking privilege
72 in order for a lock to be obtained. As most Windows applications use
73 Shared file access modes, they require the ability to obtain locks in
74 order to access files.
76 * Implement error translation functions to convert Universal Error Codes
77 output by modern servers to local errno and winsock error values.
78 This fixes the error message problems using pioctl() calls from fs.exe
79 and the AFS Shell Extension.
81 Since 1.4.0 rc8: 1.4.0 final tagged (20 Oct 2005); released (31 Oct 2005)
82 * Allow the AFS Client Service to set the firewall configuration by
83 retrying until after Windows determines the boot period is over.
85 * Do not attempt to configure the firewall on Windows 2000, XP pre-SP2,
88 * Detect IP address changes from within the AFS Client Service for the
89 purpose of checking down servers sooner
91 * If the file server or vldb server report RXKADUNKNOWNKEY, return
92 SEC_E_NO_KERB_KEY to Windows. This provides an indication to the
93 user that there is a Kerberos key problem. Previously the user would
94 receive no feedback when there was something wrong.
96 * Fix the large integer library support to properly handle values greater
99 Since 1.4.0 rc7: 1.4.0 rc8 released (15 Oct 2005)
102 * Fixed file name pattern matching. Question marks can match nothing
103 if found at the end of a component.
105 Since 1.4.0 rc6: 1.4.0 rc7 released (8 Oct 2005)
106 * Kerberos 5 ticket lifetimes should adhere to KFW Leash lifetimes
108 * The MSI installer now has a new Product ID for each build. This
109 is to allow for automated upgrades. The Upgrade ID is remaining
112 * Volumes that were cached and then subsequently were salvaged,
113 moved or otherwise taken temporarily offline (as opposed to being
114 busy) would become unreachable. A distinction is now made between
115 a volume being offline and a server being down.
117 Since 1.4.0 rc5: 1.4.0 rc6 released (2 Oct 2005)
119 * Fixed several AFS Shell Extension issues:
120 - Checking Server Status would only work if a specific cell was
122 - If servers were down, the Server Down dialog would write to
123 invalid memory and cause explorer.exe to crash
124 - Default Push Buttons were not specified for many dialogs
125 - The extension would be unloaded by the Explorer Shell and
126 never be reloaded under some circumstances.
128 * Fixed the AFS System Tray menu to disappear if another Window
129 was selected before a menu item was selected
131 * Added volume owner and group information to "fs examine" output
133 * Added fs and registry support for enabling/disabling/clearing
134 rx statistics gathering.
136 Since 1.4.0 rc4: 1.4.0 rc5 released (25 Sep 2005)
138 * New Product Code GUIDs issues for 1.4 and 1.5 branches. Separate
139 GUIDs for each platform.
141 * Documentation directory structure and default installation rules
144 * New OpenAFS for Windows HTML Release Notes installed
145 as part of the documentation set.
147 * Add thread id to rx debugging messages
149 * When all servers are offline, return a bad network path error
150 immediately. This is necessary to allow Explorer to do the
151 right thing and not hang. The background daemon thread will
152 check the down servers every 30 seconds to see if they are
155 Since 1.4.0 rc3: 1.4.0 rc4 released (14 Sep 2005)
157 * The AFSCache file has been modified to store both the
158 serial number of the volume on which the file resides
159 and the SID of the local machine. If either change,
160 a new UUID is generated.
162 * add "fs flushall" command that forces all data buffers
165 Since 1.4.0 rc2: 1.4.0 rc3 released (4 Sep 2005)
167 * add support for '/' instead of '\' in pioctl() calls
169 * Apply AFS Client Admins group protect to AFS Shell Extension
171 * Add support for \\afs\<name> to most AFS Shell Extension
172 commands except the symlink methods.
174 * when installing the Microsoft Loopback Adapter, enable
175 MS Client for Networks and prevent an install failure
176 by not calling CoInitialize twice in the same thread.
178 * reload cell vldb values from the CellServDB every two
179 hours in case it changes
181 * When updating cell information from DNS, be sure to set
184 * Add support to allow use of \\AFS\<foo> where <foo> is
185 either a mount point or symlink. As <foo> is normally
186 treated as a share name, we transform it into \\AFS\all\<foo>
189 * Init 'code' to prevent false errors when integrated logon
190 is disabled and the service is not running
192 Since 1.4.0 rc1: 1.4.0 rc2 released (28 Aug 2005)
194 * Removed trace log messages that were hampering performance.
196 * Fixed a deadlock that was being triggered by editing Word
197 documents stored within AFS with WinWord 2003.
199 * Bit 3 of the TraceOption registry value is now used to set the
200 default for "fs trace" in the non-Debug builds. The new default
201 is off for release builds and on for debug builds.
203 * Bit 2 of the TraceOption registry value can be used to turn on
204 real-time output of debug log entries to the Windows Debug
205 Output monitor interface. This data can be viewed with tools
206 such as Sysinternal's DbgView.
208 Since 1.3.87: 1.4.0 rc1 released (17 Aug 2005)
209 * When the cache manager reports ALLBUSY or ALLOFFLINE for
210 a resource we should not be returning status codes such
211 as Network Busy or Remote Host Down because these errors
212 will imply that the AFS Client Service is Busy or Down
213 and that is simply not the case. Instead we will return
214 Bad Network Path as the path is temporarily not available.
216 Instead of returning Sharing Paused when there is a
217 timeout error, return Timeout. Once again, the AFS Client
218 Service is not paused.
220 * afscreds.exe would display an Obtain Creds dialog when
221 the expired credentials reminder was triggered even
222 if there was no network path to the KDC. This is prevented
223 by adding KDC probe logic to the reminder thread.
225 * afscreds.exe would display expired tokens no differently
226 than unexpired ones. This would make it difficult for the
227 user to distiguish when the tokens were expired. For the
228 English build added a new resource string "(expired) that
229 is displayed instead of the expiration time.
232 * "fs wscell" when executed in freelance mode will return the
233 name of the cell configured in the registry. The root.afs
234 volume is not loaded from this cell, but it is used for the
235 default for aklog and integrated login.
237 * "fs mkmount, fs rmmount, symlink make, symlink remove" will
238 no longer work on \\AFS\all when freelance is being used
239 unless the user is a member of the "AFS Client Admins" Windows
242 * some more checks performed during persistent cache validation.
245 * Optimize calls to cm_CheckServer from cm_Analyze. Only check
246 down servers for the current cell not all cells.
248 * If the scache LRU list becomes corrupted, the AFS Client Service
249 might enter an infinite loop at startup. Detect the corruption
250 and discard the cache contents in this case.
252 * Fixed the Explorer Shell's remove mountpoint functionality.
254 * Fixed a deadlock caused by the holder of cm_aclLock attempting to
255 obtain a mutex lock on a cm_scache_t object whose lock is held by
256 a thread attempting to obtain the cm_aclLock.
259 * Really fixed DNS AFSDB queries to ensure that "csail" cannot be
260 misinterpretted as "csail.mit.edu" when the resolver
261 is configured to append ".mit.edu" to failed DNS queries.
263 * Added a new registry key, "LogoffPreserveTokens" (see registry.txt),
264 that can be used to force the preservation of user tokens upon logout.
266 * Update the NSIS install scripts to use NSIS 2.07. This release adds
267 recommended installation categories: AFS Client, AFS Administrator,
268 AFS Server, AFS Development Kit. Each category includes a different
269 default subset of the OpenAFS components.
271 The OpenAFS logo is now associated with the NSIS uninstall entry
272 in the Add/Remove Programs control panel.
274 * The user name associated with AFS tokens when obtained with
275 integrated login, the afs systray tool, or aklog will always
276 include the full Kerberos 5 user principal name regardless of
277 whether or not the cell is local to the realm.
279 * Modify integrated login so that it does not enter an infinite
280 loop if the service is not set to auto start.
282 * Added asetkey.exe used to set a Kerberos 5 key for use by the
285 * Added uninstall.exe to Wix installation
287 * More modifications to algorithms used to wake sleeping threads.
291 * Changes to the algorithms used to wake threads when they are
292 put to sleep because of conflicts over buffer operations.
295 * The OpenAFS integrated logon obtains Kerberos 5 tickets as part of
296 the process of producing AFS tokens. The tokens are stored within
297 the AFS Client Service but the Kerberos 5 tickets have been discarded.
298 New functionality has been added to temporarily copy the tickets to
299 a file ccache during the short window between the NPLogonNotify and
300 WinLogon Logon Event. The Logon Event handler starts a process as
301 user, afscpcc.exe, that copies the tickets into the default ccache.
302 The file ccache is then destroyed by the event handler.
304 * During synchronization operations on stat cache entries, if threads
305 are forced to sleep it was possible that the threads would not be
306 woken under heavy load.
308 * Enforce the delete on close flag specified by the NTCreateX()
311 * A race condition in the rx library was fixed that resulted in
312 a deadlock in rx_NewCall when the RX_CONN_MAKECALL_WAITING flag
313 was cleared when threads were still waiting to use the
314 connection. Also, fixed a potential case in which the
315 connection could be destroyed while threads were waiting to use it.
317 * The DNLC freelist has been seen to become corrupted with still
318 active entries being stored on the freelist. Changes were made
319 to perform a better job of cleaning entries before placing them
320 onto the freelist; marking them with the correct magic value when
321 purging the list; and allowing the list to be purged on startup
322 if the cache validation fails.
324 * Windows Crash Reporting does not get triggered for afsd_service.exe
325 because it provides its own top level exception handler. This patch
326 places an explicit call to ReportCrash() on platforms which support
329 If you configure Crash Reporting via AD Policy to capture crash
330 reports within the domain, then you will receive this output.
332 * Generate MiniDumps independent of the Windows Crash Reporting.
334 (a) If an exception occurs,a minidump will be generated at the path
335 %TEMP%\afsd.dmp. The type of minidump defaults to Normal but
336 can be set to any other type via use of the
339 [HKLM\SOFTWARE\OpenAFS\Client] MiniDumpType (DWORD)
341 (b) MiniDumps can be generated at any time using the "fs minidump"
342 command. This allows you to generate a minidump without
343 stopping the process or even requiring the use of a debugger
346 * an RX connection which reports bad ticket now treats it the same way
347 the expired ticket is treated. The ticket is removed from the
348 connection and a new anonymous connection is established.
350 * fs memdump now requires that the caller be in the AFS Client Admins
353 * additional debugging information is provided in cm_Analyze when the
354 error code is ignored.
356 * Fix a regression introduced into the pioctl() client code which
357 will cause a crash in winlogon.exe, explorer.exe and fs.exe if
358 MIT KFW is not installed. (1.3.82a)
360 * Remove AFS Gateway option from OpenAFS Control Panel (1.3.82a)
363 * Fix a race condition in cm_EndCallbackGrantingCall() that
364 could leave 'nrevp' pointing to freed memory. In the process,
365 optimize the processing to ensure that the applications monitoring
366 the status of the stat cache entry are only notified at most
369 * Conditionalize access to the Explorer Shell AFS->Mount Point
370 ->Remove menu item. Disable the item if the selected item(s)
371 are not mount points.
373 * Activate AFS RPC (RX) Free Packet Queues stored in Thread
374 Local Storage. This eliminates thread contention on the
375 global RX free packet queue. This should improve performance
376 on multi-CPU systems.
378 * Fix the IP address filtering code to properly load/unload
379 the IPHelper DLL so that Windows XP/2003 and beyond systems
380 do not have to manually probe the registry.
382 * CleanupACLEnt() was not being called consistently with
383 the cm_scache_t object referred to by the back pointer
384 mutex locked. This could in very rare conditions lead to
385 an invalid memory access.
387 * Added a script command to the msi installer "afs_replace"
388 which can be used to replace one version of OpenAFS with
389 another without requiring an uninstall and reinstall if
390 the installed msi is no longer in its original location.
392 * Apparently the problem with multi-domain forests with cross-
393 realm trusts to non-Windows realms was not entirely solved.
394 The authentication to the AFS SMB service failed because
395 the wrong name was being used. Using ASU as an example,
396 the authentication was being performed with the name
397 "QAAD\user" (an account in the forest root) and not
398 "user@ASU.EDU (the MIT Kerberos principal used to login with)
400 The solution was to add an additional dependency on KFW
401 in order or to be able to easily obtain the client principal
402 name stored in the MSLSA ccache TGT. This information is
403 used in two locations:
405 - the pioctl() function
407 - a new WinLogon Event Handler for the "logon" event.
409 The pioctl function will now be able to use the correct
410 name when calling WNetAddConnection2() and the "logon"
411 event handler will now be able to call WNetAddConnection2().
412 The hope is that the "logon" event handler will be called
413 before the profile is loaded but I have not guarrantee
417 * Fixed a locking error in cm_TryBulkStat() which had the
418 potential of deadlocking the system for the length of time
419 it takes to perform a bulk status fetch operation.
421 * Replaced time conversion code (UnixTime <-> FILETIME) to
422 be completely arithmetic instead of relying on a bizarre
423 algorithm involving a variety of C RTL time functions.
424 This has the side effect that UnixTime and FILETIME which
425 are both stored in UTC are interpretted as UTC throughout
426 the year. Windows will apply the same localization to AFS
427 as it does to NTFS. Applications which rely on the ability
428 to sync files between the two file systems will no longer
429 see the timestamps of files in AFS change an hour relative
430 to the files stored in NTFS or Windows based backup devices.
432 * Fixed a invalid memory access under a bizarre circumstance.
433 Windows will allow a physical mass media device to be
434 installed via Plug N Play to the system and will assign it
435 the lowest available drive letter. This is true even if the
436 drive letter is currently assigned in the user session to
437 a network device via NET USE (or its equivalent.) When this
438 happens, queries sent to the CIFS server will contain invalid
439 data. This invalid data was not being caught by the AFS
440 Client Service and was resulting in a crash when Freelance
443 * Fixed a reference count error when registering callbacks
444 on a stat cache object if the callback was already registered
446 * Add a case to cm_Analyze() in order to handle the case where
447 cm_GetConnByMServers() returns CM_ERROR_NOSUCHVOLUME because
448 the server list for the volume is empty. In this case, force
449 an update of the volume info and retry.
451 * Insert a missing cm_EndCallbackGrantingCall() which could
452 result in threads waiting for a callback to complete to never
455 * In the persistent cache, there is a maximum number of volume
456 entries. Allow volume entries to be reused if the maximum
457 number have been allocated and their reference count is zero.
459 * If we already have a dead virtual connection object, don't
460 ignore the fact that additional dead vc objects must be taken
463 * Removed a deadlock condition introduced in the summer of 2004.
464 Do not hold mx locks around calls to RX functions including
465 rx_NewCall(). That is what reference counts on the rx_connection
468 * Fixed an initialization error in afslogon.dll which could
469 result in random behavior including a failure to terminate
470 the NPLogon function. (1.3.80b)
472 * Fixed an error preventing the use of SMB authentication
473 on Windows 2000. (1.3.80a)
476 * Updated CellServDB to Public CellServDB 16 Mar 2005
478 * Fixed DNS AFSDB queries to ensure that "csail" cannot be
479 misinterpretted as "csail.mit.edu" when the resolver
480 is configured to append ".mit.edu" to failed DNS queries.
482 * Fixed another case in which the client would replace connections
483 to the host when it was not necessary. In this case the
484 situation would occur if cryptall was on and the connections
485 were unauthenticated due to lack of an appropriate token.
487 * OpenAFS for Windows has failed to work at sites which are
488 utilizing a cross-realm trust between an MIT/Heimdal realm
489 and a multi-domain Windows forest when the workstation being
490 accessed is not located in the root domain. This is caused
491 by a bug in the workstation which was triggered after the
492 introduction of Windows 2003 Server. When the bug is triggered,
493 the workstation attempts to authenticate users to afsd_service.exe
494 by contacting the Domain Controller instead of using the
495 LSA loopback authentication mechanism.
497 One of the reasons this bug occurs is because the workstation
498 does not have a reliable way of knowing that the service whose
499 netbios name is "AFS" is located on the workstation. This will
500 be fixed starting in Longhorn Beta 1 by Microsoft. The
501 "BackConnectionHostNames" registry value will be used to
502 indicate that the authentications to that service name should
503 be performed using the loopback authentication mechanism.
505 In the meantime, when Logon Caching is enabled, we can force
506 afsd_service.exe to authenticate using the logon cache before
507 contacting the Domain Controller. This will work with both
508 password and smart card based logons.
510 * The allDown logic in cm_ConnByMServers() was wrong. The allDown
511 flag should not be cleared if a volume's server reference is
512 marked as "offline". In the case where all of the volume's
513 servers are either "down" or the volumes are "offline", we want
514 cm_Analyze() to process the condition as CM_ERROR_ALLOFFLINE
515 instead of as CM_ERROR_TIMEDOUT. In fact, CM_ERROR_TIMEDOUT
516 should never occur in practice.
518 In the case of CM_ERROR_ALLOFFLINE, cm_Analyze() will sleep for
519 5 seconds, clear the server down and volume busy flags, and
520 then force an update from the VLDB. This allows the client to
521 update the location of a volume if the reason for it being
522 marked offline is because it is being moved. Calls to
523 cm_ConnByMServers() will be retried either until success or
524 the RDRtimeout period is reached.
526 * Correct the Power Management code behavior in response to
527 Standby, Suspend, and Shutdown events. Instead of flushing the
528 buffers associated with the mounted SMB submounts, simply write
529 all buffers which are marked dirty.
531 * Added support for "TheseCells" to afslogon.dll. "TheseCells"
532 provides a list of cells other than the default cell for which
533 tokens should be obtained using the default Kerberos principal.
534 This functionality is logon domain specific and is only available
535 when using KFW for authentication.
537 * Fixed FindNext Invalid Handle error caused by over agressive
538 attempts at garbage collecting dirSearch entries when the
539 dirSearch ID wraps from the maximum value to 1.
541 * Add support for registry defined server preferences for VLDB and
542 File servers. See registry.txt for details.
544 * Increased default cache size to 96MB and default number of cache
547 * Fixed refCount leaks related to directory lookups and pioctl calls.
549 * Callbacks revoked during a race condition with an attempt to
550 obtain the same callback no longer result in an inaccessible
553 * New command line tool:
555 afsdacl : Set or reset the DACL to allow starting or stopping
556 the afsd service by any ordinary user.
558 Usage : afsdacl [-set | -reset] [-show]
560 -reset : Reset the DACL
561 -show : Show current DACL (SDSF)
563 * IP addresses are no longer queried once at startup. Instead IP
564 addresses are obtained as needed. Loopback adapter addresses are
565 no longer published to the server.
567 * Pay attention to the MIT KFW registry configuration for automatic
568 importation of MSLSA credentials. (SOFTWARE\MIT\Leash32,MsLsaImport)
570 * Fix (once again) case-sensitive comparisons which was apparently
573 * Activate support for vos listvol -format
575 * Population of the "AFS Client Admins" group failed on non-English
576 versions of Windows because the name of the "Administrators" group
577 is localized. Now we lookup the name of the group by using the
578 Administrators Group Alias Relative ID.
580 * Multiple cell token acquisition within afscreds.exe was broken in the
581 case of Kerberos 5 cross realm authentication. Instead of contacting
582 the KDC associated with the cell's realm, afscreds would obtain a
583 token from the KDC of the user's realm. This would result in
584 "invalid kvno errors" while authenticating to the AFS servers.
585 Unauthenticated access would work. The symptoms would vary based upon
586 whether or not the VLDB servers had been contacted using unauthenticated
587 connections prior to the user obtaining tokens.
589 * The list of ACL entries was becoming corrupted. It appears as if
590 an ACL when it expires was not being appropriately cleaned up. In
591 fact, it was left in the list of ACLs associated with the scache
594 * Changed the default @sys name list to "x86_win32 i386_w2k i386_nt40"
595 for 32-bit x86 systems. The default for itanium will be "ia64_win64"
596 and "amd64_win64" for amd 64-bit processors.
598 * When executing executables, Windows provides a mechanisms by which
599 the normal search for DLLs can be bypassed. If a file foo.exe is
600 being executed and there exists a file or directory "foo.exe.local"
601 (the contents are ignored if a file), then Windows will search for
602 DLLs first in the "foo.exe.local" directory and second in the
603 directory in which the "foo.exe" file is located.
605 Previous releases of OAFW would improperly return
606 STATUS_NOT_A_DIRECTORY instead of the expected
607 STATUS_OBJECT_PATH_NOT_FOUND. This would cause the Windows SMB client
608 to terminate the search for the DLL causing the execution of the
611 * Rework the reference counting of smb_vc_t objects. The references
612 stored in the waiting locks were not counted. This could result in
613 an assertion if the reference count drops to zero.
615 * "fs wscell" returns "Freelance.Local.Root" for the workstation cell
616 when running in freelance mode.
618 * Added support for persistent caching of file contents, stat entries,
619 volume data, cell data, and name lookup data. When the registry
620 value, "NonPersistentCaching", is not defined or set to 0 the file
621 specified by "CachePath" becomes a persistent cache file. The
622 size of the cache file is computed at run time. It has a maximum
623 size of approximately 1.2GB. The contents of the file will be
624 validated according to the rules specified by the "ValidateCache"
627 * Added support for UUIDs. UUIDs are kept for as long as the
628 cache file is intact.
630 * Added cmdebug.exe and support cache manager debugging callback
631 interfaces in afsd_service.exe.
633 Usage: cmdebug -servers <server machine> [-port <IP port>] [-long]
634 [-addrs] [-cache] [-help]
635 Where: -long print all info
636 -addrs print only host interfaces
637 -cache print only cache configuration
639 * Symlinks to \\AFS\[all\]... will now be treated the same as
640 symlinks to /afs/.... However, please use /afs/... as otherwise
641 the symlinks won't work on Unix.
643 * Correct a problem with local CellID allocation for cells whose
644 server list is obtained via DNS instead of a CellServDB file. If
645 the DNS information expires the CellID assigned to the entry will
646 be changed. This causes all of the cm_scache_t objects which refer
647 to the old cellID number to become useless. Attempts to access
648 files or directories with cm_scache_t objects using the old cellID
649 will fail since the server list cannot be obtained.
651 * Correct deadlock condition in cm_EndCallbackGrantingCall which can
652 be triggered if the volume referenced by the cm_scache_t object is
655 * The AFS Service needs to respond to SERVICE_ACCEPT_SHUTDOWN messages
656 in addition to SERVICE_ACCEPT_STOP.
658 * Move RPC shutdown until after the SMB and RX shutdown procedures
659 complete. Block until RPC shutdown is complete.
661 * Modify afslogon.dll (integrated logon) to wait for service if its
662 state is START_PENDING. If the timeout period occurs, reset to
663 the retry interval and not the sleep interval.
665 * When renewing the server list for a cell obtained via DNS AFSDB
666 records, the cm_cell_t entry must be removed from the list of all
667 cells. Otherwise, the list of cells will be corrupted.
669 * In the dcache and scache modules, use the cm_scache_t dataVersion
670 instead of the cm_fakeDirVersion.
672 * Synchronize fs.c with the unix version.
674 * The variable used to determine whether a file or virtual memory
675 mapped cache is used was not properly initialized to a default
676 value. If the registry setting "NonPersistentCaching" was not
677 set, the choice would be random. Properly initialized to be
680 * The memory mapped view was never unmapped before closing the file
681 at service shutdown. This is now properly cleaned up.
683 * Default location of Cache file is now %TEMP%\AFSCache
687 * A bug affecting new installations of 1.3.75/76 would result in
688 the creating of incorrect mountpoints in the freelance root.afs
689 volume for the default cell.
691 If "fs \\afs\all\<cellname>" lists a volume name of "root" instead
692 of "root.cell", you have been affected by the bug. To correct the
693 problem, execute the following commands:
695 fs rmmount \\afs\all\<cellname>
696 fs rmmount \\afs\all\.<cellname>
698 fs mkmount \\afs\all\<cellname> root.cell <cellname>
699 fs mkmount \\afs\all\.<cellname> root.cell <cellname> -rw
703 * A bug has been fixed in the auto-generation of Freelance root.afs
704 symlinks which produced random entries in the \\AFS\all directory.
706 * Support has been added for multi-homed servers
709 * Added a new registry value, "StoreAnsiFilenames", which can be used
710 to force the use of ANSI character sets instead of OEM Code Pages.
711 This feature is useful when users require the ability to create
712 filenames with 8-bit characters and need to access the files from
713 both Latin-1 based Unix systems as well as from Windows.
715 Activation of this feature will prevent access to files stored with
716 8-bit OEM characters.
718 * Shutdown all SMB threads in a synchronized manner when stopping the
721 * There is currently a maximum cache size of 1.3GB. The limit is imposed
722 by the largest contiguous block of unused memory within the 2GB process
723 space which can be assigned to the memory mapped file. Unfortunately,
724 when the executable digital signature verification code is activated
725 Windows sees fit to further segment the process memory which in turn
726 reduces the size of the maximum cache file to less then 800MB. If
727 larger cache sizes are desired, a new registry value should be set:
729 HKLM\SOFTWARE\OpenAFS\Client (DWORD) "VerifyServiceSignature" = 0x0
731 Setting this value will disable the runtime verification of digital
732 signatures on afsd_service.exe and the afs dlls which it loads. It
733 will not disable the the version number check on those same files.
734 The signature verification is not a security messure and is only meant
735 to enhance the ability to afsd_service.exe to detect potential
736 destablizing mixtures of DLLs from incompatible distributions.
738 Added code to auto-disable the signature verification check if
739 the desired cache size is greater then 700MB.
741 * Windows' WinTrustVerify(WIN_SPUB_ACTION_PUBLISHED_SOFTWARE) is
742 used to verify the validity of the afsd_service.exe binary
743 as well as each of the AFS DLLs loaded by the service. Not only
744 must the digital signature be valid but the signatures of the
745 DLL must be signed by the same entity as the service.
747 * Implement new functions: cm_freelanceMountPointExists and
748 cm_freelanceSymlinkExists. Use them along with other validity
749 checks in cm_freelanceAddMount and cm_freelanceAddSymlink to
750 ensure that name collisions do not occur and that empty strings
751 are not valid file names.
753 A symlink may not have a name which would resolve to a valid
754 cell name. Doing so would prevent access to the cell.
756 * Add missing cm_HoldSCacheNoLock call to Freelance mount point
757 re-initialization code. The reference counts of the fake root.afs
758 volume scache object(s) would become invalid when the mount point
759 or symlink lists were altered.
761 * Add registry entries to provide mappings from the afsdsbmt.ini
762 to the new locations for applications which count on the use
763 of the old Profile file APIs. These apps are likely to fail
764 if the user does not have administrator privileges and the
765 registry is locked down.
767 * The afs_config.exe submounts dialog had two errors.
768 First, attempts to remove entries failed because the registry
769 key was being opened without KEY_WRITE privileges.
770 Second, when editing a submount entry, changing the name
771 would add a new key and leave the original one in place.
772 Now the original submount will be removed if its name is
775 * In recent months there have been several incidents in which
776 users have experienced problems starting or accessing
777 afsd_service.exe and after significant effort has been spent
778 it has turned out that they have two versions of AFS on the
779 machine or an inconsistent set of DLLs.
781 Code has now been added to afsd_service.exe which will walk
782 the list of modules loaded by afsd_service.exe and validate
783 that the version of the AFS DLLs matches the version of the
784 afsd_service.exe executable. If they do not match the service
787 * When Freelance mode is enabled and there is no registry
788 key HKLM\SOFTWARE\OpenAFS\Client\Freelance, afsd_service.exe
789 will attempt to import the afs_freelance.ini file contents.
790 If the file does not exist, it was creating a dummy file
791 with a r/o and r/w entry for the default cell and then
792 importing those values.
794 This process has been changed. The temporary file is no
795 longer created. Also, both the OpenAFS Client install
796 directory as well as %WINDIR% are checked for previous
797 afs_freelance.ini files.
799 * Added support for VL_GetEntryByNameN(). Still need to add
800 support for VL_GetEntryByNameU() for multi-homed support.
802 * Fix a deadlock situation in afscreds.exe when canceling an
803 auto-generated Obtain Tokens dialog
806 * Fix the locking of objects during Directory Searches in the
807 SMB/CIFS server. The failure to properly lock the reference
808 counts was resulting in the premature freeing of smb_dirSearch_t
809 objects while they were still in use by the SMB/CIFS client.
810 This does not solve the "Invalid Handle" problem.
812 * Fix Find Cell By Name pioctl call to return a valid cell
813 name for the Freelance fake root.afs volume.
814 "Freelance.Local.Root".
816 * Fix the Explorer Shell Extension Symlinks->Add operation.
817 The dialog template was missing and the link destination
818 string was too short.
820 * Add support for symlinks to Freelance root.afs volume
821 Stored at HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks
822 <number> = "<linkname>:<relative-path>."
823 Use symlink.exe to create, list, or remove
825 * Remove the fallback to the use of KFW's KRB4 library when obtaining
826 tokens. We never obtain KRB4 tickets.
828 * Fix AFS Client Configuration Control Panel to support new SysName
831 * Fix a bug in afsd_service.exe which could result in the SysName
832 not being read from the registry.
835 * Add code to block the issuance of AFS tokens by aklog.exe or
836 afscreds.exe when the Kerberos 5 principal name contains a dot.
838 * Modify the IsAdmin() function to always treat the local SYSTEM
839 account as an AFS client administrator. Affects fs.exe and
842 * Modify the internal handling of Quota Exceeded errors
844 * Upgrade all reference count fields in the Windows cache manager
845 and the osi library to use unsigned long instead of signed short.
846 A similar fix has been applied to the afs rpc (rx) library.
848 * fix the Windows cache manager to prevent it from replacing the
849 rx_connection object associated with the cm_conn_t object on each
850 and every operation if "fs crypt" was set. This explains the
851 dramatic performance difference when crypt is used vs clear.
852 The problem: 'cryptall', a boolean flag indicating whether or not
853 "fs crypt" is set, was being compared to the rx_connection
854 cryptlevel which is either rxkad_clear:0 or rxkad_crypt:2.
855 1 != 2 and therefore the rx_connection was always destroyed
856 and replaced on each and every operation.
858 Lock the cm_conn_t object around every call to RXAFS_xxxx functions.
859 It is not safe for the cm_conn_t object to not be locked because
860 rx_DestroyConnection might be called from another thread if:
861 - the user's tokens have changed or expired
862 - the crypt mode has changed
864 This fix appears to have also taken care of the problems associated
865 with Overlapped Writes resulting in Delayed Write errors.
867 * fix NSIS installer's AdminGroup.exe to properly create and
868 remove groups when given -create or -remove. The string comparison
871 * fs sysname now accepts a list of sysname values
873 * added a new registry value HKLM\SOFTWARE\OpenAFS\Client "IoctlDebug"
874 DWORD which when set to a non-zero value will cause error message
875 text to be output to stderr from the pioctl() routine. Useful in
876 debugging failures of fs.exe, tokens.exe, etc.
878 * added a test to the power management code to only perform a
879 flush operation if there is at least one network adapter which
880 is not a loopback adapter.
882 * Fix bug in loading of registry value HKLM\SOFTWARE\OpenAFS\Client
883 "EnableKFW". This value will not be read if the key
884 HKCU\SOFTWARE\OpenAFS\Client exists; even if the "EnableKFW"
885 value under that key does not.
887 * provide mechanisms to force the use of krb524d for Kerberos 5
888 ticket to AFS token conversion. For afslogon.dll and afscreds.exe
889 there is a new registry value "Use524" and for aklog.exe a new
890 command line parameter "-m".
892 * Fix the pattern matching algorithm to properly match patterns
895 * smb_ReceiveCoreRename() was factored to produce smb_Rename()
896 which is used by both the original function and the new
897 smb_ReceiveNTRename(). smb_ReceiveNTRename() supports the
898 creation of HardLinks in addition to Renaming. smb_Link()
899 is a new function which creates HardLinks via cm_Link().
900 cm_Link() is a new vnodeops function which creates links
903 smb_ReceiveNTRename() does not support the File Copy and
904 Move Cluster Information operations described in its interface.
905 ReceiveNTRename is under documented in CIFS-TR-1p00_FINAL.pdf.
907 * When opening files via symlinks, we should follow the symlinks
908 until we reach the actual file stat cache entry. The stat cache
909 entry of the file should then be stored in the FID instead of
910 stat scache entry of the symlink.
912 * return bad operation errors for all unimplemented functions
913 even if we do not know the functions exist.
915 * Log bad packets and unknown operation packets to the trace log
917 * Map CM_ERROR_BADOP to STATUS_NOT_SUPPORTED instead of
920 * Update list of known CIFS operations to include all those listed
921 in CIFS-TR-1p00_FINAL.pdf.
923 * Modify the handling of HKLM\SOFTWARE\OpenAFS\Client\Submounts
924 to support the REG_EXPAND_SZ type.
927 * A new Windows authorization group "AFS Client Admins" is now
928 created and populated with the members of the "Administrators"
929 group. The group is used to determine which accounts on the
930 machine may be used to modify the AFS Client Configuration via
931 the UI and command line tools. afs_config.exe, fs.exe,
933 * Modify the WinLogon Logoff Event Handler to query NT4 domain
934 controllers for the remote profile path if Active Directory
935 services are not available.
937 * Fix aklog.exe to not add the AFS ID to the username
939 * PTS registration of new users to foreign cells has been added to
942 * The cm_Daemon thread is used to perform checks for
943 down servers, up servers, volumes, callback expirations,
944 lock maintenance and token expiration. Due to a gaff in
945 larger integer division the thread never performed any
946 work. Instead the current time computation would always
947 be less then the trigger times. This had an adverse affect
948 on the client's ability to maintain communication with servers,
949 keep volumes up to date, and flush user tokens and acls
950 when they have expired. This was broken when the 1.3 branch
951 was modified to support VC7 which no longer included
954 * An initialization problem with the Freelance code was
955 detected while fixing the callbackRequest. The cm_rootSCachep
956 object is obtained during afsd_InitDaemons() but the callback
957 information is incomplete. The callback information will not
958 be obtained until cm_MergeStatus is called from within
959 cm_GetCallback. Unfortunately, cm_SyncOp did not properly
960 test for the conditions under which the callback information
963 * Reports have been filed indicating that callbacks were
964 being lost. An examination of the code indicated that the
965 cm_server_t objects were not being properly reference
966 counted by the cm_scache_t and cm_callbackRequest_t objects.
967 In particular, the cm_server_t objects may have been freed
968 from beneath the cm_conn_t objects.
970 All of the reference counting is now done via the functions:
975 this improves the ability to track the referrals.
977 Each cm_BeginCallbackGranting Call now allocates a reference
978 to the cm_server_t. The cm_EndCallbackGrantingCall either
979 frees the reference or transfers it to the cm_scache_t
980 cbServerp field. These are then appropriately tracked
981 through the cm_Analyze call.
983 * Ensure that the dnlc hash table is the same size as the
984 dir name hash table (as per original author's note).
985 Increase the dnlc CM_AFSNCNAMESIZE to a multiple of 8
986 for compatibility with 64-bit systems.
988 * fix smb_ApplyV3DirListPatches to properly apply the hidden
989 attribute to dotfiles when the infoLevel < 0x101 and
990 cm_SyncOp has failed.
992 * Fix the Freelance registry initialization code. There
993 was a possibility that some systems could end up with
994 garbage in the registry during a clean install.
997 * file and directory names beginning with "." will now be given the
998 hidden attribute when the volume access is anonymous. this matches
999 the behavior when the volume access is via an authenticated user.
1001 * Added a change monitor to the HKLM\SOFTWARE\OpenAFS\Client\Freelance
1002 key. When a change occurs mark the root.afs data as invalid and
1003 for it to be reloaded on the next access. This allows administrators
1004 to modify the mount point list without restarting the service.
1006 The freelance client used to provide a fake modification time for
1007 the root.afs volume data and its mount points of 7/09/2001 14:24 EDT.
1008 Added code to extract the last modification time of the Freelance
1009 registry key and use that instead. The time now represents the
1010 most recent mount point change.
1012 * PTS registration of new users to foreign cells has been added to
1015 * Additional Cache Control and Credential Manager options have been
1016 added to the WiX installer. See deployment guide for details.
1018 * The CachePath setting is now optionally a REG_EXPAND_SZ type
1020 * The WiX installer has been upgraded. Version 2.0.1927.1 is now
1023 * The loopback installation code may have had a problem updating the
1024 %ETC%\HOSTS file which could have resulted in a premature failure.
1025 Work around code has been added for the case where the file cannot
1028 * The default max chunksize was increased from 15 (32K) to 17 (128K)
1029 because Windows sends 64K blocks when using overlapped writes.
1031 * The default number of server threads was increased from 4 to 25 to
1032 better handle overlapped writes.
1034 * The "AfscredsShortcutParams" registry value was not being properly
1035 loaded by afscreds.exe. Therefore, the default value was always being
1036 used instead of the value set by the installer.
1038 * Windows XP provides downgrade attack detection to prevent an attacker
1039 from being able to force the use of NTLM simply by disrupting
1040 communication with the KDC. This attack cannot exist between the
1041 Windows CIFS client and the AFS Client Service. Therefore, when a
1042 downgrade has been detected the afs pioctl library will force the
1043 establishment of a new CIFS connection using NTLM.
1045 * A locking error was discovered surrounding all references to volume
1046 server lists within the cm_cell.c source file.
1048 * The logged into Windows username was incorrect on Terminal Server
1051 * A new registry value "NonPersistentCaching" was added to the service
1052 parameters key. When set to a non-zero value, the afs cache is stored
1053 in the Windows paging file. There are two limitations to choosing
1055 1. when persistent caching is implemented it won't work with
1056 this flag set since there will be nothing to persist.
1057 2. with this flag set the initial paging allocation cannot be
1058 changed while the service is running
1060 * An initialization bug was discovered in aklog.exe which affected users
1061 who have a domain name for their afs servers which could not be mapped
1065 * afs_config.exe now validates cell names against DNS in addition
1066 to the CellServDB file.
1068 * In order to allow the freelance client to connect to a volume with ID
1069 equal to 1 on the default cell we changed the fake root.afs volume ID
1070 once again. This time we choose 0xFFFFFFFF. In addition, we change
1071 the cell ID of the fake root.afs volume from 1 to 0xFFFFFFFF as well.
1072 It will now be impossible for a volume ID to match that of another
1073 cell unless the client is connected to 0xFFFFFFFD cells. That should
1074 be enough room for growth.
1076 * Fix "fs mkmount" command to work with UNC paths and when
1077 started from non-AFS drives. It is now possible to create a mount
1078 point in the freelance fake root.afs volume with the command
1080 fs mkmount \\AFS\all\<directory-name> <volume-name> <cellname>
1084 fs mkmount \\AFS\all\openafs.org root.cell openafs.org
1085 fs mkmount \\AFS\all\.openafs.org root.cell openafs.org -rw
1087 * The algorithm used to re-attempt access to the servers associated with
1088 a volume has been altered to properly address the case in which all
1089 servers have been marked down. The previous algorithm did not reset
1090 the server's down flags so the servers were never actually retried.
1091 This caused a problem with active volumes if the network connectivity
1092 was lost as could be the case with a network cable removal, wireless
1093 drop, or laptop hibernation. With the fix volume access is restored
1094 almost instantenously when network connectivity becomes available.
1096 * Support for SMB/CIFS browsing has been added to the AFS Client Service
1097 SMB server. It is now possible to use "NET VIEW \\AFS" to obtain a
1098 listing of AFS submounts and freelance mount points. Support for
1099 NETSHAREENUM, NETSHAREGETINFO, NETSERVERENUM2, NETSERVERGETINFO
1100 significantly enhances the behavior of AFS volumes within the Explorer
1101 Shell. For instance, "AFS" now shows up as server in the Explorer
1102 with each submount or freelance mount point visible as a share.
1103 The right click menu in each folder now works with full functionality
1104 on a consistent basis.
1106 * The network provider can be configured to have different behavior
1107 depending on the domain that the user logs into. These settings are
1108 only relevant when using integrated login. A domain refers to an
1109 Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
1110 local machine (i.e. local account logins). The domain name that is
1111 used for selecting the domain would be the domain that is passed into
1112 the NPLogonNotify function of the network provider. (see registry.txt
1115 * Added a new registry value [HKCU\SOFTWARE\OpenAFS\Client]
1116 "Authentication Cell" which may be used to specify a default
1117 authentication cell for afscreds.exe which is different from
1118 the default cell for the AFS Client Service daemon.
1120 * Added a Logoff WinLogon Event Notification function to afslogon.dll.
1121 afslogon.dll moved to %WINDIR%\System32\.
1122 New registry entries added to register the dll for Winlogon events.
1124 The logoff event will now force a call to ktc_ForgetAllTokens()
1125 using the context of the user being logged off as long as the
1126 user's profile is not loaded from within AFS. If the profile
1127 was loaded from AFS we can't release the tokens since the Logoff
1128 event is triggered prior to the profile being written back to
1129 the its source location. This is now performed in an XP SP2
1132 * Windows XP SP2 Internet Connection Firewall interoperability
1135 * The %WINDIR%\afsdsbmt.ini contains four sections:
1136 Submounts, Drive Mappings, Active Maps and CSC Policies.
1137 The Submounts and CSC policies are now stored in the registry under
1138 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
1139 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
1140 The Drive Mappings and Active Maps are stored in the registry under
1141 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
1142 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
1144 There is no automatic migration of this data as it would be impossible
1145 to consistently migrate data to user profiles which may not be active
1146 when the machine is updated.
1148 * The %WINDIR%\afs_freelance.ini contains lists of mountpoints for the
1149 fake root.afs volume. For the same reasons as for the cellservdb file,
1150 this information should not be in %WINDIR%. This information is now
1151 kept under the registry key
1152 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
1154 The data from the afs_freelance.ini file will be automatically
1155 migrated to the registry on first execution of afsd_service.exe
1157 * Keeping the CellServDB file in the location %WINDIR%\afsdcell.ini is
1158 troublesome for several reasons. One, it is confusing for those who
1159 expect the file to be named "CellServDB" instead of "afsdcell.ini".
1160 Two, this file is not a Windows Profile formatted file. Three,
1161 applications should not be reading or writing to %WINDIR%. It causes
1162 problems for Windows Terminal Server.
1164 The new location of CellServDB will be the OpenAFS Client install
1165 directory which is by default C:\Program Files\OpenAFS\Client and can
1166 be determined by querying the registry for
1167 [HKLM\SOFTWARE\TransarcCorporation\AFS Client\CurrentVersion]PathName
1169 The existing afsdcell.ini will be migrated by the NSIS installer.
1170 The Wix installer must still be updated to do the same.
1172 * Change NSIS installer to use DNS by default; to remove Integrated Logon
1173 High Security mode; and to add Terminal Services compatibility registry
1174 entries to allow the OpenAFS tools to find the afsdcell.ini and other
1175 configuration files in %WINDIR%.
1177 * Add support for authenticated SMB connections. This will remove
1178 the need for high security mode in most situations. Both NTLM
1179 and Extended Security (GSS SPNEGO) modes are supported. Effectively,
1180 only NTLM can be used even though Kerberos is now supported. The
1181 reason is that it is not possible to construct a service principal
1182 which is unique to each individual machine.
1184 SMB Extended Auth does not work on XP SP2 unless one of two registry
1185 modifications are made:
1187 (1) To disable the check for matching host names on loopback connections
1188 set this key. This does not require a reboot:
1190 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa]
1191 "DisableLoopbackCheck"=dword:00000001
1193 (2) To add the AFS SMB/CIFS service name to an approved list. This
1194 does require a reboot:
1196 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0]
1197 "BackConnectionHostNames"=multi-sz "AFS" "MACHINE-AFS"
1199 afsd_service.exe will automatically add the current Netbios Name
1200 to the BackConnectionHostNames list and then temporarily disable
1201 the loopback check for one cycle of startup/shutdown of the service.
1202 We assume most folks do not start/stop without a reboot so this
1203 will be adequate in most cases.
1205 * Fix security hole in afslogon.dll which allowed passwords to be
1206 sent in clear text to the KDC in a misformed principal name.
1208 * Fix cm_GetCell() to properly handle expired dns entries
1211 * If Freelance mode is active and the afs_freelance.ini
1212 file does not exist, do not create an empty file.
1213 Instead create a file containing ro and rw mountpoints
1214 to the default cell using the standard conventions.
1216 * Modify the Freelance support to handle the ability
1217 to create rw mount points in the fake root.afs volume.
1219 * Changed the RPC mechanism used for token setting from
1220 named pipes to local. Use of named pipes can be restored
1221 by setting the environment variable AFS_RPC_PROTSEQ to
1224 Named pipes were required when a Windows 9x system was
1225 using a NT system in gateway mode which is incompatible
1226 with our use of local loopback adapters.
1228 * In afscreds.exe, if a username of the form user@REALM is
1229 specified and no password is specified, do not perform a
1230 kinit operation. Only perform the aklog functionality.
1232 * Add a new registry value which allows the number of processors
1233 on which afsd_service.exe executes to be restricted. Valid
1234 values are 1..numOfProcessors
1236 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
1240 * A second MSI based installer option is now available.
1242 * Fixed Kerberos 5 kinit functionality in afscreds.exe to properly
1243 request tickets for user/instance@REALM instead of just user@REALM
1245 * Modify the Power Management Notify routine to wait for the Hard Dead
1246 timeout period instead of a fixed 19 seconds. With the longer timeout
1247 periods Hibernation and Standby could never succeed when network
1248 connectivity is not available.
1250 * The following fs.exe commands are now restricted to Administrator:
1251 - checkservers with a non-zero timer value
1254 - sysname with a new sysname list
1263 setting the default sysname for a machine should be done via the
1264 registry and not via "fs sysname".
1266 * NSIS installer adds options to install Debugging Symbols
1267 and the Microsoft Loopback Adapter; the user is now also
1268 given the ability to select the afscreds.exe startup options.
1270 * Build system modified to generate symbols for FREE (aka RELEASE)
1271 builds as well as CHECKED (aka DEBUG) builds
1273 * Sites which have a volume ID of 0x20000001 assigned to their
1274 root.cell volumes have been experiencing problems with accessing
1275 the root.cell volume of their cell when Freelance mode has been
1276 active. This was because 0x20000001 was assigned to the fake
1277 root.afs volume created by freelance. The fake volume id is
1278 now set to 0x00000001 to prevent conflicts.
1280 * The timeout logic in the AFS Client Service has been wrong
1281 for sometime. It is based on two different assumptions.
1282 First, the SMB client timeout is a fix value as was the case
1283 with OS/2 Lan Manager. This assumption is incorrect. The
1284 SMB timeout in Windows is a dynamic value computed based upon
1285 a fixed minimum timeout to which is added time based upon the
1286 size of the request and the performance characteristics of
1287 the connection. Second, it is the responsibility of the
1288 SMB Server to enforce the timeout requirements of the client.
1289 This is untrue. The SMB Server cannot be expected to know
1290 the requirements of the client. More importantly, if the
1291 SMB server uses the SMB client timeout as a value to restrict
1292 its behavior as an RX client, the performance characteristics
1293 of the local SMB session would be used to prematurely terminate
1294 WAN connections with significantly different performance
1297 The timeout logic has therefore been modified in the following
1299 . the Lan Manager Workstation (SMB) Session Timeout is used only
1300 as a basis for configuring the Connection Dead Timeout
1301 and Hard Dead Timeout values. The Connection Dead Timeout
1302 must be at least 15 seconds longer than the SMB Timeout
1303 and the Hard Dead Timeout must be at least double the
1304 Connection Dead Timeout.
1305 . New registry entries have been added to allow the Connection
1306 Dead Timeout and Hard Dead Timeout values independent of the
1307 Lan Manager Workstation Session Timeout
1308 . The test to enforce the SMB Client Timeout has been removed.
1310 One of the side-effects of removing the enforcement of the SMB
1311 Client Timeout is that regardless of whether or not the SMB client
1312 is available to receive the response (and how would the SMB server
1313 know) the RX protocol response can be used to update the AFS
1314 Client Service state for ready access by future SMB client
1317 This should be the end of the "Server paused or restarting messages"
1319 * Add support for arbitrary UNC paths to the pioctl() support.
1320 This enables the fs commands as well as the AFS Shell Extension
1321 to work correctly when UNC paths are being used.
1323 * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
1324 DNS if the cell configuration cannot be determined via CellServDB
1326 * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
1327 are ever set more than once at a time
1329 * Fix the management of lists of cm_cell_t structures when using
1330 DNS to lookup cell information. The previous code would fail to
1331 reuse the same cellID for a cell if DNS was used more than once
1332 for a given cell name. When the ttl expired, a single cm_cell_t
1333 could be inserted into the cm_allCellsp list more than once
1334 producing a loop. In addition, the vlServerp list belonging to
1335 the cell was not freed resulting in improper refCounting of the
1338 * Add DNS support to cm_IoctlNewCell() which previous only examined
1341 * Add cm_FreeServer() function and call it from cm_FreeServerList()
1342 to properly garbage collect cm_server_t objects
1344 * Add numVCs variable to smb.c to track the number of smb_vc_t
1345 objects created and use it to initialize the vcID field which
1346 previously was set to 0 in all objects resulting in FindByID
1349 * Fixed DNS lookups to work consistently throughout the OpenAFS
1350 product instead of just from within the afsd_service.exe
1352 * Added a runtime check to ensure that AFS Client Service SMB
1353 Server is accepting connections before attempting to mount
1356 * Read IP addresses for volume servers out of the CellServDB
1357 file if gethostbyname() on the hostname fails.
1359 * Fix getcellconfig() to populate both the Hostnames as well
1360 as IP addresses when loading cell data via DNS
1362 * Increase the Connection Dead Time to 50 from 20 seconds
1363 Increase the Hard Dead Time to 120 from 40 seconds
1364 (matches the Unix values)
1366 * Fixed an assertion validating the number of allocated NCBs
1368 * Fixed the build environment to consistently build for
1369 Windows 2000 and above. (APPVER = 5.0)
1371 * Fixed rx_debug to properly validate the receipt in incoming
1372 data with select() and recvfrom(). Do not copy data out of
1373 the socket buffer unless success is indicated.
1376 * afsd_service.exe will now display a message box to the
1377 desktop when it terminates due to an IP Address Change.
1379 * installer no longer deletes AFS Server configuration data
1382 * installer generates a warning dialog if the RPC service
1383 is not properly configured
1385 * installer compressed with lzma instead of bzip2
1387 * afsd_service.exe shutdown crash solved once and for all
1389 * reference counting of smb_vc_t data structures improved
1391 * name space collision of smb_fid_t event objects corrected
1393 * the output of "fs memdump" is now written to
1394 %WINDIR%\TEMP\afsd_alloc.log
1396 * the file TaAfsApp_1033.dll is now properly installed allowing
1397 the User Manager to start
1399 * a new algorithm is used for computing filename pattern matches
1401 * afscreds.exe now accepts user names containing instance
1404 * Fix the Directory Name Lookup Cache to be case-sensitive.
1405 This is crucial in environments in which a Windows client
1406 is accessing a directory with more than one filename that
1407 differs only by case. If the directory contains "FOO"
1408 and "Foo". You want "DEL Foo" to delete the correct one.
1409 We still have a problem in that "DEL foo" will delete a
1410 random filename. This will be addressed in a future release.
1412 * Fix afscreds.exe -M option (renewMaps) to work when High
1413 Security mode is off. Also, remember to disable the ActiveMap
1414 flag in afsdsbmt.ini when a drive mapping is removed.
1416 * Updates to NSIS installer script. AFS Server configuration
1417 data will not be destroyed on un-install or re-install.
1418 Use a better compression algorithm.
1420 * afslogon.dll now uses KFW to obtain tokens when available
1422 * afslogon.dll when given an all uppercase username will
1423 attempt to authenticate with both the uppercase name
1424 and an all lowercase variation
1426 * DST modification removed. The fix appears to make things
1427 worse after a reboot of the machine.
1429 * fs.exe: added "cscpolicy" which is used to
1430 change client side caching policy for AFS shares
1432 Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs]
1433 [-documents] [-disable] [-help]
1435 * Several uninitialized variables have been initialized
1437 * It is now possible to obtain tokens using cross realm
1438 Kerberos within afscreds.exe:
1440 user: jaltman@ATHENA.MIT.EDU
1442 Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
1443 will will in turn be used to obtain afs@DEMENTIA.ORG.
1444 The resulting token will be stored with the display name
1445 jaltman@ATHENA.MIT.EDU@dementia.org
1447 * aklog.exe has been added to the client
1449 Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]
1450 [[-p | -path] pathname]
1454 -d gives debugging information.
1455 krb_realm is the kerberos realm of a cell.
1456 pathname is the name of a directory to which you wish to authenticate.
1457 -noprdb means don't try to determine AFS ID.
1458 -5 or -4 selects whether to use Kerberos V or Kerberos IV.
1459 (default is Kerberos V)
1460 No commandline arguments means authenticate to the local cell.
1463 * All of the resource files have been restructured to adhere to
1464 a set of rules IBM implemented for loading string resources.
1465 These rules had either been forgotten or were not discovered
1466 by folks working on the OpenAFS sources. The end result was
1467 memory corruption. This is primary item which was preventing
1468 the AFS Server from working.
1470 * Increased the size of the maximum ticket size stored in a token
1471 from 344 bytes to 12,000. Increased the buffers used to convey
1472 messages between the pioctl() caller and the SMB Server from
1473 1000 bytes to 12,512. The code appeared to have been writing
1474 above the top of the stack by quite a few number of bytes.
1475 (The increased ticket size is necessary for the next item.)
1477 * When obtaining AFS Tokens via KFW, krb524 is no longer required.
1478 Instead the raw Kerberos 5 ticket is used in its entirety. This
1479 is extremely important as it allows us to use pure Kerberos 5 KDCs
1480 as the source of the AFS authentication. The use of up to 12,000 byte
1481 tickets will allow tickets produced by all versions of Microsoft
1482 Active Directory to be used.
1483 - create a user account.
1484 - designate it DES only
1486 - specify its UPN to be "afs@realm"
1487 - assign a SPN of "afs/cellname" to the UPN with setspn.exe
1489 * Do not enforce the funky 8dot3 pattern matching rule that the first "."
1490 is special when using long file names. (you must use "*.*" and not "*")
1491 Instead only enforce it when performing 8dot3 searches.
1493 * Fixed the DST problem with creation times being set one hour ahead
1495 * Fixed the problem when using \\afs\cell-alias. For example,
1496 \\afs\uncc instead of \\afs\uncc.edu. Do not a new cell struct
1497 for the alias name; instead simply expand the name. One of the
1498 symptoms of this problem was a loss of acquired tokens.
1500 * Fixed the AFS Shell Extension. The Symbolic Link menu was empty
1501 of strings. (Only English strings provided.)
1503 * Fixed the installer to properly replace in use files.
1505 * Fixed the build system to cleanup generated component version files
1507 * The release build compiled with MSVC 6.0 compiler to avoid the
1508 afsd_service.exe shutdown crash. This does not solve the problem
1509 but simply avoids it for the time being.
1513 * fix afslogon.dll to not corrupt memory when High Security mode
1516 * fix afsd_service.exe to not attempt to restore the stack when
1517 an exception occurs. (not safe in multi-threaded programs)
1519 * fix uninstaller to properly remove the CRT and MFC DLLs
1521 * remove a Message Box from afscreds.exe when getcellconfig()
1522 fails on a kerberos realm which is not a cell
1524 The following is a list of changes to the OpenAFS for Window client
1527 * "fs setserverprefs" will leave afsd service deadlocked
1529 * "vos listaddrs" will core dump
1531 * installer sets the appropriate keys to support Integrated Logon
1533 * installer disables the "Find Lana by Name" functionality as it
1534 was causing headaches for many users
1536 * fix the intermittent crash of the power management thread when
1537 shutting down the AFS Client Service
1539 * optimizes the obtain drive mount list functionality which is
1540 executed every time the mount tab in afscreds.exe and afs_config.exe
1541 are refreshed. (this happens a lot)
1543 * fix the service shutdown logic. add the STOP_PENDING state
1544 and do not accept additional service events after we declare
1547 The following is a list of changes to the OpenAFS for Window client
1550 * flexelint was run against the source tree and hundreds (perhaps
1551 thousands) of corrections were applied to ensure prototypes
1552 were in use; types were used consistently; variables were
1553 initialized; unused variables were removed; etc.
1555 * A wide variety of instrumentation was added including the
1556 ability to produce a stack trace from within afsd_service.exe
1559 * Dynamic configuration of the RDRtimeout value based upon the
1560 LanMan Workstation Session Timeout
1562 * The mount root no longer needs to be called "/afs". This
1563 is now set by a registry value "MountRoot" within the key
1564 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
1566 * The cell list is now only read out of afsdcell.ini when the
1567 file changes instead of each time a cell is resolved.
1569 * Thread synchronization was added to cm_server.c and ktc_nt.c
1571 * All calls to GlobalAlloc()/GlobalFree() were replaced with
1572 calloc()/free(). The Global functions were needed on Windows 3.x
1573 but have caused a variety of problems on the Win32 platforms.
1574 Avoiding them is highly recommended by several Microsoft
1575 Knowledgebase articles
1577 * Support for Symbolic Links added to the AFS Shell Extension
1579 * Added a registry value "OverlayEnabled" to determine if
1580 Shell Extension Overlays should be enabled.
1581 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
1583 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
1584 separate trees for checked and free builds. Build system supports
1585 a custom directory src\WINNT\extra which can be used as a grafting
1586 location of organization specific additions to the build tree.
1588 * New installer built using NSIS 2.0.
1590 * Named all kernel objects in order to allow them to be monitored
1591 with tools such as SysInternals' ProcExp.exe.
1593 * Introduced new EventLog framework for AFSD
1595 * Introduced Power Management interface to AFSD for Standby and
1596 Hibernate modes to allow cache to be flushed prior to network
1599 * Utilize Win32 DNSQuery API instead of internal routines. This
1600 allows DNS SRV queries to be sent to all current domain name
1601 servers. Not just one specified in an INI file. DNS is now
1604 * "NetbiosName" registry value may be used to specify a fixed
1605 Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
1606 when the loopback adapter is in use. If you need to use the
1607 old notation with a loopback adapter installed specify a registry
1610 "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
1612 * Refactor all modules which depend on LAN Adapter and NetbiosName
1613 determination in a new library: lanahelper.lib. This allows for
1614 consistent behavior throughout the product.
1616 * Move the afsd.log and afsd_init.log files to the directory specified
1617 by the "TEMP" environment variable. This is usually %WINDIR%\TEMP
1618 for services. Added the Date to the log entries.
1620 * New registry value "RxMaxMTU" used to limit the size of the RX
1621 packets sent by the AFS Client Service to the Server. In order
1622 to enable OpenAFS to work across the Cisco IPSec VPN the packet
1623 size must be restricted to 1264 or smaller. The latest NSIS
1624 installer sets a value of 1260 by default.
1626 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
1627 packets. This is not needed in order to work across the Cisco
1628 VPN but might be needed for other network environments. This
1629 value is not set by the NSIS installer.
1631 * New registry value "HideDotFiles" is used to apply the Hidden
1632 attribute to files whose names begin with a '.'. This value
1633 is set by the NSIS installer.
1635 * New registry value "MaxMpxRequests" allows the maximum number
1636 of multiplexed sessions to be configured at run time. This
1637 value is not set by the NSIS installer. The default value is
1640 * New registry value "MaxVCPerServer" allows the maxmimum number
1641 of VCs per server to be configured at run time. This value is
1642 not set by the NSIS installer. The default value is 100.
1644 * New registry value "AllSubmount" allows the "all" submount to
1645 be disabled by setting its value to 0x00.
1647 * Allow cells names to be valid mount points
1648 \\<netbiosName>\<cellname>
1650 * Store the active state of drive mappings in order for afscreds.exe
1651 to restore them upon startup
1653 * Add exception handling to generate a Stack Trace to the afsd_init.log
1654 file if one happens to occur.
1656 * Add lots of logging to help detect the cause of invalid SMB packets
1658 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
1659 conversion of Kerberos 5 "afs" service tickets. Supports auto-
1660 renewal of expiring tokens as long as afscreds.exe is running.
1662 * New afscreds.exe command line options:
1664 -M = renew drive maps
1665 -N = ip address change detection
1668 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client
1669 determines whether or not MIT Kerberos for Windows should be used
1670 to obtain tokens via Kerberos 5 tickets.
1672 * New registry value "AfscredsShortcutParams" in
1673 {HKCU,HKLM}SOFTWARE\OpenAFS\Client
1674 determines the command line parameters to be specified when "fixing"
1675 the AFS Shortcut in the user's startup folder.
1677 * The "ShowTrayIcon" registry value has been moved from
1678 HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
1679 {HKCU,HKLM}SOFTWARE\OpenAFS\Client
1681 * The <cell name> registry values used to store the token expiration
1682 reminders have been moved from
1683 HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
1684 {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
1686 * Obtain the Logon User Name from the Explorer key when available
1688 * new text document doc\txt\winnotes\registry.txt lists all registry
1689 values used by OpenAFS (excluding the AFS Server)
1691 * BUG: rx_securityClass objects were not properly reference
1692 counted and were never freed.
1694 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
1695 would be generated. The existence of a server does not imply
1696 that it is not down. If all of the servers for a cell are down
1697 return CM_ERROR_NOSUCHVOLUME instead. This prevents the Explorer
1700 * BUG: the directory name lookup cache failed to free the entries
1701 in the cache when the name cache entries cycled. The entries
1702 in the cache would become dereferenced without being freed.
1704 * BUG: fs setserverprefs could be executed without Administrator
1707 * BUG: the number of allocated NCB objects (100) exceeded the number
1708 which could actually be waited upon by the kernel (64). Any objects
1709 which were utilized above the limit could never have event completions
1712 * BUG: smb_username_t objects were not being reference counted and
1713 were not properly freed.
1715 * BUG: smb_tid_t objects could under unusual circumstances be freed
1716 before they were no longer referenced.
1718 * BUG: smb_fid_t object pointer were frequently used even when
1719 their value could be NULL. They were not properly released and
1720 therefore they were never freed.
1722 * BUG: smb_packet_t data structures were not completely initialized
1725 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
1726 Denied" because that causes the Explorer Shell to try again until
1727 access is obtained. Instead return "Remote Resources" which allows
1728 the shell to move on and treat the error as transient.
1730 * BUG: when initializing the NCBreturns structure, separate Event objects
1731 were created for each NCB although a single Event object was supposed
1732 to be shared by all.
1734 * BUG: smb_dirSearch_t objects were not being properly referenced counted
1737 * BUG: smb_tran2Packet_t objects were not being properly referenced
1740 * BUG: directory path creation did not handle the case of multiple
1741 directories requiring creation in one attempt
1743 * BUG: SMB requests which required an Extended Response were ignored.
1744 This prevented some files from being written to AFS volumes.
1746 * BUG: character strings were being freed even after they were
1747 inserted into in use data structures
1749 * BUG: inconsistent usernames were used when High Security mode was
1750 enabled. (there is still much to do in this area)
1752 * BUG: pioctl() calls which require out of band RPC operations were
1753 susceptible to race conditions when performed by multiple processes
1755 * BUG: memory allocation and deallocation crossed instances of the
1756 C Runtime Library producing memory leakage and corruption in
1757 afscreds and the client configurator.