.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "LM32-ELF-NM 1"
.TH LM32-ELF-NM 1 2026-01-23 binutils-2.45.1 "ابزارهای توسعه گنو (GNU Development Tools)"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
lm32-elf-nm \- فهرست‌بندی نمادها از فایل‌های شیء معماری LatticeMico32
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\fBlm32\-elf\-nm\fR [\fB\-A\fR|\fB\-o\fR|\fB\-\-print\-file\-name\fR]
   [\fB\-a\fR|\fB\-\-debug\-syms\fR]
   [\fB\-B\fR|\fB\-\-format=bsd\fR]
   [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR]]
   [\fB\-D\fR|\fB\-\-dynamic\fR]
   [\fB\-f\fR\fIformat\fR|\fB\-\-format=\fR\fIformat\fR]
   [\fB\-g\fR|\fB\-\-extern\-only\fR]
   [\fB\-h\fR|\fB\-\-help\fR]
   [\fB\-\-ifunc\-chars=\fR\fICHARS\fR]
   [\fB\-j\fR|\fB\-\-format=just\-symbols\fR]
   [\fB\-l\fR|\fB\-\-line\-numbers\fR] [\fB\-\-inlines\fR]
   [\fB\-n\fR|\fB\-v\fR|\fB\-\-numeric\-sort\fR]
   [\fB\-P\fR|\fB\-\-portability\fR]
   [\fB\-p\fR|\fB\-\-no\-sort\fR]
   [\fB\-r\fR|\fB\-\-reverse\-sort\fR]
   [\fB\-S\fR|\fB\-\-print\-size\fR]
   [\fB\-s\fR|\fB\-\-print\-armap\fR]
   [\fB\-t\fR \fIradix\fR|\fB\-\-radix=\fR\fIradix\fR]
   [\fB\-u\fR|\fB\-\-undefined\-only\fR]
   [\fB\-U\fR|\fB\-\-defined\-only\fR]
   [\fB\-V\fR|\fB\-\-version\fR]
   [\fB\-W\fR|\fB\-\-no\-weak\fR]
   [\fB\-X 32_64\fR]
   [\fB\-\-no\-demangle\fR]
   [\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]]
   [\fB\-\-plugin\fR \fIname\fR]
   [\fB\-\-size\-sort\fR]
   [\fB\-\-special\-syms\fR]
   [\fB\-\-synthetic\fR]
   [\fB\-\-target=\fR\fIbfdname\fR]
   [\fB\-\-unicode=\fR\fImethod\fR]
   [\fB\-\-with\-symbol\-versions\fR]
   [\fB\-\-without\-symbol\-versions\fR]
   [\fIobjfile\fR...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار گنو \fBnm\fR نمادهای موجود در فایل‌های شیء (\fIobjfile\fR...) را فهرست می‌کند.
اگر هیچ فایل شیئی به عنوان آرگومان مشخص نشود، \fBnm\fR فایل پیش‌فرض
\&\fIa.out\fR را در نظر می‌گیرد.
.PP
برای هر نماد، \fBnm\fR موارد زیر را نمایش می‌دهد:
.IP \(bu 4
مقدار نماد، در مبنای عددی تعیین‌شده توسط گزینه‌ها (پایین را ببینید)، یا به‌طور پیش‌فرض در مبنای شانزده (هگزادسیمال).
.IP \(bu 4
نوع نماد. حداقل انواع زیر استفاده می‌شوند؛ بسته به فرمت فایل شیء، انواع دیگری نیز ممکن است به کار روند.
اگر حرف کوچک باشد، نماد معمولاً محلی (local) است؛ اگر حرف بزرگ باشد، نماد سراسری یا خارجی (global/external) است.
با این حال، چند نماد با حروف کوچک برای نمادهای خاص سراسری نمایش داده می‌شوند (\f(CW\*(C`u\*(C'\fR، \f(CW\*(C`v\*(C'\fR و \f(CW\*(C`w\*(C'\fR).
.RS 4
.ie n .IP """A""" 4
.el .IP \f(CWA\fR 4
.IX Item "A"
مقدار نماد مطلق (absolute) است و با پیوند دادن (link) بیشتر تغییر نخواهد کرد.
.ie n .IP """B""" 4
.el .IP \f(CWB\fR 4
.IX Item "B"
.PD 0
.ie n .IP """b""" 4
.el .IP \f(CWb\fR 4
.IX Item "b"
.PD
نماد در بخش داده‌ای BSS قرار دارد. این بخش معمولاً حاوی داده‌های مقداردهی‌نشده یا مقداردهی‌شده با صفر است، هرچند رفتار دقیق آن به سیستم بستگی دارد.
.ie n .IP """C""" 4
.el .IP \f(CWC\fR 4
.IX Item "C"
.PD 0
.ie n .IP """c""" 4
.el .IP \f(CWc\fR 4
.IX Item "c"
.PD
نماد از نوع مشترک (common) است. نمادهای مشترک داده‌های مقداردهی‌نشده هستند. هنگام پیوند دادن، ممکن است چندین نماد مشترک با یک نام ظاهر شوند. اگر نماد در جایی تعریف شده باشد، نمادهای مشترک به عنوان ارجاعات تعریف‌نشده در نظر گرفته می‌شوند.
حرف کوچک \fIc\fR زمانی استفاده می‌شود که نماد در یک بخش ویژه برای داده‌های مشترک کوچک قرار داشته باشد.
.ie n .IP """D""" 4
.el .IP \f(CWD\fR 4
.IX Item "D"
.PD 0
.ie n .IP """d""" 4
.el .IP \f(CWd\fR 4
.IX Item "d"
.PD
نماد در بخش داده‌های مقداردهی‌شده (initialized data) قرار دارد.
.ie n .IP """G""" 4
.el .IP \f(CWG\fR 4
.IX Item "G"
.PD 0
.ie n .IP """g""" 4
.el .IP \f(CWg\fR 4
.IX Item "g"
.PD
نماد در بخش داده‌های مقداردهی‌شده برای اشیاء کوچک قرار دارد. برخی فرمت‌های فایل شیء دسترسی کارآمدتری به اشیاء داده‌ای کوچک فراهم می‌کنند، مانند یک متغیر int سراسری در مقایسه با یک آرایه سراسری بزرگ.
.ie n .IP """i""" 4
.el .IP \f(CWi\fR 4
.IX Item "i"
برای فایل‌های فرمت PE نشان می‌دهد که نماد در بخشی مخصوص پیاده‌سازی DLLها قرار دارد.
.Sp
برای فایل‌های فرمت ELF نشان می‌دهد که نماد یک تابع غیرمستقیم (indirect function یا ifunc) است. این یک افزونه گنو برای مجموعه استاندارد انواع نمادهای ELF است. این نماد نشان می‌دهد که در صورت ارجاع توسط بازآرایی (relocation)، مستقیماً به آدرس آن ارزیابی نمی‌شود، بلکه باید در زمان اجرا فراخوانی گردد. سپس اجرای زمان اجرا مقداری را که باید در بازآرایی استفاده شود برمی‌گرداند.
.Sp
نکته \- نویسه نمایشی واقعی برای نمادهای غیرمستقیم گنو توسط گزینه خط فرمان \fB\-\-ifunc\-chars\fR کنترل می‌شود. اگر این گزینه ارائه شده باشد، اولین نویسه در رشته برای نمادهای تابع غیرمستقیم سراسری استفاده می‌شود. اگر رشته حاوی نویسه دومی باشد، برای نمادهای تابع غیرمستقیم محلی استفاده خواهد شد.
.ie n .IP """I""" 4
.el .IP \f(CWI\fR 4
.IX Item "I"
نماد یک ارجاع غیرمستقیم به نمادی دیگر است.
.ie n .IP """N""" 4
.el .IP \f(CWN\fR 4
.IX Item "N"
نماد یک نماد دیباگ (اشکال‌زدایی) است.
.ie n .IP """n""" 4
.el .IP \f(CWn\fR 4
.IX Item "n"
نماد در یک بخش فقط‌خواندنی غیر داده‌ای، غیر کدی و غیر دیباگ قرار دارد.
.ie n .IP """p""" 4
.el .IP \f(CWp\fR 4
.IX Item "p"
نماد در یک بخش بازکردن پشته (stack unwind) قرار دارد.
.ie n .IP """R""" 4
.el .IP \f(CWR\fR 4
.IX Item "R"
.PD 0
.ie n .IP """r""" 4
.el .IP \f(CWr\fR 4
.IX Item "r"
.PD
نماد در یک بخش داده‌ای فقط‌خواندنی (read-only data) قرار دارد.
.ie n .IP """S""" 4
.el .IP \f(CWS\fR 4
.IX Item "S"
.PD 0
.ie n .IP """s""" 4
.el .IP \f(CWs\fR 4
.IX Item "s"
.PD
نماد در یک بخش داده‌ای مقداردهی‌نشده یا مقداردهی‌شده با صفر برای اشیاء کوچک قرار دارد.
.ie n .IP """T""" 4
.el .IP \f(CWT\fR 4
.IX Item "T"
.PD 0
.ie n .IP """t""" 4
.el .IP \f(CWt\fR 4
.IX Item "t"
.PD
نماد در بخش متن یا کد (text/code) قرار دارد.
.ie n .IP """U""" 4
.el .IP \f(CWU\fR 4
.IX Item "U"
نماد تعریف‌نشده (undefined) است.
.ie n .IP """u""" 4
.el .IP \f(CWu\fR 4
.IX Item "u"
نماد یک نماد سراسری یکتا (unique global symbol) است. این یک افزونه گنو برای مجموعه استاندارد اتصالات نماد ELF است. برای چنین نمادی، پیونددهنده پویا (dynamic linker) اطمینان حاصل می‌کند که در کل فرآیند تنها یک نماد با این نام و نوع در حال استفاده است.
.ie n .IP """V""" 4
.el .IP \f(CWV\fR 4
.IX Item "V"
.PD 0
.ie n .IP """v""" 4
.el .IP \f(CWv\fR 4
.IX Item "v"
.PD
نماد یک شیء ضعیف (weak object) است. هنگامی که یک نماد تعریف‌شده ضعیف با یک نماد تعریف‌شده معمولی پیوند می‌خورد، نماد تعریف‌شده معمولی بدون خطا استفاده می‌شود. هنگامی که یک نماد تعریف‌نشده ضعیف پیوند می‌خورد و نماد تعریف نشده باشد، مقدار نماد ضعیف بدون خطا برابر صفر می‌شود. در برخی سیستم‌ها، حروف بزرگ نشان می‌دهد که یک مقدار پیش‌فرض مشخص شده است.
.ie n .IP """W""" 4
.el .IP \f(CWW\fR 4
.IX Item "W"
.PD 0
.ie n .IP """w""" 4
.el .IP \f(CWw\fR 4
.IX Item "w"
.PD
نماد یک نماد ضعیف (weak symbol) است که به‌طور خاص به عنوان شیء ضعیف برچسب‌گذاری نشده است. هنگامی که یک نماد تعریف‌شده ضعیف با یک نماد تعریف‌شده معمولی پیوند می‌خورد، نماد تعریف‌شده معمولی بدون خطا استفاده می‌شود. هنگامی که یک نماد تعریف‌نشده ضعیف پیوند می‌خورد و نماد تعریف نشده باشد، مقدار نماد به روشی وابسته به سیستم و بدون خطا تعیین می‌شود. در برخی سیستم‌ها، حروف بزرگ نشان می‌دهد که یک مقدار پیش‌فرض مشخص شده است.
.ie n .IP """\-""" 4
.el .IP \f(CW\-\fR 4
.IX Item "-"
نماد یک نماد stabs در یک فایل شیء a.out است. در این حالت، مقادیر بعدی چاپ‌شده عبارتند از فیلد stabs other، فیلد stabs desc و نوع stab. نمادهای stabs برای نگهداری اطلاعات اشکال‌زدایی استفاده می‌شوند.
.ie n .IP """?""" 4
.el .IP \f(CW?\fR 4
.IX Item "?"
نوع نماد ناشناخته است، یا مختص فرمت فایل شیء است.
.RE
.RS 4
.RE
.IP \(bu 4
نام نماد. اگر نماد دارای اطلاعات نسخه مرتبط باشد، اطلاعات نسخه نیز نمایش داده می‌شود.
اگر نماد نسخه‌دار تعریف‌نشده یا از پیونددهنده مخفی باشد، رشته نسخه به عنوان پسوند نام نماد و پس از یک نویسه @ نمایش داده می‌شود؛ مانند
\&\fBfoo@VER_1\fR.
اگر نسخه، نسخه پیش‌فرضی باشد که هنگام حل ارجاعات بدون نسخه به نماد استفاده می‌شود، به عنوان پسوند پس از دو نویسه @ نمایش داده می‌شود؛ مانند
\&\fBfoo@@VER_2\fR.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
فرم‌های کوتاه و بلند گزینه‌ها که در اینجا به عنوان جایگزین نشان داده شده‌اند، معادل یکدیگر هستند.
.IP \fB\-A\fR 4
.IX Item "-A"
.PD 0
.IP \fB\-o\fR 4
.IX Item "-o"
.IP \fB\-\-print\-file\-name\fR 4
.IX Item "--print-file-name"
.PD
قبل از هر نماد، نام فایل ورودی (یا عضو آرشیو) را که در آن یافت شده است درج می‌کند، به جای اینکه فایل ورودی را فقط یک‌بار قبل از تمام نمادهایش مشخص کند.
.IP \fB\-a\fR 4
.IX Item "-a"
.PD 0
.IP \fB\-\-debug\-syms\fR 4
.IX Item "--debug-syms"
.PD
تمام نمادها، حتی نمادهای مخصوص دیباگر را نمایش می‌دهد؛ این نمادها معمولاً فهرست نمی‌شوند.
.IP \fB\-B\fR 4
.IX Item "-B"
معادل \fB\-\-format=bsd\fR است (جهت سازگاری با \fBnm\fR در سیستم‌های MIPS).
.IP \fB\-C\fR 4
.IX Item "-C"
.PD 0
.IP \fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR 4
.IX Item "--demangle[=style]"
.PD
رمزگشایی (\fIdemangle\fR) نام نمادهای سطح پایین به نام‌های سطح کاربر.
علاوه بر حذف هرگونه زیرخط ابتدایی اضافه‌شده توسط سیستم، این کار نام توابع ++C را خوانا می‌کند. کامپایلرهای مختلف سبک‌های نام‌گذاری متفاوتی دارند. آرگومان اختیاری سبک رمزگشایی می‌تواند برای انتخاب سبک مناسب برای کامپایلر شما استفاده شود.
.IP \fB\-\-no\-demangle\fR 4
.IX Item "--no-demangle"
نام نمادهای سطح پایین را رمزگشایی نمی‌کند. این حالت پیش‌فرض است.
.IP \fB\-\-recurse\-limit\fR 4
.IX Item "--recurse-limit"
.PD 0
.IP \fB\-\-no\-recurse\-limit\fR 4
.IX Item "--no-recurse-limit"
.IP \fB\-\-recursion\-limit\fR 4
.IX Item "--recursion-limit"
.IP \fB\-\-no\-recursion\-limit\fR 4
.IX Item "--no-recursion-limit"
.PD
محدودیت عمق بازگشت در حین رمزگشایی رشته‌ها را فعال یا غیرفعال می‌کند. از آنجا که فرمت‌های نام‌گذاری امکان بازگشت نامحدود را فراهم می‌کنند، ممکن است رشته‌هایی ایجاد شوند که رمزگشایی آن‌ها تمام فضای پشته موجود در ماشین میزبان را مصرف کرده و باعث خطای حافظه (memory fault) شود. این محدودیت با محدود کردن بازگشت به ۲۰۴۸ سطح تودرتو، سعی می‌کند از این اتفاق جلوگیری کند.
.Sp
حالت پیش‌فرض فعال بودن این محدودیت است، اما برای رمزگشایی نام‌های بسیار پیچیده ممکن است غیرفعال کردن آن لازم باشد. با این حال توجه داشته باشید که در صورت غیرفعال کردن محدودیت بازگشت، اتمام فضای پشته ممکن است و هرگونه گزارش باگ درباره چنین رخدادی رد خواهد شد.
.IP \fB\-D\fR 4
.IX Item "-D"
.PD 0
.IP \fB\-\-dynamic\fR 4
.IX Item "--dynamic"
.PD
نمادهای پویا (dynamic) را به جای نمادهای معمولی نمایش می‌دهد. این گزینه تنها برای اشیاء پویا، مانند انواع خاصی از کتابخانه‌های مشترک (shared libraries) معنی دارد.
.IP "\fB\-f\fR \fIformat\fR" 4
.IX Item "-f format"
.PD 0
.IP \fB\-\-format=\fR\fIformat\fR 4
.IX Item "--format=format"
.PD
استفاده از فرمت خروجی \fIformat\fR، که می‌تواند \f(CW\*(C`bsd\*(C'\fR،
\&\f(CW\*(C`sysv\*(C'\fR، \f(CW\*(C`posix\*(C'\fR یا \f(CW\*(C`just\-symbols\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`bsd\*(C'\fR است.
تنها نویسه اول \fIformat\fR مهم است؛ می‌تواند با حروف بزرگ یا کوچک باشد.
.IP \fB\-g\fR 4
.IX Item "-g"
.PD 0
.IP \fB\-\-extern\-only\fR 4
.IX Item "--extern-only"
.PD
فقط نمادهای خارجی (external) را نمایش می‌دهد.
.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD
خلاصه‌ای از گزینه‌های \fBnm\fR را نمایش داده و خارج می‌شود.
.IP \fB\-\-ifunc\-chars=\fR\fICHARS\fR 4
.IX Item "--ifunc-chars=CHARS"
هنگام نمایش نمادهای تابع غیرمستقیم گنو، \fBnm\fR به‌طور پیش‌فرض از نویسه \f(CW\*(C`i\*(C'\fR هم برای توابع غیرمستقیم محلی و هم سراسری استفاده می‌کند. گزینه \fB\-\-ifunc\-chars\fR به کاربر امکان می‌دهد رشته‌ای شامل یک یا دو نویسه را مشخص کند. اولین نویسه برای نمادهای تابع غیرمستقیم سراسری و نویسه دوم، در صورت وجود، برای نمادهای تابع غیرمستقیم محلی استفاده خواهد شد.
.IP \fBj\fR 4
.IX Item "j"
معادل \fB\-\-format=just\-symbols\fR است.
.IP \fB\-l\fR 4
.IX Item "-l"
.PD 0
.IP \fB\-\-line\-numbers\fR 4
.IX Item "--line-numbers"
.PD
برای هر نماد، با استفاده از اطلاعات اشکال‌زدایی تلاش می‌کند نام فایل و شماره خط را بیابد. برای یک نماد تعریف‌شده، به دنبال شماره خط آدرس نماد می‌گردد. برای یک نماد تعریف‌نشده، به دنبال شماره خط مدخل بازآرایی که به نماد ارجاع می‌دهد می‌گردد. اگر اطلاعات شماره خط یافت شود، پس از سایر اطلاعات نماد چاپ می‌شود.
.IP \fB\-\-inlines\fR 4
.IX Item "--inlines"
هنگامی که گزینه \fB\-l\fR فعال باشد، اگر آدرس متعلق به تابعی باشد که درون‌خطی (inlined) شده است، این گزینه باعث می‌شود اطلاعات منبع برای تمام دامنه‌های دربرگیرنده تا اولین تابع غیر درون‌خطی نیز چاپ شود. برای مثال، اگر \f(CW\*(C`main\*(C'\fR تابع \f(CW\*(C`callee1\*(C'\fR را درون‌خطی کرده باشد و آن هم \f(CW\*(C`callee2\*(C'\fR را درون‌خطی کرده باشد و آدرس از \f(CW\*(C`callee2\*(C'\fR باشد، اطلاعات منبع برای \f(CW\*(C`callee1\*(C'\fR و \f(CW\*(C`main\*(C'\fR نیز چاپ خواهد شد.
.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
.IP \fB\-v\fR 4
.IX Item "-v"
.IP \fB\-\-numeric\-sort\fR 4
.IX Item "--numeric-sort"
.PD
مرتب‌سازی عددی نمادها بر اساس آدرس آن‌ها، به جای مرتب‌سازی الفبایی بر اساس نام.
.IP \fB\-p\fR 4
.IX Item "-p"
.PD 0
.IP \fB\-\-no\-sort\fR 4
.IX Item "--no-sort"
.PD
نمادها را به هیچ ترتیبی مرتب نمی‌کند؛ آن‌ها را به همان ترتیبی که خوانده شده‌اند چاپ می‌کند.
.IP \fB\-P\fR 4
.IX Item "-P"
.PD 0
.IP \fB\-\-portability\fR 4
.IX Item "--portability"
.PD
استفاده از فرمت خروجی استاندارد POSIX.2 به جای فرمت پیش‌فرض. معادل \fB\-f posix\fR است.
.IP \fB\-r\fR 4
.IX Item "-r"
.PD 0
.IP \fB\-\-reverse\-sort\fR 4
.IX Item "--reverse-sort"
.PD
معکوس کردن ترتیب مرتب‌سازی (عددی یا الفبایی)؛ نمادهای انتهایی در ابتدا می‌آیند.
.IP \fB\-S\fR 4
.IX Item "-S"
.PD 0
.IP \fB\-\-print\-size\fR 4
.IX Item "--print-size"
.PD
چاپ مقدار و اندازه نمادهای تعریف‌شده برای سبک خروجی \f(CW\*(C`bsd\*(C'\fR. این گزینه برای فرمت‌های شیئی که اندازه نماد را ثبت نمی‌کنند تأثیری ندارد، مگر اینکه \fB\-\-size\-sort\fR نیز استفاده شده باشد که در آن صورت یک اندازه محاسبه‌شده نمایش داده می‌شود.
.IP \fB\-s\fR 4
.IX Item "-s"
.PD 0
.IP \fB\-\-print\-armap\fR 4
.IX Item "--print-armap"
.PD
هنگام فهرست کردن نمادهای اعضای آرشیو، ایندکس را نیز شامل می‌کند: نقشه‌ای (ذخیره‌شده در آرشیو توسط \fBar\fR یا \fBranlib\fR) از اینکه کدام ماژول‌ها حاوی تعاریف برای کدام نام‌ها هستند.
.IP "\fB\-t\fR \fIradix\fR" 4
.IX Item "-t radix"
.PD 0
.IP \fB\-\-radix=\fR\fIradix\fR 4
.IX Item "--radix=radix"
.PD
استفاده از \fIradix\fR به عنوان مبنای عددی برای چاپ مقادیر نمادها. باید \fBd\fR برای ده‌دهی (decimal)، \fBo\fR برای هشت‌هشتی (octal)، یا \fBx\fR برای شانزده‌شانزدهی (hexadecimal) باشد.
.IP \fB\-u\fR 4
.IX Item "-u"
.PD 0
.IP \fB\-\-undefined\-only\fR 4
.IX Item "--undefined-only"
.PD
فقط نمایش نمادهای تعریف‌نشده (نمادهایی که خارج از هر فایل شیء هستند). به‌طور پیش‌فرض هم نمادهای تعریف‌شده و هم تعریف‌نشده نمایش داده می‌شوند.
.IP \fB\-U\fR 4
.IX Item "-U"
.PD 0
.IP \fB\-\-defined\-only\fR 4
.IX Item "--defined-only"
.PD
فقط نمایش نمادهای تعریف‌شده برای هر فایل شیء. به‌طور پیش‌فرض هم نمادهای تعریف‌شده و هم تعریف‌نشده نمایش داده می‌شوند.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شماره نسخه \fBnm\fR و خروج.
.IP \fB\-X\fR 4
.IX Item "-X"
این گزینه جهت سازگاری با نسخه AIX برنامه \fBnm\fR نادیده گرفته می‌شود. این گزینه یک پارامتر می‌گیرد که باید رشته \fB32_64\fR باشد. حالت پیش‌فرض AIX \fBnm\fR متناظر با \fB\-X 32\fR است که توسط GNU \fBnm\fR پشتیبانی نمی‌شود.
.IP "\fB\-\-plugin\fR \fIname\fR" 4
.IX Item "--plugin name"
بارگذاری پلاگینی به نام \fIname\fR برای افزودن پشتیبانی از انواع هدف اضافی. این گزینه تنها در صورتی در دسترس است که ابزار با پشتیبانی از پلاگین ساخته شده باشد.
.Sp
اگر \fB\-\-plugin\fR ارائه نشود اما پشتیبانی از پلاگین فعال باشد، \fBnm\fR فایل‌های موجود در دایرکتوری \fI${libdir}/bfd\-plugins\fR را به ترتیب الفبایی پیمایش کرده و از اولین پلاگینی که ادعای پشتیبانی از شیء مورد نظر را داشته باشد استفاده می‌کند.
.Sp
لطفاً توجه داشته باشید که این دایرکتوری جستجوی پلاگین، همان دایرکتوری استفاده‌شده توسط گزینه \fB\-plugin\fR برنامه \fBld\fR \fIنیست\fR. برای اینکه \fBnm\fR از پلاگین پیونددهنده استفاده کند، پلاگین باید در دایرکتوری \fI${libdir}/bfd\-plugins\fR کپی شود. برای کامپایل‌های مبتنی بر GCC، پلاگین پیونددهنده \fIliblto_plugin.so.0.0.0\fR نام دارد. برای کامپایل‌های مبتنی بر Clang، نام آن \fILLVMgold.so\fR است. پلاگین GCC همیشه با نسخه‌های قبلی سازگار است، بنابراین کپی کردن جدیدترین نسخه کافی است.
.IP \fB\-\-size\-sort\fR 4
.IX Item "--size-sort"
مرتب‌سازی نمادها بر اساس اندازه. برای اشیاء ELF، اندازه نمادها از ELF خوانده می‌شود؛ برای سایر انواع شیء، اندازه نمادها به عنوان اختلاف بین مقدار نماد و مقدار نماد با مقدار بالاتر بعدی محاسبه می‌شود. اگر از فرمت خروجی \f(CW\*(C`bsd\*(C'\fR استفاده شود، اندازه نماد به جای مقدار آن چاپ می‌شود و برای چاپ هر دو مقدار و اندازه، باید از \fB\-S\fR استفاده کرد.
.Sp
نکته \- این گزینه در صورت فعال بودن \fB\-\-undefined\-only\fR کار نمی‌کند زیرا نمادهای تعریف‌نشده اندازه‌ای ندارند.
.IP \fB\-\-special\-syms\fR 4
.IX Item "--special-syms"
نمایش نمادهایی که دارای معنای خاص وابسته به معماری مقصد هستند. این نمادها معمولاً توسط معماری مقصد برای پردازش‌های خاص استفاده می‌شوند و به طور معمول در فهرست‌های معمولی نمادها مفید نیستند. برای مثال در معماری ARM، این گزینه نمادهای نگاشت مورد استفاده برای مشخص کردن گذار بین کد ARM، کد THUMB و داده‌ها را نادیده می‌گیرد.
.IP \fB\-\-synthetic\fR 4
.IX Item "--synthetic"
شامل کردن نمادهای ساختگی (synthetic) در خروجی. این‌ها نمادهای خاصی هستند که توسط پیونددهنده برای اهداف مختلف ایجاد می‌شوند. این نمادها به‌طور پیش‌فرض نمایش داده نمی‌شوند زیرا بخشی از کد منبع اصلی باینری نیستند.
.IP \fB\-\-unicode=\fR\fI[default|invalid|locale|escape|hex|highlight]\fR 4
.IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
کنترل نحوه نمایش نویسه‌های چندبایتی کدگذاری‌شده با UTF-8 در رشته‌ها. مقدار پیش‌فرض (\fB\-\-unicode=default\fR) رفتار خاصی با آن‌ها انجام نمی‌دهد. گزینه \fB\-\-unicode=locale\fR دنباله را در لوکال جاری نمایش می‌دهد که ممکن است از آن‌ها پشتیبانی کند یا نکند. گزینه‌های \fB\-\-unicode=hex\fR و \fB\-\-unicode=invalid\fR آن‌ها را به صورت دنباله‌ای از بایت‌های هگز درون پرانتز شکسته یا آکولاد نمایش می‌دهند.
.Sp
گزینه \fB\-\-unicode=escape\fR آن‌ها را به صورت دنباله‌های گریز (\fI\euxxxx\fR) نمایش می‌دهد و گزینه \fB\-\-unicode=highlight\fR آن‌ها را به صورت دنباله‌های گریز برجسته با رنگ قرمز نمایش می‌دهد (در صورت پشتیبانی دستگاه خروجی). این رنگ‌آمیزی با هدف جلب توجه به وجود دنباله‌های یونیکد در جاهایی که انتظارشان نمی‌رود طراحی شده است.
.IP \fB\-W\fR 4
.IX Item "-W"
.PD 0
.IP \fB\-\-no\-weak\fR 4
.IX Item "--no-weak"
.PD
نمادهای ضعیف (weak) را نمایش نمی‌دهد.
.IP \fB\-\-with\-symbol\-versions\fR 4
.IX Item "--with-symbol-versions"
.PD 0
.IP \fB\-\-without\-symbol\-versions\fR 4
.IX Item "--without-symbol-versions"
.PD
نمایش اطلاعات نسخه نماد را فعال یا غیرفعال می‌کند. رشته نسخه به صورت پسوندی برای نام نماد و پس از یک نویسه @ نمایش داده می‌شود؛ مانند \fBfoo@VER_1\fR. اگر نسخه، نسخه پیش‌فرضی باشد که هنگام حل ارجاعات بدون نسخه به نماد استفاده می‌شود، به عنوان پسوند پس از دو نویسه @ نمایش داده می‌شود؛ مانند \fBfoo@@VER_2\fR. به‌طور پیش‌فرض، اطلاعات نسخه نماد نمایش داده می‌شود.
.IP \fB\-\-target=\fR\fIbfdname\fR 4
.IX Item "--target=bfdname"
مشخص کردن فرمت کد شیء غیر از فرمت پیش‌فرض سیستم شما.
.IP \fB@\fR\fIfile\fR 4
.IX Item "@file"
خواندن گزینه‌های خط فرمان از \fIfile\fR. گزینه‌های خوانده‌شده به جای گزینه اصلی @\fIfile\fR درج می‌شوند. اگر \fIfile\fR وجود نداشته باشد یا خوانده نشود، گزینه به صورت تحت‌اللفظی رفتار شده و حذف نخواهد شد.
.Sp
گزینه‌ها در \fIfile\fR با فاصله‌های خالی از هم جدا می‌شوند. یک نویسه فاصله می‌تواند با احاطه کل گزینه درون علامت‌های نقل‌قول تکی یا دوتایی در گزینه گنجانده شود. هر نویسه‌ای (از جمله بک‌اسلش) می‌تواند با پیشوند کردن یک بک‌اسلش به نویسه مورد نظر اضافه شود. خود \fIfile\fR می‌تواند حاوی گزینه‌های @\fIfile\fR اضافی باشد؛ هر یک از این گزینه‌ها به صورت بازگشتی پردازش خواهند شد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBar\fR\|(1)، \fBobjdump\fR\|(1)، \fBranlib\fR\|(1) و مدخل‌های Info برای \fIbinutils\fR.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر \(co 1991\-2025 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
.PP
مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز اسناد آزاد گنو (GNU Free Documentation License)، نسخه 1.3 یا هر نسخه متأخرتر منتشرشده توسط بنیاد نرم‌افزار آزاد صادر می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متن‌های روی جلد و بدون متن‌های پشت جلد. یک کپی از این مجوز در بخش تحت عنوان "GNU Free Documentation License" گنجانده شده است.