Documentation
¶
Overview ¶
Package plan9obj implements access to Plan 9 a.out object files.
Security ¶
This package is not designed to be hardened against adversarial inputs, and is outside the scope of https://go.dev/security/policy. In particular, only basic validation is done when parsing object files. As such, care should be taken when parsing untrusted inputs, as parsing malformed files may consume significant resources, or cause panics.
Index ¶
Constants ¶
const ( Magic64 = 0x8000 // 64-bit expanded header Magic386 = (4*11+0)*11 + 7 MagicAMD64 = (4*26+0)*26 + 7 + Magic64 MagicARM = (4*20+0)*20 + 7 )
Variables ¶
var ErrNoSymbols = errors.New("no symbol section")
ErrNoSymbols is returned by File.Symbols if there is no such section in the File.
Functions ¶
This section is empty.
Types ¶
type File ¶
type File struct {
FileHeader
Sections []*Section
// contains filtered or unexported fields
}
A File represents an open Plan 9 a.out file.
func NewFile ¶
NewFile creates a new File for accessing a Plan 9 binary in an underlying reader. The Plan 9 binary is expected to start at position 0 in the ReaderAt.
func Open ¶
Open opens the named file using os.Open and prepares it for use as a Plan 9 a.out binary.
func (*File) Close ¶
Close closes the File. If the File was created using NewFile directly instead of Open, Close has no effect.
type FileHeader ¶
type FileHeader struct {
Magic uint32
Bss uint32
Entry uint64
PtrSize int
LoadAddress uint64
HdrSize uint64
}
A FileHeader represents a Plan 9 a.out file header.
type Section ¶
type Section struct {
SectionHeader
// Embed ReaderAt for ReadAt method.
// Do not embed SectionReader directly
// to avoid having Read and Seek.
// If a client wants Read and Seek it must use
// Open() to avoid fighting over the seek offset
// with other clients.
io.ReaderAt
// contains filtered or unexported fields
}
A Section represents a single section in a Plan 9 a.out file.
func (*Section) Open ¶
func (s *Section) Open() io.ReadSeeker
Open returns a new ReadSeeker reading the Plan 9 a.out section.
type SectionHeader ¶
A SectionHeader represents a single Plan 9 a.out section header. This structure doesn't exist on-disk, but eases navigation through the object file.
Source Files