ecoff

package
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 5, 2021 License: MIT Imports: 6 Imported by: 0

Documentation

Overview

Package ecoff implements access to ECOFF object files.

Index

Constants

View Source 
const (
	// TODO; header flag parsing
	HAS_RELOC  = 0x01
	HAS_SYMS   = 0x10
	HAS_LOCALS = 0x20

	F_RELFLG = 0000001
	F_EXEC   = 0000002
	F_LNNO   = 0000004
	F_LSYMS  = 0000010
	F_MINMAL = 0000020
	F_UPDATE = 0000040
	F_SWABD  = 0000100
	F_AR16WR = 0000200
	F_AR32WR = 0000400
	F_AR32W  = 0001000
	F_PATCH  = 0002000
	F_NODF   = 0002000
)
View Source 
const (
	// names of special sections
	S_TEXT    = ".text"
	S_DATA    = ".data"
	S_BSS     = ".bss"
	S_RDATA   = ".rdata"
	S_SDATA   = ".sdata"
	S_SBSS    = ".sbss"
	S_LITA    = ".lita"
	S_LIT4    = ".lit4"
	S_LIT8    = ".lit8"
	S_LIB     = ".lib"
	S_INIT    = ".init"
	S_FINI    = ".fini"
	S_PDATA   = ".pdata"
	S_XDATA   = ".xdata"
	S_GOT     = ".got"
	S_HASH    = ".hash"
	S_DYNSYM  = ".dynsym"
	S_DYNSTR  = ".dynstr"
	S_RELDYN  = ".rel.dyn"
	S_CONFLIC = ".conflic"
	S_COMMENT = ".comment"
	S_LIBLIST = ".liblist"
	S_DYNAMIC = ".dynamic"
	S_RCONST  = ".rconst"
)

Variables

View Source 
var (
	MIPSEL_MAGIC    = [2]byte{0x62, 0x01}
	MIPSEL_BE_MAGIC = [2]byte{0x01, 0x62}
	MIPSBE_MAGIC    = [2]byte{0x60, 0x01}
	MIPSBE_EL_MAGIC = [2]byte{0x01, 0x60}
)

Functions

func Print 

func Print(f *File) error

func PrintSymbolHeader 

func PrintSymbolHeader(s *SymbolicHeader) error

Types

type ExternalSymbol 

type ExternalSymbol struct {
	// JumpTable bool
	// CobolMain bool
	// WeakExt bool
	IFD int16
	Symbol
}

An ExternalSymbol represents an entry in an ECOFF external symbol table section.

type File 

type File struct {
	FileHeader
	ObjectHeader

	ExternalSymbols []*ExternalSymbol
	LocalSymbols    []*Symbol
	Sections        []*Section
	// contains filtered or unexported fields
}

A File represents an ECOFF file.

func NewFile 

func NewFile(r io.ReaderAt) (*File, error)

func Open 

func Open(name string) (*File, error)

func (*File) Close 

func (f *File) Close() error

func (*File) Data 

func (f *File) Data() []byte

Data returns a byte slice representing all contiguous section data.

func (*File) Size 

func (f *File) Size() uint32

Size returns the number of bytes for data in all sections.

func (*File) String 

func (f *File) String() string

func (*File) Symbols 

func (f *File) Symbols() []*Symbol

Symbols returns a slice of Symbols from the combined local and external symbol tables.

func (*File) SymbolsByType 

func (f *File) SymbolsByType(st SymbolType) map[uint32]*Symbol

Symbols returns a map of Symbols to start addresses for the given type.

type FileDescriptor 

type FileDescriptor struct {
	Address                   int32
	FileName                  int32
	StringsOffset             int32
	StringsLength             int32
	SymbolsOffset             int32
	SymbolsCount              int32
	OptimizationSymbolsOffset int32
	OptimizationSymbolsCount  int32
	ProceduresOffset          uint16
	ProceduresCount           int16
	AuxSymbolsOffset          int32
	AuxSymbolsCount           int32
	IndirectSymbolsOffset     int32
	IndirectSymbolsCount      int32

	// 00-05 Language
	// 05-06 File can be merged
	// 06-07 File read in after creation
	// 07-08 Compiled on big-endian host machine
	// 08-10 Level compiled with
	// 10-32 Reserved
	BitFields int32

	LineOffset int32
	LineCount  int32
}

A FileDescriptor represents an ECOFF file descriptor structure. It is used to speed mapping ofaddress to name. It should be present in every file, regardless of compilation options (unverified).

