head 1.2;
access;
symbols
RPM_4_2_1:1.1.1.5
RPM_4_2:1.1.1.5
RPM_4_1_1:1.1.1.5
RPM_4_1:1.1.1.4
RPM_4_0_5:1.1.1.3
RPM_4_0_4:1.1.1.2
RPM_4_0_3:1.1.1.1
RPM:1.1.1;
locks; strict;
comment @# @;
1.2
date 2008.01.02.09.55.23; author rse; state dead;
branches;
next 1.1;
commitid z4cpSiAhOCXk5PLs;
1.1
date 2001.07.23.20.45.38; author rse; state Exp;
branches
1.1.1.1;
next ;
1.1.1.1
date 2001.07.23.20.45.38; author rse; state Exp;
branches;
next 1.1.1.2;
1.1.1.2
date 2002.01.08.00.30.12; author rse; state Exp;
branches;
next 1.1.1.3;
1.1.1.3
date 2003.01.18.13.49.03; author rse; state Exp;
branches;
next 1.1.1.4;
1.1.1.4
date 2001.10.15.03.47.34; author rse; state Exp;
branches;
next 1.1.1.5;
1.1.1.5
date 2003.01.18.14.05.00; author rse; state Exp;
branches;
next ;
desc
@@
1.2
log
@remove the ancient RPM 4.2.1 source tree copy
@
text
@
Berkeley DB Reference Guide: Berkeley DB handles
- Berkeley DB Reference Guide:
- Programmer Notes
|
  
