Properly categorize llvm-objdump options

[serge-sans-paille]

Summary

Filters out noise, and distinguish Mach-O related options from others.

[serge-sans-paille]

For reference, toe output of -help with and without filtering:

*with filtering*

OVERVIEW: llvm object file dumper

USAGE: llvm-objdump [options] <input object files>

OPTIONS:

Generic Options:

  --help                           - Display available options (--help-hidden for more)
  --help-list                      - Display list of available options (--help-list-hidden for more)
  --version                        - Display the version of this program

llvm-objdump MachO Specific Options:

  --arch=<string>                  - architecture(s) from a Mach-O file to dump
  --archive-member-offsets         - Print the offset to each archive member for Mach-O archives (requires -macho and -archive-headers)
  --bind                           - Display mach-o binding info
  --data-in-code                   - Print the data in code table for Mach-O objects (requires -macho)
  --dis-symname=<string>           - disassemble just this symbol's instructions (requires -macho)
  --dsym=<string>                  - Use .dSYM file for debug info
  --dylib-id                       - Print the shared library's id for the dylib Mach-O file (requires -macho)
  --dylibs-used                    - Print the shared libraries used for linked Mach-O files (requires -macho)
  --exports-trie                   - Display mach-o exported symbols
  --full-leading-addr              - Print full leading address
  -g                               - Print line information from debug info if available
  --indirect-symbols               - Print indirect symbol table for Mach-O objects (requires -macho)
  --info-plist                     - Print the info plist section as strings for Mach-O objects (requires -macho)
  --lazy-bind                      - Display mach-o lazy binding info
  --link-opt-hints                 - Print the linker optimization hints for Mach-O objects (requires -macho)
  --no-leading-headers             - Print no leading headers
  --no-symbolic-operands           - do not symbolic operands when disassembling (requires -macho)
  --non-verbose                    - Print the info for Mach-O objects in non-verbose or numeric form (requires -macho)
  --objc-meta-data                 - Print the Objective-C runtime meta data for Mach-O files (requires -macho)
  --private-header                 - Display only the first format specific file header
  --rebase                         - Display mach-o rebasing info
  --universal-headers              - Print Mach-O universal headers (requires -macho)
  --weak-bind                      - Display mach-o weak binding info

llvm-objdump Options:

  -C                               - Alias for --demangle
  -D                               - Alias for --disassemble-all
  -M                               - Alias for --disassembler-options
  -R                               - Alias for --dynamic-reloc
  -S                               - Alias for -source
  -a                               - Alias for --archive-headers
  --adjust-vma=<offset>            - Increase the displayed address by the specified offset
  --all-headers                    - Display all available header information
  --arch-name=<string>             - Target arch to disassemble for, see -version for available targets
  --archive-headers                - Display archive header information
  -d                               - Alias for --disassemble
  --demangle                       - Demangle symbols names
  --disassemble                    - Display assembler mnemonics for the machine instructions
  --disassemble-all                - Display assembler mnemonics for the machine instructions
  --disassemble-functions=<string> - List of functions to disassemble
  --disassemble-zeroes             - Do not skip blocks of zeroes when disassembling
  --disassembler-options=<options> - Pass target specific disassembler options
  --dwarf=<value>                  - Dump of dwarf debug sections:
    =frames                        -   .debug_frame
  --dynamic-reloc                  - Display the dynamic relocation entries in the file
  -f                               - Alias for --file-headers
  --fault-map-section              - Display contents of faultmap section
  --file-headers                   - Display the contents of the overall file header
  --full-contents                  - Display the content of each section
  -h                               - Alias for --section-headers
  --headers                        - Alias for --section-headers
  -j                               - Alias for --section
  -l                               - Alias for --line-numbers
  --line-numbers                   - Display source line numbers with disassembly. Implies disassemble object
  -m                               - Alias for --macho
  --macho                          - Use MachO specific object file parser
  --mattr=<a1,+a2,-a3,...>         - Target specific attributes
  --mcpu=<cpu-name>                - Target a specific cpu type (-mcpu=help for details)
  --no-leading-addr                - Print no leading address
  --no-show-raw-insn               - When disassembling instructions, do not print the instruction bytes.
  -p                               - Alias for --private-headers
  --print-imm-hex                  - Use hex format for immediate values
  --private-headers                - Display format specific file headers
  -r                               - Alias for --reloc
  --raw-clang-ast                  - Dump the raw binary contents of the clang AST section
  --reloc                          - Display the relocation entries in the file
  -s                               - Alias for --full-contents
  --section=<string>               - Operate on the specified sections only. With -macho dump segment,section
  --section-headers                - Display summaries of the headers for each section.
  --show-lma                       - Display LMA column when dumping ELF section headers
  --source                         - Display source inlined with disassembly. Implies disassemble object
  --start-address=<address>        - Disassemble beginning at address
  --stop-address=<address>         - Stop disassembly at address
  --syms                           - Display the symbol table
  -t                               - Alias for --syms
  --triple=<string>                - Target triple to disassemble for, see -version for available targets
  -u                               - Alias for --unwind-info
  --unwind-info                    - Display unwind information
  --wide                           - Ignored for compatibility with GNU objdump
  -x                               - Alias for --all-headers
  -z                               - Alias for --disassemble-zeroes

