MINIX::MINIXFormat Class Reference

MINIX/ELKS a.out file format. More...

#include <minix.h>

Inheritance diagram for MINIX::MINIXFormat:

Public Types
enum	format_type { FormatCombined = 0x10 , FormatSeparate = 0x20 , UnmappedZeroPage = 0x01 }
enum	cpu_type {   I86 = 0x04 , M68K = 0x0B , NS16K = 0x0C , I386 = 0x10 ,   SPARC = 0x17 }

Public Member Functions
void	ReadFile (Linker::Reader &rd) override
	Loads file into memory.
bool	FormatIs16bit () const override
	Whether the format is 16-bit or not.
::EndianType	GetEndianType () const
	MINIXFormat (format_type format, cpu_type cpu=cpu_type(0))
void	SetOptions (std::map< std::string, std::string > &options) override
	Passes command line parameters as settings over to format object.
void	OnNewSegment (std::shared_ptr< Linker::Segment > segment) override
	Callback function when allocating a new segment When the linker script runs, it creates segments consecutively. Overriding this method permits the output format to handle the allocated segment.
void	CreateDefaultSegments ()
std::unique_ptr< Script::List >	GetScript (Linker::Module &module)
void	Link (Linker::Module &module)
void	ProcessModule (Linker::Module &module) override
	Processes the module object and initializes format fields.
void	CalculateValues () override
	Intermediate step between processing module and generating output file to set up headers and management sections It is expected that after a module is processed, additional steps are required to evaluate the final values of the fields.
void	WriteFile (Linker::Writer &wr) override
	Stores data in memory to file.
void	GenerateFile (std::string filename, Linker::Module &module) override
	The main function that handles processing, calculating and generating the final image.
std::string	GetDefaultExtension (Linker::Module &module) override
	Provides a default filename for the output file.
Public Member Functions inherited from Linker::OutputFormat
virtual bool	AddSupplementaryOutputFormat (std::string subformat)
	If the output format actually drives multiple output formats (resource file, apple double, etc.), specify multiple types, return false if unknown.
std::optional< std::string >	FetchOption (std::map< std::string, std::string > &options, std::string name)
	Convenience method to look up option by name.
std::string	FetchOption (std::map< std::string, std::string > &options, std::string name, std::string default_value)
	Convenience method to look up option by name, returning default value if name is missing.
std::optional< offset_t >	FetchIntegerOption (std::map< std::string, std::string > &options, std::string name)
	Convenience method to look up option by name and convert it to integer.
virtual void	SetModel (std::string model)
	Sets the way memory is organized, typically modifying a built-in script.
virtual void	SetLinkScript (std::string script_file, std::map< std::string, std::string > &options)
	Selects a script file to use for linking.
virtual std::string	GetDefaultExtension (Linker::Module &module, std::string filename)
	Appends a default extension to the filename.
virtual bool	FormatSupportsSegmentation () const
	Whether the format supports multiple segments.
virtual bool	FormatIsLinear () const
	Whether the address space is linear or segmented.
virtual bool	FormatSupportsResources () const
	Whether the format supports resources.
virtual bool	FormatSupportsLibraries () const
	Whether the format supports libraries.
virtual unsigned	FormatAdditionalSectionFlags (std::string section_name) const
Public Member Functions inherited from Linker::Format
	Format (offset_t file_offset=0)
virtual void	Clear ()
	Resets all fields to their default values, deallocate memory.
virtual void	Dump (Dumper::Dumper &dump)
	Display file contents in a nice manner.
Public Member Functions inherited from Linker::LinkerManager
void	ClearLinkerManager ()
void	SetLinkScript (std::string script_file, std::map< std::string, std::string > &options)
	Sets up the linker script and linker parameters.
bool	SetLinkerParameter (std::map< std::string, std::string > &options, std::string key)
	Sets a single linker parameter, if inside options.
bool	SetLinkerParameter (std::map< std::string, std::string > &options, std::string key, std::string variable)
	Sets a single linker parameter, if inside options.
std::unique_ptr< Script::List >	GetScript (Linker::Module &module)
	Compiles the linker script into an internal format.
offset_t	GetCurrentAddress () const
	Retrieves current address pointer.
void	SetCurrentAddress (offset_t address)
	Moves the current address pointer further, and if the current segment already contains data, fill it up to the point.
void	AlignCurrentAddress (offset_t align)
	Aligns current address to alignment, using SetCurrentAddress.
void	SetLatestBase (offset_t address)
	Sets the base of the current section (the value from which offsets are counted from)
void	FinishCurrentSegment ()
	Closes the current segment, sets current_segment to null.
