aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc/lto-dump.texi
blob: d57a1244ca8b0359adf99ae3bdc136c97a0decd7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
@c Copyright (C) 2018-2020 Free Software Foundation, Inc.
@c This is part of the GCC manual.
@c For copying conditions, see the file gcc.texi.

@ignore
@c man begin COPYRIGHT
Copyright @copyright{} 2017-2020 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``GNU General Public License'' and ``Funding
Free Software'', the Front-Cover texts being (a) (see below), and with
the Back-Cover Texts being (b) (see below).  A copy of the license is
included in the gfdl(7) man page.

(a) The FSF's Front-Cover Text is:

     A GNU Manual

(b) The FSF's Back-Cover Text is:

     You have freedom to copy and modify this GNU Manual, like GNU
     software.  Copies published by the Free Software Foundation raise
     funds for GNU development.
@c man end
@c Set file name and title for the man page.
@setfilename lto-dump
@settitle Tool for dumping LTO object files.
@end ignore

@node lto-dump
@chapter @command{lto-dump}---Tool for dumping LTO object files.

@menu
* lto-dump Intro::             Introduction to lto-dump.
* Invoking lto-dump::          How to use lto-dump.
@end menu

@node lto-dump Intro
@section Introduction to @command{lto-dump}
@c man begin DESCRIPTION

@command{lto-dump} is a tool you can use in conjunction with GCC to
dump link time optimization object files.

@c man end

@node Invoking lto-dump
@section Invoking @command{lto-dump}

@smallexample
Usage: lto-dump @r{[}@var{OPTION}@r{]} ... @var{objfiles}
@end smallexample

@command{lto-dump} accepts the following options:

@ignore
@c man begin SYNOPSIS
lto-dump [@option{-list}]
     [@option{-demangle}]
     [@option{-defined-only}]
     [@option{-print-value}]
     [@option{-name-sort}]
     [@option{-size-sort}]
     [@option{-reverse-sort}]
     [@option{-no-sort}]
     [@option{-symbol=}]
     [@option{-objects}]
     [@option{-type-stats}]
     [@option{-tree-stats}]
     [@option{-gimple-stats}]
     [@option{-dump-level=}]
     [@option{-dump-body=}]
     [@option{-help}] @var{lto-dump}
@c man end
@end ignore

@c man begin OPTIONS
@table @gcctabopt
@item -list
Dumps list of details of functions and variables.

@item -demangle
Dump the demangled output.

@item -defined-only
Dump only the defined symbols.

@item -print-value
Dump initial values of the variables.

@item -name-sort
Sort the symbols alphabetically.

@item -size-sort
Sort the symbols according to size.

@item -reverse-sort
Dump the symbols in reverse order.

@item -no-sort
Dump the symbols in order of occurrence.

@item -symbol=
Dump the details of specific symbol.

@item -objects
Dump the details of LTO objects.

@item -type-stats
Dump the statistics of tree types.

@item -tree-stats
Dump the statistics of trees.

@item -gimple-stats
Dump the statistics of gimple statements.

@item -dump-level=
For deciding the optimization level of body.

@item -dump-body=
Dump the specific gimple body.

@item -help
Display the dump tool help.

@end table

@c man end