fit.interfaces package

Subpackages

• fit.interfaces.gdb package
  • Submodules
  • fit.interfaces.gdb.boards module
    • BoardsFamilies
      • BoardsFamilies.STM32
      • BoardsFamilies.UNKNOWN
  • fit.interfaces.gdb.controller module
    • GDBController
      • GDBController.await_response()
      • GDBController.controller
      • GDBController.exit()
      • GDBController.flush()
      • GDBController.wait_response()
      • GDBController.write()
    • check()
  • fit.interfaces.gdb.gdb_injector module
    • GDBInjector
      • GDBInjector.Breakpoint
      • GDBInjector.State
      • GDBInjector.board_family
      • GDBInjector.breakpoints
      • GDBInjector.close()
      • GDBInjector.controller
      • GDBInjector.embedded
      • GDBInjector.endianness
      • GDBInjector.gdb_path
      • GDBInjector.get_mappings()
      • GDBInjector.get_register_names()
      • GDBInjector.interrupt()
      • GDBInjector.is_running()
      • GDBInjector.read_memory()
      • GDBInjector.read_register()
      • GDBInjector.register_names
      • GDBInjector.remote()
      • GDBInjector.reset()
      • GDBInjector.reset_functions
      • GDBInjector.reset_stm32()
      • GDBInjector.reset_unknown()
      • GDBInjector.run()
      • GDBInjector.set_event()
      • GDBInjector.state
      • GDBInjector.word_size
      • GDBInjector.write_memory()
      • GDBInjector.write_register()
    • get_int()
    • parse_memory()
    • to_gdb_hex()
  • Module contents

Submodules

fit.interfaces.implementations module

class fit.interfaces.implementations.Implementation(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

Enumeration class for the available injector implementations.

GDB = 1

classmethod from_string(s)

Function that returns the injector class corresponding to a given implementation name.

Parameters:

s (str) – the implementation name.

Return type:

Type[InternalInjector]

Returns:

the class corresponding to the given implementation name.

fit.interfaces.internal_injector module

class fit.interfaces.internal_injector.InternalInjector(elf_path, **kwargs)

Bases: ABC

Abstract class for managing the injection process into an ELF binary.

abstract close()

Function that closes the GDB session and exit the controller.

Return type:

None

classmethod get_class()

Function that returns the class type.

Return type:

Type[Self]

Returns:

the class type.

abstract get_mappings()

Return type:

list[Mapping]

abstract get_register_names()

Return type:

list[str]

abstract interrupt()

Return type:

Optional[str]

abstract is_running()

Return type:

bool

abstract read_memory(address, count)

Function that reads a memory word from the target.

Parameters:

• address (int) – the memory address to read from.

• count (int) – the number of bytes to read.

Return type:

list[int]

Returns:

the values read from the target.

abstract read_register(register)

Function that reads a register from the target.

Parameters:

register (str) – the register to read.

Return type:

int

Returns:

the value read from the target.

abstract reset()

Function that resets the injector to a known initial state. Useful between test runs or injections.

Return type:

None

abstract run(blocking=True, stop_event=None)

Function that runs the injector for a given amount of time.

Parameters:

• blocking (bool) – whether to block until the precess stops.

• stop_event (Optional[Event]) – synchronization variable that needs to be checked when waiting for a timeout

Return type:

str

Returns:

the name of the breakpoint hit.

abstract set_event(event)

Function that sets a specific event for this target.

Parameters:

event (str) – the event to set.

Return type:

None

abstract write_memory(address, value, repeat)

Function that writes a memory word from the target.

Parameters:

• address (int) – the memory address to write to.

• value (list[int]) – the value to write.

• repeat (int) – the number of times to write the value.

Return type:

None

abstract write_register(register, value)

Function that writes a register from the target.

Parameters:

• register (str) – the register to write.

• value (int) – the value to write.

Return type:

None

Module contents