std::shared_ptr< Segment >	AppendSegment (std::string name)
	Terminates the current segment (if there is one), creates a new segment and attaches it to the image.
std::shared_ptr< Segment >	FetchSegment (std::string name)
	Attempts to fetch a segment, returns null if not found.
void	AppendSection (std::shared_ptr< Section > section)
	Adds a new section to the current segment, sets the base to the same as the segment.
void	ProcessScript (std::unique_ptr< Script::List > &directives, Module &module)
	Executes a parsed linker script on a module and collects segments The function OnNewSegment can be defined to handle each newly allocated segment.
void	ProcessAction (std::unique_ptr< Script::Node > &action, Module &module)
void	PostProcessAction (std::unique_ptr< Script::Node > &action, Module &module)
void	ProcessCommand (std::unique_ptr< Script::Node > &command, Module &module)
bool	CheckPredicate (std::unique_ptr< Script::Node > &predicate, std::shared_ptr< Section > section, Module &module)
offset_t	EvaluateExpression (std::unique_ptr< Script::Node > &expression, Module &module)

Static Public Member Functions
::EndianType	GetEndianType (cpu_type cpu)

Public Attributes
format_type	format
cpu_type	cpu
uint32_t	code_base_address = 0
uint32_t	heap_top_address = 0
std::shared_ptr< Linker::Segment >	code
std::shared_ptr< Linker::Segment >	data
std::shared_ptr< Linker::Segment >	bss
uint32_t	entry_address = 0
Public Attributes inherited from Linker::Format
offset_t	file_offset
Public Attributes inherited from Linker::LinkerManager
offset_t	current_base = 0
	The base address of the current section.
std::vector< std::shared_ptr< Segment > >	segment_vector
	Ordered sequence of segments.
std::map< std::string, std::shared_ptr< Segment > >	segment_map
	Map of segments from their names.
std::shared_ptr< Segment >	current_segment
	Currently processed segment.
std::map< std::string, Location >	linker_parameters
	Parameters that permit customizing the linker script.
std::string	linker_script
	Contents of the linker script.

Static Public Attributes
static constexpr size_t	PAGE_SIZE = 0x1000

Additional Inherited Members
Protected Attributes inherited from Linker::LinkerManager
offset_t	current_address = 0
	Holds the current address value when there is no current_segment.
bool	current_is_template = false
bool	current_is_template_head = false
offset_t	template_counter = 0
std::string	current_template_name

Detailed Description

MINIX/ELKS a.out file format.

This is the native executable format for MINX and ELKS (Linux for 8086)

Member Function Documentation

CalculateValues()

void MINIXFormat::CalculateValues ( )

overridevirtual

Intermediate step between processing module and generating output file to set up headers and management sections It is expected that after a module is processed, additional steps are required to evaluate the final values of the fields.

Reimplemented from Linker::OutputFormat.

FormatIs16bit()

bool MINIXFormat::FormatIs16bit ( ) const

overridevirtual

Whether the format is 16-bit or not.

This is needed for the ELF parser which can not distinguish between the 8086 and 80386 backends.

Reimplemented from Linker::OutputFormat.

GenerateFile()

void MINIXFormat::GenerateFile ( std::string filename, Linker::Module & module )

overridevirtual

The main function that handles processing, calculating and generating the final image.

Reimplemented from Linker::OutputFormat.

GetDefaultExtension()

std::string MINIXFormat::GetDefaultExtension ( Linker::Module & module )

overridevirtual

Provides a default filename for the output file.

Typically a.out or some other extension, such as a.exe.

Reimplemented from Linker::OutputFormat.

OnNewSegment()

void MINIXFormat::OnNewSegment ( std::shared_ptr< Linker::Segment > segment )

overridevirtual

Callback function when allocating a new segment When the linker script runs, it creates segments consecutively. Overriding this method permits the output format to handle the allocated segment.

Reimplemented from Linker::LinkerManager.

ProcessModule()

void MINIXFormat::ProcessModule ( Linker::Module & object )

overridevirtual

Processes the module object and initializes format fields.

Reimplemented from Linker::OutputFormat.

ReadFile()

void MINIXFormat::ReadFile ( Linker::Reader & in )

overridevirtual

Loads file into memory.

Implements Linker::Format.

SetOptions()

void MINIXFormat::SetOptions ( std::map< std::string, std::string > & options )

overridevirtual

Passes command line parameters as settings over to format object.

Reimplemented from Linker::OutputFormat.

WriteFile()

void MINIXFormat::WriteFile ( Linker::Writer & out )

overridevirtual

Stores data in memory to file.

Implements Linker::Format.

---

The documentation for this class was generated from the following files:

• src/format/minix.h
• src/format/minix.cc