#include "llvm/MC/MCDwarf.h"

Classes
struct	CommonFields
struct	EscapeFields
struct	LabelFields

Public Types
enum	OpType : uint8_t { OpSameValue , OpRememberState , OpRestoreState , OpOffset , OpLLVMDefAspaceCfa , OpDefCfaRegister , OpDefCfaOffset , OpDefCfa , OpRelOffset , OpAdjustCfaOffset , OpEscape , OpRestore , OpUndefined , OpRegister , OpWindowSave , OpNegateRAState , OpNegateRAStateWithPC , OpGnuArgsSize , OpLabel , OpValOffset }

Public Member Functions
OpType	getOperation () const
MCSymbol *	getLabel () const
unsigned	getRegister () const
unsigned	getRegister2 () const
unsigned	getAddressSpace () const
int64_t	getOffset () const
MCSymbol *	getCfiLabel () const
StringRef	getValues () const
StringRef	getComment () const
SMLoc	getLoc () const

Static Public Member Functions
static MCCFIInstruction	cfiDefCfa (MCSymbol *L, unsigned Register, int64_t Offset, SMLoc Loc={})
	.cfi_def_cfa defines a rule for computing CFA as: take address from Register and add Offset to it.
static MCCFIInstruction	createDefCfaRegister (MCSymbol *L, unsigned Register, SMLoc Loc={})
	.cfi_def_cfa_register modifies a rule for computing CFA.
static MCCFIInstruction	cfiDefCfaOffset (MCSymbol *L, int64_t Offset, SMLoc Loc={})
	.cfi_def_cfa_offset modifies a rule for computing CFA.
static MCCFIInstruction	createAdjustCfaOffset (MCSymbol *L, int64_t Adjustment, SMLoc Loc={})
	.cfi_adjust_cfa_offset Same as .cfi_def_cfa_offset, but Offset is a relative value that is added/subtracted from the previous offset.
static MCCFIInstruction	createLLVMDefAspaceCfa (MCSymbol *L, unsigned Register, int64_t Offset, unsigned AddressSpace, SMLoc Loc)
	.cfi_llvm_def_aspace_cfa defines the rule for computing the CFA to be the result of evaluating the DWARF operation expression DW_OP_constu AS; DW_OP_aspace_bregx R, B as a location description.
static MCCFIInstruction	createOffset (MCSymbol *L, unsigned Register, int64_t Offset, SMLoc Loc={})
	.cfi_offset Previous value of Register is saved at offset Offset from CFA.
static MCCFIInstruction	createRelOffset (MCSymbol *L, unsigned Register, int64_t Offset, SMLoc Loc={})
	.cfi_rel_offset Previous value of Register is saved at offset Offset from the current CFA register.
static MCCFIInstruction	createRegister (MCSymbol *L, unsigned Register1, unsigned Register2, SMLoc Loc={})
	.cfi_register Previous value of Register1 is saved in register Register2.
static MCCFIInstruction	createWindowSave (MCSymbol *L, SMLoc Loc={})
	.cfi_window_save SPARC register window is saved.
static MCCFIInstruction	createNegateRAState (MCSymbol *L, SMLoc Loc={})
	.cfi_negate_ra_state AArch64 negate RA state.
static MCCFIInstruction	createNegateRAStateWithPC (MCSymbol *L, SMLoc Loc={})
	.cfi_negate_ra_state_with_pc AArch64 negate RA state with PC.
static MCCFIInstruction	createRestore (MCSymbol *L, unsigned Register, SMLoc Loc={})
	.cfi_restore says that the rule for Register is now the same as it was at the beginning of the function, after all initial instructions added by .cfi_startproc were executed.
static MCCFIInstruction	createUndefined (MCSymbol *L, unsigned Register, SMLoc Loc={})
	.cfi_undefined From now on the previous value of Register can't be restored anymore.
static MCCFIInstruction	createSameValue (MCSymbol *L, unsigned Register, SMLoc Loc={})
	.cfi_same_value Current value of Register is the same as in the previous frame.
static MCCFIInstruction	createRememberState (MCSymbol *L, SMLoc Loc={})
	.cfi_remember_state Save all current rules for all registers.
static MCCFIInstruction	createRestoreState (MCSymbol *L, SMLoc Loc={})
	.cfi_restore_state Restore the previously saved state.
static MCCFIInstruction	createEscape (MCSymbol *L, StringRef Vals, SMLoc Loc={}, StringRef Comment="")
	.cfi_escape Allows the user to add arbitrary bytes to the unwind info.
