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

                                           August 2020                          UMPS3-ELF2UMPS(1)