aboutsummaryrefslogtreecommitdiff
path: root/llvm/docs/CommandGuide/llvm-profgen.rst
blob: e5156129838948219a29c918d25f62bb24606342 (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
llvm-profgen - LLVM SPGO profile generation tool
================================================

.. program:: llvm-profgen

SYNOPSIS
--------

:program:`llvm-profgen` [*commands*] [*options*]

DESCRIPTION
-----------

The :program:`llvm-profgen` utility generates a profile data file
from given perf script data files for sample-based profile guided
optimization(SPGO).

COMMANDS
--------
At least one of the following commands are required:

.. option:: --perfscript=<string[,string,...]>

  Path of perf-script trace created by Linux perf tool with `script`
  command(the raw perf.data should be profiled with -b).

.. option:: --binary=<string[,string,...]>

  Path of the input profiled binary files.

.. option:: --output=<string>

  Path of the output profile file.

OPTIONS
-------
:program:`llvm-profgen` supports the following options:

.. option:: --format=[text|binary|extbinary|compbinary|gcc]

  Specify the format of the generated profile. Supported <format>  are `text`,
  `binary`, `extbinary`, `compbinary`, `gcc`, see `llvm-profdata` for more
  descriptions of the format.

.. option:: --show-mmap-events

  Print mmap events.

.. option:: --show-disassembly

  Print disassembled code.

.. option:: --x86-asm-syntax=[att|intel]

  Specify whether to print assembly code in AT&T syntax (the default) or Intel
  syntax.