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