1sparse - extra options for developers
2=====================================
3
4SYNOPSIS
5--------
6``tools`` [`options`]... `file.c``
7
8DESCRIPTION
9-----------
10
11This file is a complement of sparse's man page meant to
12document options only useful for development on sparse itself.
13
14OPTIONS
15-------
16
17.. option:: -fdump-ir=pass,[pass]
18
19  Dump the IR at each of the given passes.
20
21  The passes currently understood are:
22
23    * ``linearize``
24    * ``mem2reg``
25    * ``final``
26
27  The default pass is ``linearize``.
28
29.. option:: -f<name-of-the-pass>[-disable|-enable|=last]
30
31  If ``=last`` is used, all passes after the specified one are disabled.
32  By default all passes are enabled.
33
34  The passes currently understood are:
35
36    * ``linearize`` (can't be disabled)
37    * ``mem2reg``
38    * ``optim``
39
40.. option:: -vcompound
41
42  Print all compound global data symbols with their sizes and alignment.
43
44.. option:: -vdead
45
46  Add ``OP_DEATHNOTE`` annotations to dead pseudos.
47
48.. option:: -vdomtree
49
50  Dump the dominance tree after its calculation.
51
52.. option:: -ventry
53
54  Dump the IR after all optimization passes.
55
56.. option:: -vpostorder
57
58  Dump the reverse postorder traversal of the CFG.
59