'\" t
.\"     Title: Callgrind Annotate
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/11/2026
.\"    Manual: callgrind_annotate
.\"    Source: Release 3.25.1
.\"  Language: English
.\"
.TH "CALLGRIND ANNOTATE" "1" "08/11/2026" "Release 3\&.25\&.1" "callgrind_annotate"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
callgrind_annotate \- ابزار پس‌پردازش برای Callgrind
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBcallgrind_annotate\fR\ 'u
\fBcallgrind_annotate\fR [\fIoptions\fR] [\fIcallgrind\-out\-file\fR\ [\fIsource\-files\fR...]]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBcallgrind_annotate\fR
یک فایل خروجی تولیدشده توسط ابزار Callgrind در Valgrind را دریافت کرده و اطلاعات آن را در قالبی خوانا چاپ می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h \-\-help\fR
.RS 4
نمایش خلاصه‌ای از گزینه‌ها\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش نسخهٔ callgrind_annotate\&.
.RE
.PP
\fB\-\-show=A,B,C [پیش‌فرض: all]\fR
.RS 4
تنها نمایش ارقام برای رویدادهای A,B,C\&.
.RE
.PP
\fB\-\-threshold=<0\-\-100> [پیش‌فرض: 99%] \fR
.RS 4
درصد شمارش‌ها (از رویداد مرتب‌سازی اصلی) که مد نظر است\&.
.sp
هنگامی که مجموع درصدهای هزینهٔ توابع چاپ‌شده بزرگ‌تر یا مساوی با درصد آستانهٔ مشخص‌شده باشد، callgrind_annotate چاپ توابع را متوقف می‌کند\&.
.RE
.PP
\fB\-\-sort=A,B,C\fR
.RS 4
مرتب‌سازی ستون‌ها بر اساس رویدادهای A,B,C [ترتیب ستون رویداد]\&.
.sp
به‌صورت اختیاری، پس از هر رویداد یک : و یک مقدار آستانه قرار می‌گیرد تا آستانه‌های متفاوتی بسته به رویداد مشخص شود\&.
.sp
هنگامی که مجموع درصد هزینهٔ توابع چاپ‌شده برای تمام رویدادها بزرگ‌تر یا مساوی با درصدهای آستانهٔ مشخص‌شده برای رویدادها شود، callgrind_annotate چاپ توابع را متوقف می‌کند\&.
.sp
هنگامی که یک یا چند آستانه از طریق این گزینه مشخص شوند، مقدار
\fB\-\-threshold\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-\-show\-percs=<no|yes> [پیش‌فرض: no] \fR
.RS 4
در صورت فعال بودن، درصدی در کنار تمام شمارش‌های رویداد چاپ می‌شود\&. این کار به سنجش اهمیت نسبی هر تابع و خط کمک می‌کند\&.
.RE
.PP
\fB\-\-auto=<yes|no> [پیش‌فرض: yes] \fR
.RS 4
حاشیه‌نویسی تمام فایل‌های منبعی که حاوی توابعی هستند که به رسیدن به آستانهٔ شمارش رویداد کمک کرده‌اند\&.
.RE
.PP
\fB\-\-context=N [پیش‌فرض: 8] \fR
.RS 4
چاپ N خط از متن پیرامونی، پیش و پس از خطوط حاشیه‌نویسی‌شده\&.
.RE
.PP
\fB\-\-inclusive=<yes|no> [پیش‌فرض: no] \fR
.RS 4
افزودن هزینه‌های زیرروال به فراخوانی‌های توابع\&.
.RE
.PP
\fB\-\-tree=<none|caller|calling|both> [پیش‌فرض: none] \fR
.RS 4
چاپ فراخواننده‌ها، توابع فراخوانده‌شده، یا هر دو برای هر تابع\&.
.RE
.PP
\fB\-I, \-\-include=<dir> \fR
.RS 4
افزودن
\fBdir\fR
به فهرست دایرکتوری‌ها برای جستجوی فایل‌های منبع\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
valgrind(1),
$INSTALL/share/doc/valgrind/html/index\&.html
یا
http://www\&.valgrind\&.org/docs/manual/index\&.html\&.
.SH "نویسندگان (AUTHORS)"
.PP
Josef Weidendorfer <Josef\&.Weidendorfer@gmx\&.de>\&.
.PP
این صفحهٔ راهنما توسط Philipp Frauenfelder <pfrauenf@debian\&.org> نوشته شده است\&.