umps3-elf2umps1

Usage

Overview

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.