'\" t .\" Title: cg_annotate .\" Author: [see the "Author" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/11/2026 .\" Manual: cg_annotate .\" Source: Release 3.25.1 .\" Language: English .\" .TH "CG_ANNOTATE" "1" "08/11/2026" "Release 3\&.25\&.1" "cg_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)" cg_annotate \- ابزار پس‌پردازش برای Cachegrind .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBcg_annotate\fR\ 'u \fBcg_annotate\fR [\fIoptions\fR] \fIcachegrind\-out\-file\fR [\fIsource\-files\fR...] .SH "توضیحات (DESCRIPTION)" .PP \fBcg_annotate\fR یک یا چند فایل خروجی Cachegrind را دریافت کرده و داده‌های مربوط به برنامهٔ پروفایل‌شده را در قالبی خوانا چاپ می‌کند\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-h \-\-help \fR .RS 4 نمایش پیام راهنما\&. .RE .PP \fB\-\-version \fR .RS 4 نمایش شماره نسخه\&. .RE .PP \fB\-\-diff \fR .RS 4 مقایسه و تفاضل‌گیری (diff) میان دو فایل خروجی Cachegrind\&. .RE .PP \fB\-\-mod\-filename [پیش‌فرض: ندارد]\fR .RS 4 یک عبارت جستجو و جایگزینی \fBs/old/new/\fR مشخص می‌کند که بر روی تمامی نام‌های فایل اعمال می‌شود\&. این گزینه هنگام مقایسه برای حذف تفاوت‌های جزئی در مسیرها میان دو نسخهٔ مختلف از برنامه‌ای که در پوشه‌های متفاوتی قرار دارند مفید است\&. پسوند \fBi\fR عبارت باقاعده را به بزرگی و کوچکی حروف حساسیت‌زدایی می‌کند و پسوند \fBg\fR باعث تطابق آن در چندین تکرار می‌شود\&. .RE .PP \fB\-\-mod\-funcname [پیش‌فرض: ندارد]\fR .RS 4 مشابه \fB\-\-mod\-filename\fR، اما برای نام توابع\&. برای حذف تفاوت‌های جزئی در نام‌های تصادفی توابعی که به‌طور خودکار توسط برخی کامپایلرها تولید می‌شوند مفید است\&. .RE .PP \fB\-\-show=A,B,C [پیش‌فرض: all، با استفاده از ترتیب فایل خروجی Cachegrind] \fR .RS 4 مشخص می‌کند کدام رویدادها (و با چه ترتیبی از ستون‌ها) نمایش داده شوند\&. حالت پیش‌فرض استفاده از تمام موارد موجود در فایل خروجی Cachegrind (و بر اساس ترتیب درون فایل) است\&. بهتر است در کنار \fB\-\-sort\fR به‌کار رود\&. .RE .PP \fB\-\-sort=A,B,C [پیش‌فرض: ترتیب موجود در فایل خروجی Cachegrind] \fR .RS 4 رویدادهایی را تعیین می‌کند که مرتب‌سازی مدخل‌های file:function و function:file بر اساس آن‌ها انجام خواهد شد\&. .RE .PP \fB\-\-threshold=X [پیش‌فرض: 0\&.1%] \fR .RS 4 آستانهٔ اهمیت را برای بخش‌های file:function و function:files تنظیم می‌کند\&. یک فایل یا تابع در صورتی نمایش داده می‌شود که بیش از X% از شمارش‌های رویداد اصلی مرتب‌سازی را به خود اختصاص دهد\&. در صورت حاشیه‌نویسی فایل‌های مبدأ، این گزینه بر تعیین فایل‌هایی که حاشیه‌نویسی می‌شوند نیز اثر می‌گذارد\&. .RE .PP \fB\-\-show\-percs, \-\-no\-show\-percs, \-\-show\-percs= [پیش‌فرض: yes] \fR .RS 4 در صورت فعال بودن، در کنار شمارش تمامی رویدادها یک درصد چاپ می‌شود\&. این کار به سنجش اهمیت نسبی هر تابع و خط کمک می‌کند\&. .RE .PP \fB\-\-annotate, \-\-no\-annotate, \-\-auto= [پیش‌فرض: yes] \fR .RS 4 حاشیه‌نویسی فایل مبدأ را فعال یا غیرفعال می‌کند\&. .RE .PP \fB\-\-context=N [پیش‌فرض: 8] \fR .RS 4 تعداد خطوط پیرامونی (context) که باید قبل و بعد از هر خط حاشیه‌نویسی‌شده نمایش داده شوند\&. برای نمایش تمام خطوط فایل مبدأ، از یک عدد بزرگ (مانند 100000) استفاده کنید\&. .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 Nicholas Nethercote\&.