|
Berkeley DB handles
The Berkeley DB library has a number of object handles. The following table
lists those handles, their scope, and whether they are free-threaded
(that is, whether multiple threads within a process can share them).
- DB_ENV
- The DB_ENV handle, created by the db_env_create function, refers
to a Berkeley DB database environment -- a collection of Berkeley DB subsystems,
log files and databases. DB_ENV handles are free-threaded if
the DB_THREAD flag is specified to the DB_ENV->open function when
the environment is opened. The handle should not be closed while any
other handle remains open that is using it as a reference (for example,
DB or DB_TXN). Once either the DB_ENV->close or
DB_ENV->remove functions are called, the handle may not be accessed again,
regardless of the function's return.
- DB_TXN
- The DB_TXN handle, created by the txn_begin function, refers to
a single transaction. The handle is not free-threaded; and transactions
may not span threads, nor may transactions be used by more than a single
thread. Once the txn_abort or txn_commit functions are called,
the handle may not be accessed again, regardless of the function's
return. In addition, parent transactions may not issue any Berkeley DB
operations while they have active child transactions (child transactions
that have not yet been committed or aborted) except for
txn_begin, txn_abort and txn_commit.
- DB_MPOOLFILE
- The DB_MPOOLFILE handle refers to an open file in the shared
memory buffer pool of the database environment. The handle is not
free-threaded. Once the memp_fclose function is called, the handle may
not be accessed again, regardless of the function's return.
- DB
- The DB handle, created by the db_create function, refers to a
single Berkeley DB database, which may or may not be part of a database
environment. DB handles are free-threaded if the
DB_THREAD flag is specified to the DB->open function when the
database is opened or if the database environment in which the database
is opened is free-threaded. The handle should not be closed while any
other handle that refers to the database is in use; for example,
database handles must not be closed while cursor handles into the
database remain open, or transactions that include operations on the
database have not yet been committed or aborted. Once the
DB->close, DB->remove, or DB->rename functions are
called, the handle may not be accessed again, regardless of the
function's return.
- DBC
- The DBC handle refers to a cursor into a Berkeley DB database. The
handle is not free-threaded, and cursors may not span threads; nor may
cursors be used by more than a single thread. If the cursor is to be
used to perform operations on behalf of a transaction, the cursor must
be opened and closed within the context of that single transaction.
Once DBcursor->c_close has been called, the handle may not be accessed
again, regardless of the function's return.
Copyright Sleepycat Software
@
1.1
log
@Initial revision
@
text
@d1 1
a1 1
@
1.1.1.1
log
@Import: RPM 4.0.3
@
text
@@
1.1.1.2
log
@Import: RPM 4.0.4
@
text
@d1 1
a1 1
d22 1
a22 1
DB_ENVThe DB_ENV handle, created by the db_env_create function, refers
d24 1
a24 1
log files and databases. DB_ENV handles are free-threaded if
d28 1
a28 1
DB or DB_TXN). Once either the DB_ENV->close or
d31 1
a31 1
DB_TXNThe DB_TXN handle, created by the DB_ENV->txn_begin function, refers to
d34 1
a34 1
thread. Once the DB_TXN->abort or DB_TXN->commit functions are called,
d39 2
a40 6
DB_ENV->txn_begin, DB_TXN->abort and DB_TXN->commit.
DB_LOGCThe DB_LOGC handle refers to a cursor into the log files. The
handle is not free-threaded. Once the DB_LOGC->close function is called,
the handle may not be accessed again, regardless of the function's
return.
DB_MPOOLFILEThe DB_MPOOLFILE handle refers to an open file in the shared
d42 1
a42 1
free-threaded. Once the DB_MPOOLFILE->close function is called, the handle may
d44 1
a44 1
DBThe DB handle, created by the db_create function, refers to a
d46 1
a46 1
environment. DB handles are free-threaded if the
d57 1
a57 1
DBCThe DBC handle refers to a cursor into a Berkeley DB database. The
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d2 1
a2 1
a3 1
d22 1
a22 1
DB_ENVThe DB_ENV handle, created by the db_env_create method, refers
d24 2
a25 2
log files and databases. DB_ENV handles are free-threaded if
the DB_THREAD flag is specified to the DB_ENV->open method when
d28 2
a29 2
DB or DB_TXN). Once either the DB_ENV->close or
DB_ENV->remove methods are called, the handle may not be accessed again,
d31 1
a31 1
DB_TXNThe DB_TXN handle, created by the DB_ENV->txn_begin method, refers to
d34 1
a34 1
thread. Once the DB_TXN->abort or DB_TXN->commit methods are called,
d40 2
a41 2
DB_LOGCThe DB_LOGC handle refers to a cursor into the log files. The
handle is not free-threaded. Once the DB_LOGC->close method is called,
d44 1
a44 1
DB_MPOOLFILEThe DB_MPOOLFILE handle refers to an open file in the shared
d46 1
a46 1
free-threaded. Once the DB_MPOOLFILE->close method is called, the handle may
d48 1
a48 1
DBThe DB handle, created by the db_create method, refers to a
d50 2
a51 2
environment. DB handles are free-threaded if the
DB_THREAD flag is specified to the DB->open method when the
d58 1
a58 1
DB->close, DB->remove, or DB->rename methods are
d61 1
a61 1
DBCThe DBC handle refers to a cursor into a Berkeley DB database. The
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d2 1
a2 1
d4 1
d23 1
a23 1
DB_ENVThe DB_ENV handle, created by the db_env_create function, refers
d25 2
a26 2
log files and databases. DB_ENV handles are free-threaded if
the DB_THREAD flag is specified to the DB_ENV->open function when
d29 2
a30 2
DB or DB_TXN). Once either the DB_ENV->close or
DB_ENV->remove functions are called, the handle may not be accessed again,
d32 1
a32 1
DB_TXNThe DB_TXN handle, created by the DB_ENV->txn_begin function, refers to
d35 1
a35 1
thread. Once the DB_TXN->abort or DB_TXN->commit functions are called,
d41 2
a42 2
DB_LOGCThe DB_LOGC handle refers to a cursor into the log files. The
handle is not free-threaded. Once the DB_LOGC->close function is called,
d45 1
a45 1
DB_MPOOLFILEThe DB_MPOOLFILE handle refers to an open file in the shared
d47 1
a47 1
free-threaded. Once the DB_MPOOLFILE->close function is called, the handle may
d49 1
a49 1
DBThe DB handle, created by the db_create function, refers to a
d51 2
a52 2
environment. DB handles are free-threaded if the
DB_THREAD flag is specified to the DB->open function when the
d59 1
a59 1
DB->close, DB->remove, or DB->rename functions are
d62 1
a62 1
DBCThe DBC handle refers to a cursor into a Berkeley DB database. The
@
1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d2 1
a2 1
a3 1
d22 1
a22 1
DB_ENVThe DB_ENV handle, created by the db_env_create method, refers
d24 2
a25 2
log files and databases. DB_ENV handles are free-threaded if
the DB_THREAD flag is specified to the DB_ENV->open method when
d28 2
a29 2
DB or DB_TXN). Once either the DB_ENV->close or
DB_ENV->remove methods are called, the handle may not be accessed again,
d31 1
a31 1
DB_TXNThe DB_TXN handle, created by the DB_ENV->txn_begin method, refers to
d34 1
a34 1
thread. Once the DB_TXN->abort or DB_TXN->commit methods are called,
d40 2
a41 2
DB_LOGCThe DB_LOGC handle refers to a cursor into the log files. The
handle is not free-threaded. Once the DB_LOGC->close method is called,
d44 1
a44 1
DB_MPOOLFILEThe DB_MPOOLFILE handle refers to an open file in the shared
d46 1
a46 1
free-threaded. Once the DB_MPOOLFILE->close method is called, the handle may
d48 1
a48 1
DBThe DB handle, created by the db_create method, refers to a
d50 2
a51 2
environment. DB handles are free-threaded if the
DB_THREAD flag is specified to the DB->open method when the
d58 1
a58 1
DB->close, DB->remove, or DB->rename methods are
d61 1
a61 1
DBCThe DBC handle refers to a cursor into a Berkeley DB database. The
@