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

Description

The dbxml_load utility reads from the standard input and loads it into the XML container xml_container. The XML container xml_container 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 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_INIT_LOCK, DB_INIT_LOG, DB_INIT_MPOOL, DB_INIT_TXN, and 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.