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.54.00; author rse; state dead;
branches;
next 1.1;
commitid z4cpSiAhOCXk5PLs;
1.1
date 2001.07.23.20.45.37; author rse; state Exp;
branches
1.1.1.1;
next ;
1.1.1.1
date 2001.07.23.20.45.37; author rse; state Exp;
branches;
next 1.1.1.2;
1.1.1.2
date 2002.01.08.00.30.10; author rse; state Exp;
branches;
next 1.1.1.3;
1.1.1.3
date 2003.01.18.13.49.00; author rse; state Exp;
branches;
next 1.1.1.4;
1.1.1.4
date 2001.12.06.00.08.12; author rse; state Exp;
branches;
next 1.1.1.5;
1.1.1.5
date 2003.01.18.14.04.59; author rse; state Exp;
branches;
next ;
desc
@@
1.2
log
@remove the ancient RPM 4.2.1 source tree copy
@
text
@
Berkeley DB: DbEnv.lock_stat
DbEnv.lock_stat
|

|
import com.sleepycat.db.*;
public DbLockStat lock_stat()
throws DbException;
Description
The DbEnv.lock_stat method
creates a DbLockStat object encapsulating a statistical structure.
The lock region statistics are stored in a DbLockStat object.
The following data fields are available from the DbLockStat object:
The lock region statistics are stored in a structure of type
DB_LOCK_STAT. The following DB_LOCK_STAT fields will be filled in:
- public int st_lastid;
- The last allocated lock ID.
- public int st_nmodes;
- The number of lock modes.
- public int st_maxlocks;
- The maximum number of locks possible.
- public int st_maxlockers;
- The maximum number of lockers possible.
- public int st_maxobjects;
- The maximum number of objects possible.
- public int st_nlocks;
- The number of current locks.
- public int st_maxnlocks;
- The maximum number of locks at any one time.
- public int st_nlockers;
- The number of current lockers.
- public int st_maxnlockers;
- The maximum number of lockers at any one time.
- public int st_nobjects;
- The number of current objects.
- public int st_maxnobjects;
- The maximum number of objects at any one time.
- public int st_nrequests;
- The total number of locks requested.
- public int st_nreleases;
- The total number of locks released.
- public int st_nnowaits;
- The total number of lock requests that failed because
Db.DB_LOCK_NOWAIT was set.
- public int st_nconflicts;
- The total number of locks not immediately available due to conflicts.
- public int st_ndeadlocks;
- The number of deadlocks detected.
- public int st_regsize;
- The size of the region.
- public int st_region_wait;
- The number of times that a thread of control was forced to wait before
obtaining the region lock.
- public int st_region_nowait;
- The number of times that a thread of control was able to obtain
the region lock without waiting.
The DbEnv.lock_stat method throws an exception that encapsulates a non-zero error value on
failure.
Errors
The DbEnv.lock_stat method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods.
If a catastrophic error has occurred, the DbEnv.lock_stat method may fail and throw
a DbRunRecoveryException, in which case all subsequent Berkeley DB calls
will fail in the same way.
Class
DbEnv, DbLock
See Also
DbEnv.set_lk_conflicts,
DbEnv.set_lk_detect,
DbEnv.set_lk_max,
DbEnv.set_lk_max_lockers,
DbEnv.set_lk_max_locks,
DbEnv.set_lk_max_objects,
DbEnv.lock_detect,
DbEnv.lock_get,
DbEnv.lock_id,
DbLock.put,
and
DbEnv.lock_stat.
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
d17 1
a17 1

d24 2
a25 2
public DbLockStat lock_stat(int flags)
throws DbException;
a31 5
The flags value must be set to 0 or
the following value:
- Db.DB_STAT_CLEAR
- Reset statistics after returning their values.
a51 4
public int st_nlocktimeouts;The number of locks that have timed out.
public int st_ntxntimeouts;The number of transactions that have timed out. This value is also a
component of st_ndeadlocks, the total number of deadlocks
detected.
d70 1
d77 1
a77 2
DbEnv.lock_id_free,
DbEnv.lock_put,
d82 1
a82 1

