libdb/util/db_hotbackup.c

1159 lines
31 KiB
C
Raw Normal View History

/*-
* See the file LICENSE for redistribution information.
*
* Copyright (c) 1996, 2011 Oracle and/or its affiliates. All rights reserved.
*
* $Id$
*/
#include "db_config.h"
#include "db_int.h"
#include "dbinc/log.h"
#include "dbinc/db_page.h"
#include "dbinc/qam.h"
#include "dbinc/partition.h"
#ifndef lint
static const char copyright[] =
"Copyright (c) 1996, 2011 Oracle and/or its affiliates. All rights reserved.\n";
#endif
enum which_open { OPEN_ORIGINAL, OPEN_HOT_BACKUP };
int backup_dir_clean __P((DB_ENV *, char *, char *, int *, int, int));
int data_copy __P((DB_ENV *, char *, char *, char *, int, int));
int env_data_copy __P((DB_ENV *, char *, char *, int, const char *));
int env_init __P((DB_ENV **,
char *, char **, char ***, char *, enum which_open, int));
int main __P((int, char *[]));
int read_log_dir __P((DB_ENV *, char *, int, char *, char *, int *, int, int));
int read_data_dir __P((DB_ENV *,
char *, char *, char *, int, int, int, int, const char *));
void save_error __P((const DB_ENV *, const char *, const char *));
int usage __P((void));
int version_check __P((void));
const char *progname;
/*
* For backporting.
*/
#if (DB_VERSION_MAJOR < 5 || (DB_VERSION_MAJOR == 5 && DB_VERSION_MINOR < 2))
#define DB_STR_A(code, string, fmt) string
#define PART_PREFIX "__dbp."
#ifndef DB_WIN32
#include "db_copy.c"
#endif
#endif
int
main(argc, argv)
int argc;
char *argv[];
{
extern char *optarg;
extern int optind;
time_t now;
DB_ENV *dbenv;
u_int data_cnt, data_next;
int ch, checkpoint, copy_min, db_config, debug, env_copy, exitval;
int remove_max, ret, update, verbose, hotbackup_flag_set, relative;
char *backup_dir, **data_dir, **dir, *home, *log_dir, *passwd;
char home_buf[DB_MAXPATHLEN], time_buf[CTIME_BUFLEN];
u_int32_t flags;
/*
* Make sure all verbose message are output before any error messages
* in the case where the output is being logged into a file. This
* call has to be done before any operation is performed on the stream.
*
* Use unbuffered I/O because line-buffered I/O requires a buffer, and
* some operating systems have buffer alignment and size constraints we
* don't want to care about. There isn't enough output for the calls
* to matter.
*/
setbuf(stdout, NULL);
if ((progname = __db_rpath(argv[0])) == NULL)
progname = argv[0];
else
++progname;
if ((ret = version_check()) != 0)
return (ret);
/* We default to the safe environment copy. */
env_copy = 1;
checkpoint = db_config = data_cnt = data_next = debug =
exitval = update = verbose = hotbackup_flag_set = 0;
data_dir = NULL;
backup_dir = home = passwd = NULL;
log_dir = NULL;
copy_min = remove_max = 0;
while ((ch = getopt(argc, argv, "b:cDd:Fgh:l:P:uVv")) != EOF)
switch (ch) {
case 'b':
backup_dir = optarg;
break;
case 'c':
checkpoint = 1;
break;
case 'D':
db_config = 1;
break;
case 'd':
/*
* User can specify a list of directories -- keep an
* array, leaving room for the trailing NULL.
*/
if (data_dir == NULL || data_next >= data_cnt - 2) {
data_cnt = data_cnt == 0 ? 20 : data_cnt * 2;
if ((data_dir = realloc(data_dir,
data_cnt * sizeof(*data_dir))) == NULL) {
fprintf(stderr, "%s: %s\n",
progname, strerror(errno));
return (EXIT_FAILURE);
}
}
data_dir[data_next++] = optarg;
break;
case 'F':
/* The default is to use environment copy. */
env_copy = 0;
break;
case 'g':
debug = 1;
break;
case 'h':
home = optarg;
break;
case 'l':
log_dir = optarg;
break;
case 'P':
passwd = strdup(optarg);
memset(optarg, 0, strlen(optarg));
if (passwd == NULL) {
fprintf(stderr, DB_STR_A("5026",
"%s: strdup: %s\n", "%s %s\n"),
progname, strerror(errno));
return (EXIT_FAILURE);
}
break;
case 'u':
update = 1;
break;
case 'V':
printf("%s\n", db_version(NULL, NULL, NULL));
return (EXIT_SUCCESS);
case 'v':
verbose = 1;
break;
case '?':
default:
return (usage());
}
argc -= optind;
argv += optind;
if (argc != 0)
return (usage());
/* NULL-terminate any list of data directories. */
if (data_dir != NULL) {
data_dir[data_next] = NULL;
/*
* -d is relative to the current directory, to run a checkpoint
* we must have directories relative to the environment.
*/
if (checkpoint == 1) {
fprintf(stderr, DB_STR_A("5027",
"%s: cannot specify -d and -c\n", "%s\n"),
progname);
return (usage());
}
}
if (db_config && (data_dir != NULL || log_dir != NULL)) {
fprintf(stderr, DB_STR_A("5028",
"%s: cannot specify -D and -d or -l\n", "%s\n"), progname);
return (usage());
}
/* Handle possible interruptions. */
__db_util_siginit();
/*
* The home directory defaults to the environment variable DB_HOME.
* The log directory defaults to the home directory.
*
* We require a source database environment directory and a target
* backup directory.
*/
if (home == NULL) {
home = home_buf;
if ((ret = __os_getenv(
NULL, "DB_HOME", &home, sizeof(home_buf))) != 0) {
fprintf(stderr, DB_STR_A("5029",
"%s failed to get environment variable DB_HOME: %s\n",
"%s %s\n"), progname, db_strerror(ret));
return (EXIT_FAILURE);
}
/*
* home set to NULL if __os_getenv failed to find DB_HOME.
*/
}
if (home == NULL) {
fprintf(stderr, DB_STR_A("5030",
"%s: no source database environment specified\n",
"%s\n"), progname);
return (usage());
}
if (backup_dir == NULL) {
fprintf(stderr, DB_STR_A("5031",
"%s: no target backup directory specified\n", "%s\n"),
progname);
return (usage());
}
if (verbose) {
(void)time(&now);
printf(DB_STR_A("5032", "%s: hot backup started at %s",
"%s %s"), progname, __os_ctime(&now, time_buf));
}
/* Open the source environment. */
if (env_init(&dbenv, home,
(db_config || log_dir != NULL) ? &log_dir : NULL,
db_config ? &data_dir : NULL,
passwd, OPEN_ORIGINAL, verbose) != 0)
goto err;
if (env_copy) {
if ((ret = dbenv->get_open_flags(dbenv, &flags)) != 0)
goto err;
if (flags & DB_PRIVATE) {
fprintf(stderr, DB_STR_A("5129",
"%s: Cannot copy data from a PRIVATE environment\n",
"%s"), progname);
goto err;
}
}
if (log_dir != NULL) {
if (db_config && __os_abspath(log_dir)) {
fprintf(stderr, DB_STR_A("5033",
"%s: DB_CONFIG must not contain an absolute "
"path for the log directory\n", "%s\n"), progname);
goto err;
}
}
#if (DB_VERSION_MAJOR > 5 || (DB_VERSION_MAJOR == 5 && DB_VERSION_MINOR > 0))
/*
* Record in the environment that a hot backup is in progress.
* This disables the bulk loading optimization for the
* duration of the backup. This increments a persistent
* counter in the database's environment, so it is essential
* that the corresponding decrement takes place upon
* completion of the backup.
*/
if ((ret = dbenv->set_flags(dbenv, DB_HOTBACKUP_IN_PROGRESS, 1))) {
fprintf(stderr, DB_STR_A("5034",
"%s: dbenv->set_flags(DB_HOTBACKUP_IN_PROGRESS, 1): %s\n",
"%s %s\n"), progname, db_strerror(ret));
goto err;
}
hotbackup_flag_set = 1;
#endif
/*
* If the -c option is specified, checkpoint the source home
* database environment, and remove any unnecessary log files.
*/
if (checkpoint) {
if (verbose)
printf(DB_STR_A("5035", "%s: %s: force checkpoint\n",
"%s %s\n"), progname, home);
if ((ret =
dbenv->txn_checkpoint(dbenv, 0, 0, DB_FORCE)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->txn_checkpoint");
goto err;
}
if (!update) {
if (verbose)
printf(DB_STR_A("5036",
"%s: %s: remove unnecessary log files\n",
"%s %s\n"), progname, home);
if ((ret = dbenv->log_archive(dbenv,
NULL, DB_ARCH_REMOVE)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->log_archive");
goto err;
}
}
}
/*
* If the target directory for the backup does not exist, create it
* with mode read-write-execute for the owner. Ignore errors here,
* it's simpler and more portable to just always try the create. If
* there's a problem, we'll fail with reasonable errors later.
*/
(void)__os_mkdir(NULL, backup_dir, DB_MODE_700);
/*
* If -u was specified, remove all log files; if -u was not specified,
* remove all files.
*
* Potentially there are two directories to clean, the log directory
* and the target directory. First, clean up the log directory if
* it's different from the target directory, then clean up the target
* directory.
*/
if (db_config && log_dir != NULL &&
backup_dir_clean(
dbenv, backup_dir, log_dir, &remove_max, update, verbose) != 0)
goto err;
if (backup_dir_clean(dbenv,
backup_dir, NULL, &remove_max, update, verbose) != 0)
goto err;
/*
* If the -u option was not specified, copy all database files found in
* the database environment home directory, or any directory specified
* using the -d option, into the target directory for the backup.
*/
if (!update) {
if (read_data_dir(dbenv, home, backup_dir,
home, verbose, db_config, env_copy, 0, passwd) != 0)
goto err;
/*
* Use a DB_CONFIG if it exists and neither -D/-d was set.
*/
relative = 0;
if (!db_config && data_dir == NULL) {
(void)dbenv->get_data_dirs(
dbenv, (const char ***)&data_dir);
relative = 1;
}
if (data_dir != NULL)
for (dir = data_dir; *dir != NULL; ++dir) {
/*
* Don't allow absolute path names taken from
* the DB_CONFIG file -- running recovery with
* them would corrupt the source files.
*/
if (db_config && __os_abspath(*dir)) {
fprintf(stderr, DB_STR_A("5037",
"%s: data directory '%s' is absolute path, not permitted with -D option\n",
"%s %s\n"), progname, *dir);
goto err;
}
if (read_data_dir(dbenv, home, backup_dir,
*dir, verbose, db_config,
env_copy, relative, passwd) != 0)
goto err;
}
}
/*
* Copy all log files found in the directory specified by the -l option
* (or in the database environment home directory, if no -l option was
* specified), into the target directory for the backup.
*
* The log directory defaults to the home directory.
*/
if (read_log_dir(dbenv, home, db_config, backup_dir,
log_dir, &copy_min, update, verbose) != 0)
goto err;
/*
* If we're updating a snapshot, the lowest-numbered log file copied
* into the backup directory should be less than, or equal to, the
* highest-numbered log file removed from the backup directory during
* cleanup.
*/
if (update && remove_max < copy_min &&
!(remove_max == 0 && copy_min == 1)) {
fprintf(stderr, DB_STR_A("5038",
"%s: the largest log file removed (%d) must be greater\n",
"%s %d\n"), progname, remove_max);
fprintf(stderr, DB_STR_A("5039",
"%s: than or equal the smallest log file copied (%d)\n",
"%s %d\n"), progname, copy_min);
goto err;
}
#if (DB_VERSION_MAJOR > 5 || (DB_VERSION_MAJOR == 5 && DB_VERSION_MINOR > 0))
/* Turn off the hotbackup flag in the environment now. */
if ((ret = dbenv->set_flags(dbenv, DB_HOTBACKUP_IN_PROGRESS, 0))) {
fprintf(stderr,
"%s: dbenv->set_flags(DB_HOTBACKUP_IN_PROGRESS, 0): %s\n",
progname, db_strerror(ret));
goto err;
}
hotbackup_flag_set = 0;
#endif
/* Close the source environment. */
if ((ret = dbenv->close(dbenv, 0)) != 0) {
fprintf(stderr,
"%s: dbenv->close: %s\n", progname, db_strerror(ret));
dbenv = NULL;
goto err;
}
/* Perform catastrophic recovery on the hot backup. */
if (verbose)
printf(DB_STR_A("5040", "%s: %s: run catastrophic recovery\n",
"%s %s\n"), progname, backup_dir);
if (env_init(&dbenv,
backup_dir, NULL, NULL, passwd, OPEN_HOT_BACKUP, verbose) != 0)
goto err;
/*
* Remove any unnecessary log files from the hot backup.
* For debugging purposes, leave them around.
*/
if (debug == 0) {
if (verbose)
printf(DB_STR_A("5041",
"%s: %s: remove unnecessary log files\n",
"%s %s\n"), progname, backup_dir);
if ((ret =
dbenv->log_archive(dbenv, NULL, DB_ARCH_REMOVE)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->log_archive");
goto err;
}
}
if (0) {
err: exitval = 1;
}
#if (DB_VERSION_MAJOR > 5 || (DB_VERSION_MAJOR == 5 && DB_VERSION_MINOR > 0))
if (hotbackup_flag_set &&
(ret = dbenv->set_flags(dbenv, DB_HOTBACKUP_IN_PROGRESS, 0))) {
exitval = 1;
fprintf(stderr,
"%s: dbenv->set_flags(DB_HOTBACKUP_IN_PROGRESS, 0): %s\n",
progname, db_strerror(ret));
}
#endif
if (dbenv != NULL && (ret = dbenv->close(dbenv, 0)) != 0) {
exitval = 1;
fprintf(stderr,
"%s: dbenv->close: %s\n", progname, db_strerror(ret));
}
if (exitval == 0) {
if (verbose) {
(void)time(&now);
printf(DB_STR_A("5042",
"%s: hot backup completed at %s",
"%s %s"), progname, __os_ctime(&now, time_buf));
}
} else {
fprintf(stderr, DB_STR_A("5043", "%s: HOT BACKUP FAILED!\n",
"%s\n"), progname);
}
/* Resend any caught signal. */
__db_util_sigresend();
return (exitval == 0 ? EXIT_SUCCESS : EXIT_FAILURE);
}
/*
* env_init --
* Open a database environment.
*/
int
env_init(dbenvp, home, log_dirp, data_dirp, passwd, which, verbose)
DB_ENV **dbenvp;
char *home, **log_dirp, ***data_dirp, *passwd;
enum which_open which;
int verbose;
{
DB_ENV *dbenv;
int ret;
*dbenvp = NULL;
/*
* Create an environment object and initialize it for error reporting.
*/
if ((ret = db_env_create(&dbenv, 0)) != 0) {
fprintf(stderr,
"%s: db_env_create: %s\n", progname, db_strerror(ret));
return (1);
}
dbenv->set_errfile(dbenv, stderr);
setbuf(stderr, NULL);
dbenv->set_errpfx(dbenv, progname);
/* Any created intermediate directories are created private. */
if ((ret = dbenv->set_intermediate_dir_mode(dbenv, "rwx------")) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->set_intermediate_dir_mode");
return (1);
}
/*
* If a log directory has been specified, and it's not the same as the
* home directory, set it for the environment.
*/
if (log_dirp != NULL && *log_dirp != NULL &&
(ret = dbenv->set_lg_dir(dbenv, *log_dirp)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->set_lg_dir: %s", *log_dirp);
return (1);
}
/* Optionally set the password. */
if (passwd != NULL &&
(ret = dbenv->set_encrypt(dbenv, passwd, DB_ENCRYPT_AES)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->set_encrypt");
return (1);
}
switch (which) {
case OPEN_ORIGINAL:
/*
* Opening the database environment we're trying to back up.
* We try to attach to a pre-existing environment; if that
* fails, we create a private environment and try again.
*/
if ((ret = dbenv->open(dbenv, home, DB_USE_ENVIRON, 0)) != 0 &&
(ret == DB_VERSION_MISMATCH ||
(ret = dbenv->open(dbenv, home, DB_CREATE |
DB_INIT_LOG | DB_INIT_TXN | DB_PRIVATE | DB_USE_ENVIRON,
0)) != 0)) {
dbenv->err(dbenv, ret, "DB_ENV->open: %s", home);
return (1);
}
if (log_dirp != NULL && *log_dirp == NULL)
(void)dbenv->get_lg_dir(dbenv, (const char **)log_dirp);
if (data_dirp != NULL && *data_dirp == NULL)
(void)dbenv->get_data_dirs(
dbenv, (const char ***)data_dirp);
break;
case OPEN_HOT_BACKUP:
/*
* Opening the backup copy of the database environment. We
* better be the only user, we're running recovery.
* Ensure that there at least minimal cache for worst
* case page size.
*/
if ((ret =
dbenv->set_cachesize(dbenv, 0, 64 * 1024 * 10, 0)) != 0) {
dbenv->err(dbenv,
ret, "DB_ENV->set_cachesize: %s", home);
return (1);
}
if (verbose == 1)
(void)dbenv->set_verbose(dbenv, DB_VERB_RECOVERY, 1);
if ((ret = dbenv->open(dbenv, home, DB_CREATE |
DB_INIT_LOG | DB_INIT_MPOOL | DB_INIT_TXN | DB_PRIVATE |
DB_RECOVER_FATAL | DB_USE_ENVIRON, 0)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->open: %s", home);
return (1);
}
break;
}
*dbenvp = dbenv;
return (0);
}
/*
* backup_dir_clean --
* Clean out the backup directory.
*/
int
backup_dir_clean(dbenv, backup_dir, log_dir, remove_maxp, update, verbose)
DB_ENV *dbenv;
char *backup_dir, *log_dir;
int *remove_maxp, update, verbose;
{
ENV *env;
int cnt, fcnt, ret, v;
char **names, *dir, buf[DB_MAXPATHLEN], path[DB_MAXPATHLEN];
env = dbenv->env;
/* We may be cleaning a log directory separate from the target. */
if (log_dir != NULL) {
if ((size_t)snprintf(buf, sizeof(buf), "%s%c%s",
backup_dir, PATH_SEPARATOR[0] ,log_dir) >= sizeof(buf)) {
dbenv->errx(dbenv, DB_STR_A("5044",
"%s%c%s: path too long", "%s %c %s"),
backup_dir, PATH_SEPARATOR[0] ,log_dir);
return (1);
}
dir = buf;
} else
dir = backup_dir;
/* Get a list of file names. */
if ((ret = __os_dirlist(env, dir, 0, &names, &fcnt)) != 0) {
if (log_dir != NULL && !update)
return (0);
dbenv->err(dbenv, ret, DB_STR_A("5045", "%s: directory read",
"%s"), dir);
return (1);
}
for (cnt = fcnt; --cnt >= 0;) {
/*
* Skip non-log files (if update was specified).
*/
if (strncmp(names[cnt], LFPREFIX, sizeof(LFPREFIX) - 1)) {
if (update)
continue;
} else {
/* Track the highest-numbered log file removed. */
v = atoi(names[cnt] + sizeof(LFPREFIX) - 1);
if (*remove_maxp < v)
*remove_maxp = v;
}
if ((size_t)snprintf(path, sizeof(path), "%s%c%s",
dir, PATH_SEPARATOR[0], names[cnt]) >= sizeof(path)) {
dbenv->errx(dbenv, DB_STR_A("5046",
"%s%c%s: path too long", "%s %c %s"),
dir, PATH_SEPARATOR[0], names[cnt]);
return (1);
}
if (verbose)
printf(DB_STR_A("5047", "%s: removing %s\n",
"%s %s\n"), progname, path);
if (__os_unlink(env, path, 0) != 0)
return (1);
}
__os_dirfree(env, names, fcnt);
if (verbose && *remove_maxp != 0)
printf(DB_STR_A("5048",
"%s: highest numbered log file removed: %d\n", "%s %d\n"),
progname, *remove_maxp);
return (0);
}
/*
* read_data_dir --
* Read a directory looking for databases to copy.
*/
int
read_data_dir(dbenv,
home, backup_dir, dir, verbose, db_config, env_copy, relative, passwd)
DB_ENV *dbenv;
char *home, *backup_dir, *dir;
int verbose, db_config, env_copy, relative;
const char *passwd;
{
ENV *env;
int cnt, fcnt, ret;
char *bd, **names;
char buf[DB_MAXPATHLEN], bbuf[DB_MAXPATHLEN];
env = dbenv->env;
bd = backup_dir;
if (db_config && dir != home) {
/* Build a path name to the destination. */
if ((size_t)(cnt = snprintf(bbuf, sizeof(bbuf), "%s%c%s%c",
backup_dir, PATH_SEPARATOR[0],
dir, PATH_SEPARATOR[0])) >= sizeof(buf)) {
dbenv->errx(dbenv, DB_STR_A("5049",
"%s%c%s: path too long", "%s %c %s"),
backup_dir, PATH_SEPARATOR[0], dir);
return (1);
}
bd = bbuf;
/* Create the path. */
if ((ret = __db_mkpath(env, bd)) != 0) {
dbenv->err(dbenv, ret, DB_STR_A("5050",
"%s: cannot create", "%s"), bd);
return (1);
}
/* step on the trailing '/' */
bd[cnt - 1] = '\0';
}
if ((relative && !__os_abspath(dir)) || (db_config && dir != home)) {
/* Build a path name to the source. */
if ((size_t)snprintf(buf, sizeof(buf),
"%s%c%s", home, PATH_SEPARATOR[0], dir) >= sizeof(buf)) {
dbenv->errx(dbenv, DB_STR_A("5051",
"%s%c%s: path too long", "%s %c %s"),
home, PATH_SEPARATOR[0], dir);
return (1);
}
dir = buf;
}
/* Get a list of file names. */
if ((ret = __os_dirlist(env, dir, 0, &names, &fcnt)) != 0) {
dbenv->err(dbenv, ret, DB_STR_A("5052", "%s: directory read",
"%s"), dir);
return (1);
}
for (cnt = fcnt; --cnt >= 0;) {
/*
* Skip files in DB's name space (but not Queue extent files or
* the replicated system database, we need them).
*/
if (!strncmp(names[cnt], LFPREFIX, sizeof(LFPREFIX) - 1))
continue;
if (!strncmp(names[cnt],
DB_REGION_PREFIX, sizeof(DB_REGION_PREFIX) - 1) &&
(env_copy || strncmp(names[cnt],
QUEUE_EXTENT_PREFIX, sizeof(QUEUE_EXTENT_PREFIX) - 1))
#ifdef HAVE_PARTITION
&&
strncmp(names[cnt],
PART_PREFIX, sizeof(PART_PREFIX) - 1)
#endif
#if (DB_VERSION_MAJOR >= 5)
&&
strncmp(names[cnt],
REPSYSDBNAME, sizeof(REPSYSDBNAME) - 1)
#endif
)
continue;
/*
* Skip DB_CONFIG.
*/
if (!db_config &&
!strncmp(names[cnt], "DB_CONFIG", sizeof("DB_CONFIG")))
continue;
/*
* Copy the file.
* By default we copy through the environment, this works
* in all cases. If the OS or Filesystem supports atomic
* reads then we can read directly from the filesystem.
* This is known to be true only for UNIX based operating
* systems and not LINUX or Windows based operating systems.
*/
if (env_copy)
ret = env_data_copy(dbenv,
names[cnt], bd, verbose, passwd);
/* The file might not be a database. */
if (!env_copy || ret == ENOENT || ret == EINVAL)
ret = data_copy(dbenv, names[cnt], dir, bd, 0, verbose);
if (ret != 0)
return (1);
}
__os_dirfree(env, names, fcnt);
return (0);
}
/*
* read_log_dir --
* Read a directory looking for log files to copy. If home
* is passed then we are possibly using a log dir in the destination,
* following DB_CONFIG configuration.
*/
int
read_log_dir(dbenv, home, db_config, backup_dir, log_dir, copy_minp,
update, verbose)
DB_ENV *dbenv;
char *home, *backup_dir, *log_dir;
int *copy_minp, db_config, update, verbose;
{
ENV *env;
u_int32_t aflag;
int cnt, ret, v;
char **begin, **names, *backupd, *logd;
char from[DB_MAXPATHLEN], to[DB_MAXPATHLEN];
char cfpath[DB_MAXPATHLEN];
env = dbenv->env;
/*
* If the log directory is specified from DB_CONFIG then it is
* located relative to the the log file source dircectory. If
* the log directory is set from the -l argument and it is not an
* absolute path it is also located relative to the log file source
* directory. Otherwise the log file source directory is home.
*/
if (db_config && log_dir != NULL) {
if ((size_t)snprintf(from, sizeof(from), "%s%c%s",
home, PATH_SEPARATOR[0], log_dir) >= sizeof(from)) {
dbenv->errx(dbenv, DB_STR_A("5053",
"%s%c%s: path too long", "%s %c %s"),
home, PATH_SEPARATOR[0], log_dir);
return (1);
}
logd = strdup(from);
/*
* With a DB_CONFIG file, logs are copied to the specified
* location relative to the backup_dir. Otherwise the logs are
* copied to the backup_dir.
*/
if ((size_t)(cnt = snprintf(to, sizeof(to),
"%s%c%s%c", backup_dir, PATH_SEPARATOR[0],
log_dir, PATH_SEPARATOR[0])) >= sizeof(to)) {
dbenv->errx(dbenv, DB_STR_A("5054",
"%s%c%s: path too long", "%s %c %s"),
backup_dir, PATH_SEPARATOR[0], log_dir);
return (1);
}
backupd = strdup(to);
/* Create the backup log directory. */
if ((ret = __db_mkpath(env, backupd)) != 0) {
dbenv->err(dbenv, ret, DB_STR_A("5055",
"%s: cannot create", "%s"), backupd);
return (1);
}
/* Step on the trailing '/'. */
backupd[cnt - 1] = '\0';
} else {
/*
* Use a DB_CONFIG if it exists and neither -D/-l was set.
*/
if (log_dir == NULL) {
(void)dbenv->get_lg_dir(dbenv, (const char **)&log_dir);
if (log_dir)
logd = log_dir;
else
logd = log_dir = home;
} else {
logd = log_dir;
/*
* Do we have -l and an existing DB_CONFIG? That is a
* usage problem, but for backward compatibility, keep
* going if log_dir happens to be the same as the
* DB_CONFIG path.
*/
if ((size_t)snprintf(cfpath, sizeof(cfpath),
"%s%c%s", home, PATH_SEPARATOR[0], "DB_CONFIG") >=
sizeof(cfpath)) {
dbenv->errx(dbenv,DB_STR_A("5056",
"%s%c%s: path too long", "%s %c %s"),
home, PATH_SEPARATOR[0], "DB_CONFIG");
return (1);
}
if (__os_exists(NULL, cfpath, NULL) == 0) {
if (strcmp(log_dir,dbenv->db_log_dir)) {
fprintf(stderr, DB_STR_A("5057",
"%s: cannot specify -l with conflicting DB_CONFIG file\n",
"%s\n"), progname);
return (usage());
} else
fprintf(stderr, DB_STR_A("5058",
"%s: use of -l with DB_CONFIG file is deprecated\n",
"%s\n"), progname);
}
}
if (logd != home && !__os_abspath(logd)) {
if ((size_t)snprintf(from, sizeof(from),
"%s%c%s", home, PATH_SEPARATOR[0], log_dir)
>= sizeof(from)) {
dbenv->errx(dbenv, DB_STR_A("5059",
"%s%c%s: path too long",
"%s %c %s"), home,
PATH_SEPARATOR[0], log_dir);
return 1;
}
logd = strdup(from);
}
backupd = backup_dir;
}
again: aflag = DB_ARCH_LOG;
/*
* If this is an update and we are deleting files, first process
* those files that can be removed, then repeat with the rest.
*/
if (update)
aflag = 0;
/* Flush the log to get latest info. */
if ((ret = dbenv->log_flush(dbenv, NULL)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->log_flush");
return (1);
}
/* Get a list of file names to be copied. */
if ((ret = dbenv->log_archive(dbenv, &names, aflag)) != 0) {
dbenv->err(dbenv, ret, "DB_ENV->log_archive");
return (1);
}
if (names == NULL)
goto done;
begin = names;
for (; *names != NULL; names++) {
/* Track the lowest-numbered log file copied. */
v = atoi(*names + sizeof(LFPREFIX) - 1);
if (*copy_minp == 0 || *copy_minp > v)
*copy_minp = v;
if ((size_t)snprintf(from, sizeof(from), "%s%c%s",
logd, PATH_SEPARATOR[0], *names) >= sizeof(from)) {
dbenv->errx(dbenv, DB_STR_A("5060",
"%s%c%s: path too long", "%s %c %s"),
logd, PATH_SEPARATOR[0], *names);
return (1);
}
/*
* If we're going to remove the file, attempt to rename the
* instead of copying and then removing. The likely failure
* is EXDEV (source and destination are on different volumes).
* Fall back to a copy, regardless of the error. We don't
* worry about partial contents, the copy truncates the file
* on open.
*/
if (update) {
if ((size_t)snprintf(to, sizeof(to), "%s%c%s",
backupd, PATH_SEPARATOR[0], *names) >= sizeof(to)) {
dbenv->errx(dbenv, DB_STR_A("5061",
"%s%c%s: path too long", "%s %c %s"),
backupd, PATH_SEPARATOR[0], *names);
return (1);
}
if (__os_rename(env, from, to, 1) == 0) {
if (verbose)
printf(DB_STR_A("5062",
"%s: moving %s to %s\n",
"%s %s %s\n"),
progname, from, to);
continue;
}
}
/* Copy the file. */
if (data_copy(dbenv, *names, logd, backupd, 1, verbose) != 0)
return (1);
if (update) {
if (verbose)
printf(DB_STR_A("5063", "%s: removing %s\n",
"%s %s\n"), progname, from);
if ((ret = __os_unlink(env, from, 0)) != 0) {
dbenv->err(dbenv, ret, DB_STR_A("5064",
"unlink of %s failed", "%s"), from);
return (1);
}
}
}
free(begin);
done: if (update) {
update = 0;
goto again;
}
if (verbose && *copy_minp != 0)
printf(DB_STR_A("5065",
"%s: lowest numbered log file copied: %d\n", "%s %d\n"),
progname, *copy_minp);
if (logd != log_dir)
free(logd);
if (backupd != backup_dir)
free(backupd);
return (0);
}
/*
* data_copy --
* Copy a file into the backup directory.
*/
int
data_copy(dbenv, file, from_dir, to_dir, log, verbose)
DB_ENV *dbenv;
char *file, *from_dir, *to_dir;
int log, verbose;
{
DB_FH *rfhp, *wfhp;
ENV *env;
size_t nr, nw;
int ret;
char *buf;
rfhp = wfhp = NULL;
env = dbenv->env;
ret = 0;
if (verbose)
printf(DB_STR_A("5066", "%s: copying %s%c%s to %s%c%s\n",
"%s %s %c %s %s %c %s\n"), progname, from_dir,
PATH_SEPARATOR[0], file, to_dir, PATH_SEPARATOR[0], file);
/*
* We MUST copy multiples of the page size, atomically, to ensure a
* database page is not updated by another thread of control during
* the copy.
*
* !!!
* The current maximum page size for Berkeley DB is 64KB; we will have
* to increase this value if the maximum page size is ever more than a
* megabyte
*/
if ((buf = malloc(MEGABYTE)) == NULL) {
dbenv->err(dbenv, errno, DB_STR_A("5067",
"%lu buffer allocation", "%lu"), (u_long)MEGABYTE);
return (1);
}
/* Open the input file. */
if (snprintf(buf, MEGABYTE, "%s%c%s",
from_dir, PATH_SEPARATOR[0], file) >= MEGABYTE) {
dbenv->errx(dbenv, DB_STR_A("5068", "%s%c%s: path too long",
"%s %c %s"), from_dir, PATH_SEPARATOR[0], file);
goto err;
}
if ((ret = __os_open(env, buf, 0, DB_OSO_RDONLY, 0, &rfhp)) != 0) {
if (ret == ENOENT && !log) {
ret = 0;
if (verbose)
printf(DB_STR_A("5069",
"%s: %s%c%s not present\n", "%s %s %c %s\n"),
progname, from_dir, PATH_SEPARATOR[0], file);
goto done;
}
dbenv->err(dbenv, ret, "%s", buf);
goto err;
}
/* Open the output file. */
if (snprintf(buf, MEGABYTE, "%s%c%s",
to_dir, PATH_SEPARATOR[0], file) >= MEGABYTE) {
dbenv->errx(dbenv, DB_STR_A("5070", "%s%c%s: path too long",
"%s %c %s"), to_dir, PATH_SEPARATOR[0], file);
goto err;
}
if ((ret = __os_open(env, buf, 0,
DB_OSO_CREATE | DB_OSO_TRUNC, DB_MODE_600, &wfhp)) != 0) {
dbenv->err(dbenv, ret, "%s", buf);
goto err;
}
/* Copy the data. */
while ((ret = __os_read(env, rfhp, buf, MEGABYTE, &nr)) == 0 &&
nr > 0)
if ((ret = __os_write(env, wfhp, buf, nr, &nw)) != 0)
break;
if (0) {
err: ret = 1;
}
done: if (buf != NULL)
free(buf);
if (rfhp != NULL && __os_closehandle(env, rfhp) != 0)
ret = 1;
/* We may be running on a remote filesystem; force the flush. */
if (wfhp != NULL) {
if (__os_fsync(env, wfhp) != 0)
ret = 1;
if (__os_closehandle(env, wfhp) != 0)
ret = 1;
}
return (ret);
}
char *saved_prefix;
char *saved_errstr;
void save_error(dbenv, prefix, errstr)
const DB_ENV *dbenv;
const char *prefix;
const char *errstr;
{
COMPQUIET(dbenv, NULL);
saved_prefix = strdup(prefix);
saved_errstr = strdup(errstr);
}
/*
* env_data_copy --
* Copy a file into the backup directory through the environment.
*/
int
env_data_copy(dbenv, file, to_dir, verbose, passwd)
DB_ENV *dbenv;
char *file, *to_dir;
int verbose;
const char *passwd;
{
FILE *savefile;
int ret;
ret = 0;
if (verbose)
printf(DB_STR_A("5066", "%s: copying database %s to %s%c%s",
"%s %s %s %c %s"), progname,
file, to_dir, PATH_SEPARATOR[0], file);
dbenv->set_errcall(dbenv, save_error);
dbenv->get_errfile(dbenv, &savefile);
dbenv->set_errfile(dbenv, NULL);
if ((ret = db_copy(dbenv, file, to_dir, passwd)) != 0) {
if (ret != ENOENT && ret != EINVAL) {
if (saved_errstr != NULL)
fprintf(stderr, "%s: %s\n",
saved_prefix, saved_errstr);
else
fprintf(stderr, " %s\n", db_strerror(ret));
} else if (verbose)
printf(": not a database\n");
dbenv->set_errcall(dbenv, NULL);
dbenv->set_errfile(dbenv, savefile);
goto err;
}
dbenv->set_errcall(dbenv, NULL);
dbenv->set_errfile(dbenv, savefile);
if (verbose)
printf("\n");
err: if (saved_prefix != NULL)
free(saved_prefix);
if (saved_errstr != NULL)
free(saved_errstr);
saved_prefix = saved_errstr = NULL;
return (ret);
}
int
usage()
{
(void)fprintf(stderr, "usage: %s [-cDuVv]\n\t%s\n", progname,
"[-d data_dir ...] [-h home] [-l log_dir] [-P password] -b backup_dir");
return (EXIT_FAILURE);
}
int
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, DB_STR_A("5071",
"%s: version %d.%d doesn't match library version %d.%d\n",
"%s %d %d %d %d\n"), progname,
DB_VERSION_MAJOR, DB_VERSION_MINOR,
v_major, v_minor);
return (EXIT_FAILURE);
}
return (0);
}