06db62fefc69c9bc67a4a54de241815a58c9c24b
[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
340 Regkey:
341 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]
342
343 Value   : <Drive Letter:> for example "G:"
344 Type    : SZ
345
346     Specifies the submount name to be mapped by afsd_service.exe at startup
347     to the provided drive letter.
348
349
350
351 Regkey:
352 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
353
354
355 2. Network provider parameters
356 ------------------------------
357 Affects the network provider (afslogon.dll).
358
359 Regkey:
360 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
361
362 Value   : FailLoginsSilently
363 Type    : DWORD
364 Default : 0
365
366   Do not display message boxes if the login fails.
367
368 Regkey:
369 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
370
371 Value   : NoWarnings
372 Type    : DWORD
373 Default : 0
374
375   Disables visible warnings during logon.
376
377 Value   : AuthentProviderPath
378 Type    : REG_SZ
379 NSIS    : %WINDIR%\SYSTEM32\afslogon.dll
380
381   Specifies the install location of the authentication provider dll.
382
383 Value   : Class
384 Type    : DWORD
385 NSIS    : 0x02
386
387   Specifies the class of network provider
388
389 Value   : DependOnGroup
390 Type    : REG_MULTI_SZ
391 NSIS    : PNP_TDI
392
393   Specifies the service groups upon which the AFS Client Service 
394   depends.  Windows should not attempt to start the AFS Client Service
395   until all of the services within these groups have successfully 
396   started.
397
398 Value   : DependOnService
399 Type    : REG_MULTI_SZ
400 NSIS    : Tcpip NETBIOS RpcSs
401
402   Specifies a list of services upon which the AFS Client Service 
403   depends.  Windows should not attempt to start the AFS Client Service
404   until all of the specified services have successfully started.
405   
406 Value   : Name
407 Type    : REG_SZ
408 NSIS    : "OpenAFSDaemon"
409
410   Specifies the display name of the AFS Client Service
411
412 Value   : ProviderPath
413 Type    : REG_SZ
414 NSIS    : %WINDIR%\SYSTEM32\afslogon.dll
415
416   Specifies the DLL to use for the network provider
417
418
419 Regkey:
420 [HKLM\SOFTWARE\OpenAFS\Client]
421
422 Value   : CellServDBDir
423 Type    : REG_SZ
424 Default : <not defined>
425
426   Specifies the directory containing the CellServDB file.
427   When this value is not specified, the AFS Client install
428   directory is used.
429
430
431
432 2.1 Domain specific configuration keys for the Network Provider
433 ---------------------------------------------------------------
434
435 The network provider can be configured to have different behavior
436 depending on the domain that the user logs into.  These settings are
437 only relevant when using integrated login.  A domain refers to an
438 Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the
439 local machine (i.e. local account logins).  The domain name that is
440 used for selecting the domain would be the domain that is passed into
441 the NPLogonNotify function of the network provider.
442
443 Domain specific registry keys are :
444
445 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
446   (NP key)
447
448 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]
449   (Domains key)
450
451 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain name"]
452   (Specific domain key. One per domain.)
453
454 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]
455   (Localhost key)
456
457 eg:
458  HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider
459   |
460   +- Domain
461      +-AD1.EXAMPLE.COM
462      +-AD2.EXAMPLE.NET
463      +-LOCALHOST
464
465 Each of the domain specific keys can have the set of values described
466 in 2.1.1.  The effective values are chosen as described in 2.1.2.
467
468 2.1.1  Domain specific configuration values
469 -------------------------------------------
470 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
471 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]
472 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain name"]
473 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]
474
475   Value   : LogonOptions
476   Type    : DWORD
477   Default : 0x01
478   NSIS/WiX: depends on user configuration
479
480   0x00 - Integrated Logon is not used
481   0x01 - Integrated Logon is used
482   0x02 - High Security Mode is used
483   0x03 - Integrated Logon with High Security Mode is used
484
485   High Security Mode generates random SMB names for the creation of
486   Drive Mappings.  This mode should not be used without Integrated Logon.
487
488   As of 1.3.65 the SMB server supports SMB authentication.  The High
489   Security Mode should not be used when using SMB authentication
490   (SMBAuthType setting is non zero).
491
492   Value   : FailLoginsSilently
493   Type    : DWORD (1|0)
494   Default : 0
495   NSIS/WiX: (not set)
496
497      If true, does not display any visible warnings in the event of an
498      error during the integrated login process.
499
500   Value   : LogonScript
501   Type    : REG_SZ or REG_EXPAND_SZ
502   Default : (null)
503   NSIS/WiX: (only value under NP key) <install path>\afscreds.exe -:%s -x -a -m -n -q
504
505      A logon script that will be scheduled to be run after the profile
506      load is complete.  If using the REG_EXPAND_SZ type, you can use
507      any system environment variable as "%varname%" which would be
508      expanded at the time the network provider is run.  Optionally
509      using a "%s" in the value would result in it being expanded into
510      the AFS SMB username for the session.
511
512   Value   : LoginRetryInterval
513   Type    : DWORD
514   Default : 30
515   NSIS/WiX: (not set)
516
517      If the OpenAFS client service has not started yet, the network
518      provider will wait for a maximum of "LoginRetryInterval" seconds
519      while retrying every "LoginSleepInterval" seconds to check if the
520      service is up.
521
522   Value   : LoginSleepInterval
523   Type    : DWORD
524   Default : 5
525   NSIS/WiX: (not set)
526
527      See description of LoginRetryInterval.
528
529
530 2.1.2  Selection of effective values for domain specific configuration
531 ----------------------------------------------------------------------
532
533   During login to domain X, where X is the domain passed into
534   NPLogonNotify as lpAuthentInfo->LogonDomainName or the string
535   'LOCALHOST' if lpAuthentInfo->LogonDomainName equals the name of the
536   computer, the following keys will be looked up.
537
538     1. NP key. ("HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider")
539     2. Domains key. (NP key\"Domain")
540     3. Specific domain key. (Domains key\X)
541
542   If the specific domain key does not exist, then the domains key will
543   be ignored.  All the configuration information in this case will
544   come from the NP key.
545
546   If the specific domain key exists, then for each of the values
547   metioned in (2), they will be looked up in the specific domain key,
548   domains key and the NP key successively until the value is found.
549   The first instance of the value found this way will be the effective
550   for the login session.  If no such instance can be found, the
551   default will be used.  To re-iterate, a value in a more specific key
552   supercedes a value in a less specific key.  The exceptions to this
553   rule are stated below.
554
555 2.1.3  Exceptions to 2.1.2
556 --------------------------
557
558   To retain backwards compatibility, the following exceptions are made
559   to 2.1.2.
560
561 2.1.3.1 'FailLoginsSilently'
562
563   Historically, the 'FailLoginsSilently' value was in
564   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
565   key and not in the NP key.  Therefore, for backwards compatibility,
566   the value in the Parameters key will supercede all instances of this
567   value in other keys.  In the absence of this value in the Parameters
568   key, normal scope rules apply.
569
570 2.1.3.2 'LogonScript'
571
572   If a 'LogonScript' is not specified in the specific domain key nor
573   in the domains key, the value in the NP key will only be checked if
574   the effective 'LogonOptions' specify a high security integrated
575   login.  If a logon script is specified in the specific domain key or
576   the domains key, it will be used regardless of the high security
577   setting.  Please be aware of this when setting this value.
578
579
580 3. AFS Credentials System Tray Tool parameters
581 ----------------------------------------------
582 Affects the behavior of afscreds.exe
583
584 Regkey:
585 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
586
587 Value   : Gateway
588 Type    : REG_SZ
589 Default : ""
590 Function: GetGatewayName()
591
592   If the AFS client is utilizing a gateway to obtain AFS access, 
593   the name of the gateway is specified by this value.
594
595 Value   : Cell
596 Type    : REG_SZ
597 Default : <none>
598 Variable: IsServiceConfigured()
599
600   The value Cell is used to determine if the AFS Client Service has
601   been properly configured or not.
602
603
604 Regkey:
605 [HKLM\SOFTWARE\OpenAFS\Client]
606 [HKCU\SOFTWARE\OpenAFS\Client]
607
608 Value   : ShowTrayIcon
609 Type    : DWORD {0, 1}
610 Default : 1
611 Function: InitApp(), Main_OnCheckTerminate()
612
613   This value is used to determine whether or not a shortcut should be
614   maintained in the user's Start Menu->Programs->Startup folder. 
615
616   This value used to be stored at 
617   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].
618
619   The current user value is checked first; if it does not exist the local 
620   machine value is checked.
621
622
623 Value   : EnableKFW
624 Type    : DWORD {0, 1}
625 Default : 1
626 Function: KFW_is_available()
627
628   When MIT Kerberos for Windows can be loaded, Kerberos 5 will be used
629   to obtain AFS credentials.  By setting this value to 0, the internal
630   Kerberos 4 implementation will be used instead.  The current user value 
631   is checked first; if it does not exist the local machine value is checked.
632
633 Value   : Use524
634 Type    : DWORD {0, 1}
635 Default : 0
636 Function: KFW_use_krb524()
637
638   When MIT Kerberos for Windows can be loaded, Kerberos 5 will be used
639   to obtain AFS credentials.  By setting this value to 1, the Kerberos 5
640   tickets will be converted to Kerberos 4 tokens via a call to the krb524
641   daemon.  The current user value is checked first; if it does not exist 
642   the local machine value is checked.
643
644 Value   : AfscredsShortcutParams
645 Type    : REG_SZ
646 Default : "-A -M -N -Q"
647 Function: Shortcut_FixStartup
648
649   This value specifies the command line options which should be set
650   as part of the shortcut to afscreds.exe.  afscreds.exe rewrites the 
651   shortcut each time it exits so as to ensure that the shortcut points
652   to the latest version of the program.  This value is used to determine
653   which values should be used for command line parameters.  The current
654   user value is checked first; if it does not exist the local machine
655   value is checked.
656
657
658 Regkey:
659 [HKCU\SOFTWARE\OpenAFS\Client]
660
661 Value   : Authentication Cell
662 Type    : REG_SZ
663 Default : <none>
664 Function: Afscreds.exe GetDefaultCell()
665
666   This value allows the user to configure a different cell name to
667   be used as the default cell when acquiring tokens in afscreds.exe
668
669
670 Regkey:
671 [HKCU\SOFTWARE\OpenAFS\Client\Reminders]
672
673 Value   : "afs cell name"
674 Type    : DWORD {0, 1}
675 Default : <none>
676 Function: LoadRemind(), SaveRemind()
677
678   These values are used to save and restore the state of the reminder
679   flag for each cell for which the user has obtained tokens.
680
681   This value used to be stored at 
682   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].
683
684
685 Regkey:
686 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
687
688 Value   : "upper case drive letter"
689 Type    : DWORD {0, 1}
690 Default : <none>
691
692   These values are used to store the persistence state of the AFS 
693   drive mappings as listed in the [...\Client\Mappings] key
694
695   These values used to be stored in the afsdsbmt.ini file
696
697 Regkey:
698 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
699
700 Value   : "upper case drive letter"
701 Type    : REG_SZ
702 Default : <none>
703
704   These values are used to store the AFS path in Unix notation
705   to which the drive letter is to be mapped.
706
707   These values used to be stored in the afsdsbmt.ini file.
708
709
710 Regkey:
711 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
712
713 Value   : "smb/cifs share name"
714 Type    : REG_SZ
715 Default : <none>
716
717     This key is used to map SMB/CIFS shares to Client Side Caching 
718     (off-line access) policies. For each share one of the following
719     policies may be used: "manual", "programs", "documents", "disable"
720
721     These values used to be stored in afsdsbmt.ini
722
723 Regkey:
724 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
725
726 Value   : "numeric value"
727 Type    : REG_SZ
728 Default : <none>
729
730     This key is used to store newline terminated mount point strings 
731     for use in constructing the fake root.afs volume when Freelance
732     (dynamic roots) mode is activated.
733
734         "athena.mit.edu#athena.mit.edu:root.cell.\n"
735         ".athena.mit.edu%athena.mit.edu:root.cell.\n"
736
737     These values used to be stored in afs_freelance.ini
738
739
740 Regkey:
741 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
742
743 Value   : "submount name"
744 Type    : REG_EXPAND_SZ
745 Default : <none>
746
747     This key is used to store mappings of unix style AFS paths
748     to submount names which can be referenced as UNC paths.
749     For example the submount string "/athena.mit.edu/user/j/a/jaltman"
750     can be associated with the submount name "jaltman.home".
751     This can then be referenced as the UNC path \\AFS\jaltman.home.
752
753     These values used to be stored in afsdsbmt.ini
754
755
756 ENVIRONMENT VARIABLES:
757
758 Variable: AFS_RPC_ENCRYPT 
759 Values:   "OFF" disables the use of RPC encryption
760           any other value allows RPC encryption to be used
761 Default:  RPC encryption is on
762
763
764 Variable: AFS_RPC_PROTSEQ
765 Values:   "ncalrpc"  - local RPC 
766           "ncacn_np" - named pipes
767           "ncacn_ip_tcp" - tcp/ip
768 Default:  local RPC
769