xref: /freebsd/contrib/llvm-project/llvm/tools/llvm-readobj/Opts.td (revision 5956d97f4b3204318ceb6aa9c77bd0bc6ea87a41)
1include "llvm/Option/OptParser.td"
2
3class F<string letter, string help> : Flag<["-"], letter>, HelpText<help>;
4class FF<string name, string help> : Flag<["--"], name>, HelpText<help>;
5
6multiclass BB<string name, string help1, string help2> {
7  def NAME: Flag<["--"], name>, HelpText<help1>;
8  def no_ # NAME: Flag<["--"], "no-" # name>, HelpText<help2>;
9}
10
11multiclass Eq<string name, string help> {
12  def NAME #_EQ : Joined<["--"], name #"=">, HelpText<help>;
13  def : Separate<["--"], name>, Alias<!cast<Joined>(NAME #_EQ)>;
14}
15
16def addrsig : FF<"addrsig", "Display address-significance table">;
17def all : FF<"all", "Equivalent to setting: --file-header, --program-headers, --section-headers, "
18             "--symbols, --relocations, --dynamic-table, --notes, --version-info, --unwind, "
19             "--section-groups and --histogram">;
20def arch_specific : FF<"arch-specific", "Display architecture-specific information">;
21def bb_addr_map : FF<"bb-addr-map", "Display the BB address map section">;
22def cg_profile : FF<"cg-profile", "Display call graph profile section">;
23defm demangle : BB<"demangle", "Demangle symbol names", "Do not demangle symbol names (default)">;
24def dependent_libraries : FF<"dependent-libraries", "Display the dependent libraries section">;
25def dyn_relocations : FF<"dyn-relocations", "Display the dynamic relocation entries in the file">;
26def dyn_syms : FF<"dyn-syms", "Display the dynamic symbol table">;
27def expand_relocs : FF<"expand-relocs", "Expand each shown relocation to multiple lines">;
28def file_header : FF<"file-header", "Display file header">;
29def headers : FF<"headers", "Equivalent to setting: --file-header, --program-headers, --section-headers">;
30defm hex_dump : Eq<"hex-dump", "Display the specified section(s) as hexadecimal bytes">, MetaVarName<"<name or index>">;
31def pretty_print : FF<"pretty-print", "Pretty print JSON output">;
32def relocs : FF<"relocs", "Display the relocation entries in the file">;
33def section_data : FF<"section-data", "Display section data for each section shown. This option has no effect for GNU style output">;
34def section_details : FF<"section-details", "Display the section details">;
35def section_headers : FF<"section-headers", "Display section headers">;
36def section_mapping : FF<"section-mapping", "Display the section to segment mapping">;
37def section_mapping_EQ_false : FF<"section-mapping=false", "Don't display the section to segment mapping">, Flags<[HelpHidden]>;
38def section_relocations : FF<"section-relocations", "Display relocations for each section shown. This option has no effect for GNU style output">;
39def section_symbols : FF<"section-symbols", "Display symbols for each section shown. This option has no effect for GNU style output">;
40def stack_sizes : FF<"stack-sizes", "Display contents of all stack sizes sections. This option has no effect for GNU style output">;
41def stackmap : FF<"stackmap", "Display contents of stackmap section">;
42defm string_dump : Eq<"string-dump", "Display the specified section(s) as a list of strings">, MetaVarName<"<name or index>">;
43def string_table : FF<"string-table", "Display the string table (only for XCOFF now)">;
44def symbols : FF<"symbols", "Display the symbol table. Also display the dynamic symbol table when using GNU output style for ELF">;
45def unwind : FF<"unwind", "Display unwind information">;
46
47// ELF specific options.
48def grp_elf : OptionGroup<"kind">, HelpText<"OPTIONS (ELF specific)">;
49def dynamic_table : FF<"dynamic-table", "Display the dynamic section table">, Group<grp_elf>;
50def elf_linker_options : FF<"elf-linker-options", "Display the .linker-options section">, Group<grp_elf>;
51defm elf_output_style : Eq<"elf-output-style", "Specify ELF dump style: LLVM, GNU, JSON">, Group<grp_elf>;
52def histogram : FF<"histogram", "Display bucket list histogram for hash sections">, Group<grp_elf>;
53def section_groups : FF<"section-groups", "Display section groups">, Group<grp_elf>;
54def gnu_hash_table : FF<"gnu-hash-table", "Display the GNU hash table for dynamic symbols">, Group<grp_elf>;
55def hash_symbols : FF<"hash-symbols", "Display the dynamic symbols derived from the hash section">, Group<grp_elf>;
56def hash_table : FF<"hash-table", "Display .hash section">, Group<grp_elf>;
57def needed_libs : FF<"needed-libs", "Display the needed libraries">, Group<grp_elf>;
58def notes : FF<"notes", "Display notes">, Group<grp_elf>;
59def program_headers : FF<"program-headers", "Display program headers">, Group<grp_elf>;
60def raw_relr : FF<"raw-relr", "Do not decode relocations in SHT_RELR section, display raw contents">, Group<grp_elf>;
61def version_info : FF<"version-info", "Display version sections">, Group<grp_elf>;
62
63// Mach-O specific options.
64def grp_mach_o : OptionGroup<"kind">, HelpText<"OPTIONS (Mach-O specific)">;
65def macho_data_in_code : FF<"macho-data-in-code", "Display Data in Code command">, Group<grp_mach_o>;
66def macho_dysymtab : FF<"macho-dysymtab", "Display Dysymtab command">, Group<grp_mach_o>;
67def macho_indirect_symbols : FF<"macho-indirect-symbols", "Display indirect symbols">, Group<grp_mach_o>;
68def macho_linker_options : FF<"macho-linker-options", "Display linker options">, Group<grp_mach_o>;
69def macho_segment : FF<"macho-segment", "Display Segment command">, Group<grp_mach_o>;
70def macho_version_min : FF<"macho-version-min", "Display version min command">, Group<grp_mach_o>;
71
72// PE/COFF specific options.
73def grp_coff : OptionGroup<"kind">, HelpText<"OPTIONS (PE/COFF specific)">;
74def codeview : FF<"codeview", "Display CodeView debug information">, Group<grp_coff>;
75def codeview_ghash : FF<"codeview-ghash", "Enable global hashing for CodeView type stream de-duplication">, Group<grp_coff>;
76def codeview_merged_types : FF<"codeview-merged-types", "Display the merged CodeView type stream">, Group<grp_coff>;
77def codeview_subsection_bytes : FF<"codeview-subsection-bytes", "Dump raw contents of codeview debug sections and records">, Group<grp_coff>;
78def coff_basereloc : FF<"coff-basereloc", "Display .reloc section">, Group<grp_coff>;
79def coff_debug_directory : FF<"coff-debug-directory", "Display debug directory">, Group<grp_coff>;
80def coff_directives : FF<"coff-directives", "Display .drectve section">, Group<grp_coff>;
81def coff_exports : FF<"coff-exports", "Display export table">, Group<grp_coff>;
82def coff_imports : FF<"coff-imports", "Display import table">, Group<grp_coff>;
83def coff_load_config : FF<"coff-load-config", "Display load config">, Group<grp_coff>;
84def coff_resources : FF<"coff-resources", "Display .rsrc section">, Group<grp_coff>;
85def coff_tls_directory : FF<"coff-tls-directory", "Display TLS directory">, Group<grp_coff>;
86
87// XCOFF specific options.
88def grp_xcoff : OptionGroup<"kind">, HelpText<"OPTIONS (XCOFF specific)">;
89def auxiliary_header : FF<"auxiliary-header" , "display the auxiliary header">, Group<grp_xcoff>;
90
91def help : FF<"help", "Display this help">;
92def version : FF<"version", "Display the version">;
93
94// Ignored for GNU readelf compatibility.
95def wide : FF<"wide", "Ignored for GNU readelf compatibility">;
96def : F<"W", "Ignored for GNU readelf compatibility">, Alias<wide>;
97
98// Traditional llvm-readobj Aliases.
99def : Flag<["--"], "dt">, Alias<dyn_syms>, HelpText<"Alias for --dyn-syms">;
100def : Flag<["--"], "sd">, Alias<section_data>, HelpText<"Alias for --section-data">;
101def : Flag<["--"], "st">, Alias<section_symbols>, HelpText<"Alias for --section-symbols">;
102def : Flag<["--"], "sr">, Alias<section_relocations>, HelpText<"Alias for --section-relocations">;
103
104// Aliases.
105def : FF<"dyn-symbols", "Alias for --dyn-syms">, Alias<dyn_syms>;
106def : FF<"dynamic", "Alias for --dynamic-table">, Alias<dynamic_table>;
107def : FF<"elf-cg-profile", "Alias for --cg-profile">, Alias<cg_profile>, Flags<[HelpHidden]>;
108def : FF<"elf-hash-histogram", "Alias for --histogram">, Alias<histogram>, Flags<[HelpHidden]>;
109def : FF<"elf-section-groups", "Alias for --section-groups">, Alias<section_groups>, Flags<[HelpHidden]>;
110def : FF<"file-headers", "Alias for --file-header">, Alias<file_header>, Flags<[HelpHidden]>;
111def : FF<"relocations", "Alias for --relocs">, Alias<relocs>;
112def : FF<"sections", "Alias for --section-headers">, Alias<section_headers>;
113def : FF<"segments", "Alias for --program-headers">, Alias<program_headers>, Group<grp_elf>;
114def : FF<"syms", "Alias for --symbols">, Alias<symbols>;
115
116def : F<"A", "Alias for --arch-specific">, Alias<arch_specific>;
117def : F<"a", "Alias for --all">, Alias<all>;
118def : F<"C", "Alias for --demangle">, Alias<demangle>;
119def : F<"d", "Alias for --dynamic-table">, Alias<dynamic_table>, Group<grp_elf>;
120def : F<"e", "Alias for --headers">, Alias<headers>;
121def : F<"g", "Alias for --section-groups">, Alias<section_groups>, Group<grp_elf>;
122def : F<"h", "Alias for --file-header">, Alias<file_header>;
123def : F<"I", "Alias for --histogram">, Alias<histogram>, Group<grp_elf>;
124def : F<"l", "Alias for --program-headers">, Alias<program_headers>;
125def : F<"n", "Alias for --notes">, Alias<notes>;
126def : JoinedOrSeparate<["-"], "p">, Alias<string_dump_EQ>, HelpText<"Alias for --string-dump">, MetaVarName<"<name or index>">;
127def : F<"r", "Alias for --relocs">, Alias<relocs>;
128def : F<"S", "Alias for --section-headers">, Alias<section_headers>;
129def : F<"s", "Alias for --symbols">, Alias<symbols>;
130def : F<"t", "Alias for --section-details">, Alias<section_details>;
131def : F<"u", "Alias for --unwind">, Alias<unwind>;
132def : F<"V", "Alias for --version-info">, Alias<version_info>, Group<grp_elf>;
133def : JoinedOrSeparate<["-"], "x">, Alias<hex_dump_EQ>, HelpText<"Alias for --hex-dump">, MetaVarName<"<name or index>">;
134