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)