static MCCFIInstruction	createGnuArgsSize (MCSymbol *L, int64_t Size, SMLoc Loc={})
	A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.
static MCCFIInstruction	createLabel (MCSymbol L, MCSymbol CfiLabel, SMLoc Loc)
static MCCFIInstruction	createValOffset (MCSymbol *L, unsigned Register, int64_t Offset, SMLoc Loc={})
	.cfi_val_offset Previous value of Register is offset Offset from the current CFA register.

Detailed Description

Definition at line 510 of file MCDwarf.h.

Member Enumeration Documentation

◆ OpType

enum llvm::MCCFIInstruction::OpType : uint8_t

Enumerator
OpSameValue
OpRememberState
OpRestoreState
OpOffset
OpLLVMDefAspaceCfa
OpDefCfaRegister
OpDefCfaOffset
OpDefCfa
OpRelOffset
OpAdjustCfaOffset
OpEscape
OpRestore
OpUndefined
OpRegister
OpWindowSave
OpNegateRAState
OpNegateRAStateWithPC
OpGnuArgsSize
OpLabel
OpValOffset

Definition at line 512 of file MCDwarf.h.

Member Function Documentation

◆ cfiDefCfa()

MCCFIInstruction llvm::MCCFIInstruction::cfiDefCfa	(	MCSymbol *	L,
		unsigned	Register,
		int64_t	Offset,
		SMLoc	Loc = {} )

inlinestatic

.cfi_def_cfa defines a rule for computing CFA as: take address from Register and add Offset to it.

Definition at line 576 of file MCDwarf.h.

References llvm::Offset.

Referenced by llvm::CFIInstBuilder::buildDefCFA(), createAArch64MCAsmInfo(), createARCMCAsmInfo(), createARMMCAsmInfo(), createCSKYMCAsmInfo(), llvm::createDefCFA(), createHexagonMCAsmInfo(), createLoongArchMCAsmInfo(), createM68kMCAsmInfo(), createMSP430MCAsmInfo(), createPPCMCAsmInfo(), createRISCVMCAsmInfo(), createSparcMCAsmInfo(), createSparcV9MCAsmInfo(), createSystemZMCAsmInfo(), createVEMCAsmInfo(), createX86MCAsmInfo(), createXCoreMCAsmInfo(), llvm::MCStreamer::emitCFIDefCfa(), llvm::MSP430FrameLowering::emitEpilogue(), llvm::X86FrameLowering::emitEpilogue(), llvm::LoongArchFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), llvm::XtensaFrameLowering::emitPrologue(), and llvm::PPCFrameLowering::inlineStackProbe().

◆ cfiDefCfaOffset()

MCCFIInstruction llvm::MCCFIInstruction::cfiDefCfaOffset	(	MCSymbol *	L,
		int64_t	Offset,
		SMLoc	Loc = {} )

inlinestatic

.cfi_def_cfa_offset modifies a rule for computing CFA.

Register remains the same, but offset is new. Note that it is the absolute offset that will be added to a defined register to the compute CFA address.

Definition at line 591 of file MCDwarf.h.

References llvm::Offset.

Referenced by buildCFAOffs(), llvm::CFIInstBuilder::buildDefCFAOffset(), llvm::createDefCFA(), llvm::MCStreamer::emitCFIDefCfaOffset(), EmitDefCfaOffset(), llvm::MSP430FrameLowering::emitEpilogue(), llvm::X86FrameLowering::emitEpilogue(), llvm::ARCFrameLowering::emitPrologue(), llvm::CSKYFrameLowering::emitPrologue(), llvm::LoongArchFrameLowering::emitPrologue(), llvm::M68kFrameLowering::emitPrologue(), llvm::MSP430FrameLowering::emitPrologue(), llvm::PPCFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), and llvm::XtensaFrameLowering::emitPrologue().

◆ createAdjustCfaOffset()

MCCFIInstruction llvm::MCCFIInstruction::createAdjustCfaOffset	(	MCSymbol *	L,
		int64_t	Adjustment,
		SMLoc	Loc = {} )

inlinestatic

.cfi_adjust_cfa_offset Same as .cfi_def_cfa_offset, but Offset is a relative value that is added/subtracted from the previous offset.

Definition at line 599 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildAdjustCFAOffset(), llvm::M68kFrameLowering::eliminateCallFramePseudoInstr(), llvm::X86FrameLowering::eliminateCallFramePseudoInstr(), llvm::MCStreamer::emitCFIAdjustCfaOffset(), and ExpandMOVImmSExti8().

◆ createDefCfaRegister()

