نام (NAME)

gprofng-display-gmon - نمایش و مقایسه دادههای پروفایلینگ gmon در قالبهای گوناگون

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

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

توضیحات (DESCRIPTION)

این دستور فایل gmon.out و فایل اجرایی پروفایل‌شده را می‌خواند. با تکیه بر فایل اجرایی، اطلاعات نمادهای تحلیل‌شده و چیدمان نگاشت حافظه بازسازی می‌شود. فایل gmon.out اطلاعاتی درباره مدت‌زمان اجرای هر نماد و داده‌های مورد نیاز برای ساخت گراف فراخوانی (Call Graph) فراهم می‌کند. این داده‌های پروفایلینگ از فایل گراف فراخوانی (به‌طور پیش‌فرض gmon.out) گردآوری می‌شوند؛ فایلی که حاصل اجرای برنامه‌های کامپایل‌شده با گزینه‌های پروفایل‌سازی (مانند گزینه -pg در کامپایلر cc) است.

برای نمونه، دستور زیر داده‌های پروفایلینگ (gmon.out) مربوط به فایل اجرایی a.out را به ساختار آزمایشی تبدیل کرده و اطلاعات را در پوشه‌ای با نام example.er ذخیره می‌کند:

$ gprofng display gmon -o example.er ./a.out gmon.out

گزینه‌ها (OPTIONS)

--version

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

--help

چاپ اطلاعات راهنمای کاربری و خروج.

-o <exp_name>

تعیین نام پوشه آزمایش (Experiment Directory). این نام باید به پسوند .er ختم شود و می‌تواند یک مسیر مطلق (مانند /tmp/experiment.er) داشته باشد. اگر پوشه آزمایشی با همین نام از قبل وجود داشته باشد، بازنویسی نخواهد شد.

-O <exp_name>

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

نکات (NOTES)

هر فایل اجرایی با قالب شیء ELF (کوتاه‌نوشت Executable and Linkable Format) را می‌توان برای پروفایل‌سازی با gprofng به کار برد. در صورت مشخص نشدن target، نام پیش‌فرض فایل اجرایی a.out خواهد بود. همچنین در صورت مشخص نشدن gmon-file، نام پیش‌فرض فایل داده‌های پروفایلینگ gmon.out در نظر گرفته می‌شود.

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

gprofng(1)، gprofng-archive(1)، gprofng-display-html(1)، gprofng-display-src(1)، gprofng-display-text(1).

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

حق نشر (COPYRIGHT)

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

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