rtl-unresolved.c File Reference

RTEMS Run-Time Linker Object File Unresolved Relocations Table. More...

#include <errno.h>
#include <inttypes.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <rtems/rtl/rtl.h>
#include "rtl-error.h"
#include <rtems/rtl/rtl-unresolved.h>
#include <rtems/rtl/rtl-trace.h>

Data Structures
struct	rtl_unresolved_name_data
struct	rtems_rtl_unresolved_reloc_data
struct	rtems_rtl_unresolved_archive_reloc_data
struct	rtems_rtl_unresolved_dump_data

Typedefs
typedef struct rtems_rtl_unresolved_reloc_data	rtems_rtl_unresolved_reloc_data
typedef struct rtems_rtl_unresolved_archive_reloc_data	rtems_rtl_unresolved_archive_reloc_data
typedef struct rtems_rtl_unresolved_dump_data	rtems_rtl_unresolved_dump_data

Functions
bool	rtems_rtl_unresolved_table_open (rtems_rtl_unresolved *unresolved, size_t block_recs)
void	rtems_rtl_unresolved_table_close (rtems_rtl_unresolved *unresolved)
bool	rtems_rtl_unresolved_iterate (rtems_rtl_unresolved_iterator iterator, void *data)
bool	rtems_rtl_unresolved_add (rtems_rtl_obj *obj, const uint16_t flags, const char *name, const uint16_t sect, const rtems_rtl_word *rel)
void	rtems_rtl_unresolved_resolve (void)
bool	rtems_rtl_unresolved_remove (rtems_rtl_obj *obj, const char *name, const uint16_t sect, const rtems_rtl_word *rel)
void	rtems_rtl_unresolved_dump (void)
void	rtems_rtl_unresolved_set_archive_search (void)

Detailed Description

RTEMS Run-Time Linker Object File Unresolved Relocations Table.

Typedef Documentation

rtems_rtl_unresolved_archive_reloc_data

typedef struct rtems_rtl_unresolved_archive_reloc_data rtems_rtl_unresolved_archive_reloc_data

Struct to pass archive relocation data in the iterator.

rtems_rtl_unresolved_dump_data

typedef struct rtems_rtl_unresolved_dump_data rtems_rtl_unresolved_dump_data

Struct to pass relocation data in the iterator.

rtems_rtl_unresolved_reloc_data

typedef struct rtems_rtl_unresolved_reloc_data rtems_rtl_unresolved_reloc_data

Struct to pass relocation data in the iterator.

Function Documentation

rtems_rtl_unresolved_add()

bool rtems_rtl_unresolved_add	(	rtems_rtl_obj *	obj,
		const uint16_t	flags,
		const char *	name,
		const uint16_t	sect,
		const rtems_rtl_word *	rel
	)

Add a relocation to the list of unresolved relocations.

Parameters

unresolved	The unresolved symbol table.
obj	The object table the symbols are for.
flags	Format specific flags.
name	The symbol name the relocation references.
sect	The target section number the relocation references.
rel	The format specific relocation data.

Return values

true	The relocation has been added.
false	The relocation could not be added.

rtems_rtl_unresolved_dump()

void rtems_rtl_unresolved_dump

(

void

)

Dump the RTL unresolved data.

rtems_rtl_unresolved_iterate()

bool rtems_rtl_unresolved_iterate	(	rtems_rtl_unresolved_iterator	iterator,
		void *	data
	)

Iterate over the table of unresolved entries.

rtems_rtl_unresolved_remove()

bool rtems_rtl_unresolved_remove	(	rtems_rtl_obj *	obj,
		const char *	name,
		const uint16_t	sect,
		const rtems_rtl_word *	rel
	)

Remove a relocation from the list of unresolved relocations.

Parameters

unresolved	The unresolved symbol table.
obj	The object table the symbols are for.
esyms	The exported symbol table.
size	The size of the table in bytes.

rtems_rtl_unresolved_resolve()

void rtems_rtl_unresolved_resolve

(

void

)

Resolve the unresolved symbols.

rtems_rtl_unresolved_set_archive_search()

void rtems_rtl_unresolved_set_archive_search

(

void

)

Set all symbols to be archive searchable. This is done when the available archives have been refreshed and there are new archives to search for.

rtems_rtl_unresolved_table_close()

void rtems_rtl_unresolved_table_close

(

rtems_rtl_unresolved *

unresolved

)

Close the table and erase the blocks.

Parameters

unreolved

Close the unresolved table.

rtems_rtl_unresolved_table_open()

bool rtems_rtl_unresolved_table_open	(	rtems_rtl_unresolved *	unresolved,
		size_t	block_records
	)

Open an unresolved relocation table.

Parameters

unresolv	The unresolved table to open.
block_records	The number of records per block allocated.

Return values

true	The table is open.
false	The unresolved relocation table could not created. The RTL error has the error.