/usr/share/doc/ruby-bdb/docs/log.html is in ruby-bdb 0.6.5-7build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <?xml version="1.0" ?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>docs/log.rd</title>
</head>
<body>
<h2><a name="label-0" id="label-0">Logging subsystem</a></h2><!-- RDLabel: "Logging subsystem" -->
<p>This subsystem is used when recovery from application or system
failure is necessary.</p>
<p>The log is stored in one or more files in the environment
directory. Each file is named using the format log.NNNNNNNNNN, where
NNNNNNNNNN is the sequence number of the file within the log.</p>
<p>If the log region is being created and log files are already present,
the log files are reviewed and subsequent log writes are appended to
the end of the log, rather than overwriting current log entries.</p>
<p>The lock subsystem is created, initialized, and opened by calls to
<code>BDB::Env#open</code> with the <var>BDB::INIT_LOG</var> flag specified. </p>
<p>The following options can be given when the environnement is created</p>
<dl>
<dt><a name="label-1" id="label-1"><var>"set_lg_bsize"</var></a></dt><!-- RDLabel: ""set_lg_bsize"" -->
<dd>
Set log buffer size
</dd>
<dt><a name="label-2" id="label-2"><var>"set_lg_dir"</var></a></dt><!-- RDLabel: ""set_lg_dir"" -->
<dd>
Set the environment logging directory
</dd>
<dt><a name="label-3" id="label-3"><var>"set_lg_max"</var></a></dt><!-- RDLabel: ""set_lg_max"" -->
<dd>
Set log file size
</dd>
</dl>
<h3><a name="label-4" id="label-4">BDB::Env</a></h3><!-- RDLabel: "BDB::Env" -->
<h4><a name="label-5" id="label-5">Methods</a></h4><!-- RDLabel: "Methods" -->
<dl>
<dt><a name="label-6" id="label-6"><code>log_archive(<var>flags</var> = <var>0</var>)</code></a></dt><!-- RDLabel: "log_archive" -->
<dd>
<p>The log_archive function return an array of log or database file names.</p>
<p><var>flags</var> value must be set to 0 or the value <var>BDB::ARCH_DATA</var></p>
<pre>((|BDB::ARCH_DATA|)), ((|BDB::ARCH_LOG|))</pre></dd>
<dt><a name="label-7" id="label-7"><code>log_checkpoint(<var>string</var>)</code></a></dt><!-- RDLabel: "log_checkpoint" -->
<dd>
same as <var>log_put(string, BDB::CHECKPOINT)</var></dd>
<dt><a name="label-8" id="label-8"><code>log_curlsn(<var>string</var>)</code></a></dt><!-- RDLabel: "log_curlsn" -->
<dd>
same as <var>log_put(string, BDB::CURLSN)</var></dd>
<dt><a name="label-9" id="label-9"><code>log_each { |<var>string</var>, <var>lsn</var>| ... }</code></a></dt><!-- RDLabel: "log_each" -->
<dd>
Implement an iterator inside of the log</dd>
<dt><a name="label-10" id="label-10"><code>log_flush([<var>string</var>])</code></a></dt><!-- RDLabel: "log_flush" -->
<dd>
<p>same as <var>log_put(string, BDB::FLUSH)</var></p>
<p>Without argument, garantee that all records are written to the disk</p></dd>
<dt><a name="label-11" id="label-11"><code>log_get(<var>flag</var>)</code></a></dt><!-- RDLabel: "log_get" -->
<dd>
<p>The <var>log_get</var> return an array <var>[String, BDB::Lsn]</var> according to
the <var>flag</var> value.</p>
<p><var>flag</var> can has the value <var>BDB::CHECKPOINT</var>, <var>BDB::FIRST</var>,
<var>BDB::LAST</var>, <var>BDB::NEXT</var>, <var>BDB::PREV</var>, <var>BDB::CURRENT</var></p></dd>
<dt><a name="label-12" id="label-12"><code>log_put(<var>string</var>, <var>flag</var> = <var>0</var>)</code></a></dt><!-- RDLabel: "log_put" -->
<dd>
<p>The <var>log_put</var> function appends records to the log. It return
an object <var>BDB::Lsn</var></p>
<p><var>flag</var> can have the value <var>BDB::CHECKPOINT</var>, <var>BDB::CURLSN</var>,
<var>BDB::FLUSH</var></p></dd>
<dt><a name="label-13" id="label-13"><code>log_reverse_each { |<var>string</var>, <var>lsn</var>| ... }</code></a></dt><!-- RDLabel: "log_reverse_each" -->
<dd>
Implement an iterator inside of the log</dd>
<dt><a name="label-14" id="label-14"><code>log_stat</code></a></dt><!-- RDLabel: "log_stat" -->
<dd>
return log statistics</dd>
</dl>
<h3><a name="label-15" id="label-15">BDB::Common</a></h3><!-- RDLabel: "BDB::Common" -->
<h4><a name="label-16" id="label-16">Methods</a></h4><!-- RDLabel: "Methods" -->
<dl>
<dt><a name="label-17" id="label-17"><code>log_register(<var>name</var>)</code></a></dt><!-- RDLabel: "log_register" -->
<dd>
The <var>log_register</var> function registers a file <var>name</var>.</dd>
<dt><a name="label-18" id="label-18"><code>log_unregister()</code></a></dt><!-- RDLabel: "log_unregister" -->
<dd>
The <var>log_unregister</var> function unregisters a file name.</dd>
</dl>
<h3><a name="label-19" id="label-19">BDB::Lsn</a></h3><!-- RDLabel: "BDB::Lsn" -->
<p>include Comparable</p>
<dl>
<dt><a name="label-20" id="label-20"><code><=></code></a></dt><!-- RDLabel: "<=>" -->
<dd>
compare 2 <var>BDB::Lsn</var></dd>
<dt><a name="label-21" id="label-21"><code>log_file(<var>name</var>)</code></a></dt><!-- RDLabel: "log_file" -->
<dt><a name="label-22" id="label-22"><code>file(<var>name</var>)</code></a></dt><!-- RDLabel: "file" -->
<dd>
The <var>log_file</var> function maps <var>BDB::Lsn</var> structures to file
<var>name</var>s</dd>
<dt><a name="label-23" id="label-23"><code>log_flush</code></a></dt><!-- RDLabel: "log_flush" -->
<dt><a name="label-24" id="label-24"><code>flush</code></a></dt><!-- RDLabel: "flush" -->
<dd>
The <var>log_flush</var> function guarantees that all log records whose
<var>DBB:Lsn</var> are less than or equal to the current lsn have been written
to disk.</dd>
<dt><a name="label-25" id="label-25"><code>log_get</code></a></dt><!-- RDLabel: "log_get" -->
<dt><a name="label-26" id="label-26"><code>get</code></a></dt><!-- RDLabel: "get" -->
<dd>
return the <var>String</var> associated with this <var>BDB::Lsn</var></dd>
</dl>
</body>
</html>
|