dbxml_load [-V] [-f file] [-h home] [-P password] xml_container
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 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_INIT_LOCK, DB_INIT_LOG, DB_INIT_MPOOL, DB_INIT_TXN, and DB_USE_ENVIRON flags to the DB_ENV->open() method. (This means that dbxml_load can be used to load data into databases while they are in use by other processes.) If the DB_ENV->open() call fails, or if no home directory is specified, the database 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 database because the key already existed, and >1 if an error occurs.
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 the DB_ENV->open() method.