*without filtering*

OVERVIEW: llvm object file dumper

USAGE: llvm-objdump [options] <input object files>

OPTIONS:

Color Options:

  --color                                    - Use colors in output (default=autodetect)

General options:

  --cost-kind=<value>                        - Target cost kind
    =throughput                              -   Reciprocal throughput
    =latency                                 -   Instruction latency
    =code-size                               -   Code size
  --cvp-dont-add-nowrap-flags                - 
  --enable-gvn-memdep                        - 
  --enable-load-pre                          - 
  --enable-loop-simplifycfg-term-folding     - 
  --expensive-combines                       - Enable expensive instruction combines
  --instcombine-code-sinking                 - Enable code sinking
  --instcombine-guard-widening-window=<uint> - How wide an instruction window to bypass looking for another guard
  --instcombine-max-num-phis=<uint>          - Maximum number phis to handle in intptr/ptrint folding
  --instcombine-maxarray-size=<uint>         - Maximum array size considered when doing a combine
  --no-discriminators                        - Disable generation of discriminator information.
  --remarks-yaml-string-table                - 
  --safepoint-ir-verifier-print-only         - 
  --time-trace-granularity=<uint>            - Minimum time granularity (in microseconds) traced by time profiler
  --verify-region-info                       - Verify region info (time consuming)

Generic Options:

  --help                                     - Display available options (--help-hidden for more)
  --help-list                                - Display list of available options (--help-list-hidden for more)
  --version                                  - Display the version of this program

llvm-objdump MachO Specific Options:

  --arch=<string>                            - architecture(s) from a Mach-O file to dump
  --archive-member-offsets                   - Print the offset to each archive member for Mach-O archives (requires -macho and -archive-headers)
  --bind                                     - Display mach-o binding info
  --data-in-code                             - Print the data in code table for Mach-O objects (requires -macho)
  --dis-symname=<string>                     - disassemble just this symbol's instructions (requires -macho)
  --dsym=<string>                            - Use .dSYM file for debug info
  --dylib-id                                 - Print the shared library's id for the dylib Mach-O file (requires -macho)
  --dylibs-used                              - Print the shared libraries used for linked Mach-O files (requires -macho)
  --exports-trie                             - Display mach-o exported symbols
  --full-leading-addr                        - Print full leading address
  -g                                         - Print line information from debug info if available
  --indirect-symbols                         - Print indirect symbol table for Mach-O objects (requires -macho)
  --info-plist                               - Print the info plist section as strings for Mach-O objects (requires -macho)
  --lazy-bind                                - Display mach-o lazy binding info
  --link-opt-hints                           - Print the linker optimization hints for Mach-O objects (requires -macho)
  --no-leading-headers                       - Print no leading headers
  --no-symbolic-operands                     - do not symbolic operands when disassembling (requires -macho)
  --non-verbose                              - Print the info for Mach-O objects in non-verbose or numeric form (requires -macho)
  --objc-meta-data                           - Print the Objective-C runtime meta data for Mach-O files (requires -macho)
  --private-header                           - Display only the first format specific file header
  --rebase                                   - Display mach-o rebasing info
  --universal-headers                        - Print Mach-O universal headers (requires -macho)
  --weak-bind                                - Display mach-o weak binding info

