From 58b69754af0cbff56b1cfce9be9392e4451f6628 Mon Sep 17 00:00:00 2001 From: Dimitry Andric Date: Wed, 15 Aug 2012 19:34:23 +0000 Subject: Vendor import of llvm trunk r161861: http://llvm.org/svn/llvm-project/llvm/trunk@161861 --- docs/CommandGuide/llvm-bcanalyzer.pod | 315 ---------------------------------- 1 file changed, 315 deletions(-) delete mode 100644 docs/CommandGuide/llvm-bcanalyzer.pod (limited to 'docs/CommandGuide/llvm-bcanalyzer.pod') diff --git a/docs/CommandGuide/llvm-bcanalyzer.pod b/docs/CommandGuide/llvm-bcanalyzer.pod deleted file mode 100644 index 9c5021b639f1..000000000000 --- a/docs/CommandGuide/llvm-bcanalyzer.pod +++ /dev/null @@ -1,315 +0,0 @@ -=pod - -=head1 NAME - -llvm-bcanalyzer - LLVM bitcode analyzer - -=head1 SYNOPSIS - -B [I] [F] - -=head1 DESCRIPTION - -The B command is a small utility for analyzing bitcode files. -The tool reads a bitcode file (such as generated with the B tool) and -produces a statistical report on the contents of the bitcode file. The tool -can also dump a low level but human readable version of the bitcode file. -This tool is probably not of much interest or utility except for those working -directly with the bitcode file format. Most LLVM users can just ignore -this tool. - -If F is omitted or is C<->, then B reads its input -from standard input. This is useful for combining the tool into a pipeline. -Output is written to the standard output. - -=head1 OPTIONS - -=over - -=item B<-nodetails> - -Causes B to abbreviate its output by writing out only a module -level summary. The details for individual functions are not displayed. - -=item B<-dump> - -Causes B to dump the bitcode in a human readable format. This -format is significantly different from LLVM assembly and provides details about -the encoding of the bitcode file. - -=item B<-verify> - -Causes B to verify the module produced by reading the -bitcode. This ensures that the statistics generated are based on a consistent -module. - -=item B<-help> - -Print a summary of command line options. - -=back - -=head1 EXIT STATUS - -If B succeeds, it will exit with 0. Otherwise, if an error -occurs, it will exit with a non-zero value, usually 1. - -=head1 SUMMARY OUTPUT DEFINITIONS - -The following items are always printed by llvm-bcanalyzer. They comprize the -summary output. - -=over - -=item B - -This just provides the name of the module for which bitcode analysis is being -generated. - -=item B - -The bitcode version (not LLVM version) of the file read by the analyzer. - -=item B - -The size, in bytes, of the entire bitcode file. - -=item B - -The size, in bytes, of the module block. Percentage is relative to File Size. - -=item B - -The size, in bytes, of all the function blocks. Percentage is relative to File -Size. - -=item B - -The size, in bytes, of the Global Types Pool. Percentage is relative to File -Size. This is the size of the definitions of all types in the bitcode file. - -=item B - -The size, in bytes, of the Constant Pool Blocks Percentage is relative to File -Size. - -=item B - -Ths size, in bytes, of the Global Variable Definitions and their initializers. -Percentage is relative to File Size. - -=item B - -The size, in bytes, of all the instruction lists in all the functions. -Percentage is relative to File Size. Note that this value is also included in -the Function Bytes. - -=item B - -The size, in bytes, of all the compaction tables in all the functions. -Percentage is relative to File Size. Note that this value is also included in -the Function Bytes. - -=item B - -The size, in bytes, of all the symbol tables in all the functions. Percentage is -relative to File Size. Note that this value is also included in the Function -Bytes. - -=item B - -The size, in bytes, of the list of dependent libraries in the module. Percentage -is relative to File Size. Note that this value is also included in the Module -Global Bytes. - -=item B - -The total number of blocks of any kind in the bitcode file. - -=item B - -The total number of function definitions in the bitcode file. - -=item B - -The total number of types defined in the Global Types Pool. - -=item B - -The total number of constants (of any type) defined in the Constant Pool. - -=item B - -The total number of basic blocks defined in all functions in the bitcode file. - -=item B - -The total number of instructions defined in all functions in the bitcode file. - -=item B - -The total number of long instructions defined in all functions in the bitcode -file. Long instructions are those taking greater than 4 bytes. Typically long -instructions are GetElementPtr with several indices, PHI nodes, and calls to -functions with large numbers of arguments. - -=item B - -The total number of operands used in all instructions in the bitcode file. - -=item B - -The total number of compaction tables in all functions in the bitcode file. - -=item B - -The total number of symbol tables in all functions in the bitcode file. - -=item B - -The total number of dependent libraries found in the bitcode file. - -=item B - -The total size of the instructions in all functions in the bitcode file. - -=item B - -The average number of bytes per instruction across all functions in the bitcode -file. This value is computed by dividing Total Instruction Size by Number Of -Instructions. - -=item B - -The maximum value used for a type's slot number. Larger slot number values take -more bytes to encode. - -=item B - -The maximum value used for a value's slot number. Larger slot number values take -more bytes to encode. - -=item B - -The average size of a Value definition (of any type). This is computed by -dividing File Size by the total number of values of any type. - -=item B - -The average size of a global definition (constants and global variables). - -=item B - -The average number of bytes per function definition. This is computed by -dividing Function Bytes by Number Of Functions. - -=item B<# of VBR 32-bit Integers> - -The total number of 32-bit integers encoded using the Variable Bit Rate -encoding scheme. - -=item B<# of VBR 64-bit Integers> - -The total number of 64-bit integers encoded using the Variable Bit Rate encoding -scheme. - -=item B<# of VBR Compressed Bytes> - -The total number of bytes consumed by the 32-bit and 64-bit integers that use -the Variable Bit Rate encoding scheme. - -=item B<# of VBR Expanded Bytes> - -The total number of bytes that would have been consumed by the 32-bit and 64-bit -integers had they not been compressed with the Variable Bit Rage encoding -scheme. - -=item B - -The total number of bytes saved by using the Variable Bit Rate encoding scheme. -The percentage is relative to # of VBR Expanded Bytes. - -=back - -=head1 DETAILED OUTPUT DEFINITIONS - -The following definitions occur only if the -nodetails option was not given. -The detailed output provides additional information on a per-function basis. - -=over - -=item B - -The type signature of the function. - -=item B - -The total number of bytes in the function's block. - -=item B - -The number of basic blocks defined by the function. - -=item B - -The number of instructions defined by the function. - -=item B - -The number of instructions using the long instruction format in the function. - -=item B - -The number of operands used by all instructions in the function. - -=item B - -The number of bytes consumed by instructions in the function. - -=item B - -The average number of bytes consumed by the instructions in the function. This -value is computed by dividing Instruction Size by Instructions. - -=item B - -The average number of bytes used by the function per instruction. This value is -computed by dividing Byte Size by Instructions. Note that this is not the same -as Average Instruction Size. It computes a number relative to the total function -size not just the size of the instruction list. - -=item B - -The total number of 32-bit integers found in this function (for any use). - -=item B - -The total number of 64-bit integers found in this function (for any use). - -=item B - -The total number of bytes in this function consumed by the 32-bit and 64-bit -integers that use the Variable Bit Rate encoding scheme. - -=item B - -The total number of bytes in this function that would have been consumed by -the 32-bit and 64-bit integers had they not been compressed with the Variable -Bit Rate encoding scheme. - -=item B - -The total number of bytes saved in this function by using the Variable Bit -Rate encoding scheme. The percentage is relative to # of VBR Expanded Bytes. - -=back - -=head1 SEE ALSO - -L, L - -=head1 AUTHORS - -Maintained by the LLVM Team (L). - -=cut -- cgit v1.2.3