MCCFIInstruction llvm::MCCFIInstruction::createDefCfaRegister	(	MCSymbol *	L,
		unsigned	Register,
		SMLoc	Loc = {} )

inlinestatic

.cfi_def_cfa_register modifies a rule for computing CFA.

From now on Register will be used instead of the old one. Offset remains the same.

Definition at line 583 of file MCDwarf.h.

Referenced by buildDefCFAReg(), llvm::CFIInstBuilder::buildDefCFARegister(), createMipsMCAsmInfo(), llvm::MCStreamer::emitCFIDefCfaRegister(), EmitDefCfaRegister(), llvm::CSKYFrameLowering::emitPrologue(), llvm::M68kFrameLowering::emitPrologue(), llvm::MSP430FrameLowering::emitPrologue(), llvm::PPCFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), llvm::XtensaFrameLowering::emitPrologue(), and llvm::PPCFrameLowering::inlineStackProbe().

◆ createEscape()

MCCFIInstruction llvm::MCCFIInstruction::createEscape	(	MCSymbol *	L,
		StringRef	Vals,
		SMLoc	Loc = {},
		StringRef	Comment = "" )

inlinestatic

.cfi_escape Allows the user to add arbitrary bytes to the unwind info.

Definition at line 688 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildEscape(), llvm::createCFAOffset(), createDefCFAExpression(), createDefCFAExpression(), createDefCFAOffset(), llvm::X86FrameLowering::emitCalleeSavedFrameMoves(), llvm::MCStreamer::emitCFIEscape(), and llvm::X86FrameLowering::emitPrologue().

◆ createGnuArgsSize()

MCCFIInstruction llvm::MCCFIInstruction::createGnuArgsSize	(	MCSymbol *	L,
		int64_t	Size,
		SMLoc	Loc = {} )

inlinestatic

A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.

Definition at line 697 of file MCDwarf.h.

References Size.

Referenced by llvm::M68kFrameLowering::eliminateCallFramePseudoInstr(), llvm::X86FrameLowering::eliminateCallFramePseudoInstr(), and llvm::MCStreamer::emitCFIGnuArgsSize().

◆ createLabel()

MCCFIInstruction llvm::MCCFIInstruction::createLabel	(	MCSymbol *	L,
		MCSymbol *	CfiLabel,
		SMLoc	Loc )

inlinestatic

Definition at line 702 of file MCDwarf.h.

References OpLabel.

Referenced by llvm::MCStreamer::emitCFILabelDirective().

◆ createLLVMDefAspaceCfa()

MCCFIInstruction llvm::MCCFIInstruction::createLLVMDefAspaceCfa	(	MCSymbol *	L,
		unsigned	Register,
		int64_t	Offset,
		unsigned	AddressSpace,
		SMLoc	Loc )

inlinestatic

.cfi_llvm_def_aspace_cfa defines the rule for computing the CFA to be the result of evaluating the DWARF operation expression DW_OP_constu AS; DW_OP_aspace_bregx R, B as a location description.

Definition at line 608 of file MCDwarf.h.

References llvm::Offset, and OpLLVMDefAspaceCfa.

Referenced by llvm::MCStreamer::emitCFILLVMDefAspaceCfa().

◆ createNegateRAState()

MCCFIInstruction llvm::MCCFIInstruction::createNegateRAState	(	MCSymbol *	L,
		SMLoc	Loc = {} )

inlinestatic

.cfi_negate_ra_state AArch64 negate RA state.

Definition at line 644 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildNegateRAState(), and llvm::MCStreamer::emitCFINegateRAState().

◆ createNegateRAStateWithPC()

MCCFIInstruction llvm::MCCFIInstruction::createNegateRAStateWithPC	(	MCSymbol *	L,
		SMLoc	Loc = {} )

inlinestatic

.cfi_negate_ra_state_with_pc AArch64 negate RA state with PC.

Definition at line 649 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildNegateRAStateWithPC(), and llvm::MCStreamer::emitCFINegateRAStateWithPC().

◆ createOffset()

MCCFIInstruction llvm::MCCFIInstruction::createOffset	(	MCSymbol *	L,
		unsigned	Register,
		int64_t	Offset,
		SMLoc	Loc = {} )

inlinestatic

.cfi_offset Previous value of Register is saved at offset Offset from CFA.

Definition at line 618 of file MCDwarf.h.

References llvm::Offset.

