r4132: - Bunch of rather large fixes in the registry
[gd/samba-autobuild/.git] / source4 / lib / registry / README
1 This is the registry library. The registry is basically a bunch of hives 
2 (HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, etc) that can be loaded from 
3 different places.
4
5 The various registry backends provide support for loading/saving specific types 
6 of hives:
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' registry by 
14 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.