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-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)