* doc/binutils.texi (strings): Add "unicode" to the documentation
[binutils.git] / gprof / gmon.h
blobbe670ffc44639a2f9dd834ac3dc6f19680c4d8de
1 /*
2 * Copyright (c) 1983, 1991, 1993, 2001
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. Neither the name of the University nor the names of its contributors
14 * may be used to endorse or promote products derived from this software
15 * without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * SUCH DAMAGE.
29 #ifndef gmon_h
30 #define gmon_h
32 /* Size of the 4.4BSD gmon header */
33 #define GMON_HDRSIZE_BSD44_32 (4 + 4 + 4 + 4 + 4 + (3 * 4))
34 #define GMON_HDRSIZE_BSD44_64 (8 + 8 + 4 + 4 + 4 + (3 * 4))
36 /* *INDENT-OFF* */
37 /* For documentation purposes only.
39 struct raw_phdr
41 char low_pc[sizeof(void *)]; -- base pc address of sample buffer
42 char high_pc[sizeof(void *)]; -- max pc address of sampled buffer
43 char ncnt[4]; -- size of sample buffer (plus this
44 header)
46 char version[4]; -- version number
47 char profrate[4]; -- profiling clock rate
48 char spare[3*4]; -- reserved
51 /* *INDENT-ON* */
53 #define GMONVERSION 0x00051879
55 /* Size of the old BSD gmon header */
56 #define GMON_HDRSIZE_OLDBSD_32 (4 + 4 + 4)
58 /* FIXME: Checking host compiler defines here means that we can't
59 use a cross gprof alpha OSF. */
60 #if defined(__alpha__) && defined (__osf__)
61 #define GMON_HDRSIZE_OLDBSD_64 (8 + 8 + 4 + 4)
62 #else
63 #define GMON_HDRSIZE_OLDBSD_64 (8 + 8 + 4)
64 #endif
66 /* *INDENT-OFF* */
67 /* For documentation purposes only.
69 struct old_raw_phdr
71 char low_pc[sizeof(void *)]; -- base pc address of sample buffer
72 char high_pc[sizeof(void *)] -- max pc address of sampled buffer
73 char ncnt[4]; -- size of sample buffer (plus this
74 header)
76 if defined (__alpha__) && defined (__osf__)
77 char pad[4]; -- DEC's OSF v3.0 uses 4 bytes of padding
78 -- to bring the header to a size that is a
79 -- multiple of 8.
80 endif
83 /* *INDENT-ON* */
86 * Histogram counters are unsigned shorts:
88 #define HISTCOUNTER unsigned short
91 * Fraction of text space to allocate for histogram counters here, 1/2:
93 #define HISTFRACTION 2
96 * Fraction of text space to allocate for from hash buckets. The
97 * value of HASHFRACTION is based on the minimum number of bytes of
98 * separation between two subroutine call points in the object code.
99 * Given MIN_SUBR_SEPARATION bytes of separation the value of
100 * HASHFRACTION is calculated as:
102 * HASHFRACTION = MIN_SUBR_SEPARATION / (2 * sizeof(short) - 1);
104 * For the VAX, the shortest two call sequence is:
106 * calls $0,(r0)
107 * calls $0,(r0)
109 * which is separated by only three bytes, thus HASHFRACTION is
110 * calculated as:
112 * HASHFRACTION = 3 / (2 * 2 - 1) = 1
114 * Note that the division above rounds down, thus if MIN_SUBR_FRACTION
115 * is less than three, this algorithm will not work!
117 #define HASHFRACTION 1
120 * Percent of text space to allocate for tostructs with a minimum:
122 #define ARCDENSITY 2
123 #define MINARCS 50
125 struct tostruct
127 char *selfpc;
128 int count;
129 unsigned short link;
133 * A raw arc, with pointers to the calling site and the called site
134 * and a count. Everything is defined in terms of characters so
135 * as to get a packed representation (otherwise, different compilers
136 * might introduce different padding):
139 /* *INDENT-OFF* */
140 /* For documentation purposes only.
142 struct raw_arc
144 char from_pc[sizeof(void *)];
145 char self_pc[sizeof(void *)];
146 char count[sizeof(long)];
149 /* *INDENT-ON* */
152 * General rounding functions:
154 #define ROUNDDOWN(x,y) (((x)/(y))*(y))
155 #define ROUNDUP(x,y) ((((x)+(y)-1)/(y))*(y))
157 #endif /* gmon_h */