docs: Avoid mentioning a possibly misleading option.
[Samba/bjacke.git] / source3 / utils / dbwrap_tool.c
blob79b40d24622c8f2220bc809142de0cc6b5abdf3d
1 /*
2 Samba Unix/Linux CIFS implementation
4 low level TDB/CTDB tool using the dbwrap interface
6 Copyright (C) 2009 Michael Adam <obnox@samba.org>
7 Copyright (C) 2011 Bjoern Baumbach <bb@sernet.de>
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include "includes.h"
24 #include "system/filesys.h"
25 #include "popt_common.h"
26 #include "dbwrap/dbwrap.h"
27 #include "dbwrap/dbwrap_open.h"
28 #include "dbwrap/dbwrap_watch.h"
29 #include "messages.h"
30 #include "util_tdb.h"
32 enum dbwrap_op { OP_FETCH, OP_STORE, OP_DELETE, OP_ERASE, OP_LISTKEYS,
33 OP_LISTWATCHERS, OP_EXISTS };
35 enum dbwrap_type { TYPE_INT32, TYPE_UINT32, TYPE_STRING, TYPE_HEX, TYPE_NONE };
37 static int dbwrap_tool_fetch_int32(struct db_context *db,
38 const char *keyname,
39 const char *data)
41 int32_t value;
42 NTSTATUS status;
44 status = dbwrap_fetch_int32_bystring(db, keyname, &value);
45 if (!NT_STATUS_IS_OK(status)) {
46 d_printf("Error fetching int32 from key '%s': %s\n",
47 keyname, nt_errstr(status));
48 return -1;
50 d_printf("%d\n", value);
52 return 0;
55 static int dbwrap_tool_fetch_uint32(struct db_context *db,
56 const char *keyname,
57 const char *data)
59 uint32_t value;
60 NTSTATUS ret;
62 ret = dbwrap_fetch_uint32_bystring(db, keyname, &value);
63 if (NT_STATUS_IS_OK(ret)) {
64 d_printf("%u\n", value);
65 return 0;
66 } else {
67 d_fprintf(stderr, "ERROR: could not fetch uint32 key '%s': "
68 "%s\n", nt_errstr(ret), keyname);
69 return -1;
73 static int dbwrap_tool_fetch_string(struct db_context *db,
74 const char *keyname,
75 const char *data)
77 TDB_DATA tdbdata;
78 NTSTATUS status;
79 TALLOC_CTX *tmp_ctx = talloc_stackframe();
80 int ret;
82 status = dbwrap_fetch_bystring(db, tmp_ctx, keyname, &tdbdata);
83 if (NT_STATUS_IS_OK(status)) {
84 d_printf("%-*.*s\n", (int)tdbdata.dsize, (int)tdbdata.dsize,
85 tdbdata.dptr);
86 ret = 0;
87 } else {
88 d_fprintf(stderr, "ERROR: could not fetch string key '%s': "
89 "%s\n", nt_errstr(status), keyname);
90 ret = -1;
93 talloc_free(tmp_ctx);
94 return ret;
97 static int dbwrap_tool_fetch_hex(struct db_context *db,
98 const char *keyname,
99 const char *data)
101 TDB_DATA tdbdata;
102 DATA_BLOB datablob;
103 NTSTATUS status;
104 TALLOC_CTX *tmp_ctx = talloc_stackframe();
105 char *hex_string;
106 int ret;
108 status = dbwrap_fetch_bystring(db, tmp_ctx, keyname, &tdbdata);
109 if (NT_STATUS_IS_OK(status)) {
110 datablob.data = tdbdata.dptr;
111 datablob.length = tdbdata.dsize;
113 hex_string = data_blob_hex_string_upper(tmp_ctx, &datablob);
114 if (hex_string == NULL) {
115 d_fprintf(stderr, "ERROR: could not get hex string "
116 "from data blob\n");
117 ret = -1;
118 } else {
119 d_printf("%s\n", hex_string);
120 ret = 0;
122 } else {
123 d_fprintf(stderr, "ERROR: could not fetch hex key '%s': "
124 "%s\n", nt_errstr(status), keyname);
125 ret = -1;
128 talloc_free(tmp_ctx);
129 return ret;
132 static int dbwrap_tool_store_int32(struct db_context *db,
133 const char *keyname,
134 const char *data)
136 NTSTATUS status;
137 int32_t value = (int32_t)strtol(data, NULL, 10);
139 if (dbwrap_is_persistent(db)) {
140 status = dbwrap_trans_store_int32_bystring(db, keyname, value);
141 } else {
142 status = dbwrap_store_int32_bystring(db, keyname, value);
144 if (!NT_STATUS_IS_OK(status)) {
145 d_fprintf(stderr, "ERROR: could not store int32 key '%s': %s\n",
146 keyname, nt_errstr(status));
147 return -1;
150 return 0;
153 static int dbwrap_tool_store_uint32(struct db_context *db,
154 const char *keyname,
155 const char *data)
157 NTSTATUS status;
158 uint32_t value = (uint32_t)strtol(data, NULL, 10);
160 if (dbwrap_is_persistent(db)) {
161 status = dbwrap_trans_store_uint32_bystring(db, keyname, value);
162 } else {
163 status = dbwrap_store_uint32_bystring(db, keyname, value);
165 if (!NT_STATUS_IS_OK(status)) {
166 d_fprintf(stderr,
167 "ERROR: could not store uint32 key '%s': %s\n",
168 keyname, nt_errstr(status));
169 return -1;
172 return 0;
175 static int dbwrap_tool_store_string(struct db_context *db,
176 const char *keyname,
177 const char *data)
179 NTSTATUS status;
180 TDB_DATA tdbdata;
182 tdbdata = string_term_tdb_data(data);
184 if (dbwrap_is_persistent(db)) {
185 status = dbwrap_trans_store_bystring(db, keyname,
186 tdbdata,
187 TDB_REPLACE);
188 } else {
189 status = dbwrap_store_bystring(db, keyname,
190 tdbdata,
191 TDB_REPLACE);
193 if (!NT_STATUS_IS_OK(status)) {
194 d_fprintf(stderr,
195 "ERROR: could not store string key '%s': %s\n",
196 keyname, nt_errstr(status));
197 return -1;
200 return 0;
203 static int dbwrap_tool_store_hex(struct db_context *db,
204 const char *keyname,
205 const char *data)
207 NTSTATUS status;
208 DATA_BLOB datablob;
209 TDB_DATA tdbdata;
210 TALLOC_CTX *tmp_ctx = talloc_stackframe();
212 datablob = strhex_to_data_blob(tmp_ctx, data);
213 if(strlen(data) > 0 && datablob.length == 0) {
214 d_fprintf(stderr,
215 "ERROR: could not convert hex string to data blob\n"
216 " Not a valid hex string?\n");
217 talloc_free(tmp_ctx);
218 return -1;
221 tdbdata.dptr = (unsigned char *)datablob.data;
222 tdbdata.dsize = datablob.length;
224 if (dbwrap_is_persistent(db)) {
225 status = dbwrap_trans_store_bystring(db, keyname,
226 tdbdata,
227 TDB_REPLACE);
228 } else {
229 status = dbwrap_store_bystring(db, keyname,
230 tdbdata,
231 TDB_REPLACE);
233 if (!NT_STATUS_IS_OK(status)) {
234 d_fprintf(stderr,
235 "ERROR: could not store string key '%s': %s\n",
236 keyname, nt_errstr(status));
237 talloc_free(tmp_ctx);
238 return -1;
241 talloc_free(tmp_ctx);
242 return 0;
245 static int dbwrap_tool_delete(struct db_context *db,
246 const char *keyname,
247 const char *data)
249 NTSTATUS status;
251 if (dbwrap_is_persistent(db)) {
252 status = dbwrap_trans_delete_bystring(db, keyname);
253 } else {
254 status = dbwrap_delete_bystring(db, keyname);
257 if (!NT_STATUS_IS_OK(status)) {
258 d_fprintf(stderr, "ERROR deleting record %s : %s\n",
259 keyname, nt_errstr(status));
260 return -1;
263 return 0;
266 static int dbwrap_tool_exists(struct db_context *db,
267 const char *keyname,
268 const char *data)
270 bool result;
272 result = dbwrap_exists(db, string_term_tdb_data(keyname));
274 if (result) {
275 d_fprintf(stdout, "Key %s exists\n", keyname);
276 } else {
277 d_fprintf(stdout, "Key %s does not exist\n", keyname);
280 return (result)?0:1;
284 static int delete_fn(struct db_record *rec, void *priv)
286 dbwrap_record_delete(rec);
287 return 0;
291 * dbwrap_tool_erase: erase the whole data base
292 * the keyname argument is not used.
294 static int dbwrap_tool_erase(struct db_context *db,
295 const char *keyname,
296 const char *data)
298 NTSTATUS status;
300 status = dbwrap_traverse(db, delete_fn, NULL, NULL);
302 if (!NT_STATUS_IS_OK(status)) {
303 d_fprintf(stderr, "ERROR erasing the database\n");
304 return -1;
307 return 0;
310 static int listkey_fn(struct db_record *rec, void *private_data)
312 int length = dbwrap_record_get_key(rec).dsize;
313 unsigned char *p = (unsigned char *)dbwrap_record_get_key(rec).dptr;
315 while (length--) {
316 if (isprint(*p) && !strchr("\"\\", *p)) {
317 d_printf("%c", *p);
318 } else {
319 d_printf("\\%02X", *p);
321 p++;
324 d_printf("\n");
326 return 0;
329 static int dbwrap_tool_listkeys(struct db_context *db,
330 const char *keyname,
331 const char *data)
333 NTSTATUS status;
335 status = dbwrap_traverse_read(db, listkey_fn, NULL, NULL);
337 if (!NT_STATUS_IS_OK(status)) {
338 d_fprintf(stderr, "ERROR listing db keys\n");
339 return -1;
342 return 0;
345 static int dbwrap_tool_listwatchers_cb(const uint8_t *db_id, size_t db_id_len,
346 const TDB_DATA key,
347 const struct server_id *watchers,
348 size_t num_watchers,
349 void *private_data)
351 uint32_t i;
352 dump_data_file(db_id, db_id_len, false, stdout);
353 dump_data_file(key.dptr, key.dsize, false, stdout);
355 for (i=0; i<num_watchers; i++) {
356 char *str = server_id_str(talloc_tos(), &watchers[i]);
357 printf("%s\n", str);
358 TALLOC_FREE(str);
360 printf("\n");
361 return 0;
365 static int dbwrap_tool_listwatchers(struct db_context *db,
366 const char *keyname,
367 const char *data)
369 dbwrap_watchers_traverse_read(dbwrap_tool_listwatchers_cb, NULL);
370 return 0;
373 struct dbwrap_op_dispatch_table {
374 enum dbwrap_op op;
375 enum dbwrap_type type;
376 int (*cmd)(struct db_context *db,
377 const char *keyname,
378 const char *data);
381 struct dbwrap_op_dispatch_table dispatch_table[] = {
382 { OP_FETCH, TYPE_INT32, dbwrap_tool_fetch_int32 },
383 { OP_FETCH, TYPE_UINT32, dbwrap_tool_fetch_uint32 },
384 { OP_FETCH, TYPE_STRING, dbwrap_tool_fetch_string },
385 { OP_FETCH, TYPE_HEX, dbwrap_tool_fetch_hex },
386 { OP_STORE, TYPE_INT32, dbwrap_tool_store_int32 },
387 { OP_STORE, TYPE_UINT32, dbwrap_tool_store_uint32 },
388 { OP_STORE, TYPE_STRING, dbwrap_tool_store_string },
389 { OP_STORE, TYPE_HEX, dbwrap_tool_store_hex },
390 { OP_DELETE, TYPE_INT32, dbwrap_tool_delete },
391 { OP_ERASE, TYPE_INT32, dbwrap_tool_erase },
392 { OP_LISTKEYS, TYPE_INT32, dbwrap_tool_listkeys },
393 { OP_LISTWATCHERS, TYPE_NONE, dbwrap_tool_listwatchers },
394 { OP_EXISTS, TYPE_STRING, dbwrap_tool_exists },
395 { 0, 0, NULL },
398 int main(int argc, const char **argv)
400 struct tevent_context *evt_ctx;
401 struct messaging_context *msg_ctx;
402 struct db_context *db;
404 uint16_t count;
406 const char *dbname;
407 const char *opname;
408 enum dbwrap_op op;
409 const char *keyname = "";
410 const char *keytype = "int32";
411 enum dbwrap_type type;
412 const char *valuestr = "0";
413 int persistent = 0;
414 int tdb_flags = TDB_DEFAULT;
416 TALLOC_CTX *mem_ctx = talloc_stackframe();
418 int ret = 1;
420 struct poptOption popt_options[] = {
421 POPT_AUTOHELP
422 POPT_COMMON_SAMBA
423 { "persistent", 'p', POPT_ARG_NONE, &persistent, 0, "treat the database as persistent", NULL },
424 POPT_TABLEEND
426 int opt;
427 const char **extra_argv;
428 int extra_argc = 0;
429 poptContext pc;
431 load_case_tables();
432 lp_set_cmdline("log level", "0");
433 setup_logging(argv[0], DEBUG_STDERR);
435 pc = poptGetContext(argv[0], argc, argv, popt_options, POPT_CONTEXT_KEEP_FIRST);
437 while ((opt = poptGetNextOpt(pc)) != -1) {
438 switch (opt) {
439 default:
440 fprintf(stderr, "Invalid option %s: %s\n",
441 poptBadOption(pc, 0), poptStrerror(opt));
442 goto done;
446 /* setup the remaining options for the main program to use */
447 extra_argv = poptGetArgs(pc);
448 if (extra_argv) {
449 extra_argv++;
450 while (extra_argv[extra_argc]) extra_argc++;
453 lp_load_global(get_dyn_CONFIGFILE());
455 if ((extra_argc < 2) || (extra_argc > 5)) {
456 d_fprintf(stderr,
457 "USAGE: %s [options] <database> <op> [<key> [<type> "
458 "[<value>]]]\n"
459 " ops: fetch, store, delete, exists, "
460 "erase, listkeys, listwatchers\n"
461 " types: int32, uint32, string, hex\n",
462 argv[0]);
463 goto done;
466 dbname = extra_argv[0];
467 opname = extra_argv[1];
469 if (strcmp(opname, "store") == 0) {
470 if (extra_argc != 5) {
471 d_fprintf(stderr, "ERROR: operation 'store' requires "
472 "value argument\n");
473 goto done;
475 valuestr = extra_argv[4];
476 keytype = extra_argv[3];
477 keyname = extra_argv[2];
478 op = OP_STORE;
479 } else if (strcmp(opname, "fetch") == 0) {
480 if (extra_argc != 4) {
481 d_fprintf(stderr, "ERROR: operation 'fetch' requires "
482 "type but not value argument\n");
483 goto done;
485 op = OP_FETCH;
486 keytype = extra_argv[3];
487 keyname = extra_argv[2];
488 } else if (strcmp(opname, "delete") == 0) {
489 if (extra_argc != 3) {
490 d_fprintf(stderr, "ERROR: operation 'delete' does "
491 "not allow type nor value argument\n");
492 goto done;
494 keyname = extra_argv[2];
495 op = OP_DELETE;
496 } else if (strcmp(opname, "erase") == 0) {
497 if (extra_argc != 2) {
498 d_fprintf(stderr, "ERROR: operation 'erase' does "
499 "not take a key argument\n");
500 goto done;
502 op = OP_ERASE;
503 } else if (strcmp(opname, "listkeys") == 0) {
504 if (extra_argc != 2) {
505 d_fprintf(stderr, "ERROR: operation 'listkeys' does "
506 "not take a key argument\n");
507 goto done;
509 op = OP_LISTKEYS;
510 } else if (strcmp(opname, "listwatchers") == 0) {
511 if (extra_argc != 2) {
512 d_fprintf(stderr, "ERROR: operation 'listwatchers' "
513 "does not take an argument\n");
514 goto done;
516 op = OP_LISTWATCHERS;
517 keytype = "none";
518 } else if (strcmp(opname, "exists") == 0) {
519 if (extra_argc != 3) {
520 d_fprintf(stderr, "ERROR: operation 'exists' does "
521 "not allow type nor value argument\n");
522 goto done;
524 keyname = extra_argv[2];
525 op = OP_EXISTS;
526 keytype = "string";
527 } else {
528 d_fprintf(stderr,
529 "ERROR: invalid op '%s' specified\n"
530 " supported ops: fetch, store, delete, exists, "
531 "erase, listkeys, listwatchers\n",
532 opname);
533 goto done;
536 if (strcmp(keytype, "int32") == 0) {
537 type = TYPE_INT32;
538 } else if (strcmp(keytype, "uint32") == 0) {
539 type = TYPE_UINT32;
540 } else if (strcmp(keytype, "string") == 0) {
541 type = TYPE_STRING;
542 } else if (strcmp(keytype, "hex") == 0) {
543 type = TYPE_HEX;
544 } else if (strcmp(keytype, "none") == 0) {
545 type = TYPE_NONE;
546 } else {
547 d_fprintf(stderr, "ERROR: invalid type '%s' specified.\n"
548 " supported types: int32, uint32, "
549 "string, hex, none\n",
550 keytype);
551 goto done;
554 evt_ctx = samba_tevent_context_init(mem_ctx);
555 if (evt_ctx == NULL) {
556 d_fprintf(stderr, "ERROR: could not init event context\n");
557 goto done;
560 msg_ctx = messaging_init(mem_ctx, evt_ctx);
561 if (msg_ctx == NULL) {
562 d_fprintf(stderr, "ERROR: could not init messaging context\n");
563 goto done;
566 if (persistent == 0) {
567 tdb_flags |= TDB_CLEAR_IF_FIRST;
570 switch (op) {
571 case OP_FETCH:
572 case OP_STORE:
573 case OP_DELETE:
574 case OP_ERASE:
575 case OP_LISTKEYS:
576 case OP_EXISTS:
577 db = db_open(mem_ctx, dbname, 0, tdb_flags, O_RDWR | O_CREAT,
578 0644, DBWRAP_LOCK_ORDER_1);
579 if (db == NULL) {
580 d_fprintf(stderr, "ERROR: could not open dbname\n");
581 goto done;
583 break;
584 default:
585 db = NULL;
586 break;
589 for (count = 0; dispatch_table[count].cmd != NULL; count++) {
590 if ((op == dispatch_table[count].op) &&
591 (type == dispatch_table[count].type))
593 ret = dispatch_table[count].cmd(db, keyname, valuestr);
594 break;
598 done:
599 TALLOC_FREE(mem_ctx);
600 return ret;