.\" -*- 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 "STRINGS 1"
.TH STRINGS 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)"
nds32le-elf-strings \- استخراج و نمایش رشته‌های متنی قابل چاپ از باینری‌های Andes NDS32
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
strings [\fB\-afovV\fR] [\fB\-\fR\fImin\-len\fR]
        [\fB\-n\fR \fImin\-len\fR] [\fB\-\-bytes=\fR\fImin\-len\fR]
        [\fB\-t\fR \fIradix\fR] [\fB\-\-radix=\fR\fIradix\fR]
        [\fB\-e\fR \fIencoding\fR] [\fB\-\-encoding=\fR\fIencoding\fR]
        [\fB\-U\fR \fImethod\fR] [\fB\-\-unicode=\fR\fImethod\fR]
        [\fB\-\fR] [\fB\-\-all\fR] [\fB\-\-print\-file\-name\fR]
        [\fB\-T\fR \fIbfdname\fR] [\fB\-\-target=\fR\fIbfdname\fR]
        [\fB\-w\fR] [\fB\-\-include\-all\-whitespace\fR]
        [\fB\-s\fR] [\fB\-\-output\-separator\fR \fIsep_string\fR]
        [\fB\-\-help\fR] [\fB\-\-version\fR] \fIfile\fR...
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
به ازای هر \fIfile\fR مشخص‌شده، ابزار GNU \fBstrings\fR توالی‌هایی از نویسه‌های قابل چاپ را که طول آن‌ها حداقل ۴ نویسه باشد (یا به تعداد تعیین‌شده توسط گزینه‌های زیر) و پس از آن‌ها یک نویسه غیرقابل چاپ قرار گرفته است، چاپ می‌کند.
.PP
بسته به نحوه پیکربندی برنامه strings، رفتار پیش‌فرض آن نمایش تمام توالی‌های قابل چاپ موجود در فایل یا فقط نمایش توالی‌های موجود در بخش‌های داده‌ای بارگذاری‌شونده و مقداردهی‌شده است. اگر نوع فایل قابل تشخیص نباشد یا برنامه از ورودی استاندارد (stdin) بخواند، همیشه تمامی توالی‌های قابل چاپ یافت‌شده نمایش داده می‌شوند.
.PP
جهت حفظ سازگاری با نسخه‌های پیشین، هر فایلی که پس از گزینه خط فرمان \fB\-\fR قرار گیرد، صرف‌نظر از وجود گزینه \fB\-d\fR، به صورت کامل پویش خواهد شد.
.PP
کاربرد اصلی \&\fBstrings\fR تشخیص و بررسی محتوای فایل‌های غیرمتنی و باینری است.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-a\fR 4
.IX Item "-a"
.PD 0
.IP \fB\-\-all\fR 4
.IX Item "--all"
.IP \fB\-\fR 4
.IX Item "-"
.PD
پویش کامل فایل، بدون در نظر گرفتن بخش‌های موجود در آن یا بارگذاری و مقداردهی اولیه بخش‌ها. معمولاً این رفتار پیش‌فرض است، اما strings می‌تواند طوری پیکربندی شود که گزینه \&\fB\-d\fR پیش‌فرض باشد.
.Sp
گزینه \fB\-\fR به ترتیب و موقعیت در خط فرمان وابسته است و برنامه را وادار می‌کند فایل‌هایی را که پس از \fB\-\fR در خط فرمان آورده شده‌اند، حتی در صورت مشخص شدن گزینه \fB\-d\fR، به صورت کامل پویش کند.
.IP \fB\-d\fR 4
.IX Item "-d"
.PD 0
.IP \fB\-\-data\fR 4
.IX Item "--data"
.PD
فقط چاپ رشته‌ها از بخش‌های داده‌ای مقداردهی‌شده و بارگذاری‌شونده در فایل. این گزینه ممکن است مقدار داده‌های زائد در خروجی را کاهش دهد، اما برنامه را در معرض آسیب‌پذیری‌های امنیتی احتمالی موجود در کتابخانه BFD (که برای پویش و بارگذاری بخش‌ها به کار می‌رود) قرار می‌دهد. می‌توان strings را طوری پیکربندی کرد که این گزینه رفتار پیش‌فرض باشد. در چنین شرایطی با استفاده از گزینه \fB\-a\fR می‌توان از به‌کارگیری کتابخانه BFD اجتناب کرده و به جای آن تمام رشته‌های درون فایل را چاپ نمود.
.IP \fB\-f\fR 4
.IX Item "-f"
.PD 0
.IP \fB\-\-print\-file\-name\fR 4
.IX Item "--print-file-name"
.PD
چاپ نام فایل پیش از هر رشته.
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش خلاصه نحوه استفاده از برنامه در خروجی استاندارد و خروج.
.IP \fB\-\fR\fImin\-len\fR 4
.IX Item "-min-len"
.PD 0
.IP "\fB\-n\fR \fImin\-len\fR" 4
.IX Item "-n min-len"
.IP \fB\-\-bytes=\fR\fImin\-len\fR 4
.IX Item "--bytes=min-len"
.PD
چاپ توالی‌هایی از نویسه‌های قابل نمایش با حداقل طول \&\fImin\-len\fR نویسه. در صورت عدم تعیین، طول پیش‌فرض ۴ در نظر گرفته می‌شود. تفاوت میان نویسه‌های قابل نمایش و غیرقابل نمایش به تنظیمات گزینه‌های \&\fB\-e\fR و \fB\-U\fR بستگی دارد. توالی‌ها همیشه با رسیدن به نویسه‌های کنترلی مانند خط جدید (newline) یا بازگشت به ابتدای سطر (carriage return) خاتمه می‌یابند، اما نویسه تب (tab) شامل این مورد نمی‌شود.
.IP \fB\-o\fR 4
.IX Item "-o"
مشابه \fB\-t o\fR. برخی نسخه‌های دیگر \fBstrings\fR عملکرد \fB\-o\fR را مشابه \fB\-t d\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
چاپ آفست (موقعیت مکانی) درون فایل پیش از هر رشته. آرگومان تک‌نویسه‌ای مبنای عددی آفست را تعیین می‌کند: \fBo\fR برای هشت‌هشتی (octal)، \fBx\fR برای شانزده‌شانزدهی (hexadecimal) و \fBd\fR برای ده‌دهی (decimal).
.IP "\fB\-e\fR \fIencoding\fR" 4
.IX Item "-e encoding"
.PD 0
.IP \fB\-\-encoding=\fR\fIencoding\fR 4
.IX Item "--encoding=encoding"
.PD
انتخاب کدگذاری نویسه‌ها برای رشته‌های مورد جستجو. مقادیر مجاز برای \fIencoding\fR عبارتند از: \fBs\fR = نویسه‌های تک‌بایتی ۷ بیتی (پیش‌فرض)، \fBS\fR = نویسه‌های تک‌بایتی ۸ بیتی، \fBb\fR = ۱۶ بیتی big-endian، \fBl\fR = ۱۶ بیتی little-endian، \fBB\fR = ۳۲ بیتی big-endian، \fBL\fR = ۳۲ بیتی little-endian. این گزینه برای یافتن رشته‌های نویسه عریض (wide character) کاربرد دارد (\fBl\fR و \fBb\fR برای مثال در کدگذاری‌های یونیکد UTF\-16/UCS\-2 به کار می‌روند).
.IP "\fB\-U\fR \fI[d|i|l|e|x|h]\fR" 4
.IX Item "-U [d|i|l|e|x|h]"
.PD 0
.IP \fB\-\-unicode=\fR\fI[default|invalid|locale|escape|hex|highlight]\fR 4
.IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
.PD
کنترل نحوه نمایش نویسه‌های چندبایتی با کدگذاری UTF\-8 در رشته‌ها. مقدار پیش‌فرض (\fB\-\-unicode=default\fR) رفتار ویژه‌ای برای آن‌ها اعمال نمی‌کند و به تنظیمات گزینه \&\fB\-\-encoding\fR متکی است. سایر مقادیر این گزینه به صورت خودکار \fB\-\-encoding=S\fR را فعال می‌سازند.
.Sp
گزینه \fB\-\-unicode=invalid\fR با آن‌ها به عنوان نویسه‌های غیرگرافیکی رفتار کرده و در نتیجه آن‌ها را بخشی از یک رشته معتبر به حساب نمی‌آورد. تمام گزینه‌های دیگر آن‌ها را به عنوان نویسه‌های رشته‌ای معتبر در نظر می‌گیرند.
.Sp
گزینه \fB\-\-unicode=locale\fR آن‌ها را در لوکال (locale) جاری نمایش می‌دهد که ممکن است از کدگذاری UTF\-8 پشتیبانی کند یا نکند. گزینه \&\fB\-\-unicode=hex\fR آن‌ها را به صورت توالی‌های بایتی هگزادسیمال درون نویسه‌های \fI<>\fR نمایش می‌دهد. گزینه \fB\-\-unicode=escape\fR آن‌ها را به شکل توالی‌های اسکیپ (\fI\euxxxx\fR) و گزینه \&\fB\-\-unicode=highlight\fR آن‌ها را به صورت توالی‌های اسکیپ با رنگ قرمز برجسته نمایش می‌دهد (در صورت پشتیبانی دستگاه خروجی). رنگ‌بندی به منظور جلب توجه به وجود توالی‌های یونیکد در جاهایی است که انتظار حضور آن‌ها نمی‌رود.
.IP "\fB\-T\fR \fIbfdname\fR" 4
.IX Item "-T bfdname"
.PD 0
.IP \fB\-\-target=\fR\fIbfdname\fR 4
.IX Item "--target=bfdname"
.PD
مشخص کردن قالب کد شیء (object code) غیر از قالب پیش‌فرض سیستم.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-V\fR 4
.IX Item "-V"
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شماره نسخه برنامه در خروجی استاندارد و خروج.
.IP \fB\-w\fR 4
.IX Item "-w"
.PD 0
.IP \fB\-\-include\-all\-whitespace\fR 4
.IX Item "--include-all-whitespace"
.PD
به طور پیش‌فرض نویسه‌های تب (tab) و فاصله (space) در رشته‌های نمایشی گنجانده می‌شوند، اما سایر نویسه‌های فاصله‌ساز مانند خطوط جدید (newlines) و بازگشت به سطر (carriage returns) لحاظ نمی‌شوند. گزینه \fB\-w\fR این رفتار را تغییر می‌دهد تا تمام نویسه‌های فاصله‌ساز بخشی از رشته محسوب شوند.
.IP \fB\-s\fR 4
.IX Item "-s"
.PD 0
.IP \fB\-\-output\-separator\fR 4
.IX Item "--output-separator"
.PD
به طور پیش‌فرض، رشته‌های خروجی با خط جدید (newline) از یکدیگر جدا می‌شوند. این گزینه امکان تعیین هر رشته دلخواه را به عنوان جداکننده رکورد خروجی فراهم می‌سازد. هنگام استفاده از \-\-include\-all\-whitespace که رشته‌ها ممکن است در درون خود خطوط جدید داشته باشند، کاربردی است.
.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), \fBnm\fR\|(1), \fBobjdump\fR\|(1), \fBranlib\fR\|(1), \fBreadelf\fR\|(1)
و مدخل‌های Info برای \fIbinutils\fR.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (c) 1991\-2025 Free Software Foundation, Inc.
.PP
مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.