diff options
| author | Fangrui Song <i@maskray.me> | 2021-07-12 10:14:42 -0700 |
|---|---|---|
| committer | Fangrui Song <i@maskray.me> | 2021-07-12 10:14:42 -0700 |
| commit | 46580d43fc70dcecf21d2cedceeb4910c756fa6e (patch) | |
| tree | 6eeae71f07bdd67222f128839876f4f6c399dfa1 /llvm/docs/CommandGuide/llvm-readobj.rst | |
| parent | fe892114e33b8f98bf3537a0dd6d6798821cb849 (diff) | |
| download | llvm-46580d43fc70dcecf21d2cedceeb4910c756fa6e.zip llvm-46580d43fc70dcecf21d2cedceeb4910c756fa6e.tar.gz llvm-46580d43fc70dcecf21d2cedceeb4910c756fa6e.tar.bz2 | |
[llvm-readobj] Switch command line parsing from llvm::cl to OptTable
Users should generally observe no difference as long as they don't use
unintended option forms. Behavior changes:
* `-t=d` is removed. Use `-t d` instead.
* `--demangle=false` and `--demangle=0` cannot be used. Omit the option or use `--no-demangle`. Other flag-style options don't have `--no-` forms.
* `--help-list` is removed. This is a `cl::` specific option.
* llvm-readobj now supports grouped short options as well.
* `--color` is removed. This is generally not useful (only apply to errors/warnings) but was inherited from Support.
Some adjustment to the canonical forms
(usually from GNU readelf; currently llvm-readobj has too many redundant aliases):
* --dyn-syms is canonical. --dyn-symbols is a hidden alias
* --file-header is canonical. --file-headers is a hidden alias
* --histogram is canonical. --elf-hash-histogram is a hidden alias
* --relocs is canonical. --relocations is a hidden alias
* --section-groups is canonical. --elf-section-groups is a hidden alias
OptTable avoids global option collision if we decide to support multiplexing for binary utilities.
* Most one-dash long options are still supported. `-dt, -sd, -st, -sr` are dropped due to their conflict with grouped short options.
* `--section-mapping=false` (D57365) is strange but is kept for now.
* Many `cl::opt` variables were unnecessarily external. I added `static` whenever appropriate.
Reviewed By: jhenderson
Differential Revision: https://reviews.llvm.org/D105532
Diffstat (limited to 'llvm/docs/CommandGuide/llvm-readobj.rst')
| -rw-r--r-- | llvm/docs/CommandGuide/llvm-readobj.rst | 18 |
1 files changed, 5 insertions, 13 deletions
diff --git a/llvm/docs/CommandGuide/llvm-readobj.rst b/llvm/docs/CommandGuide/llvm-readobj.rst index 8c4546b..2fb639f 100644 --- a/llvm/docs/CommandGuide/llvm-readobj.rst +++ b/llvm/docs/CommandGuide/llvm-readobj.rst @@ -56,32 +56,24 @@ file formats. Display the address-significance table. -.. option:: --color - - Use colors in the output for warnings and errors. - .. option:: --expand-relocs - When used with :option:`--relocations`, display each relocation in an expanded + When used with :option:`--relocs`, display each relocation in an expanded multi-line format. -.. option:: --file-headers, -h +.. option:: --file-header, -h Display file headers. .. option:: --headers, -e - Equivalent to setting: :option:`--file-headers`, :option:`--program-headers`, + Equivalent to setting: :option:`--file-header`, :option:`--program-headers`, and :option:`--sections`. .. option:: --help Display a summary of command line options. -.. option:: --help-list - - Display an uncategorized summary of command line options. - .. option:: --hex-dump=<section[,section,...]>, -x Display the specified section(s) as hexadecimal bytes. ``section`` may be a @@ -181,7 +173,7 @@ The following options are implemented only for the ELF file format. Display the callgraph profile section. -.. option:: --elf-hash-histogram, --histogram, -I +.. option:: --histogram, -I Display a bucket list histogram for dynamic symbol hash tables. @@ -195,7 +187,7 @@ The following options are implemented only for the ELF file format. ``GNU``. ``LLVM`` output (the default) is an expanded and structured format, whilst ``GNU`` output mimics the equivalent GNU :program:`readelf` output. -.. option:: --elf-section-groups, --section-groups, -g +.. option:: --section-groups, -g Display section groups. |