llvm-objdump Options:

  -C                                         - Alias for --demangle
  -D                                         - Alias for --disassemble-all
  -M                                         - Alias for --disassembler-options
  -R                                         - Alias for --dynamic-reloc
  -S                                         - Alias for -source
  -a                                         - Alias for --archive-headers
  --adjust-vma=<offset>                      - Increase the displayed address by the specified offset
  --all-headers                              - Display all available header information
  --arch-name=<string>                       - Target arch to disassemble for, see -version for available targets
  --archive-headers                          - Display archive header information
  -d                                         - Alias for --disassemble
  --demangle                                 - Demangle symbols names
  --disassemble                              - Display assembler mnemonics for the machine instructions
  --disassemble-all                          - Display assembler mnemonics for the machine instructions
  --disassemble-functions=<string>           - List of functions to disassemble
  --disassemble-zeroes                       - Do not skip blocks of zeroes when disassembling
  --disassembler-options=<options>           - Pass target specific disassembler options
  --dwarf=<value>                            - Dump of dwarf debug sections:
    =frames                                  -   .debug_frame
  --dynamic-reloc                            - Display the dynamic relocation entries in the file
  -f                                         - Alias for --file-headers
  --fault-map-section                        - Display contents of faultmap section
  --file-headers                             - Display the contents of the overall file header
  --full-contents                            - Display the content of each section
  -h                                         - Alias for --section-headers
  --headers                                  - Alias for --section-headers
  -j                                         - Alias for --section
  -l                                         - Alias for --line-numbers
  --line-numbers                             - Display source line numbers with disassembly. Implies disassemble object
  -m                                         - Alias for --macho
  --macho                                    - Use MachO specific object file parser
  --mattr=<a1,+a2,-a3,...>                   - Target specific attributes
  --mcpu=<cpu-name>                          - Target a specific cpu type (-mcpu=help for details)
  --no-leading-addr                          - Print no leading address
  --no-show-raw-insn                         - When disassembling instructions, do not print the instruction bytes.
  -p                                         - Alias for --private-headers
  --print-imm-hex                            - Use hex format for immediate values
  --private-headers                          - Display format specific file headers
  -r                                         - Alias for --reloc
  --raw-clang-ast                            - Dump the raw binary contents of the clang AST section
  --reloc                                    - Display the relocation entries in the file
  -s                                         - Alias for --full-contents
  --section=<string>                         - Operate on the specified sections only. With -macho dump segment,section
  --section-headers                          - Display summaries of the headers for each section.
  --show-lma                                 - Display LMA column when dumping ELF section headers
  --source                                   - Display source inlined with disassembly. Implies disassemble object
  --start-address=<address>                  - Disassemble beginning at address
  --stop-address=<address>                   - Stop disassembly at address
  --syms                                     - Display the symbol table
  -t                                         - Alias for --syms
  --triple=<string>                          - Target triple to disassemble for, see -version for available targets
  -u                                         - Alias for --unwind-info
  --unwind-info                              - Display unwind information
  --wide                                     - Ignored for compatibility with GNU objdump
  -x                                         - Alias for --all-headers
  -z                                         - Alias for --disassemble-zeroes

[serge-sans-paille]

Following a remark from @jhenderson , and in order to make sure the options filtered out are not relevant, I've been running a clang-based script to compute the application callgraph, registering all calls to `llvm::cl` commands and their parent.

If I didn't messed up the script, none of the filtered out general options are actually reachable from main.

[MaskRay]

diff says the following options are removed from --help:

Color Options:

  --color                                    - Use colors in output (default=autodetect)

General options:

  --cost-kind=<value>                        - Target cost kind
    =throughput                              -   Reciprocal throughput
    =latency                                 -   Instruction latency
    =code-size                               -   Code size
  --cvp-dont-add-nowrap-flags                - 
  --enable-gvn-memdep                        - 
  --enable-load-pre                          - 
  --enable-loop-simplifycfg-term-folding     - 
  --expensive-combines                       - Enable expensive instruction combines
  --instcombine-code-sinking                 - Enable code sinking
  --instcombine-guard-widening-window=<uint> - How wide an instruction window to bypass looking for another guard
  --instcombine-max-num-phis=<uint>          - Maximum number phis to handle in intptr/ptrint folding
  --instcombine-maxarray-size=<uint>         - Maximum array size considered when doing a combine
  --no-discriminators                        - Disable generation of discriminator information.
  --remarks-yaml-string-table                - 
  --safepoint-ir-verifier-print-only         - 
  --time-trace-granularity=<uint>            - Minimum time granularity (in microseconds) traced by time profiler
  --verify-region-info                       - Verify region info (time consuming)

Looks great!

[MaskRay]

llvm/tools/llvm-objdump/llvm-objdump.cpp

2044

const cl::OptionCategory *...[] may be more common

