struct
(struct bin:section ( name
size
writable?
executable?
data
symbols
relocations)
#:extra-constructor-namemake-bin:section)
name:(or/c bytes? #f)
size:(or/c exact-nonnegative-integer? #f)
writable?:boolean?
executable?:boolean?
data:(or/c bytes? #f)
symbols:(listof bin:symbol? )
relocations:(listof bin:relocation? )

Represents a section of a binary object.

struct
(struct bin:symbol (namevaluesizebindingtype)
#:extra-constructor-namemake-bin:symbol)
name:symbol?
value:exact-integer?
size:(or/c exact-nonnegative-integer? #f)
binding:(one-of/c 'local'global'weak#f)
type:(one-of/c 'object'function#f)

Represents a symbol for linking.

struct
(struct bin:relocation (offsetsizesymboltypeaddend)
#:extra-constructor-namemake-bin:relocation)
offset:exact-nonnegative-integer?
size:exact-nonnegative-integer?
symbol:symbol?
type:(one-of/c 'address'offset'value'size)
addend:exact-integer?

Represents a relocation.

2Linking🔗 i

procedure
( link-object/local/relative obj)→bin:object?
obj:bin:object?

Resolves local relative references in obj.

3Dynamic Loading🔗 i

This is unsafe (particularly if there are bugs, which is likely) - it could cause crashes or worse!

interface
dynamic-object<%> :interface?

Represents an object which has been loaded into memory.

method
(send a-dynamic-object symbols )→(listof symbol? )
Returns a list of symbols exported by the object.

method
(send a-dynamic-object symbol-ref name)→cpointer?
name:symbol?
Returns a pointer to the requested symbol. This may be cast into a function type.

procedure
( load-object obj)→(is-a?/c dynamic-object<%> )
obj:bin:object?

Loads obj into memory.

4ELF Support🔗 i

(require binutils/elf ) package: binutils

4.1Reading and Writing🔗 i

procedure
( read-elf [in])→(is-a?/c elf% )
in:input-port? =(current-input-port )

Reads an ELF binary from in.

procedure
( write-elf v[out])→void?
v:(is-a?/c elf% )
out:output-port? =(current-output-port )

Writes v as an ELF binary to out.

4.2Conversion🔗 i

procedure
( elf->bin:object elf)→(bin:object? )
elf:(is-a?/c elf% )

Converts elf to a generic object. Some information will be lost in this process.

procedure
( bin:object->elf obj)→(is-a?/c elf% )
obj:bin:object?

Converts obj to an ELF object.

4.3ELF Data Structures🔗 i

These classes represent the ELF format. For details, see the ELF specification and the source code of this module.

class
elf% :class?

superclass:object%

extends: binary<%>

method
(send an-elf repack! )→void?
Adjusts sizes and offsets to fit the contents of the object.

4.4Utilities🔗 i

procedure
( system-elf-class )→(or/c 'elf32'elf64)

Returns the appropriate ELF class for the current processor.

top ← prev up next →