[llvm] r189864 - Add comments to the CFI instructions and reformat with clang-format. No functionality change.
Rafael Espíndola
rafael.espindola at gmail.com
Tue Sep 3 16:32:24 PDT 2013
Thanks!
On 3 September 2013 18:16, Bill Wendling <isanbard at gmail.com> wrote:
> Author: void
> Date: Tue Sep 3 17:16:52 2013
> New Revision: 189864
>
> URL: http://llvm.org/viewvc/llvm-project?rev=189864&view=rev
> Log:
> Add comments to the CFI instructions and reformat with clang-format. No functionality change.
>
> Modified:
> llvm/trunk/include/llvm/MC/MCDwarf.h
>
> Modified: llvm/trunk/include/llvm/MC/MCDwarf.h
> URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/MC/MCDwarf.h?rev=189864&r1=189863&r2=189864&view=diff
> ==============================================================================
> --- llvm/trunk/include/llvm/MC/MCDwarf.h (original)
> +++ llvm/trunk/include/llvm/MC/MCDwarf.h Tue Sep 3 17:16:52 2013
> @@ -23,400 +23,438 @@
> #include <vector>
>
> namespace llvm {
> - class MCContext;
> - class MCSection;
> - class MCStreamer;
> - class MCSymbol;
> - class SourceMgr;
> - class SMLoc;
> -
> - /// MCDwarfFile - Instances of this class represent the name of the dwarf
> - /// .file directive and its associated dwarf file number in the MC file,
> - /// and MCDwarfFile's are created and unique'd by the MCContext class where
> - /// the file number for each is its index into the vector of DwarfFiles (note
> - /// index 0 is not used and not a valid dwarf file number).
> - class MCDwarfFile {
> - // Name - the base name of the file without its directory path.
> - // The StringRef references memory allocated in the MCContext.
> - StringRef Name;
> -
> - // DirIndex - the index into the list of directory names for this file name.
> - unsigned DirIndex;
> -
> - private: // MCContext creates and uniques these.
> - friend class MCContext;
> - MCDwarfFile(StringRef name, unsigned dirIndex)
> +class MCContext;
> +class MCSection;
> +class MCStreamer;
> +class MCSymbol;
> +class SourceMgr;
> +class SMLoc;
> +
> +/// MCDwarfFile - Instances of this class represent the name of the dwarf
> +/// .file directive and its associated dwarf file number in the MC file,
> +/// and MCDwarfFile's are created and unique'd by the MCContext class where
> +/// the file number for each is its index into the vector of DwarfFiles (note
> +/// index 0 is not used and not a valid dwarf file number).
> +class MCDwarfFile {
> + // Name - the base name of the file without its directory path.
> + // The StringRef references memory allocated in the MCContext.
> + StringRef Name;
> +
> + // DirIndex - the index into the list of directory names for this file name.
> + unsigned DirIndex;
> +
> +private: // MCContext creates and uniques these.
> + friend class MCContext;
> + MCDwarfFile(StringRef name, unsigned dirIndex)
> : Name(name), DirIndex(dirIndex) {}
>
> - MCDwarfFile(const MCDwarfFile&) LLVM_DELETED_FUNCTION;
> - void operator=(const MCDwarfFile&) LLVM_DELETED_FUNCTION;
> - public:
> - /// getName - Get the base name of this MCDwarfFile.
> - StringRef getName() const { return Name; }
> + MCDwarfFile(const MCDwarfFile &) LLVM_DELETED_FUNCTION;
> + void operator=(const MCDwarfFile &) LLVM_DELETED_FUNCTION;
>
> - /// getDirIndex - Get the dirIndex of this MCDwarfFile.
> - unsigned getDirIndex() const { return DirIndex; }
> -
> -
> - /// print - Print the value to the stream \p OS.
> - void print(raw_ostream &OS) const;
> -
> - /// dump - Print the value to stderr.
> - void dump() const;
> - };
> -
> - inline raw_ostream &operator<<(raw_ostream &OS, const MCDwarfFile &DwarfFile){
> - DwarfFile.print(OS);
> - return OS;
> - }
> -
> - /// MCDwarfLoc - Instances of this class represent the information from a
> - /// dwarf .loc directive.
> - class MCDwarfLoc {
> - // FileNum - the file number.
> - unsigned FileNum;
> - // Line - the line number.
> - unsigned Line;
> - // Column - the column position.
> - unsigned Column;
> - // Flags (see #define's below)
> - unsigned Flags;
> - // Isa
> - unsigned Isa;
> - // Discriminator
> - unsigned Discriminator;
> +public:
> + /// getName - Get the base name of this MCDwarfFile.
> + StringRef getName() const { return Name; }
> +
> + /// getDirIndex - Get the dirIndex of this MCDwarfFile.
> + unsigned getDirIndex() const { return DirIndex; }
> +
> + /// print - Print the value to the stream \p OS.
> + void print(raw_ostream &OS) const;
> +
> + /// dump - Print the value to stderr.
> + void dump() const;
> +};
> +
> +inline raw_ostream &operator<<(raw_ostream &OS, const MCDwarfFile &DwarfFile) {
> + DwarfFile.print(OS);
> + return OS;
> +}
> +
> +/// MCDwarfLoc - Instances of this class represent the information from a
> +/// dwarf .loc directive.
> +class MCDwarfLoc {
> + // FileNum - the file number.
> + unsigned FileNum;
> + // Line - the line number.
> + unsigned Line;
> + // Column - the column position.
> + unsigned Column;
> + // Flags (see #define's below)
> + unsigned Flags;
> + // Isa
> + unsigned Isa;
> + // Discriminator
> + unsigned Discriminator;
>
> // Flag that indicates the initial value of the is_stmt_start flag.
> -#define DWARF2_LINE_DEFAULT_IS_STMT 1
> +#define DWARF2_LINE_DEFAULT_IS_STMT 1
>
> -#define DWARF2_FLAG_IS_STMT (1 << 0)
> -#define DWARF2_FLAG_BASIC_BLOCK (1 << 1)
> -#define DWARF2_FLAG_PROLOGUE_END (1 << 2)
> +#define DWARF2_FLAG_IS_STMT (1 << 0)
> +#define DWARF2_FLAG_BASIC_BLOCK (1 << 1)
> +#define DWARF2_FLAG_PROLOGUE_END (1 << 2)
> #define DWARF2_FLAG_EPILOGUE_BEGIN (1 << 3)
>
> - private: // MCContext manages these
> - friend class MCContext;
> - friend class MCLineEntry;
> - MCDwarfLoc(unsigned fileNum, unsigned line, unsigned column, unsigned flags,
> - unsigned isa, unsigned discriminator)
> +private: // MCContext manages these
> + friend class MCContext;
> + friend class MCLineEntry;
> + MCDwarfLoc(unsigned fileNum, unsigned line, unsigned column, unsigned flags,
> + unsigned isa, unsigned discriminator)
> : FileNum(fileNum), Line(line), Column(column), Flags(flags), Isa(isa),
> Discriminator(discriminator) {}
>
> - // Allow the default copy constructor and assignment operator to be used
> - // for an MCDwarfLoc object.
> + // Allow the default copy constructor and assignment operator to be used
> + // for an MCDwarfLoc object.
>
> - public:
> - /// getFileNum - Get the FileNum of this MCDwarfLoc.
> - unsigned getFileNum() const { return FileNum; }
> +public:
> + /// getFileNum - Get the FileNum of this MCDwarfLoc.
> + unsigned getFileNum() const { return FileNum; }
>
> - /// getLine - Get the Line of this MCDwarfLoc.
> - unsigned getLine() const { return Line; }
> + /// getLine - Get the Line of this MCDwarfLoc.
> + unsigned getLine() const { return Line; }
>
> - /// getColumn - Get the Column of this MCDwarfLoc.
> - unsigned getColumn() const { return Column; }
> + /// getColumn - Get the Column of this MCDwarfLoc.
> + unsigned getColumn() const { return Column; }
>
> - /// getFlags - Get the Flags of this MCDwarfLoc.
> - unsigned getFlags() const { return Flags; }
> + /// getFlags - Get the Flags of this MCDwarfLoc.
> + unsigned getFlags() const { return Flags; }
>
> - /// getIsa - Get the Isa of this MCDwarfLoc.
> - unsigned getIsa() const { return Isa; }
> + /// getIsa - Get the Isa of this MCDwarfLoc.
> + unsigned getIsa() const { return Isa; }
>
> - /// getDiscriminator - Get the Discriminator of this MCDwarfLoc.
> - unsigned getDiscriminator() const { return Discriminator; }
> + /// getDiscriminator - Get the Discriminator of this MCDwarfLoc.
> + unsigned getDiscriminator() const { return Discriminator; }
>
> - /// setFileNum - Set the FileNum of this MCDwarfLoc.
> - void setFileNum(unsigned fileNum) { FileNum = fileNum; }
> + /// setFileNum - Set the FileNum of this MCDwarfLoc.
> + void setFileNum(unsigned fileNum) { FileNum = fileNum; }
>
> - /// setLine - Set the Line of this MCDwarfLoc.
> - void setLine(unsigned line) { Line = line; }
> + /// setLine - Set the Line of this MCDwarfLoc.
> + void setLine(unsigned line) { Line = line; }
>
> - /// setColumn - Set the Column of this MCDwarfLoc.
> - void setColumn(unsigned column) { Column = column; }
> + /// setColumn - Set the Column of this MCDwarfLoc.
> + void setColumn(unsigned column) { Column = column; }
>
> - /// setFlags - Set the Flags of this MCDwarfLoc.
> - void setFlags(unsigned flags) { Flags = flags; }
> + /// setFlags - Set the Flags of this MCDwarfLoc.
> + void setFlags(unsigned flags) { Flags = flags; }
>
> - /// setIsa - Set the Isa of this MCDwarfLoc.
> - void setIsa(unsigned isa) { Isa = isa; }
> + /// setIsa - Set the Isa of this MCDwarfLoc.
> + void setIsa(unsigned isa) { Isa = isa; }
>
> - /// setDiscriminator - Set the Discriminator of this MCDwarfLoc.
> - void setDiscriminator(unsigned discriminator) {
> - Discriminator = discriminator;
> - }
> - };
> + /// setDiscriminator - Set the Discriminator of this MCDwarfLoc.
> + void setDiscriminator(unsigned discriminator) {
> + Discriminator = discriminator;
> + }
> +};
>
> - /// MCLineEntry - Instances of this class represent the line information for
> - /// the dwarf line table entries. Which is created after a machine
> - /// instruction is assembled and uses an address from a temporary label
> - /// created at the current address in the current section and the info from
> - /// the last .loc directive seen as stored in the context.
> - class MCLineEntry : public MCDwarfLoc {
> - MCSymbol *Label;
> -
> - private:
> - // Allow the default copy constructor and assignment operator to be used
> - // for an MCLineEntry object.
> -
> - public:
> - // Constructor to create an MCLineEntry given a symbol and the dwarf loc.
> - MCLineEntry(MCSymbol *label, const MCDwarfLoc loc) : MCDwarfLoc(loc),
> - Label(label) {}
> -
> - MCSymbol *getLabel() const { return Label; }
> -
> - // This is called when an instruction is assembled into the specified
> - // section and if there is information from the last .loc directive that
> - // has yet to have a line entry made for it is made.
> - static void Make(MCStreamer *MCOS, const MCSection *Section);
> - };
> +/// MCLineEntry - Instances of this class represent the line information for
> +/// the dwarf line table entries. Which is created after a machine
> +/// instruction is assembled and uses an address from a temporary label
> +/// created at the current address in the current section and the info from
> +/// the last .loc directive seen as stored in the context.
> +class MCLineEntry : public MCDwarfLoc {
> + MCSymbol *Label;
> +
> +private:
> + // Allow the default copy constructor and assignment operator to be used
> + // for an MCLineEntry object.
> +
> +public:
> + // Constructor to create an MCLineEntry given a symbol and the dwarf loc.
> + MCLineEntry(MCSymbol *label, const MCDwarfLoc loc)
> + : MCDwarfLoc(loc), Label(label) {}
> +
> + MCSymbol *getLabel() const { return Label; }
> +
> + // This is called when an instruction is assembled into the specified
> + // section and if there is information from the last .loc directive that
> + // has yet to have a line entry made for it is made.
> + static void Make(MCStreamer *MCOS, const MCSection *Section);
> +};
> +
> +/// MCLineSection - Instances of this class represent the line information
> +/// for a section where machine instructions have been assembled after seeing
> +/// .loc directives. This is the information used to build the dwarf line
> +/// table for a section.
> +class MCLineSection {
> +
> +private:
> + MCLineSection(const MCLineSection &) LLVM_DELETED_FUNCTION;
> + void operator=(const MCLineSection &) LLVM_DELETED_FUNCTION;
> +
> +public:
> + // Constructor to create an MCLineSection with an empty MCLineEntries
> + // vector.
> + MCLineSection() {}
> +
> + // addLineEntry - adds an entry to this MCLineSection's line entries
> + void addLineEntry(const MCLineEntry &LineEntry, unsigned CUID) {
> + MCLineDivisions[CUID].push_back(LineEntry);
> + }
>
> - /// MCLineSection - Instances of this class represent the line information
> - /// for a section where machine instructions have been assembled after seeing
> - /// .loc directives. This is the information used to build the dwarf line
> - /// table for a section.
> - class MCLineSection {
> -
> - private:
> - MCLineSection(const MCLineSection&) LLVM_DELETED_FUNCTION;
> - void operator=(const MCLineSection&) LLVM_DELETED_FUNCTION;
> -
> - public:
> - // Constructor to create an MCLineSection with an empty MCLineEntries
> - // vector.
> - MCLineSection() {}
> -
> - // addLineEntry - adds an entry to this MCLineSection's line entries
> - void addLineEntry(const MCLineEntry &LineEntry, unsigned CUID) {
> - MCLineDivisions[CUID].push_back(LineEntry);
> - }
> -
> - typedef std::vector<MCLineEntry> MCLineEntryCollection;
> - typedef MCLineEntryCollection::iterator iterator;
> - typedef MCLineEntryCollection::const_iterator const_iterator;
> - typedef std::map<unsigned, MCLineEntryCollection> MCLineDivisionMap;
> -
> - private:
> - // A collection of MCLineEntry for each Compile Unit ID.
> - MCLineDivisionMap MCLineDivisions;
> -
> - public:
> - // Returns whether MCLineSection contains entries for a given Compile
> - // Unit ID.
> - bool containEntriesForID(unsigned CUID) const {
> - return MCLineDivisions.count(CUID);
> - }
> - // Returns the collection of MCLineEntry for a given Compile Unit ID.
> - const MCLineEntryCollection &getMCLineEntries(unsigned CUID) const {
> - MCLineDivisionMap::const_iterator CIter = MCLineDivisions.find(CUID);
> - assert(CIter != MCLineDivisions.end());
> - return CIter->second;
> - }
> - };
> + typedef std::vector<MCLineEntry> MCLineEntryCollection;
> + typedef MCLineEntryCollection::iterator iterator;
> + typedef MCLineEntryCollection::const_iterator const_iterator;
> + typedef std::map<unsigned, MCLineEntryCollection> MCLineDivisionMap;
> +
> +private:
> + // A collection of MCLineEntry for each Compile Unit ID.
> + MCLineDivisionMap MCLineDivisions;
> +
> +public:
> + // Returns whether MCLineSection contains entries for a given Compile
> + // Unit ID.
> + bool containEntriesForID(unsigned CUID) const {
> + return MCLineDivisions.count(CUID);
> + }
> + // Returns the collection of MCLineEntry for a given Compile Unit ID.
> + const MCLineEntryCollection &getMCLineEntries(unsigned CUID) const {
> + MCLineDivisionMap::const_iterator CIter = MCLineDivisions.find(CUID);
> + assert(CIter != MCLineDivisions.end());
> + return CIter->second;
> + }
> +};
>
> - class MCDwarfFileTable {
> - public:
> - //
> - // This emits the Dwarf file and the line tables for all Compile Units.
> - //
> - static const MCSymbol *Emit(MCStreamer *MCOS);
> - //
> - // This emits the Dwarf file and the line tables for a given Compile Unit.
> - //
> - static const MCSymbol *EmitCU(MCStreamer *MCOS, unsigned ID);
> - };
> +class MCDwarfFileTable {
> +public:
> + //
> + // This emits the Dwarf file and the line tables for all Compile Units.
> + //
> + static const MCSymbol *Emit(MCStreamer *MCOS);
> + //
> + // This emits the Dwarf file and the line tables for a given Compile Unit.
> + //
> + static const MCSymbol *EmitCU(MCStreamer *MCOS, unsigned ID);
> +};
> +
> +class MCDwarfLineAddr {
> +public:
> + /// Utility function to encode a Dwarf pair of LineDelta and AddrDeltas.
> + static void Encode(MCContext &Context, int64_t LineDelta, uint64_t AddrDelta,
> + raw_ostream &OS);
> +
> + /// Utility function to emit the encoding to a streamer.
> + static void Emit(MCStreamer *MCOS, int64_t LineDelta, uint64_t AddrDelta);
> +};
> +
> +class MCGenDwarfInfo {
> +public:
> + //
> + // When generating dwarf for assembly source files this emits the Dwarf
> + // sections.
> + //
> + static void Emit(MCStreamer *MCOS, const MCSymbol *LineSectionSymbol);
> +};
> +
> +// When generating dwarf for assembly source files this is the info that is
> +// needed to be gathered for each symbol that will have a dwarf label.
> +class MCGenDwarfLabelEntry {
> +private:
> + // Name of the symbol without a leading underbar, if any.
> + StringRef Name;
> + // The dwarf file number this symbol is in.
> + unsigned FileNumber;
> + // The line number this symbol is at.
> + unsigned LineNumber;
> + // The low_pc for the dwarf label is taken from this symbol.
> + MCSymbol *Label;
> +
> +public:
> + MCGenDwarfLabelEntry(StringRef name, unsigned fileNumber, unsigned lineNumber,
> + MCSymbol *label)
> + : Name(name), FileNumber(fileNumber), LineNumber(lineNumber),
> + Label(label) {}
> +
> + StringRef getName() const { return Name; }
> + unsigned getFileNumber() const { return FileNumber; }
> + unsigned getLineNumber() const { return LineNumber; }
> + MCSymbol *getLabel() const { return Label; }
> +
> + // This is called when label is created when we are generating dwarf for
> + // assembly source files.
> + static void Make(MCSymbol *Symbol, MCStreamer *MCOS, SourceMgr &SrcMgr,
> + SMLoc &Loc);
> +};
> +
> +class MCCFIInstruction {
> +public:
> + enum OpType {
> + OpSameValue,
> + OpRememberState,
> + OpRestoreState,
> + OpOffset,
> + OpDefCfaRegister,
> + OpDefCfaOffset,
> + OpDefCfa,
> + OpRelOffset,
> + OpAdjustCfaOffset,
> + OpEscape,
> + OpRestore,
> + OpUndefined,
> + OpRegister
> + };
> +
> +private:
> + OpType Operation;
> + MCSymbol *Label;
> + unsigned Register;
> + union {
> + int Offset;
> + unsigned Register2;
> + };
> + std::vector<char> Values;
> +
> + MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R, int O, StringRef V)
> + : Operation(Op), Label(L), Register(R), Offset(O),
> + Values(V.begin(), V.end()) {
> + assert(Op != OpRegister);
> + }
>
> - class MCDwarfLineAddr {
> - public:
> - /// Utility function to encode a Dwarf pair of LineDelta and AddrDeltas.
> - static void Encode(MCContext &Context, int64_t LineDelta,
> - uint64_t AddrDelta, raw_ostream &OS);
> -
> - /// Utility function to emit the encoding to a streamer.
> - static void Emit(MCStreamer *MCOS,
> - int64_t LineDelta,uint64_t AddrDelta);
> - };
> + MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R1, unsigned R2)
> + : Operation(Op), Label(L), Register(R1), Register2(R2) {
> + assert(Op == OpRegister);
> + }
>
> - class MCGenDwarfInfo {
> - public:
> - //
> - // When generating dwarf for assembly source files this emits the Dwarf
> - // sections.
> - //
> - static void Emit(MCStreamer *MCOS, const MCSymbol *LineSectionSymbol);
> - };
> +public:
> + /// \brief .cfi_def_cfa defines a rule for computing CFA as: take address from
> + /// \param Register and add \param Offset to it.
> + static MCCFIInstruction createDefCfa(MCSymbol *L, unsigned Register,
> + int Offset) {
> + return MCCFIInstruction(OpDefCfa, L, Register, -Offset, "");
> + }
>
> - // When generating dwarf for assembly source files this is the info that is
> - // needed to be gathered for each symbol that will have a dwarf label.
> - class MCGenDwarfLabelEntry {
> - private:
> - // Name of the symbol without a leading underbar, if any.
> - StringRef Name;
> - // The dwarf file number this symbol is in.
> - unsigned FileNumber;
> - // The line number this symbol is at.
> - unsigned LineNumber;
> - // The low_pc for the dwarf label is taken from this symbol.
> - MCSymbol *Label;
> -
> - public:
> - MCGenDwarfLabelEntry(StringRef name, unsigned fileNumber,
> - unsigned lineNumber, MCSymbol *label) :
> - Name(name), FileNumber(fileNumber), LineNumber(lineNumber), Label(label){}
> -
> - StringRef getName() const { return Name; }
> - unsigned getFileNumber() const { return FileNumber; }
> - unsigned getLineNumber() const { return LineNumber; }
> - MCSymbol *getLabel() const { return Label; }
> -
> - // This is called when label is created when we are generating dwarf for
> - // assembly source files.
> - static void Make(MCSymbol *Symbol, MCStreamer *MCOS, SourceMgr &SrcMgr,
> - SMLoc &Loc);
> - };
> + /// \brief .cfi_def_cfa_register modifies a rule for computing CFA. From now
> + /// on \param Register will be used instead of the old one. Offset remains the
> + /// same.
> + static MCCFIInstruction createDefCfaRegister(MCSymbol *L, unsigned Register) {
> + return MCCFIInstruction(OpDefCfaRegister, L, Register, 0, "");
> + }
>
> - class MCCFIInstruction {
> - public:
> - enum OpType { OpSameValue, OpRememberState, OpRestoreState, OpOffset,
> - OpDefCfaRegister, OpDefCfaOffset, OpDefCfa, OpRelOffset,
> - OpAdjustCfaOffset, OpEscape, OpRestore, OpUndefined,
> - OpRegister };
> - private:
> - OpType Operation;
> - MCSymbol *Label;
> - unsigned Register;
> - union {
> - int Offset;
> - unsigned Register2;
> - };
> - std::vector<char> Values;
> -
> - MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R, int O, StringRef V) :
> - Operation(Op), Label(L), Register(R), Offset(O),
> - Values(V.begin(), V.end()) {
> - assert(Op != OpRegister);
> - }
> -
> - MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R1, unsigned R2) :
> - Operation(Op), Label(L), Register(R1), Register2(R2) {
> - assert(Op == OpRegister);
> - }
> -
> - public:
> - static MCCFIInstruction
> - createOffset(MCSymbol *L, unsigned Register, int Offset) {
> - return MCCFIInstruction(OpOffset, L, Register, Offset, "");
> - }
> -
> - static MCCFIInstruction
> - createDefCfaRegister(MCSymbol *L, unsigned Register) {
> - return MCCFIInstruction(OpDefCfaRegister, L, Register, 0, "");
> - }
> -
> - static MCCFIInstruction createDefCfaOffset(MCSymbol *L, int Offset) {
> - return MCCFIInstruction(OpDefCfaOffset, L, 0, -Offset, "");
> - }
> -
> - static MCCFIInstruction
> - createDefCfa(MCSymbol *L, unsigned Register, int Offset) {
> - return MCCFIInstruction(OpDefCfa, L, Register, -Offset, "");
> - }
> -
> - static MCCFIInstruction createUndefined(MCSymbol *L, unsigned Register) {
> - return MCCFIInstruction(OpUndefined, L, Register, 0, "");
> - }
> -
> - static MCCFIInstruction createRestore(MCSymbol *L, unsigned Register) {
> - return MCCFIInstruction(OpRestore, L, Register, 0, "");
> - }
> -
> - static MCCFIInstruction createSameValue(MCSymbol *L, unsigned Register) {
> - return MCCFIInstruction(OpSameValue, L, Register, 0, "");
> - }
> -
> - static MCCFIInstruction createRestoreState(MCSymbol *L) {
> - return MCCFIInstruction(OpRestoreState, L, 0, 0, "");
> - }
> -
> - static MCCFIInstruction createRememberState(MCSymbol *L) {
> - return MCCFIInstruction(OpRememberState, L, 0, 0, "");
> - }
> -
> - static MCCFIInstruction
> - createRelOffset(MCSymbol *L, unsigned Register, int Offset) {
> - return MCCFIInstruction(OpRelOffset, L, Register, Offset, "");
> - }
> -
> - static MCCFIInstruction
> - createAdjustCfaOffset(MCSymbol *L, int Adjustment) {
> - return MCCFIInstruction(OpAdjustCfaOffset, L, 0, Adjustment, "");
> - }
> -
> - static MCCFIInstruction createEscape(MCSymbol *L, StringRef Vals) {
> - return MCCFIInstruction(OpEscape, L, 0, 0, Vals);
> - }
> -
> - static MCCFIInstruction
> - createRegister(MCSymbol *L, unsigned Register1, unsigned Register2) {
> - return MCCFIInstruction(OpRegister, L, Register1, Register2);
> - }
> -
> - OpType getOperation() const { return Operation; }
> - MCSymbol *getLabel() const { return Label; }
> -
> - unsigned getRegister() const {
> - assert(Operation == OpDefCfa || Operation == OpOffset ||
> - Operation == OpRestore || Operation == OpUndefined ||
> - Operation == OpSameValue || Operation == OpDefCfaRegister ||
> - Operation == OpRelOffset || Operation == OpRegister);
> - return Register;
> - }
> -
> - unsigned getRegister2() const {
> - assert(Operation == OpRegister);
> - return Register2;
> - }
> -
> - int getOffset() const {
> - assert(Operation == OpDefCfa || Operation == OpOffset ||
> - Operation == OpRelOffset || Operation == OpDefCfaOffset ||
> - Operation == OpAdjustCfaOffset);
> - return Offset;
> - }
> -
> - const StringRef getValues() const {
> - assert(Operation == OpEscape);
> - return StringRef(&Values[0], Values.size());
> - }
> - };
> + /// \brief .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.
> + static MCCFIInstruction createDefCfaOffset(MCSymbol *L, int Offset) {
> + return MCCFIInstruction(OpDefCfaOffset, L, 0, -Offset, "");
> + }
>
> - struct MCDwarfFrameInfo {
> - MCDwarfFrameInfo() : Begin(0), End(0), Personality(0), Lsda(0),
> - Function(0), Instructions(), PersonalityEncoding(),
> - LsdaEncoding(0), CompactUnwindEncoding(0),
> - IsSignalFrame(false) {}
> - MCSymbol *Begin;
> - MCSymbol *End;
> - const MCSymbol *Personality;
> - const MCSymbol *Lsda;
> - const MCSymbol *Function;
> - std::vector<MCCFIInstruction> Instructions;
> - unsigned PersonalityEncoding;
> - unsigned LsdaEncoding;
> - uint32_t CompactUnwindEncoding;
> - bool IsSignalFrame;
> - };
> + /// \brief .cfi_adjust_cfa_offset Same as .cfi_def_cfa_offset, but \param
> + /// Offset is a relative value that is added/subtracted from the previous
> + /// offset.
> + static MCCFIInstruction createAdjustCfaOffset(MCSymbol *L, int Adjustment) {
> + return MCCFIInstruction(OpAdjustCfaOffset, L, 0, Adjustment, "");
> + }
>
> - class MCDwarfFrameEmitter {
> - public:
> - //
> - // This emits the frame info section.
> - //
> - static void Emit(MCStreamer &streamer, bool usingCFI,
> - bool isEH);
> - static void EmitAdvanceLoc(MCStreamer &Streamer, uint64_t AddrDelta);
> - static void EncodeAdvanceLoc(MCContext &Context, uint64_t AddrDelta,
> - raw_ostream &OS);
> - };
> + /// \brief .cfi_offset Previous value of \param Register is saved at offset
> + /// \param Offset from CFA.
> + static MCCFIInstruction createOffset(MCSymbol *L, unsigned Register,
> + int Offset) {
> + return MCCFIInstruction(OpOffset, L, Register, Offset, "");
> + }
> +
> + /// \brief .cfi_rel_offset Previous value of \param Register is saved at
> + /// offset \param Offset from the current CFA register. This is transformed to
> + /// .cfi_offset using the known displacement of the CFA register from the CFA.
> + static MCCFIInstruction createRelOffset(MCSymbol *L, unsigned Register,
> + int Offset) {
> + return MCCFIInstruction(OpRelOffset, L, Register, Offset, "");
> + }
> +
> + /// \brief .cfi_register Previous value of \param Register1 is saved in
> + /// register \param Register2.
> + static MCCFIInstruction createRegister(MCSymbol *L, unsigned Register1,
> + unsigned Register2) {
> + return MCCFIInstruction(OpRegister, L, Register1, Register2);
> + }
> +
> + /// \brief .cfi_restore says that the rule for \param 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 createRestore(MCSymbol *L, unsigned Register) {
> + return MCCFIInstruction(OpRestore, L, Register, 0, "");
> + }
> +
> + /// \brief .cfi_undefined From now on the previous value of \param Register
> + /// can't be restored anymore.
> + static MCCFIInstruction createUndefined(MCSymbol *L, unsigned Register) {
> + return MCCFIInstruction(OpUndefined, L, Register, 0, "");
> + }
> +
> + /// \brief .cfi_same_value Current value of \param Register is the same as
> + /// in the previous frame. I.e., no restoration is needed.
> + static MCCFIInstruction createSameValue(MCSymbol *L, unsigned Register) {
> + return MCCFIInstruction(OpSameValue, L, Register, 0, "");
> + }
> +
> + /// \brief .cfi_remember_state Save all current rules for all registers.
> + static MCCFIInstruction createRememberState(MCSymbol *L) {
> + return MCCFIInstruction(OpRememberState, L, 0, 0, "");
> + }
> +
> + /// \brief .cfi_restore_state Restore the previously saved state.
> + static MCCFIInstruction createRestoreState(MCSymbol *L) {
> + return MCCFIInstruction(OpRestoreState, L, 0, 0, "");
> + }
> +
> + /// \brief .cfi_escape Allows the user to add arbitrary bytes to the unwind
> + /// info.
> + static MCCFIInstruction createEscape(MCSymbol *L, StringRef Vals) {
> + return MCCFIInstruction(OpEscape, L, 0, 0, Vals);
> + }
> +
> + OpType getOperation() const { return Operation; }
> + MCSymbol *getLabel() const { return Label; }
> +
> + unsigned getRegister() const {
> + assert(Operation == OpDefCfa || Operation == OpOffset ||
> + Operation == OpRestore || Operation == OpUndefined ||
> + Operation == OpSameValue || Operation == OpDefCfaRegister ||
> + Operation == OpRelOffset || Operation == OpRegister);
> + return Register;
> + }
> +
> + unsigned getRegister2() const {
> + assert(Operation == OpRegister);
> + return Register2;
> + }
> +
> + int getOffset() const {
> + assert(Operation == OpDefCfa || Operation == OpOffset ||
> + Operation == OpRelOffset || Operation == OpDefCfaOffset ||
> + Operation == OpAdjustCfaOffset);
> + return Offset;
> + }
> +
> + const StringRef getValues() const {
> + assert(Operation == OpEscape);
> + return StringRef(&Values[0], Values.size());
> + }
> +};
> +
> +struct MCDwarfFrameInfo {
> + MCDwarfFrameInfo()
> + : Begin(0), End(0), Personality(0), Lsda(0), Function(0), Instructions(),
> + PersonalityEncoding(), LsdaEncoding(0), CompactUnwindEncoding(0),
> + IsSignalFrame(false) {}
> + MCSymbol *Begin;
> + MCSymbol *End;
> + const MCSymbol *Personality;
> + const MCSymbol *Lsda;
> + const MCSymbol *Function;
> + std::vector<MCCFIInstruction> Instructions;
> + unsigned PersonalityEncoding;
> + unsigned LsdaEncoding;
> + uint32_t CompactUnwindEncoding;
> + bool IsSignalFrame;
> +};
> +
> +class MCDwarfFrameEmitter {
> +public:
> + //
> + // This emits the frame info section.
> + //
> + static void Emit(MCStreamer &streamer, bool usingCFI, bool isEH);
> + static void EmitAdvanceLoc(MCStreamer &Streamer, uint64_t AddrDelta);
> + static void EncodeAdvanceLoc(MCContext &Context, uint64_t AddrDelta,
> + raw_ostream &OS);
> +};
> } // end namespace llvm
>
> #endif
>
>
> _______________________________________________
> llvm-commits mailing list
> llvm-commits at cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits
More information about the llvm-commits
mailing list