r9700: Change DATA_BLOB in ejs back to struct datablob
[kai/samba.git] / source / lib / registry / README
1 This is the registry library. The registry is basically a bunch of
2 hives that can be loaded from different places.
3
4 The various registry backends provide support for loading/saving
5 specific types of hives:
6
7  - ldb 
8  - w95 (USER.DAT-style files)
9  - nt4 (NTUSER.DAT-style files)
10  - gconf (GNOME configuration)
11  - rpc (Remote individual hives)
12
13 Instead of opening individual hives, one can also open a 'complete'
14 registry by using one of these three functions:
15  
16  - reg_open_local() - load local registry, see below
17  - reg_open_remote() - connect to remote registry over RPC
18  - reg_open_wine() (not working yet)
19
20 reg_open_local() loads a set of hives based on smb.conf settings.
21 Lines in smb.conf should have the following syntax:
22
23 registry:<hivename> = <backend>:<location>
24
25 So an example usage could be:
26
27 registry:HKEY_CURRENT_USER = nt4:NTUSER.DAT
28 registry:HKEY_LOCAL_MACHINE = ldb:tdb://registry.tdb
29
30 WERR_NOT_SUPPORTED will be returned for all hives that haven't been set.
31
32 On Windows the various registry hives are loaded from:
33
34 HKEY_CURRENT_CONFIG: %SystemRoot%\System32\Config\System
35 HKEY_CURRENT_USER: %Profile%\NTUser.dat
36 HKEY_LOCAL_MACHINE\SAM: %SystemRoot%\System32\Config\Sam
37 HKEY_LOCAL_MACHINE\Security: %SystemRoot%\System32\Config\Security
38 HKEY_LOCAL_MACHINE\Software: %SystemRoot%\System32\Config\Software
39 HKEY_LOCAL_MACHINE\System: %SystemRoot%\System32\Config\System
40 HKEY_USERS\.DEFAULT: %SystemRoot%\System32\Config\Default
41 HKEY_LOCAL_MACHINE\HARDWARE: is autogenerated