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