7d3151495a97c1f7e1bd9c19aa3845cc8a6f7f6f
[openafs.git] / doc / txt / winnotes / afs-changes-since-1.2.txt
1 Since 1.3.81:
2   * Added a script command to the msi installer "afs_replace"
3     which can be used to replace one version of OpenAFS with
4     another without requiring an uninstall and reinstall if
5     the installed msi is no longer in its original location.
6
7   * Apparently the problem with multi-domain forests with cross-
8     realm trusts to non-Windows realms was not entirely solved.
9     The authentication to the AFS SMB service failed because 
10     the wrong name was being used.  Using ASU as an example,
11     the authentication was being performed with the name
12     "QAAD\user" (an account in the forest root) and not 
13     "user@ASU.EDU (the MIT Kerberos principal used to login with)
14
15     The solution was to add an additional dependency on KFW
16     in order or to be able to easily obtain the client principal 
17     name stored in the MSLSA ccache TGT.  This information is 
18     used in two locations:  
19
20     - the pioctl() function 
21
22     - a new WinLogon Event Handler for the "logon" event.  
23
24     The pioctl function will now be able to use the correct
25     name when calling WNetAddConnection2() and the "logon"
26     event handler will now be able to call WNetAddConnection2().
27     The hope is that the "logon" event handler will be called 
28     before the profile is loaded but I have not guarrantee
29     that will happen. 
30
31 Since 1.3.80:
32   * Fixed a locking error in cm_TryBulkStat() which had the
33     potential of deadlocking the system for the length of time
34     it takes to perform a bulk status fetch operation.
35
36   * Replaced time conversion code (UnixTime <-> FILETIME) to 
37     be completely arithmetic instead of relying on a bizarre
38     algorithm involving a variety of C RTL time functions.
39     This has the side effect that UnixTime and FILETIME which
40     are both stored in UTC are interpretted as UTC throughout
41     the year.  Windows will apply the same localization to AFS
42     as it does to NTFS.  Applications which rely on the ability
43     to sync files between the two file systems will no longer
44     see the timestamps of files in AFS change an hour relative
45     to the files stored in NTFS or Windows based backup devices.
46
47   * Fixed a invalid memory access under a bizarre circumstance.
48     Windows will allow a physical mass media device to be 
49     installed via Plug N Play to the system and will assign it
50     the lowest available drive letter.  This is true even if the
51     drive letter is currently assigned in the user session to
52     a network device via NET USE (or its equivalent.)  When this
53     happens, queries sent to the CIFS server will contain invalid
54     data.  This invalid data was not being caught by the AFS 
55     Client Service and was resulting in a crash when Freelance
56     mode was in use.  
57
58   * Fixed a reference count error when registering callbacks
59     on a stat cache object if the callback was already registered
60
61   * Add a case to cm_Analyze() in order to handle the case where
62     cm_GetConnByMServers() returns CM_ERROR_NOSUCHVOLUME because
63     the server list for the volume is empty.  In this case, force
64     an update of the volume info and retry.
65
66   * Insert a missing cm_EndCallbackGrantingCall() which could
67     result in threads waiting for a callback to complete to never
68     be woken up.
69
70   * In the persistent cache, there is a maximum number of volume
71     entries.  Allow volume entries to be reused if the maximum
72     number have been allocated and their reference count is zero.
73
74   * If we already have a dead virtual connection object, don't 
75     ignore the fact that additional dead vc objects must be taken
76     care of.
77
78   * Removed a deadlock condition introduced in the summer of 2004.
79     Do not hold mx locks around calls to RX functions including
80     rx_NewCall().  That is what reference counts on the rx_connection
81     object are for.
82
83   * Fixed an initialization error in afslogon.dll which could
84     result in random behavior including a failure to terminate
85     the NPLogon function. (1.3.80b)
86
87   * Fixed an error preventing the use of SMB authentication
88     on Windows 2000.  (1.3.80a)
89
90 Since 1.3.77:
91   * Updated CellServDB to Public CellServDB 16 Mar 2005
92
93   * Fixed DNS AFSDB queries to ensure that "csail" cannot be
94     misinterpretted as "csail.mit.edu" when the resolver 
95     is configured to append ".mit.edu" to failed DNS queries.
96
97   * Fixed another case in which the client would replace connections
98     to the host when it was not necessary.  In this case the 
99     situation would occur if cryptall was on and the connections
100     were unauthenticated due to lack of an appropriate token.
101
102   * OpenAFS for Windows has failed to work at sites which are 
103     utilizing a cross-realm trust between an MIT/Heimdal realm
104     and a multi-domain Windows forest when the workstation being
105     accessed is not located in the root domain.  This is caused 
106     by a bug in the workstation which was triggered after the 
107     introduction of Windows 2003 Server.  When the bug is triggered,
108     the workstation attempts to authenticate users to afsd_service.exe
109     by contacting the Domain Controller instead of using the 
110     LSA loopback authentication mechanism.
111
112     One of the reasons this bug occurs is because the workstation    
113     does not have a reliable way of knowing that the service whose
114     netbios name is "AFS" is located on the workstation.  This will
115     be fixed starting in Longhorn Beta 1 by Microsoft.  The 
116     "BackConnectionHostNames" registry value will be used to 
117     indicate that the authentications to that service name should
118     be performed using the loopback authentication mechanism.
119
120     In the meantime, when Logon Caching is enabled, we can force
121     afsd_service.exe to authenticate using the logon cache before
122     contacting the Domain Controller.  This will work with both
123     password and smart card based logons.  
124
125   * The allDown logic in cm_ConnByMServers() was wrong.  The allDown
126     flag should not be cleared if a volume's server reference is 
127     marked as "offline".  In the case where all of the volume's 
128     servers are either "down" or the volumes are "offline", we want
129     cm_Analyze() to process the condition as CM_ERROR_ALLOFFLINE
130     instead of as CM_ERROR_TIMEDOUT.  In fact, CM_ERROR_TIMEDOUT
131     should never occur in practice.
132
133     In the case of CM_ERROR_ALLOFFLINE, cm_Analyze() will sleep for
134     5 seconds, clear the server down and volume busy flags, and 
135     then force an update from the VLDB.  This allows the client to 
136     update the location of a volume if the reason for it being 
137     marked offline is because it is being moved.  Calls to 
138     cm_ConnByMServers() will be retried either until success or
139     the RDRtimeout period is reached.
140
141   * Correct the Power Management code behavior in response to 
142     Standby, Suspend, and Shutdown events.  Instead of flushing the
143     buffers associated with the mounted SMB submounts, simply write
144     all buffers which are marked dirty.
145
146   * Added support for "TheseCells" to afslogon.dll.  "TheseCells"
147     provides a list of cells other than the default cell for which
148     tokens should be obtained using the default Kerberos principal.
149     This functionality is logon domain specific and is only available
150     when using KFW for authentication.
151
152   * Fixed FindNext Invalid Handle error caused by over agressive 
153     attempts at garbage collecting dirSearch entries when the 
154     dirSearch ID wraps from the maximum value to 1.
155
156   * Add support for registry defined server preferences for VLDB and 
157     File servers.  See registry.txt for details.
158
159   * Increased default cache size to 96MB and default number of cache
160     entries to 10,000.
161
162   * Fixed refCount leaks related to directory lookups and pioctl calls.
163
164   * Callbacks revoked during a race condition with an attempt to 
165     obtain the same callback no longer result in an inaccessible
166     stat cache entry.
167
168   * New command line tool:
169
170         afsdacl : Set or reset the DACL to allow starting or stopping
171              the afsd service by any ordinary user.
172
173         Usage : afsdacl [-set | -reset] [-show]
174               -set   : Sets the DACL
175               -reset : Reset the DACL
176               -show  : Show current DACL (SDSF)
177
178   * IP addresses are no longer queried once at startup.  Instead IP
179     addresses are obtained as needed.   Loopback adapter addresses are
180     no longer published to the server.
181
182   * Pay attention to the MIT KFW registry configuration for automatic
183     importation of MSLSA credentials. (SOFTWARE\MIT\Leash32,MsLsaImport)
184
185   * Fix (once again) case-sensitive comparisons which was apparently 
186     broken in 1.3.72.
187
188   * Activate support for vos listvol -format
189
190   * Population of the "AFS Client Admins" group failed on non-English
191     versions of Windows because the name of the "Administrators" group
192     is localized.  Now we lookup the name of the group by using the
193     Administrators Group Alias Relative ID.
194
195   * Multiple cell token acquisition within afscreds.exe was broken in the 
196     case of Kerberos 5 cross realm authentication.  Instead of contacting
197     the KDC associated with the cell's realm, afscreds would obtain a 
198     token from the KDC of the user's realm.  This would result in
199     "invalid kvno errors" while authenticating to the AFS servers.  
200     Unauthenticated access would work.  The symptoms would vary based upon
201     whether or not the VLDB servers had been contacted using unauthenticated
202     connections prior to the user obtaining tokens.
203
204   * The list of ACL entries was becoming corrupted.  It appears as if 
205     an ACL when it expires was not being appropriately cleaned up.  In
206     fact, it was left in the list of ACLs associated with the scache 
207     entry.
208
209   * Changed the default @sys name list to "x86_win32 i386_w2k i386_nt40"
210     for 32-bit x86 systems.  The default for itanium will be "ia64_win64"
211     and "amd64_win64" for amd 64-bit processors.
212
213   * When executing executables, Windows provides a mechanisms by which
214     the normal search for DLLs can be bypassed.  If a file foo.exe is
215     being executed and there exists a file or directory "foo.exe.local" 
216     (the contents are ignored if a file), then Windows will search for
217     DLLs first in the "foo.exe.local" directory and second in the 
218     directory in which the "foo.exe" file is located.  
219
220     Previous releases of OAFW would improperly return 
221     STATUS_NOT_A_DIRECTORY instead of the expected 
222     STATUS_OBJECT_PATH_NOT_FOUND.  This would cause the Windows SMB client
223     to terminate the search for the DLL causing the execution of the 
224     application to fail.
225
226   * Rework the reference counting of smb_vc_t objects.  The references  
227     stored in the waiting locks were not counted.  This could result in
228     an assertion if the reference count drops to zero.
229
230   * "fs wscell" returns "Freelance.Local.Root" for the workstation cell
231     when running in freelance mode.
232
233   * Added support for persistent caching of file contents, stat entries,
234     volume data, cell data, and name lookup data.  When the registry 
235     value, "NonPersistentCaching", is not defined or set to 0 the file 
236     specified by "CachePath" becomes a persistent cache file.   The 
237     size of the cache file is computed at run time.  It has a maximum
238     size of approximately 1.2GB.  The contents of the file will be 
239     validated according to the rules specified by the "ValidateCache"
240     registry value.  
241
242   * Added support for UUIDs.  UUIDs are kept for as long as the 
243     cache file is intact.
244
245   * Added cmdebug.exe and support cache manager debugging callback 
246     interfaces in afsd_service.exe.
247
248     Usage: cmdebug -servers <server machine> [-port <IP port>] [-long] 
249                    [-addrs] [-cache] [-help]
250     Where: -long   print all info
251            -addrs  print only host interfaces
252            -cache  print only cache configuration
253
254   * Symlinks to \\AFS\[all\]... will now be treated the same as 
255     symlinks to /afs/....   However, please use /afs/... as otherwise
256     the symlinks won't work on Unix.
257   
258   * Correct a problem with local CellID allocation for cells whose 
259     server list is obtained via DNS instead of a CellServDB file.  If
260     the DNS information expires the CellID assigned to the entry will
261     be changed.  This causes all of the cm_scache_t objects which refer
262     to the old cellID number to become useless.  Attempts to access 
263     files or directories with cm_scache_t objects using the old cellID
264     will fail since the server list cannot be obtained.
265
266   * Correct deadlock condition in cm_EndCallbackGrantingCall which can
267     be triggered if the volume referenced by the cm_scache_t object is
268     offline.
269
270   * The AFS Service needs to respond to SERVICE_ACCEPT_SHUTDOWN messages
271     in addition to SERVICE_ACCEPT_STOP.
272
273   * Move RPC shutdown until after the SMB and RX shutdown procedures 
274     complete.  Block until RPC shutdown is complete.
275
276   * Modify afslogon.dll (integrated logon) to wait for service if its
277     state is START_PENDING.  If the timeout period occurs, reset to 
278     the retry interval and not the sleep interval.
279
280   * When renewing the server list for a cell obtained via DNS AFSDB
281     records, the cm_cell_t entry must be removed from the list of all 
282     cells.  Otherwise, the list of cells will be corrupted.
283  
284   * In the dcache and scache modules, use the cm_scache_t dataVersion
285     instead of the cm_fakeDirVersion.  
286
287   * Synchronize fs.c with the unix version.
288
289   * The variable used to determine whether a file or virtual memory
290     mapped cache is used was not properly initialized to a default
291     value. If the registry setting "NonPersistentCaching" was not
292     set, the choice would be random.   Properly initialized to be
293     "file".
294
295   * The memory mapped view was never unmapped before closing the file
296     at service shutdown.  This is now properly cleaned up.
297
298   * Default location of Cache file is now %TEMP%\AFSCache
299
300 Since 1.3.76:
301
302   * A bug affecting new installations of 1.3.75/76 would result in
303     the creating of incorrect mountpoints in the freelance root.afs 
304     volume for the default cell.
305
306     If "fs \\afs\all\<cellname>" lists a volume name of "root" instead
307     of "root.cell", you have been affected by the bug.  To correct the
308     problem, execute the following commands:
309
310           fs rmmount \\afs\all\<cellname>
311           fs rmmount \\afs\all\.<cellname>
312         
313           fs mkmount \\afs\all\<cellname> root.cell <cellname>
314           fs mkmount \\afs\all\.<cellname> root.cell <cellname> -rw
315
316 Since 1.3.75:
317
318   * A bug has been fixed in the auto-generation of Freelance root.afs
319     symlinks which produced random entries in the \\AFS\all directory.
320
321   * Support has been added for multi-homed servers
322
323 Since 1.3.74:
324   * Added a new registry value, "StoreAnsiFilenames", which can be used
325     to force the use of ANSI character sets instead of OEM Code Pages.
326     This feature is useful when users require the ability to create 
327     filenames with 8-bit characters and need to access the files from
328     both Latin-1 based Unix systems as well as from Windows.
329
330     Activation of this feature will prevent access to files stored with
331     8-bit OEM characters.
332
333   * Shutdown all SMB threads in a synchronized manner when stopping the 
334     service.
335  
336   * There is currently a maximum cache size of 1.3GB.  The limit is imposed
337     by the largest contiguous block of unused memory within the 2GB process
338     space which can be assigned to the memory mapped file.  Unfortunately,
339     when the executable digital signature verification code is activated
340     Windows sees fit to further segment the process memory which in turn
341     reduces the size of the maximum cache file to less then 800MB.  If
342     larger cache sizes are desired, a new registry value should be set:
343
344       HKLM\SOFTWARE\OpenAFS\Client (DWORD) "VerifyServiceSignature" = 0x0
345
346     Setting this value will disable the runtime verification of digital
347     signatures on afsd_service.exe and the afs dlls which it loads.  It
348     will not disable the the version number check on those same files.
349     The signature verification is not a security messure and is only meant
350     to enhance the ability to afsd_service.exe to detect potential
351     destablizing mixtures of DLLs from incompatible distributions.
352
353     Added code to auto-disable the signature verification check if 
354     the desired cache size is greater then 700MB.
355
356   * Windows' WinTrustVerify(WIN_SPUB_ACTION_PUBLISHED_SOFTWARE) is 
357     used to verify the validity of the afsd_service.exe binary 
358     as well as each of the AFS DLLs loaded by the service.  Not only
359     must the digital signature be valid but the signatures of the 
360     DLL must be signed by the same entity as the service.
361
362   * Implement new functions: cm_freelanceMountPointExists and
363     cm_freelanceSymlinkExists.  Use them along with other validity
364     checks in cm_freelanceAddMount and cm_freelanceAddSymlink to
365     ensure that name collisions do not occur and that empty strings
366     are not valid file names.
367
368     A symlink may not have a name which would resolve to a valid 
369     cell name.  Doing so would prevent access to the cell.
370
371   * Add missing cm_HoldSCacheNoLock call to Freelance mount point
372     re-initialization code.  The reference counts of the fake root.afs
373     volume scache object(s) would become invalid when the mount point
374     or symlink lists were altered.
375
376   * Add registry entries to provide mappings from the afsdsbmt.ini
377     to the new locations for applications which count on the use
378     of the old Profile file APIs.  These apps are likely to fail
379     if the user does not have administrator privileges and the 
380     registry is locked down.
381
382   * The afs_config.exe submounts dialog had two errors.  
383     First, attempts to remove entries failed because the registry
384     key was being opened without KEY_WRITE privileges.  
385     Second, when editing a submount entry, changing the name
386     would add a new key and leave the original one in place. 
387     Now the original submount will be removed if its name is 
388     changed.
389
390   * In recent months there have been several incidents in which
391     users have experienced problems starting or accessing 
392     afsd_service.exe and after significant effort has been spent
393     it has turned out that they have two versions of AFS on the
394     machine or an inconsistent set of DLLs.  
395
396     Code has now been added to afsd_service.exe which will walk
397     the list of modules loaded by afsd_service.exe and validate
398     that the version of the AFS DLLs matches the version of the
399     afsd_service.exe executable.  If they do not match the service
400     will not start.  
401
402   * When Freelance mode is enabled and there is no registry
403     key HKLM\SOFTWARE\OpenAFS\Client\Freelance, afsd_service.exe
404     will attempt to import the afs_freelance.ini file contents.
405     If the file does not exist, it was creating a dummy file
406     with a r/o and r/w entry for the default cell and then
407     importing those values.
408
409     This process has been changed.  The temporary file is no
410     longer created.   Also, both the OpenAFS Client install
411     directory as well as %WINDIR% are checked for previous
412     afs_freelance.ini files.
413
414   * Added support for VL_GetEntryByNameN().  Still need to add
415     support for VL_GetEntryByNameU() for multi-homed support.
416
417   * Fix a deadlock situation in afscreds.exe when canceling an
418     auto-generated Obtain Tokens dialog
419
420 Since 1.3.72/73:
421   * Fix the locking of objects during Directory Searches in the
422     SMB/CIFS server.  The failure to properly lock the reference 
423     counts was resulting in the premature freeing of smb_dirSearch_t 
424     objects while they were still in use by the SMB/CIFS client.
425     This does not solve the "Invalid Handle" problem.
426
427   * Fix Find Cell By Name pioctl call to return a valid cell
428     name for the Freelance fake root.afs volume.  
429     "Freelance.Local.Root".
430
431   * Fix the Explorer Shell Extension Symlinks->Add operation.
432     The dialog template was missing and the link destination
433     string was too short.
434
435   * Add support for symlinks to Freelance root.afs volume
436     Stored at HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks
437        <number>  =  "<linkname>:<relative-path>."
438     Use symlink.exe to create, list, or remove
439
440   * Remove the fallback to the use of KFW's KRB4 library when obtaining
441     tokens.  We never obtain KRB4 tickets.
442
443   * Fix AFS Client Configuration Control Panel to support new SysName
444     protocol.
445
446   * Fix a bug in afsd_service.exe which could result in the SysName
447     not being read from the registry.
448
449 Since 1.3.71:
450   * Add code to block the issuance of AFS tokens by aklog.exe or
451     afscreds.exe when the Kerberos 5 principal name contains a dot.
452
453   * Modify the IsAdmin() function to always treat the local SYSTEM
454     account as an AFS client administrator.  Affects fs.exe and 
455     afs_config.exe.
456
457   * Modify the internal handling of Quota Exceeded errors
458
459   * Upgrade all reference count fields in the Windows cache manager
460     and the osi library to use unsigned long instead of signed short.
461     A similar fix has been applied to the afs rpc (rx) library.
462
463   * fix the Windows cache manager to prevent it from replacing the 
464     rx_connection object associated with the cm_conn_t object on each
465     and every operation if "fs crypt" was set.  This explains the 
466     dramatic performance difference when crypt is used vs clear.
467     The problem: 'cryptall', a boolean flag indicating whether or not 
468     "fs crypt" is set, was being compared to the rx_connection 
469     cryptlevel which is either rxkad_clear:0 or rxkad_crypt:2.
470     1 != 2 and therefore the rx_connection was always destroyed 
471     and replaced on each and every operation.
472
473     Lock the cm_conn_t object around every call to RXAFS_xxxx functions.
474     It is not safe for the cm_conn_t object to not be locked because
475     rx_DestroyConnection might be called from another thread if:
476         - the user's tokens have changed or expired
477         - the crypt mode has changed
478
479     This fix appears to have also taken care of the problems associated
480     with Overlapped Writes resulting in Delayed Write errors.
481
482   * fix NSIS installer's AdminGroup.exe to properly create and
483     remove groups when given -create or -remove.  The string comparison
484     test was wrong.
485
486   * fs sysname now accepts a list of sysname values 
487
488   * added a new registry value HKLM\SOFTWARE\OpenAFS\Client "IoctlDebug"
489     DWORD which when set to a non-zero value will cause error message
490     text to be output to stderr from the pioctl() routine.  Useful in 
491     debugging failures of fs.exe, tokens.exe, etc.
492
493   * added a test to the power management code to only perform a 
494     flush operation if there is at least one network adapter which
495     is not a loopback adapter.
496
497   * Fix bug in loading of registry value HKLM\SOFTWARE\OpenAFS\Client
498     "EnableKFW".  This value will not be read if the key
499     HKCU\SOFTWARE\OpenAFS\Client exists; even if the "EnableKFW" 
500     value under that key does not.
501
502   * provide mechanisms to force the use of krb524d for Kerberos 5
503     ticket to AFS token conversion.  For afslogon.dll and afscreds.exe
504     there is a new registry value "Use524" and for aklog.exe a new
505     command line parameter "-m".
506
507   * Fix the pattern matching algorithm to properly match patterns
508     ending with a '*'.
509
510   * smb_ReceiveCoreRename() was factored to produce smb_Rename()
511     which is used by both the original function and the new
512     smb_ReceiveNTRename().  smb_ReceiveNTRename() supports the
513     creation of HardLinks in addition to Renaming.  smb_Link() 
514     is a new function which creates HardLinks via cm_Link().
515     cm_Link() is a new vnodeops function which creates links
516     using RXAFS_Link().
517
518     smb_ReceiveNTRename() does not support the File Copy and 
519     Move Cluster Information operations described in its interface.
520     ReceiveNTRename is under documented in CIFS-TR-1p00_FINAL.pdf.
521
522   * When opening files via symlinks, we should follow the symlinks
523     until we reach the actual file stat cache entry.  The stat cache
524     entry of the file should then be stored in the FID instead of
525     stat scache entry of the symlink.
526
527   * return bad operation errors for all unimplemented functions
528     even if we do not know the functions exist.
529
530   * Log bad packets and unknown operation packets to the trace log
531
532   * Map CM_ERROR_BADOP to STATUS_NOT_SUPPORTED instead of 
533     0xC09820FF
534   
535   * Update list of known CIFS operations to include all those listed
536     in CIFS-TR-1p00_FINAL.pdf.
537
538   * Modify the handling of HKLM\SOFTWARE\OpenAFS\Client\Submounts
539     to support the REG_EXPAND_SZ type.
540
541 Since 1.3.70:
542   * A new Windows authorization group "AFS Client Admins" is now 
543     created and populated with the members of the "Administrators"
544     group.  The group is used to determine which accounts on the
545     machine may be used to modify the AFS Client Configuration via
546     the UI and command line tools.  afs_config.exe, fs.exe, 
547
548   * Modify the WinLogon Logoff Event Handler to query NT4 domain
549     controllers for the remote profile path if Active Directory
550     services are not available.
551
552   * Fix aklog.exe to not add the AFS ID to the username
553
554   * PTS registration of new users to foreign cells has been added to 
555      afscreds.exe
556
557   * The cm_Daemon thread is used to perform checks for 
558     down servers, up servers, volumes, callback expirations, 
559     lock maintenance and token expiration.  Due to a gaff in
560     larger integer division the thread never performed any 
561     work.  Instead the current time computation would always
562     be less then the trigger times.  This had an adverse affect
563     on the client's ability to maintain communication with servers,
564     keep volumes up to date, and flush user tokens and acls
565     when they have expired. This was broken when the 1.3 branch
566     was modified to support VC7 which no longer included 
567     largeint.lib
568
569   * An initialization problem with the Freelance code was 
570     detected while fixing the callbackRequest.  The cm_rootSCachep
571     object is obtained during afsd_InitDaemons() but the callback 
572     information is incomplete.  The callback information will not
573     be obtained until cm_MergeStatus is called from within
574     cm_GetCallback.  Unfortunately, cm_SyncOp did not properly 
575     test for the conditions under which the callback information
576     must be obtained.  
577
578   * Reports have been filed indicating that callbacks were
579     being lost.  An examination of the code indicated that the
580     cm_server_t objects were not being properly reference
581     counted by the cm_scache_t and cm_callbackRequest_t objects.
582     In particular, the cm_server_t objects may have been freed
583     from beneath the cm_conn_t objects.
584
585     All of the reference counting is now done via the functions:
586         cm_GetServer
587         cm_GetServerNoLock
588         cm_PutServer
589         cm_PutServerNoLock
590     this improves the ability to track the referrals.  
591
592     Each cm_BeginCallbackGranting Call now allocates a reference
593     to the cm_server_t.  The cm_EndCallbackGrantingCall either
594     frees the reference or transfers it to the cm_scache_t
595     cbServerp field.  These are then appropriately tracked
596     through the cm_Analyze call.
597
598   * Ensure that the dnlc hash table is the same size as the
599     dir name hash table (as per original author's note).
600     Increase the dnlc CM_AFSNCNAMESIZE to a multiple of 8
601     for compatibility with 64-bit systems.
602
603   * fix smb_ApplyV3DirListPatches to properly apply the hidden
604      attribute to dotfiles when the infoLevel < 0x101 and 
605      cm_SyncOp has failed.
606
607   * Fix the Freelance registry initialization code.  There
608     was a possibility that some systems could end up with 
609     garbage in the registry during a clean install.
610
611 Since 1.3.66:
612    * file and directory names beginning with "." will now be given the
613      hidden attribute when the volume access is anonymous.  this matches
614      the behavior when the volume access is via an authenticated user.
615
616    * Added a change monitor to the HKLM\SOFTWARE\OpenAFS\Client\Freelance
617      key.  When a change occurs mark the root.afs data as invalid and
618      for it to be reloaded on the next access.  This allows administrators
619      to modify the mount point list without restarting the service.
620      
621      The freelance client used to provide a fake modification time for
622      the root.afs volume data and its mount points of 7/09/2001 14:24 EDT.
623      Added code to extract the last modification time of the Freelance
624      registry key and use that instead.  The time now represents the 
625      most recent mount point change.
626
627    * PTS registration of new users to foreign cells has been added to 
628      aklog.exe
629
630    * Additional Cache Control and Credential Manager options have been
631      added to the WiX installer.  See deployment guide for details.
632
633    * The CachePath setting is now optionally a REG_EXPAND_SZ type
634   
635    * The WiX installer has been upgraded.  Version 2.0.1927.1 is now 
636      required.
637
638    * The loopback installation code may have had a problem updating the
639      %ETC%\HOSTS file which could have resulted in a premature failure.
640      Work around code has been added for the case where the file cannot
641      be deleted.
642
643    * The default max chunksize was increased from 15 (32K) to 17 (128K)
644      because Windows sends 64K blocks when using overlapped writes.
645
646    * The default number of server threads was increased from 4 to 25 to
647      better handle overlapped writes.  
648
649    * The "AfscredsShortcutParams" registry value was not being properly
650      loaded by afscreds.exe.  Therefore, the default value was always being
651      used instead of the value set by the installer.
652
653    * Windows XP provides downgrade attack detection to prevent an attacker
654      from being able to force the use of NTLM simply by disrupting 
655      communication with the KDC.  This attack cannot exist between the 
656      Windows CIFS client and the AFS Client Service.  Therefore, when a
657      downgrade has been detected the afs pioctl library will force the 
658      establishment of a new CIFS connection using NTLM.
659  
660    * A locking error was discovered surrounding all references to volume
661      server lists within the cm_cell.c source file. 
662
663    * The logged into Windows username was incorrect on Terminal Server
664      machines.
665
666    * A new registry value "NonPersistentCaching" was added to the service
667      parameters key.  When set to a non-zero value, the afs cache is stored
668      in the Windows paging file.  There are two limitations to choosing
669      this option: 
670         1. when persistent caching is implemented it won't work with 
671            this flag set since there will be nothing to persist.
672         2. with this flag set the initial paging allocation cannot be
673            changed while the service is running
674
675    * An initialization bug was discovered in aklog.exe which affected users
676      who have a domain name for their afs servers which could not be mapped
677      to a realm
678
679 Since 1.3.65:
680    * afs_config.exe now validates cell names against DNS in addition
681      to the CellServDB file.
682
683    * In order to allow the freelance client to connect to a volume with ID 
684      equal to 1 on the default cell we changed the fake root.afs volume ID
685      once again.  This time we choose 0xFFFFFFFF.  In addition, we change
686      the cell ID of the fake root.afs volume from 1 to 0xFFFFFFFF as well.
687      It will now be impossible for a volume ID to match that of another 
688      cell unless the client is connected to 0xFFFFFFFD cells.  That should
689      be enough room for growth.
690
691    * Fix "fs mkmount" command to work with UNC paths and when
692      started from non-AFS drives.  It is now possible to create a mount
693      point in the freelance fake root.afs volume with the command
694
695         fs mkmount \\AFS\all\<directory-name> <volume-name> <cellname>
696
697      For example,
698         
699         fs mkmount \\AFS\all\openafs.org root.cell openafs.org
700         fs mkmount \\AFS\all\.openafs.org root.cell openafs.org -rw
701
702    * The algorithm used to re-attempt access to the servers associated with
703      a volume has been altered to properly address the case in which all 
704      servers have been marked down.  The previous algorithm did not reset
705      the server's down flags so the servers were never actually retried.
706      This caused a problem with active volumes if the network connectivity
707      was lost as could be the case with a network cable removal, wireless
708      drop, or laptop hibernation.  With the fix volume access is restored
709      almost instantenously when network connectivity becomes available.
710
711    * Support for SMB/CIFS browsing has been added to the AFS Client Service
712      SMB server.  It is now possible to use "NET VIEW \\AFS" to obtain a
713      listing of AFS submounts and freelance mount points.  Support for
714      NETSHAREENUM, NETSHAREGETINFO, NETSERVERENUM2, NETSERVERGETINFO
715      significantly enhances the behavior of AFS volumes within the Explorer
716      Shell.  For instance, "AFS" now shows up as server in the Explorer
717      with each submount or freelance mount point visible as a share.
718      The right click menu in each folder now works with full functionality
719      on a consistent basis.
720
721    * The network provider can be configured to have different behavior
722      depending on the domain that the user logs into.  These settings are
723      only relevant when using integrated login.  A domain refers to an
724      Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
725      local machine (i.e. local account logins).  The domain name that is
726      used for selecting the domain would be the domain that is passed into
727      the NPLogonNotify function of the network provider. (see registry.txt
728      for details)
729
730    * Added a new registry value [HKCU\SOFTWARE\OpenAFS\Client] 
731      "Authentication Cell" which may be used to specify a default 
732      authentication cell for afscreds.exe which is different from
733      the default cell for the AFS Client Service daemon.
734
735    * Added a Logoff WinLogon Event Notification function to afslogon.dll.
736      afslogon.dll moved to %WINDIR%\System32\.
737      New registry entries added to register the dll for Winlogon events.
738
739      The logoff event will now force a call to ktc_ForgetAllTokens()
740      using the context of the user being logged off as long as the 
741      user's profile is not loaded from within AFS.  If the profile 
742      was loaded from AFS we can't release the tokens since the Logoff
743      event is triggered prior to the profile being written back to 
744      the its source location.  This is now performed in an XP SP2 
745      safe manner.
746
747    * Windows XP SP2 Internet Connection Firewall interoperability
748      has been added.
749
750    * The %WINDIR%\afsdsbmt.ini contains four sections:
751         Submounts, Drive Mappings, Active Maps and CSC Policies.
752      The Submounts and CSC policies are now stored in the registry under
753         [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
754         [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
755      The Drive Mappings and Active Maps are stored in the registry under
756         [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
757         [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
758
759      There is no automatic migration of this data as it would be impossible
760      to consistently migrate data to user profiles which may not be active
761      when the machine is updated.
762
763    * The %WINDIR%\afs_freelance.ini contains lists of mountpoints for the
764      fake root.afs volume.  For the same reasons as for the cellservdb file,
765      this information should not be in %WINDIR%.  This information is now
766      kept under the registry key
767         [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
768
769      The data from the afs_freelance.ini file will be automatically 
770      migrated to the registry on first execution of afsd_service.exe
771
772    * Keeping the CellServDB file in the location %WINDIR%\afsdcell.ini is 
773      troublesome for several reasons.  One, it is confusing for those who
774      expect the file to be named "CellServDB" instead of "afsdcell.ini".
775      Two, this file is not a Windows Profile formatted file.  Three, 
776      applications should not be reading or writing to %WINDIR%.  It causes
777      problems for Windows Terminal Server.
778
779      The new location of CellServDB will be the OpenAFS Client install 
780      directory which is by default C:\Program Files\OpenAFS\Client and can
781      be determined by querying the registry for 
782      [HKLM\SOFTWARE\TransarcCorporation\AFS Client\CurrentVersion]PathName
783
784      The existing afsdcell.ini will be migrated by the NSIS installer. 
785      The Wix installer must still be updated to do the same.
786
787    * Change NSIS installer to use DNS by default; to remove Integrated Logon
788      High Security mode; and to add Terminal Services compatibility registry
789      entries to allow the OpenAFS tools to find the afsdcell.ini and other
790      configuration files in %WINDIR%.
791   
792    * Add support for authenticated SMB connections.   This will remove
793      the need for high security mode in most situations.  Both NTLM
794      and Extended Security (GSS SPNEGO) modes are supported.  Effectively,
795      only NTLM can be used even though Kerberos is now supported.  The
796      reason is that it is not possible to construct a service principal
797      which is unique to each individual machine.
798
799      SMB Extended Auth does not work on XP SP2 unless one of two registry
800      modifications are made:
801
802      (1) To disable the check for matching host names on loopback connections
803         set this key.  This does not require a reboot:
804
805         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa]
806             "DisableLoopbackCheck"=dword:00000001
807
808      (2) To add the AFS SMB/CIFS service name to an approved list.  This
809         does require a reboot:
810
811         [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0]
812             "BackConnectionHostNames"=multi-sz "AFS" "MACHINE-AFS"
813
814      afsd_service.exe will automatically add the current Netbios Name
815      to the BackConnectionHostNames list and then temporarily disable
816      the loopback check for one cycle of startup/shutdown of the service.
817      We assume most folks do not start/stop without a reboot so this 
818      will be adequate in most cases.
819
820    * Fix security hole in afslogon.dll which allowed passwords to be
821      sent in clear text to the KDC in a misformed principal name.
822
823    * Fix cm_GetCell() to properly handle expired dns entries
824      without crashing
825
826    * If Freelance mode is active and the afs_freelance.ini
827      file does not exist, do not create an empty file.
828      Instead create a file containing ro and rw mountpoints
829      to the default cell using the standard conventions.
830
831    * Modify the Freelance support to handle the ability
832      to create rw mount points in the fake root.afs volume.
833
834    * Changed the RPC mechanism used for token setting from 
835      named pipes to local.  Use of named pipes can be restored
836      by setting the environment variable AFS_RPC_PROTSEQ to
837      "ncacn_np". 
838
839      Named pipes were required when a Windows 9x system was
840      using a NT system in gateway mode which is incompatible
841      with our use of local loopback adapters.
842
843    * In afscreds.exe, if a username of the form user@REALM is
844      specified and no password is specified, do not perform a 
845      kinit operation.  Only perform the aklog functionality.
846
847    * Add a new registry value which allows the number of processors
848      on which afsd_service.exe executes to be restricted.  Valid
849      values are 1..numOfProcessors
850
851        HKLM\SYSTEM\CurrentControlSet\Services\TransarcAfsDaemon\Parameters
852           (DWORD) MaxCPUs 
853
854 Since 1.3.64:
855    * A second MSI based installer option is now available.
856
857    * Fixed Kerberos 5 kinit functionality in afscreds.exe to properly
858      request tickets for user/instance@REALM instead of just user@REALM
859
860    * Modify the Power Management Notify routine to wait for the Hard Dead
861      timeout period instead of a fixed 19 seconds.  With the longer timeout
862      periods Hibernation and Standby could never succeed when network 
863      connectivity is not available.
864
865    * The following fs.exe commands are now restricted to Administrator:
866      - checkservers with a non-zero timer value
867      - setcachesize
868      - newcell
869      - sysname with a new sysname list
870      - exportafs 
871      - setcell
872      - setserverprefs
873      - storebehind
874      - setcrypt
875      - cscpolicy
876      - trace
877
878      setting the default sysname for a machine should be done via the
879      registry and not via "fs sysname".
880
881    * NSIS installer adds options to install Debugging Symbols
882      and the Microsoft Loopback Adapter; the user is now also
883      given the ability to select the afscreds.exe startup options.
884
885    * Build system modified to generate symbols for FREE (aka RELEASE)
886      builds as well as CHECKED (aka DEBUG) builds
887
888    * Sites which have a volume ID of 0x20000001 assigned to their
889      root.cell volumes have been experiencing problems with accessing
890      the root.cell volume of their cell when Freelance mode has been
891      active.  This was because 0x20000001 was assigned to the fake
892      root.afs volume created by freelance.  The fake volume id is
893      now set to 0x00000001 to prevent conflicts.
894
895    * The timeout logic in the AFS Client Service has been wrong
896      for sometime.  It is based on two different assumptions.
897      First, the SMB client timeout is a fix value as was the case
898      with OS/2 Lan Manager.  This assumption is incorrect.  The
899      SMB timeout in Windows is a dynamic value computed based upon
900      a fixed minimum timeout to which is added time based upon the
901      size of the request and the performance characteristics of
902      the connection.  Second, it is the responsibility of the 
903      SMB Server to enforce the timeout requirements of the client.
904      This is untrue.  The SMB Server cannot be expected to know
905      the requirements of the client.  More importantly, if the 
906      SMB server uses the SMB client timeout as a value to restrict
907      its behavior as an RX client, the performance characteristics
908      of the local SMB session would be used to prematurely terminate
909      WAN connections with significantly different performance 
910      characteristics.
911
912      The timeout logic has therefore been modified in the following
913      manner:
914       . the Lan Manager Workstation (SMB) Session Timeout is used only
915         as a basis for configuring the Connection Dead Timeout 
916         and Hard Dead Timeout values.  The Connection Dead Timeout
917         must be at least 15 seconds longer than the SMB Timeout
918         and the Hard Dead Timeout must be at least double the 
919         Connection Dead Timeout.
920       . New registry entries have been added to allow the Connection
921         Dead Timeout and Hard Dead Timeout values independent of the
922         Lan Manager Workstation Session Timeout
923       . The test to enforce the SMB Client Timeout has been removed.
924         
925      One of the side-effects of removing the enforcement of the SMB 
926      Client Timeout is that regardless of whether or not the SMB client
927      is available to receive the response (and how would the SMB server
928      know) the RX protocol response can be used to update the AFS 
929      Client Service state for ready access by future SMB client 
930      requests.
931
932      This should be the end of the "Server paused or restarting messages"
933    
934    * Add support for arbitrary UNC paths to the pioctl() support.
935      This enables the fs commands as well as the AFS Shell Extension
936      to work correctly when UNC paths are being used.
937
938    * Fix afscreds.exe (by updating afskfw.lib) to search for cells via
939      DNS if the cell configuration cannot be determined via CellServDB
940
941    * Add debug info to test whether CM_BUF_WAITING or CM_SCACHE_WAITING
942      are ever set more than once at a time
943  
944    * Fix the management of lists of cm_cell_t structures when using 
945      DNS to lookup cell information.  The previous code would fail to
946      reuse the same cellID for a cell if DNS was used more than once
947      for a given cell name.  When the ttl expired, a single cm_cell_t
948      could be inserted into the cm_allCellsp list more than once 
949      producing a loop.  In addition, the vlServerp list belonging to
950      the cell was not freed resulting in improper refCounting of the
951      servers.
952
953    * Add DNS support to cm_IoctlNewCell() which previous only examined
954      the CellServDB file
955
956    * Add cm_FreeServer() function and call it from cm_FreeServerList()
957      to properly garbage collect cm_server_t objects 
958      
959    * Add numVCs variable to smb.c to track the number of smb_vc_t 
960      objects created and use it to initialize the vcID field which 
961      previously was set to 0 in all objects resulting in FindByID 
962      collisions.
963
964    * Fixed DNS lookups to work consistently throughout the OpenAFS
965      product instead of just from within the afsd_service.exe
966
967    * Added a runtime check to ensure that AFS Client Service SMB
968      Server is accepting connections before attempting to mount
969      global drives.
970
971    * Read IP addresses for volume servers out of the CellServDB
972      file if gethostbyname() on the hostname fails.
973
974    * Fix getcellconfig() to populate both the Hostnames as well
975      as IP addresses when loading cell data via DNS
976
977    * Increase the Connection Dead Time to 50 from 20 seconds
978      Increase the Hard Dead Time to 120 from 40 seconds
979      (matches the Unix values)
980
981    * Fixed an assertion validating the number of allocated NCBs
982
983    * Fixed the build environment to consistently build for 
984      Windows 2000 and above.  (APPVER = 5.0)
985
986    * Fixed rx_debug to properly validate the receipt in incoming
987      data with select() and recvfrom().  Do not copy data out of
988      the socket buffer unless success is indicated.
989
990 Since 1.3.63:
991    * afsd_service.exe will now display a message box to the 
992      desktop when it terminates due to an IP Address Change.
993   
994    * installer no longer deletes AFS Server configuration data
995      on uninstall
996
997    * installer generates a warning dialog if the RPC service 
998      is not properly configured
999
1000    * installer compressed with lzma instead of bzip2
1001
1002    * afsd_service.exe shutdown crash solved once and for all
1003  
1004    * reference counting of smb_vc_t data structures improved
1005  
1006    * name space collision of smb_fid_t event objects corrected
1007
1008    * the output of "fs memdump" is now written to 
1009      %WINDIR%\TEMP\afsd_alloc.log
1010
1011    * the file TaAfsApp_1033.dll is now properly installed allowing
1012      the User Manager to start
1013   
1014    * a new algorithm is used for computing filename pattern matches
1015
1016    * afscreds.exe now accepts user names containing instance
1017      fields.
1018
1019    * Fix the Directory Name Lookup Cache to be case-sensitive.
1020      This is crucial in environments in which a Windows client
1021      is accessing a directory with more than one filename that
1022      differs only by case.  If the directory contains "FOO" 
1023      and "Foo".  You want "DEL Foo" to delete the correct one.
1024      We still have a problem in that "DEL foo" will delete a
1025      random filename.  This will be addressed in a future release.
1026
1027    * Fix afscreds.exe -M option (renewMaps) to work when High
1028      Security mode is off.  Also, remember to disable the ActiveMap
1029      flag in afsdsbmt.ini when a drive mapping is removed.
1030
1031    * Updates to NSIS installer script.  AFS Server configuration
1032      data will not be destroyed on un-install or re-install.  
1033      Use a better compression algorithm.
1034    
1035    * afslogon.dll now uses KFW to obtain tokens when available
1036    
1037    * afslogon.dll when given an all uppercase username will
1038      attempt to authenticate with both the uppercase name
1039      and an all lowercase variation
1040
1041    * DST modification removed.  The fix appears to make things
1042      worse after a reboot of the machine.
1043
1044    * fs.exe:  added "cscpolicy" which is used to 
1045      change client side caching policy for AFS shares
1046
1047      Usage: fs cscpolicy [-share <AFS share>] [-manual] [-programs] 
1048                          [-documents] [-disable] [-help]
1049
1050    * Several uninitialized variables have been initialized
1051
1052    * It is now possible to obtain tokens using cross realm
1053      Kerberos within afscreds.exe:
1054         cell:      dementia.org
1055         user:      jaltman@ATHENA.MIT.EDU
1056         password:  xxxxxxxx
1057      Will obtain a cross realm ticket for jaltman/DEMENTIA.ORG@ATHENA.MIT.EDU
1058      will will in turn be used to obtain afs@DEMENTIA.ORG.
1059      The resulting token will be stored with the display name 
1060        jaltman@ATHENA.MIT.EDU@dementia.org
1061
1062    * aklog.exe has been added to the client
1063
1064      Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]] 
1065                   [[-p | -path] pathname]
1066                   [-noprdb] [-force]
1067                   [-5 | -4]
1068
1069         -d gives debugging information.
1070         krb_realm is the kerberos realm of a cell.
1071         pathname is the name of a directory to which you wish to authenticate.
1072         -noprdb means don't try to determine AFS ID.
1073         -5 or -4 selects whether to use Kerberos V or Kerberos IV.
1074            (default is Kerberos V)
1075         No commandline arguments means authenticate to the local cell.
1076
1077 Since 1.3.62:
1078    * All of the resource files have been restructured to adhere to
1079      a set of rules IBM implemented for loading string resources.
1080      These rules had either been forgotten or were not discovered
1081      by folks working on the OpenAFS sources.  The end result was
1082      memory corruption.  This is primary item which was preventing
1083      the AFS Server from working.
1084
1085    * Increased the size of the maximum ticket size stored in a token
1086      from 344 bytes to 12,000.  Increased the buffers used to convey
1087      messages between the pioctl() caller and the SMB Server from
1088      1000 bytes to 12,512.  The code appeared to have been writing
1089      above the top of the stack by quite a few number of bytes.
1090      (The increased ticket size is necessary for the next item.)
1091
1092    * When obtaining AFS Tokens via KFW, krb524 is no longer required.
1093      Instead the raw Kerberos 5 ticket is used in its entirety.  This
1094      is extremely important as it allows us to use pure Kerberos 5 KDCs
1095      as the source of the AFS authentication.  The use of up to 12,000 byte
1096      tickets will allow tickets produced by all versions of Microsoft
1097      Active Directory to be used.
1098       - create a user account.       
1099       - designate it DES only
1100       - disable pre-auth
1101       - specify its UPN to be  "afs@realm"
1102       - assign a SPN of "afs/cellname" to the UPN with setspn.exe
1103
1104    * Do not enforce the funky 8dot3 pattern matching rule that the first "."
1105      is special when using long file names.  (you must use "*.*" and not "*")
1106      Instead only enforce it when performing 8dot3 searches. 
1107
1108    * Fixed the DST problem with creation times being set one hour ahead
1109
1110    * Fixed the problem when using \\afs\cell-alias.  For example, 
1111      \\afs\uncc instead of \\afs\uncc.edu.  Do not a new cell struct
1112      for the alias name; instead simply expand the name.  One of the
1113      symptoms of this problem was a loss of acquired tokens.
1114
1115    * Fixed the AFS Shell Extension.  The Symbolic Link menu was empty 
1116      of strings.  (Only English strings provided.)
1117
1118    * Fixed the installer to properly replace in use files.  
1119
1120    * Fixed the build system to cleanup generated component version files
1121
1122    * The release build compiled with MSVC 6.0 compiler to avoid the 
1123      afsd_service.exe shutdown crash.  This does not solve the problem
1124      but simply avoids it for the time being.
1125
1126 Since 1.3.61:
1127
1128  * fix afslogon.dll to not corrupt memory when High Security mode
1129    is not used.  
1130
1131  * fix afsd_service.exe to not attempt to restore the stack when
1132    an exception occurs.  (not safe in multi-threaded programs)
1133
1134  * fix uninstaller to properly remove the CRT and MFC DLLs
1135  
1136  * remove a Message Box from afscreds.exe when getcellconfig()
1137    fails on a kerberos realm which is not a cell
1138
1139 The following is a list of changes to the OpenAFS for Window client
1140 since 1.3.60.
1141
1142  * "fs setserverprefs" will leave afsd service deadlocked
1143
1144  * "vos listaddrs" will core dump
1145
1146  * installer sets the appropriate keys to support Integrated Logon
1147
1148  * installer disables the "Find Lana by Name" functionality as it
1149    was causing headaches for many users
1150
1151  * fix the intermittent crash of the power management thread when
1152    shutting down the AFS Client Service
1153
1154  * optimizes the obtain drive mount list functionality which is 
1155    executed every time the mount tab in afscreds.exe and afs_config.exe
1156    are refreshed.  (this happens a lot)
1157
1158  * fix the service shutdown logic.  add the STOP_PENDING state
1159    and do not accept additional service events after we declare
1160    ourselves STOPPED.
1161
1162 The following is a list of changes to the OpenAFS for Window client
1163 since 1.2.10.
1164
1165 * flexelint was run against the source tree and hundreds (perhaps 
1166   thousands) of corrections were applied to ensure prototypes 
1167   were in use; types were used consistently; variables were 
1168   initialized; unused variables were removed; etc.
1169
1170 * A wide variety of instrumentation was added including the 
1171   ability to produce a stack trace from within afsd_service.exe
1172   when it crashes.
1173
1174 * Dynamic configuration of the RDRtimeout value based upon the
1175   LanMan Workstation Session Timeout
1176
1177 * The mount root no longer needs to be called "/afs".  This 
1178   is now set by a registry value "MountRoot" within the key
1179   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
1180
1181 * The cell list is now only read out of afsdcell.ini when the
1182   file changes instead of each time a cell is resolved.
1183
1184 * Thread synchronization was added to cm_server.c and ktc_nt.c
1185
1186 * All calls to GlobalAlloc()/GlobalFree() were replaced with 
1187   calloc()/free().  The Global functions were needed on Windows 3.x
1188   but have caused a variety of problems on the Win32 platforms.
1189   Avoiding them is highly recommended by several Microsoft 
1190   Knowledgebase articles
1191
1192 * Support for Symbolic Links added to the AFS Shell Extension
1193
1194 * Added a registry value "OverlayEnabled" to determine if
1195   Shell Extension Overlays should be enabled.  
1196   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
1197
1198 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
1199   separate trees for checked and free builds.  Build system supports
1200   a custom directory src\WINNT\extra which can be used as a grafting
1201   location of organization specific additions to the build tree.
1202
1203 * New installer built using NSIS 2.0.  
1204
1205 * Named all kernel objects in order to allow them to be monitored
1206   with tools such as SysInternals' ProcExp.exe.
1207   
1208 * Introduced new EventLog framework for AFSD
1209
1210 * Introduced Power Management interface to AFSD for Standby and 
1211   Hibernate modes to allow cache to be flushed prior to network
1212   disconnect
1213
1214 * Utilize Win32 DNSQuery API instead of internal routines.  This 
1215   allows DNS SRV queries to be sent to all current domain name 
1216   servers.  Not just one specified in an INI file.  DNS is now
1217   always activated.
1218
1219 * "NetbiosName" registry value may be used to specify a fixed
1220   Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
1221   when the loopback adapter is in use.  If you need to use the 
1222   old notation with a loopback adapter installed specify a registry
1223   entry of 
1224
1225      "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
1226
1227 * Refactor all modules which depend on LAN Adapter and NetbiosName
1228   determination in a new library: lanahelper.lib.  This allows for
1229   consistent behavior throughout the product.
1230
1231 * Move the afsd.log and afsd_init.log files to the directory specified
1232   by the "TEMP" environment variable.  This is usually %WINDIR%\TEMP
1233   for services.  Added the Date to the log entries.
1234
1235 * New registry value "RxMaxMTU" used to limit the size of the RX 
1236   packets sent by the AFS Client Service to the Server.  In order
1237   to enable OpenAFS to work across the Cisco IPSec VPN the packet
1238   size must be restricted to 1264 or smaller.  The latest NSIS
1239   installer sets a value of 1260 by default.
1240
1241 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
1242   packets.  This is not needed in order to work across the Cisco
1243   VPN but might be needed for other network environments.  This
1244   value is not set by the NSIS installer.
1245
1246 * New registry value "HideDotFiles" is used to apply the Hidden
1247   attribute to files whose names begin with a '.'.   This value
1248   is set by the NSIS installer.
1249
1250 * New registry value "MaxMpxRequests" allows the maximum number
1251   of multiplexed sessions to be configured at run time.  This
1252   value is not set by the NSIS installer.  The default value is
1253   50.
1254
1255 * New registry value "MaxVCPerServer" allows the maxmimum number
1256   of VCs per server to be configured at run time.  This value is
1257   not set by the NSIS installer.  The default value is 100.
1258
1259 * New registry value "AllSubmount" allows the "all" submount to
1260   be disabled by setting its value to 0x00.
1261
1262 * Allow cells names to be valid mount points 
1263     \\<netbiosName>\<cellname>
1264
1265 * Store the active state of drive mappings in order for afscreds.exe
1266   to restore them upon startup
1267
1268 * Add exception handling to generate a Stack Trace to the afsd_init.log
1269   file if one happens to occur.
1270
1271 * Add lots of logging to help detect the cause of invalid SMB packets
1272
1273 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
1274   conversion of Kerberos 5 "afs" service tickets.  Supports auto-
1275   renewal of expiring tokens as long as afscreds.exe is running.
1276
1277 * New afscreds.exe command line options:
1278     -A = autoinit
1279     -M = renew drive maps
1280     -N = ip address change detection
1281     -Z = unmap drives
1282
1283 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
1284   determines whether or not MIT Kerberos for Windows should be used
1285   to obtain tokens via Kerberos 5 tickets.
1286
1287 * New registry value "AfscredsShortcutParams" in 
1288   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
1289   determines the command line parameters to be specified when "fixing"
1290   the AFS Shortcut in the user's startup folder.
1291
1292 * The "ShowTrayIcon" registry value has been moved from 
1293   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
1294   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
1295   
1296 * The <cell name> registry values used to store the token expiration
1297   reminders have been moved from 
1298   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
1299   {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
1300  
1301 * Obtain the Logon User Name from the Explorer key when available
1302
1303 * new text document doc\txt\winnotes\registry.txt lists all registry
1304   values used by OpenAFS (excluding the AFS Server)
1305
1306 * BUG: rx_securityClass objects were not properly reference 
1307   counted and were never freed.  
1308
1309 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
1310   would be generated.  The existence of a server does not imply
1311   that it is not down.  If all of the servers for a cell are down
1312   return CM_ERROR_NOSUCHVOLUME instead.  This prevents the Explorer
1313   Shell from hanging.
1314
1315 * BUG: the directory name lookup cache failed to free the entries
1316   in the cache when the name cache entries cycled.  The entries
1317   in the cache would become dereferenced without being freed.
1318
1319 * BUG: fs setserverprefs could be executed without Administrator
1320   privileges
1321
1322 * BUG: the number of allocated NCB objects (100) exceeded the number
1323   which could actually be waited upon by the kernel (64).  Any objects
1324   which were utilized above the limit could never have event completions
1325   detected.
1326
1327 * BUG: smb_username_t objects were not being reference counted and 
1328   were not properly freed.
1329
1330 * BUG: smb_tid_t objects could under unusual circumstances be freed
1331   before they were no longer referenced.
1332
1333 * BUG: smb_fid_t object pointer were frequently used even when 
1334   their value could be NULL.   They were not properly released and
1335   therefore they were never freed.
1336
1337 * BUG: smb_packet_t data structures were not completely initialized
1338   upon creation
1339
1340 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
1341   Denied" because that causes the Explorer Shell to try again until
1342   access is obtained.  Instead return "Remote Resources" which allows 
1343   the shell to move on and treat the error as transient.
1344
1345 * BUG: when initializing the NCBreturns structure, separate Event objects
1346   were created for each NCB although a single Event object was supposed
1347   to be shared by all.
1348
1349 * BUG: smb_dirSearch_t objects were not being properly referenced counted
1350   or freed.
1351
1352 * BUG: smb_tran2Packet_t objects were not being properly referenced 
1353   counted or freed.
1354
1355 * BUG: directory path creation did not handle the case of multiple
1356   directories requiring creation in one attempt
1357
1358 * BUG: SMB requests which required an Extended Response were ignored.
1359   This prevented some files from being written to AFS volumes.
1360
1361 * BUG: character strings were being freed even after they were 
1362   inserted into in use data structures
1363
1364 * BUG: inconsistent usernames were used when High Security mode was
1365   enabled.  (there is still much to do in this area)
1366
1367 * BUG: pioctl() calls which require out of band RPC operations were
1368   susceptible to race conditions when performed by multiple processes
1369
1370 * BUG: memory allocation and deallocation crossed instances of the
1371   C Runtime Library producing memory leakage and corruption in 
1372   afscreds and the client configurator.
1373
1374
1375