winnotes-registry-20040708
[openafs.git] / doc / txt / winnotes / registry.txt
index 1e71ae9..ee1ede4 100644 (file)
@@ -1,8 +1,8 @@
 
-Registry keys used in the Windows AFS Client
---------------------------------------------
+Registry keys and Environment Variables used in the Windows AFS Client
+----------------------------------------------------------------------
 
-This file describes the registry keys used in the Windows AFS clients.
+REGISTRY KEYS:
 
 1. Service parameters
 ---------------------
@@ -240,6 +240,30 @@ Variable: rx_mtu
   In order to enable OpenAFS to operate across the Cisco IPSec VPN
   client, this value must be set to 1264 or smaller.
 
+Value  : ConnDeadTimeout
+Type   : DWORD
+Default : 60 (seconds)
+Variable: ConnDeadtimeout
+
+  The Connection Dead Time is enforced to be at a minimum 15 seconds 
+  longer than the minimum SMB timeout as specified by 
+
+  HKLM\SYSTEM\CurrentControlSet\Services\lanmanworkstation\parameters
+    SessTimeout
+
+  If the minimum SMB timeout is not specified the value is 45 seconds.
+  See http://support.microsoft.com:80/support/kb/articles/Q102/0/67.asp
+
+
+Value  : HardDeadTimeout
+Type   : DWORD
+Default : 120 (seconds)
+Variable: HardDeadtimeout
+
+  The Hard Dead Time is enforced to be at least double the ConnDeadTimeout.
+  The provides an opportunity for at least one retry.
+
+
 Value   : AllSubmount
 Type    : DWORD {0, 1}
 Default : 1
@@ -256,6 +280,27 @@ Default : 0
   Disables the attempt to identity the network adapter to use by 
   looking for an adapter with a display name of "AFS".
 
+Value   : MaxCPUs
+Type    : DWORD {1..32} or {1..64} depending on the architecture
+Default : <no default>
+
+  If this value is specified, afsd_service.exe will restrict itself
+  to executing on the specified number of CPUs if there are a greater
+  number installed in the machine.  
+
+  NOTE: Setting this entry to "1" may be required on hyperthreaded 
+  systems to avoid crashes in the RX library.
+
+
+Regkey:
+[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]
+
+Value   : <Drive Letter:> for example "G:"
+Type    : SZ
+
+    Specifies the submount name to be mapped by afsd_service.exe at startup
+    to the provided drive letter.
+
 
 
 Regkey:
@@ -422,3 +467,17 @@ Function: LoadRemind(), SaveRemind()
   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].
 
 
+ENVIRONMENT VARIABLES:
+
+Variable: AFS_RPC_ENCRYPT 
+Values:   "OFF" disables the use of RPC encryption
+          any other value allows RPC encryption to be used
+Default:  RPC encryption is on
+
+
+Variable: AFS_RPC_PROTSEQ
+Values:   "ncalrpc"  - local RPC 
+          "ncacn_np" - named pipes
+          "ncacn_ip_tcp" - tcp/ip
+Default:  local RPC
+