Index: openafs/doc/txt/winnotes/afs-changes-since-1.2.txt
diff -c openafs/doc/txt/winnotes/afs-changes-since-1.2.txt:1.13.2.8 openafs/doc/txt/winnotes/afs-changes-since-1.2.txt:1.13.2.9
*** openafs/doc/txt/winnotes/afs-changes-since-1.2.txt:1.13.2.8	Mon Oct 18 00:11:49 2004
--- openafs/doc/txt/winnotes/afs-changes-since-1.2.txt	Fri Nov  5 14:21:38 2004
***************
*** 1,3 ****
--- 1,31 ----
+ Since 1.3.72/73:
+   * Fix the locking of objects during Directory Searches in the
+     SMB/CIFS server.  The failure to properly lock the reference 
+     counts was resulting in the premature freeing of smb_dirSearch_t 
+     objects while they were still in use by the SMB/CIFS client.
+     This does not solve the "Invalid Handle" problem.
+ 
+   * Fix Find Cell By Name pioctl call to return a valid cell
+     name for the Freelance fake root.afs volume.  
+     "Freelance.Local.Root".
+ 
+   * Fix the Explorer Shell Extension Symlinks->Add operation.
+     The dialog template was missing and the link destination
+     string was too short.
+ 
+   * 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: openafs/doc/txt/winnotes/afs-install-notes.txt
diff -c openafs/doc/txt/winnotes/afs-install-notes.txt:1.11.2.4 openafs/doc/txt/winnotes/afs-install-notes.txt:1.11.2.5
*** openafs/doc/txt/winnotes/afs-install-notes.txt:1.11.2.4	Mon Oct 18 00:11:49 2004
--- openafs/doc/txt/winnotes/afs-install-notes.txt	Fri Nov  5 14:21:38 2004
***************
*** 1,4 ****
! OpenAFS for Windows 1.3.72 Installation Notes
  ---------------------------------------------
  
  The OpenAFS for Windows product was very poorly maintained throughout the 
--- 1,4 ----
! OpenAFS for Windows 1.3.74 Installation Notes
  ---------------------------------------------
  
  The OpenAFS for Windows product was very poorly maintained throughout the 
***************
*** 72,95 ****
  dynamically constructed when the service starts.  This mode is called 
  Freelance mode.  Freelance mode is turned on by default.
  
! The contents of the
! fake "root.afs" volume are constructed dynamically as cells are accessed.
! When the fake "root.afs" volume is constructed it will only contain two
! mount points: a read-only and read-write mount point used to access the
! "root.cell" volume of the default AFS cell.  Any attempt to access a 
! valid cell name will automatically result in a new mount point 
  being created in the fake "root.afs" volume.  If the cellname begins with
  a "." the mount point will be read-write; otherwise the mount point will
  be read-only.  These mount points are preserved in the registry at key:
    HKLM\SOFTWARE\OpenAFS\Client\Freelance
  
  Additional mount points may be manually created using the "fs mkmount"
  command.  Mount points may be removed using the "fs rmmount" command.
  
!     fs mkmount \\AFS\all\athena.mit.edu root.cell athena.mit.edu
!     fs mkmount \\AFS\all\.athena.mit.edu root.cell athena.mit.edu -rw
!     fs rmmount \\AFS\all\athena.mit.edu
!     fs rmmount \\AFS\all\.athena.mit.edu
       
  
  4. The OpenAFS for Windows client will use AFSDB DNS records to 
--- 72,109 ----
  dynamically constructed when the service starts.  This mode is called 
  Freelance mode.  Freelance mode is turned on by default.
  
! The contents of the fake "root.afs" volume are constructed dynamically as
! cells are accessed.  When the fake "root.afs" volume is constructed it will
! only contain two mount points: a read-only and read-write mount point used
! to access the "root.cell" volume of the default AFS cell.  Any attempt to
! access a valid cell name will automatically result in a new mount point 
  being created in the fake "root.afs" volume.  If the cellname begins with
  a "." the mount point will be read-write; otherwise the mount point will
  be read-only.  These mount points are preserved in the registry at key:
+ 
    HKLM\SOFTWARE\OpenAFS\Client\Freelance
  
  Additional mount points may be manually created using the "fs mkmount"
  command.  Mount points may be removed using the "fs rmmount" command.
  
!     >fs mkmount \\AFS\all\athena.mit.edu root.cell athena.mit.edu
!     >fs mkmount \\AFS\all\.athena.mit.edu root.cell athena.mit.edu -rw
!     >fs rmmount \\AFS\all\athena.mit.edu
!     >fs rmmount \\AFS\all\.athena.mit.edu
! 
! Beginning in 1.3.74, the Freelance fake root.afs volume will support
! the creation of symlinks.
! 
!   >symlink make \\afs\all\link \\afs\all\athena.mit.edu\user\j\a\jaltman
! 
!   >symlink list \\afs\all\link
!   '\\afs\all\link' is a symlink to 'athena.mit.edu\user\j\a\jaltman'
! 
!   >symlink rm \\afs\all\link
! 
! The symlinks are stored in the registry at:
! 
!   HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks 
       
  
  4. The OpenAFS for Windows client will use AFSDB DNS records to 
***************
*** 358,363 ****
--- 372,390 ----
  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: openafs/doc/txt/winnotes/afs-issues.txt
diff -c openafs/doc/txt/winnotes/afs-issues.txt:1.8.2.6 openafs/doc/txt/winnotes/afs-issues.txt:1.8.2.7
*** openafs/doc/txt/winnotes/afs-issues.txt:1.8.2.6	Mon Oct 18 00:11:49 2004
--- openafs/doc/txt/winnotes/afs-issues.txt	Fri Nov  5 14:21:39 2004
***************
*** 73,78 ****
--- 73,80 ----
       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,134 ****
       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.
       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.
  
! (31) The Cache Manager Flush routines do not return or check error 
!      codes.        
  
  -------------------------------------------------------------------------
  List of unfunded projects:
--- 117,146 ----
       can be executed prior to the completion of the SMB registration
       and service thread initialization.
  
! (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
  
! (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.
! 
!      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,161 ****
     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
     9. Create new afs_admin.exe tool to be installed in the administrator folder (or use MMS) 
        which contains
--- 167,173 ----
     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 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,182 ****
    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
--- 188,194 ----
    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 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,200 ****
        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
        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: 
          Find
          FindUnique
          FindClose
--- 196,207 ----
        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
    19. Add support for SMB/CIFS Digital Signatures
!   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
!   20. Missing SMB/CIFS functions: 
          Find
          FindUnique
          FindClose
***************
*** 202,212 ****
          WriteBulk       
          WriteBulkData
          Tran2::SessionSetup
!   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.
! 
! 
--- 209,222 ----
          WriteBulk       
          WriteBulkData
          Tran2::SessionSetup
!   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.
!   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: openafs/doc/txt/winnotes/registry.txt
diff -c openafs/doc/txt/winnotes/registry.txt:1.18.2.3 openafs/doc/txt/winnotes/registry.txt:1.18.2.4
*** openafs/doc/txt/winnotes/registry.txt:1.18.2.3	Mon Oct 18 00:11:49 2004
--- openafs/doc/txt/winnotes/registry.txt	Fri Nov  5 14:21:39 2004
***************
*** 733,749 ****
  Type    : REG_SZ
  Default : <none>
  
!     This key is used to store newline 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"
  
      These values used to be stored in afs_freelance.ini
  
  
  Regkey:
  [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
  
  Value   : "submount name"
--- 733,766 ----
  Type    : REG_SZ
  Default : <none>
  
!     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."
!         ".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"
