samba-mirror

mirror of https://github.com/samba-team/samba.git synced 2025-01-11 05:18:09 +03:00

History

Jelmer Vernooij 9547649006 r4299: Store REG_SZ, REG_EXPAND_SZ and REG_DWORD values in human-readable (and human-editable) format in the ldb registry backend. (This used to be commit `6eafd055d1`)		2007-10-10 13:07:32 -05:00
..
common	r4299: Store REG_SZ, REG_EXPAND_SZ and REG_DWORD values in human-readable (and human-editable) format in	2007-10-10 13:07:32 -05:00
tools	r4209: Fix several smaller bugs	2007-10-10 13:07:27 -05:00
config.m4	r3733: More build system fixes/features:	2007-10-10 13:05:47 -05:00
config.mk	r4132: - Bunch of rather large fixes in the registry	2007-10-10 13:06:29 -05:00
README	r4155: More destinction between hives and predefined keys	2007-10-10 13:07:20 -05:00
reg_backend_dir.c	r4209: Fix several smaller bugs	2007-10-10 13:07:27 -05:00
reg_backend_gconf.c	r4137: Make *_open_key take a registry_key instead of a hive (more efficient	2007-10-10 13:06:30 -05:00
reg_backend_ldb.c	r4299: Store REG_SZ, REG_EXPAND_SZ and REG_DWORD values in human-readable (and human-editable) format in	2007-10-10 13:07:32 -05:00
reg_backend_nt4.c	r4213: Store REG_SZ in UTF16, not the unix charset..	2007-10-10 13:07:27 -05:00
reg_backend_rpc.c	r4209: Fix several smaller bugs	2007-10-10 13:07:27 -05:00
reg_backend_w95.c	r4166: More small API fixes, keep registry structs as small as possible.	2007-10-10 13:07:21 -05:00
reg_backend_wine.c	r4132: - Bunch of rather large fixes in the registry	2007-10-10 13:06:29 -05:00
reg_samba.c	r4155: More destinction between hives and predefined keys	2007-10-10 13:07:20 -05:00
TODO	r2518: Some long overdue changes:	2007-10-10 12:59:01 -05:00
winregistry.pc.in	r20: Add the registry library. Still needs a lot of work,	2007-10-10 12:50:33 -05:00

README

This is the registry library. The registry is basically a bunch of hives 
that can be loaded from different places.

The various registry backends provide support for loading/saving specific types 
of hives:
 - ldb 
 - w95 (USER.DAT-style files)
 - nt4 (NTUSER.DAT-style files)
 - gconf (GNOME configuration)
 - rpc (Remote individual hives)

Instead of opening individual hives, one can also open a 'complete' registry by 
using one of these three functions:
 
 - reg_open_local() - load local registry, see below
 - reg_open_remote() - connect to remote registry over RPC
 - reg_open_wine() (not working yet)

reg_open_local() loads a set of hives based on smb.conf settings. 
Lines in smb.conf should have the following syntax:

registry:<hivename> = <backend>:<location>

So an example usage could be:

registry:HKEY_CURRENT_USER = nt4:NTUSER.DAT
registry:HKEY_LOCAL_MACHINE = ldb:tdb://registry.tdb

WERR_NOT_SUPPORTED will be returned for all hives that haven't been set.

On Windows the various registry hives are loaded from:

HKEY_CURRENT_CONFIG: %SystemRoot%\System32\Config\System
HKEY_CURRENT_USER: %Profile%\NTUser.dat
HKEY_LOCAL_MACHINE\SAM: %SystemRoot%\System32\Config\Sam
HKEY_LOCAL_MACHINE\Security: %SystemRoot%\System32\Config\Security
HKEY_LOCAL_MACHINE\Software: %SystemRoot%\System32\Config\Software
HKEY_LOCAL_MACHINE\System: %SystemRoot%\System32\Config\System
HKEY_USERS\.DEFAULT: %SystemRoot%\System32\Config\Default
HKEY_LOCAL_MACHINE\HARDWARE: is autogenerated