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