mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-01-18 12:24:38 +08:00
5d2c2c84f2
Move it out of defs.h, adjust the includes here and there. Change-Id: I11901fdce55d54f5e51723e123cef154cfb1bbc5 Approved-By: John Baldwin <jhb@FreeBSD.org>
263 lines
8.3 KiB
C++
263 lines
8.3 KiB
C++
/* Header file for Compile and inject module.
|
|
|
|
Copyright (C) 2014-2024 Free Software Foundation, Inc.
|
|
|
|
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 COMPILE_COMPILE_H
|
|
#define COMPILE_COMPILE_H
|
|
|
|
#include "gcc-c-interface.h"
|
|
#include "gdbsupport/gdb-hashtab.h"
|
|
|
|
struct ui_file;
|
|
struct gdbarch;
|
|
struct dwarf2_per_cu_data;
|
|
struct dwarf2_per_objfile;
|
|
struct symbol;
|
|
struct dynamic_prop;
|
|
|
|
/* Scope types enumerator. List the types of scopes the compiler will
|
|
accept. */
|
|
|
|
enum compile_i_scope_types
|
|
{
|
|
COMPILE_I_INVALID_SCOPE,
|
|
|
|
/* A simple scope. Wrap an expression into a simple scope that
|
|
takes no arguments, returns no value, and uses the generic
|
|
function name "_gdb_expr". */
|
|
|
|
COMPILE_I_SIMPLE_SCOPE,
|
|
|
|
/* Do not wrap the expression,
|
|
it has to provide function "_gdb_expr" on its own. */
|
|
COMPILE_I_RAW_SCOPE,
|
|
|
|
/* A printable expression scope. Wrap an expression into a scope
|
|
suitable for the "compile print" command. It uses the generic
|
|
function name "_gdb_expr". COMPILE_I_PRINT_ADDRESS_SCOPE variant
|
|
is the usual one, taking address of the object.
|
|
COMPILE_I_PRINT_VALUE_SCOPE is needed for arrays where the array
|
|
name already specifies its address. See get_out_value_type. */
|
|
COMPILE_I_PRINT_ADDRESS_SCOPE,
|
|
COMPILE_I_PRINT_VALUE_SCOPE,
|
|
};
|
|
|
|
/* An object of this type holds state associated with a given
|
|
compilation job. */
|
|
|
|
class compile_instance
|
|
{
|
|
public:
|
|
compile_instance (struct gcc_base_context *gcc_fe, const char *options);
|
|
|
|
virtual ~compile_instance ()
|
|
{
|
|
m_gcc_fe->ops->destroy (m_gcc_fe);
|
|
}
|
|
|
|
/* Returns the GCC options to be passed during compilation. */
|
|
const std::string &gcc_target_options () const
|
|
{
|
|
return m_gcc_target_options;
|
|
}
|
|
|
|
/* Query the type cache for TYPE, returning the compiler's
|
|
type for it in RET. */
|
|
bool get_cached_type (struct type *type, gcc_type *ret) const;
|
|
|
|
/* Insert GCC_TYPE into the type cache for TYPE.
|
|
|
|
It is ok for a given type to be inserted more than once, provided that
|
|
the exact same association is made each time. */
|
|
void insert_type (struct type *type, gcc_type gcc_type);
|
|
|
|
/* Associate SYMBOL with some error text. */
|
|
void insert_symbol_error (const struct symbol *sym, const char *text);
|
|
|
|
/* Emit the error message corresponding to SYM, if one exists, and
|
|
arrange for it not to be emitted again. */
|
|
void error_symbol_once (const struct symbol *sym);
|
|
|
|
/* These currently just forward to the underlying ops
|
|
vtable. */
|
|
|
|
/* Set the plug-in print callback. */
|
|
void set_print_callback (void (*print_function) (void *, const char *),
|
|
void *datum);
|
|
|
|
/* Return the plug-in's front-end version. */
|
|
unsigned int version () const;
|
|
|
|
/* Set the plug-in's verbosity level. Nop for GCC_FE_VERSION_0. */
|
|
void set_verbose (int level);
|
|
|
|
/* Set the plug-in driver program. Nop for GCC_FE_VERSION_0. */
|
|
void set_driver_filename (const char *filename);
|
|
|
|
/* Set the regular expression used to match the configury triplet
|
|
prefix to the compiler. Nop for GCC_FE_VERSION_0. */
|
|
void set_triplet_regexp (const char *regexp);
|
|
|
|
/* Set compilation arguments. REGEXP is only used for protocol
|
|
version GCC_FE_VERSION_0. */
|
|
gdb::unique_xmalloc_ptr<char> set_arguments (int argc, char **argv,
|
|
const char *regexp = NULL);
|
|
|
|
/* Set the filename of the program to compile. Nop for GCC_FE_VERSION_0. */
|
|
void set_source_file (const char *filename);
|
|
|
|
/* Compile the previously specified source file to FILENAME.
|
|
VERBOSE_LEVEL is only used for protocol version GCC_FE_VERSION_0. */
|
|
bool compile (const char *filename, int verbose_level = -1);
|
|
|
|
/* Set the scope type for this compile. */
|
|
void set_scope (enum compile_i_scope_types scope)
|
|
{
|
|
m_scope = scope;
|
|
}
|
|
|
|
/* Return the scope type. */
|
|
enum compile_i_scope_types scope () const
|
|
{
|
|
return m_scope;
|
|
}
|
|
|
|
/* Set the block to be used for symbol searches. */
|
|
void set_block (const struct block *block)
|
|
{
|
|
m_block = block;
|
|
}
|
|
|
|
/* Return the search block. */
|
|
const struct block *block () const
|
|
{
|
|
return m_block;
|
|
}
|
|
|
|
protected:
|
|
|
|
/* The GCC front end. */
|
|
struct gcc_base_context *m_gcc_fe;
|
|
|
|
/* The "scope" of this compilation. */
|
|
enum compile_i_scope_types m_scope;
|
|
|
|
/* The block in which an expression is being parsed. */
|
|
const struct block *m_block;
|
|
|
|
/* Specify "-std=gnu11", "-std=gnu++11" or similar. These options are put
|
|
after CU's DW_AT_producer compilation options to override them. */
|
|
std::string m_gcc_target_options;
|
|
|
|
/* Map from gdb types to gcc types. */
|
|
htab_up m_type_map;
|
|
|
|
/* Map from gdb symbols to gcc error messages to emit. */
|
|
htab_up m_symbol_err_map;
|
|
};
|
|
|
|
/* Public function that is called from compile_control case in the
|
|
expression command. GDB returns either a CMD, or a CMD_STRING, but
|
|
never both. */
|
|
|
|
extern void eval_compile_command (struct command_line *cmd,
|
|
const char *cmd_string,
|
|
enum compile_i_scope_types scope,
|
|
void *scope_data);
|
|
|
|
/* Compile a DWARF location expression to C, suitable for use by the
|
|
compiler.
|
|
|
|
STREAM is the stream where the code should be written.
|
|
|
|
RESULT_NAME is the name of a variable in the resulting C code. The
|
|
result of the expression will be assigned to this variable.
|
|
|
|
SYM is the symbol corresponding to this expression.
|
|
PC is the location at which the expression is being evaluated.
|
|
ARCH is the architecture to use.
|
|
|
|
REGISTERS_USED is an out parameter which is updated to note which
|
|
registers were needed by this expression.
|
|
|
|
ADDR_SIZE is the DWARF address size to use.
|
|
|
|
OPT_PTR and OP_END are the bounds of the DWARF expression.
|
|
|
|
PER_CU is the per-CU object used for looking up various other
|
|
things.
|
|
|
|
PER_OBJFILE is the per-objfile object also used for looking up various other
|
|
things. */
|
|
|
|
extern void compile_dwarf_expr_to_c (string_file *stream,
|
|
const char *result_name,
|
|
struct symbol *sym,
|
|
CORE_ADDR pc,
|
|
struct gdbarch *arch,
|
|
std::vector<bool> ®isters_used,
|
|
unsigned int addr_size,
|
|
const gdb_byte *op_ptr,
|
|
const gdb_byte *op_end,
|
|
dwarf2_per_cu_data *per_cu,
|
|
dwarf2_per_objfile *per_objfile);
|
|
|
|
/* Compile a DWARF bounds expression to C, suitable for use by the
|
|
compiler.
|
|
|
|
STREAM is the stream where the code should be written.
|
|
|
|
RESULT_NAME is the name of a variable in the resulting C code. The
|
|
result of the expression will be assigned to this variable.
|
|
|
|
PROP is the dynamic property for which we're compiling.
|
|
|
|
SYM is the symbol corresponding to this expression.
|
|
PC is the location at which the expression is being evaluated.
|
|
ARCH is the architecture to use.
|
|
|
|
REGISTERS_USED is an out parameter which is updated to note which
|
|
registers were needed by this expression.
|
|
|
|
ADDR_SIZE is the DWARF address size to use.
|
|
|
|
OPT_PTR and OP_END are the bounds of the DWARF expression.
|
|
|
|
PER_CU is the per-CU object used for looking up various other
|
|
things.
|
|
|
|
PER_OBJFILE is the per-objfile object also used for looking up various other
|
|
things. */
|
|
|
|
extern void compile_dwarf_bounds_to_c (string_file *stream,
|
|
const char *result_name,
|
|
const struct dynamic_prop *prop,
|
|
struct symbol *sym, CORE_ADDR pc,
|
|
struct gdbarch *arch,
|
|
std::vector<bool> ®isters_used,
|
|
unsigned int addr_size,
|
|
const gdb_byte *op_ptr,
|
|
const gdb_byte *op_end,
|
|
dwarf2_per_cu_data *per_cu,
|
|
dwarf2_per_objfile *per_objfile);
|
|
|
|
extern void compile_print_value (struct value *val, void *data_voidp);
|
|
|
|
/* Command element for the 'compile' command. */
|
|
extern cmd_list_element *compile_cmd_element;
|
|
|
|
#endif /* COMPILE_COMPILE_H */
|