mirror of
https://github.com/bminor/binutils-gdb.git
synced 2025-11-16 12:34:43 +00:00
887373a45f
CFI_escape is most commonly used to include DWARF expressions in the
unwind information. One may also use CFI_escape to add OS-specific CFI
opcodes. Up until now, SFrame generation process would skip generating
SFrame FDE at the mere sight of a CFI_escape opcode.
Fine tune the handling of CFI_escape for SFrame generation by explicitly
checking for few "harmless" (in context of SFrame generation)
CFI_escape DWARF info:
- DW_CFA_expression affecting registers of no significance to SFrame
stack trace info
- DW_CFA_value_offset affecting registers of no significance to SFrame
stack trace info
Expose the current cfi_escape_data structure in dw2gencfi.c to the
relevant header file to allow SFrame generation APIs to use it too.
Valid unwind info may be split across multiple .cfi_escape directives.
Conversely, it is also allowed to simply put multiple DWARF expressions
and/or operations in a single .cfi_escape directive. Handling all of
these cases correctly will need parsing/processing that is not deemed
worth the effort in context of SFrame generation; We continue to skip
generating SFrame FDE for these cases and warn the user.
In future, SFrame stack trace format may support non-SP/FP as base
register (albeit in limited form). Add an explicit check in
sframe_xlate_do_escape_expr (to test against the current CFA register)
to ensure the functionality continues to work.
Use differentiated warning text in sframe_xlate_do_val_offset to avoid
confusion to the user as the same function is used for handling
.cfi_val_offset and .cfi_escape DW_CFA_val_offset,...
Also, add a common test with DWARF reg 12 which is non SP / FP on x86_64
and aarch64 (and s390x too).
gas/
* gas/dw2gencfi.c (struct cfi_escape_data): Move from ...
* gas/dw2gencfi.h (struct cfi_escape_data): ... to.
* gas/gen-sframe.c (sframe_xlate_do_val_offset): Include string
for .cfi_escape conditionally.
(sframe_xlate_do_escape_expr): New definition.
(sframe_xlate_do_escape_val_offset): Likewise.
(sframe_xlate_do_cfi_escape): Likewise.
(sframe_do_cfi_insn): Handle CFI_escape explicitly.
gas/testsuite/
* gas/cfi-sframe/cfi-sframe.exp: Add new tests.
* gas/cfi-sframe/cfi-sframe-common-9.d: New test.
* gas/cfi-sframe/cfi-sframe-common-9.s: New test.
* gas/cfi-sframe/cfi-sframe-x86_64-empty-1.d: New test.
* gas/cfi-sframe/cfi-sframe-x86_64-empty-1.s: New test.
* gas/cfi-sframe/cfi-sframe-x86_64-empty-2.d: New test.
* gas/cfi-sframe/cfi-sframe-x86_64-empty-2.s: New test.
* gas/cfi-sframe/cfi-sframe-x86_64-empty-3.d: New test.
* gas/cfi-sframe/cfi-sframe-x86_64-empty-3.s: New test.
237 lines
6.1 KiB
C
237 lines
6.1 KiB
C
/* dw2gencfi.h - Support for generating Dwarf2 CFI information.
|
|
Copyright (C) 2003-2025 Free Software Foundation, Inc.
|
|
Contributed by Michal Ludvig <mludvig@suse.cz>
|
|
|
|
This file is part of GAS, the GNU Assembler.
|
|
|
|
GAS 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, or (at your option)
|
|
any later version.
|
|
|
|
GAS 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 GAS; see the file COPYING. If not, write to the Free
|
|
Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
|
|
02110-1301, USA. */
|
|
|
|
#ifndef DW2GENCFI_H
|
|
#define DW2GENCFI_H
|
|
|
|
#include "dwarf2.h"
|
|
|
|
struct symbol;
|
|
struct fde_entry;
|
|
|
|
extern int all_cfi_sections;
|
|
|
|
extern const pseudo_typeS cfi_pseudo_table[];
|
|
|
|
#ifndef tc_cfi_frame_initial_instructions
|
|
#define tc_cfi_frame_initial_instructions() ((void)0)
|
|
#endif
|
|
|
|
#ifndef tc_cfi_startproc
|
|
# define tc_cfi_startproc() ((void)0)
|
|
#endif
|
|
|
|
#ifndef tc_cfi_endproc
|
|
# define tc_cfi_endproc(fde) ((void) (fde))
|
|
#endif
|
|
|
|
/* Parse CFI assembler directive .cfi_sections. This is an external function
|
|
because SCFI functionality also uses the same implementation. */
|
|
extern void dot_cfi_sections (int);
|
|
|
|
/* cfi_finish() is called at the end of file. It will complain if
|
|
the last CFI wasn't properly closed by .cfi_endproc. */
|
|
extern void cfi_finish (void);
|
|
|
|
/* Entry points for backends to add unwind information. */
|
|
extern void cfi_new_fde (struct symbol *);
|
|
extern void cfi_end_fde (struct symbol *);
|
|
extern void cfi_set_last_fde (struct fde_entry *fde);
|
|
extern void cfi_set_return_column (unsigned);
|
|
extern void cfi_set_sections (void);
|
|
extern void cfi_add_advance_loc (struct symbol *);
|
|
extern void cfi_add_label (const char *);
|
|
|
|
extern void cfi_add_CFA_offset (unsigned, offsetT);
|
|
extern void cfi_add_CFA_val_offset (unsigned, offsetT);
|
|
extern void cfi_add_CFA_def_cfa (unsigned, offsetT);
|
|
extern void cfi_add_CFA_register (unsigned, unsigned);
|
|
extern void cfi_add_CFA_def_cfa_register (unsigned);
|
|
extern void cfi_add_CFA_def_cfa_offset (offsetT);
|
|
extern void cfi_add_CFA_restore (unsigned);
|
|
extern void cfi_add_CFA_undefined (unsigned);
|
|
extern void cfi_add_CFA_same_value (unsigned);
|
|
extern void cfi_add_CFA_remember_state (void);
|
|
extern void cfi_add_CFA_restore_state (void);
|
|
|
|
/* Structures for md_cfi_end. */
|
|
|
|
#if defined (TE_PE) || defined (TE_PEP)
|
|
#define SUPPORT_FRAME_LINKONCE 1
|
|
#else
|
|
#define SUPPORT_FRAME_LINKONCE 0
|
|
#endif
|
|
|
|
#ifdef tc_cfi_reloc_for_encoding
|
|
#define SUPPORT_COMPACT_EH 1
|
|
#else
|
|
#define SUPPORT_COMPACT_EH 0
|
|
#endif
|
|
|
|
#ifndef TARGET_MULTIPLE_EH_FRAME_SECTIONS
|
|
#define TARGET_MULTIPLE_EH_FRAME_SECTIONS 0
|
|
#endif
|
|
|
|
#define MULTIPLE_FRAME_SECTIONS (SUPPORT_FRAME_LINKONCE || SUPPORT_COMPACT_EH \
|
|
|| TARGET_MULTIPLE_EH_FRAME_SECTIONS)
|
|
|
|
struct cfi_escape_data
|
|
{
|
|
struct cfi_escape_data *next;
|
|
expressionS exp;
|
|
};
|
|
|
|
struct cfi_insn_data
|
|
{
|
|
struct cfi_insn_data *next;
|
|
#if MULTIPLE_FRAME_SECTIONS
|
|
segT cur_seg;
|
|
#endif
|
|
int insn;
|
|
union
|
|
{
|
|
struct
|
|
{
|
|
unsigned reg;
|
|
offsetT offset;
|
|
} ri;
|
|
|
|
struct
|
|
{
|
|
unsigned reg1;
|
|
unsigned reg2;
|
|
} rr;
|
|
|
|
unsigned r;
|
|
offsetT i;
|
|
|
|
struct
|
|
{
|
|
symbolS *lab1;
|
|
symbolS *lab2;
|
|
} ll;
|
|
|
|
struct cfi_escape_data *esc;
|
|
|
|
struct
|
|
{
|
|
unsigned reg, encoding;
|
|
expressionS exp;
|
|
} ea;
|
|
|
|
const char *sym_name;
|
|
} u;
|
|
};
|
|
|
|
/* An enumeration describing the Compact EH header format. The least
|
|
significant bit is used to distinguish the entries.
|
|
|
|
Inline Compact: Function offset [0]
|
|
Four chars of unwind data.
|
|
Out-of-line Compact: Function offset [1]
|
|
Compact unwind data offset [0]
|
|
Legacy: Function offset [1]
|
|
Unwind data offset [1]
|
|
|
|
The header type is initialized to EH_COMPACT_UNKNOWN until the
|
|
format is discovered by encountering a .fde_data entry.
|
|
Failure to find a .fde_data entry will cause an EH_COMPACT_LEGACY
|
|
header to be generated. */
|
|
|
|
enum {
|
|
EH_COMPACT_UNKNOWN,
|
|
EH_COMPACT_LEGACY,
|
|
EH_COMPACT_INLINE,
|
|
EH_COMPACT_OUTLINE,
|
|
EH_COMPACT_OUTLINE_DONE,
|
|
/* Outline if .cfi_inline_lsda used, otherwise legacy FDE. */
|
|
EH_COMPACT_HAS_LSDA
|
|
};
|
|
|
|
/* Stack of old CFI data, for save/restore. */
|
|
struct cfa_save_data
|
|
{
|
|
struct cfa_save_data *next;
|
|
offsetT cfa_offset;
|
|
};
|
|
|
|
/* Current open FDE entry. */
|
|
struct frch_cfi_data
|
|
{
|
|
struct fde_entry *cur_fde_data;
|
|
symbolS *last_address;
|
|
offsetT cur_cfa_offset;
|
|
struct cfa_save_data *cfa_save_stack;
|
|
};
|
|
|
|
struct fde_entry
|
|
{
|
|
struct fde_entry *next;
|
|
#if MULTIPLE_FRAME_SECTIONS
|
|
segT cur_seg;
|
|
#endif
|
|
symbolS *start_address;
|
|
symbolS *end_address;
|
|
struct cfi_insn_data *data;
|
|
struct cfi_insn_data **last;
|
|
unsigned char per_encoding;
|
|
unsigned char lsda_encoding;
|
|
int personality_id;
|
|
expressionS personality;
|
|
expressionS lsda;
|
|
unsigned int return_column;
|
|
unsigned int signal_frame;
|
|
#if MULTIPLE_FRAME_SECTIONS
|
|
int handled;
|
|
#endif
|
|
int eh_header_type;
|
|
/* Compact unwinding opcodes, not including the PR byte or LSDA. */
|
|
int eh_data_size;
|
|
bfd_byte *eh_data;
|
|
/* For out of line tables and FDEs. */
|
|
symbolS *eh_loc;
|
|
int sections;
|
|
#ifdef tc_fde_entry_extras
|
|
tc_fde_entry_extras
|
|
#endif
|
|
};
|
|
|
|
/* The list of all FDEs that have been collected. */
|
|
extern struct fde_entry *all_fde_data;
|
|
|
|
/* Fake CFI type; outside the byte range of any real CFI insn. */
|
|
#define CFI_adjust_cfa_offset 0x100
|
|
#define CFI_return_column 0x101
|
|
#define CFI_rel_offset 0x102
|
|
#define CFI_escape 0x103
|
|
#define CFI_signal_frame 0x104
|
|
#define CFI_val_encoded_addr 0x105
|
|
#define CFI_label 0x106
|
|
|
|
/* By default emit .eh_frame only, not .debug_frame. */
|
|
#define CFI_EMIT_eh_frame (1 << 0)
|
|
#define CFI_EMIT_debug_frame (1 << 1)
|
|
#define CFI_EMIT_target (1 << 2)
|
|
#define CFI_EMIT_eh_frame_compact (1 << 3)
|
|
#define CFI_EMIT_sframe (1 << 4)
|
|
|
|
#endif /* DW2GENCFI_H */
|