type FileHeader 

type FileHeader struct {
	Magic                [2]byte
	NumSections          uint16
	Timestamp            int32
	SymbolicHeaderOffset uint32
	SymbolicHeaderSize   int32
	OptionalHeader       uint16
	Flags                uint16
}

A FileHeader represents an ECOFF file header.

type ObjectHeader 

type ObjectHeader struct {
	Magic     int16
	Vstamp    int16
	TextSize  int32
	DataSize  int32
	BssSize   int32
	Entry     uint32
	TextStart uint32
	DataStart uint32
	BssStart  uint32
	GprMask   uint32
	CprMask   [4]uint32
	GpValue   uint32
}

An ObjectHeader represents an ECOFF object header. This is the header referred to in the OptionalHeader field of FileHeader.

type OptimizationType 

type OptimizationType uint32
const (
	OT_NIL    OptimizationType = 0 /* inactive */
	OT_REG    OptimizationType = 1 /* move var to reg */
	OT_BLOCK  OptimizationType = 2 /* begin basic block */
	OT_PROC   OptimizationType = 3 /* procedure */
	OT_INLINE OptimizationType = 4 /* inline procedure */
	OT_END    OptimizationType = 5 /* whatever you started */
	OT_MAX    OptimizationType = 6
)

type ProcedureDescriptor32 

type ProcedureDescriptor32 struct {
	Address                     int32
	LocalSymbolsOffset          int32
	LineNumbersOffset           int32
	RegisterMask                uint32
	RegisterOffset              int32
	OptimizationSymbolsOffset   int32
	FloatingPointRegisterMask   int32
	FloatingPointRegisterOffset int32
	FrameOffset                 int32
	FrameRegister               int16
	ProgramCounterOffest        int16
	LineBegin                   int32
	LineEnd                     int32
	LineOffset                  int32
}

A ProcedureDescriptor32 represents a 32-bit ECOFF file descriptor structure. There should be a structure representing each text label in any given 32-bit ECOFF file.

type ProcedureDescriptor64 

type ProcedureDescriptor64 struct {
	ProcedureDescriptor32

	// 00-08 Size of GP prologue
	// 08-09 Procedure uses GP
	// 09-10 Register frame procedure
	// 10-11 Compiled with -pg
	// 11-24 Reserved
	// 24-32 Local variable offset from vfp
	BitFields int32
}

A ProcedureDescriptor64 represents a 64-bit ECOFF file descriptor structure. There should be a structure representing each text label in any given 64-bit ECOFF file.

type Section 

type Section struct {
	SectionHeader

	io.ReaderAt
	// contains filtered or unexported fields
}

A Section represents a single section in an ECOFF file.

func (*Section) Data 

func (s *Section) Data() ([]byte, error)

Data reads and returns the contents of the ECOFF section.

func (*Section) Open 

func (s *Section) Open() io.ReadSeeker

Open returns a new ReadSeeker reading the ECOFF section.

func (*Section) String 

func (s *Section) String() string

type SectionHeader 

type SectionHeader struct {
	Name              [8]uint8
	PhysicalAddress   uint32
	VirtualAddress    uint32
	Size              int32
	Offset            uint32
	RelocationsOffset uint32
	LineNumbersOffset int32
	NumRelocations    uint16
	NumLineNumbers    uint16
	Flags             int32
}

A SectionHeader represents an ECOFF section header.

type StorageClass 

