[thirdparty/binutils-gdb.git] / gdb / compile / compile.h

/* Header file for Compile and inject module.

   Copyright (C) 2014-2019 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

struct ui_file;
struct gdbarch;
struct dwarf2_per_cu_data;
struct symbol;
struct dynamic_prop;

/* 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.  */

extern void compile_dwarf_expr_to_c (string_file *stream,
				     const char *result_name,
				     struct symbol *sym,
				     CORE_ADDR pc,
				     struct gdbarch *arch,
				     unsigned char *registers_used,
				     unsigned int addr_size,
				     const gdb_byte *op_ptr,
				     const gdb_byte *op_end,
				     struct dwarf2_per_cu_data *per_cu);

/* 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.  */

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,
				       unsigned char *registers_used,
				       unsigned int addr_size,
				       const gdb_byte *op_ptr,
				       const gdb_byte *op_end,
				       struct dwarf2_per_cu_data *per_cu);

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 */
Commit	Line	Data
bb2ec1b3 TT	1	/* Header file for Compile and inject module.
bb2ec1b3 TT	2
42a4f53d	3	Copyright (C) 2014-2019 Free Software Foundation, Inc.
bb2ec1b3 TT	4
	5	This program is free software; you can redistribute it and/or modify
	6	it under the terms of the GNU General Public License as published by
	7	the Free Software Foundation; either version 3 of the License, or
	8	(at your option) any later version.
	9
	10	This program is distributed in the hope that it will be useful,
	11	but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	13	GNU General Public License for more details.
	14
	15	You should have received a copy of the GNU General Public License
	16	along with this program. If not, see <http://www.gnu.org/licenses/>. */
	17
1a5c2598 TT	18	#ifndef COMPILE_COMPILE_H
1a5c2598 TT	19	#define COMPILE_COMPILE_H
bb2ec1b3 TT	20
	21	struct ui_file;
	22	struct gdbarch;
	23	struct dwarf2_per_cu_data;
	24	struct symbol;
	25	struct dynamic_prop;
	26
	27	/* Public function that is called from compile_control case in the
	28	expression command. GDB returns either a CMD, or a CMD_STRING, but
	29	never both. */
	30
851c9091 JK	31	extern void eval_compile_command (struct command_line *cmd,
851c9091 JK	32	const char *cmd_string,
5c65b58a JK	33	enum compile_i_scope_types scope,
5c65b58a JK	34	void *scope_data);
bb2ec1b3 TT	35
	36	/* Compile a DWARF location expression to C, suitable for use by the
	37	compiler.
	38
	39	STREAM is the stream where the code should be written.
	40
	41	RESULT_NAME is the name of a variable in the resulting C code. The
	42	result of the expression will be assigned to this variable.
	43
	44	SYM is the symbol corresponding to this expression.
	45	PC is the location at which the expression is being evaluated.
	46	ARCH is the architecture to use.
	47
	48	REGISTERS_USED is an out parameter which is updated to note which
	49	registers were needed by this expression.
	50
	51	ADDR_SIZE is the DWARF address size to use.
	52
	53	OPT_PTR and OP_END are the bounds of the DWARF expression.
	54
	55	PER_CU is the per-CU object used for looking up various other
	56	things. */
	57
d82b3862	58	extern void compile_dwarf_expr_to_c (string_file *stream,
bb2ec1b3 TT	59	const char *result_name,
	60	struct symbol *sym,
	61	CORE_ADDR pc,
	62	struct gdbarch *arch,
	63	unsigned char *registers_used,
	64	unsigned int addr_size,
	65	const gdb_byte *op_ptr,
	66	const gdb_byte *op_end,
	67	struct dwarf2_per_cu_data *per_cu);
	68
	69	/* Compile a DWARF bounds expression to C, suitable for use by the
	70	compiler.
	71
	72	STREAM is the stream where the code should be written.
	73
	74	RESULT_NAME is the name of a variable in the resulting C code. The
	75	result of the expression will be assigned to this variable.
	76
	77	PROP is the dynamic property for which we're compiling.
	78
	79	SYM is the symbol corresponding to this expression.
	80	PC is the location at which the expression is being evaluated.
	81	ARCH is the architecture to use.
	82
	83	REGISTERS_USED is an out parameter which is updated to note which
	84	registers were needed by this expression.
	85
	86	ADDR_SIZE is the DWARF address size to use.
	87
	88	OPT_PTR and OP_END are the bounds of the DWARF expression.
	89
	90	PER_CU is the per-CU object used for looking up various other
	91	things. */
	92
d82b3862	93	extern void compile_dwarf_bounds_to_c (string_file *stream,
bb2ec1b3 TT	94	const char *result_name,
	95	const struct dynamic_prop *prop,
	96	struct symbol *sym, CORE_ADDR pc,
	97	struct gdbarch *arch,
	98	unsigned char *registers_used,
	99	unsigned int addr_size,
	100	const gdb_byte *op_ptr,
	101	const gdb_byte *op_end,
	102	struct dwarf2_per_cu_data *per_cu);
	103
36de76f9 JK	104	extern void compile_print_value (struct value val, void data_voidp);
36de76f9 JK	105
8588b356 SM	106	/* Command element for the 'compile' command. */
	107	extern cmd_list_element *compile_cmd_element;
	108
1a5c2598	109	#endif /* COMPILE_COMPILE_H */