doc/txt/winnotes/registry.txt

   1
   2 Registry keys and Environment Variables used in the Windows AFS Client
   3 ----------------------------------------------------------------------
   4
   5 REGISTRY KEYS:
   6
   7 1. Service parameters
   8 ---------------------
   9
  10 The service parameters primarily affect the behavior of the AFS client
  11 service (afsd_service.exe).
  12
  13 Regkey:
  14 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
  15
  16 Value   : LANadapter
  17 Type    : DWORD
  18 Default : -1
  19 Variable: LANadapter
  20
  21   LAN adapter number to use.  This is the lana number of the LAN
  22   adapter that the SMB server should bind to.  If unspecified or set
  23   to -1, a LAN adapter with named 'AFS' or a loopback adapter will be
  24   selected.  If neither are present, then all available adapters will
  25   be bound to.  When binding to a non-loopback adapter, the NetBIOS
  26   name '%hostname%-AFS' will be used (where %hostname% is the NetBIOS
  27   name of the host truncated to 11 characters). Otherwise, the NetBIOS
  28   name will be 'AFS'.
  29
  30 Value   : CacheSize
  31 Type    : DWORD
  32 Default : 20480 (CM_CONFIGDEFAULT_CACHESIZE)
  33 Variable: cm_initParams.cacheSize
  34
  35   Size of the AFS cache in 1k blocks.
  36
  37 Value   : ChunkSize
  38 Type    : DWORD
  39 Default : 15 (CM_CONFIGDEFAULT_CHUNKSIZE)
  40 Variable: cm_logChunkSize (cm_chunkSize = 1 << cm_logChunkSize)
  41
  42   Size of chunk for reading and writing. Actual chunk size is 2^cm_logChunkSize.
  43
  44 Value   : Daemons
  45 Type    : DWORD
  46 Default : 2 (CM_CONFIGDEFAULT_DAEMONS)
  47 Variable: numBkgD
  48
  49   Number of background daemons (number of threads of
  50   cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)
  51
  52 Value   : ServerThreads
  53 Type    : DWORD
  54 Default : 4 (CM_CONFIGDEFAULT_SVTHREADS)
  55 Variable: numSvThreads
  56
  57   Number of SMB server threads (number of threads of smb_Server). (see
  58   smb_Server in smb.c).
  59
  60 Value   : Stats
  61 Type    : DWORD
  62 Default : 1000 (CM_CONFIGDEFAULT_STATS)
  63 Variable: cm_initParams.nStatCaches
  64
  65   Cache configuration.
  66
  67 Value   : LogoffTokenTransfer
  68 Type    : DWORD {1,0}
  69 Default : 1
  70 Variable: smb_LogoffTokenTransfer
  71
  72   If enabled (set to 1), activates functionality where the user's
  73   tokens are kept intact until smb_LogoffTokenTransferTimeout seconds
  74   elapse after user logs off.  If roaming profiles are used and the
  75   roaming profile takes a long time to be written back, this ensures
  76   that the tokens remain valid until the profile save is complete.
  77
  78 Value   : LogoffTokenTransferTimeout
  79 Type    : DWORD
  80 Default : 10
  81 Variable: smb_LogoffTokenTransferTimeout
  82
  83   See LogoffTokenTransfer above.
  84
  85 Value   : RootVolume
  86 Type    : REG_SZ
  87 Default : "root.afs"
  88 Variable: cm_rootVolumeName
  89
  90   Root volume name.
  91
  92 Value   : Mountroot
  93 Type    : REG_SZ
  94 Default : "/afs"
  95 Variable: cm_mountRoot
  96
  97   Name of root mount point.  In symlinks, if a path starts with
  98   cm_mountRoot, it is assumed that the path is absolute (as opposed to
  99   relative) and is adjusted accordingly. Eg: if a path is specified as
 100   /afs/athena.mit.edu/foo/bar/baz and cm_mountRoot is "/afs", then the
 101   path is interpreted as \\afs\all\athena.mit.edu\foo\bar\baz.  If a
 102   path does not start with with cm_mountRoot, the path is assumed to
 103   be relative and suffixed to the reference directory (i.e. directory
 104   where the symlink exists)
 105
 106 Value   : CachePath
 107 Type    : REG_SZ or REG_EXPAND_SZ
 108 Default : "%SYSTEMDRIVE%\AFSCache"
 109 Variable: cm_CachePath
 110
 111   Location of on-disk cache file.  The default implies the root
 112   directory of the boot disk
 113
 114
 115 Value   : NonPersistentCaching
 116 Type    : DWORD [0..1]
 117 Default : 0
 118 Variable: buf_CacheType
 119
 120   When this registry value is set to a non-zero value, the CachePath
 121   value is ignored and the cache data is stored in the windows paging
 122   file.  This prevents the use of persistent caching (when available)
 123   as well as the ability to alter the size of the cache at runtime
 124   using the "fs setcachesize" command.
 125
 126
 127 Value   : TrapOnPanic
 128 Type    : DWORD {1,0}
 129 Default : 0
 130 Variable: traceOnPanic
 131
 132   Issues a breakpoint in the event of a panic. (breakpoint: _asm int 3).
 133
 134 Value   : NetbiosName
 135 Type    : REG_EXPAND_SZ
 136 Default : "AFS"
 137 Variable: cm_NetbiosName
 138
 139   Specifies the NetBIOS name to be used when binding to a Loopback
 140   adapter.  To provide the old behavior specify a value of
 141   "%COMPUTERNAME%-AFS"
 142
 143 Value   : IsGateway
 144 Type    : DWORD {1,0}
 145 Default : 0
 146 Variable: isGateway
 147
 148   Select whether or not this AFS client should act as a gateway.  If
 149   set and the NetBIOS name hostname-AFS is bound to a physical NIC,
 150   other machines in the subnet can access AFS via SMB connections to
 151   hostname-AFS.
 152
 153   When IsGateway is non-zero, the LAN adapter detection code will
 154   avoid binding to a loopback adapter.  This will ensure that the
 155   NetBIOS name will be of the form hostname-AFS instead of the value
 156   set by the "NetbiosName" registry value.
 157
 158 Value   : ReportSessionStartups
 159 Type    : DWORD {1,0}
 160 Default : 0
 161 Variable: reportSessionStartups
 162
 163   If enabled, all SMB sessions created are recorded in the Application
 164   event log.  This also enables other events such as drive mappings
 165   or various error types to be logged.
 166
 167 Value   : TraceBufferSize
 168 Type    : DWORD
 169 Default : 5000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)
 170 Variable: traceBufSize
 171
 172   Number of entries to keep in trace log.
 173
 174 Value   : SysName
 175 Type    : REG_SZ
 176 Default : "i386_nt40"
 177 Variable: cm_sysName
 178
 179   Self explanatory.
 180
 181 Value   : SecurityLevel
 182 Type    : DWORD {1,0}
 183 Default : 0
 184 Variable: cryptall
 185
 186   Enables encryption on RX calls.
 187
 188 Value   : UseDNS
 189 Type    : DWORD {1,0}
 190 Default : 1
 191 Variable: cm_dnsEnabled
 192
 193   Enables resolving volservers using AFSDB DNS queries. (see
 194   afsdb-freelance-notes).
 195
 196   As of 1.3.60, this value is ignored as the DNS query support
 197   utilizes the Win32 DNSQuery API which is available on Win2000
 198   and above.
 199
 200 Value   : FreelanceClient
 201 Type    : DWORD {1,0}
 202 Default : 0
 203 Variable: cm_freelanceEnabled
 204
 205   Enables freelance client. (see afsdb-freelance-notes)
 206
 207 Value   : HideDotFiles
 208 Type    : DWORD {1,0}
 209 Default : 1
 210 Variable: smb_hideDotFiles
 211
 212   Enables marking dotfiles with the hidden attribute.  Dot files are
 213   files whose name starts with a period (excluding "." and "..").
 214
 215 Value   : MaxMpxRequests
 216 Type    : DWORD
 217 Default : 50
 218 Variable: smb_maxMpxRequests
 219
 220   Maximum number of multiplexed SMB requests that can be made.
 221
 222 Value   : MaxVCPerServer
 223 Type    : DWORD
 224 Default : 100
 225 Variable: smb_maxVCPerServer
 226
 227   Maximum number of SMB virtual circuits.
 228
 229 Value   : Cell
 230 Type    : REG_SZ
 231 Default : <none>
 232 Variable: rootCellName
 233
 234   Name of root cell (the cell from which root.afs should be mounted in
 235   \\afs\all).
 236
 237 Value   : RxNoJumbo
 238 Type    : DWORD {0,1}
 239 Default : 0
 240 Variable: rx_nojumbo
 241
 242   If enabled, does not send or indicate that we are able to send or
 243   receive RX jumbograms.
 244
 245 Value   : RxMaxMTU
 246 Type    : DWORD
 247 Default : -1
 248 Variable: rx_mtu
 249
 250   If set to anything other than -1, uses that value as the maximum MTU
 251   supported by the RX interface.
 252
 253   In order to enable OpenAFS to operate across the Cisco IPSec VPN
 254   client, this value must be set to 1264 or smaller.
 255
 256 Value   : ConnDeadTimeout
 257 Type    : DWORD
 258 Default : 60 (seconds)
 259 Variable: ConnDeadtimeout
 260
 261   The Connection Dead Time is enforced to be at a minimum 15 seconds
 262   longer than the minimum SMB timeout as specified by
 263
 264   HKLM\SYSTEM\CurrentControlSet\Services\lanmanworkstation\parameters
 265     SessTimeout
 266
 267   If the minimum SMB timeout is not specified the value is 45 seconds.
 268   See http://support.microsoft.com:80/support/kb/articles/Q102/0/67.asp
 269
 270
 271 Value   : HardDeadTimeout
 272 Type    : DWORD
 273 Default : 120 (seconds)
 274 Variable: HardDeadtimeout
 275
 276   The Hard Dead Time is enforced to be at least double the ConnDeadTimeout.
 277   The provides an opportunity for at least one retry.
 278
 279
 280 Value  : TraceOption
 281 Type   : DWORD {0, 1, 2, 3}
 282 Default : 0
 283
 284   Enables logging of debug output to the Windows Event Log.
 285   Bit 0 enables logging of "Logon Events" processed by the Network Provider
 286   and Winlogon Event Notification Handler.
 287   Bit 1 enables logging of events captured by the AFS Client Service.
 288
 289 Value   : AllSubmount
 290 Type    : DWORD {0, 1}
 291 Default : 1
 292 Variable: allSubmount (smb.c)
 293
 294   By setting this value to 0, the "\\NetbiosName\all" mount point
 295   will not be created.  This allows the read-write versions of
 296   root.afs to be hidden.
 297
 298 Value   : NoFindLanaByName
 299 Type    : DWORD {0, 1}
 300 Default : 0
 301
 302   Disables the attempt to identity the network adapter to use by
 303   looking for an adapter with a display name of "AFS".
 304
 305 Value   : MaxCPUs
 306 Type    : DWORD {1..32} or {1..64} depending on the architecture
 307 Default : <no default>
 308
 309   If this value is specified, afsd_service.exe will restrict itself
 310   to executing on the specified number of CPUs if there are a greater
 311   number installed in the machine.
 312
 313   NOTE: Setting this entry to "1" may be required on hyperthreaded
 314   systems to avoid crashes in the RX library.
 315
 316 Value   : smbAuthType
 317 Type    : DWORD {0..2}
 318 Default : 2
 319
 320   If this value is specified, it defines the type of SMB authentication
 321   which must be present in order for the Windows SMB client to connect
 322   to the AFS Client Service's SMB server.  The values are:
 323     0 = No authentication required
 324     1 = NTLM authentication required
 325     2 = Extended (GSS SPNEGO) authentication required
 326   The default is Extended authentication
 327
 328 Value   : MaxLogSize
 329 Type    : DWORD {0 .. MAXDWORD}
 330 Default : 100K
 331
 332   This entry determines the maximum size of the %WINDIR%\TEMP\afsd_init.log
 333   file.  If the file is larger than this value when afsd_service.exe starts
 334   the file will be reset to 0 bytes.  If this value is 0, it means the file
 335   should be allowed to grow indefinitely.
 336
 337
 338 Regkey:
 339 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]
 340
 341 Value   : <Drive Letter:> for example "G:"
 342 Type    : SZ
 343
 344     Specifies the submount name to be mapped by afsd_service.exe at startup
 345     to the provided drive letter.
 346
 347
 348
 349 Regkey:
 350 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
 351
 352
 353 2. Network provider parameters
 354 ------------------------------
 355 Affects the network provider (afslogon.dll).
 356
 357 Regkey:
 358 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
 359
 360 Value   : FailLoginsSilently
 361 Type    : DWORD
 362 Default : 0
 363
 364   Do not display message boxes if the login fails.
 365
 366 Regkey:
 367 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
 368
 369 Value   : NoWarnings
 370 Type    : DWORD
 371 Default : 0
 372
 373   Disables visible warnings during logon.
 374
 375 Value   : AuthentProviderPath
 376 Type    : REG_SZ
 377 NSIS    : %WINDIR%\SYSTEM32\afslogon.dll
 378
 379   Specifies the install location of the authentication provider dll.
 380
 381 Value   : Class
 382 Type    : DWORD
 383 NSIS    : 0x02
 384
 385   Specifies the class of network provider
 386
 387 Value   : DependOnGroup
 388 Type    : REG_MULTI_SZ
 389 NSIS    : PNP_TDI
 390
 391   Specifies the service groups upon which the AFS Client Service
 392   depends.  Windows should not attempt to start the AFS Client Service
 393   until all of the services within these groups have successfully
 394   started.
 395
 396 Value   : DependOnService
 397 Type    : REG_MULTI_SZ
 398 NSIS    : Tcpip NETBIOS RpcSs
 399
 400   Specifies a list of services upon which the AFS Client Service
 401   depends.  Windows should not attempt to start the AFS Client Service
 402   until all of the specified services have successfully started.
 403
 404 Value   : Name
 405 Type    : REG_SZ
 406 NSIS    : "OpenAFSDaemon"
 407
 408   Specifies the display name of the AFS Client Service
 409
 410 Value   : ProviderPath
 411 Type    : REG_SZ
 412 NSIS    : %WINDIR%\SYSTEM32\afslogon.dll
 413
 414   Specifies the DLL to use for the network provider
 415
 416
 417 Regkey:
 418 [HKLM\SOFTWARE\OpenAFS\Client]
 419
 420 Value   : CellServDBDir
 421 Type    : REG_SZ
 422 Default : <not defined>
 423
 424   Specifies the directory containing the CellServDB file.
 425   When this value is not specified, the AFS Client install
 426   directory is used.
 427
 428
 429
 430 2.1 Domain specific configuration keys for the Network Provider
 431 ---------------------------------------------------------------
 432
 433 The network provider can be configured to have different behavior
 434 depending on the domain that the user logs into.  These settings are
 435 only relevant when using integrated login.  A domain refers to an
 436 Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
 437 local machine (i.e. local account logins).  The domain name that is
 438 used for selecting the domain would be the domain that is passed into
 439 the NPLogonNotify function of the network provider.
 440
 441 Domain specific registry keys are :
 442
 443 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
 444   (NP key)
 445
 446 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]
 447   (Domains key)
 448
 449 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain name"]
 450   (Specific domain key. One per domain.)
 451
 452 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]
 453   (Localhost key)
 454
 455 eg:
 456  HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider
 457   |
 458   +- Domain
 459      +-AD1.EXAMPLE.COM
 460      +-AD2.EXAMPLE.NET
 461      +-LOCALHOST
 462
 463 Each of the domain specific keys can have the set of values described
 464 in 2.1.1.  The effective values are chosen as described in 2.1.2.
 465
 466 2.1.1  Domain specific configuration values
 467 -------------------------------------------
 468 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
 469 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]
 470 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain name"]
 471 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]
 472
 473   Value   : LogonOptions
 474   Type    : DWORD
 475   Default : 0x01
 476   NSIS/WiX: depends on user configuration
 477
 478   0x00 - Integrated Logon is not used
 479   0x01 - Integrated Logon is used
 480   0x02 - High Security Mode is used
 481   0x03 - Integrated Logon with High Security Mode is used
 482
 483   High Security Mode generates random SMB names for the creation of
 484   Drive Mappings.  This mode should not be used without Integrated Logon.
 485
 486   As of 1.3.65 the SMB server supports SMB authentication.  The High
 487   Security Mode should not be used when using SMB authentication
 488   (SMBAuthType setting is non zero).
 489
 490   Value   : FailLoginsSilently
 491   Type    : DWORD (1|0)
 492   Default : 0
 493   NSIS/WiX: (not set)
 494
 495      If true, does not display any visible warnings in the event of an
 496      error during the integrated login process.
 497
 498   Value   : LogonScript
 499   Type    : REG_SZ or REG_EXPAND_SZ
 500   Default : (null)
 501   NSIS/WiX: (only value under NP key) <install path>\afscreds.exe -:%s -x -a -m -n -q
 502
 503      A logon script that will be scheduled to be run after the profile
 504      load is complete.  If using the REG_EXPAND_SZ type, you can use
 505      any system environment variable as "%varname%" which would be
 506      expanded at the time the network provider is run.  Optionally
 507      using a "%s" in the value would result in it being expanded into
 508      the AFS SMB username for the session.
 509
 510   Value   : LoginRetryInterval
 511   Type    : DWORD
 512   Default : 30
 513   NSIS/WiX: (not set)
 514
 515      If the OpenAFS client service has not started yet, the network
 516      provider will wait for a maximum of "LoginRetryInterval" seconds
 517      while retrying every "LoginSleepInterval" seconds to check if the
 518      service is up.
 519
 520   Value   : LoginSleepInterval
 521   Type    : DWORD
 522   Default : 5
 523   NSIS/WiX: (not set)
 524
 525      See description of LoginRetryInterval.
 526
 527
 528 2.1.2  Selection of effective values for domain specific configuration
 529 ----------------------------------------------------------------------
 530
 531   During login to domain X, where X is the domain passed into
 532   NPLogonNotify as lpAuthentInfo->LogonDomainName or the string
 533   'LOCALHOST' if lpAuthentInfo->LogonDomainName equals the name of the
 534   computer, the following keys will be looked up.
 535
 536     1. NP key. ("HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider")
 537     2. Domains key. (NP key\"Domain")
 538     3. Specific domain key. (Domains key\X)
 539
 540   If the specific domain key does not exist, then the domains key will
 541   be ignored.  All the configuration information in this case will
 542   come from the NP key.
 543
 544   If the specific domain key exists, then for each of the values
 545   metioned in (2), they will be looked up in the specific domain key,
 546   domains key and the NP key successively until the value is found.
 547   The first instance of the value found this way will be the effective
 548   for the login session.  If no such instance can be found, the
 549   default will be used.  To re-iterate, a value in a more specific key
 550   supercedes a value in a less specific key.  The exceptions to this
 551   rule are stated below.
 552
 553 2.1.3  Exceptions to 2.1.2
 554 --------------------------
 555
 556   To retain backwards compatibility, the following exceptions are made
 557   to 2.1.2.
 558
 559 2.1.3.1 'FailLoginsSilently'
 560
 561   Historically, the 'FailLoginsSilently' value was in
 562   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
 563   key and not in the NP key.  Therefore, for backwards compatibility,
 564   the value in the Parameters key will supercede all instances of this
 565   value in other keys.  In the absence of this value in the Parameters
 566   key, normal scope rules apply.
 567
 568 2.1.3.2 'LogonScript'
 569
 570   If a 'LogonScript' is not specified in the specific domain key nor
 571   in the domains key, the value in the NP key will only be checked if
 572   the effective 'LogonOptions' specify a high security integrated
 573   login.  If a logon script is specified in the specific domain key or
 574   the domains key, it will be used regardless of the high security
 575   setting.  Please be aware of this when setting this value.
 576
 577
 578 3. AFS Credentials System Tray Tool parameters
 579 ----------------------------------------------
 580 Affects the behavior of afscreds.exe
 581
 582 Regkey:
 583 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
 584
 585 Value   : Gateway
 586 Type    : REG_SZ
 587 Default : ""
 588 Function: GetGatewayName()
 589
 590   If the AFS client is utilizing a gateway to obtain AFS access,
 591   the name of the gateway is specified by this value.
 592
 593 Value   : Cell
 594 Type    : REG_SZ
 595 Default : <none>
 596 Variable: IsServiceConfigured()
 597
 598   The value Cell is used to determine if the AFS Client Service has
 599   been properly configured or not.
 600
 601
 602 Regkey:
 603 [HKLM\SOFTWARE\OpenAFS\Client]
 604 [HKCU\SOFTWARE\OpenAFS\Client]
 605
 606 Value   : ShowTrayIcon
 607 Type    : DWORD {0, 1}
 608 Default : 1
 609 Function: InitApp(), Main_OnCheckTerminate()
 610
 611   This value is used to determine whether or not a shortcut should be
 612   maintained in the user's Start Menu->Programs->Startup folder.
 613
 614   This value used to be stored at
 615   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].
 616
 617   The current user value is checked first; if it does not exist the local
 618   machine value is checked.
 619
 620
 621 Value   : EnableKFW
 622 Type    : DWORD {0, 1}
 623 Default : 1
 624 Function: KFW_is_available()
 625
 626   When MIT Kerberos for Windows can be loaded, Kerberos 5 will be used
 627   to obtain AFS credentials.  By setting this value to 0, the internal
 628   Kerberos 4 implementation will be used instead.  The current user value
 629   is checked first; if it does not exist the local machine value is checked.
 630
 631 Value   : AfscredsShortcutParams
 632 Type    : REG_SZ
 633 Default : "-A -M -N -Q"
 634 Function: Shortcut_FixStartup
 635
 636   This value specifies the command line options which should be set
 637   as part of the shortcut to afscreds.exe.  afscreds.exe rewrites the
 638   shortcut each time it exits so as to ensure that the shortcut points
 639   to the latest version of the program.  This value is used to determine
 640   which values should be used for command line parameters.  The current
 641   user value is checked first; if it does not exist the local machine
 642   value is checked.
 643
 644
 645 Regkey:
 646 [HKCU\SOFTWARE\OpenAFS\Client]
 647
 648 Value   : Authentication Cell
 649 Type    : REG_SZ
 650 Default : <none>
 651 Function: Afscreds.exe GetDefaultCell()
 652
 653   This value allows the user to configure a different cell name to
 654   be used as the default cell when acquiring tokens in afscreds.exe
 655
 656
 657 Regkey:
 658 [HKCU\SOFTWARE\OpenAFS\Client\Reminders]
 659
 660 Value   : "afs cell name"
 661 Type    : DWORD {0, 1}
 662 Default : <none>
 663 Function: LoadRemind(), SaveRemind()
 664
 665   These values are used to save and restore the state of the reminder
 666   flag for each cell for which the user has obtained tokens.
 667
 668   This value used to be stored at
 669   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].
 670
 671
 672 Regkey:
 673 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
 674
 675 Value   : "upper case drive letter"
 676 Type    : DWORD {0, 1}
 677 Default : <none>
 678
 679   These values are used to store the persistence state of the AFS
 680   drive mappings as listed in the [...\Client\Mappings] key
 681
 682   These values used to be stored in the afsdsbmt.ini file
 683
 684 Regkey:
 685 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
 686
 687 Value   : "upper case drive letter"
 688 Type    : REG_SZ
 689 Default : <none>
 690
 691   These values are used to store the AFS path in Unix notation
 692   to which the drive letter is to be mapped.
 693
 694   These values used to be stored in the afsdsbmt.ini file.
 695
 696
 697 Regkey:
 698 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
 699
 700 Value   : "smb/cifs share name"
 701 Type    : REG_SZ
 702 Default : <none>
 703
 704     This key is used to map SMB/CIFS shares to Client Side Caching
 705     (off-line access) policies. For each share one of the following
 706     policies may be used: "manual", "programs", "documents", "disable"
 707
 708     These values used to be stored in afsdsbmt.ini
 709
 710 Regkey:
 711 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
 712
 713 Value   : "numeric value"
 714 Type    : REG_SZ
 715 Default : <none>
 716
 717     This key is used to store newline terminated mount point strings
 718     for use in constructing the fake root.afs volume when Freelance
 719     (dynamic roots) mode is activated.
 720
 721         "athena.mit.edu#athena.mit.edu:root.cell.\n"
 722         ".athena.mit.edu%athena.mit.edu:root.cell.\n"
 723
 724     These values used to be stored in afs_freelance.ini
 725
 726
 727 Regkey:
 728 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
 729
 730 Value   : "submount name"
 731 Type    : REG_SZ
 732 Default : <none>
 733
 734     This key is used to store mappings of unix style AFS paths
 735     to submount names which can be referenced as UNC paths.
 736     For example the submount string "/athena.mit.edu/user/j/a/jaltman"
 737     can be associated with the submount name "jaltman.home".
 738     This can then be referenced as the UNC path \\AFS\jaltman.home.
 739
 740     These values used to be stored in afsdsbmt.ini
 741
 742
 743 ENVIRONMENT VARIABLES:
 744
 745 Variable: AFS_RPC_ENCRYPT
 746 Values:   "OFF" disables the use of RPC encryption
 747           any other value allows RPC encryption to be used
 748 Default:  RPC encryption is on
 749
 750
 751 Variable: AFS_RPC_PROTSEQ
 752 Values:   "ncalrpc"  - local RPC
 753           "ncacn_np" - named pipes
 754           "ncacn_ip_tcp" - tcp/ip
 755 Default:  local RPC
 756