llvm/tools/llvm-objdump/MachODump.cpp

 #include <xar/xar.h>
 }
 #endif
 
 using namespace llvm::object;
 
 namespace llvm {
 
+cl::OptionCategory MachOCat("llvm-objdump MachO Specific Options");
+
 extern cl::opt<bool> ArchiveHeaders;
 extern cl::opt<bool> Disassemble;
 extern cl::opt<bool> DisassembleAll;
 extern cl::opt<DIDumpType> DwarfDumpType;
 extern cl::list<std::string> FilterSections;
 extern cl::list<std::string> MAttrs;
 extern cl::opt<std::string> MCPU;
 extern cl::opt<bool> NoShowRawInsn;
 extern cl::opt<bool> NoLeadingAddr;
 extern cl::opt<bool> PrintImmHex;
 extern cl::opt<bool> PrivateHeaders;
 extern cl::opt<bool> Relocations;
 extern cl::opt<bool> SectionHeaders;
 extern cl::opt<bool> SectionContents;
 extern cl::opt<bool> SymbolTable;
 extern cl::opt<std::string> TripleName;
 extern cl::opt<bool> UnwindInfo;
 
 cl::opt<bool>
     FirstPrivateHeader("private-header",
                        cl::desc("Display only the first format specific file "
-                                "header"));
+                                "header"),
+                       cl::cat(MachOCat));
 
 cl::opt<bool> ExportsTrie("exports-trie",
-                                 cl::desc("Display mach-o exported symbols"));
+                          cl::desc("Display mach-o exported symbols"),
+                          cl::cat(MachOCat));
 
-cl::opt<bool> Rebase("rebase", cl::desc("Display mach-o rebasing info"));
+cl::opt<bool> Rebase("rebase", cl::desc("Display mach-o rebasing info"),
+                     cl::cat(MachOCat));
 
