diff options
Diffstat (limited to 'llvm/lib/CodeGen/AsmPrinter/DwarfExpression.h')
| -rw-r--r-- | llvm/lib/CodeGen/AsmPrinter/DwarfExpression.h | 51 |
1 files changed, 29 insertions, 22 deletions
diff --git a/llvm/lib/CodeGen/AsmPrinter/DwarfExpression.h b/llvm/lib/CodeGen/AsmPrinter/DwarfExpression.h index 06fa59bced1..b24074bc918 100644 --- a/llvm/lib/CodeGen/AsmPrinter/DwarfExpression.h +++ b/llvm/lib/CodeGen/AsmPrinter/DwarfExpression.h @@ -76,7 +76,6 @@ public: /// entry. class DwarfExpression { protected: - // Various convenience accessors that extract things out of AsmPrinter. unsigned DwarfVersion; public: @@ -98,10 +97,14 @@ public: /// Emit an (double-)indirect dwarf register operation. void AddRegIndirect(int DwarfReg, int Offset, bool Deref = false); - /// Emit DW_OP_piece operation. + /// Emit a DW_OP_piece operation for a variable fragment. + /// \param OffsetInBits This is the offset where the fragment appears + /// inside the *source variable*. void AddOpPiece(unsigned SizeInBits, unsigned OffsetInBits = 0); + /// Emit a shift-right dwarf expression. void AddShr(unsigned ShiftBy); + /// Emit a DW_OP_stack_value, if supported. /// /// The proper way to describe a constant value is DW_OP_constu <const>, @@ -121,22 +124,22 @@ public: int Offset = 0); /// Emit a partial DWARF register operation. - /// \param MachineReg the register - /// \param PieceSizeInBits size and - /// \param PieceOffsetInBits offset of the piece in bits, if this is one - /// piece of an aggregate value. /// - /// If size and offset is zero an operation for the entire - /// register is emitted: Some targets do not provide a DWARF - /// register number for every register. If this is the case, this - /// function will attempt to emit a DWARF register by emitting a - /// piece of a super-register or by piecing together multiple - /// subregisters that alias the register. + /// \param MachineReg the register, + /// \param FragmentSizeInBits size and + /// \param FragmentOffsetInBits offset of the fragment in bits, if this is + /// a fragment of an aggregate value. + /// + /// If size and offset is zero an operation for the entire register is + /// emitted: Some targets do not provide a DWARF register number for every + /// register. If this is the case, this function will attempt to emit a DWARF + /// register by emitting a fragment of a super-register or by piecing together + /// multiple subregisters that alias the register. /// /// \return false if no DWARF register exists for MachineReg. - bool AddMachineRegPiece(const TargetRegisterInfo &TRI, unsigned MachineReg, - unsigned PieceSizeInBits = 0, - unsigned PieceOffsetInBits = 0); + bool AddMachineRegFragment(const TargetRegisterInfo &TRI, unsigned MachineReg, + unsigned FragmentSizeInBits = 0, + unsigned FragmentOffsetInBits = 0); /// Emit a signed constant. void AddSignedConstant(int64_t Value); @@ -149,17 +152,21 @@ public: /// the prefix of a DwarfExpression if a more efficient representation for /// combining the register location and the first operation exists. /// - /// \param PieceOffsetInBits If this is one piece out of a fragmented - /// location, this is the offset of the piece inside the entire variable. - /// \return false if no DWARF register exists for MachineReg. + /// \param FragmentOffsetInBits If this is one fragment out of a fragmented + /// location, this is the offset of the + /// fragment inside the entire variable. + /// \return false if no DWARF register exists + /// for MachineReg. bool AddMachineRegExpression(const TargetRegisterInfo &TRI, DIExpressionCursor &Expr, unsigned MachineReg, - unsigned PieceOffsetInBits = 0); + unsigned FragmentOffsetInBits = 0); /// Emit all remaining operations in the DIExpressionCursor. - /// \param PieceOffsetInBits If this is one piece out of a fragmented - /// location, this is the offset of the piece inside the entire variable. + /// + /// \param FragmentOffsetInBits If this is one fragment out of multiple + /// locations, this is the offset of the + /// fragment inside the entire variable. void AddExpression(DIExpressionCursor &&Expr, - unsigned PieceOffsetInBits = 0); + unsigned FragmentOffsetInBits = 0); }; /// DwarfExpression implementation for .debug_loc entries. |
