{
    "mode": "man",
    "parameter": "nm",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/nm/1/json",
    "generated": "2026-10-07T15:06:43Z",
    "synopsis": "nm [-A|-o|--print-file-name]\n[-a|--debug-syms]\n[-B|--format=bsd]\n[-C|--demangle[=style]]\n[-D|--dynamic]\n[-fformat|--format=format]\n[-g|--extern-only]\n[-h|--help]\n[--ifunc-chars=CHARS]\n[-j|--format=just-symbols]\n[-l|--line-numbers] [--inlines]\n[-n|-v|--numeric-sort]\n[-P|--portability]\n[-p|--no-sort]\n[-r|--reverse-sort]\n[-S|--print-size]\n[-s|--print-armap]\n[-t radix|--radix=radix]\n[-u|--undefined-only]\n[-U|--defined-only]\n[-V|--version]\n[-W|--no-weak]\n[-X 3264]\n[--no-demangle]\n[--no-recurse-limit|--recurse-limit]]\n[--plugin name]\n[--size-sort]\n[--special-syms]\n[--synthetic]\n[--target=bfdname]\n[--unicode=method]\n[--with-symbol-versions]\n[--without-symbol-versions]\n[objfile...]",
    "sections": {
        "NAME": {
            "content": "nm - list symbols from object files\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "nm [-A|-o|--print-file-name]\n[-a|--debug-syms]\n[-B|--format=bsd]\n[-C|--demangle[=style]]\n[-D|--dynamic]\n[-fformat|--format=format]\n[-g|--extern-only]\n[-h|--help]\n[--ifunc-chars=CHARS]\n[-j|--format=just-symbols]\n[-l|--line-numbers] [--inlines]\n[-n|-v|--numeric-sort]\n[-P|--portability]\n[-p|--no-sort]\n[-r|--reverse-sort]\n[-S|--print-size]\n[-s|--print-armap]\n[-t radix|--radix=radix]\n[-u|--undefined-only]\n[-U|--defined-only]\n[-V|--version]\n[-W|--no-weak]\n[-X 3264]\n[--no-demangle]\n[--no-recurse-limit|--recurse-limit]]\n[--plugin name]\n[--size-sort]\n[--special-syms]\n[--synthetic]\n[--target=bfdname]\n[--unicode=method]\n[--with-symbol-versions]\n[--without-symbol-versions]\n[objfile...]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "GNU nm lists the symbols from object files objfile....  If no object files are listed as\narguments, nm assumes the file a.out.\n\nFor each symbol, nm shows:\n\n•   The  symbol  value,  in  the  radix  selected  by  options (see below), or hexadecimal by\ndefault.\n\n•   The symbol type.  At least the following types are used; others are, as  well,  depending\non  the object file format.  If lowercase, the symbol is usually local; if uppercase, the\nsymbol is global (external).  There are however a few lowercase symbols  that  are  shown\nfor special global symbols (\"u\", \"v\" and \"w\").\n\n\"A\" The symbol's value is absolute, and will not be changed by further linking.\n\n\"B\"\n\"b\" The  symbol  is  in  the  BSS  data  section.   This section typically contains zero-\ninitialized or uninitialized data, although the exact behavior is system dependent.\n\n\"C\"\n\"c\" The symbol is common.  Common symbols are uninitialized data.  When linking, multiple\ncommon symbols may appear with the same name.  If the symbol is defined anywhere, the\ncommon symbols are treated as undefined references.  The lower case  c  character  is\nused when the symbol is in a special section for small commons.\n\n\"D\"\n\"d\" The symbol is in the initialized data section.\n\n\"G\"\n\"g\" The  symbol  is  in  an initialized data section for small objects.  Some object file\nformats permit more efficient access to small data objects,  such  as  a  global  int\nvariable as opposed to a large global array.\n\n\"i\" For  PE  format  files this indicates that the symbol is in a section specific to the\nimplementation of DLLs.\n\nFor ELF format files this indicates that the symbol is an indirect function.  This is\na GNU extension to the standard set of ELF symbol types.  It indicates a symbol which\nif referenced by a relocation does not evaluate to its address, but instead  must  be\ninvoked  at  runtime.  The runtime execution will then return the value to be used in\nthe relocation.\n\nNote - the actual symbols display for GNU  indirect  symbols  is  controlled  by  the\n--ifunc-chars  command  line option.  If this option has been provided then the first\ncharacter in the string will be used for global indirect function  symbols.   If  the\nstring contains a second character then that will be used for local indirect function\nsymbols.\n\n\"I\" The symbol is an indirect reference to another symbol.\n\n\"N\" The symbol is a debugging symbol.\n\n\"n\" The symbol is in a non-data, non-code, non-debug read-only section.\n\n\"p\" The symbol is in a stack unwind section.\n\n\"R\"\n\"r\" The symbol is in a read only data section.\n\n\"S\"\n\"s\" The symbol is in an uninitialized or zero-initialized data section for small objects.\n\n\"T\"\n\"t\" The symbol is in the text (code) section.\n\n\"U\" The symbol is undefined.\n\n\"u\" The symbol is a unique global symbol.  This is a GNU extension to the standard set of\nELF symbol bindings.  For such a symbol the dynamic linker will make sure that in the\nentire process there is just one symbol with this name and type in use.\n\n\"V\"\n\"v\" The  symbol  is  a  weak  object.  When a weak defined symbol is linked with a normal\ndefined symbol, the normal defined symbol  is  used  with  no  error.   When  a  weak\nundefined  symbol  is  linked  and  the  symbol is not defined, the value of the weak\nsymbol becomes zero with no error.  On  some  systems,  uppercase  indicates  that  a\ndefault value has been specified.\n\n\"W\"\n\"w\" The  symbol  is  a weak symbol that has not been specifically tagged as a weak object\nsymbol.  When a weak defined symbol is linked  with  a  normal  defined  symbol,  the\nnormal  defined symbol is used with no error.  When a weak undefined symbol is linked\nand the symbol is not defined, the value of the symbol is  determined  in  a  system-\nspecific  manner  without error.  On some systems, uppercase indicates that a default\nvalue has been specified.\n\n\"-\" The symbol is a stabs symbol in an a.out object file.  In this case, the next  values\nprinted  are  the  stabs other field, the stabs desc field, and the stab type.  Stabs\nsymbols are used to hold debugging information.\n\n\"?\" The symbol type is unknown, or object file format specific.\n\n•   The symbol name.  If a symbol has  version  information  associated  with  it,  then  the\nversion information is displayed as well.  If the versioned symbol is undefined or hidden\nfrom  linker, the version string is displayed as a suffix to the symbol name, preceded by\nan @ character.  For example foo@VER1.  If the version is the default version to be used\nwhen resolving unversioned references to the symbol, then it is  displayed  as  a  suffix\npreceded by two @ characters.  For example foo@@VER2.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "The long and short forms of options, shown here as alternatives, are equivalent.\n",
            "subsections": [
                {
                    "name": "-A",
                    "content": "",
                    "flag": "-A"
                },
                {
                    "name": "-o",
                    "content": "",
                    "flag": "-o"
                },
                {
                    "name": "--print-file-name",
                    "content": "Precede  each  symbol  by  the name of the input file (or archive member) in which it was\nfound, rather than identifying the input file once only, before all of its symbols.\n",
                    "long": "--print-file-name"
                },
                {
                    "name": "-a",
                    "content": "",
                    "flag": "-a"
                },
                {
                    "name": "--debug-syms",
                    "content": "Display all symbols, even debugger-only symbols; normally these are not listed.\n",
                    "long": "--debug-syms"
                },
                {
                    "name": "-B   --format=bsd",
                    "content": "",
                    "flag": "-B",
                    "long": "--format",
                    "arg": "bsd"
                },
                {
                    "name": "-C",
                    "content": "--demangle[=style]\nDecode (demangle) low-level symbol names into user-level  names.   Besides  removing  any\ninitial  underscore  prepended  by  the  system,  this makes C++ function names readable.\nDifferent compilers  have  different  mangling  styles.  The  optional  demangling  style\nargument can be used to choose an appropriate demangling style for your compiler.\n",
                    "flag": "-C"
                },
                {
                    "name": "--no-demangle",
                    "content": "Do not demangle low-level symbol names.  This is the default.\n",
                    "long": "--no-demangle"
                },
                {
                    "name": "--recurse-limit",
                    "content": "",
                    "long": "--recurse-limit"
                },
                {
                    "name": "--no-recurse-limit",
                    "content": "",
                    "long": "--no-recurse-limit"
                },
                {
                    "name": "--recursion-limit",
                    "content": "",
                    "long": "--recursion-limit"
                },
                {
                    "name": "--no-recursion-limit",
                    "content": "Enables  or  disables  a  limit  on  the  amount of recursion performed whilst demangling\nstrings.  Since the name mangling formats allow for an infinite level of recursion it  is\npossible  to  create  strings  whose  decoding  will  exhaust  the  amount of stack space\navailable on the host machine, triggering a memory fault.  The  limit  tries  to  prevent\nthis from happening by restricting recursion to 2048 levels of nesting.\n\nThe  default  is for this limit to be enabled, but disabling it may be necessary in order\nto demangle truly complicated names.   Note  however  that  if  the  recursion  limit  is\ndisabled  then  stack exhaustion is possible and any bug reports about such an event will\nbe rejected.\n",
                    "long": "--no-recursion-limit"
                },
                {
                    "name": "-D",
                    "content": "",
                    "flag": "-D"
                },
                {
                    "name": "--dynamic",
                    "content": "Display the dynamic symbols rather than the normal symbols.  This is only meaningful  for\ndynamic objects, such as certain types of shared libraries.\n",
                    "long": "--dynamic"
                },
                {
                    "name": "-f _",
                    "content": "--format=format\nUse the output format format, which can be \"bsd\", \"sysv\", \"posix\" or \"just-symbols\".  The\ndefault  is  \"bsd\".   Only the first character of format is significant; it can be either\nupper or lower case.\n",
                    "flag": "-f"
                },
                {
                    "name": "-g",
                    "content": "",
                    "flag": "-g"
                },
                {
                    "name": "--extern-only",
                    "content": "Display only external symbols.\n",
                    "long": "--extern-only"
                },
                {
                    "name": "-h",
                    "content": "",
                    "flag": "-h"
                },
                {
                    "name": "--help",
                    "content": "Show a summary of the options to nm and exit.\n\n--ifunc-chars=CHARS\nWhen display GNU indirect function symbols nm will default to using the \"i\" character for\nboth local indirect functions and global indirect functions.   The  --ifunc-chars  option\nallows the user to specify a string containing one or two characters. The first character\nwill  be  used for global indirect function symbols and the second character, if present,\nwill be used for local indirect function symbols.\n\nj   The same as --format=just-symbols.\n",
                    "long": "--help"
                },
                {
                    "name": "-l",
                    "content": "",
                    "flag": "-l"
                },
                {
                    "name": "--line-numbers",
                    "content": "For each symbol, use debugging information to try to find a  filename  and  line  number.\nFor  a  defined  symbol,  look  for the line number of the address of the symbol.  For an\nundefined symbol, look for the line number of a relocation  entry  which  refers  to  the\nsymbol.   If  line  number  information  can  be  found,  print it after the other symbol\ninformation.\n",
                    "long": "--line-numbers"
                },
                {
                    "name": "--inlines",
                    "content": "When option -l is active, if the address belongs to a function  that  was  inlined,  then\nthis option causes the source information for all enclosing scopes back to the first non-\ninlined  function  to be printed as well.  For example, if \"main\" inlines \"callee1\" which\ninlines \"callee2\", and address is from \"callee2\", the source  information  for  \"callee1\"\nand \"main\" will also be printed.\n",
                    "long": "--inlines"
                },
                {
                    "name": "-n",
                    "content": "",
                    "flag": "-n"
                },
                {
                    "name": "-v",
                    "content": "",
                    "flag": "-v"
                },
                {
                    "name": "--numeric-sort",
                    "content": "Sort symbols numerically by their addresses, rather than alphabetically by their names.\n",
                    "long": "--numeric-sort"
                },
                {
                    "name": "-p",
                    "content": "",
                    "flag": "-p"
                },
                {
                    "name": "--no-sort",
                    "content": "Do not bother to sort the symbols in any order; print them in the order encountered.\n",
                    "long": "--no-sort"
                },
                {
                    "name": "-P",
                    "content": "",
                    "flag": "-P"
                },
                {
                    "name": "--portability",
                    "content": "Use  the  POSIX.2 standard output format instead of the default format.  Equivalent to -f\nposix.\n",
                    "long": "--portability"
                },
                {
                    "name": "-r",
                    "content": "",
                    "flag": "-r"
                },
                {
                    "name": "--reverse-sort",
                    "content": "Reverse the order of the sort (whether numeric or alphabetic); let the last come first.\n",
                    "long": "--reverse-sort"
                },
                {
                    "name": "-S",
                    "content": "",
                    "flag": "-S"
                },
                {
                    "name": "--print-size",
                    "content": "Print both value and size of defined symbols for the \"bsd\" output style.  This option has\nno effect for object formats that do not record symbol sizes, unless --size-sort is  also\nused in which case a calculated size is displayed.\n",
                    "long": "--print-size"
                },
                {
                    "name": "-s",
                    "content": "",
                    "flag": "-s"
                },
                {
                    "name": "--print-armap",
                    "content": "When  listing  symbols  from archive members, include the index: a mapping (stored in the\narchive by ar or ranlib) of which modules contain definitions for which names.\n",
                    "long": "--print-armap"
                },
                {
                    "name": "-t _",
                    "content": "--radix=radix\nUse radix as the radix for printing the symbol values.  It must be d for decimal,  o  for\noctal, or x for hexadecimal.\n",
                    "flag": "-t"
                },
                {
                    "name": "-u",
                    "content": "",
                    "flag": "-u"
                },
                {
                    "name": "--undefined-only",
                    "content": "Display  only  undefined  symbols  (those external to each object file).  By default both\ndefined and undefined symbols are displayed.\n",
                    "long": "--undefined-only"
                },
                {
                    "name": "-U",
                    "content": "",
                    "flag": "-U"
                },
                {
                    "name": "--defined-only",
                    "content": "Display only defined symbols for each object file.  By default both defined and undefined\nsymbols are displayed.\n",
                    "long": "--defined-only"
                },
                {
                    "name": "-V",
                    "content": "",
                    "flag": "-V"
                },
                {
                    "name": "--version",
                    "content": "Show the version number of nm and exit.\n",
                    "long": "--version"
                },
                {
                    "name": "-X",
                    "content": "parameter  which  must be the string 3264.  The default mode of AIX nm corresponds to -X\n32, which is not supported by GNU nm.\n\n--plugin name\nLoad the plugin called name to add support for extra target types.  This option  is  only\navailable if the toolchain has been built with plugin support enabled.\n\nIf  --plugin  is  not provided, but plugin support has been enabled then nm iterates over\nthe files in ${libdir}/bfd-plugins in alphabetic order and the first plugin  that  claims\nthe object in question is used.\n\nPlease note that this plugin search directory is not the one used by ld's -plugin option.\nIn   order   to   make   nm   use   the   linker  plugin  it  must  be  copied  into  the\n${libdir}/bfd-plugins directory.  For GCC based compilations the linker plugin is  called\nlibltoplugin.so.0.0.0.   For Clang based compilations it is called LLVMgold.so.  The GCC\nplugin is always backwards compatible with earlier versions, so it is sufficient to  just\ncopy the newest one.\n",
                    "flag": "-X"
                },
                {
                    "name": "--size-sort",
                    "content": "Sort  symbols  by  size.   For  ELF objects symbol sizes are read from the ELF, for other\nobject types the symbol sizes are computed as the difference between  the  value  of  the\nsymbol  and  the  value  of  the  symbol with the next higher value.  If the \"bsd\" output\nformat is used the size of the symbol is printed, rather than the value, and -S  must  be\nused in order both size and value to be printed.\n\nNote  -  this  option  does  not  work  if --undefined-only has been enabled as undefined\nsymbols have no size.\n",
                    "long": "--size-sort"
                },
                {
                    "name": "--special-syms",
                    "content": "Display symbols which have a target-specific special meaning.  These symbols are  usually\nused by the target for some special processing and are not normally helpful when included\nin  the  normal  symbol  lists.   For  example for ARM targets this option would skip the\nmapping symbols used to mark transitions between ARM code, THUMB code and data.\n",
                    "long": "--special-syms"
                },
                {
                    "name": "--synthetic",
                    "content": "Include synthetic symbols in the output.  These are special symbols created by the linker\nfor various purposes.  They are not shown by default since  they  are  not  part  of  the\nbinary's original source code.\n\n--unicode=[default|invalid|locale|escape|hex|highlight]\nControls  the  display  of  UTF-8  encoded  multibyte characters in strings.  The default\n(--unicode=default) is to give them no special treatment.   The  --unicode=locale  option\ndisplays  the  sequence  in  the  current locale, which may or may not support them.  The\noptions --unicode=hex and --unicode=invalid display them as hex byte  sequences  enclosed\nby either angle brackets or curly braces.\n\nThe   --unicode=escape  option  displays  them  as  escape  sequences  (\\uxxxx)  and  the\n--unicode=highlight option displays them as  escape  sequences  highlighted  in  red  (if\nsupported  by  the  output  device).   The colouring is intended to draw attention to the\npresence of unicode sequences where they might not be expected.\n",
                    "long": "--synthetic"
                },
                {
                    "name": "-W",
                    "content": "",
                    "flag": "-W"
                },
                {
                    "name": "--no-weak",
                    "content": "Do not display weak symbols.\n",
                    "long": "--no-weak"
                },
                {
                    "name": "--with-symbol-versions",
                    "content": "",
                    "long": "--with-symbol-versions"
                },
                {
                    "name": "--without-symbol-versions",
                    "content": "Enables or disables the display of symbol version information.   The  version  string  is\ndisplayed  as  a  suffix  to  the  symbol  name, preceded by an @ character.  For example\nfoo@VER1.  If the version is the default version to be used when  resolving  unversioned\nreferences  to  the symbol then it is displayed as a suffix preceded by two @ characters.\nFor example foo@@VER2.  By default, symbol version information is displayed.\n\n--target=bfdname\nSpecify an object code format other than your system's default format.\n\n@file\nRead command-line options from file.  The options read  are  inserted  in  place  of  the\noriginal  @file  option.  If file does not exist, or cannot be read, then the option will\nbe treated literally, and not removed.\n\nOptions in file are separated by whitespace.  A whitespace character may be  included  in\nan  option  by  surrounding  the  entire  option  in either single or double quotes.  Any\ncharacter (including a backslash) may be  included  by  prefixing  the  character  to  be\nincluded  with  a  backslash.   The file may itself contain additional @file options; any\nsuch options will be processed recursively.\n",
                    "long": "--without-symbol-versions"
                }
            ]
        },
        "SEE ALSO": {
            "content": "ar(1), objdump(1), ranlib(1), and the Info entries for binutils.\n",
            "subsections": []
        },
        "COPYRIGHT": {
            "content": "Copyright (c) 1991-2024 Free Software Foundation, Inc.\n\nPermission is granted to copy, distribute and/or modify this document under the terms of  the\nGNU  Free  Documentation  License,  Version  1.3  or  any later version published by the Free\nSoftware Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-\nCover Texts.  A  copy  of  the  license  is  included  in  the  section  entitled  \"GNU  Free\nDocumentation License\".\n\nbinutils-2.42                                2026-02-09                                        NM(1)",
            "subsections": []
        }
    },
    "summary": "nm - list symbols from object files",
    "flags": [
        {
            "flag": "-A",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-o",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--print-file-name",
            "arg": null,
            "description": "Precede each symbol by the name of the input file (or archive member) in which it was found, rather than identifying the input file once only, before all of its symbols."
        },
        {
            "flag": "-a",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--debug-syms",
            "arg": null,
            "description": "Display all symbols, even debugger-only symbols; normally these are not listed."
        },
        {
            "flag": "-B",
            "long": "--format",
            "arg": "bsd",
            "description": ""
        },
        {
            "flag": "-C",
            "long": null,
            "arg": null,
            "description": "--demangle[=style] Decode (demangle) low-level symbol names into user-level names. Besides removing any initial underscore prepended by the system, this makes C++ function names readable. Different compilers have different mangling styles. The optional demangling style argument can be used to choose an appropriate demangling style for your compiler."
        },
        {
            "flag": "",
            "long": "--no-demangle",
            "arg": null,
            "description": "Do not demangle low-level symbol names. This is the default."
        },
        {
            "flag": "",
            "long": "--recurse-limit",
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--no-recurse-limit",
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--recursion-limit",
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--no-recursion-limit",
            "arg": null,
            "description": "Enables or disables a limit on the amount of recursion performed whilst demangling strings. Since the name mangling formats allow for an infinite level of recursion it is possible to create strings whose decoding will exhaust the amount of stack space available on the host machine, triggering a memory fault. The limit tries to prevent this from happening by restricting recursion to 2048 levels of nesting. The default is for this limit to be enabled, but disabling it may be necessary in order to demangle truly complicated names. Note however that if the recursion limit is disabled then stack exhaustion is possible and any bug reports about such an event will be rejected."
        },
        {
            "flag": "-D",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--dynamic",
            "arg": null,
            "description": "Display the dynamic symbols rather than the normal symbols. This is only meaningful for dynamic objects, such as certain types of shared libraries."
        },
        {
            "flag": "-f",
            "long": null,
            "arg": null,
            "description": "--format=format Use the output format format, which can be \"bsd\", \"sysv\", \"posix\" or \"just-symbols\". The default is \"bsd\". Only the first character of format is significant; it can be either upper or lower case."
        },
        {
            "flag": "-g",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--extern-only",
            "arg": null,
            "description": "Display only external symbols."
        },
        {
            "flag": "-h",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--help",
            "arg": null,
            "description": "Show a summary of the options to nm and exit. --ifunc-chars=CHARS When display GNU indirect function symbols nm will default to using the \"i\" character for both local indirect functions and global indirect functions. The --ifunc-chars option allows the user to specify a string containing one or two characters. The first character will be used for global indirect function symbols and the second character, if present, will be used for local indirect function symbols. j The same as --format=just-symbols."
        },
        {
            "flag": "-l",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--line-numbers",
            "arg": null,
            "description": "For each symbol, use debugging information to try to find a filename and line number. For a defined symbol, look for the line number of the address of the symbol. For an undefined symbol, look for the line number of a relocation entry which refers to the symbol. If line number information can be found, print it after the other symbol information."
        },
        {
            "flag": "",
            "long": "--inlines",
            "arg": null,
            "description": "When option -l is active, if the address belongs to a function that was inlined, then this option causes the source information for all enclosing scopes back to the first non- inlined function to be printed as well. For example, if \"main\" inlines \"callee1\" which inlines \"callee2\", and address is from \"callee2\", the source information for \"callee1\" and \"main\" will also be printed."
        },
        {
            "flag": "-n",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-v",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--numeric-sort",
            "arg": null,
            "description": "Sort symbols numerically by their addresses, rather than alphabetically by their names."
        },
        {
            "flag": "-p",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--no-sort",
            "arg": null,
            "description": "Do not bother to sort the symbols in any order; print them in the order encountered."
        },
        {
            "flag": "-P",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--portability",
            "arg": null,
            "description": "Use the POSIX.2 standard output format instead of the default format. Equivalent to -f posix."
        },
        {
            "flag": "-r",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--reverse-sort",
            "arg": null,
            "description": "Reverse the order of the sort (whether numeric or alphabetic); let the last come first."
        },
        {
            "flag": "-S",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--print-size",
            "arg": null,
            "description": "Print both value and size of defined symbols for the \"bsd\" output style. This option has no effect for object formats that do not record symbol sizes, unless --size-sort is also used in which case a calculated size is displayed."
        },
        {
            "flag": "-s",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--print-armap",
            "arg": null,
            "description": "When listing symbols from archive members, include the index: a mapping (stored in the archive by ar or ranlib) of which modules contain definitions for which names."
        },
        {
            "flag": "-t",
            "long": null,
            "arg": null,
            "description": "--radix=radix Use radix as the radix for printing the symbol values. It must be d for decimal, o for octal, or x for hexadecimal."
        },
        {
            "flag": "-u",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--undefined-only",
            "arg": null,
            "description": "Display only undefined symbols (those external to each object file). By default both defined and undefined symbols are displayed."
        },
        {
            "flag": "-U",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--defined-only",
            "arg": null,
            "description": "Display only defined symbols for each object file. By default both defined and undefined symbols are displayed."
        },
        {
            "flag": "-V",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--version",
            "arg": null,
            "description": "Show the version number of nm and exit."
        },
        {
            "flag": "-X",
            "long": null,
            "arg": null,
            "description": "parameter which must be the string 3264. The default mode of AIX nm corresponds to -X 32, which is not supported by GNU nm. --plugin name Load the plugin called name to add support for extra target types. This option is only available if the toolchain has been built with plugin support enabled. If --plugin is not provided, but plugin support has been enabled then nm iterates over the files in ${libdir}/bfd-plugins in alphabetic order and the first plugin that claims the object in question is used. Please note that this plugin search directory is not the one used by ld's -plugin option. In order to make nm use the linker plugin it must be copied into the ${libdir}/bfd-plugins directory. For GCC based compilations the linker plugin is called libltoplugin.so.0.0.0. For Clang based compilations it is called LLVMgold.so. The GCC plugin is always backwards compatible with earlier versions, so it is sufficient to just copy the newest one."
        },
        {
            "flag": "",
            "long": "--size-sort",
            "arg": null,
            "description": "Sort symbols by size. For ELF objects symbol sizes are read from the ELF, for other object types the symbol sizes are computed as the difference between the value of the symbol and the value of the symbol with the next higher value. If the \"bsd\" output format is used the size of the symbol is printed, rather than the value, and -S must be used in order both size and value to be printed. Note - this option does not work if --undefined-only has been enabled as undefined symbols have no size."
        },
        {
            "flag": "",
            "long": "--special-syms",
            "arg": null,
            "description": "Display symbols which have a target-specific special meaning. These symbols are usually used by the target for some special processing and are not normally helpful when included in the normal symbol lists. For example for ARM targets this option would skip the mapping symbols used to mark transitions between ARM code, THUMB code and data."
        },
        {
            "flag": "",
            "long": "--synthetic",
            "arg": null,
            "description": "Include synthetic symbols in the output. These are special symbols created by the linker for various purposes. They are not shown by default since they are not part of the binary's original source code. --unicode=[default|invalid|locale|escape|hex|highlight] Controls the display of UTF-8 encoded multibyte characters in strings. The default (--unicode=default) is to give them no special treatment. The --unicode=locale option displays the sequence in the current locale, which may or may not support them. The options --unicode=hex and --unicode=invalid display them as hex byte sequences enclosed by either angle brackets or curly braces. The --unicode=escape option displays them as escape sequences (\\uxxxx) and the --unicode=highlight option displays them as escape sequences highlighted in red (if supported by the output device). The colouring is intended to draw attention to the presence of unicode sequences where they might not be expected."
        },
        {
            "flag": "-W",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--no-weak",
            "arg": null,
            "description": "Do not display weak symbols."
        },
        {
            "flag": "",
            "long": "--with-symbol-versions",
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": "--without-symbol-versions",
            "arg": null,
            "description": "Enables or disables the display of symbol version information. The version string is displayed as a suffix to the symbol name, preceded by an @ character. For example foo@VER1. If the version is the default version to be used when resolving unversioned references to the symbol then it is displayed as a suffix preceded by two @ characters. For example foo@@VER2. By default, symbol version information is displayed. --target=bfdname Specify an object code format other than your system's default format. @file Read command-line options from file. The options read are inserted in place of the original @file option. If file does not exist, or cannot be read, then the option will be treated literally, and not removed. Options in file are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The file may itself contain additional @file options; any such options will be processed recursively."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "ar",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/ar/1/json"
        },
        {
            "name": "objdump",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/objdump/1/json"
        },
        {
            "name": "ranlib",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/ranlib/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "List symbol names in object files.",
        "examples": [
            {
                "description": "List global (extern) functions in a file (prefixed with T)",
                "command": "nm {{-g|--extern-only}} {{path/to/file.o}}"
            },
            {
                "description": "List only undefined symbols in a file",
                "command": "nm {{-u|--undefined-only}} {{path/to/file.o}}"
            },
            {
                "description": "List all symbols, even debugging symbols",
                "command": "nm {{-a|--debug-syms}} {{path/to/file.o}}"
            },
            {
                "description": "Demangle C++ symbols (make them readable)",
                "command": "nm {{-C|--demangle}} {{path/to/file.o}}"
            }
        ]
    }
}