-cl::opt<bool> Bind("bind", cl::desc("Display mach-o binding info"));
+cl::opt<bool> Bind("bind", cl::desc("Display mach-o binding info"),
+                   cl::cat(MachOCat));
 
 cl::opt<bool> LazyBind("lazy-bind",
-                              cl::desc("Display mach-o lazy binding info"));
+                       cl::desc("Display mach-o lazy binding info"),
+                       cl::cat(MachOCat));
 
 cl::opt<bool> WeakBind("weak-bind",
-                              cl::desc("Display mach-o weak binding info"));
+                       cl::desc("Display mach-o weak binding info"),
+                       cl::cat(MachOCat));
 
 static cl::opt<bool>
     UseDbg("g", cl::Grouping,
-           cl::desc("Print line information from debug info if available"));
+           cl::desc("Print line information from debug info if available"),
+           cl::cat(MachOCat));
 
 static cl::opt<std::string> DSYMFile("dsym",
-                                     cl::desc("Use .dSYM file for debug info"));
+                                     cl::desc("Use .dSYM file for debug info"),
+                                     cl::cat(MachOCat));
 
 static cl::opt<bool> FullLeadingAddr("full-leading-addr",
-                                     cl::desc("Print full leading address"));
+                                     cl::desc("Print full leading address"),
+                                     cl::cat(MachOCat));
 
 static cl::opt<bool> NoLeadingHeaders("no-leading-headers",
-                                      cl::desc("Print no leading headers"));
+                                      cl::desc("Print no leading headers"),
+                                      cl::cat(MachOCat));
 
 cl::opt<bool> UniversalHeaders("universal-headers",
                                cl::desc("Print Mach-O universal headers "
-                                        "(requires -macho)"));
+                                        "(requires -macho)"),
+                               cl::cat(MachOCat));
 
 cl::opt<bool>
     ArchiveMemberOffsets("archive-member-offsets",
                          cl::desc("Print the offset to each archive member for "
                                   "Mach-O archives (requires -macho and "
-                                  "-archive-headers)"));
+                                  "-archive-headers)"),
+                         cl::cat(MachOCat));
 
 cl::opt<bool> IndirectSymbols("indirect-symbols",
                               cl::desc("Print indirect symbol table for Mach-O "
-                                       "objects (requires -macho)"));
+                                       "objects (requires -macho)"),
+                              cl::cat(MachOCat));
 
 cl::opt<bool>
     DataInCode("data-in-code",
                cl::desc("Print the data in code table for Mach-O objects "
-                        "(requires -macho)"));
+                        "(requires -macho)"),
+               cl::cat(MachOCat));
 
 cl::opt<bool> LinkOptHints("link-opt-hints",
                            cl::desc("Print the linker optimization hints for "
-                                    "Mach-O objects (requires -macho)"));
+                                    "Mach-O objects (requires -macho)"),
+                           cl::cat(MachOCat));
 
 cl::opt<bool> InfoPlist("info-plist",
                         cl::desc("Print the info plist section as strings for "
-                                 "Mach-O objects (requires -macho)"));
+                                 "Mach-O objects (requires -macho)"),
+                        cl::cat(MachOCat));
 
 cl::opt<bool> DylibsUsed("dylibs-used",
                          cl::desc("Print the shared libraries used for linked "
-                                  "Mach-O files (requires -macho)"));
+                                  "Mach-O files (requires -macho)"),
+                         cl::cat(MachOCat));
 
 cl::opt<bool>
     DylibId("dylib-id",
             cl::desc("Print the shared library's id for the dylib Mach-O "
-                     "file (requires -macho)"));
+                     "file (requires -macho)"),
+            cl::cat(MachOCat));
 
 cl::opt<bool>
     NonVerbose("non-verbose",
                cl::desc("Print the info for Mach-O objects in "
-                        "non-verbose or numeric form (requires -macho)"));
+                        "non-verbose or numeric form (requires -macho)"),
+               cl::cat(MachOCat));
 
 cl::opt<bool>
     ObjcMetaData("objc-meta-data",
                  cl::desc("Print the Objective-C runtime meta data for "
-                          "Mach-O files (requires -macho)"));
+                          "Mach-O files (requires -macho)"),
+                 cl::cat(MachOCat));
 
 cl::opt<std::string> DisSymName(
     "dis-symname",
-    cl::desc("disassemble just this symbol's instructions (requires -macho)"));
+    cl::desc("disassemble just this symbol's instructions (requires -macho)"),
+    cl::cat(MachOCat));
 
 static cl::opt<bool> NoSymbolicOperands(
     "no-symbolic-operands",
-    cl::desc("do not symbolic operands when disassembling (requires -macho)"));
+    cl::desc("do not symbolic operands when disassembling (requires -macho)"),
+    cl::cat(MachOCat));
 
 static cl::list<std::string>
     ArchFlags("arch", cl::desc("architecture(s) from a Mach-O file to dump"),
-              cl::ZeroOrMore);
+              cl::ZeroOrMore, cl::cat(MachOCat));
 
 bool ArchAll = false;
 
 static std::string ThumbTripleName;
 
 static const Target *GetTarget(const MachOObjectFile *MachOObj,
                                const char **McpuDefault,
                                const Target **ThumbTarget) {

llvm/tools/llvm-objdump/llvm-objdump.cpp

 #include <system_error>
 #include <unordered_map>
 #include <utility>
 
 using namespace llvm::object;
 
 namespace llvm {
 
+cl::OptionCategory ObjdumpCat("llvm-objdump Options");
+
 // MachO specific
+extern cl::OptionCategory MachOCat;
 extern cl::opt<bool> Bind;
 extern cl::opt<bool> DataInCode;
 extern cl::opt<bool> DylibsUsed;
 extern cl::opt<bool> DylibId;
 extern cl::opt<bool> ExportsTrie;
 extern cl::opt<bool> FirstPrivateHeader;
 extern cl::opt<bool> IndirectSymbols;
 extern cl::opt<bool> InfoPlist;
 extern cl::opt<bool> LazyBind;
 extern cl::opt<bool> LinkOptHints;
 extern cl::opt<bool> ObjcMetaData;
 extern cl::opt<bool> Rebase;
 extern cl::opt<bool> UniversalHeaders;
 extern cl::opt<bool> WeakBind;
 
 static cl::opt<uint64_t> AdjustVMA(
     "adjust-vma",
     cl::desc("Increase the displayed address by the specified offset"),
-    cl::value_desc("offset"), cl::init(0));
+    cl::value_desc("offset"), cl::init(0), cl::cat(ObjdumpCat));
 
 static cl::opt<bool>
     AllHeaders("all-headers",
-               cl::desc("Display all available header information"));
+               cl::desc("Display all available header information"),
+               cl::cat(ObjdumpCat));
 static cl::alias AllHeadersShort("x", cl::desc("Alias for --all-headers"),
                                  cl::NotHidden, cl::Grouping,
                                  cl::aliasopt(AllHeaders));
 
 static cl::opt<std::string>
