xref: /freebsd/contrib/llvm-project/llvm/tools/llvm-readobj/Opts.td (revision 7ef62cebc2f965b0f640263e179276928885e33d)
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">;
40defm sort_symbols : Eq<"sort-symbols", "Specify the keys to sort the symbols before displaying symtab">;
41def stack_sizes : FF<"stack-sizes", "Display contents of all stack sizes sections. This option has no effect for GNU style output">;
42def stackmap : FF<"stackmap", "Display contents of stackmap section">;
43defm string_dump : Eq<"string-dump", "Display the specified section(s) as a list of strings">, MetaVarName<"<name or index>">;
44def string_table : FF<"string-table", "Display the string table (only for XCOFF now)">;
45def symbols : FF<"symbols", "Display the symbol table. Also display the dynamic symbol table when using GNU output style for ELF">;
46def unwind : FF<"unwind", "Display unwind information">;
47
48// ELF specific options.
49def grp_elf : OptionGroup<"kind">, HelpText<"OPTIONS (ELF specific)">;
50def dynamic_table : FF<"dynamic-table", "Display the dynamic section table">, Group<grp_elf>;
51def elf_linker_options : FF<"elf-linker-options", "Display the .linker-options section">, Group<grp_elf>;
52defm elf_output_style : Eq<"elf-output-style", "Specify ELF dump style: LLVM, GNU, JSON">, Group<grp_elf>;
53def histogram : FF<"histogram", "Display bucket list histogram for hash sections">, Group<grp_elf>;
54def section_groups : FF<"section-groups", "Display section groups">, Group<grp_elf>;
55def gnu_hash_table : FF<"gnu-hash-table", "Display the GNU hash table for dynamic symbols">, Group<grp_elf>;
56def hash_symbols : FF<"hash-symbols", "Display the dynamic symbols derived from the hash section">, Group<grp_elf>;
57def hash_table : FF<"hash-table", "Display .hash section">, Group<grp_elf>;
58def needed_libs : FF<"needed-libs", "Display the needed libraries">, Group<grp_elf>;
59def notes : FF<"notes", "Display notes">, Group<grp_elf>;
60def program_headers : FF<"program-headers", "Display program headers">, Group<grp_elf>;
61def raw_relr : FF<"raw-relr", "Do not decode relocations in SHT_RELR section, display raw contents">, Group<grp_elf>;
62def version_info : FF<"version-info", "Display version sections">, Group<grp_elf>;
63
64// Mach-O specific options.
65def grp_mach_o : OptionGroup<"kind">, HelpText<"OPTIONS (Mach-O specific)">;
66def macho_data_in_code : FF<"macho-data-in-code", "Display Data in Code command">, Group<grp_mach_o>;
67def macho_dysymtab : FF<"macho-dysymtab", "Display Dysymtab command">, Group<grp_mach_o>;
68def macho_indirect_symbols : FF<"macho-indirect-symbols", "Display indirect symbols">, Group<grp_mach_o>;
69def macho_linker_options : FF<"macho-linker-options", "Display linker options">, Group<grp_mach_o>;
70def macho_segment : FF<"macho-segment", "Display Segment command">, Group<grp_mach_o>;
71def macho_version_min : FF<"macho-version-min", "Display version min command">, Group<grp_mach_o>;
72
73// PE/COFF specific options.
74def grp_coff : OptionGroup<"kind">, HelpText<"OPTIONS (PE/COFF specific)">;
75def codeview : FF<"codeview", "Display CodeView debug information">, Group<grp_coff>;
76def codeview_ghash : FF<"codeview-ghash", "Enable global hashing for CodeView type stream de-duplication">, Group<grp_coff>;
77def codeview_merged_types : FF<"codeview-merged-types", "Display the merged CodeView type stream">, Group<grp_coff>;
78def codeview_subsection_bytes : FF<"codeview-subsection-bytes", "Dump raw contents of codeview debug sections and records">, Group<grp_coff>;
79def coff_basereloc : FF<"coff-basereloc", "Display .reloc section">, Group<grp_coff>;
80def coff_debug_directory : FF<"coff-debug-directory", "Display debug directory">, Group<grp_coff>;
81def coff_directives : FF<"coff-directives", "Display .drectve section">, Group<grp_coff>;
82def coff_exports : FF<"coff-exports", "Display export table">, Group<grp_coff>;
83def coff_imports : FF<"coff-imports", "Display import table">, Group<grp_coff>;
84def coff_load_config : FF<"coff-load-config", "Display load config">, Group<grp_coff>;
85def coff_resources : FF<"coff-resources", "Display .rsrc section">, Group<grp_coff>;
86def coff_tls_directory : FF<"coff-tls-directory", "Display TLS directory">, Group<grp_coff>;
87
88// XCOFF specific options.
89def grp_xcoff : OptionGroup<"kind">, HelpText<"OPTIONS (XCOFF specific)">;
90def auxiliary_header : FF<"auxiliary-header" , "Display the auxiliary header">, Group<grp_xcoff>;
91def exception_section : FF<"exception-section" , "Display the exception section entries">, Group<grp_xcoff>;
92def loader_section_header : FF<"loader-section-header" , "Display the loader section header">, Group<grp_xcoff>;
93def loader_section_symbols : FF<"loader-section-symbols" , "Display the loader section symbol table">, Group<grp_xcoff>;
94def loader_section_relocations : FF<"loader-section-relocations" , "Display the loader section relocation entries">, Group<grp_xcoff>;
95
96def help : FF<"help", "Display this help">;
97def version : FF<"version", "Display the version">;
98
99// Ignored for GNU readelf compatibility.
100def wide : FF<"wide", "Ignored for GNU readelf compatibility">;
101def : F<"W", "Ignored for GNU readelf compatibility">, Alias<wide>;
102
103// Traditional llvm-readobj Aliases.
104def : Flag<["--"], "dt">, Alias<dyn_syms>, HelpText<"Alias for --dyn-syms">;
105def : Flag<["--"], "sd">, Alias<section_data>, HelpText<"Alias for --section-data">;
106def : Flag<["--"], "st">, Alias<section_symbols>, HelpText<"Alias for --section-symbols">;
107def : Flag<["--"], "sr">, Alias<section_relocations>, HelpText<"Alias for --section-relocations">;
108
109// Aliases.
110def : FF<"dyn-symbols", "Alias for --dyn-syms">, Alias<dyn_syms>;
111def : FF<"dynamic", "Alias for --dynamic-table">, Alias<dynamic_table>;
112def : FF<"elf-cg-profile", "Alias for --cg-profile">, Alias<cg_profile>, Flags<[HelpHidden]>;
113def : FF<"elf-hash-histogram", "Alias for --histogram">, Alias<histogram>, Flags<[HelpHidden]>;
114def : FF<"elf-section-groups", "Alias for --section-groups">, Alias<section_groups>, Flags<[HelpHidden]>;
115def : FF<"file-headers", "Alias for --file-header">, Alias<file_header>, Flags<[HelpHidden]>;
116def : FF<"relocations", "Alias for --relocs">, Alias<relocs>;
117def : FF<"sections", "Alias for --section-headers">, Alias<section_headers>;
118def : FF<"segments", "Alias for --program-headers">, Alias<program_headers>, Group<grp_elf>;
119def : FF<"syms", "Alias for --symbols">, Alias<symbols>;
120
121def : F<"A", "Alias for --arch-specific">, Alias<arch_specific>;
122def : F<"a", "Alias for --all">, Alias<all>;
123def : F<"C", "Alias for --demangle">, Alias<demangle>;
124def : F<"d", "Alias for --dynamic-table">, Alias<dynamic_table>, Group<grp_elf>;
125def : F<"e", "Alias for --headers">, Alias<headers>;
126def : F<"g", "Alias for --section-groups">, Alias<section_groups>, Group<grp_elf>;
127def : F<"h", "Alias for --file-header">, Alias<file_header>;
128def : F<"I", "Alias for --histogram">, Alias<histogram>, Group<grp_elf>;
129def : F<"l", "Alias for --program-headers">, Alias<program_headers>;
130def : F<"n", "Alias for --notes">, Alias<notes>;
131def : JoinedOrSeparate<["-"], "p">, Alias<string_dump_EQ>, HelpText<"Alias for --string-dump">, MetaVarName<"<name or index>">;
132def : F<"r", "Alias for --relocs">, Alias<relocs>;
133def : F<"S", "Alias for --section-headers">, Alias<section_headers>;
134def : F<"s", "Alias for --symbols">, Alias<symbols>;
135def : F<"t", "Alias for --section-details">, Alias<section_details>;
136def : F<"u", "Alias for --unwind">, Alias<unwind>;
137def : F<"V", "Alias for --version-info">, Alias<version_info>, Group<grp_elf>;
138def : JoinedOrSeparate<["-"], "x">, Alias<hex_dump_EQ>, HelpText<"Alias for --hex-dump">, MetaVarName<"<name or index>">;
139