XXX-TBLGEN(1)

📦
version 12.0.1 · 4 versions
, in fedora 43, fedora 44

✨ XXX-TBLGEN(1) ✨

okay so bestie, welcome to the manual page for xxx-tblgen, part of the LLVM family 💜 — it's the Target Description to C++ Code situation, and it's lowkey a whole vibe.

🌸 NAME 🌸

xxx-tblgen — Target Description to C++ Code

🎀 SYNOPSIS 🎀

xxx-tblgen [options] [filename]

🦋 DESCRIPTION 🦋

so. xxx-tblgen is literally a family of programs 👑 that translates target description (.td) files into C++ code and other output formats. fr fr.

ngl, most users of LLVM will not need to use this program. it's used only for writing parts of the compiler or LLVM target backends. iykyk 💅

The details of the input and output of xxx-tblgen is beyond the scope of this short introduction; please see the TableGen Overview for an introduction and for references to additional TableGen documents. (yes bestie, there's lore, go read it 🫶)

The filename argument specifies the name of the Target Description (.td) file that TableGen processes. that's the main character right there ✨

💖 OPTIONS 💖

🌈 General Options

  • -help — Print a description of the command line options. ur little cheat sheet, slay.
  • -help-list — Print a description of the command line options in a simple list format. same tea, simpler cup 🍓
  • -D=macroname — Specify the name of a macro to be defined. The name is defined, but it has no particular value. like a name tag with no job title 💀
  • -d=filename — Specify the name of the dependency filename.
  • -debug — Enable debug output. turn on the chaos cam 🎥
  • -dump-json — Print a JSON representation of all records, suitable for further automated processing. robot food, delicious 🤖
  • -I directory — Specify where to find other target description files for inclusion. The directory value should be a full or partial path to a directory that contains target description files.
  • -null-backend — Parse the source files and build the records, but do not run any backend. This is useful for timing the frontend. all vibes, no output ✨
  • -o filename — Specify the output file name. If filename is -, then xxx-tblgen sends its output to standard output.
  • -print-records — Print all classes and records to standard output (default backend option). the default, periodt.
  • -print-detailed-records — Print a detailed report of all global variables, classes, and records to standard output.
  • -stats — Print a report with any statistics collected by the backend.
  • -time-phases — Time the parser and backend phases and print a report. stopwatch era ⏱️
  • -version — Show the version number of the program.
  • -write-if-changed — Write the output file only if it is new or has changed. no unnecessary rewrites, we love efficiency 💅

⭐ llvm-tblgen Options

  • -gen-asm-matcher — Generate assembly instruction matcher.
  • -match-prefix=prefix — Make -gen-asm-matcher match only instructions with the given prefix.
  • -gen-asm-parser — Generate assembly instruction parser.
  • -asmparsernum=n — Make -gen-asm-parser emit assembly parser number n.
  • -gen-asm-writer — Generate assembly writer.
  • -asmwriternum=n — Make -gen-asm-writer emit assembly writer number n.
  • -gen-attrs — Geneerate attributes.
  • -gen-automata — Generate generic automata.
  • -gen-callingconv — Generate calling convention descriptions.
  • -gen-compress-inst-emitter — Generate RISCV compressed instructions.
  • -gen-ctags — Generate ctags-compatible index.
  • -gen-dag-isel — Generate a DAG (directed acyclic graph) instruction selector.
  • -instrument-coverage — Make -gen-dag-isel generate tables to help identify the patterns matched.
  • -omit-comments — Make -gen-dag-isel omit comments. The default is false.
  • -gen-dfa-packetizer — Generate DFA Packetizer for VLIW targets.
  • -gen-directive-decl — Generate directive related declaration code (header file).
  • -gen-directive-gen — Generate directive related implementation code part.
  • -gen-directive-impl — Generate directive related implementation code.
  • -gen-disassembler — Generate disassembler.
  • -gen-emitter — Generate machine code emitter.
  • -gen-exegesis — Generate llvm-exegesis tables.
  • -gen-fast-isel — Generate a "fast" instruction selector.
  • -gen-global-isel — Generate GlobalISel selector.
  • -gisel-coverage-file=filename — Specify the file from which to retrieve coverage information.
  • -instrument-gisel-coverage — Make -gen-global-isel generate coverage instrumentation.
  • -optimize-match-table — Make -gen-global-isel generate an optimized version of the match table.
  • -warn-on-skipped-patterns — Make -gen-global-isel explain why a pattern was skipped for inclusion. bestie just tell me why 😭
  • -gen-global-isel-combiner — Generate GlobalISel combiner.
  • -combiners=list — Make -gen-global-isel-combiner emit the specified combiners.
  • -gicombiner-show-expansions — Make -gen-global-isel-combiner use C++ comments to indicate occurences of code expansion.
  • -gicombiner-stop-after-build — Make -gen-global-isel-combiner stop processing after building the match tree.
  • -gicombiner-stop-after-parse — Make -gen-global-isel-combiner stop processing after parsing rules and dump state.
  • -gen-instr-info — Generate instruction descriptions.
  • -gen-instr-docs — Generate instruction documentation.
  • -gen-intrinsic-enums — Generate intrinsic enums.
  • -intrinsic-prefix=prefix — Make -gen-intrinsic-enums generate intrinsics with this target prefix.
  • -gen-intrinsic-impl — Generate intrinsic information.
  • -gen-opt-parser-defs — Generate options definitions.
  • -gen-opt-rst — Generate option RST.
  • -gen-pseudo-lowering — Generate pseudo instruction lowering.
  • -gen-register-bank — Generate register bank descriptions.
  • -gen-register-info — Generate registers and register classes info.
  • -register-info-debug — Make -gen-register-info dump register information for debugging.
  • -gen-searchable-tables — Generate generic searchable tables. See TableGen BackEnds for a detailed description.
  • -gen-subtarget — Generate subtarget enumerations.
  • -gen-x86-EVEX2VEX-tables — Generate X86 EVEX to VEX compress tables.
  • -gen-x86-fold-tables — Generate X86 fold tables.
  • -long-string-literals — When emitting large string tables, prefer string literals over comma-separated char literals. This can be a readability and compile-time performance win, but upsets some compilers. 💀 sorry to those compilers i guess
  • -print-enums — Print enumeration values for a class.
  • -class=classname — Make -print-enums print the enumeration list for the specified class.
  • -print-sets — Print expanded sets for testing DAG exprs.

🧚 clang-tblgen Options

  • -gen-clang-attr-classes — Generate Clang attribute clases.
  • -gen-clang-attr-parser-string-switches — Generate all parser-related attribute string switches.
  • -gen-clang-attr-subject-match-rules-parser-string-switches — Generate all parser-related attribute subject match rule string switches.
  • -gen-clang-attr-impl — Generate Clang attribute implementations.
  • -gen-clang-attr-list" — Generate a Clang attribute list.
  • -gen-clang-attr-subject-match-rule-list — Generate a Clang attribute subject match rule list.
  • -gen-clang-attr-pch-read — Generate Clang PCH attribute reader.
  • -gen-clang-attr-pch-write — Generate Clang PCH attribute writer.
  • -gen-clang-attr-has-attribute-impl — Generate a Clang attribute spelling list.
  • -gen-clang-attr-spelling-index — Generate a Clang attribute spelling index.
  • -gen-clang-attr-ast-visitor — Generate a recursive AST visitor for Clang attributes.
  • -gen-clang-attr-template-instantiate — Generate a Clang template instantiate code.
  • -gen-clang-attr-parsed-attr-list — Generate a Clang parsed attribute list.
  • -gen-clang-attr-parsed-attr-impl — Generate the Clang parsed attribute helpers.
  • -gen-clang-attr-parsed-attr-kinds — Generate a Clang parsed attribute kinds.
  • -gen-clang-attr-text-node-dump — Generate Clang attribute text node dumper.
  • -gen-clang-attr-node-traverse — Generate Clang attribute traverser.
  • -gen-clang-diags-defs — Generate Clang diagnostics definitions.
  • -clang-component component — Only use warnings from specified component.
  • -gen-clang-diag-groups — Generate Clang diagnostic groups.
  • -gen-clang-diags-index-name — Generate Clang diagnostic name index.
  • -gen-clang-basic-reader — Generate Clang BasicReader classes.
  • -gen-clang-basic-writer — Generate Clang BasicWriter classes.
  • -gen-clang-comment-nodes — Generate Clang AST comment nodes.
  • -gen-clang-decl-nodes — Generate Clang AST declaration nodes.
  • -gen-clang-stmt-nodes — Generate Clang AST statement nodes.
  • -gen-clang-type-nodes — Generate Clang AST type nodes.
  • -gen-clang-type-reader — Generate Clang AbstractTypeReader class.
  • -gen-clang-type-writer — Generate Clang AbstractTypeWriter class.
  • -gen-clang-opcodes — Generate Clang constexpr interpreter opcodes.
  • -gen-clang-sa-checkers — Generate Clang static analyzer checkers.
  • -gen-clang-comment-html-tags — Generate efficient matchers for HTML tag names that are used in documentation comments.
  • -gen-clang-comment-html-tags-properties — Generate efficient matchers for HTML tag properties.
  • -gen-clang-comment-html-named-character-references — Generate function to translate named character references to UTF-8 sequences.
  • -gen-clang-comment-command-info — Generate command properties for commands that are used in documentation comments.
  • -gen-clang-comment-command-list — Generate list of commands that are used in documentation comments.
  • -gen-clang-opencl-builtins — Generate OpenCL builtin declaration handlers.
  • -gen-arm-neon — Generate arm_neon.h for Clang.
  • -gen-arm-fp16 — Generate arm_fp16.h for Clang.
  • -gen-arm-bf16 — Generate arm_bf16.h for Clang.
  • -gen-arm-neon-sema — Generate ARM NEON sema support for Clang.
  • -gen-arm-neon-test — Generate ARM NEON tests for Clang.
  • -gen-arm-sve-header — Generate arm_sve.h for Clang.
  • -gen-arm-sve-builtins — Generate arm_sve_builtins.inc for Clang.
  • -gen-arm-sve-builtin-codegen — Generate arm_sve_builtin_cg_map.inc for Clang.
  • -gen-arm-sve-typeflags — Generate arm_sve_typeflags.inc for Clang.
  • -gen-arm-sve-sema-rangechecks — Generate arm_sve_sema_rangechecks.inc for Clang.
  • -gen-arm-mve-header — spits out arm_mve.h for Clang ✨
  • -gen-arm-mve-builtin-def — makes the ARM MVE builtin definitions for Clang 💖
  • -gen-arm-mve-builtin-sema — generates the ARM MVE builtin sema checks for Clang 🎀
  • -gen-arm-mve-builtin-codegen — generates the ARM MVE builtin code-generator for Clang 🦋
  • -gen-arm-mve-builtin-aliases — generates the list of valid ARM MVE builtin aliases for Clang 🌸
  • -gen-arm-cde-header — generates arm_cde.h for Clang 💅
  • -gen-arm-cde-builtin-def — ARM CDE builtin definitions for Clang, bestie 🫶
  • -gen-arm-cde-builtin-sema — ARM CDE builtin sema checks for Clang 😭
  • -gen-arm-cde-builtin-codegen — ARM CDE builtin code-generator for Clang 🔥
  • -gen-arm-cde-builtin-aliases — the list of valid ARM CDE builtin aliases for Clang 👑
  • -gen-attr-docs — generates attribute documentation 🌈
  • -gen-diag-docs — generates diagnostic documentation ⭐
  • -gen-opt-docs — generates option documentation 💀
  • -gen-clang-data-collectors — generates data collectors for AST nodes 🙈
  • -gen-clang-test-pragma-attribute-supported-attributes — generates a list of attributes supported by #pragma Clang attribute, literally just for testing purposes 🍓

🌟 mlir-tblgen Options 🌟

  • -gen-avail-interface-decls — generates availability interface declarations 🧚
  • -gen-avail-interface-defs — generates op interface definitions 💜
  • -gen-dialect-doc — generates dialect documentation ✨
  • -dialect — the dialect to generate 💖
  • -gen-directive-decl — generates declarations for directives (OpenMP, etc.) 🎀
  • -gen-enum-decls — generates enum utility declarations 🦋
  • -gen-enum-defs — generates enum utility definitions 🌸
  • -gen-enum-from-llvmir-conversions — generates conversions of EnumAttrs from LLVM IR 💅
  • -gen-enum-to-llvmir-conversions — generates conversions of EnumAttrs to LLVM IR 🫶
  • -gen-llvmir-conversions — generates LLVM IR conversions 😭
  • -gen-llvmir-intrinsics — generates LLVM IR intrinsics 🔥
  • -llvmir-intrinsics-filter — only keeps the intrinsics whose record name contains the substring you specify 👑
  • -dialect-opclass-base — the base class for the ops in the dialect we're about to emit 🌈
  • -gen-op-decls — generates operation declarations ⭐
  • -gen-op-defs — generates operation definitions 💀
  • -asmformat-error-is-fatal — emits a fatal error if format parsing fails. so dramatic. so valid. 🙈
  • -op-exclude-regex — regular expression of the name of ops to exclude (no filter if empty) 🍓
  • -op-include-regex — regular expression of the name of ops to include (no filter if empty) 🧚
  • -gen-op-doc — generates operation documentation 💜
  • -gen-pass-decls — the manpage says "Generate operation documentation" here and honestly bestie, we're just the messengers, we do not make the rules 😭 it is what it says ✨
  • -name namestring — the name of this group of passes 💖
  • -gen-pass-doc — generates pass documentation 🎀
  • -gen-rewriters — generates pattern rewriters 🦋
  • -gen-spirv-avail-impls — generates SPIR-V operation utility definitions 🌸
  • -gen-spirv-capability-implication — generates a utility function that returns the implied capabilities for a given capability 💅
  • -gen-spirv-enum-avail-decls — generates SPIR-V enum availability declarations 🫶
  • -gen-spirv-enum-avail-defs — generates SPIR-V enum availability definitions 😭
  • -gen-spirv-op-utils — generates SPIR-V operation utility definitions 🔥
  • -gen-spirv-serialization — generates SPIR-V (de)serialization utilities and functions 👑
  • -gen-struct-attr-decls — generates struct utility declarations 🌈
  • -gen-struct-attr-defs — generates struct utility definitions ⭐
  • -gen-typedef-decls — generates TypeDef declarations 💀
  • -gen-typedef-defs — generates TypeDef definitions 🙈
  • -typedefs-dialect name — generates types for this dialect 🍓

🚪 EXIT STATUS 🚪

If xxx-tblgen succeeds, it exits with 0. If an error happens instead, it exits with a non-zero value. that's it, that's the vibe check 💅

💌 AUTHOR 💌

Maintained by the LLVM Team (https://llvm.org/).

2003-2024, LLVM Project

and that's the whole page, bestie!! 🫶 this was XXX-TBLGEN(1), dated 2024-07-18, brought to you by the LLVM Project (copyright 2003-2024) — go forth and generate, you absolute icon 👑💖✨

📦 where this page comes from