-    ArchName("arch-name", cl::desc("Target arch to disassemble for, "
-                                   "see -version for available targets"));
+    ArchName("arch-name",
+             cl::desc("Target arch to disassemble for, "
+                      "see -version for available targets"),
+             cl::cat(ObjdumpCat));
 
 cl::opt<bool> ArchiveHeaders("archive-headers",
-                             cl::desc("Display archive header information"));
+                             cl::desc("Display archive header information"),
+                             cl::cat(ObjdumpCat));
 static cl::alias ArchiveHeadersShort("a",
                                      cl::desc("Alias for --archive-headers"),
                                      cl::NotHidden, cl::Grouping,
                                      cl::aliasopt(ArchiveHeaders));
 
 cl::opt<bool> Demangle("demangle", cl::desc("Demangle symbols names"),
-                       cl::init(false));
+                       cl::init(false), cl::cat(ObjdumpCat));
 static cl::alias DemangleShort("C", cl::desc("Alias for --demangle"),
                                cl::NotHidden, cl::Grouping,
                                cl::aliasopt(Demangle));
 
 cl::opt<bool> Disassemble(
     "disassemble",
-    cl::desc("Display assembler mnemonics for the machine instructions"));
+    cl::desc("Display assembler mnemonics for the machine instructions"),
+    cl::cat(ObjdumpCat));
 static cl::alias DisassembleShort("d", cl::desc("Alias for --disassemble"),
                                   cl::NotHidden, cl::Grouping,
                                   cl::aliasopt(Disassemble));
 
 cl::opt<bool> DisassembleAll(
     "disassemble-all",
-    cl::desc("Display assembler mnemonics for the machine instructions"));
+    cl::desc("Display assembler mnemonics for the machine instructions"),
+    cl::cat(ObjdumpCat));
 static cl::alias DisassembleAllShort("D",
                                      cl::desc("Alias for --disassemble-all"),
                                      cl::NotHidden, cl::Grouping,
                                      cl::aliasopt(DisassembleAll));
 
 static cl::list<std::string>
-DisassembleFunctions("disassemble-functions",
-                     cl::CommaSeparated,
-                     cl::desc("List of functions to disassemble"));
+    DisassembleFunctions("disassemble-functions", cl::CommaSeparated,
+                         cl::desc("List of functions to disassemble"),
+                         cl::cat(ObjdumpCat));
 
 static cl::opt<bool> DisassembleZeroes(
     "disassemble-zeroes",
-    cl::desc("Do not skip blocks of zeroes when disassembling"));
+    cl::desc("Do not skip blocks of zeroes when disassembling"),
+    cl::cat(ObjdumpCat));
 static cl::alias
     DisassembleZeroesShort("z", cl::desc("Alias for --disassemble-zeroes"),
                            cl::NotHidden, cl::Grouping,
                            cl::aliasopt(DisassembleZeroes));
 
 static cl::list<std::string>
     DisassemblerOptions("disassembler-options",
                         cl::desc("Pass target specific disassembler options"),
-                        cl::value_desc("options"), cl::CommaSeparated);
+                        cl::value_desc("options"), cl::CommaSeparated,
+                        cl::cat(ObjdumpCat));
 static cl::alias
     DisassemblerOptionsShort("M", cl::desc("Alias for --disassembler-options"),
                              cl::NotHidden, cl::Grouping, cl::Prefix,
                              cl::CommaSeparated,
                              cl::aliasopt(DisassemblerOptions));
 
 cl::opt<DIDumpType> DwarfDumpType(
     "dwarf", cl::init(DIDT_Null), cl::desc("Dump of dwarf debug sections:"),
-    cl::values(clEnumValN(DIDT_DebugFrame, "frames", ".debug_frame")));
+    cl::values(clEnumValN(DIDT_DebugFrame, "frames", ".debug_frame")),
+    cl::cat(ObjdumpCat));
 
 static cl::opt<bool> DynamicRelocations(
     "dynamic-reloc",
-    cl::desc("Display the dynamic relocation entries in the file"));
+    cl::desc("Display the dynamic relocation entries in the file"),
+    cl::cat(ObjdumpCat));
 static cl::alias DynamicRelocationShort("R",
                                         cl::desc("Alias for --dynamic-reloc"),
                                         cl::NotHidden, cl::Grouping,
                                         cl::aliasopt(DynamicRelocations));
 
 static cl::opt<bool>
     FaultMapSection("fault-map-section",
-                   cl::desc("Display contents of faultmap section"));
+                    cl::desc("Display contents of faultmap section"),
+                    cl::cat(ObjdumpCat));
 
 static cl::opt<bool>
     FileHeaders("file-headers",
-                cl::desc("Display the contents of the overall file header"));
+                cl::desc("Display the contents of the overall file header"),
+                cl::cat(ObjdumpCat));
 static cl::alias FileHeadersShort("f", cl::desc("Alias for --file-headers"),
                                   cl::NotHidden, cl::Grouping,
                                   cl::aliasopt(FileHeaders));
 
 cl::opt<bool> SectionContents("full-contents",
-                              cl::desc("Display the content of each section"));
+                              cl::desc("Display the content of each section"),
+                              cl::cat(ObjdumpCat));
 static cl::alias SectionContentsShort("s",
                                       cl::desc("Alias for --full-contents"),
                                       cl::NotHidden, cl::Grouping,
                                       cl::aliasopt(SectionContents));
 
