#include "llvm/MC/MCDwarf.h"

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

Public Member Functions
OpType	getOperation () const

MCSymbol *	getLabel () const

unsigned	getRegister () const

unsigned	getRegister2 () const

unsigned	getAddressSpace () const

int	getOffset () const

StringRef	getValues () const

StringRef	getComment () const

SMLoc	getLoc () const

Static Public Member Functions
static MCCFIInstruction	cfiDefCfa (MCSymbol *L, unsigned Register, int 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, int Offset, SMLoc Loc={})
	.cfi_def_cfa_offset modifies a rule for computing CFA.

static MCCFIInstruction	createAdjustCfaOffset (MCSymbol *L, int 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, int 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, int Offset, SMLoc Loc={})
	.cfi_offset Previous value of Register is saved at offset Offset from CFA.

static MCCFIInstruction	createRelOffset (MCSymbol *L, unsigned Register, int 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	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, int Size, SMLoc Loc={})
	A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.

Detailed Description

Definition at line 483 of file MCDwarf.h.

Member Enumeration Documentation

◆ OpType

enum llvm::MCCFIInstruction::OpType

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

Definition at line 485 of file MCDwarf.h.

Member Function Documentation

◆ cfiDefCfa()

static MCCFIInstruction llvm::MCCFIInstruction::cfiDefCfa	(	MCSymbol *	L,
		unsigned	Register,
		int	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 540 of file MCDwarf.h.

Referenced by createAArch64MCAsmInfo(), createARCMCAsmInfo(), createARMMCAsmInfo(), createCSKYMCAsmInfo(), llvm::createDefCFA(), createHexagonMCAsmInfo(), createLoongArchMCAsmInfo(), createM68kMCAsmInfo(), createMSP430MCAsmInfo(), createPPCMCAsmInfo(), createRISCVMCAsmInfo(), createSparcMCAsmInfo(), createSparcV9MCAsmInfo(), createSystemZMCAsmInfo(), createVEMCAsmInfo(), createX86MCAsmInfo(), createXCoreMCAsmInfo(), llvm::MCStreamer::emitCFIDefCfa(), emitDefineCFAWithFP(), llvm::AArch64FrameLowering::emitEpilogue(), llvm::MSP430FrameLowering::emitEpilogue(), llvm::X86FrameLowering::emitEpilogue(), llvm::ARMFrameLowering::emitPrologue(), llvm::Thumb1FrameLowering::emitPrologue(), llvm::LoongArchFrameLowering::emitPrologue(), llvm::RISCVFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), llvm::PPCFrameLowering::inlineStackProbe(), and llvm::AArch64FrameLowering::resetCFIToInitialState().

◆ cfiDefCfaOffset()

static MCCFIInstruction llvm::MCCFIInstruction::cfiDefCfaOffset	(	MCSymbol *	L,
		int	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 555 of file MCDwarf.h.

◆ createAdjustCfaOffset()

static MCCFIInstruction llvm::MCCFIInstruction::createAdjustCfaOffset	(	MCSymbol *	L,
		int	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 563 of file MCDwarf.h.

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

◆ createDefCfaRegister()

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

◆ createEscape()

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

Referenced by llvm::createCFAOffset(), createDefCFAExpression(), llvm::X86FrameLowering::emitCalleeSavedFrameMoves(), llvm::MCStreamer::emitCFIEscape(), llvm::X86FrameLowering::emitPrologue(), emitSCSPrologue(), and emitShadowCallStackPrologue().

◆ createGnuArgsSize()

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

inlinestatic

A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.

Definition at line 652 of file MCDwarf.h.

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

◆ createLLVMDefAspaceCfa()

static MCCFIInstruction llvm::MCCFIInstruction::createLLVMDefAspaceCfa	(	MCSymbol *	L,
		unsigned	Register,
		int	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 572 of file MCDwarf.h.

References Offset, and OpLLVMDefAspaceCfa.

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

◆ createNegateRAState()

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

inlinestatic

.cfi_negate_ra_state AArch64 negate RA state.

Definition at line 608 of file MCDwarf.h.

Referenced by llvm::AArch64FrameLowering::authenticateLR(), llvm::MCStreamer::emitCFINegateRAState(), llvm::AArch64FrameLowering::resetCFIToInitialState(), and llvm::AArch64FrameLowering::signLR().

◆ createOffset()

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

inlinestatic

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

Definition at line 582 of file MCDwarf.h.

◆ createRegister()

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

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

◆ createRelOffset()

static MCCFIInstruction llvm::MCCFIInstruction::createRelOffset	(	MCSymbol *	L,
		unsigned	Register,
		int	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 590 of file MCDwarf.h.

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

◆ createRememberState()

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

inlinestatic

.cfi_remember_state Save all current rules for all registers.

Definition at line 635 of file MCDwarf.h.

Referenced by llvm::MCStreamer::emitCFIRememberState(), and llvm::CFIFixup::runOnMachineFunction().

◆ createRestore()

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

Referenced by llvm::MSP430FrameLowering::emitCalleeSavedFrameMoves(), llvm::X86FrameLowering::emitCalleeSavedFrameMoves(), emitCalleeSavedRestores(), llvm::MCStreamer::emitCFIRestore(), llvm::MSP430FrameLowering::emitEpilogue(), llvm::X86FrameLowering::emitEpilogue(), emitSCSEpilogue(), and emitShadowCallStackEpilogue().