windows-docs-20041027
authorJeffrey Altman <jaltman@mit.edu>
Thu, 28 Oct 2004 02:22:25 +0000 (02:22 +0000)
committerJeffrey Altman <jaltman@secure-endpoints.com>
Thu, 28 Oct 2004 02:22:25 +0000 (02:22 +0000)
Documentation updates

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

index 0356e0c..ad848ef 100644 (file)
@@ -1,3 +1,17 @@
+Since 1.3.72/73:
+  * Add support for symlinks to Freelance root.afs volume
+    Stored at HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks
+       <number>  =  "<linkname>:<relative-path>."
+    Use symlink.exe to create, list, or remove
+
+  * Remove the fallback to the use of KFW's KRB4 library when obtaining
+    tokens.  We never obtain KRB4 tickets.
+
+  * Fix AFS Client Configuration Control Panel to support new SysName
+    protocol.
+  * Fix a bug in afsd_service.exe which could result in the SysName
+    not being read from the registry.
+
 Since 1.3.71:
   * Add code to block the issuance of AFS tokens by aklog.exe or
     afscreds.exe when the Kerberos 5 principal name contains a dot.
index 49f8f74..2bf79e9 100644 (file)
@@ -358,6 +358,19 @@ the availability of this option should only be used by individuals until
 such time as their organizations can provide a more permanent solution.
 
 
+25. The Status Cache (AFS Config Control Panel: Advanced Page) is defined
+to have a maximum number of entries.  Each entry represents a single file
+or directory entry accessed within the AFS file system.  When the maximum
+number of entries are allocated, entries will begin to be reused according
+to a least recently used (LRU) algorithm.  If the number of files or 
+directories being accessed repeatedly by your applications is greater then
+the maximum number of entries, your host will begin to experience thrashing
+of the Status Cache and all requests will result in network operations.
+
+If you are experiencing poor performance you might want to increase the 
+maximum number of Status Cache entries.  Each entry requires 164K.  Only
+those entries which are used are allocated.
+
 
 ------------------------------------------------------------------------
 
index 44e53c9..55b8a9b 100644 (file)
@@ -73,6 +73,8 @@ directories.
      description must be unique.  "home" cannot be reused.  We need a way 
      to remove "home" from the submount list.  
 
+     [Actually, an end user should not be able to modify the submount list]
+
 (16) WinAFS configuration values are still stored in old style INI files 
      instead of using the Registry.  This is especially important for
      per-user values such as drive mappings
@@ -115,20 +117,30 @@ directories.
      can be executed prior to the completion of the SMB registration
      and service thread initialization.
 
-(28) Should we allow the AFSCACHE file to be stored in the Virtual Paging
-     file as long as we do not support persistent caches?
-
-(29) CIFS Remote Administration Protocol implementation is incomplete.
+(28) 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
 
-(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.
+(29) The Cache Manager Flush routines do not return or check error 
+     codes.       
+
+(30) Remove submount creation as a side effect of AFS drive mapping.
+     
+     The AFS Submount is effectively a server side alias for a path 
+     located in the AFS space.  This alias is exported by the AFS 
+     SMB/CIFS Server to the Windows SMB/CIFS client as a Share name.  
+     This makes the AFS Submount a system global setting which should 
+     only be modified by a member of the "AFS Client Admin" group.
 
-(31) The Cache Manager Flush routines do not return or check error 
-     codes.        
+     afs_creds.exe and afs_config.exe should be modified to no longer 
+     use submount names when creating drive maps.  Drive maps should 
+     simply use the full AFS path name.  Submounts should not be 
+     created as a side effect of a drive mapping.
+
+     The creation of submounts should only be possible via afsshare.exe 
+     or by the new AFS Client Service Administration tool when executed 
+     by an authorized user.
 
 -------------------------------------------------------------------------
 List of unfunded projects:
@@ -155,7 +167,7 @@ List of unfunded projects:
    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
+         2. drive mappings but no submounts
          3. visibility of afs creds and setting of afs creds startup options
    9. Create new afs_admin.exe tool to be installed in the administrator folder (or use MMS) 
       which contains
@@ -176,7 +188,7 @@ List of unfunded projects:
   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
+  14. Integrate KFW installation into the NSIS and MSI installers
   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
@@ -184,17 +196,12 @@ List of unfunded projects:
       3. force share names to be no longer than 13 characters
       4. restrict authentication to ASCII only names and passwords
   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
   19. Add support for SMB/CIFS Digital Signatures
-  20. Development of afsmap.exe tool to provide AFS aware NET USE functionality
+  19. 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
-  21. Write-through caching appears to be unsupported.   Files copied to AFS
-      do not end up in the local cache.
-  22. Missing SMB/CIFS functions: 
+  20. Missing SMB/CIFS functions: 
         Find
         FindUnique
         FindClose
@@ -202,11 +209,14 @@ List of unfunded projects:
         WriteBulk       
         WriteBulkData
         Tran2::SessionSetup
-  23. StoreBehind mode is not implemented.  Or more correctly, all data is
+  21. 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 
+  22. 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.
-
-
+  23. Develop an optional Installable File System replacement for the SMB/CIFS 
+      Server.
+  24. Add support for storing Extended Attributes on files
+  25. Add support for storing Windows ACLs on files
+  26. Remove submount creation as a side effect of drive creation
index 9e5d245..fcf2113 100644 (file)
@@ -733,17 +733,34 @@ Value   : "numeric value"
 Type    : REG_SZ
 Default : <none>
 
-    This key is used to store newline terminated mount point strings 
+    This key is used to store dot terminated mount point strings 
     for use in constructing the fake root.afs volume when Freelance
     (dynamic roots) mode is activated.
 
-        "athena.mit.edu#athena.mit.edu:root.cell.\n"
-        ".athena.mit.edu%athena.mit.edu:root.cell.\n"
+        "athena.mit.edu#athena.mit.edu:root.cell."
+        ".athena.mit.edu%athena.mit.edu:root.cell."
 
     These values used to be stored in afs_freelance.ini
 
 
 Regkey:
+[HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks]
+
+Value   : "numeric value"
+Type    : REG_SZ
+Default : <none>
+
+    This key is used to store a dot terminated symlink strings 
+    for use in constructing the fake root.afs volume when Freelance
+    (dynamic roots) mode is activated.
+
+        "linkname:destination-path."
+        "athena:athena.mit.edu."
+        "home:athena.mit.edu\user\j\a\jaltman."
+        "filename:path\file."
+
+
+Regkey:
 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
 
 Value   : "submount name"