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  re‐
       quired 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 loca‐
       tions 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  dis‐
       plays 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-mkdev(1), umps3-objdump(1)

       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
                                                  December 2022                                UMPS3-ELF2UMPS(1)