db_load
NAME
db_load - the DB database loader
SYNOPSIS
db_load [-c name=value]
[-f file] [-h home] [-t btree | hash] db_file
DESCRIPTION
The db_load utility reads from the standard input and
loads it into the database db_file. The input to db_load
must have been created by the db_dump or db_dump185 utili-
ties (see db_dump(1) for more information).
The options are as follows:
-c Specify configuration options for the DB_INFO struc-
ture provided to db_open(3), ignoring any value they
may have based on the input. The command-line format
is ``name=value''. Supported keywords are listed
below.
-f Read from the specified input file instead of from
the standard input.
-h Specify a home directory for the database.
-t Specify the underlying access method. If no -t
option is specified, the database will be loaded into
a database of the same type as was dumped, e.g., a
hash database will be created if a hash database was
dumped. Btree and hash databases may be converted
from one to the other. Recno databases cannot be
converted to any other database type.
The db_load utility exits 0 on success, and >0 if an error
occurs.
KEYWORDS
The following keywords are supported for the -c command-
line option. See db_open(3) for further discussion of
these keywords and what values should be specified.
The parenthetical listing specifies how the value part of
the ``name=value'' pair is interpreted. Items listed as
(boolean) expect value to be ``1'' (set) or ``0'' (unset).
Items listed as (number) convert value to a number. Items
listed as (string) use the characters of value directly.
bt_minkey
The minimum number of keys per page (number).
db_lorder
The byte order for integers in the stored database
metadata (number).
db_pagesize
The size of pages used for nodes in the tree, in
bytes (number).
duplicates
The value of the DB_DUP flag (boolean).
h_ffactor
The density within the hash table (number).
h_nelem
The size of the hash table (number).
re_len
Specify fixed-length records of the specified length
(number).
re_pad
Specify the fixed-length record pad character
(string).
recnum
The value of the DB_RECNUM flag (boolean).
renumber
The value of the DB_RENUMBER flag (boolean).
ENVIRONMENT VARIABLES
The following environment variables affect the execution
of db_load:
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_appinit(3).
SEE ALSO
The DB library is a family of groups of functions that
provides a modular programming interface to transactions
and record-oriented file access. The library includes
support for transactions, locking, logging and file page
caching, as well as various indexed access methods. Many
of the functional groups (e.g., the file page caching
functions) are useful independent of the other DB func-
tions, although some functional groups are explicitly
based on other functional groups (e.g., transactions and
logging). For a general description of the DB package,
see db_intro(3).
db_archive(1), db_checkpoint(1), db_deadlock(1), db_dump(1),
db_intro(3), db_load(1), db_recover(1), db_stat(1),
db_appinit(3), db_cursor(3), db_dbm(3), db_lock(3), db_log(3),
db_mpool(3), db_open(3), db_txn(3)