type StorageClass uint32
const (
	SC_NIL          StorageClass = 0  /* inactive */
	SC_TEXT         StorageClass = 1  /* text symbol */
	SC_DATA         StorageClass = 2  /* initialized data symbol  */
	SC_BSS          StorageClass = 3  /* un-initialized data symbol  */
	SC_REGISTER     StorageClass = 4  /* value of symbol is register number  */
	SC_ABS          StorageClass = 5  /* value of symbol is absolute  */
	SC_UNDEFINED    StorageClass = 6  /* who knows? */
	SC_CDB_LOCAL    StorageClass = 7  /* variable's value is IN se->va.??  */
	SC_BITS         StorageClass = 8  /* this is a bit field  */
	SC_CDB_SYSTEM   StorageClass = 9  /* variable's value is IN CDB's address space  */
	SC_DBX          StorageClass = 9  /* overlap dbx internal use  */
	SC_REG_IMAGE    StorageClass = 10 /* register value saved on stack  */
	SC_INFO         StorageClass = 11 /* symbol contains debugger information  */
	SC_USER_STRUCT  StorageClass = 12 /* address in struct user for current process */
	SC_SDATA        StorageClass = 13 /* load time only small data  */
	SC_SBSS         StorageClass = 14 /* load time only small common  */
	SC_RDATA        StorageClass = 15 /* load time only read only data */
	SC_VAR          StorageClass = 16 /* var parameter (Fortrain, Pascal) */
	SC_COMMON       StorageClass = 17 /* common variable */
	SC_SCOMMON      StorageClass = 18 /* small common */
	SC_VAR_REGISTER StorageClass = 19 /* var parameter in a register */
	SC_VARIANT      StorageClass = 20 /* variant record */
	SC_SUNDEFINED   StorageClass = 21 /* small undefined external data */
	SC_INIT         StorageClass = 22 /* .init section symbol */
	SC_BASED_VAR    StorageClass = 23 /* Fortran or PL/1 ptr based var */
	SC_XDATA        StorageClass = 24 /* exception handling data */
	SC_PDATA        StorageClass = 25 /* procedure section */
	SC_FINI         StorageClass = 26 /* .fini section */
	SC_RCONST       StorageClass = 27 /* .rconst section */
	SC_MAX          StorageClass = 32
)

type Symbol 

type Symbol struct {
	Name         string
	Index        uint32
	Value        uint32
	Type         SymbolType
	StorageClass uint32
	SectionIndex uint32
}

A Symbol represents an entry in an ECOFF local symbol table section.

func (*Symbol) String 

func (s *Symbol) String() string

type SymbolType 

type SymbolType uint32
const (
	ST_NIL          SymbolType = 0  /* inactive */
	ST_GLOBAL       SymbolType = 1  /* external symbol */
	ST_STATIC       SymbolType = 2  /* static */
	ST_PARAM        SymbolType = 3  /* procedure argument */
	ST_LOCAL        SymbolType = 4  /* local variable */
	ST_LABEL        SymbolType = 5  /* label */
	ST_PROC         SymbolType = 6  /* procedure */
	ST_BLOCK        SymbolType = 7  /* beginning of block */
	ST_END          SymbolType = 8  /* end (of struct/union/enum) */
	ST_MEMBER       SymbolType = 9  /* member (of struct/union/enum) */
	ST_TYPEDEF      SymbolType = 10 /* type definition */
	ST_FILE         SymbolType = 11 /* file name */
	ST_REG_RELOC    SymbolType = 12 /* register relocation */
	ST_FORWARD      SymbolType = 13 /* forwarding address */
	ST_STATIC_PROC  SymbolType = 14 /* load time only static procs */
	ST_CONSTANT     SymbolType = 15 /* const */
	ST_STATIC_PARAM SymbolType = 16 /* Fortran static parameters */

	// These new symbol types have been "recently" added to SGI machines.
	ST_STRUCT   SymbolType = 26 /* Beginning of block defining a struct type */
	ST_UNION    SymbolType = 27 /* Beginning of block defining a union type */
	ST_ENUM     SymbolType = 28 /* Beginning of block defining an enum type */
	ST_INDIRECT SymbolType = 34 /* indirect type specification */
	ST_STR      SymbolType = 60 /* string */
	ST_NUMBER   SymbolType = 61 /* pure number */
	ST_EXPR     SymbolType = 62 /* expression */
	ST_TYPE     SymbolType = 63 /* post-coersion SER */
	ST_MAX      SymbolType = 64
)

type SymbolicHeader 

type SymbolicHeader struct {
	Magic                        int16
	Version                      Version
	LineNumbersCount             int32
	LineNumbersLength            int32
	LineNumbersOffset            int32
	DenseNumbersLength           int32
	DenseNumbersOffset           int32
	ProceduresCount              int32
	ProceduresOffset             int32
	LocalSymbolsCount            int32
	LocalSymbolsOffset           int32
	OptimizationSymbolsCount     int32
	OptimizationSymbolsOffset    int32
	AuxSymbolsCount              int32
	AuxSymbolsOffset             int32
	LocalStringsLength           int32
	LocalStringsOffset           int32
	ExternalStringsLength        int32
	ExternalStringsOffset        int32
	FileDescriptorLength         int32
	FileDescriptorOffset         int32
	RelativeFileDescriptorLength int32
	RelativeFileDescriptorOffset int32
	ExternalSymbolsCount         int32
	ExternalSymbolsOffset        int32
}

type Version 

type Version int16

func (Version) String 

func (v Version) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.