-static cl::list<std::string>
-InputFilenames(cl::Positional, cl::desc("<input object files>"),cl::ZeroOrMore);
+static cl::list<std::string> InputFilenames(cl::Positional,
+                                            cl::desc("<input object files>"),
+                                            cl::ZeroOrMore,
+                                            cl::cat(ObjdumpCat));
 
 static cl::opt<bool>
     PrintLines("line-numbers",
                cl::desc("Display source line numbers with "
-                        "disassembly. Implies disassemble object"));
+                        "disassembly. Implies disassemble object"),
+               cl::cat(ObjdumpCat));
 static cl::alias PrintLinesShort("l", cl::desc("Alias for --line-numbers"),
                                  cl::NotHidden, cl::Grouping,
                                  cl::aliasopt(PrintLines));
 
-static cl::opt<bool>
-MachOOpt("macho", cl::desc("Use MachO specific object file parser"));
+static cl::opt<bool> MachOOpt("macho",
+                              cl::desc("Use MachO specific object file parser"),
+                              cl::cat(ObjdumpCat));
 static cl::alias MachOm("m", cl::desc("Alias for --macho"), cl::NotHidden,
                         cl::Grouping, cl::aliasopt(MachOOpt));
 
 cl::opt<std::string>
     MCPU("mcpu",
          cl::desc("Target a specific cpu type (-mcpu=help for details)"),
-         cl::value_desc("cpu-name"), cl::init(""));
+         cl::value_desc("cpu-name"), cl::init(""), cl::cat(ObjdumpCat));
 
 cl::list<std::string> MAttrs("mattr", cl::CommaSeparated,
                              cl::desc("Target specific attributes"),
-                             cl::value_desc("a1,+a2,-a3,..."));
+                             cl::value_desc("a1,+a2,-a3,..."),
+                             cl::cat(ObjdumpCat));
 
 cl::opt<bool> NoShowRawInsn("no-show-raw-insn",
                             cl::desc("When disassembling "
                                      "instructions, do not print "
-                                     "the instruction bytes."));
+                                     "the instruction bytes."),
+                            cl::cat(ObjdumpCat));
 cl::opt<bool> NoLeadingAddr("no-leading-addr",
-                                   cl::desc("Print no leading address"));
+                            cl::desc("Print no leading address"),
+                            cl::cat(ObjdumpCat));
 
 static cl::opt<bool> RawClangAST(
     "raw-clang-ast",
-    cl::desc("Dump the raw binary contents of the clang AST section"));
+    cl::desc("Dump the raw binary contents of the clang AST section"),
+    cl::cat(ObjdumpCat));
 
 cl::opt<bool>
-    Relocations("reloc",
-                cl::desc("Display the relocation entries in the file"));
+    Relocations("reloc", cl::desc("Display the relocation entries in the file"),
+                cl::cat(ObjdumpCat));
 static cl::alias RelocationsShort("r", cl::desc("Alias for --reloc"),
                                   cl::NotHidden, cl::Grouping,
                                   cl::aliasopt(Relocations));
 
