← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/postgresql-9.1/oneiric-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/html/regress-coverage.html

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2011-05-11 10:41:53 UTC
  • Revision ID: james.westby@ubuntu.com-20110511104153-psbh2o58553fv1m0
Tags: upstream-9.1~beta1
Import upstream version 9.1~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/html/regress-coverage.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Test Coverage Examination</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 
9
REV="MADE"
 
10
HREF="mailto:pgsql-docs@postgresql.org"><LINK
 
11
REL="HOME"
 
12
TITLE="PostgreSQL 9.1beta1 Documentation"
 
13
HREF="index.html"><LINK
 
14
REL="UP"
 
15
TITLE="Regression Tests"
 
16
HREF="regress.html"><LINK
 
17
REL="PREVIOUS"
 
18
TITLE="Variant Comparison Files"
 
19
HREF="regress-variant.html"><LINK
 
20
REL="NEXT"
 
21
TITLE="Client Interfaces"
 
22
HREF="client-interfaces.html"><LINK
 
23
REL="STYLESHEET"
 
24
TYPE="text/css"
 
25
HREF="stylesheet.css"><META
 
26
HTTP-EQUIV="Content-Type"
 
27
CONTENT="text/html; charset=ISO-8859-1"><META
 
28
NAME="creation"
 
29
CONTENT="2011-04-27T21:20:33"></HEAD
 
30
><BODY
 
31
CLASS="SECT1"
 
32
><DIV
 
33
CLASS="NAVHEADER"
 
34
><TABLE
 
35
SUMMARY="Header navigation table"
 
36
WIDTH="100%"
 
37
BORDER="0"
 
38
CELLPADDING="0"
 
39
CELLSPACING="0"
 
40
><TR
 
41
><TH
 
42
COLSPAN="5"
 
43
ALIGN="center"
 
44
VALIGN="bottom"
 
45
><A
 
46
HREF="index.html"
 
47
>PostgreSQL 9.1beta1 Documentation</A
 
48
></TH
 
49
></TR
 
50
><TR
 
51
><TD
 
52
WIDTH="10%"
 
53
ALIGN="left"
 
54
VALIGN="top"
 
55
><A
 
56
TITLE="Variant Comparison Files"
 
57
HREF="regress-variant.html"
 
58
ACCESSKEY="P"
 
59
>Prev</A
 
60
></TD
 
61
><TD
 
62
WIDTH="10%"
 
63
ALIGN="left"
 
64
VALIGN="top"
 
65
><A
 
66
TITLE="Regression Tests"
 
67
HREF="regress.html"
 
68
>Fast Backward</A
 
69
></TD
 
70
><TD
 
71
WIDTH="60%"
 
72
ALIGN="center"
 
73
VALIGN="bottom"
 
74
>Chapter 30. Regression Tests</TD
 
75
><TD
 
76
WIDTH="10%"
 
77
ALIGN="right"
 
78
VALIGN="top"
 
79
><A
 
80
TITLE="Regression Tests"
 
81
HREF="regress.html"
 
82
>Fast Forward</A
 
83
></TD
 
84
><TD
 
85
WIDTH="10%"
 
86
ALIGN="right"
 
87
VALIGN="top"
 
88
><A
 
89
TITLE="Client Interfaces"
 
90
HREF="client-interfaces.html"
 
91
ACCESSKEY="N"
 
92
>Next</A
 
93
></TD
 
94
></TR
 
95
></TABLE
 
96
><HR
 
97
ALIGN="LEFT"
 
98
WIDTH="100%"></DIV
 
99
><DIV
 
100
CLASS="SECT1"
 
101
><H1
 
102
CLASS="SECT1"
 
103
><A
 
104
NAME="REGRESS-COVERAGE"
 
105
>30.4. Test Coverage Examination</A
 
106
></H1
 
107
><P
 
108
>    The PostgreSQL source code can be compiled with coverage testing
 
109
    instrumentation, so that it becomes possible to examine which
 
110
    parts of the code are covered by the regression tests or any other
 
111
    test suite that is run with the code.  This is currently supported
 
112
    when compiling with GCC and requires the <TT
 
113
CLASS="COMMAND"
 
114
>gcov</TT
 
115
>
 
116
    and <TT
 
117
CLASS="COMMAND"
 
118
>lcov</TT
 
119
> programs.
 
120
   </P
 
121
><P
 
122
>    A typical workflow would look like this:
 
123
</P><PRE
 
124
CLASS="SCREEN"
 
125
>./configure --enable-coverage ... OTHER OPTIONS ...
 
126
gmake
 
127
gmake check # or other test suite
 
128
gmake coverage-html</PRE
 
129
><P>
 
130
    Then point your HTML browser
 
131
    to <TT
 
132
CLASS="FILENAME"
 
133
>coverage/index.html</TT
 
134
>.
 
135
    The <TT
 
136
CLASS="COMMAND"
 
137
>gmake</TT
 
138
> commands also work in subdirectories.
 
139
   </P
 
140
><P
 
141
>    To reset the execution counts between test runs, run:
 
142
</P><PRE
 
143
CLASS="SCREEN"
 
144
>gmake coverage-clean</PRE
 
145
><P>
 
146
   </P
 
147
></DIV
 
148
><DIV
 
149
CLASS="NAVFOOTER"
 
150
><HR
 
151
ALIGN="LEFT"
 
152
WIDTH="100%"><TABLE
 
153
SUMMARY="Footer navigation table"
 
154
WIDTH="100%"
 
155
BORDER="0"
 
156
CELLPADDING="0"
 
157
CELLSPACING="0"
 
158
><TR
 
159
><TD
 
160
WIDTH="33%"
 
161
ALIGN="left"
 
162
VALIGN="top"
 
163
><A
 
164
HREF="regress-variant.html"
 
165
ACCESSKEY="P"
 
166
>Prev</A
 
167
></TD
 
168
><TD
 
169
WIDTH="34%"
 
170
ALIGN="center"
 
171
VALIGN="top"
 
172
><A
 
173
HREF="index.html"
 
174
ACCESSKEY="H"
 
175
>Home</A
 
176
></TD
 
177
><TD
 
178
WIDTH="33%"
 
179
ALIGN="right"
 
180
VALIGN="top"
 
181
><A
 
182
HREF="client-interfaces.html"
 
183
ACCESSKEY="N"
 
184
>Next</A
 
185
></TD
 
186
></TR
 
187
><TR
 
188
><TD
 
189
WIDTH="33%"
 
190
ALIGN="left"
 
191
VALIGN="top"
 
192
>Variant Comparison Files</TD
 
193
><TD
 
194
WIDTH="34%"
 
195
ALIGN="center"
 
196
VALIGN="top"
 
197
><A
 
198
HREF="regress.html"
 
199
ACCESSKEY="U"
 
200
>Up</A
 
201
></TD
 
202
><TD
 
203
WIDTH="33%"
 
204
ALIGN="right"
 
205
VALIGN="top"
 
206
>Client Interfaces</TD
 
207
></TR
 
208
></TABLE
 
209
></DIV
 
210
></BODY
 
211
></HTML
 
212
>
 
 
b'\\ No newline at end of file'