---
name: "umps3-elf2umps"
section: "1"
platform: "linux"
package: "umps3"
version: "3.0.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/umps3-elf2umps"
---

# umps3-elf2umps(1)

The umps3-elf2umps object file conversion utility

## 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*

## SEE ALSO

[**umps3**(1)](/umps3/1.md), [**umps3-mkdev**(1)](/umps3-mkdev/1.md), [**umps3-objdump**(1)](/umps3-objdump/1.md)

Full documentation at: *https://github.com/virtualsquare/umps3*

Project wiki: *https://wiki.virtualsquare.org/#!umps/umps.md*

## COPYRIGHT

2004, Mauro Morsiani

2010-2011, Tomislav Jonjic *tjonjic@gmail.com*