Module `stm8dce.rel_analysis`

This module provides classes and functions for analyzing .rel and .lib files

Functions

def modules_by_defined_symbol(modules, symbol_name)

Returns a list of modules that define the given symbol.

Args

modules : list: List of Module objects.
symbol_name : str: The symbol to search for.

Returns

list: List of modules that define the symbol.

Classes

class Module

Class to represent a module in the .rel or .lib file.

Attributes

path : str: Path to the file containing the module.
line_number : int: Line number in the file where the module starts.
name : str: The name of the module.
referenced_symbols : list: Symbols referenced by this module.
defined_symbols : list: Symbols defined by this module.
referenced_by : list: ASM functions that reference this module.
references : list: ASM Functions or constants referenced by this module.

Initializes the Module with the given path and line_number.

Args

path : str: The file path of the module.
line_number : int: The line number in the file.

Methods

def __init__(self, path, line_number)

Initializes the Module with the given path and line_number.

Args

path : str: The file path of the module.
line_number : int: The line number in the file.

def __repr__(self)

Return repr(self).

def __str__(self)

Return str(self).

def add_defined_symbol(self, symbol)

Adds a symbol to the list of defined symbols.

Args

symbol : str: The symbol to add.

def add_referenced_symbol(self, symbol)

Adds a symbol to the list of referenced symbols.

Args

symbol : str: The symbol to add.

def print(self)

Prints the details of the module.

def resolve_incoming_references(self, keep_functions, all_initializers)

Resolves incoming references for the module. This means finding the functions that reference this module's defined symbols.

Args

keep_functions : list: List of kept function objects.
all_initializers : list: List of all initializer objects.

def resolve_outgoing_references(self, all_functions, all_constants)

Resolves outgoing references for the module. This means finding the functions and constants that this module references.

Args

all_functions : list: List of all function objects.
all_constants : list: List of all constant objects.

def resolve_references(self, keep_functions, all_initializers, all_functions, all_constants)

Resolves references for the module by calling incoming and outgoing reference resolvers. Resolving means: - Find the functions that reference this module's defined symbols - Find the functions and constants that this module references

Args

keep_functions : list: List of kept function objects.
all_initializers : list: List of all initializer objects.
all_functions : list: List of all function objects.
all_constants : list: List of all constant objects.

def set_name(self, name)

Sets the name of the module.

Args

name : str: The name to set for the module.