Man page - umps3-elf2umps(1)

Packages contains this manual

Package: umps3
apt-get install umps3

Manuals in package:

Documentations in package:

umps3

Manual

UMPS3-ELF2UMPS

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
AUTHOR
BUGS
SEE ALSO
COPYRIGHT

NAME

umps3-elf2umps – The umps3-elf2umps object file conversion utility

SYNOPSIS

umps3-elf2umps [ OPTIONS ] -k FILE umps3-elf2umps [ OPTIONS ] -b FILE umps3-elf2umps [ OPTIONS ] -a FILE

DESCRIPTION

The command-line umps3-elf2umps utility is used to convert the ELF formatted executable and object files produced by the gcc cross-platform development tools into the .aout , .core , and .rom formatted files required by uMPS3 .

A successful conversion will produce a file by the name of file.core.umps , file.rom.umps , or file.aout.umps accordingly.

A .stab file is a text file containing a one-line uMPS3-specific header and the contents of the symbol table from the ELF-formatted input file. It is used by the uMPS3 simulator to map .text and .data locations to their symbolic, i.e. kernel/OS source code, names. Hence the automatic generation of the .stab file whenever a .core file is produced. Since .stab files are text files one can also examine/modify them using traditional text-processing tools.

In addition to its utility in tracking down errors in the umps3-elf2umps program (which hopefully no longer exist), the -v flag is of general interest since it illustrates which ELF sections were found and produced and the resulting header data for .core and .aout files. For .rom files, the -v flag also displays the BIOS code size obtained during file conversion.

OPTIONS

	`-v`		Optional flag to produce verbose output during the conversion process.
	`-m`		Optional flag to generate the `.stab` symbol table map file associated with FILE .
	`-k`		Flag to produce a `.core` formatted file. This flag can only be used with an executable file. A `.stab` file is automatically produced with this option.
	`-b`		Flag to produce a `.rom` formatted file. This flag can only be used with an object file that does not contain relocations.
	`-a`		Flag to produce a `.aout` formatted file.

This flag can only be used with an executable file.

FILES

FILE is the executable or object file to be converted.

AUTHOR

Mauro Morsiani
Tomislav Jonjic tjonjic@gmail.com
Contributors can be listed on GitHub.

BUGS

Report issues on GitHub: https://github.com/virtualsquare/umps3

COPYRIGHT

2004, Mauro Morsiani
2010-2011, Tomislav Jonjic tjonjic@gmail.com