This is an archive of the discontinued LLVM Phabricator instance.

Differential D126133

[llvm-nm][docs] Document -W and -U
ClosedPublic

Authored by MaskRay on May 21 2022, 4:01 PM.

Details

Reviewers
jhenderson
keith
Commits
rG224a8653c98e: [llvm-nm][docs] Document -W and -U
Summary

Latest GNU nm (milestone: 2.39) has added -W/--no-weak and changed -U to mean
--defined-only (instead of --unicode=). The changes match our semantics.

Close #55297

Diff Detail

Event Timeline

MaskRay created this revision.May 21 2022, 4:01 PM
Herald added a project: Restricted Project. · View Herald TranscriptMay 21 2022, 4:01 PM
Herald added subscribers: StephenFan, rupprecht. · View Herald Transcript
MaskRay requested review of this revision.May 21 2022, 4:01 PM
Herald added a project: Restricted Project. · View Herald TranscriptMay 21 2022, 4:01 PM
Herald added a subscriber: llvm-commits. · View Herald Transcript
keith accepted this revision.May 21 2022, 5:43 PM

Awesome, thanks!

This revision is now accepted and ready to land.May 21 2022, 5:43 PM
jhenderson accepted this revision.May 23 2022, 3:56 AM

LGTM!

This revision was landed with ongoing or failed builds.May 23 2022, 9:59 AM
Closed by commit rG224a8653c98e: [llvm-nm][docs] Document -W and -U (authored by MaskRay). · Explain Why
This revision was automatically updated to reflect the committed changes.
MaskRay added a commit: rG224a8653c98e: [llvm-nm][docs] Document -W and -U.

Revision Contents

PathSize
llvm/
docs/
CommandGuide/
4 lines
tools/
llvm-nm/
4 lines

Diff 431414

llvm/docs/CommandGuide/llvm-nm.rst

Show First 20 Lines • Show All 139 Lines • ▼ Show 20 Lines 32_64
Process both 32-bit and 64-bit object files. Process both 32-bit and 64-bit object files.
any any
Process all the supported object files. Process all the supported object files.
.. option:: --debug-syms, -a .. option:: --debug-syms, -a
Show all symbols, even those usually suppressed. Show all symbols, even those usually suppressed.
.. option:: --defined-only .. option:: --defined-only, -U
Print only symbols defined in this file. Print only symbols defined in this file.
.. option:: --demangle, -C .. option:: --demangle, -C
Demangle symbol names. Demangle symbol names.
.. option:: --dynamic, -D .. option:: --dynamic, -D
Show All 35 Lines
.. option:: --no-llvm-bc .. option:: --no-llvm-bc
Disable the LLVM bitcode reader. Disable the LLVM bitcode reader.
.. option:: --no-sort, -p .. option:: --no-sort, -p
Show symbols in the order encountered. Show symbols in the order encountered.
.. option:: --no-weak .. option:: --no-weak, -W
Don't print weak symbols. Don't print weak symbols.
.. option:: --numeric-sort, -n, -v .. option:: --numeric-sort, -n, -v
Sort symbols by address. Sort symbols by address.
.. option:: --portability, -P .. option:: --portability, -P
▲ Show 20 Lines • Show All 104 Lines • Show Last 20 Lines

llvm/tools/llvm-nm/Opts.td

Show First 20 Lines • Show All 71 Lines • ▼ Show 20 Lines
def : F<"n", "Alias for --numeric-sort">, Alias<numeric_sort>; def : F<"n", "Alias for --numeric-sort">, Alias<numeric_sort>;
def : F<"o", "Alias for --print-file-name">, Alias<print_file_name>; def : F<"o", "Alias for --print-file-name">, Alias<print_file_name>;
def : F<"p", "Alias for --no-sort">, Alias<no_sort>; def : F<"p", "Alias for --no-sort">, Alias<no_sort>;
def : F<"P", "Alias for --format=posix">, Alias<format_EQ>, AliasArgs<["posix"]>; def : F<"P", "Alias for --format=posix">, Alias<format_EQ>, AliasArgs<["posix"]>;
def : F<"r", "Alias for --reverse-sort">, Alias<reverse_sort>; def : F<"r", "Alias for --reverse-sort">, Alias<reverse_sort>;
def : F<"S", "Alias for --print-size">, Alias<print_size>; def : F<"S", "Alias for --print-size">, Alias<print_size>;
def : JoinedOrSeparate<["-"], "t">, HelpText<"Alias for --radix">, Alias<radix_EQ>, MetaVarName<"<radix>">; def : JoinedOrSeparate<["-"], "t">, HelpText<"Alias for --radix">, Alias<radix_EQ>, MetaVarName<"<radix>">;
def : F<"u", "Alias for --undefined-only">, Alias<undefined_only>; def : F<"u", "Alias for --undefined-only">, Alias<undefined_only>;
def : F<"U", "Deprecated alias for --defined-only">, Alias<defined_only>, Flags<[HelpHidden]>; def : F<"U", "Alias for --defined-only">, Alias<defined_only>;
def : F<"v", "Alias for --numeric-sort">, Alias<numeric_sort>; def : F<"v", "Alias for --numeric-sort">, Alias<numeric_sort>;
def : F<"V", "Alias for --version">, Alias<version>; def : F<"V", "Alias for --version">, Alias<version>;
def : F<"W", "Deprecated alias for --no-weak">, Alias<no_weak>, Flags<[HelpHidden]>; def : F<"W", "Alias for --no-weak">, Alias<no_weak>;