cg_annotate - ابزار
پس‌پردازش
برای Cachegrind
cg_annotate [options] cachegrind-out-file
[source-files...]
cg_annotate یک یا
چند فایل
خروجی Cachegrind را
دریافت
کرده و
داده‌های
مربوط به
برنامهٔ
پروفایل‌شده
را در قالبی
خوانا چاپ
می‌کند.
-h --help
نمایش
پیام
راهنما.
--version
نمایش
شماره
نسخه.
--diff
مقایسه و
تفاضل‌گیری
(diff) میان دو
فایل خروجی
Cachegrind.
--mod-filename <regex>
[پیش‌فرض:
ندارد]
یک عبارت
جستجو و
جایگزینی
s/old/new/ مشخص
می‌کند که
بر روی
تمامی
نام‌های
فایل اعمال
می‌شود. این
گزینه
هنگام
مقایسه
برای حذف
تفاوت‌های
جزئی در
مسیرها
میان دو
نسخهٔ
مختلف از
برنامه‌ای
که در
پوشه‌های
متفاوتی
قرار دارند
مفید است.
پسوند i
عبارت
باقاعده را
به بزرگی و
کوچکی حروف
حساسیت‌زدایی
می‌کند و
پسوند g
باعث تطابق
آن در چندین
تکرار
می‌شود.
--mod-funcname <regex>
[پیش‌فرض:
ندارد]
مشابه
--mod-filename، اما
برای نام
توابع. برای
حذف
تفاوت‌های
جزئی در
نام‌های
تصادفی
توابعی که
به‌طور
خودکار
توسط برخی
کامپایلرها
تولید
می‌شوند
مفید است.
--show=A,B,C
[پیش‌فرض: all،
با استفاده
از ترتیب
فایل خروجی
Cachegrind]
مشخص
می‌کند
کدام
رویدادها (و
با چه
ترتیبی از
ستون‌ها)
نمایش داده
شوند. حالت
پیش‌فرض
استفاده از
تمام موارد
موجود در
فایل خروجی
Cachegrind (و بر اساس
ترتیب درون
فایل) است.
بهتر است در
کنار --sort
به‌کار
رود.
--sort=A,B,C
[پیش‌فرض:
ترتیب
موجود در
فایل خروجی
Cachegrind]
رویدادهایی
را تعیین
می‌کند که
مرتب‌سازی
مدخل‌های file:function
و function:file بر اساس
آن‌ها
انجام
خواهد شد.
--threshold=X
[پیش‌فرض: 0.1%]
آستانهٔ
اهمیت را
برای
بخش‌های file:function
و function:files تنظیم
می‌کند. یک
فایل یا
تابع در
صورتی
نمایش داده
می‌شود که
بیش از X% از
شمارش‌های
رویداد
اصلی
مرتب‌سازی
را به خود
اختصاص دهد.
در صورت
حاشیه‌نویسی
فایل‌های
مبدأ، این
گزینه بر
تعیین
فایل‌هایی
که
حاشیه‌نویسی
می‌شوند
نیز اثر
می‌گذارد.
--show-percs, --no-show-percs, --show-percs=<no|yes>
[پیش‌فرض: yes]
در صورت
فعال بودن،
در کنار
شمارش
تمامی
رویدادها
یک درصد چاپ
می‌شود. این
کار به سنجش
اهمیت نسبی
هر تابع و خط
کمک
می‌کند.
--annotate, --no-annotate, --auto=<no|yes>
[پیش‌فرض: yes]
حاشیه‌نویسی
فایل مبدأ
را فعال یا
غیرفعال
می‌کند.
--context=N
[پیش‌فرض: 8]
تعداد
خطوط
پیرامونی (context)
که باید قبل
و بعد از هر
خط
حاشیه‌نویسی‌شده
نمایش داده
شوند. برای
نمایش تمام
خطوط فایل
مبدأ، از یک
عدد بزرگ
(مانند 100000)
استفاده
کنید.
