= Loader =

Loader is an utility used to load binary files into platforms.
It holds information about one or more files, and may load any loadable section by its address and size.

== Usage ==

 * {{{Loader( const std::string &filename )}}}

Creates a new Loader, capable of loading `filename`.

 * {{{void load( void *buffer, uintptr_t address, size_t length )}}}

`buffer` must be at least `length` bytes long.

Loads in buffer any segment overlapping memory region between `address` to `address+length`.
Used addresses are LMAs (loading memory address) of sections.

If a section is too big to fit in the given buffer, it is truncated and a warning is generated to stderr.

== Handlers ==

Loader does not directly handle different file types. It relies on handlers to support all needed file types.
Your platform must link against needed file loader handler to work properly.

For instance, to support ELF files, you need to add the following line to your platform_desc:
{{{
  Uses('common:elf_file_loader'),
}}}

Handlers are tried in order, and if all fails, error is raised.