dbxml_load [-V] [-f file] [-h home] [-P password] file

Description

The dbxml_load utility reads from the standard input and loads it into the XML container file. The XML container file is created if it does not already exist.

The input to dbxml_load must be in the output format specified by the dbxml_dump utility.

The options are as follows:

-f

Read from the specified input file instead of from the standard input.

-h

Specify a home directory for the database environment.

If a home directory is specified, the database environment is opened using the Db.DB_INIT_LOCK, Db.DB_INIT_LOG, Db.DB_INIT_MPOOL, Db.DB_INIT_TXN, and Db.DB_USE_ENVIRON flags to DB_ENV->open. (This means that dbxml_load can be used to load data into XML containers while they are in use by other processes.) If the DB_ENV->open call fails, or if no home directory is specified, the XML container is still updated, but the environment is ignored; for example, no locking is done.

-P

Specify an environment password. Although Berkeley DB utilities overwrite password strings as soon as possible, be aware there may be a window of vulnerability on systems where unprivileged users can see command-line arguments or where utilities are not able to overwrite the memory containing the command-line arguments.

-V

Write the library version number to the standard output, and exit.

The dbxml_load utility may be used with a Berkeley DB environment (as described for the -h option, the environment variable DB_HOME, or because the utility was run in a directory containing a Berkeley DB environment). In order to avoid environment corruption when using a Berkeley DB environment, dbxml_load should always be given the chance to detach from the environment and exit gracefully. To cause dbxml_load to release all environment resources and exit cleanly, send it an interrupt signal (SIGINT).

The dbxml_load utility exits 0 on success, 1 if one or more key/data pairs were not loaded into the XML container because the key already existed, and >1 if an error occurs.

Environment Variables

DB_HOME

If the -h option is not specified and the environment variable DB_HOME is set, it is used as the path of the database home, as described in DB_ENV->open.