← Back to branch summary

~ubuntu-branches/ubuntu/maverick/evolution-data-server/maverick-proposed

« back to all changes in this revision

Viewing changes to libdb/docs/ref/test/run.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
https://launchpad.net/bugs/42199
https://launchpad.net/bugs/229669
https://launchpad.net/bugs/173703
https://launchpad.net/bugs/360344
https://launchpad.net/bugs/508494
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
libdb/docs/ref/test/run.html
1
 
<!--$Id$-->
2
 
<!--Copyright 1997-2002 by Sleepycat Software, Inc.-->
3
 
<!--All rights reserved.-->
4
 
<!--See the file LICENSE for redistribution information.-->
5
 
<html>
6
 
<head>
7
 
<title>Berkeley DB Reference Guide: Running the test suite</title>
8
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
9
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
10
 
</head>
11
 
<body bgcolor=white>
12
 
<a name="2"><!--meow--></a>
13
 
<table width="100%"><tr valign=top>
14
 
<td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Test Suite</dl></h3></td>
15
 
<td align=right><a href="../../ref/upgrade.4.1/disk.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/test/faq.html"><img src="../../images/next.gif" alt="Next"></a>
16
 
</td></tr></table>
17
 
<p>
18
 
<h1 align=center>Running the test suite</h1>
19
 
<p>Once you have started tclsh and have loaded the test.tcl source file (see
20
 
<a href="../../ref/build_unix/test.html">Running the test suite under UNIX</a>
21
 
and <a href="../../ref/build_win/test.html">Running the test suite under
22
 
Windows</a> for more information), you are ready to run the test suite.  At
23
 
the tclsh prompt, to run the entire test suite, enter the following:
24
 
<p><blockquote><pre>% run_std</pre></blockquote>
25
 
<p>Running all the tests can take from several hours to a few days to
26
 
complete, depending on your hardware.  For this reason, the output from
27
 
this command is redirected to a file in the current directory named
28
 
<b>ALL.OUT</b>.  Periodically, a line will be written to the standard
29
 
output, indicating what test is being run.  When the test suite has
30
 
finished, a single message indicating that the test suite completed
31
 
successfully or that it failed will be written.  If the run failed, you
32
 
should review the file <b>ALL.OUT</b> to determine which tests failed.
33
 
Errors will appear in that file as output lines, beginning with the
34
 
string "FAIL".
35
 
<p>It is also possible to run specific tests or tests for a particular
36
 
subsystem:
37
 
<p><blockquote><pre>% r archive
38
 
% r btree
39
 
% r env
40
 
% r frecno
41
 
% r hash
42
 
% r join
43
 
% r join
44
 
% r lock
45
 
% r log
46
 
% r mpool
47
 
% r mutex
48
 
% r queue
49
 
% r rbtree
50
 
% r recno
51
 
% r rrecno
52
 
% r subdb
53
 
% r txn</pre></blockquote>
54
 
<p>Or to run a single, individual test:
55
 
<p><blockquote><pre>% test001 btree</pre></blockquote>
56
 
<p>It is also possible to modify the test run based on arguments on the
57
 
command line.  For example, the following command will run a greatly
58
 
abbreviated form of test001, doing 10 operations instead of 10,000:
59
 
<p><blockquote><pre>% test001 btree 10</pre></blockquote>
60
 
<p>In all cases, when not running the entire test suite as described
61
 
previously, a successful test run will return you to the tclsh prompt.
62
 
On failure, a message is displayed indicating what failed.
63
 
<p>Tests are run, by default, in the directory <b>TESTDIR</b>.  However,
64
 
the test files are often very large.  To use a different directory for
65
 
the test directory, edit the file include.tcl in your build directory,
66
 
and change the following line to a more appropriate value for your
67
 
system:
68
 
<p><blockquote><pre>set testdir ./TESTDIR</pre></blockquote>
69
 
<p>For example, you might change it to the following:
70
 
<p><blockquote><pre>set testdir /var/tmp/db.test</pre></blockquote>
71
 
<p>Alternatively, you can create a symbolic link named TESTDIR in your
72
 
build directory to an appropriate location for running the tests.
73
 
Regardless of where you run the tests, the TESTDIR directory should be
74
 
on a local filesystem, using a remote filesystem (for example, NFS) will
75
 
almost certainly cause spurious test failures.
76
 
<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/upgrade.4.1/disk.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/test/faq.html"><img src="../../images/next.gif" alt="Next"></a>
77
 
</td></tr></table>
78
 
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
79
 
</body>
80
 
</html>