profile.h 1.4 KiB raw
1
#ifndef PROFILE_H
2
#define PROFILE_H
3
4
#include "types.h"
5
6
struct debug_map;
7
8
/* A range word stores the absolute PC in its low 24 bits and the
9
 * instruction count minus one in its high byte. Hosted text ends below
10
 * 16 MiB. The interpreter uses an escape followed by a full PC for a
11
 * single instruction outside this range. */
12
#define PROFILE_PC_BITS   24
13
#define PROFILE_PC_MASK   ((1u << PROFILE_PC_BITS) - 1)
14
#define PROFILE_PC_ESCAPE U32_MAX
15
16
/* State of one hosted execution profile. */
17
struct profile;
18
19
/* Start an instruction profile. Write folded stacks and PC counts if prefix
20
 * is set. Write ordered PC ranges if trace is set. Report each invocation
21
 * of function if set. The image and debug map stay valid until close. */
22
struct profile *profile_open(
23
    const char             *program,
24
    const u8               *memory,
25
    u32                     base,
26
    u32                     bytes,
27
    const struct debug_map *debug,
28
    const char             *prefix,
29
    const char             *trace,
30
    const char             *function
31
);
32
33
/* Read ranges in execution order. Keep the last range's transfer pending
34
 * until the next PC is known. */
35
void profile_record(struct profile *profile, const u32 *ranges, const u32 *end);
36
37
/* Write reports and free the profile. If the final instruction had a known
38
 * continuation, next_pc is its target, including zero for a hosted return. */
39
bool profile_close(struct profile *profile, u32 next_pc, bool continued);
40
41
#endif