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
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
|
/*! @file GcovFunctionData.h
* @brief GcovFunctionData Specification
*
* This file contains the specification of the GcovGcnoWriter class.
*/
#ifndef __GCOV_FUNCTION_DATA_H__
#define __GCOV_FUNCTION_DATA_H__
#include <stdint.h>
#include <list>
#include <fstream>
#include <iomanip>
#include "CoverageMapBase.h"
#include "DesiredSymbols.h"
namespace Gcov {
#define FUNCTION_NAME_LENGTH 64
#define FILE_NAME_LENGTH 256
#define ON_TREE_ARC_FLAG 0x1
#define FAKE_ARC_FLAG 0x2
#define FALLTHROUGH_ARC_FLAG 0x4
struct gcov_arc_info
{
uint32_t sourceBlock;
uint32_t destinationBlock;
uint32_t flags;
uint64_t counter;
};
struct gcov_block_info
{
uint32_t id;
uint32_t flags;
uint32_t numberOfLines;
uint64_t counter;
std::string sourceFileName;
std::list<uint32_t> lines;
};
typedef std::list<gcov_arc_info> arcs_t;
typedef std::list<gcov_arc_info>::iterator arcs_iterator_t;
typedef std::list<gcov_block_info> blocks_t;
typedef std::list<gcov_block_info>::iterator blocks_iterator_t;
class DesiredSymbols;
/*! @class GcovFunctionData
*
* This is the specification of the GcovFunctionData class.
*/
class GcovFunctionData {
public:
/*!
* This method constructs a GcovFunctionData instance.
*/
GcovFunctionData();
/*!
* This method destructs a GcovFunctionData instance.
*/
virtual ~GcovFunctionData();
/*!
* This method stores checksum related to function
*
* @param[in] chk stores the checksum value
*/
void setChecksum( const uint32_t chk );
/*!
* This method stores id of function
*
* @param[in] idNumber stores the id value
*/
void setId( const uint32_t idNumber );
/*!
* This method stores checksum related to function
*
* @param[in] lineNo passes number of the line begining the function
*/
void setFirstLineNumber( const uint32_t lineNo );
/*!
* This method stores name of the function and ties it to its
* unified coverage map.
*
* @param[in] functionName passes name of the the function
* @param[in] symbolsToAnalyze the symbols to be analyzed
*
* @return Returns TRUE if the method succeeded and FALSE if it failed.
*/
bool setFunctionName(
const std::string& fcnName,
Coverage::DesiredSymbols& symbolsToAnalyze
);
/*!
* This method stores name of the source file where function is located
*
* @param[in] fileName passes name of the the file
*
* @return Returns TRUE if the method succeeded and FALSE if it failed.
*/
bool setFileName( const std::string& fileName );
/*!
* This method stores name of the source file where block is located
*
* @param[in] block identifies block
* @param[in] fileName passes name of the the file
*
* @return Returns TRUE if the method succeeded and FALSE if it failed.
*/
void setBlockFileName(
const blocks_iterator_t block,
const std::string& fileName
);
/*!
* This method returns arcs list
*/
arcs_t getArcs() const;
/*!
* This method returns blocks list
*/
blocks_t getBlocks() const;
/*!
* This method returns checksum
*/
uint32_t getChecksum() const;
/*!
* This method returns id
*/
uint32_t getId() const;
/*!
* This method returns counters
*
* @param[out] counterValues array of counter values
* @param[out] countersFound used to return counters number
* @param[out] countersSum used to return sum counters values
* @param[out] countersMax used to return max counter value
*/
void getCounters(
uint64_t* counterValues,
uint32_t& countersFound,
uint64_t& countersSum,
uint64_t& countersMax
);
/*!
* This method adds new arc to arc list
*
* @param[in] source passes source block number
* @param[in] destination passes destination block number
*/
void addArc( uint32_t source, uint32_t destination, uint32_t flags );
/*!
* This method adds new arc to arc list
*
* @param[in] block identifies block
* @param[in] line passes the line number
*/
void addBlockLine( const blocks_iterator_t block, const uint32_t line );
/*!
* This method finds block by its ID
*
* @param[in] id passes block id number
*
* @return Returns iterator to a matching block or NULL for error.
*/
blocks_iterator_t findBlockById( const uint32_t id );
/*!
* This method adds new block to block list
*
* @param[in] id passes block id number
* @param[in] flags passes per block flags
* @param[in] sourceFileName passes containing file name
*/
void addBlock(
const uint32_t id,
const uint32_t flags,
const std::string& sourceFileName
);
/*!
* This method prints info about function
*/
void printFunctionInfo(
std::ofstream& textFile,
uint32_t function_number
);
/*!
* This method prints info about coverage of this function
*/
void printCoverageInfo(
std::ofstream& textFile,
uint32_t function_number
);
/*!
* This method prints info about chosen arc in arcs list
*
* @param[in] textFile specifies output file
* @param[in] arc passes iterator identifying arc
*/
void printArcInfo( std::ofstream& textFile, arcs_iterator_t arc );
/*!
* This method prints info about chosen block in blocks list
*
* @param[in] block passes iterator identifying block
*/
void printBlockInfo( std::ofstream& textFile, blocks_iterator_t block );
/*!
* This method calculates values of arc counters
*/
bool processFunctionCounters();
private:
uint32_t id;
uint32_t checksum;
uint32_t firstLineNumber;
uint32_t numberOfBlocks;
uint32_t numberOfArcs;
arcs_t arcs;
blocks_t blocks;
std::string functionName;
std::string sourceFileName;
/*!
* This member contains the unified or merged coverage map
* and symbol info for the symbol.
*/
Coverage::CoverageMapBase* coverageMap;
Coverage::SymbolInformation* symbolInfo;
/*!
* This method creates list of taken/not taken values
* for branches
*
* @param[in] taken used to return taken counts list
* @param[in] notTaken used to return not taken counts list
*/
bool processBranches(
std::list<uint64_t>* taken,
std::list<uint64_t>* notTaken
);
};
}
#endif
|
