.\" -*- 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 "GPROFNG 1"
.TH GPROFNG 1 2026-08-11 binutils-2.47 "User Commands"
.\" 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)"
gprofng \- نسل بعدی ابزار پروفایل‌بندی برنامه‌های کاربردی در گنو
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBgprofng\fR [\fIoption(s)\fR] \fIaction\fR [\fIqualifier\fR]
[\fIoption(s)\fR] \fItarget\fR [\fIoptions\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
این برنامه گرداننده (Driver) مجموعه ابزارهای gprofng برای گردآوری و تحلیل داده‌های کارایی (Performance) است.
.PP
این گرداننده، \fIaction\fR (کنش) مشخص‌شده را اجرا می‌کند. نمونه‌ای از یک کنش، دستور \&\fBcollect\fR برای گردآوری داده‌های کارایی است. بسته به کنش، ممکن است برای تعریف دقیق‌تر دستور به یک \fIqualifier\fR (توصیف‌کننده) نیاز باشد. آخرین مورد نیز \fItarget\fR (هدف) است که دستور بر روی آن اعمال می‌شود.
.PP
گزینه‌ها در سه بخش مختلف پشتیبانی می‌شوند. خودِ گرداننده از گزینه‌هایی پشتیبانی می‌کند که فهرست آن‌ها در ادامه آمده است. همچنین \fIaction\fR (احتمالاً در ترکیب با \fIqualifier\fR) نیز از گزینه‌هایی پشتیبانی می‌کند که توضیحات آن‌ها در صفحه راهنمای دستور مربوطه یافت می‌شود. هر گزینه‌ای که برای اجرای دستور هدف مورد نیاز است، باید پس از نام هدف آورده شود.
.PP
برای نمونه، جهت گردآوری داده‌های کارایی برای برنامه‌ای با نام \&\fBa.out\fR و ذخیره نتایج در دایرکتوری آزمایش \fBmydata.er\fR، می‌توان دستور زیر را به کار برد:
.PP
.Vb 1
\&        $ gprofng collect app \-o mydata.er a.out \-t 2
.Ve
.PP
در این مثال، کنش برابر با \fBcollect\fR، توصیف‌کننده برابر با \fBapp\fR، تنها آرگومان داده‌شده به دستور \f(CW\*(C`\-o mydata.er\*(C'\fR و هدف نیز \&\fBa.out\fR است. دستور هدف با گزینه \fB\-t 2\fR فراخوانی شده است.
.PP
اگر gprofng بدون هیچ گزینه، کنش یا هدف اضافی اجرا شود، خلاصه‌ای از نحوه استفاده چاپ خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP \fI\-\-version\fR 4
.IX Item "--version"
چاپ شماره نسخه و خروج.
.IP \fI\-\-help\fR 4
.IX Item "--help"
نمایش اطلاعات نحوه استفاده و خروج.
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر پشتیبانی می‌شوند:
.IP \fBGPROFNG_MAX_CALL_STACK_DEPTH\fR 4
.IX Item "GPROFNG_MAX_CALL_STACK_DEPTH"
تنظیم عمق پشته فراخوانی (مقدار پیش‌فرض 256 است).
.IP \fBGPROFNG_USE_JAVA_OPTIONS\fR 4
.IX Item "GPROFNG_USE_JAVA_OPTIONS"
هنگام پروفایل‌بندی یک برنامه C/C++ که از تابع \fBdlopen()\fR برای اجرای کد جاوا استفاده می‌کند، می‌تواند تنظیم شود.
.IP \fBGPROFNG_ALLOW_CORE_DUMP\fR 4
.IX Item "GPROFNG_ALLOW_CORE_DUMP"
تنظیم این متغیر امکان تولید فایل تخلیه حافظه (Core Dump) را فراهم می‌کند؛ در غیر این صورت یک گزارش خطا در \fB/tmp\fR ایجاد می‌شود.
.IP \fBGPROFNG_ARCHIVE\fR 4
.IX Item "GPROFNG_ARCHIVE"
استفاده از این متغیر برای تعریف تنظیمات بایگانی خودکار پس از پایان ضبط آزمایش است.
.IP \fBGPROFNG_ARCHIVE_COMMON_DIR\fR 4
.IX Item "GPROFNG_ARCHIVE_COMMON_DIR"
تنظیم این متغیر به مکان بایگانی مشترک.
.IP \fBGPROFNG_JAVA_MAX_CALL_STACK_DEPTH\fR 4
.IX Item "GPROFNG_JAVA_MAX_CALL_STACK_DEPTH"
تنظیم عمق پشته فراخوانی جاوا؛ مقدار پیش‌فرض 256 است؛ برای غیرفعال کردن ضبط پشته‌های فراخوانی، مقدار آن را روی 0 قرار دهید.
.IP \fBGPROFNG_JAVA_NATIVE_MAX_CALL_STACK_DEPTH\fR 4
.IX Item "GPROFNG_JAVA_NATIVE_MAX_CALL_STACK_DEPTH"
تنظیم عمق پشته فراخوانی بومی (Native) جاوا؛ مقدار پیش‌فرض 256 است؛ برای غیرفعال کردن ضبط پشته‌های فراخوانی، مقدار آن را روی 0 قرار دهید (پشته‌های فراخوانی اسمبلی و JNI ثبت نمی‌شوند).
.IP \fBGPROFNG_SYSCONFDIR\fR 4
.IX Item "GPROFNG_SYSCONFDIR"
تنظیم مسیر فایل پیکربندی \fIgprofng.rc\fR. به‌طور پیش‌فرض، این فایل در زیرشاخه \fIetc\fR از دایرکتوری نصب binutils قرار دارد. در صورتی که برای نصب از یک بسته RPM استفاده شده باشد، این فایل در دایرکتوری \fI/etc\fR قرار دارد.
.Sp
هنگام ساخت و نصب از روی کد منبع، کاربر می‌تواند مسیر این فایل پیکربندی را به مکانی غیرپیش‌فرض تنظیم کند. در این صورت، کاربر می‌تواند متغیر محیطی \f(CW\*(C`GPROFNG_SYSCONFDIR\*(C'\fR را برای اشاره به این مکان تنظیم کند.
.Sp
در غیر این صورت، ابزارهای \fBgprofng display text\fR، \fBgprofng display src\fR و \fBgprofng archive\fR قادر به یافتن این فایل نخواهند بود.
.SH "نکات (NOTES)"
.IX Header "نکات (NOTES)"
گرداننده gprofng از دستورات زیر پشتیبانی می‌کند:
.PP
\&\fIگردآوری داده‌های کارایی:\fR
.ie n .IP """gprofng collect app""" 4
.el .IP "\f(CWgprofng collect app\fR" 4
.IX Item "gprofng collect app"
گردآوری داده‌های کارایی برنامه کاربردی.
.PP
\&\fIنمایش نتایج کارایی:\fR
.ie n .IP """gprofng display text""" 4
.el .IP "\f(CWgprofng display text\fR" 4
.IX Item "gprofng display text"
نمایش داده‌های کارایی در قالب اسکی (ASCII).
.ie n .IP """gprofng display html""" 4
.el .IP "\f(CWgprofng display html\fR" 4
.IX Item "gprofng display html"
تولید یک فایل HTML از یک یا چند آزمایش.
.ie n .IP """gprofng display gui""" 4
.el .IP "\f(CWgprofng display gui\fR" 4
.IX Item "gprofng display gui"
شروع رابط گرافیکی کاربری (GUI). توجه داشته باشید که این ابزار به‌طور پیش‌فرض موجود نیست و باید جداگانه نصب شود.
.PP
\&\fIدستورات متفرقه:\fR
.ie n .IP """gprofng display src""" 4
.el .IP "\f(CWgprofng display src\fR" 4
.IX Item "gprofng display src"
نمایش کد منبع یا دیس‌اسمبلی به همراه حاشیه‌نویسی‌های کامپایلر.
.ie n .IP """gprofng display gmon""" 4
.el .IP "\f(CWgprofng display gmon\fR" 4
.IX Item "gprofng display gmon"
تبدیل یک فایل \fIgmon.out\fR داده‌شده به آزمایش‌های gprofng.
.ie n .IP """gprofng archive""" 4
.el .IP "\f(CWgprofng archive\fR" 4
.IX Item "gprofng archive"
گنجاندن فایل‌های باینری و کد منبع درون دایرکتوری آزمایش.
.PP
فراخوانی مستقیم دستورات سطح پایین‌تر نیز ممکن است، اما از آنجا که این دستورات (به‌ویژه گزینه‌های آن‌ها) ممکن است دستخوش تغییر شوند، توصیه می‌کنیم از همین گرداننده استفاده کنید.
.PP
ابزار \fIgprofng GUI\fR یک ابزار اختیاری است که یک رابط گرافیکی را برای \f(CW\*(C`gprofng\*(C'\fR فراهم می‌آورد. استفاده از آن آسان بوده و از نماهای متعددی برای بررسی داده‌های کارایی پشتیبانی می‌کند. برای علاقه‌مندان به این رابط گرافیکی، پیشنهاد می‌کنیم عبارت \f(CW\*(C`gprofng\-gui\*(C'\fR را برای چگونگی دریافت، نصب و استفاده از آن جستجو کنند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBgprofng\-archive\fR\|(1),
\&\fBgprofng\-collect\-app\fR\|(1),
\&\fBgprofng\-display\-html\fR\|(1),
\&\fBgprofng\-display\-src\fR\|(1),
\&\fBgprofng\-display\-text\fR\|(1),
\&\fBgprofng\-display\-gmon\fR\|(1)
.PP
هر یک از دستورات gprofng نیز از گزینه \fB\-\-help\fR پشتیبانی می‌کنند. این گزینه فهرستی از گزینه‌ها و توضیح کوتاهی برای هر گزینه را نمایش می‌دهد.
.PP
برای نمونه، دستور زیر گزینه‌های پشتیبانی‌شده در دستور \&\fBgprofng collect app\fR را نمایش می‌دهد:
.PP
.Vb 1
\&        $ gprofng collect app \-\-help
.Ve
.PP
راهنمای کاربری gprofng به عنوان کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های \&\fBinfo\fR و \fBgprofng\fR به‌درستی نصب شده باشند، دستور \fBinfo gprofng\fR باید دسترسی به این سند را فراهم کند.
.SH "کپی‌رایت (COPYRIGHT)"
.IX Header "کپی‌رایت (COPYRIGHT)"
کپی‌رایت \(co 2022\-2026 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.