Referenced by llvm::CFIInstBuilder::buildOffset(), llvm::createCFAOffset(), createM68kMCAsmInfo(), createMSP430MCAsmInfo(), createX86MCAsmInfo(), llvm::DWARFCFIAnalysis::DWARFCFIAnalysis(), llvm::MSP430FrameLowering::emitCalleeSavedFrameMoves(), llvm::X86FrameLowering::emitCalleeSavedFrameMoves(), llvm::X86FrameLowering::emitCalleeSavedFrameMovesFullCFA(), EmitCfiOffset(), llvm::MCStreamer::emitCFIOffset(), llvm::ARCFrameLowering::emitPrologue(), llvm::CSKYFrameLowering::emitPrologue(), llvm::LoongArchFrameLowering::emitPrologue(), llvm::M68kFrameLowering::emitPrologue(), llvm::MSP430FrameLowering::emitPrologue(), llvm::PPCFrameLowering::emitPrologue(), llvm::SystemZELFFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), and llvm::XtensaFrameLowering::emitPrologue().

◆ createRegister()

MCCFIInstruction llvm::MCCFIInstruction::createRegister	(	MCSymbol *	L,
		unsigned	Register1,
		unsigned	Register2,
		SMLoc	Loc = {} )

inlinestatic

.cfi_register Previous value of Register1 is saved in register Register2.

Definition at line 633 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildRegister(), llvm::MCStreamer::emitCFIRegister(), and llvm::PPCFrameLowering::emitPrologue().

◆ createRelOffset()

MCCFIInstruction llvm::MCCFIInstruction::createRelOffset	(	MCSymbol *	L,
		unsigned	Register,
		int64_t	Offset,
		SMLoc	Loc = {} )

inlinestatic

.cfi_rel_offset Previous value of Register is saved at offset Offset from the current CFA register.

This is transformed to .cfi_offset using the known displacement of the CFA register from the CFA.

Definition at line 626 of file MCDwarf.h.

References llvm::Offset.

Referenced by llvm::MCStreamer::emitCFIRelOffset().

◆ createRememberState()

MCCFIInstruction llvm::MCCFIInstruction::createRememberState	(	MCSymbol *	L,
		SMLoc	Loc = {} )

inlinestatic

.cfi_remember_state Save all current rules for all registers.

Definition at line 677 of file MCDwarf.h.

Referenced by llvm::MCStreamer::emitCFIRememberState(), and insertRememberRestorePair().

◆ createRestore()

MCCFIInstruction llvm::MCCFIInstruction::createRestore	(	MCSymbol *	L,
		unsigned	Register,
		SMLoc	Loc = {} )

inlinestatic

.cfi_restore says that the rule for Register is now the same as it was at the beginning of the function, after all initial instructions added by .cfi_startproc were executed.

Definition at line 657 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildRestore(), llvm::MSP430FrameLowering::emitCalleeSavedFrameMoves(), llvm::X86FrameLowering::emitCalleeSavedFrameMoves(), llvm::MCStreamer::emitCFIRestore(), llvm::MSP430FrameLowering::emitEpilogue(), and llvm::X86FrameLowering::emitEpilogue().

◆ createRestoreState()

MCCFIInstruction llvm::MCCFIInstruction::createRestoreState	(	MCSymbol *	L,
		SMLoc	Loc = {} )

inlinestatic

.cfi_restore_state Restore the previously saved state.

Definition at line 682 of file MCDwarf.h.

Referenced by llvm::MCStreamer::emitCFIRestoreState(), and insertRememberRestorePair().

◆ createSameValue()

MCCFIInstruction llvm::MCCFIInstruction::createSameValue	(	MCSymbol *	L,
		unsigned	Register,
		SMLoc	Loc = {} )

inlinestatic

.cfi_same_value Current value of Register is the same as in the previous frame.

I.e., no restoration is needed.

Definition at line 671 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildSameValue(), llvm::DWARFCFIAnalysis::DWARFCFIAnalysis(), and llvm::MCStreamer::emitCFISameValue().

◆ createUndefined()

MCCFIInstruction llvm::MCCFIInstruction::createUndefined	(	MCSymbol *	L,
		unsigned	Register,
		SMLoc	Loc = {} )

inlinestatic

.cfi_undefined From now on the previous value of Register can't be restored anymore.

Definition at line 664 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildUndefined(), llvm::DWARFCFIAnalysis::DWARFCFIAnalysis(), and llvm::MCStreamer::emitCFIUndefined().

◆ createValOffset()

MCCFIInstruction llvm::MCCFIInstruction::createValOffset	(	MCSymbol *	L,
		unsigned	Register,
		int64_t	Offset,
		SMLoc	Loc = {} )

inlinestatic

