GPROFNG(1) User Commands GPROFNG(1)

gprofng - نسل بعدی ابزار پروفایل‌بندی برنامه‌های کاربردی در گنو

gprofng [option(s)] action [qualifier] [option(s)] target [options]

این برنامه گرداننده (Driver) مجموعه ابزارهای gprofng برای گردآوری و تحلیل داده‌های کارایی (Performance) است.

این گرداننده، action (کنش) مشخص‌شده را اجرا می‌کند. نمونه‌ای از یک کنش، دستور collect برای گردآوری داده‌های کارایی است. بسته به کنش، ممکن است برای تعریف دقیق‌تر دستور به یک qualifier (توصیف‌کننده) نیاز باشد. آخرین مورد نیز target (هدف) است که دستور بر روی آن اعمال می‌شود.

گزینه‌ها در سه بخش مختلف پشتیبانی می‌شوند. خودِ گرداننده از گزینه‌هایی پشتیبانی می‌کند که فهرست آن‌ها در ادامه آمده است. همچنین action (احتمالاً در ترکیب با qualifier) نیز از گزینه‌هایی پشتیبانی می‌کند که توضیحات آن‌ها در صفحه راهنمای دستور مربوطه یافت می‌شود. هر گزینه‌ای که برای اجرای دستور هدف مورد نیاز است، باید پس از نام هدف آورده شود.

برای نمونه، جهت گردآوری داده‌های کارایی برای برنامه‌ای با نام a.out و ذخیره نتایج در دایرکتوری آزمایش mydata.er، می‌توان دستور زیر را به کار برد:

$ gprofng collect app -o mydata.er a.out -t 2

در این مثال، کنش برابر با collect، توصیف‌کننده برابر با app، تنها آرگومان داده‌شده به دستور "-o mydata.er"; و هدف نیز a.out است. دستور هدف با گزینه -t 2 فراخوانی شده است.

اگر gprofng بدون هیچ گزینه، کنش یا هدف اضافی اجرا شود، خلاصه‌ای از نحوه استفاده چاپ خواهد شد.

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

متغیرهای محیطی زیر پشتیبانی می‌شوند:

تنظیم عمق پشته فراخوانی (مقدار پیش‌فرض 256 است).
هنگام پروفایل‌بندی یک برنامه C/C++ که از تابع dlopen() برای اجرای کد جاوا استفاده می‌کند، می‌تواند تنظیم شود.
تنظیم این متغیر امکان تولید فایل تخلیه حافظه (Core Dump) را فراهم می‌کند؛ در غیر این صورت یک گزارش خطا در /tmp ایجاد می‌شود.
استفاده از این متغیر برای تعریف تنظیمات بایگانی خودکار پس از پایان ضبط آزمایش است.
تنظیم این متغیر به مکان بایگانی مشترک.
تنظیم عمق پشته فراخوانی جاوا؛ مقدار پیش‌فرض 256 است؛ برای غیرفعال کردن ضبط پشته‌های فراخوانی، مقدار آن را روی 0 قرار دهید.
تنظیم عمق پشته فراخوانی بومی (Native) جاوا؛ مقدار پیش‌فرض 256 است؛ برای غیرفعال کردن ضبط پشته‌های فراخوانی، مقدار آن را روی 0 قرار دهید (پشته‌های فراخوانی اسمبلی و JNI ثبت نمی‌شوند).
تنظیم مسیر فایل پیکربندی gprofng.rc. به‌طور پیش‌فرض، این فایل در زیرشاخه etc از دایرکتوری نصب binutils قرار دارد. در صورتی که برای نصب از یک بسته RPM استفاده شده باشد، این فایل در دایرکتوری /etc قرار دارد.

هنگام ساخت و نصب از روی کد منبع، کاربر می‌تواند مسیر این فایل پیکربندی را به مکانی غیرپیش‌فرض تنظیم کند. در این صورت، کاربر می‌تواند متغیر محیطی "GPROFNG_SYSCONFDIR" را برای اشاره به این مکان تنظیم کند.

در غیر این صورت، ابزارهای gprofng display text، gprofng display src و gprofng archive قادر به یافتن این فایل نخواهند بود.

گرداننده gprofng از دستورات زیر پشتیبانی می‌کند:

گردآوری داده‌های کارایی:

"gprofng collect app"
گردآوری داده‌های کارایی برنامه کاربردی.

نمایش نتایج کارایی:

"gprofng display text"
نمایش داده‌های کارایی در قالب اسکی (ASCII).
"gprofng display html"
تولید یک فایل HTML از یک یا چند آزمایش.
"gprofng display gui"
شروع رابط گرافیکی کاربری (GUI). توجه داشته باشید که این ابزار به‌طور پیش‌فرض موجود نیست و باید جداگانه نصب شود.

دستورات متفرقه:

"gprofng display src"
نمایش کد منبع یا دیس‌اسمبلی به همراه حاشیه‌نویسی‌های کامپایلر.
"gprofng display gmon"
تبدیل یک فایل gmon.out داده‌شده به آزمایش‌های gprofng.
"gprofng archive"
گنجاندن فایل‌های باینری و کد منبع درون دایرکتوری آزمایش.

فراخوانی مستقیم دستورات سطح پایین‌تر نیز ممکن است، اما از آنجا که این دستورات (به‌ویژه گزینه‌های آن‌ها) ممکن است دستخوش تغییر شوند، توصیه می‌کنیم از همین گرداننده استفاده کنید.

ابزار gprofng GUI یک ابزار اختیاری است که یک رابط گرافیکی را برای "gprofng" فراهم می‌آورد. استفاده از آن آسان بوده و از نماهای متعددی برای بررسی داده‌های کارایی پشتیبانی می‌کند. برای علاقه‌مندان به این رابط گرافیکی، پیشنهاد می‌کنیم عبارت "gprofng-gui" را برای چگونگی دریافت، نصب و استفاده از آن جستجو کنند.

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

هر یک از دستورات gprofng نیز از گزینه --help پشتیبانی می‌کنند. این گزینه فهرستی از گزینه‌ها و توضیح کوتاهی برای هر گزینه را نمایش می‌دهد.

برای نمونه، دستور زیر گزینه‌های پشتیبانی‌شده در دستور gprofng collect app را نمایش می‌دهد:

$ gprofng collect app --help

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

کپی‌رایت © 2022-2026 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)

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

2026-08-11 binutils-2.47