File: log_stat.html

package info (click to toggle)
db4.7 4.7.25-21
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 66,668 kB
  • sloc: ansic: 152,921; java: 62,154; tcl: 53,690; sh: 14,075; perl: 13,476; cpp: 10,662; cs: 2,660; makefile: 2,511; awk: 1,749; xml: 197; python: 26; php: 22; asm: 14; sed: 9
file content (132 lines) | stat: -rw-r--r-- 7,219 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<!--$Id: log_stat.so,v 10.59 2007/09/21 20:06:02 bostic Exp $-->
<!--Copyright (c) 1997,2008 Oracle.  All rights reserved.-->
<!--See the file LICENSE for redistribution information.-->
<html>
<head>
<title>Berkeley DB: DbEnv::log_stat</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<table width="100%"><tr valign=top>
<td>
<b>DbEnv::log_stat</b>
</td>
<td align=right>
<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a>
<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td>
</tr></table>
<hr size=1 noshade>
<tt>
<b><pre>
#include &lt;db_cxx.h&gt;
<p>
int
DbEnv::log_stat(DB_LOG_STAT **statp, u_int32_t flags);
<p>
int
DbEnv::log_stat_print(u_int32_t flags);
</pre></b>
<hr size=1 noshade>
<b>Description: DbEnv::log_stat</b>
<p>The DbEnv::log_stat method returns the logging subsystem statistics.</p>
<p>The DbEnv::log_stat method creates a statistical structure of type
DB_LOG_STAT and copies a pointer to it into a user-specified memory
location.</p>
<p>Statistical structures are stored in allocated memory.  If application-specific allocation
routines have been declared (see <a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a> for more
information), they are used to allocate the memory; otherwise, the
standard C library <b>malloc</b>(3) is used.  The caller is
responsible for deallocating the memory.  To deallocate the memory, free
the memory reference; references inside the returned memory need not be
individually freed.</p>
<p>The following DB_LOG_STAT fields will be filled in:</p>
<br>
<b>u_int32_t st_magic;</b><ul compact><li>The magic number that identifies a file as a log file.</ul>
<b>u_int32_t st_version;</b><ul compact><li>The version of the log file type.</ul>
<b>int st_mode;</b><ul compact><li>The mode of any created log files.</ul>
<b>u_int32_t st_lg_bsize;</b><ul compact><li>The in-memory log record cache size.</ul>
<b>u_int32_t st_lg_size;</b><ul compact><li>The log file size.</ul>
<b>u_int32_t st_record;</b><ul compact><li>The number of records written to this log.</ul>
<b>u_int32_t st_w_mbytes;</b><ul compact><li>The number of megabytes written to this log.</ul>
<b>u_int32_t st_w_bytes;</b><ul compact><li>The number of bytes over and above <b>st_w_mbytes</b> written to this log.</ul>
<b>u_int32_t st_wc_mbytes;</b><ul compact><li>The number of megabytes written to this log since the last checkpoint.</ul>
<b>u_int32_t st_wc_bytes;</b><ul compact><li>The number of bytes over and above <b>st_wc_mbytes</b> written to this log
since the last checkpoint.</ul>
<b>u_int32_t st_wcount;</b><ul compact><li>The number of times the log has been written to disk.</ul>
<b>u_int32_t st_wcount_fill;</b><ul compact><li>The number of times the log has been written to disk because the
in-memory log record cache filled up.</ul>
<b>u_int32_t st_rcount;</b><ul compact><li>The number of times the log has been read from disk.</ul>
<b>u_int32_t st_scount;</b><ul compact><li>The number of times the log has been flushed to disk.</ul>
<b>u_int32_t st_cur_file;</b><ul compact><li>The current log file number.</ul>
<b>u_int32_t st_cur_offset;</b><ul compact><li>The byte offset in the current log file.</ul>
<b>u_int32_t st_disk_file;</b><ul compact><li>The log file number of the last record known to be on disk.</ul>
<b>u_int32_t st_disk_offset;</b><ul compact><li>The byte offset of the last record known to be on disk.</ul>
<b>u_int32_t st_maxcommitperflush;</b><ul compact><li>The maximum number of commits contained in a single log flush.</ul>
<b>u_int32_t st_mincommitperflush;</b><ul compact><li>The minimum number of commits contained in a single log flush that
contained a commit.</ul>
<b>roff_t st_regsize;</b><ul compact><li>The size of the log region, in bytes.</ul>
<b>u_int32_t st_region_wait;</b><ul compact><li>The number of times that a thread of control was forced to wait before
obtaining the log region mutex.</ul>
<b>u_int32_t st_region_nowait;</b><ul compact><li>The number of times that a thread of control was able to obtain
the log region mutex without waiting.</ul>
<br>
<p>The DbEnv::log_stat method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is called.</p>
<p>The DbEnv::log_stat method
either returns a non-zero error value
or throws an exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
</p>
<b>Parameters</b> <br>
 <b>flags</b><ul compact><li>The <b>flags</b> parameter must be set to 0 or
the following value:
<br>
<b><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a></b><ul compact><li>Reset statistics after returning their values.</ul>
<br></ul>
 <b>statp</b><ul compact><li>The <b>statp</b> parameter references memory into which
a pointer to the allocated statistics structure is copied.</ul> 
<br>
<br><b>Errors</b>
<p>The DbEnv::log_stat method
may fail and throw
<a href="../api_cxx/except_class.html">DbException</a>,
encapsulating one of the following non-zero errors, or return one of
the following non-zero errors:</p>
<br>
<b>EINVAL</b><ul compact><li>An
invalid flag value or parameter was specified.</ul>
<br>
<hr size=1 noshade>
<b>Description: DbEnv::log_stat_print</b>
<p>The DbEnv::log_stat_print method displays the
logging subsystem statistical information, as described for the DbEnv::log_stat method.
The information is printed to a specified output channel (see the
<a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an
application callback function (see the <a href="../api_cxx/env_set_msgcall.html">DbEnv::set_msgcall</a> method for
more information).</p>
<p>The DbEnv::log_stat_print method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is called.</p>
<p>The DbEnv::log_stat_print method
either returns a non-zero error value
or throws an exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
</p>
<b>Parameters</b> <br>
 <b>flags</b><ul compact><li>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one
or more of the following values:
<br>
<b><a name="DB_STAT_ALL">DB_STAT_ALL</a></b><ul compact><li>Display all available information.</ul>
<b><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a></b><ul compact><li>Reset statistics after displaying their values.</ul>
<br></ul>
<br>
<hr size=1 noshade>
<br><b>Class</b>
<a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a>, <a href="../api_cxx/lsn_class.html">DbLsn</a>
<br><b>See Also</b>
<a href="../api_cxx/log_list.html">Logging Subsystem and Related Methods</a>
</tt>
<table width="100%"><tr><td><br></td><td align=right>
<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a>
</td></tr></table>
<p><font size=1>Copyright (c) 1996,2008 Oracle.  All rights reserved.</font>
</body>
</html>