2 * Unix SMB/CIFS implementation.
3 * Virtual Windows Registry Layer
4 * Copyright (C) Gerald Carter 2002-2005
5 * Copyright (C) Michael Adam 2007-2009
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 3 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, see <http://www.gnu.org/licenses/>.
21 /* Implementation of internal registry database functions. */
27 #include "reg_util_internal.h"
28 #include "reg_backend_db.h"
29 #include "reg_objects.h"
30 #include "nt_printing.h"
34 #define DBGC_CLASS DBGC_REGISTRY
36 static struct db_context *regdb = NULL;
37 static int regdb_refcount;
39 static bool regdb_key_exists(struct db_context *db, const char *key);
40 static bool regdb_key_is_base_key(const char *key);
41 static WERROR regdb_fetch_keys_internal(struct db_context *db, const char *key,
42 struct regsubkey_ctr *ctr);
43 static bool regdb_store_keys_internal(struct db_context *db, const char *key,
44 struct regsubkey_ctr *ctr);
45 static int regdb_fetch_values_internal(struct db_context *db, const char* key,
46 struct regval_ctr *values);
47 static bool regdb_store_values_internal(struct db_context *db, const char *key,
48 struct regval_ctr *values);
50 /* List the deepest path into the registry. All part components will be created.*/
52 /* If you want to have a part of the path controlled by the tdb and part by
53 a virtual registry db (e.g. printing), then you have to list the deepest path.
54 For example,"HKLM/SOFTWARE/Microsoft/Windows NT/CurrentVersion/Print"
55 allows the reg_db backend to handle everything up to
56 "HKLM/SOFTWARE/Microsoft/Windows NT/CurrentVersion" and then we'll hook
57 the reg_printing backend onto the last component of the path (see
58 KEY_PRINTING_2K in include/rpc_reg.h) --jerry */
60 static const char *builtin_registry_paths[] = {
64 KEY_PRINTING "\\Forms",
65 KEY_PRINTING "\\Printers",
66 KEY_PRINTING "\\Environments\\Windows NT x86\\Print Processors\\winprint",
73 KEY_SAMBA_GROUP_POLICY,
74 KEY_GP_MACHINE_POLICY,
75 KEY_GP_MACHINE_WIN_POLICY,
78 KEY_GP_USER_WIN_POLICY,
79 "HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion\\Winlogon\\GPExtensions",
80 "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Print\\Monitors",
82 "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Terminal Server\\DefaultUserConfiguration",
91 struct builtin_regkey_value {
93 const char *valuename;
101 static struct builtin_regkey_value builtin_registry_values[] = {
102 { KEY_PRINTING_PORTS,
103 SAMBA_PRINTER_PORT_NAME, REG_SZ, { "" } },
105 "DefaultSpoolDirectory", REG_SZ, { "C:\\Windows\\System32\\Spool\\Printers" } },
107 "DisplayName", REG_SZ, { "Event Log" } },
109 "ErrorControl", REG_DWORD, { (char*)0x00000001 } },
110 { NULL, NULL, 0, { NULL } }
114 * Initialize a key in the registry:
115 * create each component key of the specified path.
117 static WERROR init_registry_key_internal(struct db_context *db,
118 const char *add_path)
121 TALLOC_CTX *frame = talloc_stackframe();
124 char *remaining = NULL;
127 struct regsubkey_ctr *subkeys;
130 DEBUG(6, ("init_registry_key: Adding [%s]\n", add_path));
132 path = talloc_strdup(frame, add_path);
133 base = talloc_strdup(frame, "");
134 if (!path || !base) {
140 while (next_token_talloc(frame, &p, &keyname, "\\")) {
142 /* build up the registry path from the components */
145 base = talloc_asprintf(frame, "%s\\", base);
151 base = talloc_asprintf_append(base, "%s", keyname);
157 /* get the immediate subkeyname (if we have one ) */
159 subkeyname = talloc_strdup(frame, "");
165 remaining = talloc_strdup(frame, p);
172 if (!next_token_talloc(frame, &p2,
175 subkeyname = talloc_strdup(frame,p2);
183 DEBUG(10,("init_registry_key: Storing key [%s] with "
184 "subkey [%s]\n", base,
185 *subkeyname ? subkeyname : "NULL"));
187 /* we don't really care if the lookup succeeds or not
188 * since we are about to update the record.
189 * We just want any subkeys already present */
191 werr = regsubkey_ctr_init(frame, &subkeys);
192 if (!W_ERROR_IS_OK(werr)) {
193 DEBUG(0,("talloc() failure!\n"));
197 werr = regdb_fetch_keys_internal(db, base, subkeys);
198 if (!W_ERROR_IS_OK(werr) &&
199 !W_ERROR_EQUAL(werr, WERR_NOT_FOUND))
205 werr = regsubkey_ctr_addkey(subkeys, subkeyname);
206 if (!W_ERROR_IS_OK(werr)) {
210 if (!regdb_store_keys_internal(db, base, subkeys)) {
211 werr = WERR_CAN_NOT_COMPLETE;
223 struct init_registry_key_context {
224 const char *add_path;
227 static NTSTATUS init_registry_key_action(struct db_context *db,
230 struct init_registry_key_context *init_ctx =
231 (struct init_registry_key_context *)private_data;
233 return werror_to_ntstatus(init_registry_key_internal(
234 db, init_ctx->add_path));
238 * Initialize a key in the registry:
239 * create each component key of the specified path,
240 * wrapped in one db transaction.
242 WERROR init_registry_key(const char *add_path)
244 struct init_registry_key_context init_ctx;
246 if (regdb_key_exists(regdb, add_path)) {
250 init_ctx.add_path = add_path;
252 return ntstatus_to_werror(dbwrap_trans_do(regdb,
253 init_registry_key_action,
257 /***********************************************************************
258 Open the registry data in the tdb
259 ***********************************************************************/
261 static void regdb_ctr_add_value(struct regval_ctr *ctr,
262 struct builtin_regkey_value *value)
264 switch(value->type) {
266 regval_ctr_addvalue(ctr, value->valuename, REG_DWORD,
267 (uint8_t *)&value->data.dw_value,
272 regval_ctr_addvalue_sz(ctr, value->valuename,
277 DEBUG(0, ("regdb_ctr_add_value: invalid value type in "
278 "registry values [%d]\n", value->type));
282 static NTSTATUS init_registry_data_action(struct db_context *db,
286 TALLOC_CTX *frame = talloc_stackframe();
287 struct regval_ctr *values;
290 /* loop over all of the predefined paths and add each component */
292 for (i=0; builtin_registry_paths[i] != NULL; i++) {
293 if (regdb_key_exists(db, builtin_registry_paths[i])) {
296 status = werror_to_ntstatus(init_registry_key_internal(db,
297 builtin_registry_paths[i]));
298 if (!NT_STATUS_IS_OK(status)) {
303 /* loop over all of the predefined values and add each component */
305 for (i=0; builtin_registry_values[i].path != NULL; i++) {
308 werr = regval_ctr_init(frame, &values);
309 if (!W_ERROR_IS_OK(werr)) {
310 status = werror_to_ntstatus(werr);
314 regdb_fetch_values_internal(db,
315 builtin_registry_values[i].path,
318 /* preserve existing values across restarts. Only add new ones */
320 if (!regval_ctr_key_exists(values,
321 builtin_registry_values[i].valuename))
323 regdb_ctr_add_value(values,
324 &builtin_registry_values[i]);
325 regdb_store_values_internal(db,
326 builtin_registry_values[i].path,
332 status = NT_STATUS_OK;
340 WERROR init_registry_data(void)
343 TALLOC_CTX *frame = talloc_stackframe();
344 struct regval_ctr *values;
348 * First, check for the existence of the needed keys and values.
349 * If all do already exist, we can save the writes.
351 for (i=0; builtin_registry_paths[i] != NULL; i++) {
352 if (!regdb_key_exists(regdb, builtin_registry_paths[i])) {
357 for (i=0; builtin_registry_values[i].path != NULL; i++) {
358 werr = regval_ctr_init(frame, &values);
359 W_ERROR_NOT_OK_GOTO_DONE(werr);
361 regdb_fetch_values_internal(regdb,
362 builtin_registry_values[i].path,
364 if (!regval_ctr_key_exists(values,
365 builtin_registry_values[i].valuename))
380 * There are potentially quite a few store operations which are all
381 * indiviually wrapped in tdb transactions. Wrapping them in a single
382 * transaction gives just a single transaction_commit() to actually do
383 * its fsync()s. See tdb/common/transaction.c for info about nested
384 * transaction behaviour.
387 werr = ntstatus_to_werror(dbwrap_trans_do(regdb,
388 init_registry_data_action,
396 static int regdb_normalize_keynames_fn(struct db_record *rec,
399 TALLOC_CTX *mem_ctx = talloc_tos();
403 if (rec->key.dptr == NULL || rec->key.dsize == 0) {
407 keyname = strchr((const char *) rec->key.dptr, '/');
409 struct db_record new_rec;
411 keyname = talloc_string_sub(mem_ctx,
412 (const char *) rec->key.dptr,
416 DEBUG(2, ("regdb_normalize_keynames_fn: Convert %s to %s\n",
417 (const char *) rec->key.dptr,
420 new_rec.value = rec->value;
421 new_rec.key = string_term_tdb_data(keyname);
422 new_rec.private_data = rec->private_data;
424 /* Delete the original record and store the normalized key */
425 status = rec->delete_rec(rec);
426 if (!NT_STATUS_IS_OK(status)) {
427 DEBUG(0,("regdb_normalize_keynames_fn: "
428 "tdb_delete for [%s] failed!\n",
433 status = rec->store(&new_rec, new_rec.value, TDB_REPLACE);
434 if (!NT_STATUS_IS_OK(status)) {
435 DEBUG(0,("regdb_normalize_keynames_fn: "
436 "failed to store new record for [%s]!\n",
445 static WERROR regdb_store_regdb_version(uint32_t version)
448 const char *version_keyname = "INFO/version";
451 return WERR_CAN_NOT_COMPLETE;
454 status = dbwrap_trans_store_int32(regdb, version_keyname, version);
455 if (!NT_STATUS_IS_OK(status)) {
456 DEBUG(1, ("regdb_store_regdb_version: error storing %s = %d: %s\n",
457 version_keyname, version, nt_errstr(status)));
458 return ntstatus_to_werror(status);
460 DEBUG(10, ("regdb_store_regdb_version: stored %s = %d\n",
461 version_keyname, version));
466 static WERROR regdb_upgrade_v1_to_v2(void)
472 mem_ctx = talloc_stackframe();
473 if (mem_ctx == NULL) {
477 rc = regdb->traverse(regdb, regdb_normalize_keynames_fn, mem_ctx);
479 talloc_destroy(mem_ctx);
482 return WERR_REG_IO_FAILURE;
485 werr = regdb_store_regdb_version(REGVER_V2);
489 /***********************************************************************
490 Open the registry database
491 ***********************************************************************/
493 WERROR regdb_init(void)
495 const char *vstring = "INFO/version";
496 uint32 vers_id, expected_version;
500 DEBUG(10, ("regdb_init: incrementing refcount (%d->%d)\n",
501 regdb_refcount, regdb_refcount+1));
506 regdb = db_open(NULL, state_path("registry.tdb"), 0,
507 REG_TDB_FLAGS, O_RDWR, 0600);
509 regdb = db_open(NULL, state_path("registry.tdb"), 0,
510 REG_TDB_FLAGS, O_RDWR|O_CREAT, 0600);
512 werr = ntstatus_to_werror(map_nt_error_from_unix(errno));
513 DEBUG(1,("regdb_init: Failed to open registry %s (%s)\n",
514 state_path("registry.tdb"), strerror(errno) ));
518 DEBUG(10,("regdb_init: Successfully created registry tdb\n"));
522 DEBUG(10, ("regdb_init: registry db openend. refcount reset (%d)\n",
525 expected_version = REGVER_V2;
527 vers_id = dbwrap_fetch_int32(regdb, vstring);
529 DEBUG(10, ("regdb_init: registry version uninitialized "
530 "(got %d), initializing to version %d\n",
531 vers_id, expected_version));
533 werr = regdb_store_regdb_version(expected_version);
537 if (vers_id > expected_version || vers_id == 0) {
538 DEBUG(1, ("regdb_init: unknown registry version %d "
539 "(code version = %d), refusing initialization\n",
540 vers_id, expected_version));
541 return WERR_CAN_NOT_COMPLETE;
544 if (vers_id == REGVER_V1) {
545 DEBUG(10, ("regdb_init: got registry db version %d, upgrading "
546 "to version %d\n", REGVER_V1, REGVER_V2));
548 if (regdb->transaction_start(regdb) != 0) {
549 return WERR_REG_IO_FAILURE;
552 werr = regdb_upgrade_v1_to_v2();
553 if (!W_ERROR_IS_OK(werr)) {
554 regdb->transaction_cancel(regdb);
558 if (regdb->transaction_commit(regdb) != 0) {
559 return WERR_REG_IO_FAILURE;
565 /* future upgrade code should go here */
570 /***********************************************************************
571 Open the registry. Must already have been initialized by regdb_init()
572 ***********************************************************************/
574 WERROR regdb_open( void )
576 WERROR result = WERR_OK;
579 DEBUG(10, ("regdb_open: incrementing refcount (%d->%d)\n",
580 regdb_refcount, regdb_refcount+1));
587 regdb = db_open(NULL, state_path("registry.tdb"), 0,
588 REG_TDB_FLAGS, O_RDWR, 0600);
590 result = ntstatus_to_werror( map_nt_error_from_unix( errno ) );
591 DEBUG(0,("regdb_open: Failed to open %s! (%s)\n",
592 state_path("registry.tdb"), strerror(errno) ));
598 DEBUG(10, ("regdb_open: registry db opened. refcount reset (%d)\n",
604 /***********************************************************************
605 ***********************************************************************/
607 int regdb_close( void )
609 if (regdb_refcount == 0) {
615 DEBUG(10, ("regdb_close: decrementing refcount (%d->%d)\n",
616 regdb_refcount+1, regdb_refcount));
618 if ( regdb_refcount > 0 )
621 SMB_ASSERT( regdb_refcount >= 0 );
627 WERROR regdb_transaction_start(void)
629 return (regdb->transaction_start(regdb) == 0) ?
630 WERR_OK : WERR_REG_IO_FAILURE;
633 WERROR regdb_transaction_commit(void)
635 return (regdb->transaction_commit(regdb) == 0) ?
636 WERR_OK : WERR_REG_IO_FAILURE;
639 WERROR regdb_transaction_cancel(void)
641 return (regdb->transaction_cancel(regdb) == 0) ?
642 WERR_OK : WERR_REG_IO_FAILURE;
645 /***********************************************************************
646 return the tdb sequence number of the registry tdb.
647 this is an indicator for the content of the registry
648 having changed. it will change upon regdb_init, too, though.
649 ***********************************************************************/
650 int regdb_get_seqnum(void)
652 return regdb->get_seqnum(regdb);
656 static WERROR regdb_delete_key_with_prefix(struct db_context *db,
661 WERROR werr = WERR_NOMEM;
662 TALLOC_CTX *mem_ctx = talloc_stackframe();
664 if (keyname == NULL) {
665 werr = WERR_INVALID_PARAM;
669 if (prefix == NULL) {
670 path = discard_const_p(char, keyname);
672 path = talloc_asprintf(mem_ctx, "%s\\%s", prefix, keyname);
678 path = normalize_reg_path(mem_ctx, path);
683 werr = ntstatus_to_werror(dbwrap_delete_bystring(db, path));
685 /* treat "not" found" as ok */
686 if (W_ERROR_EQUAL(werr, WERR_NOT_FOUND)) {
691 talloc_free(mem_ctx);
696 static WERROR regdb_delete_values(struct db_context *db, const char *keyname)
698 return regdb_delete_key_with_prefix(db, keyname, REG_VALUE_PREFIX);
701 static WERROR regdb_delete_secdesc(struct db_context *db, const char *keyname)
703 return regdb_delete_key_with_prefix(db, keyname, REG_SECDESC_PREFIX);
706 static WERROR regdb_delete_subkeylist(struct db_context *db, const char *keyname)
708 return regdb_delete_key_with_prefix(db, keyname, NULL);
711 static WERROR regdb_delete_key_lists(struct db_context *db, const char *keyname)
715 werr = regdb_delete_values(db, keyname);
716 if (!W_ERROR_IS_OK(werr)) {
717 DEBUG(1, (__location__ " Deleting %s\\%s failed: %s\n",
718 REG_VALUE_PREFIX, keyname, win_errstr(werr)));
722 werr = regdb_delete_secdesc(db, keyname);
723 if (!W_ERROR_IS_OK(werr)) {
724 DEBUG(1, (__location__ " Deleting %s\\%s failed: %s\n",
725 REG_SECDESC_PREFIX, keyname, win_errstr(werr)));
729 werr = regdb_delete_subkeylist(db, keyname);
730 if (!W_ERROR_IS_OK(werr)) {
731 DEBUG(1, (__location__ " Deleting %s failed: %s\n",
732 keyname, win_errstr(werr)));
740 /***********************************************************************
741 Add subkey strings to the registry tdb under a defined key
742 fmt is the same format as tdb_pack except this function only supports
744 ***********************************************************************/
746 static WERROR regdb_store_keys_internal2(struct db_context *db,
748 struct regsubkey_ctr *ctr)
751 uint8 *buffer = NULL;
754 uint32 num_subkeys = regsubkey_ctr_numkeys(ctr);
755 char *keyname = NULL;
756 TALLOC_CTX *ctx = talloc_stackframe();
760 werr = WERR_INVALID_PARAM;
764 keyname = talloc_strdup(ctx, key);
770 keyname = normalize_reg_path(ctx, keyname);
776 /* allocate some initial memory */
778 buffer = (uint8 *)SMB_MALLOC(1024);
779 if (buffer == NULL) {
786 /* store the number of subkeys */
788 len += tdb_pack(buffer+len, buflen-len, "d", num_subkeys);
790 /* pack all the strings */
792 for (i=0; i<num_subkeys; i++) {
795 thistime = tdb_pack(buffer+len, buflen-len, "f",
796 regsubkey_ctr_specific_key(ctr, i));
797 if (len+thistime > buflen) {
800 * tdb_pack hasn't done anything because of the short
801 * buffer, allocate extra space.
803 buffer = SMB_REALLOC_ARRAY(buffer, uint8_t,
806 DEBUG(0, ("regdb_store_keys: Failed to realloc "
807 "memory of size [%u]\n",
808 (unsigned int)(len+thistime)*2));
812 buflen = (len+thistime)*2;
813 thistime2 = tdb_pack(
814 buffer+len, buflen-len, "f",
815 regsubkey_ctr_specific_key(ctr, i));
816 if (thistime2 != thistime) {
817 DEBUG(0, ("tdb_pack failed\n"));
818 werr = WERR_CAN_NOT_COMPLETE;
825 /* finally write out the data */
829 werr = ntstatus_to_werror(dbwrap_store_bystring(db, keyname, dbuf,
831 W_ERROR_NOT_OK_GOTO_DONE(werr);
834 * Delete a sorted subkey cache for regdb_key_exists, will be
835 * recreated automatically
837 keyname = talloc_asprintf(ctx, "%s\\%s", REG_SORTED_SUBKEYS_PREFIX,
839 if (keyname == NULL) {
844 werr = ntstatus_to_werror(dbwrap_delete_bystring(db, keyname));
846 /* don't treat WERR_NOT_FOUND as an error here */
847 if (W_ERROR_EQUAL(werr, WERR_NOT_FOUND)) {
857 /***********************************************************************
858 Store the new subkey record and create any child key records that
859 do not currently exist
860 ***********************************************************************/
862 struct regdb_store_keys_context {
864 struct regsubkey_ctr *ctr;
867 static NTSTATUS regdb_store_keys_action(struct db_context *db,
870 struct regdb_store_keys_context *store_ctx;
874 struct regsubkey_ctr *subkeys = NULL, *old_subkeys = NULL;
875 char *oldkeyname = NULL;
876 TALLOC_CTX *mem_ctx = talloc_stackframe();
878 store_ctx = (struct regdb_store_keys_context *)private_data;
881 * Re-fetch the old keys inside the transaction
884 werr = regsubkey_ctr_init(mem_ctx, &old_subkeys);
885 W_ERROR_NOT_OK_GOTO_DONE(werr);
887 werr = regdb_fetch_keys_internal(db, store_ctx->key, old_subkeys);
888 if (!W_ERROR_IS_OK(werr) &&
889 !W_ERROR_EQUAL(werr, WERR_NOT_FOUND))
895 * Make the store operation as safe as possible without transactions:
897 * (1) For each subkey removed from ctr compared with old_subkeys:
899 * (a) First delete the value db entry.
901 * (b) Next delete the secdesc db record.
903 * (c) Then delete the subkey list entry.
905 * (2) Now write the list of subkeys of the parent key,
906 * deleting removed entries and adding new ones.
908 * (3) Finally create the subkey list entries for the added keys.
910 * This way if we crash half-way in between deleting the subkeys
911 * and storing the parent's list of subkeys, no old data can pop up
912 * out of the blue when re-adding keys later on.
915 /* (1) delete removed keys' lists (values/secdesc/subkeys) */
917 num_subkeys = regsubkey_ctr_numkeys(old_subkeys);
918 for (i=0; i<num_subkeys; i++) {
919 oldkeyname = regsubkey_ctr_specific_key(old_subkeys, i);
921 if (regsubkey_ctr_key_exists(store_ctx->ctr, oldkeyname)) {
923 * It's still around, don't delete
928 path = talloc_asprintf(mem_ctx, "%s\\%s", store_ctx->key,
935 werr = regdb_delete_key_lists(db, path);
936 W_ERROR_NOT_OK_GOTO_DONE(werr);
941 TALLOC_FREE(old_subkeys);
943 /* (2) store the subkey list for the parent */
945 werr = regdb_store_keys_internal2(db, store_ctx->key, store_ctx->ctr);
946 if (!W_ERROR_IS_OK(werr)) {
947 DEBUG(0,("regdb_store_keys: Failed to store new subkey list "
948 "for parent [%s]: %s\n", store_ctx->key,
953 /* (3) now create records for any subkeys that don't already exist */
955 num_subkeys = regsubkey_ctr_numkeys(store_ctx->ctr);
957 if (num_subkeys == 0) {
958 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
959 W_ERROR_NOT_OK_GOTO_DONE(werr);
961 werr = regdb_store_keys_internal2(db, store_ctx->key, subkeys);
962 if (!W_ERROR_IS_OK(werr)) {
963 DEBUG(0,("regdb_store_keys: Failed to store "
964 "new record for key [%s]: %s\n",
965 store_ctx->key, win_errstr(werr)));
968 TALLOC_FREE(subkeys);
971 for (i=0; i<num_subkeys; i++) {
972 path = talloc_asprintf(mem_ctx, "%s\\%s", store_ctx->key,
973 regsubkey_ctr_specific_key(store_ctx->ctr, i));
978 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
979 W_ERROR_NOT_OK_GOTO_DONE(werr);
981 werr = regdb_fetch_keys_internal(db, path, subkeys);
982 if (!W_ERROR_IS_OK(werr)) {
983 /* create a record with 0 subkeys */
984 werr = regdb_store_keys_internal2(db, path, subkeys);
985 if (!W_ERROR_IS_OK(werr)) {
986 DEBUG(0,("regdb_store_keys: Failed to store "
987 "new record for key [%s]: %s\n", path,
993 TALLOC_FREE(subkeys);
1000 talloc_free(mem_ctx);
1001 return werror_to_ntstatus(werr);
1004 static bool regdb_store_keys_internal(struct db_context *db, const char *key,
1005 struct regsubkey_ctr *ctr)
1007 int num_subkeys, old_num_subkeys, i;
1008 struct regsubkey_ctr *old_subkeys = NULL;
1009 TALLOC_CTX *ctx = talloc_stackframe();
1012 struct regdb_store_keys_context store_ctx;
1014 if (!regdb_key_is_base_key(key) && !regdb_key_exists(db, key)) {
1019 * fetch a list of the old subkeys so we can determine if anything has
1023 werr = regsubkey_ctr_init(ctx, &old_subkeys);
1024 if (!W_ERROR_IS_OK(werr)) {
1025 DEBUG(0,("regdb_store_keys: talloc() failure!\n"));
1029 werr = regdb_fetch_keys_internal(db, key, old_subkeys);
1030 if (!W_ERROR_IS_OK(werr) &&
1031 !W_ERROR_EQUAL(werr, WERR_NOT_FOUND))
1036 num_subkeys = regsubkey_ctr_numkeys(ctr);
1037 old_num_subkeys = regsubkey_ctr_numkeys(old_subkeys);
1038 if ((num_subkeys && old_num_subkeys) &&
1039 (num_subkeys == old_num_subkeys)) {
1041 for (i = 0; i < num_subkeys; i++) {
1042 if (strcmp(regsubkey_ctr_specific_key(ctr, i),
1043 regsubkey_ctr_specific_key(old_subkeys, i))
1049 if (i == num_subkeys) {
1051 * Nothing changed, no point to even start a tdb
1060 TALLOC_FREE(old_subkeys);
1062 store_ctx.key = key;
1063 store_ctx.ctr = ctr;
1065 werr = ntstatus_to_werror(dbwrap_trans_do(db,
1066 regdb_store_keys_action,
1069 ret = W_ERROR_IS_OK(werr);
1077 bool regdb_store_keys(const char *key, struct regsubkey_ctr *ctr)
1079 return regdb_store_keys_internal(regdb, key, ctr);
1083 * create a subkey of a given key
1086 struct regdb_create_subkey_context {
1091 static NTSTATUS regdb_create_subkey_action(struct db_context *db,
1095 struct regdb_create_subkey_context *create_ctx;
1096 struct regsubkey_ctr *subkeys;
1097 TALLOC_CTX *mem_ctx = talloc_stackframe();
1099 create_ctx = (struct regdb_create_subkey_context *)private_data;
1101 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
1102 W_ERROR_NOT_OK_GOTO_DONE(werr);
1104 werr = regdb_fetch_keys_internal(db, create_ctx->key, subkeys);
1105 W_ERROR_NOT_OK_GOTO_DONE(werr);
1107 werr = regsubkey_ctr_addkey(subkeys, create_ctx->subkey);
1108 W_ERROR_NOT_OK_GOTO_DONE(werr);
1110 werr = regdb_store_keys_internal2(db, create_ctx->key, subkeys);
1111 if (!W_ERROR_IS_OK(werr)) {
1112 DEBUG(0, (__location__ " failed to store new subkey list for "
1113 "parent key %s: %s\n", create_ctx->key,
1118 talloc_free(mem_ctx);
1119 return werror_to_ntstatus(werr);
1122 static WERROR regdb_create_subkey(const char *key, const char *subkey)
1125 struct regsubkey_ctr *subkeys;
1126 TALLOC_CTX *mem_ctx = talloc_stackframe();
1127 struct regdb_create_subkey_context create_ctx;
1129 if (!regdb_key_is_base_key(key) && !regdb_key_exists(regdb, key)) {
1130 werr = WERR_NOT_FOUND;
1134 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
1135 W_ERROR_NOT_OK_GOTO_DONE(werr);
1137 werr = regdb_fetch_keys_internal(regdb, key, subkeys);
1138 W_ERROR_NOT_OK_GOTO_DONE(werr);
1140 if (regsubkey_ctr_key_exists(subkeys, subkey)) {
1145 talloc_free(subkeys);
1147 create_ctx.key = key;
1148 create_ctx.subkey = subkey;
1150 werr = ntstatus_to_werror(dbwrap_trans_do(regdb,
1151 regdb_create_subkey_action,
1155 talloc_free(mem_ctx);
1160 * create a subkey of a given key
1163 struct regdb_delete_subkey_context {
1169 static NTSTATUS regdb_delete_subkey_action(struct db_context *db,
1173 struct regdb_delete_subkey_context *delete_ctx;
1174 struct regsubkey_ctr *subkeys;
1175 TALLOC_CTX *mem_ctx = talloc_stackframe();
1177 delete_ctx = (struct regdb_delete_subkey_context *)private_data;
1179 werr = regdb_delete_key_lists(db, delete_ctx->path);
1180 W_ERROR_NOT_OK_GOTO_DONE(werr);
1182 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
1183 W_ERROR_NOT_OK_GOTO_DONE(werr);
1185 werr = regdb_fetch_keys_internal(db, delete_ctx->key, subkeys);
1186 W_ERROR_NOT_OK_GOTO_DONE(werr);
1188 werr = regsubkey_ctr_delkey(subkeys, delete_ctx->subkey);
1189 W_ERROR_NOT_OK_GOTO_DONE(werr);
1191 werr = regdb_store_keys_internal2(db, delete_ctx->key, subkeys);
1192 if (!W_ERROR_IS_OK(werr)) {
1193 DEBUG(0, (__location__ " failed to store new subkey_list for "
1194 "parent key %s: %s\n", delete_ctx->key,
1199 talloc_free(mem_ctx);
1200 return werror_to_ntstatus(werr);
1203 static WERROR regdb_delete_subkey(const char *key, const char *subkey)
1207 struct regdb_delete_subkey_context delete_ctx;
1208 TALLOC_CTX *mem_ctx = talloc_stackframe();
1210 if (!regdb_key_is_base_key(key) && !regdb_key_exists(regdb, key)) {
1211 werr = WERR_NOT_FOUND;
1215 path = talloc_asprintf(mem_ctx, "%s\\%s", key, subkey);
1221 if (!regdb_key_exists(regdb, path)) {
1226 delete_ctx.key = key;
1227 delete_ctx.subkey = subkey;
1228 delete_ctx.path = path;
1230 werr = ntstatus_to_werror(dbwrap_trans_do(regdb,
1231 regdb_delete_subkey_action,
1235 talloc_free(mem_ctx);
1239 static TDB_DATA regdb_fetch_key_internal(struct db_context *db,
1240 TALLOC_CTX *mem_ctx, const char *key)
1245 path = normalize_reg_path(mem_ctx, key);
1247 return make_tdb_data(NULL, 0);
1250 data = dbwrap_fetch_bystring(db, mem_ctx, path);
1258 * check whether a given key name represents a base key,
1259 * i.e one without a subkey separator ('\').
1261 static bool regdb_key_is_base_key(const char *key)
1263 TALLOC_CTX *mem_ctx = talloc_stackframe();
1271 path = normalize_reg_path(mem_ctx, key);
1273 DEBUG(0, ("out of memory! (talloc failed)\n"));
1277 if (*path == '\0') {
1281 ret = (strrchr(path, '\\') == NULL);
1284 TALLOC_FREE(mem_ctx);
1289 * regdb_key_exists() is a very frequent operation. It can be quite
1290 * time-consuming to fully fetch the parent's subkey list, talloc_strdup all
1291 * subkeys and then compare the keyname linearly to all the parent's subkeys.
1293 * The following code tries to make this operation as efficient as possible:
1294 * Per registry key we create a list of subkeys that is very efficient to
1295 * search for existence of a subkey. Its format is:
1297 * 4 bytes num_subkeys
1298 * 4*num_subkey bytes offset into the string array
1299 * then follows a sorted list of subkeys in uppercase
1301 * This record is created by create_sorted_subkeys() on demand if it does not
1302 * exist. scan_parent_subkeys() uses regdb->parse_record to search the sorted
1303 * list, the parsing code and the binary search can be found in
1304 * parent_subkey_scanner. The code uses parse_record() to avoid a memcpy of
1305 * the potentially large subkey record.
1307 * The sorted subkey record is deleted in regdb_store_keys_internal2 and
1308 * recreated on demand.
1311 static int cmp_keynames(char **p1, char **p2)
1313 return StrCaseCmp(*p1, *p2);
1316 struct create_sorted_subkeys_context {
1318 const char *sorted_keyname;
1321 static NTSTATUS create_sorted_subkeys_action(struct db_context *db,
1324 char **sorted_subkeys;
1325 struct regsubkey_ctr *ctr;
1332 struct create_sorted_subkeys_context *sorted_ctx;
1334 sorted_ctx = (struct create_sorted_subkeys_context *)private_data;
1337 * In this function, we only treat failing of the actual write to
1338 * the db as a real error. All preliminary errors, at a stage when
1339 * nothing has been written to the DB yet are treated as success
1340 * to be committed (as an empty transaction).
1342 * The reason is that this (disposable) call might be nested in other
1343 * transactions. Doing a cancel here would destroy the possibility of
1344 * a transaction_commit for transactions that we might be wrapped in.
1347 status = werror_to_ntstatus(regsubkey_ctr_init(talloc_tos(), &ctr));
1348 if (!NT_STATUS_IS_OK(status)) {
1349 /* don't treat this as an error */
1350 status = NT_STATUS_OK;
1354 status = werror_to_ntstatus(regdb_fetch_keys_internal(db,
1357 if (!NT_STATUS_IS_OK(status)) {
1358 /* don't treat this as an error */
1359 status = NT_STATUS_OK;
1363 num_subkeys = regsubkey_ctr_numkeys(ctr);
1364 sorted_subkeys = talloc_array(ctr, char *, num_subkeys);
1365 if (sorted_subkeys == NULL) {
1366 /* don't treat this as an error */
1370 len = 4 + 4*num_subkeys;
1372 for (i = 0; i < num_subkeys; i++) {
1373 sorted_subkeys[i] = talloc_strdup_upper(sorted_subkeys,
1374 regsubkey_ctr_specific_key(ctr, i));
1375 if (sorted_subkeys[i] == NULL) {
1376 /* don't treat this as an error */
1379 len += strlen(sorted_subkeys[i])+1;
1382 TYPESAFE_QSORT(sorted_subkeys, num_subkeys, cmp_keynames);
1384 buf = talloc_array(ctr, char, len);
1386 /* don't treat this as an error */
1389 p = buf + 4 + 4*num_subkeys;
1391 SIVAL(buf, 0, num_subkeys);
1393 for (i=0; i < num_subkeys; i++) {
1394 ptrdiff_t offset = p - buf;
1395 SIVAL(buf, 4 + 4*i, offset);
1396 strlcpy(p, sorted_subkeys[i], len-offset);
1397 p += strlen(sorted_subkeys[i]) + 1;
1400 status = dbwrap_store_bystring(
1401 db, sorted_ctx->sorted_keyname, make_tdb_data((uint8_t *)buf,
1410 static bool create_sorted_subkeys(const char *key, const char *sorted_keyname)
1413 struct create_sorted_subkeys_context sorted_ctx;
1415 sorted_ctx.key = key;
1416 sorted_ctx.sorted_keyname = sorted_keyname;
1418 status = dbwrap_trans_do(regdb,
1419 create_sorted_subkeys_action,
1422 return NT_STATUS_IS_OK(status);
1425 struct scan_subkey_state {
1431 static int parent_subkey_scanner(TDB_DATA key, TDB_DATA data,
1434 struct scan_subkey_state *state =
1435 (struct scan_subkey_state *)private_data;
1436 uint32_t num_subkeys;
1439 if (data.dsize < sizeof(uint32_t)) {
1443 state->scanned = true;
1444 state->found = false;
1446 tdb_unpack(data.dptr, data.dsize, "d", &num_subkeys);
1452 uint32_t idx = (l+u)/2;
1453 char *s = (char *)data.dptr + IVAL(data.dptr, 4 + 4*idx);
1454 int comparison = strcmp(state->name, s);
1456 if (comparison < 0) {
1458 } else if (comparison > 0) {
1461 state->found = true;
1468 static bool scan_parent_subkeys(struct db_context *db, const char *parent,
1473 struct scan_subkey_state state = { 0, };
1474 bool result = false;
1479 path = normalize_reg_path(talloc_tos(), parent);
1484 key = talloc_asprintf(talloc_tos(), "%s\\%s",
1485 REG_SORTED_SUBKEYS_PREFIX, path);
1490 state.name = talloc_strdup_upper(talloc_tos(), name);
1491 if (state.name == NULL) {
1494 state.scanned = false;
1496 res = db->parse_record(db, string_term_tdb_data(key),
1497 parent_subkey_scanner, &state);
1499 if (state.scanned) {
1500 result = state.found;
1502 res = db->transaction_start(db);
1504 DEBUG(0, ("error starting transacion\n"));
1508 if (!create_sorted_subkeys(path, key)) {
1509 res = db->transaction_cancel(db);
1511 smb_panic("Failed to cancel transaction.");
1516 res = db->parse_record(db, string_term_tdb_data(key),
1517 parent_subkey_scanner, &state);
1518 if ((res == 0) && (state.scanned)) {
1519 result = state.found;
1522 res = db->transaction_commit(db);
1524 DEBUG(0, ("error committing transaction\n"));
1531 TALLOC_FREE(state.name);
1536 * Check for the existence of a key.
1538 * Existence of a key is authoritatively defined by its
1539 * existence in the list of subkeys of its parent key.
1540 * The exeption of this are keys without a parent key,
1541 * i.e. the "base" keys (HKLM, HKCU, ...).
1543 static bool regdb_key_exists(struct db_context *db, const char *key)
1545 TALLOC_CTX *mem_ctx = talloc_stackframe();
1554 path = normalize_reg_path(mem_ctx, key);
1556 DEBUG(0, ("out of memory! (talloc failed)\n"));
1560 if (*path == '\0') {
1564 p = strrchr(path, '\\');
1566 /* this is a base key */
1567 value = regdb_fetch_key_internal(db, mem_ctx, path);
1568 ret = (value.dptr != NULL);
1571 ret = scan_parent_subkeys(db, path, p+1);
1575 TALLOC_FREE(mem_ctx);
1580 /***********************************************************************
1581 Retrieve an array of strings containing subkeys. Memory should be
1582 released by the caller.
1583 ***********************************************************************/
1585 static WERROR regdb_fetch_keys_internal(struct db_context *db, const char *key,
1586 struct regsubkey_ctr *ctr)
1594 TALLOC_CTX *frame = talloc_stackframe();
1597 DEBUG(11,("regdb_fetch_keys: Enter key => [%s]\n", key ? key : "NULL"));
1599 frame = talloc_stackframe();
1601 if (!regdb_key_exists(db, key)) {
1602 DEBUG(10, ("key [%s] not found\n", key));
1603 werr = WERR_NOT_FOUND;
1607 werr = regsubkey_ctr_set_seqnum(ctr, db->get_seqnum(db));
1608 W_ERROR_NOT_OK_GOTO_DONE(werr);
1610 value = regdb_fetch_key_internal(db, frame, key);
1612 if (value.dsize == 0 || value.dptr == NULL) {
1613 DEBUG(10, ("regdb_fetch_keys: no subkeys found for key [%s]\n",
1619 buflen = value.dsize;
1620 len = tdb_unpack( buf, buflen, "d", &num_items);
1621 if (len == (uint32_t)-1) {
1622 werr = WERR_NOT_FOUND;
1626 werr = regsubkey_ctr_reinit(ctr);
1627 W_ERROR_NOT_OK_GOTO_DONE(werr);
1629 for (i=0; i<num_items; i++) {
1630 len += tdb_unpack(buf+len, buflen-len, "f", subkeyname);
1631 werr = regsubkey_ctr_addkey(ctr, subkeyname);
1632 if (!W_ERROR_IS_OK(werr)) {
1633 DEBUG(5, ("regdb_fetch_keys: regsubkey_ctr_addkey "
1634 "failed: %s\n", win_errstr(werr)));
1640 DEBUG(11,("regdb_fetch_keys: Exit [%d] items\n", num_items));
1647 int regdb_fetch_keys(const char *key, struct regsubkey_ctr *ctr)
1651 werr = regdb_fetch_keys_internal(regdb, key, ctr);
1652 if (!W_ERROR_IS_OK(werr)) {
1656 return regsubkey_ctr_numkeys(ctr);
1659 /****************************************************************************
1660 Unpack a list of registry values frem the TDB
1661 ***************************************************************************/
1663 static int regdb_unpack_values(struct regval_ctr *values, uint8 *buf, int buflen)
1670 uint32 num_values = 0;
1673 /* loop and unpack the rest of the registry values */
1675 len += tdb_unpack(buf+len, buflen-len, "d", &num_values);
1677 for ( i=0; i<num_values; i++ ) {
1678 /* unpack the next regval */
1683 valuename[0] = '\0';
1684 len += tdb_unpack(buf+len, buflen-len, "fdB",
1690 regval_ctr_addvalue(values, valuename, type,
1691 (uint8_t *)data_p, size);
1692 SAFE_FREE(data_p); /* 'B' option to tdb_unpack does a malloc() */
1694 DEBUG(8,("specific: [%s], len: %d\n", valuename, size));
1700 /****************************************************************************
1701 Pack all values in all printer keys
1702 ***************************************************************************/
1704 static int regdb_pack_values(struct regval_ctr *values, uint8 *buf, int buflen)
1708 struct regval_blob *val;
1714 num_values = regval_ctr_numvals( values );
1716 /* pack the number of values first */
1718 len += tdb_pack( buf+len, buflen-len, "d", num_values );
1720 /* loop over all values */
1722 for ( i=0; i<num_values; i++ ) {
1723 val = regval_ctr_specific_value( values, i );
1724 len += tdb_pack(buf+len, buflen-len, "fdB",
1728 regval_data_p(val) );
1734 /***********************************************************************
1735 Retrieve an array of strings containing subkeys. Memory should be
1736 released by the caller.
1737 ***********************************************************************/
1739 static int regdb_fetch_values_internal(struct db_context *db, const char* key,
1740 struct regval_ctr *values)
1742 char *keystr = NULL;
1743 TALLOC_CTX *ctx = talloc_stackframe();
1748 DEBUG(10,("regdb_fetch_values: Looking for value of key [%s] \n", key));
1750 if (!regdb_key_exists(db, key)) {
1754 keystr = talloc_asprintf(ctx, "%s\\%s", REG_VALUE_PREFIX, key);
1759 werr = regval_ctr_set_seqnum(values, db->get_seqnum(db));
1760 W_ERROR_NOT_OK_GOTO_DONE(werr);
1762 value = regdb_fetch_key_internal(db, ctx, keystr);
1765 /* all keys have zero values by default */
1769 regdb_unpack_values(values, value.dptr, value.dsize);
1770 ret = regval_ctr_numvals(values);
1777 int regdb_fetch_values(const char* key, struct regval_ctr *values)
1779 return regdb_fetch_values_internal(regdb, key, values);
1782 static bool regdb_store_values_internal(struct db_context *db, const char *key,
1783 struct regval_ctr *values)
1785 TDB_DATA old_data, data;
1786 char *keystr = NULL;
1787 TALLOC_CTX *ctx = talloc_stackframe();
1790 bool result = false;
1792 DEBUG(10,("regdb_store_values: Looking for value of key [%s] \n", key));
1794 if (!regdb_key_exists(db, key)) {
1800 len = regdb_pack_values(values, data.dptr, data.dsize);
1802 DEBUG(0,("regdb_store_values: unable to pack values. len <= 0\n"));
1806 data.dptr = TALLOC_ARRAY(ctx, uint8, len);
1809 len = regdb_pack_values(values, data.dptr, data.dsize);
1811 SMB_ASSERT( len == data.dsize );
1813 keystr = talloc_asprintf(ctx, "%s\\%s", REG_VALUE_PREFIX, key );
1817 keystr = normalize_reg_path(ctx, keystr);
1822 old_data = dbwrap_fetch_bystring(db, ctx, keystr);
1824 if ((old_data.dptr != NULL)
1825 && (old_data.dsize == data.dsize)
1826 && (memcmp(old_data.dptr, data.dptr, data.dsize) == 0))
1832 status = dbwrap_trans_store_bystring(db, keystr, data, TDB_REPLACE);
1834 result = NT_STATUS_IS_OK(status);
1841 bool regdb_store_values(const char *key, struct regval_ctr *values)
1843 return regdb_store_values_internal(regdb, key, values);
1846 static WERROR regdb_get_secdesc(TALLOC_CTX *mem_ctx, const char *key,
1847 struct security_descriptor **psecdesc)
1852 TALLOC_CTX *tmp_ctx = talloc_stackframe();
1853 WERROR err = WERR_OK;
1855 DEBUG(10, ("regdb_get_secdesc: Getting secdesc of key [%s]\n", key));
1857 if (!regdb_key_exists(regdb, key)) {
1862 tdbkey = talloc_asprintf(tmp_ctx, "%s\\%s", REG_SECDESC_PREFIX, key);
1863 if (tdbkey == NULL) {
1868 tdbkey = normalize_reg_path(tmp_ctx, tdbkey);
1869 if (tdbkey == NULL) {
1874 data = dbwrap_fetch_bystring(regdb, tmp_ctx, tdbkey);
1875 if (data.dptr == NULL) {
1880 status = unmarshall_sec_desc(mem_ctx, (uint8 *)data.dptr, data.dsize,
1883 if (NT_STATUS_EQUAL(status, NT_STATUS_NO_MEMORY)) {
1885 } else if (!NT_STATUS_IS_OK(status)) {
1886 err = WERR_REG_CORRUPT;
1890 TALLOC_FREE(tmp_ctx);
1894 static WERROR regdb_set_secdesc(const char *key,
1895 struct security_descriptor *secdesc)
1897 TALLOC_CTX *mem_ctx = talloc_stackframe();
1899 WERROR err = WERR_NOMEM;
1902 if (!regdb_key_exists(regdb, key)) {
1907 tdbkey = talloc_asprintf(mem_ctx, "%s\\%s", REG_SECDESC_PREFIX, key);
1908 if (tdbkey == NULL) {
1912 tdbkey = normalize_reg_path(mem_ctx, tdbkey);
1913 if (tdbkey == NULL) {
1918 if (secdesc == NULL) {
1919 /* assuming a delete */
1920 err = ntstatus_to_werror(dbwrap_trans_delete_bystring(regdb,
1925 err = ntstatus_to_werror(marshall_sec_desc(mem_ctx, secdesc,
1928 W_ERROR_NOT_OK_GOTO_DONE(err);
1930 err = ntstatus_to_werror(dbwrap_trans_store_bystring(regdb, tdbkey,
1934 TALLOC_FREE(mem_ctx);
1938 bool regdb_subkeys_need_update(struct regsubkey_ctr *subkeys)
1940 return (regdb_get_seqnum() != regsubkey_ctr_get_seqnum(subkeys));
1943 bool regdb_values_need_update(struct regval_ctr *values)
1945 return (regdb_get_seqnum() != regval_ctr_get_seqnum(values));
1949 * Table of function pointers for default access
1952 struct registry_ops regdb_ops = {
1953 .fetch_subkeys = regdb_fetch_keys,
1954 .fetch_values = regdb_fetch_values,
1955 .store_subkeys = regdb_store_keys,
1956 .store_values = regdb_store_values,
1957 .create_subkey = regdb_create_subkey,
1958 .delete_subkey = regdb_delete_subkey,
1959 .get_secdesc = regdb_get_secdesc,
1960 .set_secdesc = regdb_set_secdesc,
1961 .subkeys_need_update = regdb_subkeys_need_update,
1962 .values_need_update = regdb_values_need_update