gcc/doc/lto-dump.texi

   1 @c Copyright (C) 2018-2023 Free Software Foundation, Inc.
   2 @c This is part of the GCC manual.
   3 @c For copying conditions, see the file gcc.texi.
   4
   5 @ignore
   6 @c man begin COPYRIGHT
   7 Copyright @copyright{} 2017-2023 Free Software Foundation, Inc.
   8
   9 Permission is granted to copy, distribute and/or modify this document
  10 under the terms of the GNU Free Documentation License, Version 1.3 or
  11 any later version published by the Free Software Foundation; with the
  12 Invariant Sections being ``GNU General Public License'' and ``Funding
  13 Free Software'', the Front-Cover texts being (a) (see below), and with
  14 the Back-Cover Texts being (b) (see below).  A copy of the license is
  15 included in the gfdl(7) man page.
  16
  17 (a) The FSF's Front-Cover Text is:
  18
  19      A GNU Manual
  20
  21 (b) The FSF's Back-Cover Text is:
  22
  23      You have freedom to copy and modify this GNU Manual, like GNU
  24      software.  Copies published by the Free Software Foundation raise
  25      funds for GNU development.
  26 @c man end
  27 @c Set file name and title for the man page.
  28 @setfilename lto-dump
  29 @settitle Tool for dumping LTO object files.
  30 @end ignore
  31
  32 @node lto-dump
  33 @chapter @command{lto-dump}---Tool for dumping LTO object files.
  34
  35 @menu
  36 * lto-dump Intro::             Introduction to lto-dump.
  37 * Invoking lto-dump::          How to use lto-dump.
  38 @end menu
  39
  40 @node lto-dump Intro
  41 @section Introduction to @command{lto-dump}
  42 @c man begin DESCRIPTION
  43
  44 @command{lto-dump} is a tool you can use in conjunction with GCC to
  45 dump link time optimization object files.
  46
  47 @c man end
  48
  49 @node Invoking lto-dump
  50 @section Invoking @command{lto-dump}
  51
  52 @smallexample
  53 Usage: lto-dump @r{[}@var{OPTION}@r{]} ... @var{objfiles}
  54 @end smallexample
  55
  56 @command{lto-dump} accepts the following options:
  57
  58 @ignore
  59 @c man begin SYNOPSIS
  60 lto-dump [@option{-list}]
  61      [@option{-demangle}]
  62      [@option{-defined-only}]
  63      [@option{-print-value}]
  64      [@option{-name-sort}]
  65      [@option{-size-sort}]
  66      [@option{-reverse-sort}]
  67      [@option{-no-sort}]
  68      [@option{-symbol=}]
  69      [@option{-objects}]
  70      [@option{-type-stats}]
  71      [@option{-tree-stats}]
  72      [@option{-gimple-stats}]
  73      [@option{-dump-level=}]
  74      [@option{-dump-body=}]
  75      [@option{-help}] @var{lto-dump}
  76 @c man end
  77 @end ignore
  78
  79 @c man begin OPTIONS
  80 @table @gcctabopt
  81 @item -list
  82 Dumps list of details of functions and variables.
  83
  84 @item -demangle
  85 Dump the demangled output.
  86
  87 @item -defined-only
  88 Dump only the defined symbols.
  89
  90 @item -print-value
  91 Dump initial values of the variables.
  92
  93 @item -name-sort
  94 Sort the symbols alphabetically.
  95
  96 @item -size-sort
  97 Sort the symbols according to size.
  98
  99 @item -reverse-sort
 100 Dump the symbols in reverse order.
 101
 102 @item -no-sort
 103 Dump the symbols in order of occurrence.
 104
 105 @item -symbol=
 106 Dump the details of specific symbol.
 107
 108 @item -objects
 109 Dump the details of LTO objects.
 110
 111 @item -type-stats
 112 Dump the statistics of tree types.
 113
 114 @item -tree-stats
 115 Dump the statistics of trees.
 116
 117 @item -gimple-stats
 118 Dump the statistics of gimple statements.
 119
 120 @item -dump-level=
 121 For deciding the optimization level of body.
 122
 123 @item -dump-body=
 124 Dump the specific gimple body.
 125
 126 @item -help
 127 Display the dump tool help.
 128
 129 @end table
 130
 131 @c man end