xcoff

package
v1.21.8 Latest Latest
Warning

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

 Go to latest Published: Dec 24, 2023 License: MIT Imports: 2 Imported by: 0

Documentation

Overview

Package xcoff implements access to XCOFF (Extended Common Object File Format) files.

Index

Constants

View Source 
const (
	SAIAMAG   = 0x8
	AIAFMAG   = "`\n"
	AIAMAG    = "<aiaff>\n"
	AIAMAGBIG = "<bigaf>\n"

	// Sizeof
	FL_HSZ_BIG = 0x80
	AR_HSZ_BIG = 0x70
)
View Source 
const (
	FILHSZ_32 = 20
	FILHSZ_64 = 24
)
View Source 
const (
	U802TOCMAGIC = 0737
	U64_TOCMAGIC = 0767
)
View Source 
const (
	F_RELFLG    = 0x0001
	F_EXEC      = 0x0002
	F_LNNO      = 0x0004
	F_FDPR_PROF = 0x0010
	F_FDPR_OPTI = 0x0020
	F_DSA       = 0x0040
	F_VARPG     = 0x0100
	F_DYNLOAD   = 0x1000
	F_SHROBJ    = 0x2000
	F_LOADONLY  = 0x4000
)

Flags that describe the type of the object file.

View Source 
const (
	STYP_DWARF  = 0x0010
	STYP_TEXT   = 0x0020
	STYP_DATA   = 0x0040
	STYP_BSS    = 0x0080
	STYP_EXCEPT = 0x0100
	STYP_INFO   = 0x0200
	STYP_TDATA  = 0x0400
	STYP_TBSS   = 0x0800
	STYP_LOADER = 0x1000
	STYP_DEBUG  = 0x2000
	STYP_TYPCHK = 0x4000
	STYP_OVRFLO = 0x8000
)

Flags defining the section type.

View Source 
const (
	SSUBTYP_DWINFO  = 0x10000
	SSUBTYP_DWLINE  = 0x20000
	SSUBTYP_DWPBNMS = 0x30000
	SSUBTYP_DWPBTYP = 0x40000
	SSUBTYP_DWARNGE = 0x50000
	SSUBTYP_DWABREV = 0x60000
	SSUBTYP_DWSTR   = 0x70000
	SSUBTYP_DWRNGES = 0x80000
	SSUBTYP_DWLOC   = 0x90000
	SSUBTYP_DWFRAME = 0xA0000
	SSUBTYP_DWMAC   = 0xB0000
)
View Source 
const (
	// Nscnum
	N_DEBUG = -2
	N_ABS   = -1
	N_UNDEF = 0

	//Ntype
	SYM_V_INTERNAL  = 0x1000
	SYM_V_HIDDEN    = 0x2000
	SYM_V_PROTECTED = 0x3000
	SYM_V_EXPORTED  = 0x4000
	SYM_TYPE_FUNC   = 0x0020
)
View Source 
const (
	C_NULL    = 0
	C_EXT     = 2
	C_STAT    = 3
	C_BLOCK   = 100
	C_FCN     = 101
	C_FILE    = 103
	C_HIDEXT  = 107
	C_BINCL   = 108
	C_EINCL   = 109
	C_WEAKEXT = 111
	C_DWARF   = 112
	C_GSYM    = 128
	C_LSYM    = 129
	C_PSYM    = 130
	C_RSYM    = 131
	C_RPSYM   = 132
	C_STSYM   = 133
	C_BCOMM   = 135
	C_ECOML   = 136
	C_ECOMM   = 137
	C_DECL    = 140
	C_ENTRY   = 141
	C_FUN     = 142
	C_BSTAT   = 143
	C_ESTAT   = 144
	C_GTLS    = 145
	C_STTLS   = 146
)

Storage Class.

View Source 
const (
	XTY_ER = 0
	XTY_SD = 1
	XTY_LD = 2
	XTY_CM = 3
)

Symbol type field.

View Source 
const (
	XFT_FN = 0
	XFT_CT = 1
	XFT_CV = 2
	XFT_CD = 128
)

Defines for File auxiliary definitions: x_ftype field of x_file

View Source 
const (
	XMC_PR     = 0
	XMC_RO     = 1
	XMC_DB     = 2
	XMC_TC     = 3
	XMC_UA     = 4
	XMC_RW     = 5
	XMC_GL     = 6
	XMC_XO     = 7
	XMC_SV     = 8
	XMC_BS     = 9
	XMC_DS     = 10
	XMC_UC     = 11
	XMC_TC0    = 15
	XMC_TD     = 16
	XMC_SV64   = 17
	XMC_SV3264 = 18
	XMC_TL     = 20
	XMC_UL     = 21
	XMC_TE     = 22
)

Storage-mapping class.

