samba-mirror

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

History

Karolin Seeger 53b9e4ba6b docs: man regshell: Add missing meta data. This avoids warnings during the waf build and removes "FIXME" entries from the manpage. Karolin Reviewed-by: Andreas Schneider <asn@samba.org>		2012-11-29 13:42:05 +01:00
..
man	docs: man regshell: Add missing meta data.	2012-11-29 13:42:05 +01:00
tests	s4:registry:testsuite: fix use of non-existent word (existant)	2012-06-12 07:21:44 +02:00
tools	s4:registry:regdiff: use existing talloc context for the event context	2012-07-13 02:51:44 +02:00
Doxyfile
hive.c	Remove the 'dir' registry backend.	2011-12-29 16:45:23 +01:00
interface.c	s4:registry - on key add operations we have to handle with paths not always only a name	2010-07-01 15:48:05 +02:00
ldb.c	s4:lib/registry/ldb.c - quit the deletion of a not-existing default value with WERR_BADFILE	2011-11-03 20:10:06 +01:00
local.c	s4:registry - move some common constraint checks to the "local" backend	2010-07-01 15:48:06 +02:00
patchfile_dotreg.c	Ensure convert_string_XXX is always called with a valid converted_size pointer.	2011-03-29 21:01:49 +02:00
patchfile_preg.c	Finish removal of iconv_convenience in public API's.	2010-05-18 11:45:30 +02:00
patchfile.c	Finish removal of iconv_convenience in public API's.	2010-05-18 11:45:30 +02:00
pyregistry.c	s4:libcli/pyerrors: s/PyErr_WERROR_IS_ERR_RAISE/PyErr_WERROR_NOT_OK_RAISE/	2012-08-06 15:50:16 +02:00
README
regf.c	s4:lib/registry/regf.c - always generate debug messages on error cases	2011-11-03 20:10:06 +01:00
regf.idl	Fix regf.idl, subkey and rootkey types were switched.	2010-09-19 12:34:55 -07:00
registry.h	s4:registry: add a TALLOC_CTX argument to reg_open_remote()	2012-07-13 00:57:19 +02:00
registry.pc.in	s4-pkgconfig: add @LIB_RPATH@ to our link flags	2010-12-08 12:46:00 +01:00
rpc.c	s4:registry: add a TALLOC_CTX argument to reg_open_remote()	2012-07-13 00:57:19 +02:00
samba.c	s4-loadparm: 2nd half of lp_ to lpcfg_ conversion	2010-07-16 18:24:27 +10:00
TODO
util.c	Ensure convert_string_XXX is always called with a valid converted_size pointer.	2011-03-29 21:01:49 +02:00
wine.c
wscript_build	Remove the 'dir' registry backend.	2011-12-29 16:45:23 +01:00

README

This is the registry library. The registry is basically a bunch of
hives, each of which is loaded from a file. When using a local registry, 
it is possible to specify where hives should be loaded from, etc. 

There are separate APIs for accessing the data in a hive and the 
data in the registry itself. Each supports different backends. 

The following "full registry" backends are currently provided:

 * Remote (over DCE/RPC)
 * Local (allows "mounting" hives)
 * Wine (uses the wine plain-text file)

The following hive backends are supported:

 - ldb 
 - regf (NTUSER.DAT-style files)
 - rpc (Remote individual hives)
 - directory

reg_open_samba() 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 = regf: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