tools/llvm-bcanalyzer/llvm-bcanalyzer.cpp

   1 //===-- llvm-bcanalyzer.cpp - Byte Code Analyzer --------------------------===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file was developed by Reid Spencer and is distributed under the
   6 // University of Illinois Open Source License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This tool may be invoked in the following manner:
  11 //  llvm-bcanalyzer [options]      - Read LLVM bytecode from stdin
  12 //  llvm-bcanalyzer [options] x.bc - Read LLVM bytecode from the x.bc file
  13 //
  14 //  Options:
  15 //      --help      - Output information about command line switches
  16 //      --nodetails - Don't print out detailed informaton about individual
  17 //                    blocks and functions
  18 //      --dump      - Dump low-level bytecode structure in readable format
  19 //
  20 // This tool provides analytical information about a bytecode file. It is
  21 // intended as an aid to developers of bytecode reading and writing software. It
  22 // produces on std::out a summary of the bytecode file that shows various
  23 // statistics about the contents of the file. By default this information is
  24 // detailed and contains information about individual bytecode blocks and the
  25 // functions in the module. To avoid this more detailed output, use the
  26 // -nodetails option to limit the output to just module level information.
  27 // The tool is also able to print a bytecode file in a straight forward text
  28 // format that shows the containment and relationships of the information in
  29 // the bytecode file (-dump option).
  30 //===----------------------------------------------------------------------===//
  31
  32 #include "llvm/Analysis/Verifier.h"
  33 #include "llvm/Bytecode/Analyzer.h"
  34 #include "llvm/Support/CommandLine.h"
  35 #include "llvm/Support/ManagedStatic.h"
  36 #include "llvm/System/Signals.h"
  37 #include <fstream>
  38 #include <iostream>
  39
  40 using namespace llvm;
  41
  42 static cl::opt<std::string>
  43   InputFilename(cl::Positional, cl::desc("<input bytecode>"), cl::init("-"));
  44
  45 static cl::opt<std::string>
  46   OutputFilename("-o", cl::init("-"), cl::desc("<output file>"));
  47
  48 static cl::opt<bool> NoDetails ("nodetails", cl::desc("Skip detailed output"));
  49 static cl::opt<bool> Dump      ("dump", cl::desc("Dump low level bytecode trace"));
  50 static cl::opt<bool> Verify    ("verify", cl::desc("Progressively verify module"));
  51
  52 int main(int argc, char **argv) {
  53   llvm_shutdown_obj X;  // Call llvm_shutdown() on exit.
  54   try {
  55     cl::ParseCommandLineOptions(argc, argv,
  56       " llvm-bcanalyzer Analysis of ByteCode Dumper\n");
  57
  58     sys::PrintStackTraceOnErrorSignal();
  59
  60     std::ostream* Out = &std::cout;  // Default to printing to stdout...
  61     std::string ErrorMessage;
  62     BytecodeAnalysis bca;
  63
  64     /// Determine what to generate
  65     bca.detailedResults = !NoDetails;
  66     bca.progressiveVerify = Verify;
  67
  68     /// Analyze the bytecode file
  69     Module* M = AnalyzeBytecodeFile(InputFilename, bca, &ErrorMessage, (Dump?Out:0));
  70
  71     // All that bcanalyzer does is write the gathered statistics to the output
  72     PrintBytecodeAnalysis(bca,*Out);
  73
  74     if ( M && Verify ) {
  75       std::string verificationMsg;
  76       if (verifyModule(*M, ReturnStatusAction, &verificationMsg))
  77         std::cerr << "Final Verification Message: " << verificationMsg << "\n";
  78     }
  79
  80     if (Out != &std::cout) {
  81       ((std::ofstream*)Out)->close();
  82       delete Out;
  83     }
  84     return 0;
  85   } catch (const std::string& msg) {
  86     std::cerr << argv[0] << ": " << msg << "\n";
  87   } catch (...) {
  88     std::cerr << argv[0] << ": Unexpected unknown exception occurred.\n";
  89   }
  90   return 1;
  91 }
  92
  93 // vim: sw=2