نام (NAME)

gprofng-display-src - نمایش کد منبع و در صورت تمایل کد دیس‌اسمبلی شیء هدف

خلاصه دستور (SYNOPSIS)

gprofng display src [گزینه‌ها] target-file

توضیحات (DESCRIPTION)

فهرست کد منبع، یا کد منبع درآمیخته با کد دیس‌اسمبلی، استخراج‌شده از فایل هدف (یک فایل اجرایی، شیء اشتراکی، فایل شیء یا یک فایل ‎.class‎ جاوا) را نمایش می‌دهد.

برای نمونه، دستور زیر فهرست کد منبع و دیس‌اسمبلی تابعی به نام mxv_core را که بخشی از فایل شیء mxv.o است نمایش می‌دهد:

$ gprofng display src -disasm mxv_core mxv.o

برای نمایش فهرست کد منبع و دیس‌اسمبلی همه توابع موجود در این فایل، از دستور زیر استفاده کنید:

$ gprofng display src -disasm all -1 mxv.o

شناسه target-file نام یک فایل اجرایی، شیء اشتراکی (Shared Object)، فایل شیء (.o) یا یک فایل کلاس جاوا (.class) است.

اگر هیچ گزینه‌ای مشخص نشود، فهرست کد منبع target-file نمایش داده می‌شود. این حالت معادل -source all -1 است. چنانچه این اطلاعات در دسترس نباشد، پیامی مبنی بر این موضوع چاپ خواهد شد.

گزینه‌ها (OPTIONS)

--version

چاپ شماره نسخه برنامه و خروج.

--help

چاپ اطلاعات نحوه استفاده از دستور و خروج.

-functions

فهرست کردن تمام توابع موجود در شیء داده‌شده.

-source item tag

نمایش کد منبع برای item در target-file. پارامتر tag برای تمایز در مواردی به کار می‌رود که چندین مورد با نام یکسان وجود داشته باشند. تعریف item و tag را در بخش نکات (NOTES) ببینید.

-disasm item tag

گنجاندن دیس‌اسمبلی در فهرست کد منبع. فهرست پیش‌فرض شامل دیس‌اسمبلی نیست. اگر کد منبع در دسترس نباشد، تنها فهرستی از دیس‌اسمبلی نمایش داده می‌شود. تعریف item و tag را در بخش نکات (NOTES) ببینید.

-outfile filename

نوشتن نتایج در فایل filename. یک خط تیره (-) نتایج را در خروجی استاندارد (stdout) می‌نویسد. این حالت پیش‌فرض نیز هست. توجه داشته باشید که این گزینه تنها بر گزینه‌هایی اثر می‌گذارد که در سمت راست این گزینه قرار گرفته باشند.

نکات (NOTES)

از item برای تعیین نام یک تابع، یا یک فایل منبع یا شیء استفاده کنید که برای ساخت فایل اجرایی یا شیء اشتراکی به کار رفته است.

شناسه tag شاخصی است که برای تشخیص اینکه به کدام مورد ارجاع داده شده، در زمانی که چندین تابع نام یکسانی دارند، به کار می‌رود. این شناسه الزامی است، اما در صورتی که برای تفکیک تابع نیازی به آن نباشد نادیده گرفته خواهد شد.

همچنین item می‌تواند به شکل function`file` مشخص شود که در این صورت، کد منبع یا دیس‌اسمبلی تابع نام‌برده‌شده در زمینه منبع فایل تعیین‌شده استفاده خواهد شد.

ترکیب خاص item و tag به صورت all -1 برای تولید کد منبع یا دیس‌اسمبلی برای تمام توابع موجود در target-file به کار می‌رود.

همچنین ببینید (SEE ALSO)

gprofng(1), gprofng-archive(1), gprofng-collect-app(1), gprofng-display-html(1), gprofng-display-text(1)

راهنمای کاربری ابزار gprofng به‌صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. در صورت نصب بودن برنامه‌های info و gprofng، دستور info gprofng باید دسترسی به این مستندات را فراهم کند.

کپی‌رایت (COPYRIGHT)

حق نشر © ۲۰۲۲-۲۰۲۶ بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)

اجازه نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد داده می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.