View Source 
const (
	LDHDRSZ_32 = 32
	LDHDRSZ_64 = 56
)
View Source 
const (
	R_POS = 0x00
	R_NEG = 0x01
	R_REL = 0x02
	R_TOC = 0x03
	R_TRL = 0x12

	R_TRLA = 0x13
	R_GL   = 0x05
	R_TCL  = 0x06
	R_RL   = 0x0C
	R_RLA  = 0x0D
	R_REF  = 0x0F
	R_BA   = 0x08
	R_RBA  = 0x18
	R_BR   = 0x0A
	R_RBR  = 0x1A

	R_TLS    = 0x20
	R_TLS_IE = 0x21
	R_TLS_LD = 0x22
	R_TLS_LE = 0x23
	R_TLSM   = 0x24
	R_TLSML  = 0x25

	R_TOCU = 0x30
	R_TOCL = 0x31
)
View Source 
const SYMESZ = 18

Variables

This section is empty.

Functions

This section is empty.

Types

type Archive 

type Archive struct {
	ArchiveHeader
	Members []*Member
	// contains filtered or unexported fields
}

Archive represents an open AIX big archive.

func NewArchive 

func NewArchive(r io.ReaderAt) (*Archive, error)

NewArchive creates a new Archive for accessing an AIX big archive in an underlying reader.

func OpenArchive 

func OpenArchive(name string) (*Archive, error)

OpenArchive opens the named archive using os.Open and prepares it for use as an AIX big archive.

func (*Archive) Close 

func (a *Archive) Close() error

Close closes the Archive. If the Archive was created using NewArchive directly instead of OpenArchive, Close has no effect.

func (*Archive) GetFile 

func (arch *Archive) GetFile(name string) (*File, error)

GetFile returns the XCOFF file defined by member name. FIXME: This doesn't work if an archive has two members with the same name which can occur if an archive has both 32-bits and 64-bits files.

type ArchiveHeader 

type ArchiveHeader struct {
	// contains filtered or unexported fields
}

MemberHeader holds information about a big archive file header

type AuxCSect32 

type AuxCSect32 struct {
	Xscnlen   uint32
	Xparmhash uint32
	Xsnhash   uint16
	Xsmtyp    uint8
	Xsmclas   uint8
	Xstab     uint32
	Xsnstab   uint16
}

csect Auxiliary Entry.

type AuxCSect64 

type AuxCSect64 struct {
	Xscnlenlo uint32
	Xparmhash uint32
	Xsnhash   uint16
	Xsmtyp    uint8
	Xsmclas   uint8
	Xscnlenhi uint32
	Xpad      uint8
	Xauxtype  uint8
}

type AuxFcn32 

type AuxFcn32 struct {
	Xexptr   uint32
	Xfsize   uint32
	Xlnnoptr uint32
	Xendndx  uint32
	Xpad     uint16
}

Function Auxiliary Entry

type AuxFcn64 

type AuxFcn64 struct {
	Xlnnoptr uint64
	Xfsize   uint32
	Xendndx  uint32
	Xpad     uint8
	Xauxtype uint8
}

type AuxFile64 

type AuxFile64 struct {
	Xfname   [8]byte
	Xftype   uint8
	Xauxtype uint8
}

File Auxiliary Entry

type AuxSect64 

type AuxSect64 struct {
	Xscnlen uint64
	Xnreloc uint64

	Xauxtype uint8
	// contains filtered or unexported fields
}

type AuxiliaryCSect 

type AuxiliaryCSect struct {
	Length              int64
	StorageMappingClass int
	SymbolType          int
}

AuxiliaryCSect holds information about an XCOFF symbol in an AUX_CSECT entry.

type AuxiliaryFcn 

type AuxiliaryFcn struct {
	Size int64
}

AuxiliaryFcn holds information about an XCOFF symbol in an AUX_FCN entry.

type File 

type File struct {
	FileHeader
	Sections     []*Section
	Symbols      []*Symbol
	StringTable  []byte
	LibraryPaths []string
	// contains filtered or unexported fields
}

A File represents an open XCOFF file.

func NewFile 

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

NewFile creates a new File for accessing an XCOFF binary in an underlying reader.

func Open 

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

Open opens the named file using os.Open and prepares it for use as an XCOFF binary.

func (*File) CSect 

func (f *File) CSect(name string) []byte

CSect reads and returns the contents of a csect.

func (*File) Close 

func (f *File) Close() error

Close closes the File. If the File was created using NewFile directly instead of Open, Close has no effect.

func (*File) DWARF 

func (f *File) DWARF() (*dwarf.Data, error)

func (*File) ImportedLibraries 

func (f *File) ImportedLibraries() ([]string, error)

ImportedLibraries returns the names of all libraries referred to by the binary f that are expected to be linked with the binary at dynamic link time.

func (*File) ImportedSymbols 

func (f *File) ImportedSymbols() ([]ImportedSymbol, error)

ImportedSymbols returns the names of all symbols referred to by the binary f that are expected to be satisfied by other libraries at dynamic load time. It does not return weak symbols.

func (*File) Section 

func (f *File) Section(name string) *Section

