734b0e4bda
Add a structure to hold the branch trace data and an enum to describe the format of that data. So far, only BTS is supported. Also added a NONE format to indicate that no branch trace data is available. This will make it easier to support different branch trace formats in the future. 2015-02-09 Markus Metzger <markus.t.metzger@intel.com> * Makefile.in (SFILES): Add common/btrace-common.c. (COMMON_OBS): Add common/btrace-common.o. (btrace-common.o): Add build rules. * btrace.c (parse_xml_btrace): Update parameters. (parse_xml_btrace_block): Set format field. (btrace_add_pc, btrace_fetch): Use struct btrace_data. (do_btrace_data_cleanup, make_cleanup_btrace_data): New. (btrace_compute_ftrace): Split into this and... (btrace_compute_ftrace_bts): ...this. (btrace_stitch_trace): Split into this and... (btrace_stitch_bts): ...this. * btrace.h (parse_xml_btrace): Update parameters. (make_cleanup_btrace_data): New. * common/btrace-common.c: New. * common/btrace-common.h: Include common-defs.h. (btrace_block_s): Update comment. (btrace_format): New. (btrace_format_string): New. (btrace_data_bts): New. (btrace_data): New. (btrace_data_init, btrace_data_fini, btrace_data_empty): New. * remote.c (remote_read_btrace): Update parameters. * target.c (target_read_btrace): Update parameters. * target.h (target_read_btrace): Update parameters. (target_ops)<to_read_btrace>: Update parameters. * x86-linux-nat.c (x86_linux_read_btrace): Update parameters. * target-delegates.c: Regenerate. * target-debug (target_debug_print_struct_btrace_data_p): New. * nat/linux-btrace.c (linux_read_btrace): Split into this and... (linux_read_bts): ...this. * nat/linux-btrace.h (linux_read_btrace): Update parameters. gdbserver/ * Makefile.in (SFILES): Add common/btrace-common.c. (OBS): Add common/btrace-common.o. (btrace-common.o): Add build rules. * linux-low: Include btrace-common.h. (linux_low_read_btrace): Use struct btrace_data. Call btrace_data_init and btrace_data_fini.
132 lines
3.7 KiB
C
132 lines
3.7 KiB
C
/* Branch trace support for GDB, the GNU debugger.
|
|
|
|
Copyright (C) 2013-2015 Free Software Foundation, Inc.
|
|
|
|
Contributed by Intel Corp. <markus.t.metzger@intel.com>.
|
|
|
|
This file is part of GDB.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program 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 General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef BTRACE_COMMON_H
|
|
#define BTRACE_COMMON_H
|
|
|
|
/* Branch tracing (btrace) is a per-thread control-flow execution trace of the
|
|
inferior. For presentation purposes, the branch trace is represented as a
|
|
list of sequential control-flow blocks, one such list per thread. */
|
|
|
|
#include "vec.h"
|
|
|
|
/* A branch trace block.
|
|
|
|
This represents a block of sequential control-flow. Adjacent blocks will be
|
|
connected via calls, returns, or jumps. The latter can be direct or
|
|
indirect, conditional or unconditional. Branches can further be
|
|
asynchronous, e.g. interrupts. */
|
|
struct btrace_block
|
|
{
|
|
/* The address of the first byte of the first instruction in the block.
|
|
The address may be zero if we do not know the beginning of this block,
|
|
such as for the first block in a delta trace. */
|
|
CORE_ADDR begin;
|
|
|
|
/* The address of the first byte of the last instruction in the block. */
|
|
CORE_ADDR end;
|
|
};
|
|
|
|
/* Define functions operating on a vector of branch trace blocks. */
|
|
typedef struct btrace_block btrace_block_s;
|
|
DEF_VEC_O (btrace_block_s);
|
|
|
|
/* Enumeration of btrace formats. */
|
|
|
|
enum btrace_format
|
|
{
|
|
/* No branch trace format. */
|
|
BTRACE_FORMAT_NONE,
|
|
|
|
/* Branch trace is in Branch Trace Store (BTS) format.
|
|
Actually, the format is a sequence of blocks derived from BTS. */
|
|
BTRACE_FORMAT_BTS
|
|
};
|
|
|
|
/* Branch trace in BTS format. */
|
|
struct btrace_data_bts
|
|
{
|
|
/* Branch trace is represented as a vector of branch trace blocks starting
|
|
with the most recent block. */
|
|
VEC (btrace_block_s) *blocks;
|
|
};
|
|
|
|
/* The branch trace data. */
|
|
struct btrace_data
|
|
{
|
|
enum btrace_format format;
|
|
|
|
union
|
|
{
|
|
/* Format == BTRACE_FORMAT_BTS. */
|
|
struct btrace_data_bts bts;
|
|
} variant;
|
|
};
|
|
|
|
/* Target specific branch trace information. */
|
|
struct btrace_target_info;
|
|
|
|
/* Enumeration of btrace read types. */
|
|
|
|
enum btrace_read_type
|
|
{
|
|
/* Send all available trace. */
|
|
BTRACE_READ_ALL,
|
|
|
|
/* Send all available trace, if it changed. */
|
|
BTRACE_READ_NEW,
|
|
|
|
/* Send the trace since the last request. This will fail if the trace
|
|
buffer overflowed. */
|
|
BTRACE_READ_DELTA
|
|
};
|
|
|
|
/* Enumeration of btrace errors. */
|
|
|
|
enum btrace_error
|
|
{
|
|
/* No error. Everything is OK. */
|
|
BTRACE_ERR_NONE,
|
|
|
|
/* An unknown error. */
|
|
BTRACE_ERR_UNKNOWN,
|
|
|
|
/* Branch tracing is not supported on this system. */
|
|
BTRACE_ERR_NOT_SUPPORTED,
|
|
|
|
/* The branch trace buffer overflowed; no delta read possible. */
|
|
BTRACE_ERR_OVERFLOW
|
|
};
|
|
|
|
/* Return a string representation of FORMAT. */
|
|
extern const char *btrace_format_string (enum btrace_format format);
|
|
|
|
/* Initialize DATA. */
|
|
extern void btrace_data_init (struct btrace_data *data);
|
|
|
|
/* Cleanup DATA. */
|
|
extern void btrace_data_fini (struct btrace_data *data);
|
|
|
|
/* Return non-zero if DATA is empty; zero otherwise. */
|
|
extern int btrace_data_empty (struct btrace_data *data);
|
|
|
|
#endif /* BTRACE_COMMON_H */
|