plan9obj

原文：https://pkg.go.dev/debug/plan9obj@go1.23.0

Package plan9obj implements access to Plan 9 a.out object files.

​ plan9obj 包实现对 Plan 9 a.out 对象文件的访问。

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.

​ 该包没有设计用于抵御对抗性输入，并且超出了 https://go.dev/security/policy 的范围。特别是，在解析对象文件时只进行了基本验证。因此，在解析不受信任的输入时应该小心，因为解析格式错误的文件可能会消耗大量资源或导致崩溃。

常量

View Source

1
2
3
4
5
6
7

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
)

变量

View Source

1

var ErrNoSymbols = errors.New("no symbol section")

ErrNoSymbols is returned by File.Symbols if there is no such section in the File.

​ 如果文件中没有该节（section），则 File.Symbols 返回 ErrNoSymbols。

函数

This section is empty.

类型

type File

1
2
3
4
5

type File struct {
	FileHeader
	Sections []*Section
	// contains filtered or unexported fields
}

A File represents an open Plan 9 a.out file.

​ File 表示一个打开的 Plan 9 a.out 文件。

func NewFile

1

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

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.

​ NewFile 创建一个新的 File，用于访问底层 reader 中的 Plan 9 二进制文件。Plan 9 二进制文件预期从 ReaderAt 的位置 0 开始。

func Open

1

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

Open opens the named file using os.Open and prepares it for use as a Plan 9 a.out binary.

​ Open 使用 os.Open 打开指定的文件，并准备将其用作 Plan 9 a.out 二进制文件。

(*File) Close

1

func (f *File) Close() error

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

​ Close 关闭文件。如果 File 是通过 NewFile 直接创建而不是通过 Open 创建的，则 Close 不起作用。

(*File) Section

1

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

Section returns a section with the given name, or nil if no such section exists.

​ Section 返回具有给定名称的节（section），如果不存在则返回 nil。

(*File) Symbols

1

func (f *File) Symbols() ([]Sym, error)

Symbols returns the symbol table for f.

​ Symbols 返回 f 的符号表。

type FileHeader

1
2
3
4
5
6
7
8

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.

​ FileHeader 表示 Plan 9 a.out 文件头。

type Section

1
2
3
4
5
6
7
8
9

type Section struct {
	SectionHeader

    // 通过嵌入 ReaderAt 实现 ReadAt 方法。
    // 不直接嵌入 SectionReader，以避免造成 Read 和 Seek 的冲突。
    // 如果客户端需要 Read 和 Seek，必须使用 Open() 方法以避免与其他客户端争用 Seek 偏移量。	
	io.ReaderAt
	// contains filtered or unexported fields
}

A Section represents a single section in a Plan 9 a.out file.

​ Section 表示 Plan 9 a.out 文件中的单个节（section）。

(*Section) Data

1

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

Data reads and returns the contents of the Plan 9 a.out section.

​ Data 读取并返回 Plan 9 a.out 节的内容。

(*Section) Open

1

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

Open returns a new ReadSeeker reading the Plan 9 a.out section.

​ Open 返回一个新的 ReadSeeker，用于读取 Plan 9 a.out 节。

type SectionHeader

1
2
3
4
5

type SectionHeader struct {
	Name   string
	Size   uint32
	Offset uint32
}

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.

​ SectionHeader 表示 Plan 9 a.out 单个节的头。该结构在磁盘上不存在，但可以方便地导航对象文件。

type Sym

1
2
3
4
5

type Sym struct {
	Value uint64
	Type  rune
	Name  string
}

A Symbol represents an entry in a Plan 9 a.out symbol table section.

​ Sym 表示 Plan 9 a.out 符号表节中的条目。