source4/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