WHATSNEW: Add release notes for Samba 4.0.26.
[samba.git] / source / lib / registry / README
1 This is the registry library. The registry is basically a bunch of
2 hives, each of which is loaded from a file. When using a local registry, 
3 it is possible to specify where hives should be loaded from, etc. 
4
5 There are separate APIs for accessing the data in a hive and the 
6 data in the registry itself. Each supports different backends. 
7
8 The following "full registry" backends are currently provided:
9
10  * Remote (over DCE/RPC)
11  * Local (allows "mounting" hives)
12  * Wine (uses the wine plain-text file)
13
14 The following hive backends are supported:
15
16  - ldb 
17  - regf (NTUSER.DAT-style files)
18  - rpc (Remote individual hives)
19  - directory
20
21 reg_open_samba() loads a set of hives based on smb.conf settings.
22 Lines in smb.conf should have the following syntax:
23
24 registry:<hivename> = <backend>:<location>
25
26 So an example usage could be:
27
28 registry:HKEY_CURRENT_USER = regf:NTUSER.DAT
29 registry:HKEY_LOCAL_MACHINE = ldb:tdb://registry.tdb
30
31 WERR_NOT_SUPPORTED will be returned for all hives that haven't been set.
32
33 On Windows the various registry hives are loaded from:
34
35 HKEY_CURRENT_CONFIG: %SystemRoot%\System32\Config\System
36 HKEY_CURRENT_USER: %Profile%\NTUser.dat
37 HKEY_LOCAL_MACHINE\SAM: %SystemRoot%\System32\Config\Sam
38 HKEY_LOCAL_MACHINE\Security: %SystemRoot%\System32\Config\Security
39 HKEY_LOCAL_MACHINE\Software: %SystemRoot%\System32\Config\Software
40 HKEY_LOCAL_MACHINE\System: %SystemRoot%\System32\Config\System
41 HKEY_USERS\.DEFAULT: %SystemRoot%\System32\Config\Default
42 HKEY_LOCAL_MACHINE\HARDWARE: is autogenerated