.cfi_val_offset Previous value of Register is offset Offset from the current CFA register.

Definition at line 709 of file MCDwarf.h.

References llvm::Offset.

Referenced by llvm::MCStreamer::emitCFIValOffset().

◆ createWindowSave()

MCCFIInstruction llvm::MCCFIInstruction::createWindowSave	(	MCSymbol *	L,
		SMLoc	Loc = {} )

inlinestatic

.cfi_window_save SPARC register window is saved.

Definition at line 639 of file MCDwarf.h.

Referenced by llvm::CFIInstBuilder::buildWindowSave(), and llvm::MCStreamer::emitCFIWindowSave().

◆ getAddressSpace()

unsigned llvm::MCCFIInstruction::getAddressSpace ( ) const

inline

Definition at line 731 of file MCDwarf.h.

References assert(), and OpLLVMDefAspaceCfa.

Referenced by llvm::AsmPrinter::emitCFIInstruction(), and printCFI().

◆ getCfiLabel()

MCSymbol * llvm::MCCFIInstruction::getCfiLabel ( ) const

inline

Definition at line 744 of file MCDwarf.h.

References assert(), and OpLabel.

◆ getComment()

StringRef llvm::MCCFIInstruction::getComment ( ) const

inline

Definition at line 755 of file MCDwarf.h.

References assert(), and OpEscape.

Referenced by llvm::AsmPrinter::emitCFIInstruction().

◆ getLabel()

MCSymbol * llvm::MCCFIInstruction::getLabel ( ) const

inline

Definition at line 715 of file MCDwarf.h.

Referenced by printCFI().

◆ getLoc()

SMLoc llvm::MCCFIInstruction::getLoc ( ) const

inline

Definition at line 759 of file MCDwarf.h.

Referenced by llvm::AsmPrinter::emitCFIInstruction().

◆ getOffset()

int64_t llvm::MCCFIInstruction::getOffset ( ) const

inline

Definition at line 736 of file MCDwarf.h.

References assert(), OpAdjustCfaOffset, OpDefCfa, OpDefCfaOffset, OpGnuArgsSize, OpLLVMDefAspaceCfa, OpOffset, OpRelOffset, and OpValOffset.

Referenced by llvm::AsmPrinter::emitCFIInstruction(), and printCFI().

◆ getOperation()

OpType llvm::MCCFIInstruction::getOperation ( ) const

inline

Definition at line 714 of file MCDwarf.h.

Referenced by llvm::X86FrameLowering::BuildCFI(), llvm::AsmPrinter::emitCFIInstruction(), maybeMoveCFI(), and printCFI().

◆ getRegister()

unsigned llvm::MCCFIInstruction::getRegister ( ) const

inline

Definition at line 717 of file MCDwarf.h.

References assert(), OpDefCfa, OpDefCfaRegister, OpLLVMDefAspaceCfa, OpOffset, OpRegister, OpRelOffset, OpRestore, OpSameValue, OpUndefined, and OpValOffset.

Referenced by llvm::AsmPrinter::emitCFIInstruction(), and printCFI().

◆ getRegister2()

unsigned llvm::MCCFIInstruction::getRegister2 ( ) const

inline

Definition at line 726 of file MCDwarf.h.

References assert(), and OpRegister.

Referenced by llvm::AsmPrinter::emitCFIInstruction(), and printCFI().

◆ getValues()

StringRef llvm::MCCFIInstruction::getValues ( ) const

inline

Definition at line 749 of file MCDwarf.h.

References assert(), and OpEscape.

Referenced by llvm::AsmPrinter::emitCFIInstruction(), and printCFI().

The documentation for this class was generated from the following file:

include/llvm/MC/MCDwarf.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ OpType

Member Function Documentation

◆ cfiDefCfa()

◆ cfiDefCfaOffset()

◆ createAdjustCfaOffset()

◆ createDefCfaRegister()

◆ createEscape()

◆ createGnuArgsSize()

◆ createLabel()

◆ createLLVMDefAspaceCfa()

◆ createNegateRAState()

◆ createNegateRAStateWithPC()

◆ createOffset()

◆ createRegister()

◆ createRelOffset()

◆ createRememberState()

◆ createRestore()

◆ createRestoreState()

◆ createSameValue()

◆ createUndefined()

◆ createValOffset()

◆ createWindowSave()

◆ getAddressSpace()

◆ getCfiLabel()

◆ getComment()

◆ getLabel()

◆ getLoc()

◆ getOffset()

◆ getOperation()

◆ getRegister()

◆ getRegister2()

◆ getValues()