Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / cbb07bea14a708e1d7cfcb286cac334f83b0a192 / . / llvm / docs / CommandGuide / tblgen.rst
blob: 1858ee447d0756ca7300f0cb22212fc9e62eaacd [file] [log] [blame]
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]1tblgen - Target Description To C++ Code Generator
2=================================================
3
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]4SYNOPSIS
5--------
6
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]7:program:`tblgen` [*options*] [*filename*]
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]8
9DESCRIPTION
10-----------
11
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]12:program:`tblgen` translates from target description (``.td``) files into C++
13code that can be included in the definition of an LLVM target library. Most
14users of LLVM will not need to use this program. It is only for assisting with
15writing an LLVM target backend.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]16
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]17The input and output of :program:`tblgen` is beyond the scope of this short
18introduction. Please see :doc:`../TableGenFundamentals`.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]19
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]20The *filename* argument specifies the name of a Target Description (``.td``)
21file to read as input.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]22
23OPTIONS
24-------
25
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]26.. option:: -help
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]27
28 Print a summary of command line options.
29
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]30.. option:: -o filename
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]31
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]32 Specify the output file name. If ``filename`` is ``-``, then
33 :program:`tblgen` sends its output to standard output.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]34
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]35.. option:: -I directory
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]36
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]37 Specify where to find other target description files for inclusion. The
38 ``directory`` value should be a full or partial path to a directory that
39 contains target description files.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]40
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]41.. option:: -asmparsernum N
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]42
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]43 Make -gen-asm-parser emit assembly writer number ``N``.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]44
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]45.. option:: -asmwriternum N
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]46
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]47 Make -gen-asm-writer emit assembly writer number ``N``.
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]48
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]49.. option:: -class className
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]50
51 Print the enumeration list for this class.
52
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]53.. option:: -print-records
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]54
55 Print all records to standard output (default).
56
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]57.. option:: -print-enums
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]58
59 Print enumeration values for a class
60
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]61.. option:: -print-sets
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]62
63 Print expanded sets for testing DAG exprs.
64
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]65.. option:: -gen-emitter
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]66
67 Generate machine code emitter.
68
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]69.. option:: -gen-register-info
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]70
71 Generate registers and register classes info.
72
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]73.. option:: -gen-instr-info
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]74
75 Generate instruction descriptions.
76
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]77.. option:: -gen-asm-writer
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]78
79 Generate the assembly writer.
80
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]81.. option:: -gen-disassembler
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]82
83 Generate disassembler.
84
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]85.. option:: -gen-pseudo-lowering
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]86
87 Generate pseudo instruction lowering.
88
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]89.. option:: -gen-dag-isel
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]90
91 Generate a DAG (Directed Acycle Graph) instruction selector.
92
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]93.. option:: -gen-asm-matcher
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]94
95 Generate assembly instruction matcher.
96
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]97.. option:: -gen-dfa-packetizer
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]98
99 Generate DFA Packetizer for VLIW targets.
100
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]101.. option:: -gen-fast-isel
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]102
103 Generate a "fast" instruction selector.
104
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]105.. option:: -gen-subtarget
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]106
107 Generate subtarget enumerations.
108
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]109.. option:: -gen-intrinsic
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]110
111 Generate intrinsic information.
112
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]113.. option:: -gen-tgt-intrinsic
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]114
115 Generate target intrinsic information.
116
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]117.. option:: -gen-enhanced-disassembly-info
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]118
119 Generate enhanced disassembly info.
120
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]121.. option:: -version
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]122
123 Show the version number of this program.
124
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]125EXIT STATUS
126-----------
127
Dmitri Gribenkocbb07be2012-11-29 17:41:05 +0000[diff] [blame^]128If :program:`tblgen` succeeds, it will exit with 0. Otherwise, if an error
Daniel Dunbar8f4a8a62012-05-08 16:50:35 +0000[diff] [blame]129occurs, it will exit with a non-zero value.