/*- * See the file LICENSE for redistribution information. * * Copyright (c) 1996,2007 Oracle. All rights reserved. * * $Id: db_dump.c,v 12.15 2007/05/17 15:14:59 bostic Exp $ */ #include "db_config.h" #include "db_int.h" #include "dbinc/db_page.h" #include "dbinc/db_am.h" #ifndef lint static const char copyright[] = "Copyright (c) 1996,2007 Oracle. All rights reserved.\n"; #endif int db_dump_db_init __P((DB_ENV *, char *, int, u_int32_t, int *)); int db_dump_dump_sub __P((DB_ENV *, DB *, char *, int, int)); int db_dump_main __P((int, char *[])); int db_dump_show_subs __P((DB *)); int db_dump_usage __P((void)); int db_dump_version_check __P((void)); const char *progname; int db_dump(args) char *args; { int argc; char **argv; __db_util_arg("db_dump", args, &argc, &argv); return (db_dump_main(argc, argv) ? EXIT_FAILURE : EXIT_SUCCESS); } #include #define ERROR_RETURN ERROR int db_dump_main(argc, argv) int argc; char *argv[]; { extern char *optarg; extern int optind, __db_getopt_reset; DB_ENV *dbenv; DB *dbp; u_int32_t cache; int ch; int exitval, keyflag, lflag, nflag, pflag, private; int ret, Rflag, rflag, resize; char *dopt, *home, *passwd, *subname; if ((progname = __db_rpath(argv[0])) == NULL) progname = argv[0]; else ++progname; if ((ret = db_dump_version_check()) != 0) return (ret); dbenv = NULL; dbp = NULL; exitval = lflag = nflag = pflag = rflag = Rflag = 0; keyflag = 0; cache = MEGABYTE; private = 0; dopt = home = passwd = subname = NULL; __db_getopt_reset = 1; while ((ch = getopt(argc, argv, "d:f:h:klNpP:rRs:V")) != EOF) switch (ch) { case 'd': dopt = optarg; break; case 'f': if (freopen(optarg, "w", stdout) == NULL) { fprintf(stderr, "%s: %s: reopen: %s\n", progname, optarg, strerror(errno)); return (EXIT_FAILURE); } break; case 'h': home = optarg; break; case 'k': keyflag = 1; break; case 'l': lflag = 1; break; case 'N': nflag = 1; break; case 'P': passwd = strdup(optarg); memset(optarg, 0, strlen(optarg)); if (passwd == NULL) { fprintf(stderr, "%s: strdup: %s\n", progname, strerror(errno)); return (EXIT_FAILURE); } break; case 'p': pflag = 1; break; case 's': subname = optarg; break; case 'R': Rflag = 1; /* DB_AGGRESSIVE requires DB_SALVAGE */ /* FALLTHROUGH */ case 'r': rflag = 1; break; case 'V': printf("%s\n", db_version(NULL, NULL, NULL)); return (EXIT_SUCCESS); case '?': default: return (db_dump_usage()); } argc -= optind; argv += optind; if (argc != 1) return (db_dump_usage()); if (dopt != NULL && pflag) { fprintf(stderr, "%s: the -d and -p options may not both be specified\n", progname); return (EXIT_FAILURE); } if (lflag && subname != NULL) { fprintf(stderr, "%s: the -l and -s options may not both be specified\n", progname); return (EXIT_FAILURE); } if (keyflag && rflag) { fprintf(stderr, "%s: %s", "the -k and -r or -R options may not both be specified\n", progname); return (EXIT_FAILURE); } if (subname != NULL && rflag) { fprintf(stderr, "%s: %s", "the -s and -r or R options may not both be specified\n", progname); return (EXIT_FAILURE); } /* Handle possible interruptions. */ __db_util_siginit(); /* * Create an environment object and initialize it for error * reporting. */ retry: if ((ret = db_env_create(&dbenv, 0)) != 0) { fprintf(stderr, "%s: db_env_create: %s\n", progname, db_strerror(ret)); goto err; } dbenv->set_errfile(dbenv, stderr); dbenv->set_errpfx(dbenv, progname); if (nflag) { if ((ret = dbenv->set_flags(dbenv, DB_NOLOCKING, 1)) != 0) { dbenv->err(dbenv, ret, "set_flags: DB_NOLOCKING"); goto err; } if ((ret = dbenv->set_flags(dbenv, DB_NOPANIC, 1)) != 0) { dbenv->err(dbenv, ret, "set_flags: DB_NOPANIC"); goto err; } } if (passwd != NULL && (ret = dbenv->set_encrypt(dbenv, passwd, DB_ENCRYPT_AES)) != 0) { dbenv->err(dbenv, ret, "set_passwd"); goto err; } /* Initialize the environment. */ if (db_dump_db_init(dbenv, home, rflag, cache, &private) != 0) goto err; /* Create the DB object and open the file. */ if ((ret = db_create(&dbp, dbenv, 0)) != 0) { dbenv->err(dbenv, ret, "db_create"); goto err; } /* * If we're salvaging, don't do an open; it might not be safe. * Dispatch now into the salvager. */ if (rflag) { /* The verify method is a destructor. */ ret = dbp->verify(dbp, argv[0], NULL, stdout, DB_SALVAGE | (Rflag ? DB_AGGRESSIVE : 0) | (pflag ? DB_PRINTABLE : 0)); dbp = NULL; if (ret != 0) goto err; goto done; } if ((ret = dbp->open(dbp, NULL, argv[0], subname, DB_UNKNOWN, DB_RDONLY, 0)) != 0) { dbp->err(dbp, ret, "open: %s", argv[0]); goto err; } if (private != 0) { if ((ret = __db_util_cache(dbp, &cache, &resize)) != 0) goto err; if (resize) { (void)dbp->close(dbp, 0); dbp = NULL; (void)dbenv->close(dbenv, 0); dbenv = NULL; goto retry; } } if (dopt != NULL) { if ((ret = __db_dumptree(dbp, NULL, dopt, NULL)) != 0) { dbp->err(dbp, ret, "__db_dumptree: %s", argv[0]); goto err; } } else if (lflag) { if (dbp->get_multiple(dbp)) { if (db_dump_show_subs(dbp)) goto err; } else { dbp->errx(dbp, "%s: does not contain multiple databases", argv[0]); goto err; } } else { if (subname == NULL && dbp->get_multiple(dbp)) { if (db_dump_dump_sub(dbenv, dbp, argv[0], pflag, keyflag)) goto err; } else if (dbp->dump(dbp, NULL, __db_pr_callback, stdout, pflag, keyflag)) goto err; } if (0) { err: exitval = 1; } done: if (dbp != NULL && (ret = dbp->close(dbp, 0)) != 0) { exitval = 1; dbenv->err(dbenv, ret, "close"); } if (dbenv != NULL && (ret = dbenv->close(dbenv, 0)) != 0) { exitval = 1; fprintf(stderr, "%s: dbenv->close: %s\n", progname, db_strerror(ret)); } if (passwd != NULL) free(passwd); /* Resend any caught signal. */ __db_util_sigresend(); return (exitval == 0 ? EXIT_SUCCESS : EXIT_FAILURE); } /* * db_init -- * Initialize the environment. */ int db_dump_db_init(dbenv, home, is_salvage, cache, is_privatep) DB_ENV *dbenv; char *home; int is_salvage; u_int32_t cache; int *is_privatep; { int ret; /* * Try and use the underlying environment when opening a database. * We wish to use the buffer pool so our information is as up-to-date * as possible, even if the mpool cache hasn't been flushed. * * If we are not doing a salvage, we want to join the environment; * if a locking system is present, this will let us use it and be * safe to run concurrently with other threads of control. (We never * need to use transactions explicitly, as we're read-only.) Note * that in CDB, too, this will configure our environment * appropriately, and our cursors will (correctly) do locking as CDB * read cursors. * * If we are doing a salvage, the verification code will protest * if we initialize transactions, logging, or locking; do an * explicit DB_INIT_MPOOL to try to join any existing environment * before we create our own. */ *is_privatep = 0; if ((ret = dbenv->open(dbenv, home, DB_USE_ENVIRON | (is_salvage ? DB_INIT_MPOOL : 0), 0)) == 0) return (0); if (ret == DB_VERSION_MISMATCH) goto err; /* * An environment is required because we may be trying to look at * databases in directories other than the current one. We could * avoid using an environment iff the -h option wasn't specified, * but that seems like more work than it's worth. * * No environment exists (or, at least no environment that includes * an mpool region exists). Create one, but make it private so that * no files are actually created. */ *is_privatep = 1; if ((ret = dbenv->set_cachesize(dbenv, 0, cache, 1)) == 0 && (ret = dbenv->open(dbenv, home, DB_CREATE | DB_INIT_MPOOL | DB_PRIVATE | DB_USE_ENVIRON, 0)) == 0) return (0); /* An environment is required. */ err: dbenv->err(dbenv, ret, "DB_ENV->open"); return (1); } /* * dump_sub -- * Dump out the records for a DB containing subdatabases. */ int db_dump_dump_sub(dbenv, parent_dbp, parent_name, pflag, keyflag) DB_ENV *dbenv; DB *parent_dbp; char *parent_name; int pflag, keyflag; { DB *dbp; DBC *dbcp; DBT key, data; int ret; char *subdb; /* * Get a cursor and step through the database, dumping out each * subdatabase. */ if ((ret = parent_dbp->cursor(parent_dbp, NULL, &dbcp, 0)) != 0) { dbenv->err(dbenv, ret, "DB->cursor"); return (1); } memset(&key, 0, sizeof(key)); memset(&data, 0, sizeof(data)); while ((ret = dbcp->get(dbcp, &key, &data, DB_IGNORE_LEASE | DB_NEXT)) == 0) { /* Nul terminate the subdatabase name. */ if ((subdb = malloc(key.size + 1)) == NULL) { dbenv->err(dbenv, ENOMEM, NULL); return (1); } memcpy(subdb, key.data, key.size); subdb[key.size] = '\0'; /* Create the DB object and open the file. */ if ((ret = db_create(&dbp, dbenv, 0)) != 0) { dbenv->err(dbenv, ret, "db_create"); free(subdb); return (1); } if ((ret = dbp->open(dbp, NULL, parent_name, subdb, DB_UNKNOWN, DB_RDONLY, 0)) != 0) dbp->err(dbp, ret, "DB->open: %s:%s", parent_name, subdb); if (ret == 0 && dbp->dump( dbp, subdb, __db_pr_callback, stdout, pflag, keyflag)) ret = 1; (void)dbp->close(dbp, 0); free(subdb); if (ret != 0) return (1); } if (ret != DB_NOTFOUND) { parent_dbp->err(parent_dbp, ret, "DBcursor->get"); return (1); } if ((ret = dbcp->close(dbcp)) != 0) { parent_dbp->err(parent_dbp, ret, "DBcursor->close"); return (1); } return (0); } /* * show_subs -- * Display the subdatabases for a database. */ int db_dump_show_subs(dbp) DB *dbp; { DBC *dbcp; DBT key, data; int ret; /* * Get a cursor and step through the database, printing out the key * of each key/data pair. */ if ((ret = dbp->cursor(dbp, NULL, &dbcp, 0)) != 0) { dbp->err(dbp, ret, "DB->cursor"); return (1); } memset(&key, 0, sizeof(key)); memset(&data, 0, sizeof(data)); while ((ret = dbcp->get(dbcp, &key, &data, DB_IGNORE_LEASE | DB_NEXT)) == 0) { if ((ret = dbp->dbenv->prdbt( &key, 1, NULL, stdout, __db_pr_callback, 0)) != 0) { dbp->errx(dbp, NULL); return (1); } } if (ret != DB_NOTFOUND) { dbp->err(dbp, ret, "DBcursor->get"); return (1); } if ((ret = dbcp->close(dbcp)) != 0) { dbp->err(dbp, ret, "DBcursor->close"); return (1); } return (0); } /* * usage -- * Display the usage message. */ int db_dump_usage() { (void)fprintf(stderr, "usage: %s [-klNprRV]\n\t%s\n", progname, "[-d ahr] [-f output] [-h home] [-P password] [-s database] db_file"); return (EXIT_FAILURE); } int db_dump_version_check() { int v_major, v_minor, v_patch; /* Make sure we're loaded with the right version of the DB library. */ (void)db_version(&v_major, &v_minor, &v_patch); if (v_major != DB_VERSION_MAJOR || v_minor != DB_VERSION_MINOR) { fprintf(stderr, "%s: version %d.%d doesn't match library version %d.%d\n", progname, DB_VERSION_MAJOR, DB_VERSION_MINOR, v_major, v_minor); return (EXIT_FAILURE); } return (0); }