.\" -*- 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)"
lm32-elf-strings \- چاپ رشته‌های کاراکتری قابل چاپ از فایل‌های شیء LatticeMico32
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\fBstrings\fR [\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"
به ازای هر \fIپرونده\fR مشخص‌شده، دستور گنو \fBstrings\fR دنباله‌های کاراکترهای قابل چاپ را که حداقل ۴ کاراکتر طول دارند (یا طولی که در گزینه‌های زیر تعیین شده است) و پس از آن‌ها یک کاراکتر غیرقابل چاپ قرار گرفته است، چاپ می‌کند.
.PP
بسته به نحوه پیکربندی برنامه strings، رفتار پیش‌فرض آن نمایش تمامی دنباله‌های قابل چاپی است که در هر فایل پیدا می‌کند، یا فقط دنباله‌هایی که در بخش‌های داده‌ای بارگذاری‌شونده و مقداردهی‌شده قرار دارند. اگر نوع فایل غیرقابل تشخیص باشد، یا اگر 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 به موقعیت خود در خط فرمان وابسته است و strings را وادار می‌کند تا هر فایلی را که پس از \fB\-\fR در خط فرمان آورده شده، به طور کامل پویش کند، حتی اگر گزینه \fB\-d\fR مشخص شده باشد.
.IP \fB\-d\fR 4
.IX Item "-d"
.PD 0
.IP \fB\-\-data\fR 4
.IX Item "--data"
.PD
فقط رشته‌های موجود در بخش‌های داده‌ای بارگذاری‌شده و مقداردهی‌شده فایل را چاپ می‌کند. این کار ممکن است حجم داده‌های نامربوط در خروجی را کاهش دهد، اما برنامه strings را در معرض آسیب‌پذیری‌های امنیتی احتمالی موجود در کتابخانه 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 بستگی دارد. دنباله‌ها همواره در کاراکترهای کنترلی مانند خط جدید و بازگشت به ابتدای خط پایان می‌یابند، اما کاراکتر تب دنباله را خاتمه نمی‌دهد.
.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 برای هشت‌هشتی (اکتال)، \fBx\fR برای شانزده‌شانزدهی (هگزادسیمال)، یا \fBd\fR برای ده‌دهی (دسیمال).
.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 = ۱۶ بیتی با ترتیب بایت بزرگ‌تر (bigendian)، \fBl\fR = ۱۶ بیتی با ترتیب بایت کوچک‌تر (littleendian)، \fBB\fR = ۳۲ بیتی bigendian، و \fBL\fR = ۳۲ بیتی littleendian. برای یافتن رشته‌های کاراکتری عریض (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 آن‌ها را بر اساس لوکال (تنظیمات محلی) فعلی نمایش می‌دهد که ممکن است از کدگذاری 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
به طور پیش‌فرض کاراکترهای تب و فاصله جزو رشته‌های نمایشی لحاظ می‌شوند، اما سایر کاراکترهای فضای خالی مانند خط جدید و بازگشت به ابتدای خط لحاظ نمی‌شوند. گزینه \fB\-w\fR این رفتار را تغییر می‌دهد تا تمامی کاراکترهای فضای خالی بخشی از رشته به حساب آیند.
.IP \fB\-s\fR 4
.IX Item "-s"
.PD 0
.IP \fB\-\-output\-separator\fR 4
.IX Item "--output-separator"
.PD
به طور پیش‌فرض، رشته‌های خروجی با خط جدید از یکدیگر تفکیک می‌شوند. این گزینه امکان تعیین هر رشته دلخواه را به عنوان جداکننده رکوردهای خروجی فراهم می‌کند. این گزینه هنگام همراهی با \-\-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"
حق نشر \(co ۱۹۹۱\-۲۰۲۵ بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
.PP
مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License) نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. نسخه‌ای از این مجوز در بخش با عنوان «GNU Free Documentation License» گنجانده شده است.