samba-mirror

mirror of https://github.com/samba-team/samba.git synced 2024-12-25 23:21:54 +03:00

History

Jelmer Vernooij cb7c72a0ef r26263: Don't assume CH_UNIX is CH_UTF8. (This used to be commit `69157be9b1`)		2007-12-21 05:47:37 +01:00
..
man	r24667: Finally merge the registry improvements that Wilco Baan Hofman and I have	2007-10-10 15:02:34 -05:00
tests	r26073: Import Python bindings for the registry.	2007-12-21 05:45:53 +01:00
tools	r26236: Remove more uses of global_loadparm or specify loadparm_context explicitly.	2007-12-21 05:47:15 +01:00
config.mk	r26073: Import Python bindings for the registry.	2007-12-21 05:45:53 +01:00
dir.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
Doxyfile	r24667: Finally merge the registry improvements that Wilco Baan Hofman and I have	2007-10-10 15:02:34 -05:00
hive.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
hive.h	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
interface.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
ldb.c	r26263: Don't assume CH_UNIX is CH_UTF8.	2007-12-21 05:47:37 +01:00
local.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
patchfile_dotreg.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
patchfile_preg.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
patchfile.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
patchfile.h	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
README	r24667: Finally merge the registry improvements that Wilco Baan Hofman and I have	2007-10-10 15:02:34 -05:00
regf.c	r25920: ndr: change NTSTAUS into enum ndr_err_code (samba4 callers)	2007-12-21 05:45:02 +01:00
regf.idl	r24667: Finally merge the registry improvements that Wilco Baan Hofman and I have	2007-10-10 15:02:34 -05:00
registry_wrap.c	r26248: Check in SWIG output so SWIG is not required when running out of svn.	2007-12-21 05:47:26 +01:00
registry.h	r26236: Remove more uses of global_loadparm or specify loadparm_context explicitly.	2007-12-21 05:47:15 +01:00
registry.i	r26236: Remove more uses of global_loadparm or specify loadparm_context explicitly.	2007-12-21 05:47:15 +01:00
registry.py	r26248: Check in SWIG output so SWIG is not required when running out of svn.	2007-12-21 05:47:26 +01:00
rpc.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
samba.c	r26236: Remove more uses of global_loadparm or specify loadparm_context explicitly.	2007-12-21 05:47:15 +01:00
TODO	r24717: Some more easy bool conversions, update TODO for registry	2007-10-10 15:02:55 -05:00
util.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05:00
wine.c	r25544: Cleanup some more indents in lib/registry.	2007-10-10 15:07:51 -05: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