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