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
|
/*
* Copyright (c) 2016, Linaro Limited
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
/*
* gmon.out file format
*
* This file is adapted from glibc's gmon/sys/gmon_out.h
* Although gmon/sys/gmon_out.h is covered by the LGPL v2.1 license or later
* as stated below, please note the following:
* (https://www.gnu.org/licenses/lgpl-3.0.en.html#section3)
*
* "3. Object Code Incorporating Material from Library Header Files.
* The object code form of an Application may incorporate material from a
* header file that is part of the Library. You may convey such object code
* under terms of your choice, provided that, if the incorporated material
* is not limited to numerical parameters, data structure layouts and
* accessors, or small macros, inline functions and templates (ten or fewer
* lines in length), you do both of the following: [...]"
*
* The code below is indeed limited to data structure layouts.
*/
/*
* Copyright (C) 1996-2016 Free Software Foundation, Inc.
* This file is part of the GNU C Library.
* Contributed by David Mosberger <davidm@cs.arizona.edu>.
*
* The GNU C Library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* The GNU C Library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with the GNU C Library; if not, see
* <http://www.gnu.org/licenses/>.
*/
/*
* This file specifies the format of gmon.out files. It should have
* as few external dependencies as possible as it is going to be included
* in many different programs. That is, minimize the number of #include's.
*
* A gmon.out file consists of a header (defined by gmon_hdr) followed by
* a sequence of records. Each record starts with a one-byte tag
* identifying the type of records, followed by records specific data.
*/
#ifndef GMON_OUT_H
#define GMON_OUT_H
#define GMON_MAGIC "gmon" /* magic cookie */
#define GMON_VERSION 1 /* version number */
/*
* Raw header as it appears on file (without padding). This header
* always comes first in gmon.out and is then followed by a series
* records defined below.
* Virtual addresses are stored as uintptr_t, gprof knows which size to expect
* because the executable file is provided.
*/
struct gmon_hdr {
char cookie[4];
int32_t version;
char spare[3 * 4];
} __packed;
/* types of records in this file: */
enum gmon_record_tag {
GMON_TAG_TIME_HIST = 0,
GMON_TAG_CG_ARC = 1,
GMON_TAG_BB_COUNT = 2
};
struct gmon_hist_hdr {
uintptr_t low_pc; /* base pc address of sample buffer */
uintptr_t high_pc; /* max pc address of sampled buffer */
uint32_t hist_size; /* size of sample buffer */
uint32_t prof_rate; /* profiling clock rate */
char dimen[15]; /* phys. dim., usually "seconds" */
char dimen_abbrev; /* usually 's' for "seconds" */
} __packed;
struct gmon_cg_arc_record {
uintptr_t from_pc; /* address within caller's body */
uintptr_t self_pc; /* address within callee's body */
int32_t count; /* number of arc traversals */
} __packed;
#endif /* GMON_OUT_H */
|
