examples/customization/bin-utils/README

   1 Files in this directory:
   2
   3 o .lldbinit:
   4
   5 An example lldb init file that imports the binutils.py module and adds the
   6 following commands: 'itob' and 'utob'.
   7
   8 o binutils.py:
   9
  10 Python module which provides implementation for the 'itob' and 'utob' commands.
  11
  12 o README:
  13
  14 The file you are reading now.
  15
  16 ================================================================================
  17 The following terminal output shows an interaction with lldb using the .lldbinit
  18 and the binutils.py files which are located in my HOME directory.  The lldb init
  19 file imports the utils Python module and adds the 'itob' and 'utob' commands.
  20
  21 $ /Volumes/data/lldb/svn/trunk/build/Debug/lldb
  22 (lldb) help itob
  23 Convert the integer to print its two's complement representation.
  24     args[0] (mandatory) is the integer to be converted
  25     args[1] (mandatory) is the bit width of the two's complement representation
  26     args[2] (optional) if specified, turns on verbose printing
  27 Syntax: itob
  28 (lldb) itob -5 4
  29  [1, 0, 1, 1]
  30 (lldb) itob -5 32 v
  31  31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10  9  8  7  6  5  4  3  2  1  0
  32  [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1]
  33 (lldb) utob 0xABCD 32 v
  34  31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10  9  8  7  6  5  4  3  2  1  0
  35  [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 1]
  36 (lldb)