winnotes-20041012
authorJeffrey Altman <jaltman@mit.edu>
Wed, 13 Oct 2004 03:48:24 +0000 (03:48 +0000)
committerJeffrey Altman <jaltman@secure-endpoints.com>
Wed, 13 Oct 2004 03:48:24 +0000 (03:48 +0000)
Update documentation files with latest changes

doc/txt/winnotes/afs-changes-since-1.2.txt
doc/txt/winnotes/afs-issues.txt
doc/txt/winnotes/registry.txt

index a864e19..11837fb 100644 (file)
@@ -1,4 +1,35 @@
 Since 1.3.71:
+  * fix the Windows cache manager to prevent it from replacing the 
+    rx_connection object associated with the cm_conn_t object on each
+    and every operation if "fs crypt" was set.  This explains the 
+    dramatic performance difference when crypt is used vs clear.
+    The problem: 'cryptall', a boolean flag indicating whether or not 
+    "fs crypt" is set, was being compared to the rx_connection 
+    cryptlevel which is either rxkad_clear:0 or rxkad_crypt:2.
+    1 != 2 and therefore the rx_connection was always destroyed 
+    and replaced on each and every operation.
+
+    Lock the cm_conn_t object around every call to RXAFS_xxxx functions.
+    It is not safe for the cm_conn_t object to not be locked because
+    rx_DestroyConnection might be called from another thread if:
+        - the user's tokens have changed or expired
+        - the crypt mode has changed
+
+  * fix NSIS installer's AdminGroup.exe to properly create and
+    remove groups when given -create or -remove.  The string comparison
+    test was wrong.
+
+  * fs sysname now accepts a list of sysname values 
+
+  * added a new registry value HKLM\SOFTWARE\OpenAFS\Client "IoctlDebug"
+    DWORD which when set to a non-zero value will cause error message
+    text to be output to stderr from the pioctl() routine.  Useful in 
+    debugging failures of fs.exe, tokens.exe, etc.
+
+  * added a test to the power management code to only perform a 
+    flush operation if there is at least one network adapter which
+    is not a loopback adapter.
+
   * Fix bug in loading of registry value HKLM\SOFTWARE\OpenAFS\Client
     "EnableKFW".  This value will not be read if the key
     HKCU\SOFTWARE\OpenAFS\Client exists; even if the "EnableKFW" 
@@ -40,6 +71,9 @@ Since 1.3.71:
   * Update list of known CIFS operations to include all those listed
     in CIFS-TR-1p00_FINAL.pdf.
 
+  * Modify the handling of HKLM\SOFTWARE\OpenAFS\Client\Submounts
+    to support the REG_EXPAND_SZ type.
+
 Since 1.3.70:
   * A new Windows authorization group "AFS Client Admins" is now 
     created and populated with the members of the "Administrators"
index 0d54904..44e53c9 100644 (file)
@@ -1,4 +1,4 @@
-This file is a rough list of known issues with the 1.3.70 release of OpenAFS
+This file is a rough list of known issues with the 1.3.72 release of OpenAFS
 on Windows.  This list is not complete.  There are probably other issues 
 which can be found in the RT database or on the mailing list.
 
@@ -108,28 +108,27 @@ directories.
      and per-machine settings.  All of the new registry items need to 
      be added to the UI
 
-(27) There appears to be a thread safety issue in the Rx library when
-     running on Intel processors which support hyper-threading
-
-(28) Thread initialization versus Global Drive Mapping.  There is no
+(27) Thread initialization versus Global Drive Mapping.  There is no
      mechanism in the afsd_init.c to ensure that all of the threads 
      complete initializing in the correct sequence.  In the case of 
      Global Drive Maps this is a problem because the Global Drive Maps
      can be executed prior to the completion of the SMB registration
      and service thread initialization.
 
-(29) Should we allow the AFSCACHE file to be stored in the Virtual Paging
+(28) Should we allow the AFSCACHE file to be stored in the Virtual Paging
      file as long as we do not support persistent caches?
 
-(30) CIFS Remote Administration Protocol implementation is incomplete.
+(29) CIFS Remote Administration Protocol implementation is incomplete.
      Notifications are not made to requestors when the view of a file
      or folder changes due to token acquisition; token expiration; or
      token destruction
 
-(31) Microsoft Office appears to have trouble editing files of ~20MB
+(30) Microsoft Office appears to have trouble editing files of ~20MB
      or larger from within AFS.  Performance is particularly slow and
      applications such as Word often crash upon saving the files.
-      
+
+(31) The Cache Manager Flush routines do not return or check error 
+     codes.        
 
 -------------------------------------------------------------------------
 List of unfunded projects:
@@ -144,22 +143,21 @@ List of unfunded projects:
       the AFS Client Server is not using Freelance mode
    5. Prevent panic situation when the IP address to which the SMB server is bound is removed 
       from the local machine's network configuration