-cl::opt<bool>
-    PrintImmHex("print-imm-hex",
-                cl::desc("Use hex format for immediate values"));
-
-cl::opt<bool>
-    PrivateHeaders("private-headers",
-                   cl::desc("Display format specific file headers"));
+cl::opt<bool> PrintImmHex("print-imm-hex",
+                          cl::desc("Use hex format for immediate values"),
+                          cl::cat(ObjdumpCat));
+
+cl::opt<bool> PrivateHeaders("private-headers",
+                             cl::desc("Display format specific file headers"),
+                             cl::cat(ObjdumpCat));
 static cl::alias PrivateHeadersShort("p",
                                      cl::desc("Alias for --private-headers"),
                                      cl::NotHidden, cl::Grouping,
                                      cl::aliasopt(PrivateHeaders));
 
 cl::list<std::string>
     FilterSections("section",
                    cl::desc("Operate on the specified sections only. "
-                            "With -macho dump segment,section"));
+                            "With -macho dump segment,section"),
+                   cl::cat(ObjdumpCat));
 static cl::alias FilterSectionsj("j", cl::desc("Alias for --section"),
                                  cl::NotHidden, cl::Grouping, cl::Prefix,
                                  cl::aliasopt(FilterSections));
 
 cl::opt<bool> SectionHeaders("section-headers",
                              cl::desc("Display summaries of the "
-                                      "headers for each section."));
+                                      "headers for each section."),
+                             cl::cat(ObjdumpCat));
 static cl::alias SectionHeadersShort("headers",
                                      cl::desc("Alias for --section-headers"),
                                      cl::NotHidden,
                                      cl::aliasopt(SectionHeaders));
 static cl::alias SectionHeadersShorter("h",
                                        cl::desc("Alias for --section-headers"),
                                        cl::NotHidden, cl::Grouping,
                                        cl::aliasopt(SectionHeaders));
 
 static cl::opt<bool>
     ShowLMA("show-lma",
-            cl::desc("Display LMA column when dumping ELF section headers"));
+            cl::desc("Display LMA column when dumping ELF section headers"),
+            cl::cat(ObjdumpCat));
 
 static cl::opt<bool> PrintSource(
     "source",
     cl::desc(
-        "Display source inlined with disassembly. Implies disassemble object"));
+        "Display source inlined with disassembly. Implies disassemble object"),
+    cl::cat(ObjdumpCat));
 static cl::alias PrintSourceShort("S", cl::desc("Alias for -source"),
                                   cl::NotHidden, cl::Grouping,
                                   cl::aliasopt(PrintSource));
 
 static cl::opt<uint64_t>
     StartAddress("start-address", cl::desc("Disassemble beginning at address"),
-                 cl::value_desc("address"), cl::init(0));
+                 cl::value_desc("address"), cl::init(0), cl::cat(ObjdumpCat));
 static cl::opt<uint64_t> StopAddress("stop-address",
                                      cl::desc("Stop disassembly at address"),
                                      cl::value_desc("address"),
-                                     cl::init(UINT64_MAX));
+                                     cl::init(UINT64_MAX), cl::cat(ObjdumpCat));
 
-cl::opt<bool> SymbolTable("syms", cl::desc("Display the symbol table"));
+cl::opt<bool> SymbolTable("syms", cl::desc("Display the symbol table"),
+                          cl::cat(ObjdumpCat));
 static cl::alias SymbolTableShort("t", cl::desc("Alias for --syms"),
                                   cl::NotHidden, cl::Grouping,
                                   cl::aliasopt(SymbolTable));
 
 cl::opt<std::string> TripleName("triple",
                                 cl::desc("Target triple to disassemble for, "
-                                         "see -version for available targets"));
+                                         "see -version for available targets"),
+                                cl::cat(ObjdumpCat));
 
-cl::opt<bool> UnwindInfo("unwind-info",
-                                cl::desc("Display unwind information"));
+cl::opt<bool> UnwindInfo("unwind-info", cl::desc("Display unwind information"),
+                         cl::cat(ObjdumpCat));
 static cl::alias UnwindInfoShort("u", cl::desc("Alias for --unwind-info"),
                                  cl::NotHidden, cl::Grouping,
                                  cl::aliasopt(UnwindInfo));
 
-
 static cl::opt<bool>
-    Wide("wide", cl::desc("Ignored for compatibility with GNU objdump"));
+    Wide("wide", cl::desc("Ignored for compatibility with GNU objdump"),
+         cl::cat(ObjdumpCat));
 static cl::alias WideShort("w", cl::Grouping, cl::aliasopt(Wide));
 
 static StringSet<> DisasmFuncsSet;
 static StringRef ToolName;
 
 typedef std::vector<std::tuple<uint64_t, StringRef, uint8_t>> SectionSymbolsTy;
 
 SectionFilter ToolSectionFilter(object::ObjectFile const &O) {
static void dumpInput(StringRef file) {
   else
     report_error(errorCodeToError(object_error::invalid_file_type), file);
 }
 } // namespace llvm
 
 int main(int argc, char **argv) {
   using namespace llvm;
   InitLLVM X(argc, argv);
+  cl::OptionCategory const *OptionFilters[] = {&ObjdumpCat, &MachOCat};
+  cl::HideUnrelatedOptions(OptionFilters);
 
   // Initialize targets and assembly printers/parsers.
   InitializeAllTargetInfos();
   InitializeAllTargetMCs();
   InitializeAllDisassemblers();
 
   // Register the target printer for --version.
   cl::AddExtraVersionPrinter(TargetRegistry::printRegisteredTargetsForVersion);