#include <DynamicLinker.h>

Collaboration diagram for DynamicLinker:

Classes
struct	SharedObject

Public Member Functions
	DynamicLinker ()

	DynamicLinker (DynamicLinker &other)

bool	checkInterpreter (File *pFile, String &actualFilename)

bool	checkDependencies (File *pFile)

bool	loadProgram (File pFile, bool bDryRun=false, bool bInterpreter=false, String sInterpreter=0)

bool	loadObject (File *pFile, bool bDryRun=false)

bool	trap (uintptr_t address)

Elf *	getProgramElf ()

uintptr_t	resolve (String name)

Static Public Member Functions
static uintptr_t	resolvePlt (SyscallState &state)

Private Member Functions
DynamicLinker &	operator= (const DynamicLinker &)

uintptr_t	resolvePltSymbol (uintptr_t libraryId, uintptr_t symIdx)

void	initPlt (Elf *pElf, uintptr_t value)

Private Attributes
Elf *	m_pProgramElf

uintptr_t	m_ProgramStart

size_t	m_ProgramSize

uintptr_t	m_ProgramBuffer

RadixTree< void * >	m_LoadedObjects

Tree< uintptr_t, SharedObject * >	m_Objects

Detailed Description

The dynamic linker tracks instances of shared objects through an address space.

Definition at line 37 of file DynamicLinker.h.

Constructor & Destructor Documentation

DynamicLinker::DynamicLinker ( )

Creates a new DynamicLinker object.

Definition at line 53 of file DynamicLinker.cc.

DynamicLinker::DynamicLinker ( DynamicLinker & other )

Creates a new DynamicLinker from another. Copies all mappings.

Definition at line 59 of file DynamicLinker.cc.

Member Function Documentation

bool DynamicLinker::checkDependencies ( File * pFile )

inline

Checks dependencies for a given program. Returns true if all dependencies are available and loadable, false if not.

Definition at line 57 of file DynamicLinker.h.

bool DynamicLinker::checkInterpreter	(	File *	pFile,
		String &	actualFilename
	)

inline

Checks the given program for a requested interpreter, that we should run instead of loading the binary ourselves.

Definition at line 50 of file DynamicLinker.h.

Referenced by PosixSubsystem::invoke().

Here is the caller graph for this function:

Elf* DynamicLinker::getProgramElf ( )

inline

Returns the program ELF.

Definition at line 86 of file DynamicLinker.h.

void DynamicLinker::initPlt	(	Elf *	pElf,
		uintptr_t	value
	)

private

Todo:: ARMify

Todo:: Change this to use the size of the elf!

Todo:: Page size here.

Todo:: Page size here.

Definition at line 32 of file amd64/DynamicLinker.cc.

References PhysicalMemoryManager::allocatePage(), ERROR, VirtualAddressSpace::Execute, Elf::getGlobalOffsetTable(), Processor::information(), PhysicalMemoryManager::instance(), NOTICE, WARNING, and VirtualAddressSpace::Write.

Referenced by loadObject(), and loadProgram().

Here is the caller graph for this function:

bool DynamicLinker::loadObject	(	File *	pFile,
		bool	bDryRun = `false`
	)

Loads a shared object into this address space (along with any dependencies.

Parameters

pFile The ELF object to load.

Returns: True if the ELF and all dependencies was loaded successfully.

Definition at line 246 of file DynamicLinker.cc.

References Elf::allocate(), List< T, nodePoolSize >::begin(), Elf::create(), Elf::createNeededOnly(), List< T, nodePoolSize >::end(), ERROR, VFS::find(), Symlink::followLink(), Symlink::fromFile(), File::getName(), initPlt(), RadixTree< T >::insert(), VFS::instance(), MemoryMapManager::instance(), File::isSymlink(), RadixTree< T >::lookup(), MemoryMapManager::mapFile(), Elf::neededLibraries(), NOTICE, and WARNING.

Referenced by loadProgram().

Here is the caller graph for this function:

bool DynamicLinker::loadProgram	(	File *	pFile,
		bool	bDryRun = `false`,
		bool	bInterpreter = `false`,
		String *	sInterpreter = `0`
	)

Loads the main program. This must be an ELF file, and the linker will also load all library dependencies. If any of these loads fails, false is returned.

Parameters

pFile The ELF file.

Definition at line 94 of file DynamicLinker.cc.

References Elf::allocate(), List< T, nodePoolSize >::begin(), Elf::create(), Elf::createNeededOnly(), List< T, nodePoolSize >::end(), ERROR, VFS::find(), Symlink::followLink(), Symlink::fromFile(), Elf::getInterpreter(), File::getName(), initPlt(), RadixTree< T >::insert(), VFS::instance(), MemoryMapManager::instance(), File::isSymlink(), loadObject(), RadixTree< T >::lookup(), MemoryMapManager::mapFile(), Elf::neededLibraries(), NOTICE, MemoryMapManager::unmap(), and WARNING.