#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

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

static MCCFIInstruction	cfiDefCfaOffset (MCSymbol *L, int Offset)
	.cfi_def_cfa_offset modifies a rule for computing CFA.

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

static MCCFIInstruction	createRelOffset (MCSymbol *L, unsigned Register, int Offset)
	.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)
	.cfi_register Previous value of Register1 is saved in register Register2.

static MCCFIInstruction	createWindowSave (MCSymbol *L)
	.cfi_window_save SPARC register window is saved.

static MCCFIInstruction	createNegateRAState (MCSymbol *L)
	.cfi_negate_ra_state AArch64 negate RA state.

static MCCFIInstruction	createRestore (MCSymbol *L, unsigned Register)
	.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)
	.cfi_undefined From now on the previous value of Register can't be restored anymore.

static MCCFIInstruction	createSameValue (MCSymbol *L, unsigned Register)
	.cfi_same_value Current value of Register is the same as in the previous frame.

static MCCFIInstruction	createRememberState (MCSymbol *L)
	.cfi_remember_state Save all current rules for all registers.

static MCCFIInstruction	createRestoreState (MCSymbol *L)
	.cfi_restore_state Restore the previously saved state.

static MCCFIInstruction	createEscape (MCSymbol *L, StringRef Vals, StringRef Comment="")
	.cfi_escape Allows the user to add arbitrary bytes to the unwind info.

static MCCFIInstruction	createGnuArgsSize (MCSymbol *L, int Size)
	A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.

Detailed Description

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

Member Function Documentation

◆ cfiDefCfa()

static MCCFIInstruction llvm::MCCFIInstruction::cfiDefCfa	(	MCSymbol *	L,
		unsigned	Register,
		int	Offset
	)

inlinestatic

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

Definition at line 533 of file MCDwarf.h.

References Offset, and OpDefCfa.

Referenced by createAArch64MCAsmInfo(), createARCMCAsmInfo(), createARMMCAsmInfo(), createCSKYMCAsmInfo(), llvm::createDefCFA(), createHexagonMCAsmInfo(), createLoongArchMCAsmInfo(), createM68kMCAsmInfo(), createMSP430MCAsmInfo(), createPPCMCAsmInfo(), createRISCVMCAsmInfo(), createSparcMCAsmInfo(), createSparcV9MCAsmInfo(), createSystemZMCAsmInfo(), createVEMCAsmInfo(), createX86MCAsmInfo(), createXCoreMCAsmInfo(), llvm::MCStreamer::emitCFIDefCfa(), llvm::AArch64FrameLowering::emitEpilogue(), llvm::MSP430FrameLowering::emitEpilogue(), llvm::X86FrameLowering::emitEpilogue(), llvm::AArch64FrameLowering::emitPrologue(), 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
	)

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

References Offset, and OpDefCfaOffset.

◆ createAdjustCfaOffset()

static MCCFIInstruction llvm::MCCFIInstruction::createAdjustCfaOffset	(	MCSymbol *	L,
		int	Adjustment
	)

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

References OpAdjustCfaOffset.

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
	)

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

References OpDefCfaRegister.

◆ createEscape()

static MCCFIInstruction llvm::MCCFIInstruction::createEscape	(	MCSymbol *	L,
		StringRef	Vals,
		StringRef	Comment = `""`
	)

inlinestatic

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

Definition at line 632 of file MCDwarf.h.

References OpEscape.

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
	)

inlinestatic

A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.

Definition at line 638 of file MCDwarf.h.

References OpGnuArgsSize, and Size.

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
	)

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

References Offset, and OpLLVMDefAspaceCfa.

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

◆ createNegateRAState()

static MCCFIInstruction llvm::MCCFIInstruction::createNegateRAState ( MCSymbol * L )

inlinestatic

.cfi_negate_ra_state AArch64 negate RA state.

Definition at line 597 of file MCDwarf.h.

References OpNegateRAState.

Referenced by llvm::MCStreamer::emitCFINegateRAState(), llvm::AArch64FrameLowering::emitPrologue(), InsertReturnAddressAuth(), llvm::AArch64FrameLowering::resetCFIToInitialState(), and signOutlinedFunction().

◆ createOffset()

static MCCFIInstruction llvm::MCCFIInstruction::createOffset	(	MCSymbol *	L,
		unsigned	Register,
		int	Offset
	)

inlinestatic

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

Definition at line 571 of file MCDwarf.h.

References Offset, and OpOffset.

◆ createRegister()

static MCCFIInstruction llvm::MCCFIInstruction::createRegister	(	MCSymbol *	L,
		unsigned	Register1,
		unsigned	Register2
	)

inlinestatic

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

Definition at line 586 of file MCDwarf.h.

References OpRegister, and Register2.

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

◆ createRelOffset()

static MCCFIInstruction llvm::MCCFIInstruction::createRelOffset	(	MCSymbol *	L,
		unsigned	Register,
		int	Offset
	)

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

References Offset, and OpRelOffset.

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

◆ createRememberState()

static MCCFIInstruction llvm::MCCFIInstruction::createRememberState ( MCSymbol * L )

inlinestatic

.cfi_remember_state Save all current rules for all registers.

Definition at line 621 of file MCDwarf.h.

References OpRememberState.

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

◆ createRestore()

static MCCFIInstruction llvm::MCCFIInstruction::createRestore	(	MCSymbol *	L,
		unsigned	Register
	)

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

References OpRestore.

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