docs/CommandGuide/analyze.html

   1 <html>
   2 <title>
   3 LLVM: analyze tool
   4 </title>
   5
   6 <body bgcolor=white>
   7
   8 <center><h1>LLVM: <tt>analyze</tt> tool</h1></center>
   9 <HR>
  10
  11 <h3>NAME</h3>
  12 <tt>analyze</tt>
  13
  14 <h3>SYNOPSIS</h3>
  15 <tt>analyze [options] [filename]</tt>
  16
  17 <h3>DESCRIPTION</h3>
  18
  19 The <tt>analyze</tt> command performs various analysis of LLVM assembly code or
  20 bytecode.  It will usually print the results on standard output, but in a few
  21 cases, it will print output to standard error or generate a file with the
  22 analysis output (which is usually done when the output is meant for another
  23 program).
  24 <p>
  25 If filename is omitted or is -, <tt>analyze</tt> reads its input from standard
  26 input.  It first attempts to interpret its input as LLVM bytecode.  If it
  27 encounters an error, it then attempts to parse the input as LLVM assembly
  28 language.
  29
  30 <h3>OPTIONS</h3>
  31
  32 <ul>
  33         <li> -help
  34         <br>
  35         Print a summary of command line options.
  36         <p>
  37
  38         <li> -q
  39         <br>
  40         Quiet mode.  With this option, analysis pass names are not printed.
  41         <p>
  42
  43         <li> -load &lt;plugin&gt;
  44         <br>
  45         Load the specified dynamic object with name <tt>plugin</tt>.  This file
  46         should contain additional analysis passes that register themselves with
  47         the <tt>analyze</tt> program after being loaded.
  48         <p>
  49
  50         After being loaded, additional command line options are made available
  51         for running the passes made available by <tt>plugin</tt>.  Use
  52         '<tt><tt>analyze</tt> -load &lt;plugin&gt; -help</tt>' to see the new
  53         list of available analysis passes.
  54         <p>
  55
  56         <li> -profile-info-file &lt;filename&gt;
  57         <br>
  58         Specify the name of the file loaded by the -profile-loader option.
  59         <p>
  60
  61         <li> -stats
  62         <br>
  63         Print statistics.
  64         <p>
  65
  66         <li> -time-passes
  67         <br>
  68         Record the amount of time needed for each pass and print it to standard
  69         error.
  70         <p>
  71 </ul>
  72
  73 <h3>EXIT STATUS</h3>
  74
  75 If <tt>analyze</tt> succeeds, it will exit with 0.  Otherwise, if an error
  76 occurs, it will exit with a non-zero value.
  77
  78 <h3>SEE ALSO</h3>
  79
  80 <a href="opt.html"><tt>opt</tt></a>
  81
  82 <HR>
  83 Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
  84 </body>
  85 </html>
  86