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.01; 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.11; 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.memp_stat
DbEnv.memp_stat
|
 
|
import com.sleepycat.db.*;
public DbMpoolStat memp_stat()
throws DbException;
public DbMpoolFStat[] memp_fstat()
throws DbException;
Description
The DbEnv.memp_stat and DbEnv.memp_fstat method create statistical
structures and return to the caller. The statistics include the number
of files participating in the pool, the active pages in the pool, and
information as to how effective the cache has been.
The DbEnv.memp_stat method creates a DbMpoolStat object containing global
statistics. The following data fields are available:
- public long st_gbytes;
- Gigabytes of cache (total cache size is st_gbytes + st_bytes).
- public long st_bytes;
- Bytes of cache (total cache size is st_gbytes + st_bytes).
- public int st_ncache;
- Number of caches.
- public int st_regsize;
- Individual cache size.
- public int st_cache_hit;
- Requested pages found in the cache.
- public int st_cache_miss;
- Requested pages not found in the cache.
- public int st_map;
- Requested pages mapped into the process' address space (there is no
available information about whether or not this request caused disk I/O,
although examining the application page fault rate may be helpful).
- public int st_page_create;
- Pages created in the cache.
- public int st_page_in;
- Pages read into the cache.
- public int st_page_out;
- Pages written from the cache to the backing file.
- public int st_ro_evict;
- Clean pages forced from the cache.
- public int st_rw_evict;
- Dirty pages forced from the cache.
- public int st_hash_buckets;
- Number of hash buckets in buffer hash table.
- public int st_hash_searches;
- Total number of buffer hash table lookups.
- public int st_hash_longest;
- The longest chain ever encountered in buffer hash table lookups.
- public int st_hash_examined;
- Total number of hash elements traversed during hash table lookups.
- public int st_page_clean;
- Clean pages currently in the cache.
- public int st_page_dirty;
- Dirty pages currently in the cache.
- public int st_page_trickle;
- Dirty pages written using the DbEnv.memp_trickle interface.
- 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.memp_fstat method creates an array of DbMpoolFStat objects
containing statistics for individual files in the pool. Each
DbMpoolFStat object contains statistics for an individual DbMpoolFile.
The following data fields are available for each DbMpoolFStat object:
- public String file_name;
- The name of the file.
- public long st_pagesize;
- Page size in bytes.
- public int st_cache_hit;
- Requested pages found in the cache.
- public int st_cache_miss;
- Requested pages not found in the cache.
- public int st_map;
- Requested pages mapped into the process' address space.
- public int st_page_create;
- Pages created in the cache.
- public int st_page_in;
- Pages read into the cache.
- public int st_page_out;
- Pages written from the cache to the backing file.
The DbEnv.memp_stat method throws an exception that encapsulates a non-zero error value on
failure.
Errors
The DbEnv.memp_stat method may fail and throw an exception encapsulating a non-zero error for the following conditions:
- EINVAL
- An invalid flag value or parameter was specified.
The DbEnv.memp_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.memp_stat method may fail and throw
a DbRunRecoveryException, in which case all subsequent Berkeley DB calls
will fail in the same way.
Class
DbEnv
See Also
DbEnv.memp_fstat,
DbEnv.memp_stat,
and
DbEnv.memp_trickle.
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
d25 1
a25 1
throws DbException;
d27 2
a28 2
public DbMpoolFStat[] memp_fstat(int flags)
throws DbException;
d98 1
a98 1
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d24 1
a24 1
public DbMpoolStat memp_stat(int flags)
d31 6
a36 13
The DbEnv.memp_stat and DbEnv.memp_fstat methods return the memory pool
subsystem statistics.
The flags value must be set to 0 or
the following value:
- Db.DB_STAT_CLEAR
- Reset statistics after returning their values.
The DbEnv.memp_stat and DbEnv.memp_fstat methods create the DbMpoolStat
and DbMpoolFStat objects encapsulating the memory pool region
statistics. The memory pool region statistics are stored in a
DbMpoolStat object and the per-file memory pool statistics are stored
in DbMpoolFStat objects. The following data fields are available from
the DbMpoolStat object:
d42 2
a46 2
public int st_cache_hit;Requested pages found in the cache.
public int st_cache_miss;Requested pages not found in the cache.
a51 4
public int st_page_trickle;Dirty pages written using the DbEnv.memp_trickle interface.
public int st_pages;Pages in the cache.
public int st_page_clean;Clean pages currently in the cache.
public int st_page_dirty;Dirty pages currently in the cache.
d56 3
a58 6
public int st_hash_nowait;The number of times that a thread of control was able to obtain a hash
bucket lock without waiting.
public int st_hash_wait;The number of times that a thread of control was forced to wait before
obtaining a hash bucket lock.
public int st_hash_max_wait;The maximum number of times any hash bucket lock was waited for by a
thread of control.
d60 3
a62 8
obtaining a region lock.
public int st_region_nowait;The number of times that a thread of control was able to obtain a region
lock without waiting.
public int st_alloc;Number of page allocations.
public int st_alloc_buckets;Number of hash buckets checked during allocation.
public int st_alloc_max_buckets;Maximum number of hash buckets checked during an allocation.
public int st_alloc_pages;Number of pages checked during allocation.
public int st_alloc_max_pages;Maximum number of pages checked during an allocation.
d67 1
a67 2
The following data fields are available for each DbMpoolFStat
object:
d86 3
a88 3
If a catastrophic error has occurred, the DbEnv.memp_stat method may fail and
throw a DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d90 1
a90 1
DbEnv, DbMpoolFile
d92 4
a95 1
Memory Pools and Related Methods
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2
d4 1
d25 1
a25 1
public DbMpoolStat memp_stat()
d32 13
a44 6
The DbEnv.memp_stat and DbEnv.memp_fstat method create statistical
structures and return to the caller. The statistics include the number
of files participating in the pool, the active pages in the pool, and
information as to how effective the cache has been.
The DbEnv.memp_stat method creates a DbMpoolStat object containing global
statistics. The following data fields are available:
a49 2
public int st_cache_hit;Requested pages found in the cache.
public int st_cache_miss;Requested pages not found in the cache.
d53 2
d60 4
d68 6
a73 3
public int st_page_clean;Clean pages currently in the cache.
public int st_page_dirty;Dirty pages currently in the cache.
public int st_page_trickle;Dirty pages written using the DbEnv.memp_trickle interface.
d75 8
a82 3
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.
d87 2
a88 1
The following data fields are available for each DbMpoolFStat object:
d107 3
a109 3
If a catastrophic error has occurred, the DbEnv.memp_stat method may fail and throw
a DbRunRecoveryException, in which case all subsequent Berkeley DB calls
will fail in the same way.
d111 1
a111 1
DbEnv
d113 1
a113 4
DbEnv.memp_fstat,
DbEnv.memp_stat,
and
DbEnv.memp_trickle.
@
1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d1 2
a2 2
a3 1
d24 1
a24 1
public DbMpoolStat memp_stat(int flags)
d31 6
a36 13
The DbEnv.memp_stat and DbEnv.memp_fstat methods return the memory pool
subsystem statistics.
The flags value must be set to 0 or
the following value:
- Db.DB_STAT_CLEAR
- Reset statistics after returning their values.
The DbEnv.memp_stat and DbEnv.memp_fstat methods create the DbMpoolStat
and DbMpoolFStat objects encapsulating the memory pool region
statistics. The memory pool region statistics are stored in a
DbMpoolStat object and the per-file memory pool statistics are stored
in DbMpoolFStat objects. The following data fields are available from
the DbMpoolStat object:
d42 2
a46 2
public int st_cache_hit;Requested pages found in the cache.
public int st_cache_miss;Requested pages not found in the cache.
a51 4
public int st_page_trickle;Dirty pages written using the DbEnv.memp_trickle interface.
public int st_pages;Pages in the cache.
public int st_page_clean;Clean pages currently in the cache.
public int st_page_dirty;Dirty pages currently in the cache.
d56 3
a58 6
public int st_hash_nowait;The number of times that a thread of control was able to obtain a hash
bucket lock without waiting.
public int st_hash_wait;The number of times that a thread of control was forced to wait before
obtaining a hash bucket lock.
public int st_hash_max_wait;The maximum number of times any hash bucket lock was waited for by a
thread of control.
d60 3
a62 8
obtaining a region lock.
public int st_region_nowait;The number of times that a thread of control was able to obtain a region
lock without waiting.
public int st_alloc;Number of page allocations.
public int st_alloc_buckets;Number of hash buckets checked during allocation.
public int st_alloc_max_buckets;Maximum number of hash buckets checked during an allocation.
public int st_alloc_pages;Number of pages checked during allocation.
public int st_alloc_max_pages;Maximum number of pages checked during an allocation.
d67 1
a67 2
The following data fields are available for each DbMpoolFStat
object:
d86 3
a88 3
If a catastrophic error has occurred, the DbEnv.memp_stat method may fail and
throw a DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d90 1
a90 1
DbEnv, DbMpoolFile
d92 4
a95 1
Memory Pools and Related Methods
@