====================
Tool: mp_bin2objdump
====================

--------
Overview
--------

The **mp_bin2objdump** tool provides an interface to disassemble raw binary 
files. Some of the back-ends for Microprobe generate ``*.bin`` files that 
contain the generated codified instructions. In order to debug and check what 
it is generated, one can use this tool and get the corresponding assembly.
This differs from **mp_bin2asm** tool in that it generates an output similar
to the one used by **GNU objdump** in binutils.  

-----------
Basic usage
-----------

::

   > mp_bin2objdump -T TARGET -i INPUT_BIN_FILE > OBJDUMP_FILE

where:

============================================================ =================================================================
Flag/Argument                                                Description
============================================================ =================================================================
``-T TARGET``, ``--target TARGET``                           Target definition string. Check: :doc:`tools_target_definition`.
``-i INPUT_BIN_FILE``, ``--input-bin-file INPUT_BIN_FILE``   Input binary file.
============================================================ =================================================================

----------
Full usage
----------

.. program-output:: ../../targets/generic/tools/mp_bin2objdump.py --help

---------------
Example outputs
---------------

.. rubric:: Example 1:

Command::

   > mp_bin2objdump -T z13-z13-z64_mesa_st -i input.bin 
   
Output:

.. program-output:: ../../targets/generic/tools/mp_bin2objdump.py -P ../../targets/ -T z13-z13-z64_mesa_st -i ../../targets/z/tests/tools/bin2objdump_test001.bin
  
