.TH GPROFNG\-DISPLAY\-HTML 1 "2026-08-11" "binutils-2.47" "دستورات کاربر"
.SH "نام (NAME)"
gprofng\-display\-html \- تولید گزارشهای وب و ساختار HTML از دادههای پروفایلینگ gprofng
.SH "خلاصه دستور (SYNOPSIS)"
.B gprofng display html
[\fIگزینهها\fR] \fIآزمایش(ها)\fR
.SH "توضیحات (DESCRIPTION)"
دستور
.B gprofng display html
دادههای حاصل از یک یا چند آزمایش (پروفایلینگ با ابزار gprofng) را پردازش کرده و یک دایرکتوری شامل فایل
.I index.html
تولید میکند. با باز کردن این فایل در مرورگر وب، میتوانید دادههای به دست آمده از تحلیل کارایی برنامه را بهصورت تعاملی و ساختاریافته مشاهده و بررسی کنید.
.SH "گزینهها (OPTIONS)"
.TP
\fB\-\-version\fR
نمایش شماره نسخه برنامه و خروج.
.TP
\fB\-\-help\fR
نمایش اطلاعات نحوه استفاده از دستور و خروج.
.TP
\fB\-\-verbose\fR
فعالسازی حالت پرگویی (Verbose) جهت نمایش پیامهای تشخیصی درباره روند پردازش دادهها. این حالت بهطور پیشفرض غیرفعال است.
.TP
\fB\-d\fR [\fIdb\-vol\-size\fR], \fB\-\-\debug\fR[=\fIdb\-vol\-size\fR]
کنترل چاپ اطلاعات اشکالزدایی حین اجرا جهت کمک به عیبیابی یا توسعه برنامه.
.PP
پارامتر
.I db\-vol\-size
حجم خروجی اطلاعات اشکالزدایی را مشخص میکند و یکی از مقادیر زیر را میپذیرد:
.BR s ،
.BR S ،
.BR m ،
.BR M ،
.BR l ،
.BR L ،
.B xl
یا
.BR XL .
در صورتی که
.I db\-vol\-size
تعیین نشود، حجم ملایمی از اطلاعات نمایش داده میشود که معادل انتخاب
.B s
یا
.B S
است. با انتخاب نمادهای بزرگتر، حجم دادههای خروجی افزایش مییابد. در حال حاضر مقدار
.B l/L
معادل
.B xl/XL
عمل میکند، اما در نگارشهای آینده تفکیک خواهد شد. حالت اشکالزدایی بهطور پیشفرض غیرفعال است.
.TP
\fB\-\-\highlight\-percentage=\fR\fIvalue\fR
تنظیم یک مقدار درصدی در بازه [0,100] برای تفکیک رنگی و برجستهسازی خطوط کد منبع و دستورالعملهای اسمبلی که در این محدوده درصدی از بیشینه مقادیر سنجه (Metric) قرار دارند. مقدار پیشفرض 90 (درصد) است. مقدار صفر این قابلیت را غیرفعال میکند.
.TP
\fB\-o\fR \fIdirname\fR, \fB\-\-\output=\fR\fIdirname\fR
استفاده از
.I dirname
بهعنوان نام دایرکتوری ذخیره نتایج. در صورت مشخص نکردن این گزینه، نام پیشفرض دایرکتوری به شکل
.B display..html
در دایرکتوری جاری خواهد بود که در آن
.I
اولین عدد صحیح مثبتی است که بر اساس این الگوی نامگذاری استفاده نشده باشد. در صورتی که دایرکتوری با همین نام از قبل وجود داشته باشد، رونویسی نمیشود؛ برنامه یک پیام خطا چاپ کرده و متوقف میشود.
.TP
\fB\-O\fR \fIdirname\fR, \fB\-\-\overwrite=\fR\fIdirname\fR
استفاده از
.I dirname
بهعنوان نام دایرکتوری ذخیره نتایج. در صورت عدم تعیین این گزینه، نام پیشفرض دایرکتوری به صورت
.B display..html
در دایرکتوری جاری در نظر گرفته میشود که در آن
.I
اولین عدد صحیح مثبتی است که با این الگو استفاده نشده باشد. اگر دایرکتوری با این نام از قبل موجود باشد، بدون هیچ هشداری بازنویسی (Overwrite) خواهد شد.
.TP
\fB\-q\fR, \fB\-\-\quiet\fR
غیرفعالسازی نمایش تمام پیامهای هشدار، اشکالزدایی، پرگویی و سایر پیامها. در صورت فعال بودن این گزینه، تنظیمات مربوط به
.B \-\-\verbose
و
.B \-\-\debug
پذیرفته میشوند اما نادیده گرفته خواهند شد. با اعمال این گزینه، خروجی خط فرمان به جز پیامهای خطا کاملاً خاموش میشود. حالت بیصدا بهطور پیشفرض غیرفعال است.
.TP
\fB\-\-\nowarnings\fR
غیرفعال کردن چاپ پیامهای هشدار در خروجی استاندارد (stdout). پیامهای هشدار بهطور پیشفرض در خروجی نمایش داده میشوند.
.SH "نکات (NOTES)"
.IP \(bu 4
گزینهها و مقادیر به کوچک و بزرگ بودن حروف حساس هستند (Case-sensitive).
.IP \(bu 4
در این نگارش، ساختار نحوی گزینهها بازبینی شده تا هماهنگی بیشتری با سایر ابزارها و دستورات استاندارد لینوکس داشته باشد:
.PP
گزینههایی که پیش از این صرفاً مقادیر
.B on
یا
.B off
دریافت میکردند، اکنون مانند یک کلید سوییچ عمل کرده و حالت پیشفرض را معکوس میکنند. برای مثال، حالت پرگویی بهطور پیشفرض خاموش است و با ذکر گزینه
.B \-\-\verbose
روشن میشود.
.PP
در گزینههای بلند (گزینههایی که با
.B \-\-\
شروع میشوند) و نیازمند دریافت مقدار هستند، باید علامت مساوی
.RB ( = )
میان نام گزینه و مقدار آن درج شود.
.PP
با وجود اینکه نحو و مقادیر قدیمی هنوز در برنامه پذیرفته میشوند، اکیداً توصیه میشود نحوه استفاده از گزینهها را به ساختار جدید ارتقا دهید؛ چرا که ممکن است در نگارشهای آینده پشتیبانی از این تنظیمات قدیمی متوقف شود.
.PP
برای تسهیل روند این تغییرات، در صورت استفاده از نحو یا مقادیر قدیمی، یک پیام هشدار روی ترمینال نمایش داده میشود.
.IP \(bu 4
گزینه
.B \-hp
هنوز معتبر است و کار میکند، ولی در نگارشهای آینده منسوخ خواهد شد. بهتر است بهجای آن از گزینه
.B \-\-\highlight\-percentage
استفاده کنید.
.IP \(bu 4
هنگام مشخص کردن نام دایرکتوری برای ذخیره فایلهای HTML، اطمینان حاصل کنید که ماسک دسترسی کاربر
.RB ( umask )
بهگونهای تنظیم شده باشد که مجوزهای دسترسی لازم فراهم شود.
.IP \(bu 4
صرفنظر از تنظیمات فعال یا غیرفعال بودن نمایش پیامهای هشدار در خط فرمان، اگر هشداری رخ دهد همواره از طریق صفحه اصلی
.I index.html
قابل دسترسی و مشاهده است.
.IP \(bu 4
این ابزار تلاش میکند پیش از انجام هر اقدامی، تا حد امکان هشدارها و خطاهای رخداده را گردآوری کند تا رسیدگی همزمان به چندین مورد آسانتر باشد. در نتیجه این رفتار، ممکن است پیامها در همان لحظه رخ دادن نمایش داده نشوند؛ بهویژه هشدارها که عموماً در اواخر پردازش ظاهر میشوند، اما در صورت بروز خطا، برنامه بدون آغاز پردازش بلافاصله متوقف خواهد شد.
.SH "همچنین ببینید (SEE ALSO)"
.BR gprofng (1),
.BR gprofng\-archive (1),
.BR gprofng\-collect\-app (1),
.BR gprofng\-display\-src (1),
.BR gprofng\-display\-text (1)
.PP
راهنمای کاربری جامع
.B gprofng
بهصورت راهنمای Texinfo نگهداری میشود. چنانچه ابزارهای
.B info
و
.B gprofng
بهدرستی روی سیستم نصب شده باشند، دستور زیر این راهنما را در اختیارتان قرار میدهد:
.PP
.nf
info gprofng
.fi
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co ۲۰۲۲\-۲۰۲۶ بنیاد نرمافزارهای آزاد (Free Software Foundation, Inc.)
.PP
مجوز کپی، توزیع یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرمافزارهای آزاد صادر شده است؛ بدون بخشهای تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.