.TH GPROFNG-DISPLAY-SRC 1 "2026-08-11" "binutils-2.47" "دستورات کاربر"
.if n .ad l
.nh
.SH "نام (NAME)"
gprofng\-display\-src \- نمایش کد منبع و در صورت تمایل کد دیس‌اسمبلی شیء هدف
.SH "خلاصه دستور (SYNOPSIS)"
.B gprofng display src
[\fIگزینه‌ها\fR] \fItarget\-file\fR
.SH "توضیحات (DESCRIPTION)"
فهرست کد منبع، یا کد منبع درآمیخته با کد دیس‌اسمبلی، استخراج‌شده از فایل هدف (یک فایل اجرایی، شیء اشتراکی، فایل شیء یا یک فایل ‎.class‎ جاوا) را نمایش می‌دهد.
.PP
برای نمونه، دستور زیر فهرست کد منبع و دیس‌اسمبلی تابعی به نام
.B mxv_core
را که بخشی از فایل شیء
.B mxv.o
است نمایش می‌دهد:
.PP
.nf
        $ gprofng display src \-disasm mxv_core mxv.o
.fi
.PP
برای نمایش فهرست کد منبع و دیس‌اسمبلی همه توابع موجود در این فایل، از دستور زیر استفاده کنید:
.PP
.nf
        $ gprofng display src \-disasm all \-1 mxv.o
.fi
.PP
شناسه
.I target\-file
نام یک فایل اجرایی، شیء اشتراکی (Shared Object)، فایل شیء (\&.o) یا یک فایل کلاس جاوا (\&.class) است.
.PP
اگر هیچ گزینه‌ای مشخص نشود، فهرست کد منبع
.I target\-file
نمایش داده می‌شود. این حالت معادل
.B \-source all \-1
است. چنانچه این اطلاعات در دسترس نباشد، پیامی مبنی بر این موضوع چاپ خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.IP \fB\-\-version\fR 4
چاپ شماره نسخه برنامه و خروج.
.IP \fB\-\-help\fR 4
چاپ اطلاعات نحوه استفاده از دستور و خروج.
.IP \fB\-functions\fR 4
فهرست کردن تمام توابع موجود در شیء داده‌شده.
.IP "\fB\-source\fR \fIitem\fR \fItag\fR" 4
نمایش کد منبع برای
.I item
در
.IR target\-file .
پارامتر
.I tag
برای تمایز در مواردی به کار می‌رود که چندین مورد با نام یکسان وجود داشته باشند.
تعریف
.I item
و
.I tag
را در بخش
.B "نکات (NOTES)"
ببینید.
.IP "\fB\-disasm\fR \fIitem\fR \fItag\fR" 4
گنجاندن دیس‌اسمبلی در فهرست کد منبع. فهرست پیش‌فرض شامل دیس‌اسمبلی نیست. اگر کد منبع در دسترس نباشد، تنها فهرستی از دیس‌اسمبلی نمایش داده می‌شود.
تعریف
.I item
و
.I tag
را در بخش
.B "نکات (NOTES)"
ببینید.
.IP "\fB\-outfile\fR \fIfilename\fR" 4
نوشتن نتایج در فایل
.IR filename .
یک خط تیره (\-) نتایج را در خروجی استاندارد (stdout) می‌نویسد.
این حالت پیش‌فرض نیز هست. توجه داشته باشید که این گزینه تنها بر گزینه‌هایی اثر می‌گذارد که در سمت راست این گزینه قرار گرفته باشند.
.SH "نکات (NOTES)"
از
.I item
برای تعیین نام یک تابع، یا یک فایل منبع یا شیء استفاده کنید که برای ساخت فایل اجرایی یا شیء اشتراکی به کار رفته است.
.PP
شناسه
.I tag
شاخصی است که برای تشخیص اینکه به کدام مورد ارجاع داده شده، در زمانی که چندین تابع نام یکسانی دارند، به کار می‌رود. این شناسه الزامی است، اما در صورتی که برای تفکیک تابع نیازی به آن نباشد نادیده گرفته خواهد شد.
.PP
همچنین
.I item
می‌تواند به شکل
\fBfunction\`file\`\fR
مشخص شود که در این صورت، کد منبع یا دیس‌اسمبلی تابع نام‌برده‌شده در زمینه منبع فایل تعیین‌شده استفاده خواهد شد.
.PP
ترکیب خاص
.I item
و
.I tag
به صورت
.B all \-1
برای تولید کد منبع یا دیس‌اسمبلی برای تمام توابع موجود در
.I target\-file
به کار می‌رود.
.SH "همچنین ببینید (SEE ALSO)"
.BR gprofng (1),
.BR gprofng\-archive (1),
.BR gprofng\-collect\-app (1),
.BR gprofng\-display\-html (1),
.BR gprofng\-display\-text (1)
.PP
راهنمای کاربری ابزار gprofng به‌صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. در صورت نصب بودن برنامه‌های
.B info
و
.BR gprofng ،
دستور
.B info gprofng
باید دسترسی به این مستندات را فراهم کند.
.SH "کپی‌رایت (COPYRIGHT)"
حق نشر \(co ۲۰۲۲\-۲۰۲۶ بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
.PP
اجازه نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد داده می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.