2 Unix SMB/CIFS implementation.
3 simple registry frontend
5 Copyright (C) Jelmer Vernooij 2004-2007
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/>.
22 #include "lib/registry/registry.h"
23 #include "lib/cmdline/popt_common.h"
24 #include "lib/events/events.h"
25 #include "system/time.h"
26 #include "lib/smbreadline/smbreadline.h"
27 #include "librpc/gen_ndr/ndr_security.h"
28 #include "lib/registry/tools/common.h"
29 #include "param/param.h"
31 struct regshell_context {
32 struct registry_context *registry;
34 struct registry_key *current;
39 * ls - list values/keys
40 * rmval/rm - remove value
41 * rmkey/rmdir - remove key
42 * mkkey/mkdir - make key
44 * info - show key info
51 static WERROR cmd_info(struct regshell_context *ctx, int argc, char **argv)
53 struct security_descriptor *sec_desc = NULL;
56 const char *classname = NULL;
58 uint32_t max_subkeynamelen;
59 uint32_t max_valnamelen;
60 uint32_t max_valbufsize;
64 error = reg_key_get_info(ctx, ctx->current, &classname, &num_subkeys, &num_values,
65 &last_change, &max_subkeynamelen, &max_valnamelen, &max_valbufsize);
66 if (!W_ERROR_IS_OK(error)) {
67 printf("Error getting key info: %s\n", win_errstr(error));
72 printf("Name: %s\n", strchr(ctx->path, '\\')?strrchr(ctx->path, '\\')+1:
74 printf("Full path: %s\n", ctx->path);
75 if (classname != NULL)
76 printf("Key Class: %s\n", classname);
77 last_mod = nt_time_to_unix(last_change);
78 printf("Time Last Modified: %s\n", ctime(&last_mod));
79 printf("Number of subkeys: %d\n", num_subkeys);
80 printf("Number of values: %d\n", num_values);
82 if (max_valnamelen > 0)
83 printf("Maximum value name length: %d\n", max_valnamelen);
85 if (max_valbufsize > 0)
86 printf("Maximum value data length: %d\n", max_valbufsize);
88 if (max_subkeynamelen > 0)
89 printf("Maximum sub key name length: %d\n", max_subkeynamelen);
91 error = reg_get_sec_desc(ctx, ctx->current, &sec_desc);
92 if (!W_ERROR_IS_OK(error)) {
93 printf("Error getting security descriptor\n");
96 ndr_print_debug((ndr_print_fn_t)ndr_print_security_descriptor,
97 "Security", sec_desc);
98 talloc_free(sec_desc);
103 static WERROR cmd_predef(struct regshell_context *ctx, int argc, char **argv)
105 struct registry_key *ret = NULL;
107 fprintf(stderr, "Usage: predef predefined-key-name\n");
109 fprintf(stderr, "No full registry loaded, no predefined keys defined\n");
111 WERROR error = reg_get_predefined_key_by_name(ctx->registry,
114 if (!W_ERROR_IS_OK(error)) {
115 fprintf(stderr, "Error opening predefined key %s: %s\n",
116 argv[1], win_errstr(error));
120 ctx->path = strupper_talloc(ctx, argv[1]);
127 static WERROR cmd_pwd(struct regshell_context *ctx,
128 int argc, char **argv)
130 printf("%s\n", ctx->path);
134 static WERROR cmd_set(struct regshell_context *ctx, int argc, char **argv)
136 struct registry_value val;
140 fprintf(stderr, "Usage: set value-name type value\n");
141 return WERR_INVALID_PARAM;
144 if (!reg_string_to_val(ctx, argv[2], argv[3], &val.data_type,
146 fprintf(stderr, "Unable to interpret data\n");
147 return WERR_INVALID_PARAM;
150 error = reg_val_set(ctx->current, argv[1], val.data_type, val.data);
151 if (!W_ERROR_IS_OK(error)) {
152 fprintf(stderr, "Error setting value: %s\n", win_errstr(error));
159 static WERROR cmd_ck(struct regshell_context *ctx, int argc, char **argv)
161 struct registry_key *new = NULL;
167 error = reg_open_key(ctx->registry, ctx->current, argv[1],
169 if(!W_ERROR_IS_OK(error)) {
170 DEBUG(0, ("Error opening specified key: %s\n",
176 ctx->path = talloc_asprintf(ctx, "%s\\%s", ctx->path, argv[1]);
177 printf("Current path is: %s\n", ctx->path);
183 static WERROR cmd_print(struct regshell_context *ctx, int argc, char **argv)
186 DATA_BLOB value_data;
190 fprintf(stderr, "Usage: print <valuename>");
191 return WERR_INVALID_PARAM;
194 error = reg_key_get_value_by_name(ctx, ctx->current, argv[1],
195 &value_type, &value_data);
196 if (!W_ERROR_IS_OK(error)) {
197 fprintf(stderr, "No such value '%s'\n", argv[1]);
201 printf("%s\n%s\n", str_regtype(value_type),
202 reg_val_data_string(ctx, value_type, value_data));
207 static WERROR cmd_ls(struct regshell_context *ctx, int argc, char **argv)
213 const char *name = NULL;
215 for (i = 0; W_ERROR_IS_OK(error = reg_key_get_subkey_by_index(ctx,
221 printf("K %s\n", name);
224 if (!W_ERROR_EQUAL(error, WERR_NO_MORE_ITEMS)) {
225 DEBUG(0, ("Error occured while browsing thru keys: %s\n",
229 for (i = 0; W_ERROR_IS_OK(error = reg_key_get_value_by_index(ctx,
235 printf("V \"%s\" %s %s\n", name, str_regtype(data_type),
236 reg_val_data_string(ctx, data_type, data));
241 static WERROR cmd_mkkey(struct regshell_context *ctx, int argc, char **argv)
243 struct registry_key *tmp;
247 fprintf(stderr, "Usage: mkkey <keyname>\n");
248 return WERR_INVALID_PARAM;
251 error = reg_key_add_name(ctx, ctx->current, argv[1], 0, NULL, &tmp);
253 if (!W_ERROR_IS_OK(error)) {
254 fprintf(stderr, "Error adding new subkey '%s'\n", argv[1]);
261 static WERROR cmd_rmkey(struct regshell_context *ctx,
262 int argc, char **argv)
267 fprintf(stderr, "Usage: rmkey <name>\n");
268 return WERR_INVALID_PARAM;
271 error = reg_key_del(ctx->current, argv[1]);
272 if(!W_ERROR_IS_OK(error)) {
273 fprintf(stderr, "Error deleting '%s'\n", argv[1]);
276 fprintf(stderr, "Successfully deleted '%s'\n", argv[1]);
282 static WERROR cmd_rmval(struct regshell_context *ctx, int argc, char **argv)
287 fprintf(stderr, "Usage: rmval <valuename>\n");
288 return WERR_INVALID_PARAM;
291 error = reg_del_value(ctx->current, argv[1]);
292 if(!W_ERROR_IS_OK(error)) {
293 fprintf(stderr, "Error deleting value '%s'\n", argv[1]);
296 fprintf(stderr, "Successfully deleted value '%s'\n", argv[1]);
302 _NORETURN_ static WERROR cmd_exit(struct regshell_context *ctx,
303 int argc, char **argv)
309 static WERROR cmd_help(struct regshell_context *ctx, int, char **);
315 WERROR (*handle)(struct regshell_context *ctx, int argc, char **argv);
316 } regshell_cmds[] = {
317 {"ck", "cd", "Change current key", cmd_ck },
318 {"info", "i", "Show detailed information of a key", cmd_info },
319 {"list", "ls", "List values/keys in current key", cmd_ls },
320 {"print", "p", "Print value", cmd_print },
321 {"mkkey", "mkdir", "Make new key", cmd_mkkey },
322 {"rmval", "rm", "Remove value", cmd_rmval },
323 {"rmkey", "rmdir", "Remove key", cmd_rmkey },
324 {"pwd", "pwk", "Printing current key", cmd_pwd },
325 {"set", "update", "Update value", cmd_set },
326 {"help", "?", "Help", cmd_help },
327 {"exit", "quit", "Exit", cmd_exit },
328 {"predef", "predefined", "Go to predefined key", cmd_predef },
332 static WERROR cmd_help(struct regshell_context *ctx,
333 int argc, char **argv)
336 printf("Available commands:\n");
337 for(i = 0; regshell_cmds[i].name; i++) {
338 printf("%s - %s\n", regshell_cmds[i].name,
339 regshell_cmds[i].help);
344 static WERROR process_cmd(struct regshell_context *ctx,
351 if ((ret = poptParseArgvString(line, &argc, (const char ***) &argv)) != 0) {
352 fprintf(stderr, "regshell: %s\n", poptStrerror(ret));
353 return WERR_INVALID_PARAM;
356 for(i = 0; regshell_cmds[i].name; i++) {
357 if(!strcmp(regshell_cmds[i].name, argv[0]) ||
358 (regshell_cmds[i].alias && !strcmp(regshell_cmds[i].alias, argv[0]))) {
359 return regshell_cmds[i].handle(ctx, argc, argv);
363 fprintf(stderr, "No such command '%s'\n", argv[0]);
365 return WERR_INVALID_PARAM;
368 #define MAX_COMPLETIONS 100
370 static struct registry_key *current_key = NULL;
372 static char **reg_complete_command(const char *text, int start, int end)
374 /* Complete command */
376 int i, len, samelen=0, count=1;
378 matches = malloc_array_p(char *, MAX_COMPLETIONS);
379 if (!matches) return NULL;
383 for (i=0;regshell_cmds[i].handle && count < MAX_COMPLETIONS-1;i++) {
384 if (strncmp(text, regshell_cmds[i].name, len) == 0) {
385 matches[count] = strdup(regshell_cmds[i].name);
389 samelen = strlen(matches[count]);
391 while (strncmp(matches[count], matches[count-1], samelen) != 0)
398 case 0: /* should never happen */
402 matches[0] = strdup(matches[1]);
405 matches[0] = strndup(matches[1], samelen);
407 matches[count] = NULL;
413 free(matches[count]);
420 static char **reg_complete_key(const char *text, int start, int end)
422 struct registry_key *base;
423 const char *subkeyname;
428 const char *base_n = "";
432 matches = malloc_array_p(char *, MAX_COMPLETIONS);
433 if (!matches) return NULL;
435 mem_ctx = talloc_init("completion");
440 for(i = 0; j < MAX_COMPLETIONS-1; i++) {
441 status = reg_key_get_subkey_by_index(mem_ctx, base, i,
442 &subkeyname, NULL, NULL);
443 if(W_ERROR_IS_OK(status)) {
444 if(!strncmp(text, subkeyname, len)) {
445 matches[j] = strdup(subkeyname);
449 samelen = strlen(matches[j]);
451 while (strncmp(matches[j], matches[j-1], samelen) != 0)
454 } else if(W_ERROR_EQUAL(status, WERR_NO_MORE_ITEMS)) {
457 printf("Error creating completion list: %s\n",
459 talloc_free(mem_ctx);
464 if (j == 1) { /* No matches at all */
466 talloc_free(mem_ctx);
470 if (j == 2) { /* Exact match */
471 asprintf(&matches[0], "%s%s", base_n, matches[1]);
473 asprintf(&matches[0], "%s%s", base_n,
474 talloc_strndup(mem_ctx, matches[1], samelen));
476 talloc_free(mem_ctx);
482 static char **reg_completion(const char *text, int start, int end)
484 smb_readline_ca_char(' ');
487 return reg_complete_command(text, start, end);
489 return reg_complete_key(text, start, end);
493 int main(int argc, char **argv)
496 const char *file = NULL;
498 const char *remote = NULL;
499 struct regshell_context *ctx;
501 struct poptOption long_options[] = {
503 {"file", 'F', POPT_ARG_STRING, &file, 0, "open hive file", NULL },
504 {"remote", 'R', POPT_ARG_STRING, &remote, 0, "connect to specified remote server", NULL},
506 POPT_COMMON_CREDENTIALS
511 pc = poptGetContext(argv[0], argc, (const char **) argv, long_options,0);
513 while((opt = poptGetNextOpt(pc)) != -1) {
516 ctx = talloc_zero(NULL, struct regshell_context);
518 if (remote != NULL) {
519 ctx->registry = reg_common_open_remote(remote, cmdline_lp_ctx,
520 cmdline_credentials);
521 } else if (file != NULL) {
522 ctx->current = reg_common_open_file(file, cmdline_lp_ctx, cmdline_credentials);
523 if (ctx->current == NULL)
525 ctx->registry = ctx->current->context;
526 ctx->path = talloc_strdup(ctx, "");
528 ctx->registry = reg_common_open_local(cmdline_credentials, cmdline_lp_ctx);
531 if (ctx->registry == NULL)
534 if (ctx->current == NULL) {
537 for (i = 0; reg_predefined_keys[i].handle; i++) {
539 err = reg_get_predefined_key(ctx->registry,
540 reg_predefined_keys[i].handle,
542 if (W_ERROR_IS_OK(err)) {
543 ctx->path = talloc_strdup(ctx,
544 reg_predefined_keys[i].name);
552 if (ctx->current == NULL) {
553 fprintf(stderr, "Unable to access any of the predefined keys\n");
562 asprintf(&prompt, "%s> ", ctx->path);
564 current_key = ctx->current; /* No way to pass a void * pointer
566 line = smb_readline(prompt, NULL, reg_completion);
573 if (line[0] != '\n') {
574 ret = W_ERROR_IS_OK(process_cmd(ctx, line));