-   6. Identify and fix the problems with running the RX library on Hyperthreaded systems
-   7. Add support for Named Pipes within the afs filesystem
+   6. Add support for Named Pipes within the afs filesystem
       (This is not currently a supported feature of AFS; it will require 
       changes to the servers as well as the clients.)
-   8. Re-write afscreds.exe to support:
+   7. Re-write afscreds.exe to support:
          1. choosing between Kerberos 5 and Kerberos 4 on a per principal basis
          2. providing users with the ability to map multiple cells to a single principal
          3. providing change password functionality on a per principal basis
          4. no longer include drive mapping
          5. configuration of afscreds startup options in shortcut
-   9. Re-write afs_config.exe to be only "per user" functionality which does not require admin 
+   8. Re-write afs_config.exe to be only "per user" functionality which does not require admin 
       privileges
          1. default cell and principal for the user
          2. drive mappings
          3. visibility of afs creds and setting of afs creds startup options
-  10. Create new afs_admin.exe tool to be installed in the administrator folder (or use MMS) 
+   9. Create new afs_admin.exe tool to be installed in the administrator folder (or use MMS) 
       which contains
          1. afs client service cell name
          2. integrated logon configuration
@@ -174,29 +172,29 @@ List of unfunded projects:
         11. network configuration
         12. miscellaneous
         13. need to add support for all of the new registry values since 1.2.8
-  11. Identify why 16-bit DOS applications executed out of AFS fail
-  12. Add support for configurable Icon file representing AFS folders within the Explorer Shell
-  13. Documentation Documentation Documentation
-  14. Large File support (> 2GB)
-  15. Integrate KFW installation into the NSIS installer
-  16. Add support for record locking to AFS (requires changes to the servers)
-  17. Unicode enable the SMB/CIFS server.  OEM Code Pages: 
+  10. Identify why 16-bit DOS applications executed out of AFS fail
+  11. Add support for configurable Icon file representing AFS folders within the Explorer Shell
+  12. Documentation Documentation Documentation
+  13. Large File support (> 2GB)
+  14. Integrate KFW installation into the NSIS installer
+  15. Add support for record locking to AFS (requires changes to the servers)
+  16. Unicode enable the SMB/CIFS server.  OEM Code Pages: 
       1. prevent the use of interoperable file names
       2. force the use of paths no longer than 256 characters
       3. force share names to be no longer than 13 characters
       4. restrict authentication to ASCII only names and passwords
-  18. Complete implementation of CIFS Remote Administration Protocol
-  19. Correct the problems with overlapped writes which adversely affect 
+  17. Complete implementation of CIFS Remote Administration Protocol
+  18. Correct the problems with overlapped writes which adversely affect 
       Microsoft Office applications storing documents and temporary files
       within AFS volumes
-  20. Add support for SMB/CIFS Digital Signatures
-  21. Development of afsmap.exe tool to provide AFS aware NET USE functionality
+  19. Add support for SMB/CIFS Digital Signatures
+  20. Development of afsmap.exe tool to provide AFS aware NET USE functionality
       afsmap.exe <drive> <afs-path> [/PERSISTENT]
       afsmap.exe <drive> <unc-path> [/PERSISTENT]
       afsmap.exe <drive> /DELETE
-  22. Write-through caching appears to be unsupported.   Files copied to AFS
+  21. Write-through caching appears to be unsupported.   Files copied to AFS
       do not end up in the local cache.
-  23. Missing SMB/CIFS functions: 
+  22. Missing SMB/CIFS functions: 
         Find
         FindUnique
         FindClose
@@ -204,8 +202,11 @@ List of unfunded projects:
         WriteBulk       
         WriteBulkData
         Tran2::SessionSetup
-  24. StoreBehind mode is not implemented.  Or more correctly, all data is
+  23. StoreBehind mode is not implemented.  Or more correctly, all data is
       written directly to the server and is not cached.  Writes invalidate
       the local cache entries which are then read back from the server.
+  24. The Power Management Flush Cache code does not work on Terminal 
+      Server nor does it always successfully flush all of the dirty buffers
+      to the AFS servers before suspend/hibernate operations occur.
 
 
index 3ba0797..06db62f 100644 (file)
@@ -176,7 +176,9 @@ Type        : REG_SZ
 Default : "i386_nt40"
 Variable: cm_sysName
 
-  Self explanatory.
+  Provides an initial value for "fs sysname".  The string can contain
+  one or more replacement values for @sys in order of preference separated 
+  by whitespace.
 
 Value  : SecurityLevel
 Type   : DWORD {1,0}
@@ -739,7 +741,7 @@ Regkey:
 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
 
 Value   : "submount name"
-Type    : REG_SZ
+Type    : REG_EXPAND_SZ
 Default : <none>
 
     This key is used to store mappings of unix style AFS paths