2 * Unix SMB/CIFS implementation.
3 * Virtual Windows Registry Layer
4 * Copyright (C) Gerald Carter 2002-2005
5 * Copyright (C) Michael Adam 2007-2011
6 * Copyright (C) Gregor Beck 2011
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 3 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, see <http://www.gnu.org/licenses/>.
22 /* Implementation of internal registry database functions. */
25 #include "system/filesys.h"
28 #include "reg_util_internal.h"
29 #include "reg_backend_db.h"
30 #include "reg_objects.h"
31 #include "nt_printing.h"
33 #include "dbwrap/dbwrap.h"
34 #include "dbwrap/dbwrap_open.h"
35 #include "../libcli/security/secdesc.h"
38 #define DBGC_CLASS DBGC_REGISTRY
40 #define REGDB_VERSION_KEYNAME "INFO/version"
42 static struct db_context *regdb = NULL;
43 static int regdb_refcount;
45 static bool regdb_key_exists(struct db_context *db, const char *key);
46 static WERROR regdb_fetch_keys_internal(struct db_context *db, const char *key,
47 struct regsubkey_ctr *ctr);
48 static bool regdb_store_keys_internal(struct db_context *db, const char *key,
49 struct regsubkey_ctr *ctr);
50 static int regdb_fetch_values_internal(struct db_context *db, const char* key,
51 struct regval_ctr *values);
52 static NTSTATUS regdb_store_values_internal(struct db_context *db, const char *key,
53 struct regval_ctr *values);
54 static WERROR regdb_store_subkey_list(struct db_context *db, const char *parent,
57 static WERROR regdb_create_basekey(struct db_context *db, const char *key);
58 static WERROR regdb_create_subkey_internal(struct db_context *db,
63 struct regdb_trans_ctx {
64 NTSTATUS (*action)(struct db_context *, void *);
68 static NTSTATUS regdb_trans_do_action(struct db_context *db, void *private_data)
72 struct regdb_trans_ctx *ctx = (struct regdb_trans_ctx *)private_data;
74 status = dbwrap_fetch_int32(db, REGDB_VERSION_KEYNAME, &version_id);
76 if (!NT_STATUS_IS_OK(status)) {
77 DEBUG(0, ("ERROR: could not fetch registry db version: %s. "
78 "Denying access.\n", nt_errstr(status)));
79 return NT_STATUS_ACCESS_DENIED;
82 if (version_id != REGDB_CODE_VERSION) {
83 DEBUG(0, ("ERROR: changed registry version %d found while "
84 "trying to write to the registry. Version %d "
85 "expected. Denying access.\n",
86 version_id, REGDB_CODE_VERSION));
87 return NT_STATUS_ACCESS_DENIED;
90 status = ctx->action(db, ctx->private_data);
94 static WERROR regdb_trans_do(struct db_context *db,
95 NTSTATUS (*action)(struct db_context *, void *),
99 struct regdb_trans_ctx ctx;
103 ctx.private_data = private_data;
105 status = dbwrap_trans_do(db, regdb_trans_do_action, &ctx);
107 return ntstatus_to_werror(status);
110 /* List the deepest path into the registry. All part components will be created.*/
112 /* If you want to have a part of the path controlled by the tdb and part by
113 a virtual registry db (e.g. printing), then you have to list the deepest path.
114 For example,"HKLM/SOFTWARE/Microsoft/Windows NT/CurrentVersion/Print"
115 allows the reg_db backend to handle everything up to
116 "HKLM/SOFTWARE/Microsoft/Windows NT/CurrentVersion" and then we'll hook
117 the reg_printing backend onto the last component of the path (see
118 KEY_PRINTING_2K in include/rpc_reg.h) --jerry */
120 static const char *builtin_registry_paths[] = {
124 KEY_PRINTING "\\Forms",
125 KEY_PRINTING "\\Printers",
126 KEY_PRINTING "\\Environments\\Windows NT x86\\Print Processors\\winprint",
133 KEY_SAMBA_GROUP_POLICY,
134 KEY_GP_MACHINE_POLICY,
135 KEY_GP_MACHINE_WIN_POLICY,
138 KEY_GP_USER_WIN_POLICY,
139 "HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion\\Winlogon\\GPExtensions",
140 "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Print\\Monitors",
142 "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Terminal Server\\DefaultUserConfiguration",
151 struct builtin_regkey_value {
153 const char *valuename;
161 static struct builtin_regkey_value builtin_registry_values[] = {
162 { KEY_PRINTING_PORTS,
163 SAMBA_PRINTER_PORT_NAME, REG_SZ, { "" } },
165 "DefaultSpoolDirectory", REG_SZ, { "C:\\Windows\\System32\\Spool\\Printers" } },
167 "DisplayName", REG_SZ, { "Event Log" } },
169 "ErrorControl", REG_DWORD, { (char*)0x00000001 } },
170 { NULL, NULL, 0, { NULL } }
173 static WERROR create_key_recursive(struct db_context *db,
180 if (subkey == NULL) {
181 return WERR_INVALID_PARAM;
185 return regdb_create_basekey(db, subkey);
188 p = strrchr_m(path, '\\');
191 werr = create_key_recursive(db, NULL, path);
194 werr = create_key_recursive(db, path, p+1);
198 if (!W_ERROR_IS_OK(werr)) {
202 werr = regdb_create_subkey_internal(db, path, subkey);
209 * Initialize a key in the registry:
210 * create each component key of the specified path.
212 static WERROR init_registry_key_internal(struct db_context *db,
213 const char *add_path)
217 TALLOC_CTX *frame = talloc_stackframe();
219 if (add_path == NULL) {
220 werr = WERR_INVALID_PARAM;
224 key = talloc_strdup(frame, add_path);
226 subkey = strrchr_m(key, '\\');
227 if (subkey == NULL) {
235 werr = create_key_recursive(db, key, subkey);
242 struct init_registry_key_context {
243 const char *add_path;
246 static NTSTATUS init_registry_key_action(struct db_context *db,
249 struct init_registry_key_context *init_ctx =
250 (struct init_registry_key_context *)private_data;
252 return werror_to_ntstatus(init_registry_key_internal(
253 db, init_ctx->add_path));
257 * Initialize a key in the registry:
258 * create each component key of the specified path,
259 * wrapped in one db transaction.
261 WERROR init_registry_key(const char *add_path)
263 struct init_registry_key_context init_ctx;
265 if (regdb_key_exists(regdb, add_path)) {
269 init_ctx.add_path = add_path;
271 return regdb_trans_do(regdb,
272 init_registry_key_action,
276 /***********************************************************************
277 Open the registry data in the tdb
278 ***********************************************************************/
280 static void regdb_ctr_add_value(struct regval_ctr *ctr,
281 struct builtin_regkey_value *value)
283 switch(value->type) {
285 regval_ctr_addvalue(ctr, value->valuename, REG_DWORD,
286 (uint8_t *)&value->data.dw_value,
291 regval_ctr_addvalue_sz(ctr, value->valuename,
296 DEBUG(0, ("regdb_ctr_add_value: invalid value type in "
297 "registry values [%d]\n", value->type));
301 static NTSTATUS init_registry_data_action(struct db_context *db,
305 TALLOC_CTX *frame = talloc_stackframe();
306 struct regval_ctr *values;
309 /* loop over all of the predefined paths and add each component */
311 for (i=0; builtin_registry_paths[i] != NULL; i++) {
312 if (regdb_key_exists(db, builtin_registry_paths[i])) {
315 status = werror_to_ntstatus(init_registry_key_internal(db,
316 builtin_registry_paths[i]));
317 if (!NT_STATUS_IS_OK(status)) {
322 /* loop over all of the predefined values and add each component */
324 for (i=0; builtin_registry_values[i].path != NULL; i++) {
327 werr = regval_ctr_init(frame, &values);
328 if (!W_ERROR_IS_OK(werr)) {
329 status = werror_to_ntstatus(werr);
333 regdb_fetch_values_internal(db,
334 builtin_registry_values[i].path,
337 /* preserve existing values across restarts. Only add new ones */
339 if (!regval_ctr_key_exists(values,
340 builtin_registry_values[i].valuename))
342 regdb_ctr_add_value(values,
343 &builtin_registry_values[i]);
344 status = regdb_store_values_internal(db,
345 builtin_registry_values[i].path,
347 if (!NT_STATUS_IS_OK(status)) {
354 status = NT_STATUS_OK;
362 WERROR init_registry_data(void)
365 TALLOC_CTX *frame = talloc_stackframe();
366 struct regval_ctr *values;
370 * First, check for the existence of the needed keys and values.
371 * If all do already exist, we can save the writes.
373 for (i=0; builtin_registry_paths[i] != NULL; i++) {
374 if (!regdb_key_exists(regdb, builtin_registry_paths[i])) {
379 for (i=0; builtin_registry_values[i].path != NULL; i++) {
380 werr = regval_ctr_init(frame, &values);
381 W_ERROR_NOT_OK_GOTO_DONE(werr);
383 regdb_fetch_values_internal(regdb,
384 builtin_registry_values[i].path,
386 if (!regval_ctr_key_exists(values,
387 builtin_registry_values[i].valuename))
402 * There are potentially quite a few store operations which are all
403 * indiviually wrapped in tdb transactions. Wrapping them in a single
404 * transaction gives just a single transaction_commit() to actually do
405 * its fsync()s. See tdb/common/transaction.c for info about nested
406 * transaction behaviour.
409 werr = regdb_trans_do(regdb,
410 init_registry_data_action,
418 static int regdb_normalize_keynames_fn(struct db_record *rec,
421 TALLOC_CTX *mem_ctx = talloc_tos();
426 struct db_context *db = (struct db_context *)private_data;
428 key = dbwrap_record_get_key(rec);
429 if (key.dptr == NULL || key.dsize == 0) {
433 value = dbwrap_record_get_value(rec);
436 DEBUG(0, ("regdb_normalize_keynames_fn: ERROR: "
437 "NULL db context handed in via private_data\n"));
441 if (strncmp((const char *)key.dptr, REGDB_VERSION_KEYNAME,
442 strlen(REGDB_VERSION_KEYNAME)) == 0)
447 keyname = strchr((const char *)key.dptr, '/');
449 keyname = talloc_string_sub(mem_ctx,
450 (const char *)key.dptr,
454 DEBUG(2, ("regdb_normalize_keynames_fn: Convert %s to %s\n",
455 (const char *)key.dptr,
458 /* Delete the original record and store the normalized key */
459 status = dbwrap_record_delete(rec);
460 if (!NT_STATUS_IS_OK(status)) {
461 DEBUG(0,("regdb_normalize_keynames_fn: "
462 "tdb_delete for [%s] failed!\n",
463 (const char *)key.dptr));
467 status = dbwrap_store_bystring(db, keyname, value, TDB_REPLACE);
468 if (!NT_STATUS_IS_OK(status)) {
469 DEBUG(0,("regdb_normalize_keynames_fn: "
470 "failed to store new record for [%s]!\n",
479 static WERROR regdb_store_regdb_version(struct db_context *db, uint32_t version)
483 return WERR_CAN_NOT_COMPLETE;
486 status = dbwrap_trans_store_int32(db, REGDB_VERSION_KEYNAME, version);
487 if (!NT_STATUS_IS_OK(status)) {
488 DEBUG(1, ("regdb_store_regdb_version: error storing %s = %d: %s\n",
489 REGDB_VERSION_KEYNAME, version, nt_errstr(status)));
490 return ntstatus_to_werror(status);
492 DEBUG(10, ("regdb_store_regdb_version: stored %s = %d\n",
493 REGDB_VERSION_KEYNAME, version));
498 static WERROR regdb_upgrade_v1_to_v2(struct db_context *db)
504 mem_ctx = talloc_stackframe();
506 status = dbwrap_traverse(db, regdb_normalize_keynames_fn, db, NULL);
507 if (!NT_STATUS_IS_OK(status)) {
508 werr = WERR_REG_IO_FAILURE;
512 werr = regdb_store_regdb_version(db, REGDB_VERSION_V2);
515 talloc_free(mem_ctx);
519 static int regdb_upgrade_v2_to_v3_fn(struct db_record *rec, void *private_data)
526 uint32_t buflen, len;
531 struct db_context *db = (struct db_context *)private_data;
533 key = dbwrap_record_get_key(rec);
534 if (key.dptr == NULL || key.dsize == 0) {
539 DEBUG(0, ("regdb_upgrade_v2_to_v3_fn: ERROR: "
540 "NULL db context handed in via private_data\n"));
544 keyname = (const char *)key.dptr;
546 if (strncmp(keyname, REGDB_VERSION_KEYNAME,
547 strlen(REGDB_VERSION_KEYNAME)) == 0)
552 if (strncmp(keyname, REG_SORTED_SUBKEYS_PREFIX,
553 strlen(REG_SORTED_SUBKEYS_PREFIX)) == 0)
555 /* Delete the deprecated sorted subkeys cache. */
557 DEBUG(10, ("regdb_upgrade_v2_to_v3: deleting [%s]\n", keyname));
559 status = dbwrap_record_delete(rec);
560 if (!NT_STATUS_IS_OK(status)) {
561 DEBUG(0, ("regdb_upgrade_v2_to_v3: tdb_delete for [%s] "
562 "failed!\n", keyname));
569 if (strncmp(keyname, REG_VALUE_PREFIX, strlen(REG_VALUE_PREFIX)) == 0) {
570 DEBUG(10, ("regdb_upgrade_v2_to_v3: skipping [%s]\n", keyname));
574 if (strncmp(keyname, REG_SECDESC_PREFIX,
575 strlen(REG_SECDESC_PREFIX)) == 0)
577 DEBUG(10, ("regdb_upgrade_v2_to_v3: skipping [%s]\n", keyname));
582 * Found a regular subkey list record.
583 * Walk the list and create the list record for those
584 * subkeys that don't already have one.
586 DEBUG(10, ("regdb_upgrade_v2_to_v3: scanning subkey list of [%s]\n",
589 value = dbwrap_record_get_value(rec);
591 buflen = value.dsize;
593 len = tdb_unpack(buf, buflen, "d", &num_items);
594 if (len == (uint32_t)-1) {
595 /* invalid or empty - skip */
599 for (i=0; i<num_items; i++) {
600 len += tdb_unpack(buf+len, buflen-len, "f", subkeyname);
601 DEBUG(10, ("regdb_upgrade_v2_to_v3: "
602 "writing subkey list for [%s\\%s]\n",
603 keyname, subkeyname));
604 werr = regdb_store_subkey_list(db, keyname, subkeyname);
605 if (!W_ERROR_IS_OK(werr)) {
613 static WERROR regdb_upgrade_v2_to_v3(struct db_context *db)
618 status = dbwrap_traverse(db, regdb_upgrade_v2_to_v3_fn, db, NULL);
619 if (!NT_STATUS_IS_OK(status)) {
620 werr = WERR_REG_IO_FAILURE;
624 werr = regdb_store_regdb_version(db, REGDB_VERSION_V3);
630 /***********************************************************************
631 Open the registry database
632 ***********************************************************************/
634 WERROR regdb_init(void)
641 DEBUG(10, ("regdb_init: incrementing refcount (%d->%d)\n",
642 regdb_refcount, regdb_refcount+1));
647 regdb = db_open(NULL, state_path("registry.tdb"), 0,
648 REG_TDB_FLAGS, O_RDWR, 0600);
650 regdb = db_open(NULL, state_path("registry.tdb"), 0,
651 REG_TDB_FLAGS, O_RDWR|O_CREAT, 0600);
653 werr = ntstatus_to_werror(map_nt_error_from_unix(errno));
654 DEBUG(1,("regdb_init: Failed to open registry %s (%s)\n",
655 state_path("registry.tdb"), strerror(errno) ));
659 DEBUG(10,("regdb_init: Successfully created registry tdb\n"));
663 DEBUG(10, ("regdb_init: registry db openend. refcount reset (%d)\n",
666 status = dbwrap_fetch_int32(regdb, REGDB_VERSION_KEYNAME, &vers_id);
667 if (!NT_STATUS_IS_OK(status)) {
668 DEBUG(10, ("regdb_init: registry version uninitialized "
669 "(got %d), initializing to version %d\n",
670 vers_id, REGDB_CODE_VERSION));
672 werr = regdb_store_regdb_version(regdb, REGDB_CODE_VERSION);
676 if (vers_id > REGDB_CODE_VERSION || vers_id == 0) {
677 DEBUG(0, ("regdb_init: unknown registry version %d "
678 "(code version = %d), refusing initialization\n",
679 vers_id, REGDB_CODE_VERSION));
680 return WERR_CAN_NOT_COMPLETE;
683 if (dbwrap_transaction_start(regdb) != 0) {
684 return WERR_REG_IO_FAILURE;
687 if (vers_id == REGDB_VERSION_V1) {
688 DEBUG(10, ("regdb_init: upgrading registry from version %d "
689 "to %d\n", REGDB_VERSION_V1, REGDB_VERSION_V2));
691 werr = regdb_upgrade_v1_to_v2(regdb);
692 if (!W_ERROR_IS_OK(werr)) {
693 dbwrap_transaction_cancel(regdb);
697 vers_id = REGDB_VERSION_V2;
700 if (vers_id == REGDB_VERSION_V2) {
701 DEBUG(10, ("regdb_init: upgrading registry from version %d "
702 "to %d\n", REGDB_VERSION_V2, REGDB_VERSION_V3));
704 werr = regdb_upgrade_v2_to_v3(regdb);
705 if (!W_ERROR_IS_OK(werr)) {
706 dbwrap_transaction_cancel(regdb);
710 vers_id = REGDB_VERSION_V3;
713 /* future upgrade code should go here */
715 if (dbwrap_transaction_commit(regdb) != 0) {
716 return WERR_REG_IO_FAILURE;
722 /***********************************************************************
723 Open the registry. Must already have been initialized by regdb_init()
724 ***********************************************************************/
726 WERROR regdb_open( void )
728 WERROR result = WERR_OK;
731 DEBUG(10, ("regdb_open: incrementing refcount (%d->%d)\n",
732 regdb_refcount, regdb_refcount+1));
739 regdb = db_open(NULL, state_path("registry.tdb"), 0,
740 REG_TDB_FLAGS, O_RDWR, 0600);
742 result = ntstatus_to_werror( map_nt_error_from_unix( errno ) );
743 DEBUG(0,("regdb_open: Failed to open %s! (%s)\n",
744 state_path("registry.tdb"), strerror(errno) ));
750 DEBUG(10, ("regdb_open: registry db opened. refcount reset (%d)\n",
756 /***********************************************************************
757 ***********************************************************************/
759 int regdb_close( void )
761 if (regdb_refcount == 0) {
767 DEBUG(10, ("regdb_close: decrementing refcount (%d->%d)\n",
768 regdb_refcount+1, regdb_refcount));
770 if ( regdb_refcount > 0 )
773 SMB_ASSERT( regdb_refcount >= 0 );
779 WERROR regdb_transaction_start(void)
781 return (dbwrap_transaction_start(regdb) == 0) ?
782 WERR_OK : WERR_REG_IO_FAILURE;
785 WERROR regdb_transaction_commit(void)
787 return (dbwrap_transaction_commit(regdb) == 0) ?
788 WERR_OK : WERR_REG_IO_FAILURE;
791 WERROR regdb_transaction_cancel(void)
793 return (dbwrap_transaction_cancel(regdb) == 0) ?
794 WERR_OK : WERR_REG_IO_FAILURE;
797 /***********************************************************************
798 return the tdb sequence number of the registry tdb.
799 this is an indicator for the content of the registry
800 having changed. it will change upon regdb_init, too, though.
801 ***********************************************************************/
802 int regdb_get_seqnum(void)
804 return dbwrap_get_seqnum(regdb);
808 static WERROR regdb_delete_key_with_prefix(struct db_context *db,
813 WERROR werr = WERR_NOMEM;
814 TALLOC_CTX *mem_ctx = talloc_stackframe();
816 if (keyname == NULL) {
817 werr = WERR_INVALID_PARAM;
821 if (prefix == NULL) {
822 path = discard_const_p(char, keyname);
824 path = talloc_asprintf(mem_ctx, "%s\\%s", prefix, keyname);
830 path = normalize_reg_path(mem_ctx, path);
835 werr = ntstatus_to_werror(dbwrap_delete_bystring(db, path));
837 /* treat "not found" as ok */
838 if (W_ERROR_EQUAL(werr, WERR_NOT_FOUND)) {
843 talloc_free(mem_ctx);
848 static WERROR regdb_delete_values(struct db_context *db, const char *keyname)
850 return regdb_delete_key_with_prefix(db, keyname, REG_VALUE_PREFIX);
853 static WERROR regdb_delete_secdesc(struct db_context *db, const char *keyname)
855 return regdb_delete_key_with_prefix(db, keyname, REG_SECDESC_PREFIX);
858 static WERROR regdb_delete_subkeylist(struct db_context *db, const char *keyname)
860 return regdb_delete_key_with_prefix(db, keyname, NULL);
864 static WERROR regdb_delete_key_lists(struct db_context *db, const char *keyname)
868 werr = regdb_delete_values(db, keyname);
869 if (!W_ERROR_IS_OK(werr)) {
870 DEBUG(1, (__location__ " Deleting %s\\%s failed: %s\n",
871 REG_VALUE_PREFIX, keyname, win_errstr(werr)));
875 werr = regdb_delete_secdesc(db, keyname);
876 if (!W_ERROR_IS_OK(werr)) {
877 DEBUG(1, (__location__ " Deleting %s\\%s failed: %s\n",
878 REG_SECDESC_PREFIX, keyname, win_errstr(werr)));
882 werr = regdb_delete_subkeylist(db, keyname);
883 if (!W_ERROR_IS_OK(werr)) {
884 DEBUG(1, (__location__ " Deleting %s failed: %s\n",
885 keyname, win_errstr(werr)));
893 /***********************************************************************
894 Add subkey strings to the registry tdb under a defined key
895 fmt is the same format as tdb_pack except this function only supports
897 ***********************************************************************/
899 static WERROR regdb_store_keys_internal2(struct db_context *db,
901 struct regsubkey_ctr *ctr)
904 uint8 *buffer = NULL;
907 uint32 num_subkeys = regsubkey_ctr_numkeys(ctr);
908 char *keyname = NULL;
909 TALLOC_CTX *ctx = talloc_stackframe();
913 werr = WERR_INVALID_PARAM;
917 keyname = talloc_strdup(ctx, key);
923 keyname = normalize_reg_path(ctx, keyname);
929 /* allocate some initial memory */
931 buffer = (uint8 *)SMB_MALLOC(1024);
932 if (buffer == NULL) {
939 /* store the number of subkeys */
941 len += tdb_pack(buffer+len, buflen-len, "d", num_subkeys);
943 /* pack all the strings */
945 for (i=0; i<num_subkeys; i++) {
948 thistime = tdb_pack(buffer+len, buflen-len, "f",
949 regsubkey_ctr_specific_key(ctr, i));
950 if (len+thistime > buflen) {
953 * tdb_pack hasn't done anything because of the short
954 * buffer, allocate extra space.
956 buffer = SMB_REALLOC_ARRAY(buffer, uint8_t,
959 DEBUG(0, ("regdb_store_keys: Failed to realloc "
960 "memory of size [%u]\n",
961 (unsigned int)(len+thistime)*2));
965 buflen = (len+thistime)*2;
966 thistime2 = tdb_pack(
967 buffer+len, buflen-len, "f",
968 regsubkey_ctr_specific_key(ctr, i));
969 if (thistime2 != thistime) {
970 DEBUG(0, ("tdb_pack failed\n"));
971 werr = WERR_CAN_NOT_COMPLETE;
978 /* finally write out the data */
982 werr = ntstatus_to_werror(dbwrap_store_bystring(db, keyname, dbuf,
992 * Utility function to store a new empty list of
993 * subkeys of given key specified as parent and subkey name
994 * (thereby creating the key).
995 * If the parent keyname is NULL, then the "subkey" is
996 * interpreted as a base key.
997 * If the subkey list does already exist, it is not modified.
999 * Must be called from within a transaction.
1001 static WERROR regdb_store_subkey_list(struct db_context *db, const char *parent,
1006 struct regsubkey_ctr *subkeys = NULL;
1007 TALLOC_CTX *frame = talloc_stackframe();
1009 if (parent == NULL) {
1010 path = talloc_strdup(frame, key);
1012 path = talloc_asprintf(frame, "%s\\%s", parent, key);
1019 werr = regsubkey_ctr_init(frame, &subkeys);
1020 W_ERROR_NOT_OK_GOTO_DONE(werr);
1022 werr = regdb_fetch_keys_internal(db, path, subkeys);
1023 if (W_ERROR_IS_OK(werr)) {
1024 /* subkey list exists already - don't modify */
1028 werr = regsubkey_ctr_reinit(subkeys);
1029 W_ERROR_NOT_OK_GOTO_DONE(werr);
1031 /* create a record with 0 subkeys */
1032 werr = regdb_store_keys_internal2(db, path, subkeys);
1033 if (!W_ERROR_IS_OK(werr)) {
1034 DEBUG(0, ("regdb_store_keys: Failed to store new record for "
1035 "key [%s]: %s\n", path, win_errstr(werr)));
1044 /***********************************************************************
1045 Store the new subkey record and create any child key records that
1046 do not currently exist
1047 ***********************************************************************/
1049 struct regdb_store_keys_context {
1051 struct regsubkey_ctr *ctr;
1054 static NTSTATUS regdb_store_keys_action(struct db_context *db,
1057 struct regdb_store_keys_context *store_ctx;
1061 struct regsubkey_ctr *old_subkeys = NULL;
1062 char *oldkeyname = NULL;
1063 TALLOC_CTX *mem_ctx = talloc_stackframe();
1065 store_ctx = (struct regdb_store_keys_context *)private_data;
1068 * Re-fetch the old keys inside the transaction
1071 werr = regsubkey_ctr_init(mem_ctx, &old_subkeys);
1072 W_ERROR_NOT_OK_GOTO_DONE(werr);
1074 werr = regdb_fetch_keys_internal(db, store_ctx->key, old_subkeys);
1075 if (!W_ERROR_IS_OK(werr) &&
1076 !W_ERROR_EQUAL(werr, WERR_NOT_FOUND))
1082 * Make the store operation as safe as possible without transactions:
1084 * (1) For each subkey removed from ctr compared with old_subkeys:
1086 * (a) First delete the value db entry.
1088 * (b) Next delete the secdesc db record.
1090 * (c) Then delete the subkey list entry.
1092 * (2) Now write the list of subkeys of the parent key,
1093 * deleting removed entries and adding new ones.
1095 * (3) Finally create the subkey list entries for the added keys.
1097 * This way if we crash half-way in between deleting the subkeys
1098 * and storing the parent's list of subkeys, no old data can pop up
1099 * out of the blue when re-adding keys later on.
1102 /* (1) delete removed keys' lists (values/secdesc/subkeys) */
1104 num_subkeys = regsubkey_ctr_numkeys(old_subkeys);
1105 for (i=0; i<num_subkeys; i++) {
1106 oldkeyname = regsubkey_ctr_specific_key(old_subkeys, i);
1108 if (regsubkey_ctr_key_exists(store_ctx->ctr, oldkeyname)) {
1110 * It's still around, don't delete
1115 path = talloc_asprintf(mem_ctx, "%s\\%s", store_ctx->key,
1122 werr = regdb_delete_key_lists(db, path);
1123 W_ERROR_NOT_OK_GOTO_DONE(werr);
1128 TALLOC_FREE(old_subkeys);
1130 /* (2) store the subkey list for the parent */
1132 werr = regdb_store_keys_internal2(db, store_ctx->key, store_ctx->ctr);
1133 if (!W_ERROR_IS_OK(werr)) {
1134 DEBUG(0,("regdb_store_keys: Failed to store new subkey list "
1135 "for parent [%s]: %s\n", store_ctx->key,
1140 /* (3) now create records for any subkeys that don't already exist */
1142 num_subkeys = regsubkey_ctr_numkeys(store_ctx->ctr);
1144 for (i=0; i<num_subkeys; i++) {
1147 subkey = regsubkey_ctr_specific_key(store_ctx->ctr, i);
1149 werr = regdb_store_subkey_list(db, store_ctx->key, subkey);
1150 W_ERROR_NOT_OK_GOTO_DONE(werr);
1156 talloc_free(mem_ctx);
1157 return werror_to_ntstatus(werr);
1160 static bool regdb_store_keys_internal(struct db_context *db, const char *key,
1161 struct regsubkey_ctr *ctr)
1163 int num_subkeys, old_num_subkeys, i;
1164 struct regsubkey_ctr *old_subkeys = NULL;
1165 TALLOC_CTX *ctx = talloc_stackframe();
1168 struct regdb_store_keys_context store_ctx;
1170 if (!regdb_key_exists(db, key)) {
1175 * fetch a list of the old subkeys so we can determine if anything has
1179 werr = regsubkey_ctr_init(ctx, &old_subkeys);
1180 if (!W_ERROR_IS_OK(werr)) {
1181 DEBUG(0,("regdb_store_keys: talloc() failure!\n"));
1185 werr = regdb_fetch_keys_internal(db, key, old_subkeys);
1186 if (!W_ERROR_IS_OK(werr) &&
1187 !W_ERROR_EQUAL(werr, WERR_NOT_FOUND))
1192 num_subkeys = regsubkey_ctr_numkeys(ctr);
1193 old_num_subkeys = regsubkey_ctr_numkeys(old_subkeys);
1194 if ((num_subkeys && old_num_subkeys) &&
1195 (num_subkeys == old_num_subkeys)) {
1197 for (i = 0; i < num_subkeys; i++) {
1198 if (strcmp(regsubkey_ctr_specific_key(ctr, i),
1199 regsubkey_ctr_specific_key(old_subkeys, i))
1205 if (i == num_subkeys) {
1207 * Nothing changed, no point to even start a tdb
1216 TALLOC_FREE(old_subkeys);
1218 store_ctx.key = key;
1219 store_ctx.ctr = ctr;
1221 werr = regdb_trans_do(db,
1222 regdb_store_keys_action,
1225 ret = W_ERROR_IS_OK(werr);
1233 bool regdb_store_keys(const char *key, struct regsubkey_ctr *ctr)
1235 return regdb_store_keys_internal(regdb, key, ctr);
1239 * create a subkey of a given key
1242 struct regdb_create_subkey_context {
1247 static NTSTATUS regdb_create_subkey_action(struct db_context *db,
1251 struct regdb_create_subkey_context *create_ctx;
1252 struct regsubkey_ctr *subkeys;
1253 TALLOC_CTX *mem_ctx = talloc_stackframe();
1255 create_ctx = (struct regdb_create_subkey_context *)private_data;
1257 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
1258 W_ERROR_NOT_OK_GOTO_DONE(werr);
1260 werr = regdb_fetch_keys_internal(db, create_ctx->key, subkeys);
1261 W_ERROR_NOT_OK_GOTO_DONE(werr);
1263 werr = regsubkey_ctr_addkey(subkeys, create_ctx->subkey);
1264 W_ERROR_NOT_OK_GOTO_DONE(werr);
1266 werr = regdb_store_keys_internal2(db, create_ctx->key, subkeys);
1267 if (!W_ERROR_IS_OK(werr)) {
1268 DEBUG(0, (__location__ " failed to store new subkey list for "
1269 "parent key %s: %s\n", create_ctx->key,
1273 werr = regdb_store_subkey_list(db, create_ctx->key, create_ctx->subkey);
1276 talloc_free(mem_ctx);
1277 return werror_to_ntstatus(werr);
1280 static WERROR regdb_create_subkey_internal(struct db_context *db,
1285 struct regsubkey_ctr *subkeys;
1286 TALLOC_CTX *mem_ctx = talloc_stackframe();
1287 struct regdb_create_subkey_context create_ctx;
1289 if (!regdb_key_exists(db, key)) {
1290 werr = WERR_NOT_FOUND;
1294 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
1295 W_ERROR_NOT_OK_GOTO_DONE(werr);
1297 werr = regdb_fetch_keys_internal(db, key, subkeys);
1298 W_ERROR_NOT_OK_GOTO_DONE(werr);
1300 if (regsubkey_ctr_key_exists(subkeys, subkey)) {
1303 newkey = talloc_asprintf(mem_ctx, "%s\\%s", key, subkey);
1304 if (newkey == NULL) {
1309 if (regdb_key_exists(db, newkey)) {
1315 talloc_free(subkeys);
1317 create_ctx.key = key;
1318 create_ctx.subkey = subkey;
1320 werr = regdb_trans_do(db,
1321 regdb_create_subkey_action,
1325 talloc_free(mem_ctx);
1329 static WERROR regdb_create_subkey(const char *key, const char *subkey)
1331 return regdb_create_subkey_internal(regdb, key, subkey);
1338 struct regdb_create_basekey_context {
1342 static NTSTATUS regdb_create_basekey_action(struct db_context *db,
1346 struct regdb_create_basekey_context *create_ctx;
1348 create_ctx = (struct regdb_create_basekey_context *)private_data;
1350 werr = regdb_store_subkey_list(db, NULL, create_ctx->key);
1352 return werror_to_ntstatus(werr);
1355 static WERROR regdb_create_basekey(struct db_context *db, const char *key)
1358 struct regdb_create_subkey_context create_ctx;
1360 create_ctx.key = key;
1362 werr = regdb_trans_do(db,
1363 regdb_create_basekey_action,
1370 * create a subkey of a given key
1373 struct regdb_delete_subkey_context {
1380 static NTSTATUS regdb_delete_subkey_action(struct db_context *db,
1384 struct regdb_delete_subkey_context *delete_ctx;
1385 struct regsubkey_ctr *subkeys;
1386 TALLOC_CTX *mem_ctx = talloc_stackframe();
1388 delete_ctx = (struct regdb_delete_subkey_context *)private_data;
1390 werr = regdb_delete_key_lists(db, delete_ctx->path);
1391 W_ERROR_NOT_OK_GOTO_DONE(werr);
1393 if (delete_ctx->lazy) {
1397 werr = regsubkey_ctr_init(mem_ctx, &subkeys);
1398 W_ERROR_NOT_OK_GOTO_DONE(werr);
1400 werr = regdb_fetch_keys_internal(db, delete_ctx->key, subkeys);
1401 W_ERROR_NOT_OK_GOTO_DONE(werr);
1403 werr = regsubkey_ctr_delkey(subkeys, delete_ctx->subkey);
1404 W_ERROR_NOT_OK_GOTO_DONE(werr);
1406 werr = regdb_store_keys_internal2(db, delete_ctx->key, subkeys);
1407 if (!W_ERROR_IS_OK(werr)) {
1408 DEBUG(0, (__location__ " failed to store new subkey_list for "
1409 "parent key %s: %s\n", delete_ctx->key,
1414 talloc_free(mem_ctx);
1415 return werror_to_ntstatus(werr);
1418 static WERROR regdb_delete_subkey(const char *key, const char *subkey, bool lazy)
1422 struct regdb_delete_subkey_context delete_ctx;
1423 TALLOC_CTX *mem_ctx = talloc_stackframe();
1425 if (!regdb_key_exists(regdb, key)) {
1426 werr = WERR_NOT_FOUND;
1430 path = talloc_asprintf(mem_ctx, "%s\\%s", key, subkey);
1436 if (!regdb_key_exists(regdb, path)) {
1441 delete_ctx.key = key;
1442 delete_ctx.subkey = subkey;
1443 delete_ctx.path = path;
1444 delete_ctx.lazy = lazy;
1446 werr = regdb_trans_do(regdb,
1447 regdb_delete_subkey_action,
1451 talloc_free(mem_ctx);
1455 static TDB_DATA regdb_fetch_key_internal(struct db_context *db,
1456 TALLOC_CTX *mem_ctx, const char *key)
1462 path = normalize_reg_path(mem_ctx, key);
1464 return make_tdb_data(NULL, 0);
1467 status = dbwrap_fetch_bystring(db, mem_ctx, path, &data);
1468 if (!NT_STATUS_IS_OK(status)) {
1478 * Check for the existence of a key.
1480 * Existence of a key is authoritatively defined by
1481 * the existence of the record that contains the list
1484 * Return false, if the record does not match the correct
1485 * structure of an initial 4-byte counter and then a
1486 * list of the corresponding number of zero-terminated
1489 static bool regdb_key_exists(struct db_context *db, const char *key)
1491 TALLOC_CTX *mem_ctx = talloc_stackframe();
1497 uint32_t num_items, i;
1504 path = normalize_reg_path(mem_ctx, key);
1506 DEBUG(0, ("out of memory! (talloc failed)\n"));
1510 if (*path == '\0') {
1514 value = regdb_fetch_key_internal(db, mem_ctx, path);
1515 if (value.dptr == NULL) {
1519 if (value.dsize == 0) {
1520 DEBUG(10, ("regdb_key_exists: subkeylist-record for key "
1521 "[%s] is empty: Could be a deleted record in a "
1522 "clustered (ctdb) environment?\n",
1527 len = tdb_unpack(value.dptr, value.dsize, "d", &num_items);
1528 if (len == (int32_t)-1) {
1529 DEBUG(1, ("regdb_key_exists: ERROR: subkeylist-record for key "
1530 "[%s] is invalid: Could not parse initial 4-byte "
1531 "counter. record data length is %u.\n",
1532 path, (unsigned int)value.dsize));
1537 * Note: the tdb_unpack check above implies that len <= value.dsize
1539 buflen = value.dsize - len;
1540 buf = (const char *)value.dptr + len;
1544 for (i = 0; i < num_items; i++) {
1548 len = strnlen(buf, buflen) + 1;
1550 DEBUG(1, ("regdb_key_exists: ERROR: subkeylist-record "
1551 "for key [%s] is corrupt: %u items expected, "
1552 "item number %u is not zero terminated.\n",
1553 path, num_items, i+1));
1562 DEBUG(1, ("regdb_key_exists: ERROR: subkeylist-record for key "
1563 "[%s] is corrupt: %u items expected and found, but "
1564 "the record contains additional %u bytes\n",
1565 path, num_items, buflen));
1569 if (i < num_items) {
1570 DEBUG(1, ("regdb_key_exists: ERROR: subkeylist-record for key "
1571 "[%s] is corrupt: %u items expected, but only %u "
1573 path, num_items, i+1));
1580 TALLOC_FREE(mem_ctx);
1585 /***********************************************************************
1586 Retrieve an array of strings containing subkeys. Memory should be
1587 released by the caller.
1588 ***********************************************************************/
1590 static WERROR regdb_fetch_keys_internal(struct db_context *db, const char *key,
1591 struct regsubkey_ctr *ctr)
1599 TALLOC_CTX *frame = talloc_stackframe();
1602 DEBUG(11,("regdb_fetch_keys: Enter key => [%s]\n", key ? key : "NULL"));
1604 if (!regdb_key_exists(db, key)) {
1605 DEBUG(10, ("key [%s] not found\n", key));
1606 werr = WERR_NOT_FOUND;
1610 werr = regsubkey_ctr_reinit(ctr);
1611 W_ERROR_NOT_OK_GOTO_DONE(werr);
1613 werr = regsubkey_ctr_set_seqnum(ctr, dbwrap_get_seqnum(db));
1614 W_ERROR_NOT_OK_GOTO_DONE(werr);
1616 value = regdb_fetch_key_internal(db, frame, key);
1618 if (value.dsize == 0 || value.dptr == NULL) {
1619 DEBUG(10, ("regdb_fetch_keys: no subkeys found for key [%s]\n",
1625 buflen = value.dsize;
1626 len = tdb_unpack( buf, buflen, "d", &num_items);
1627 if (len == (uint32_t)-1) {
1628 werr = WERR_NOT_FOUND;
1632 for (i=0; i<num_items; i++) {
1633 len += tdb_unpack(buf+len, buflen-len, "f", subkeyname);
1634 werr = regsubkey_ctr_addkey(ctr, subkeyname);
1635 if (!W_ERROR_IS_OK(werr)) {
1636 DEBUG(5, ("regdb_fetch_keys: regsubkey_ctr_addkey "
1637 "failed: %s\n", win_errstr(werr)));
1643 DEBUG(11,("regdb_fetch_keys: Exit [%d] items\n", num_items));
1650 int regdb_fetch_keys(const char *key, struct regsubkey_ctr *ctr)
1654 werr = regdb_fetch_keys_internal(regdb, key, ctr);
1655 if (!W_ERROR_IS_OK(werr)) {
1659 return regsubkey_ctr_numkeys(ctr);
1662 /****************************************************************************
1663 Unpack a list of registry values frem the TDB
1664 ***************************************************************************/
1666 static int regdb_unpack_values(struct regval_ctr *values, uint8 *buf, int buflen)
1673 uint32 num_values = 0;
1676 /* loop and unpack the rest of the registry values */
1678 len += tdb_unpack(buf+len, buflen-len, "d", &num_values);
1680 for ( i=0; i<num_values; i++ ) {
1681 /* unpack the next regval */
1686 valuename[0] = '\0';
1687 len += tdb_unpack(buf+len, buflen-len, "fdB",
1693 regval_ctr_addvalue(values, valuename, type,
1694 (uint8_t *)data_p, size);
1695 SAFE_FREE(data_p); /* 'B' option to tdb_unpack does a malloc() */
1697 DEBUG(8,("specific: [%s], len: %d\n", valuename, size));
1703 /****************************************************************************
1704 Pack all values in all printer keys
1705 ***************************************************************************/
1707 static int regdb_pack_values(struct regval_ctr *values, uint8 *buf, int buflen)
1711 struct regval_blob *val;
1717 num_values = regval_ctr_numvals( values );
1719 /* pack the number of values first */
1721 len += tdb_pack( buf+len, buflen-len, "d", num_values );
1723 /* loop over all values */
1725 for ( i=0; i<num_values; i++ ) {
1726 val = regval_ctr_specific_value( values, i );
1727 len += tdb_pack(buf+len, buflen-len, "fdB",
1731 regval_data_p(val) );
1737 /***********************************************************************
1738 Retrieve an array of strings containing subkeys. Memory should be
1739 released by the caller.
1740 ***********************************************************************/
1742 static int regdb_fetch_values_internal(struct db_context *db, const char* key,
1743 struct regval_ctr *values)
1745 char *keystr = NULL;
1746 TALLOC_CTX *ctx = talloc_stackframe();
1751 DEBUG(10,("regdb_fetch_values: Looking for value of key [%s] \n", key));
1753 if (!regdb_key_exists(db, key)) {
1757 keystr = talloc_asprintf(ctx, "%s\\%s", REG_VALUE_PREFIX, key);
1762 werr = regval_ctr_set_seqnum(values, dbwrap_get_seqnum(db));
1763 W_ERROR_NOT_OK_GOTO_DONE(werr);
1765 value = regdb_fetch_key_internal(db, ctx, keystr);
1768 /* all keys have zero values by default */
1772 regdb_unpack_values(values, value.dptr, value.dsize);
1773 ret = regval_ctr_numvals(values);
1780 int regdb_fetch_values(const char* key, struct regval_ctr *values)
1782 return regdb_fetch_values_internal(regdb, key, values);
1785 static NTSTATUS regdb_store_values_internal(struct db_context *db,
1787 struct regval_ctr *values)
1789 TDB_DATA old_data, data;
1790 char *keystr = NULL;
1791 TALLOC_CTX *ctx = talloc_stackframe();
1795 DEBUG(10,("regdb_store_values: Looking for value of key [%s] \n", key));
1797 if (!regdb_key_exists(db, key)) {
1798 status = NT_STATUS_NOT_FOUND;
1804 len = regdb_pack_values(values, data.dptr, data.dsize);
1806 DEBUG(0,("regdb_store_values: unable to pack values. len <= 0\n"));
1807 status = NT_STATUS_UNSUCCESSFUL;
1811 data.dptr = talloc_array(ctx, uint8, len);
1814 len = regdb_pack_values(values, data.dptr, data.dsize);
1816 SMB_ASSERT( len == data.dsize );
1818 keystr = talloc_asprintf(ctx, "%s\\%s", REG_VALUE_PREFIX, key );
1820 status = NT_STATUS_NO_MEMORY;
1823 keystr = normalize_reg_path(ctx, keystr);
1825 status = NT_STATUS_NO_MEMORY;
1829 status = dbwrap_fetch_bystring(db, ctx, keystr, &old_data);
1831 if (NT_STATUS_IS_OK(status)
1832 && (old_data.dptr != NULL)
1833 && (old_data.dsize == data.dsize)
1834 && (memcmp(old_data.dptr, data.dptr, data.dsize) == 0))
1836 status = NT_STATUS_OK;
1840 status = dbwrap_trans_store_bystring(db, keystr, data, TDB_REPLACE);
1847 struct regdb_store_values_ctx {
1849 struct regval_ctr *values;
1852 static NTSTATUS regdb_store_values_action(struct db_context *db,
1856 struct regdb_store_values_ctx *ctx =
1857 (struct regdb_store_values_ctx *)private_data;
1859 status = regdb_store_values_internal(db, ctx->key, ctx->values);
1864 bool regdb_store_values(const char *key, struct regval_ctr *values)
1867 struct regdb_store_values_ctx ctx;
1870 ctx.values = values;
1872 werr = regdb_trans_do(regdb, regdb_store_values_action, &ctx);
1874 return W_ERROR_IS_OK(werr);
1877 static WERROR regdb_get_secdesc(TALLOC_CTX *mem_ctx, const char *key,
1878 struct security_descriptor **psecdesc)
1883 TALLOC_CTX *tmp_ctx = talloc_stackframe();
1884 WERROR err = WERR_OK;
1886 DEBUG(10, ("regdb_get_secdesc: Getting secdesc of key [%s]\n", key));
1888 if (!regdb_key_exists(regdb, key)) {
1893 tdbkey = talloc_asprintf(tmp_ctx, "%s\\%s", REG_SECDESC_PREFIX, key);
1894 if (tdbkey == NULL) {
1899 tdbkey = normalize_reg_path(tmp_ctx, tdbkey);
1900 if (tdbkey == NULL) {
1905 status = dbwrap_fetch_bystring(regdb, tmp_ctx, tdbkey, &data);
1906 if (!NT_STATUS_IS_OK(status)) {
1911 status = unmarshall_sec_desc(mem_ctx, (uint8 *)data.dptr, data.dsize,
1914 if (NT_STATUS_EQUAL(status, NT_STATUS_NO_MEMORY)) {
1916 } else if (!NT_STATUS_IS_OK(status)) {
1917 err = WERR_REG_CORRUPT;
1921 TALLOC_FREE(tmp_ctx);
1925 struct regdb_set_secdesc_ctx {
1927 struct security_descriptor *secdesc;
1930 static NTSTATUS regdb_set_secdesc_action(struct db_context *db,
1936 struct regdb_set_secdesc_ctx *ctx =
1937 (struct regdb_set_secdesc_ctx *)private_data;
1938 TALLOC_CTX *frame = talloc_stackframe();
1940 tdbkey = talloc_asprintf(frame, "%s\\%s", REG_SECDESC_PREFIX, ctx->key);
1941 if (tdbkey == NULL) {
1942 status = NT_STATUS_NO_MEMORY;
1946 tdbkey = normalize_reg_path(frame, tdbkey);
1947 if (tdbkey == NULL) {
1948 status = NT_STATUS_NO_MEMORY;
1952 if (ctx->secdesc == NULL) {
1953 /* assuming a delete */
1954 status = dbwrap_delete_bystring(db, tdbkey);
1958 status = marshall_sec_desc(frame, ctx->secdesc, &tdbdata.dptr,
1960 if (!NT_STATUS_IS_OK(status)) {
1964 status = dbwrap_store_bystring(db, tdbkey, tdbdata, 0);
1971 static WERROR regdb_set_secdesc(const char *key,
1972 struct security_descriptor *secdesc)
1975 struct regdb_set_secdesc_ctx ctx;
1977 if (!regdb_key_exists(regdb, key)) {
1983 ctx.secdesc = secdesc;
1985 err = regdb_trans_do(regdb, regdb_set_secdesc_action, &ctx);
1991 bool regdb_subkeys_need_update(struct regsubkey_ctr *subkeys)
1993 return (regdb_get_seqnum() != regsubkey_ctr_get_seqnum(subkeys));
1996 bool regdb_values_need_update(struct regval_ctr *values)
1998 return (regdb_get_seqnum() != regval_ctr_get_seqnum(values));
2002 * Table of function pointers for default access
2005 struct registry_ops regdb_ops = {
2006 .fetch_subkeys = regdb_fetch_keys,
2007 .fetch_values = regdb_fetch_values,
2008 .store_subkeys = regdb_store_keys,
2009 .store_values = regdb_store_values,
2010 .create_subkey = regdb_create_subkey,
2011 .delete_subkey = regdb_delete_subkey,
2012 .get_secdesc = regdb_get_secdesc,
2013 .set_secdesc = regdb_set_secdesc,
2014 .subkeys_need_update = regdb_subkeys_need_update,
2015 .values_need_update = regdb_values_need_update