#include "llvm/MC/MCDwarf.h"

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 509 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 511 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 585 of file MCDwarf.h.

References Offset, and Register.

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 600 of file MCDwarf.h.

References 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 608 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 592 of file MCDwarf.h.

References Register.

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 697 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 703 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 708 of file MCDwarf.h.

References CfiLabel, and 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 617 of file MCDwarf.h.

References AddressSpace, Offset, OpLLVMDefAspaceCfa, and Register.

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 653 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 658 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 627 of file MCDwarf.h.

References Offset, and Register.

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 642 of file MCDwarf.h.

References Register2.

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 635 of file MCDwarf.h.

References Offset, and Register.

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 686 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 666 of file MCDwarf.h.

References Register.

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 691 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 680 of file MCDwarf.h.

References Register.

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 673 of file MCDwarf.h.

References Register.

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 715 of file MCDwarf.h.

References Offset, and Register.

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 648 of file MCDwarf.h.

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

◆ getAddressSpace()

unsigned llvm::MCCFIInstruction::getAddressSpace ( ) const

inline

Definition at line 740 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 755 of file MCDwarf.h.

References assert(), and OpLabel.

◆ getComment()

StringRef llvm::MCCFIInstruction::getComment ( ) const

inline

Definition at line 765 of file MCDwarf.h.

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

◆ getLabel()

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

inline

Definition at line 721 of file MCDwarf.h.

Referenced by printCFI().

◆ getLoc()

SMLoc llvm::MCCFIInstruction::getLoc ( ) const

inline

Definition at line 766 of file MCDwarf.h.

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

◆ getOffset()

int64_t llvm::MCCFIInstruction::getOffset ( ) const

inline

Definition at line 745 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 720 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 723 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 735 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 760 of file MCDwarf.h.

References assert(), and OpEscape.

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

Member Data Documentation

◆ AddressSpace

unsigned llvm::MCCFIInstruction::AddressSpace

Definition at line 544 of file MCDwarf.h.

Referenced by createLLVMDefAspaceCfa().

◆ CfiLabel

MCSymbol* llvm::MCCFIInstruction::CfiLabel

Definition at line 550 of file MCDwarf.h.

Referenced by createLabel().

◆ Offset

int64_t llvm::MCCFIInstruction::Offset

Definition at line 539 of file MCDwarf.h.

Referenced by cfiDefCfa(), cfiDefCfaOffset(), createLLVMDefAspaceCfa(), createOffset(), createRelOffset(), and createValOffset().

◆ Register

unsigned llvm::MCCFIInstruction::Register

Definition at line 538 of file MCDwarf.h.

Referenced by cfiDefCfa(), createDefCfaRegister(), createLLVMDefAspaceCfa(), createOffset(), createRelOffset(), createRestore(), createSameValue(), createUndefined(), and createValOffset().

◆ Register2

unsigned llvm::MCCFIInstruction::Register2

Definition at line 548 of file MCDwarf.h.

Referenced by createRegister().

◆ [struct]

struct { ... } llvm::MCCFIInstruction::RI

◆ [struct]

struct { ... } llvm::MCCFIInstruction::RIA

◆ [struct]

struct { ... } llvm::MCCFIInstruction::RR

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

include/llvm/MC/MCDwarf.h

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()

Member Data Documentation

◆ AddressSpace

◆ CfiLabel

◆ Offset

◆ Register

◆ Register2

◆ [struct]

◆ [struct]

◆ [struct]