2 * Unix SMB/CIFS implementation.
3 * Virtual Windows Registry Layer
4 * Copyright (C) Gerald Carter 2002-2005
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, see <http://www.gnu.org/licenses/>.
20 /* Implementation of internal registry database functions. */
25 #define DBGC_CLASS DBGC_REGISTRY
27 static struct db_context *regdb = NULL;
28 static int regdb_refcount;
30 /* List the deepest path into the registry. All part components will be created.*/
32 /* If you want to have a part of the path controlled by the tdb and part by
33 a virtual registry db (e.g. printing), then you have to list the deepest path.
34 For example,"HKLM/SOFTWARE/Microsoft/Windows NT/CurrentVersion/Print"
35 allows the reg_db backend to handle everything up to
36 "HKLM/SOFTWARE/Microsoft/Windows NT/CurrentVersion" and then we'll hook
37 the reg_printing backend onto the last component of the path (see
38 KEY_PRINTING_2K in include/rpc_reg.h) --jerry */
40 static const char *builtin_registry_paths[] = {
50 KEY_SAMBA_GROUP_POLICY,
51 KEY_GP_MACHINE_POLICY,
52 KEY_GP_MACHINE_WIN_POLICY,
55 KEY_GP_USER_WIN_POLICY,
56 KEY_WINLOGON_GPEXT_PATH,
57 "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Print\\Monitors",
59 "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Terminal Server\\DefaultUserConfiguration",
68 struct builtin_regkey_value {
70 const char *valuename;
78 static struct builtin_regkey_value builtin_registry_values[] = {
80 SAMBA_PRINTER_PORT_NAME, REG_SZ, { "" } },
82 "DefaultSpoolDirectory", REG_SZ, { "C:\\Windows\\System32\\Spool\\Printers" } },
84 "DisplayName", REG_SZ, { "Event Log" } },
86 "ErrorControl", REG_DWORD, { (char*)0x00000001 } },
87 { NULL, NULL, 0, { NULL } }
91 * Initialize a key in the registry:
92 * create each component key of the specified path.
94 static bool init_registry_key_internal(const char *add_path)
97 TALLOC_CTX *frame = talloc_stackframe();
100 char *remaining = NULL;
103 REGSUBKEY_CTR *subkeys;
106 DEBUG(6, ("init_registry_key: Adding [%s]\n", add_path));
108 path = talloc_strdup(frame, add_path);
109 base = talloc_strdup(frame, "");
110 if (!path || !base) {
115 while (next_token_talloc(frame, &p, &keyname, "\\")) {
117 /* build up the registry path from the components */
120 base = talloc_asprintf(frame, "%s\\", base);
125 base = talloc_asprintf_append(base, "%s", keyname);
130 /* get the immediate subkeyname (if we have one ) */
132 subkeyname = talloc_strdup(frame, "");
137 remaining = talloc_strdup(frame, p);
143 if (!next_token_talloc(frame, &p2,
146 subkeyname = talloc_strdup(frame,p2);
153 DEBUG(10,("init_registry_key: Storing key [%s] with "
154 "subkey [%s]\n", base,
155 *subkeyname ? subkeyname : "NULL"));
157 /* we don't really care if the lookup succeeds or not
158 * since we are about to update the record.
159 * We just want any subkeys already present */
161 if (!(subkeys = TALLOC_ZERO_P(frame, REGSUBKEY_CTR))) {
162 DEBUG(0,("talloc() failure!\n"));
166 regdb_fetch_keys(base, subkeys);
168 regsubkey_ctr_addkey( subkeys, subkeyname);
170 if (!regdb_store_keys( base, subkeys)) {
182 * Initialize a key in the registry:
183 * create each component key of the specified path,
184 * wrapped in one db transaction.
186 bool init_registry_key(const char *add_path)
188 if (regdb->transaction_start(regdb) == -1) {
189 DEBUG(0, ("init_registry_key: transaction_start failed\n"));
193 if (!init_registry_key_internal(add_path)) {
197 if (regdb->transaction_commit(regdb) == -1) {
198 DEBUG(0, ("init_registry_key: Could not commit transaction\n"));
205 if (regdb->transaction_cancel(regdb) == -1) {
206 smb_panic("init_registry_key: transaction_cancel failed\n");
212 /***********************************************************************
213 Open the registry data in the tdb
214 ***********************************************************************/
216 bool init_registry_data(void)
218 TALLOC_CTX *frame = NULL;
224 * There are potentially quite a few store operations which are all
225 * indiviually wrapped in tdb transactions. Wrapping them in a single
226 * transaction gives just a single transaction_commit() to actually do
227 * its fsync()s. See tdb/common/transaction.c for info about nested
228 * transaction behaviour.
231 if (regdb->transaction_start(regdb) == -1) {
232 DEBUG(0, ("init_registry_data: tdb_transaction_start "
237 /* loop over all of the predefined paths and add each component */
239 for (i=0; builtin_registry_paths[i] != NULL; i++) {
240 if (!init_registry_key_internal(builtin_registry_paths[i])) {
245 /* loop over all of the predefined values and add each component */
247 frame = talloc_stackframe();
249 for (i=0; builtin_registry_values[i].path != NULL; i++) {
251 values = TALLOC_ZERO_P(frame, REGVAL_CTR);
252 if (values == NULL) {
256 regdb_fetch_values(builtin_registry_values[i].path, values);
258 /* preserve existing values across restarts. Only add new ones */
260 if (!regval_ctr_key_exists(values,
261 builtin_registry_values[i].valuename))
263 switch(builtin_registry_values[i].type) {
265 regval_ctr_addvalue(values,
266 builtin_registry_values[i].valuename,
268 (char*)&builtin_registry_values[i].data.dw_value,
274 builtin_registry_values[i].data.string,
276 regval_ctr_addvalue(values,
277 builtin_registry_values[i].valuename,
280 data.uni_str_len*sizeof(uint16));
284 DEBUG(0, ("init_registry_data: invalid value "
285 "type in builtin_registry_values "
287 builtin_registry_values[i].type));
289 regdb_store_values(builtin_registry_values[i].path,
297 if (regdb->transaction_commit(regdb) == -1) {
298 DEBUG(0, ("init_registry_data: Could not commit "
309 if (regdb->transaction_cancel(regdb) == -1) {
310 smb_panic("init_registry_data: tdb_transaction_cancel "
317 /***********************************************************************
318 Open the registry database
319 ***********************************************************************/
321 bool regdb_init( void )
323 const char *vstring = "INFO/version";
327 DEBUG(10,("regdb_init: incrementing refcount (%d)\n", regdb_refcount));
332 regdb = db_open(NULL, state_path("registry.tdb"), 0, REG_TDB_FLAGS, O_RDWR, 0600);
334 regdb = db_open(NULL, state_path("registry.tdb"), 0, REG_TDB_FLAGS, O_RDWR|O_CREAT, 0600);
336 DEBUG(0,("regdb_init: Failed to open registry %s (%s)\n",
337 state_path("registry.tdb"), strerror(errno) ));
341 DEBUG(10,("regdb_init: Successfully created registry tdb\n"));
346 vers_id = dbwrap_fetch_int32(regdb, vstring);
348 if ( vers_id != REGVER_V1 ) {
349 /* any upgrade code here if needed */
350 DEBUG(10, ("regdb_init: got INFO/version = %d != %d\n",
351 vers_id, REGVER_V1));
357 /***********************************************************************
358 Open the registry. Must already have been initialized by regdb_init()
359 ***********************************************************************/
361 WERROR regdb_open( void )
363 WERROR result = WERR_OK;
366 DEBUG(10,("regdb_open: incrementing refcount (%d)\n", regdb_refcount));
373 regdb = db_open(NULL, state_path("registry.tdb"), 0, REG_TDB_FLAGS, O_RDWR, 0600);
375 result = ntstatus_to_werror( map_nt_error_from_unix( errno ) );
376 DEBUG(0,("regdb_open: Failed to open %s! (%s)\n",
377 state_path("registry.tdb"), strerror(errno) ));
383 DEBUG(10,("regdb_open: refcount reset (%d)\n", regdb_refcount));
388 /***********************************************************************
389 ***********************************************************************/
391 int regdb_close( void )
393 if (regdb_refcount == 0) {
399 DEBUG(10,("regdb_close: decrementing refcount (%d)\n", regdb_refcount));
401 if ( regdb_refcount > 0 )
404 SMB_ASSERT( regdb_refcount >= 0 );
410 /***********************************************************************
411 return the tdb sequence number of the registry tdb.
412 this is an indicator for the content of the registry
413 having changed. it will change upon regdb_init, too, though.
414 ***********************************************************************/
415 int regdb_get_seqnum(void)
417 return regdb->get_seqnum(regdb);
420 /***********************************************************************
421 Add subkey strings to the registry tdb under a defined key
422 fmt is the same format as tdb_pack except this function only supports
424 ***********************************************************************/
426 static bool regdb_store_keys_internal(const char *key, REGSUBKEY_CTR *ctr)
429 uint8 *buffer = NULL;
433 uint32 num_subkeys = regsubkey_ctr_numkeys(ctr);
434 char *keyname = NULL;
435 TALLOC_CTX *ctx = talloc_stackframe();
442 keyname = talloc_strdup(ctx, key);
446 keyname = normalize_reg_path(ctx, keyname);
448 /* allocate some initial memory */
450 buffer = (uint8 *)SMB_MALLOC(1024);
451 if (buffer == NULL) {
457 /* store the number of subkeys */
459 len += tdb_pack(buffer+len, buflen-len, "d", num_subkeys);
461 /* pack all the strings */
463 for (i=0; i<num_subkeys; i++) {
464 len += tdb_pack(buffer+len, buflen-len, "f",
465 regsubkey_ctr_specific_key(ctr, i));
467 /* allocate some extra space */
468 buffer = (uint8 *)SMB_REALLOC(buffer, len*2);
470 DEBUG(0, ("regdb_store_keys: Failed to realloc "
471 "memory of size [%d]\n", len*2));
476 len = tdb_pack(buffer+len, buflen-len, "f",
477 regsubkey_ctr_specific_key(ctr, i));
481 /* finally write out the data */
485 status = dbwrap_store_bystring(regdb, keyname, dbuf, TDB_REPLACE);
486 if (!NT_STATUS_IS_OK(status)) {
497 /***********************************************************************
498 Store the new subkey record and create any child key records that
499 do not currently exist
500 ***********************************************************************/
502 bool regdb_store_keys(const char *key, REGSUBKEY_CTR *ctr)
506 REGSUBKEY_CTR *subkeys = NULL, *old_subkeys = NULL;
507 char *oldkeyname = NULL;
508 TALLOC_CTX *ctx = talloc_stackframe();
512 * fetch a list of the old subkeys so we can determine if anything has
516 if (!(old_subkeys = TALLOC_ZERO_P(ctx, REGSUBKEY_CTR))) {
517 DEBUG(0,("regdb_store_keys: talloc() failure!\n"));
521 regdb_fetch_keys(key, old_subkeys);
523 if ((ctr->num_subkeys && old_subkeys->num_subkeys) &&
524 (ctr->num_subkeys == old_subkeys->num_subkeys)) {
526 for (i = 0; i<ctr->num_subkeys; i++) {
527 if (strcmp(ctr->subkeys[i],
528 old_subkeys->subkeys[i]) != 0) {
532 if (i == ctr->num_subkeys) {
534 * Nothing changed, no point to even start a tdb
537 TALLOC_FREE(old_subkeys);
542 TALLOC_FREE(old_subkeys);
544 if (regdb->transaction_start(regdb) == -1) {
545 DEBUG(0, ("regdb_store_keys: transaction_start failed\n"));
550 * Re-fetch the old keys inside the transaction
553 if (!(old_subkeys = TALLOC_ZERO_P(ctx, REGSUBKEY_CTR))) {
554 DEBUG(0,("regdb_store_keys: talloc() failure!\n"));
558 regdb_fetch_keys(key, old_subkeys);
560 /* store the subkey list for the parent */
562 if (!regdb_store_keys_internal(key, ctr) ) {
563 DEBUG(0,("regdb_store_keys: Failed to store new subkey list "
564 "for parent [%s]\n", key));
568 /* now delete removed keys */
570 num_subkeys = regsubkey_ctr_numkeys(old_subkeys);
571 for (i=0; i<num_subkeys; i++) {
572 oldkeyname = regsubkey_ctr_specific_key(old_subkeys, i);
574 if (regsubkey_ctr_key_exists(ctr, oldkeyname)) {
576 * It's still around, don't delete
582 path = talloc_asprintf(ctx, "%s/%s", key, oldkeyname);
586 path = normalize_reg_path(ctx, path);
590 status = dbwrap_delete_bystring(regdb, path);
591 if (!NT_STATUS_IS_OK(status)) {
592 DEBUG(1, ("Deleting %s failed\n", path));
597 path = talloc_asprintf(ctx, "%s/%s/%s",
604 path = normalize_reg_path(ctx, path);
610 * Ignore errors here, we might have no values around
612 dbwrap_delete_bystring(regdb, path);
616 TALLOC_FREE(old_subkeys);
618 /* now create records for any subkeys that don't already exist */
620 num_subkeys = regsubkey_ctr_numkeys(ctr);
622 if (num_subkeys == 0) {
623 if (!(subkeys = TALLOC_ZERO_P(ctx, REGSUBKEY_CTR)) ) {
624 DEBUG(0,("regdb_store_keys: talloc() failure!\n"));
628 if (!regdb_store_keys_internal(key, subkeys)) {
629 DEBUG(0,("regdb_store_keys: Failed to store "
630 "new record for key [%s]\n", key));
633 TALLOC_FREE(subkeys);
637 for (i=0; i<num_subkeys; i++) {
638 path = talloc_asprintf(ctx, "%s/%s",
640 regsubkey_ctr_specific_key(ctr, i));
644 if (!(subkeys = TALLOC_ZERO_P(ctx, REGSUBKEY_CTR)) ) {
645 DEBUG(0,("regdb_store_keys: talloc() failure!\n"));
649 if (regdb_fetch_keys( path, subkeys ) == -1) {
650 /* create a record with 0 subkeys */
651 if (!regdb_store_keys_internal(path, subkeys)) {
652 DEBUG(0,("regdb_store_keys: Failed to store "
653 "new record for key [%s]\n", path));
658 TALLOC_FREE(subkeys);
662 if (regdb->transaction_commit(regdb) == -1) {
663 DEBUG(0, ("regdb_store_keys: Could not commit transaction\n"));
671 if (regdb->transaction_cancel(regdb) == -1) {
672 smb_panic("regdb_store_keys: transaction_cancel failed\n");
682 /***********************************************************************
683 Retrieve an array of strings containing subkeys. Memory should be
684 released by the caller.
685 ***********************************************************************/
687 int regdb_fetch_keys(const char *key, REGSUBKEY_CTR *ctr)
696 TALLOC_CTX *frame = talloc_stackframe();
697 struct db_record *rec;
699 DEBUG(11,("regdb_fetch_keys: Enter key => [%s]\n", key ? key : "NULL"));
701 path = talloc_strdup(frame, key);
706 /* convert to key format */
707 path = talloc_string_sub(frame, path, "\\", "/");
713 rec = regdb->fetch_locked(regdb, frame, string_term_tdb_data(path));
719 ctr->seqnum = regdb_get_seqnum();
721 buf = rec->value.dptr;
722 buflen = rec->value.dsize;
725 DEBUG(5,("regdb_fetch_keys: tdb lookup failed to locate key [%s]\n", key));
729 len = tdb_unpack( buf, buflen, "d", &num_items);
731 for (i=0; i<num_items; i++) {
732 len += tdb_unpack(buf+len, buflen-len, "f", subkeyname);
733 regsubkey_ctr_addkey(ctr, subkeyname);
736 DEBUG(11,("regdb_fetch_keys: Exit [%d] items\n", num_items));
744 /****************************************************************************
745 Unpack a list of registry values frem the TDB
746 ***************************************************************************/
748 static int regdb_unpack_values(REGVAL_CTR *values, uint8 *buf, int buflen)
755 uint32 num_values = 0;
758 /* loop and unpack the rest of the registry values */
760 len += tdb_unpack(buf+len, buflen-len, "d", &num_values);
762 for ( i=0; i<num_values; i++ ) {
763 /* unpack the next regval */
769 len += tdb_unpack(buf+len, buflen-len, "fdB",
775 /* add the new value. Paranoid protective code -- make sure data_p is valid */
777 if (*valuename && size && data_p) {
778 regval_ctr_addvalue(values, valuename, type,
779 (const char *)data_p, size);
781 SAFE_FREE(data_p); /* 'B' option to tdb_unpack does a malloc() */
783 DEBUG(8,("specific: [%s], len: %d\n", valuename, size));
789 /****************************************************************************
790 Pack all values in all printer keys
791 ***************************************************************************/
793 static int regdb_pack_values(REGVAL_CTR *values, uint8 *buf, int buflen)
803 num_values = regval_ctr_numvals( values );
805 /* pack the number of values first */
807 len += tdb_pack( buf+len, buflen-len, "d", num_values );
809 /* loop over all values */
811 for ( i=0; i<num_values; i++ ) {
812 val = regval_ctr_specific_value( values, i );
813 len += tdb_pack(buf+len, buflen-len, "fdB",
817 regval_data_p(val) );
823 /***********************************************************************
824 Retrieve an array of strings containing subkeys. Memory should be
825 released by the caller.
826 ***********************************************************************/
828 int regdb_fetch_values( const char* key, REGVAL_CTR *values )
831 TALLOC_CTX *ctx = talloc_stackframe();
832 struct db_record *rec;
835 DEBUG(10,("regdb_fetch_values: Looking for value of key [%s] \n", key));
837 keystr = talloc_asprintf(ctx, "%s/%s", REG_VALUE_PREFIX, key);
841 keystr = normalize_reg_path(ctx, keystr);
846 rec = regdb->fetch_locked(regdb, ctx, string_term_tdb_data(keystr));
851 values->seqnum = regdb_get_seqnum();
853 if (!rec->value.dptr) {
854 /* all keys have zero values by default */
858 regdb_unpack_values(values, rec->value.dptr, rec->value.dsize);
859 ret = regval_ctr_numvals(values);
866 bool regdb_store_values( const char *key, REGVAL_CTR *values )
868 TDB_DATA old_data, data;
870 TALLOC_CTX *ctx = talloc_stackframe();
874 DEBUG(10,("regdb_store_values: Looking for value of key [%s] \n", key));
878 len = regdb_pack_values(values, data.dptr, data.dsize);
880 DEBUG(0,("regdb_store_values: unable to pack values. len <= 0\n"));
884 data.dptr = TALLOC_ARRAY(ctx, uint8, len);
887 len = regdb_pack_values(values, data.dptr, data.dsize);
889 SMB_ASSERT( len == data.dsize );
891 keystr = talloc_asprintf(ctx, "%s/%s", REG_VALUE_PREFIX, key );
895 keystr = normalize_reg_path(ctx, keystr);
900 old_data = dbwrap_fetch_bystring(regdb, ctx, keystr);
902 if ((old_data.dptr != NULL)
903 && (old_data.dsize == data.dsize)
904 && (memcmp(old_data.dptr, data.dptr, data.dsize) == 0))
910 ret = dbwrap_trans_store(regdb, string_term_tdb_data(keystr), data,
912 result = (ret != -1);
919 static WERROR regdb_get_secdesc(TALLOC_CTX *mem_ctx, const char *key,
920 struct security_descriptor **psecdesc)
925 TALLOC_CTX *tmp_ctx = talloc_stackframe();
926 WERROR err = WERR_OK;
928 DEBUG(10, ("regdb_get_secdesc: Getting secdesc of key [%s]\n", key));
930 tdbkey = talloc_asprintf(tmp_ctx, "%s/%s", REG_SECDESC_PREFIX, key);
931 if (tdbkey == NULL) {
935 normalize_dbkey(tdbkey);
937 data = dbwrap_fetch_bystring(regdb, tmp_ctx, tdbkey);
938 if (data.dptr == NULL) {
943 status = unmarshall_sec_desc(mem_ctx, (uint8 *)data.dptr, data.dsize,
946 if (NT_STATUS_EQUAL(status, NT_STATUS_NO_MEMORY)) {
948 } else if (!NT_STATUS_IS_OK(status)) {
949 err = WERR_REG_CORRUPT;
953 TALLOC_FREE(tmp_ctx);
957 static WERROR regdb_set_secdesc(const char *key,
958 struct security_descriptor *secdesc)
960 TALLOC_CTX *mem_ctx = talloc_stackframe();
962 WERROR err = WERR_NOMEM;
966 tdbkey = talloc_asprintf(mem_ctx, "%s/%s", REG_SECDESC_PREFIX, key);
967 if (tdbkey == NULL) {
970 normalize_dbkey(tdbkey);
972 if (secdesc == NULL) {
973 /* assuming a delete */
974 tdb_ret = dbwrap_trans_delete(regdb,
975 string_term_tdb_data(tdbkey));
977 err = ntstatus_to_werror(map_nt_error_from_unix(errno));
984 err = ntstatus_to_werror(marshall_sec_desc(mem_ctx, secdesc,
987 if (!W_ERROR_IS_OK(err)) {
991 tdb_ret = dbwrap_trans_store(regdb, string_term_tdb_data(tdbkey),
994 err = ntstatus_to_werror(map_nt_error_from_unix(errno));
999 TALLOC_FREE(mem_ctx);
1003 bool regdb_subkeys_need_update(REGSUBKEY_CTR *subkeys)
1005 return (regdb_get_seqnum() != subkeys->seqnum);
1008 bool regdb_values_need_update(REGVAL_CTR *values)
1010 return (regdb_get_seqnum() != values->seqnum);
1014 * Table of function pointers for default access
1017 REGISTRY_OPS regdb_ops = {
1018 .fetch_subkeys = regdb_fetch_keys,
1019 .fetch_values = regdb_fetch_values,
1020 .store_subkeys = regdb_store_keys,
1021 .store_values = regdb_store_values,
1022 .get_secdesc = regdb_get_secdesc,
1023 .set_secdesc = regdb_set_secdesc,
1024 .subkeys_need_update = regdb_subkeys_need_update,
1025 .values_need_update = regdb_values_need_update