CALLGRIND ANNOTATE(1) callgrind_annotate CALLGRIND ANNOTATE(1)

callgrind_annotate - ابزار پس‌پردازش برای Callgrind

callgrind_annotate [options] [callgrind-out-file [source-files...]]

callgrind_annotate یک فایل خروجی تولیدشده توسط ابزار Callgrind در Valgrind را دریافت کرده و اطلاعات آن را در قالبی خوانا چاپ می‌کند.

-h --help

نمایش خلاصه‌ای از گزینه‌ها.

--version

نمایش نسخهٔ callgrind_annotate.

--show=A,B,C [پیش‌فرض: all]

تنها نمایش ارقام برای رویدادهای A,B,C.

--threshold=<0--100> [پیش‌فرض: 99%]

درصد شمارش‌ها (از رویداد مرتب‌سازی اصلی) که مد نظر است.

هنگامی که مجموع درصدهای هزینهٔ توابع چاپ‌شده بزرگ‌تر یا مساوی با درصد آستانهٔ مشخص‌شده باشد، callgrind_annotate چاپ توابع را متوقف می‌کند.

--sort=A,B,C

مرتب‌سازی ستون‌ها بر اساس رویدادهای A,B,C [ترتیب ستون رویداد].

به‌صورت اختیاری، پس از هر رویداد یک : و یک مقدار آستانه قرار می‌گیرد تا آستانه‌های متفاوتی بسته به رویداد مشخص شود.

هنگامی که مجموع درصد هزینهٔ توابع چاپ‌شده برای تمام رویدادها بزرگ‌تر یا مساوی با درصدهای آستانهٔ مشخص‌شده برای رویدادها شود، callgrind_annotate چاپ توابع را متوقف می‌کند.

هنگامی که یک یا چند آستانه از طریق این گزینه مشخص شوند، مقدار --threshold نادیده گرفته می‌شود.

--show-percs=<no|yes> [پیش‌فرض: no]

در صورت فعال بودن، درصدی در کنار تمام شمارش‌های رویداد چاپ می‌شود. این کار به سنجش اهمیت نسبی هر تابع و خط کمک می‌کند.

--auto=<yes|no> [پیش‌فرض: yes]

حاشیه‌نویسی تمام فایل‌های منبعی که حاوی توابعی هستند که به رسیدن به آستانهٔ شمارش رویداد کمک کرده‌اند.

--context=N [پیش‌فرض: 8]

چاپ N خط از متن پیرامونی، پیش و پس از خطوط حاشیه‌نویسی‌شده.

--inclusive=<yes|no> [پیش‌فرض: no]

افزودن هزینه‌های زیرروال به فراخوانی‌های توابع.

--tree=<none|caller|calling|both> [پیش‌فرض: none]

چاپ فراخواننده‌ها، توابع فراخوانده‌شده، یا هر دو برای هر تابع.

-I, --include=<dir>

افزودن dir به فهرست دایرکتوری‌ها برای جستجوی فایل‌های منبع.

valgrind(1), $INSTALL/share/doc/valgrind/html/index.html یا http://www.valgrind.org/docs/manual/index.html.

Josef Weidendorfer <Josef.Weidendorfer@gmx.de>.

این صفحهٔ راهنما توسط Philipp Frauenfelder <pfrauenf@debian.org> نوشته شده است.

08/11/2026 Release 3.25.1