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