| UMPS3-ELF2UMPS(1) | General Commands Manual | UMPS3-ELF2UMPS(1) |
umps3-elf2umps – The umps3-elf2umps object file conversion utility
umps3-elf2umps [OPTIONS] -k FILE
umps3-elf2umps [OPTIONS] -b FILE
umps3-elf2umps [OPTIONS] -a FILE
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.
This flag can only be used with an executable file.
FILE is the executable or object file to be converted.
Mauro Morsiani
Tomislav Jonjic tjonjic@gmail.com
Contributors can be listed on GitHub.
Report issues on GitHub: https://github.com/virtualsquare/umps3
umps3(1), umps3-mkdev(1), umps3-objdump(1)
Full documentation at: https://github.com/virtualsquare/umps3
Project wiki: https://wiki.virtualsquare.org/#!umps/umps.md
2004, Mauro Morsiani
2010-2011, Tomislav Jonjic tjonjic@gmail.com
| December 2022 |