@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d28 4
a31 1
The DbEnv.lock_stat method returns the locking subsystem statistics.
d37 2
a38 3
The DbEnv.lock_stat method creates a DbLockStat object encapsulating the
lock region statistics. The following data fields are available from
the DbLockStat object:
d40 1
a40 2
public int st_id;The last allocated locker ID.
public int st_cur_maxid;The current maximum unused locker ID.
d44 1
a44 1
public int st_maxobjects;The maximum number of lock objects possible.
d49 2
a50 2
public int st_nobjects;The number of current lock objects.
public int st_maxnobjects;The maximum number of lock objects at any one time.
d53 1
a53 1
public int st_nnowaits;The total number of lock requests failing because
d56 1
a56 2
public int st_ndeadlocks;The number of deadlocks.
public int st_locktimeout;Lock timeout value.
a57 1
public int st_txntimeout;Transaction timeout value.
d61 1
a61 1
public int st_regsize;The size of the lock region.
d71 3
a73 3
If a catastrophic error has occurred, the DbEnv.lock_stat method may fail and
throw a DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d75 1
a75 1
DbEnv, DbLock
d77 12
a88 1
Locking Subsystem and Related Methods
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2
d4 1
d29 1
a29 4
The DbEnv.lock_stat method
creates a DbLockStat object encapsulating a statistical structure.
The lock region statistics are stored in a DbLockStat object.
The following data fields are available from the DbLockStat object:
d35 3
a37 2
The lock region statistics are stored in a structure of type
DB_LOCK_STAT. The following DB_LOCK_STAT fields will be filled in:
d39 2
a40 1
public int st_lastid;The last allocated lock ID.
d44 1
a44 1
public int st_maxobjects;The maximum number of objects possible.
d49 2
a50 2
public int st_nobjects;The number of current objects.
public int st_maxnobjects;The maximum number of objects at any one time.
d53 1
a53 1
public int st_nnowaits;The total number of lock requests that failed because
d56 2
a57 1
public int st_ndeadlocks;The number of deadlocks detected.
d59 1
d63 1
a63 1
public int st_regsize;The size of the region.
d73 3
a75 3
If a catastrophic error has occurred, the DbEnv.lock_stat method may fail and throw
a DbRunRecoveryException, in which case all subsequent Berkeley DB calls
will fail in the same way.
d77 1
a77 1
DbEnv, DbLock
d79 1
a79 12
DbEnv.set_lk_conflicts,
DbEnv.set_lk_detect,
DbEnv.set_lk_max_lockers,
DbEnv.set_lk_max_locks,
DbEnv.set_lk_max_objects,
DbEnv.lock_detect,
DbEnv.lock_get,
DbEnv.lock_id,
DbEnv.lock_id_free,
DbEnv.lock_put,
and
DbEnv.lock_stat.
@
1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d1 2
a2 2
a3 1
d28 4
a31 1
The DbEnv.lock_stat method returns the locking subsystem statistics.
d37 2
a38 3
The DbEnv.lock_stat method creates a DbLockStat object encapsulating the
lock region statistics. The following data fields are available from
the DbLockStat object:
d40 1
a40 2
public int st_id;The last allocated locker ID.
public int st_cur_maxid;The current maximum unused locker ID.
d44 1
a44 1
public int st_maxobjects;The maximum number of lock objects possible.
d49 2
a50 2
public int st_nobjects;The number of current lock objects.
public int st_maxnobjects;The maximum number of lock objects at any one time.
d53 1
a53 1
public int st_nnowaits;The total number of lock requests failing because
d56 1
a56 2
public int st_ndeadlocks;The number of deadlocks.
public int st_locktimeout;Lock timeout value.
a57 1
public int st_txntimeout;Transaction timeout value.
d61 1
a61 1
public int st_regsize;The size of the lock region.
d71 3
a73 3
If a catastrophic error has occurred, the DbEnv.lock_stat method may fail and
throw a DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d75 1
a75 1
DbEnv, DbLock
d77 12
a88 1
Locking Subsystem and Related Methods
@