122 lines
2.9 KiB
C++
122 lines
2.9 KiB
C++
/*
|
|
* \brief Dynamic linker interface
|
|
* \author Sebastian Sumpf
|
|
* \date 2014-10-09
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2014-2017 Genode Labs GmbH
|
|
*
|
|
* This file is part of the Genode OS framework, which is distributed
|
|
* under the terms of the GNU Affero General Public License version 3.
|
|
*/
|
|
|
|
#ifndef _INCLUDE__BASE__SHARED_OBJECT_H_
|
|
#define _INCLUDE__BASE__SHARED_OBJECT_H_
|
|
|
|
#include <base/env.h>
|
|
#include <base/allocator.h>
|
|
#include <base/exception.h>
|
|
#include <base/stdint.h>
|
|
|
|
namespace Genode {
|
|
|
|
class Shared_object;
|
|
struct Address_info;
|
|
};
|
|
|
|
|
|
class Genode::Shared_object
|
|
{
|
|
private:
|
|
|
|
void *_handle = nullptr;
|
|
void *_lookup(const char *symbol) const;
|
|
|
|
Allocator &_md_alloc;
|
|
|
|
/*
|
|
* Noncopyable
|
|
*/
|
|
Shared_object(Shared_object const &);
|
|
Shared_object &operator = (Shared_object const &);
|
|
|
|
public:
|
|
|
|
class Invalid_rom_module : public Genode::Exception { };
|
|
class Invalid_symbol : public Genode::Exception { };
|
|
|
|
enum Keep { DONT_KEEP, KEEP };
|
|
enum Bind { BIND_LAZY, BIND_NOW };
|
|
|
|
/**
|
|
* Load shared object and dependencies
|
|
*
|
|
* \param env Genode environment, needed to obtain the ROM module
|
|
* for the shared object and to populate the linker
|
|
* area of the component's address space
|
|
* \param md_alloc backing store for the linker's dynamically allocated
|
|
* meta data
|
|
* \param name ROM module name of shared object to load
|
|
* \param bind bind functions immediately (BIND_NOW) or on
|
|
* demand (BIND_LAZY)
|
|
* \param keep unload ELF object if no longer needed (DONT_KEEP),
|
|
* or keep ELF object loaded at all times (KEEP)
|
|
*
|
|
* \throw Invalid_rom_module
|
|
*/
|
|
Shared_object(Env &, Allocator &md_alloc, char const *name,
|
|
Bind bind, Keep keep);
|
|
|
|
/**
|
|
* Close and unload shared object
|
|
*/
|
|
~Shared_object();
|
|
|
|
/**
|
|
* Lookup a symbol in shared object and it's dependencies
|
|
*
|
|
* \param symbol Symbol name
|
|
*
|
|
* \throw Invalid_symbol
|
|
*
|
|
* \return Symbol address
|
|
*/
|
|
template<typename T = void *> T lookup(const char *symbol) const
|
|
{
|
|
return reinterpret_cast<T>(_lookup(symbol));
|
|
}
|
|
|
|
/**
|
|
* Link information
|
|
*/
|
|
struct Link_map
|
|
{
|
|
Genode::addr_t addr; /* load address */
|
|
char const *path; /* object path */
|
|
void const *dynamic; /* pointer to DYNAMIC section */
|
|
Link_map const *next;
|
|
Link_map const *prev;
|
|
};
|
|
|
|
/**
|
|
* Return link map of shared object
|
|
*/
|
|
Link_map const &link_map() const;
|
|
};
|
|
|
|
|
|
struct Genode::Address_info
|
|
{
|
|
char const *path { nullptr }; /* path of shared object */
|
|
Genode::addr_t base { 0 }; /* base of shared object */
|
|
char const *name { nullptr }; /* name of symbol */
|
|
Genode::addr_t addr { 0 }; /* address of symbol */
|
|
|
|
class Invalid_address : public Genode::Exception { };
|
|
|
|
Address_info(Genode::addr_t addr);
|
|
};
|
|
|
|
#endif /* _INCLUDE__BASE__SHARED_OBJECT_H_ */
|