annotate gcc/doc/lto-dump.texi @ 158:494b0b89df80 default tip

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