docs/CommandGuide/llvm-dis.rst

   1 llvm-dis - LLVM disassembler
   2 ============================
   3
   4 .. program:: llvm-dis
   5
   6 SYNOPSIS
   7 --------
   8
   9
  10 **llvm-dis** [*options*] [*filename*]
  11
  12
  13 DESCRIPTION
  14 -----------
  15
  16
  17 The **llvm-dis** command is the LLVM disassembler.  It takes an LLVM
  18 bitcode file and converts it into human-readable LLVM assembly language.
  19
  20 If filename is omitted or specified as ``-``, **llvm-dis** reads its
  21 input from standard input.
  22
  23 If the input is being read from standard input, then **llvm-dis**
  24 will send its output to standard output by default.  Otherwise, the
  25 output will be written to a file named after the input file, with
  26 a ``.ll`` suffix added (any existing ``.bc`` suffix will first be
  27 removed).  You can override the choice of output file using the
  28 **-o** option.
  29
  30
  31 OPTIONS
  32 -------
  33
  34
  35
  36 **-f**
  37
  38  Enable binary output on terminals.  Normally, **llvm-dis** will refuse to
  39  write raw bitcode output if the output stream is a terminal. With this option,
  40  **llvm-dis** will write raw bitcode regardless of the output device.
  41
  42
  43
  44 **-help**
  45
  46  Print a summary of command line options.
  47
  48
  49
  50 **-o** *filename*
  51
  52  Specify the output file name.  If *filename* is -, then the output is sent
  53  to standard output.
  54
  55
  56
  57
  58 EXIT STATUS
  59 -----------
  60
  61
  62 If **llvm-dis** succeeds, it will exit with 0.  Otherwise, if an error
  63 occurs, it will exit with a non-zero value.
  64
  65
  66 SEE ALSO
  67 --------
  68
  69
  70 llvm-as|llvm-as