Section returns the first section with the given name, or nil if no such section exists. Xcoff have section's name limited to 8 bytes. Some sections like .gosymtab can be trunked but this method will still find them.

func (*File) SectionByType 

func (f *File) SectionByType(typ uint32) *Section

SectionByType returns the first section in f with the given type, or nil if there is no such section.

type FileHeader 

type FileHeader struct {
	TargetMachine uint16
}

FileHeader holds information about an XCOFF file header.

type FileHeader32 

type FileHeader32 struct {
	Fmagic   uint16
	Fnscns   uint16
	Ftimedat uint32
	Fsymptr  uint32
	Fnsyms   uint32
	Fopthdr  uint16
	Fflags   uint16
}

File Header.

type FileHeader64 

type FileHeader64 struct {
	Fmagic   uint16
	Fnscns   uint16
	Ftimedat uint32
	Fsymptr  uint64
	Fopthdr  uint16
	Fflags   uint16
	Fnsyms   uint32
}

type ImportedSymbol 

type ImportedSymbol struct {
	Name    string
	Library string
}

ImportedSymbol holds information about an imported XCOFF symbol.

type LoaderHeader32 

type LoaderHeader32 struct {
	Lversion uint32
	Lnsyms   uint32
	Lnreloc  uint32
	Listlen  uint32
	Lnimpid  uint32
	Limpoff  uint32
	Lstlen   uint32
	Lstoff   uint32
}

Loader Header.

type LoaderHeader64 

type LoaderHeader64 struct {
	Lversion uint32
	Lnsyms   uint32
	Lnreloc  uint32
	Listlen  uint32
	Lnimpid  uint32
	Lstlen   uint32
	Limpoff  uint64
	Lstoff   uint64
	Lsymoff  uint64
	Lrldoff  uint64
}

type LoaderSymbol32 

type LoaderSymbol32 struct {
	Lname   [8]byte
	Lvalue  uint32
	Lscnum  uint16
	Lsmtype uint8
	Lsmclas uint8
	Lifile  uint32
	Lparm   uint32
}

Loader Symbol.

type LoaderSymbol64 

type LoaderSymbol64 struct {
	Lvalue  uint64
	Loffset uint32
	Lscnum  uint16
	Lsmtype uint8
	Lsmclas uint8
	Lifile  uint32
	Lparm   uint32
}

type Member 

type Member struct {
	MemberHeader
	// contains filtered or unexported fields
}

Member represents a member of an AIX big archive.

type MemberHeader 

type MemberHeader struct {
	Name string
	Size uint64
}

MemberHeader holds information about a big archive member

type Reloc 

type Reloc struct {
	VirtualAddress   uint64
	Symbol           *Symbol
	Signed           bool
	InstructionFixed bool
	Length           uint8
	Type             uint8
}

type Reloc32 

type Reloc32 struct {
	Rvaddr  uint32
	Rsymndx uint32
	Rsize   uint8
	Rtype   uint8
}

type Reloc64 

type Reloc64 struct {
	Rvaddr  uint64
	Rsymndx uint32
	Rsize   uint8
	Rtype   uint8
}

type Section 

type Section struct {
	SectionHeader
	Relocs []Reloc
	io.ReaderAt
	// contains filtered or unexported fields
}

func (*Section) Data 

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

Data reads and returns the contents of the XCOFF section s.

type SectionHeader 

type SectionHeader struct {
	Name           string
	VirtualAddress uint64
	Size           uint64
	Type           uint32
	Relptr         uint64
	Nreloc         uint32
}

SectionHeader holds information about an XCOFF section header.

type SectionHeader32 

type SectionHeader32 struct {
	Sname    [8]byte
	Spaddr   uint32
	Svaddr   uint32
	Ssize    uint32
	Sscnptr  uint32
	Srelptr  uint32
	Slnnoptr uint32
	Snreloc  uint16
	Snlnno   uint16
	Sflags   uint32
}

Section Header.

type SectionHeader64 

type SectionHeader64 struct {
	Sname    [8]byte
	Spaddr   uint64
	Svaddr   uint64
	Ssize    uint64
	Sscnptr  uint64
	Srelptr  uint64
	Slnnoptr uint64
	Snreloc  uint32
	Snlnno   uint32
	Sflags   uint32
	Spad     uint32
}

type SymEnt32 

type SymEnt32 struct {
	Nname   [8]byte
	Nvalue  uint32
	Nscnum  uint16
	Ntype   uint16
	Nsclass uint8
	Nnumaux uint8
}

Symbol Table Entry.

type SymEnt64 

type SymEnt64 struct {
	Nvalue  uint64
	Noffset uint32
	Nscnum  uint16
	Ntype   uint16
	Nsclass uint8
	Nnumaux uint8
}

type Symbol 

type Symbol struct {
	Name          string
	Value         uint64
	SectionNumber int
	StorageClass  int
	AuxFcn        AuxiliaryFcn
	AuxCSect      AuxiliaryCSect
}

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.