summaryrefslogtreecommitdiff
path: root/docs/porting/testport.html
blob: b40ddbc294326ef39042a1692fe0bc955c7252a9 (plain)
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!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>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Chapter 3. Testing and Certifying the Port</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Porting Berkeley DB" />
    <link rel="up" href="index.html" title="Porting Berkeley DB" />
    <link rel="prev" href="layout.html" title="Source Code Layout" />
    <link rel="next" href="modifytest.html" title="Modifying the Tests" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.1</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Chapter 3. Testing and Certifying the Port</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="layout.html">Prev</a> </td>
          <th width="60%" align="center"> </th>
          <td width="20%" align="right"> <a accesskey="n" href="modifytest.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="chapter" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title"><a id="testport"></a>Chapter 3. Testing and Certifying the Port</h2>
          </div>
        </div>
      </div>
      <div class="toc">
        <p>
          <b>Table of Contents</b>
        </p>
        <dl>
          <dt>
            <span class="sect1">
              <a href="testport.html#testtypes">Types of Tests for Berkeley DB</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="modifytest.html">Modifying the Tests</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="testrun.html">Running the Tests</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="testreview.html">Reviewing the Results of the Tests</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="sourceintegrate.html">Integrating Changes into the Berkeley DB Source Code</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="certport.html">Certifying a Port of Berkeley DB</a>
            </span>
          </dt>
        </dl>
      </div>
      <p>
There are several different types of tests available for validating your
port of Berkeley DB as discussed in <a class="xref" href="testport.html#testtypes" title="Types of Tests for Berkeley DB">Types of Tests for Berkeley DB</a>. Testing your port involves:
</p>
      <div class="itemizedlist">
        <ul type="disc">
          <li>
            <p>
<a class="xref" href="modifytest.html" title="Modifying the Tests">Modifying the Tests</a>
</p>
          </li>
          <li>
            <p>
<a class="xref" href="testrun.html" title="Running the Tests">Running the Tests</a>
</p>
          </li>
          <li>
            <p>
        <a class="xref" href="testreview.html" title="Reviewing the Results of the Tests">Reviewing the Results of the Tests</a>
</p>
          </li>
          <li>
            <p>
<a class="xref" href="sourceintegrate.html" title="Integrating Changes into the Berkeley DB Source Code">Integrating Changes into the Berkeley DB Source Code</a>
</p>
          </li>
          <li>
            <p>
        <a class="xref" href="certport.html" title="Certifying a Port of Berkeley DB">Certifying a Port of Berkeley DB</a>
</p>
          </li>
        </ul>
      </div>
      <div class="sect1" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title" style="clear: both"><a id="testtypes"></a>Types of Tests for Berkeley DB</h2>
            </div>
          </div>
        </div>
        <p>
There are two types of tests available for testing your port of Berkeley DB:
</p>
        <div class="itemizedlist">
          <ul type="disc">
            <li>
              <p>The C Tests for Berkeley DB</p>
              <p>
There are two types of C tests for Berkeley DB. Each of these is in its own directory:
</p>
              <div class="itemizedlist">
                <ul type="circle">
                  <li>
                    <p>
The <code class="literal">test_mutex</code> test is found in <code class="literal">src/mutex</code>.
</p>
                  </li>
                  <li>
                    <p>
The <code class="literal">test_micro</code> tests are found in <code class="literal">test/micro</code>.
Here you will find C tests that exercise the most common code paths. However, please note that 
<code class="literal">test_micro</code> is not intended to be an exhaustive test suite. Additionally, it tests the
different versions of Berkeley DB (including the new port) against each
other.  The <code class="literal">test_micro</code> tests can either be run in a shell or as simple C tests.
</p>
                  </li>
                </ul>
              </div>
            </li>
            <li>
              <p>The Berkeley DB Test Suite</p>
              <p>
The <code class="literal">test</code> directory contains the Berkeley DB Test Suite that tests all of the code in Berkeley DB. Using the Test Suite involves using Tool Command Language (Tcl) version 8.5 or later. Running the standard version of the Test Suite executes tests the major functionality of Berkeley DB. A more exhaustive version of the Test Suite runs all the tests several more times, testing encryption, replication, and different page sizes.
</p>
            </li>
          </ul>
        </div>
      </div>
      <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
        <h3 class="title">Note</h3>
        <p>
            Contact the Oracle Berkeley DB engineering team for a platform compatibility test suite.
            
        </p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="layout.html">Prev</a> </td>
          <td width="20%" align="center"> </td>
          <td width="40%" align="right"> <a accesskey="n" href="modifytest.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Source Code Layout </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Modifying the Tests</td>
        </tr>
      </table>
    </div>
  </body>
</html>