'\" t .\" Title: Callgrind Control .\" Author: [see the "Author" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/11/2026 .\" Manual: callgrind_control .\" Source: Release 3.25.1 .\" Language: Persian .\" .TH "CALLGRIND CONTROL" "1" "08/11/2026" "Release 3\&.25\&.1" "callgrind_control" .\" ----------------------------------------------------------------- .\" * 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_control \- مشاهده و کنترل برنامه‌های در حال اجرا توسط Callgrind .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBcallgrind_control\fR\ 'u \fBcallgrind_control\fR [\fIoptions\fR] [\fIpid|program\-name\fR...] .SH "توضیحات (DESCRIPTION)" .PP \fBcallgrind_control\fR برنامه‌های در حال اجرا توسط ابزار Callgrind از مجموعه Valgrind را کنترل می‌کند\&. هنگامی که آرگومان \fBpid/program name\fR مشخص نشده باشد، تمام برنامه‌هایی که در حال حاضر توسط Callgrind روی این سیستم اجرا می‌شوند، برای عملیات‌های تعیین‌شده با گزینه(های) مشخص به کار گرفته خواهند شد\&. عمل پیش‌فرض این است که اطلاعات مختصری درباره برنامه‌های در حال اجرا توسط Callgrind ارائه شود\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-h \-\-help\fR .RS 4 نمایش توضیحی کوتاه، نحوه استفاده و خلاصه‌ای از گزینه‌ها\&. .RE .PP \fB\-\-version\fR .RS 4 نمایش نسخه callgrind_control\&. .RE .PP \fB\-l \-\-long\fR .RS 4 علاوه بر اطلاعات مختصری که به طور پیش‌فرض داده می‌شود، دایرکتوری کاری را نیز نمایش می‌دهد\&. .RE .PP \fB\-s \-\-stat\fR .RS 4 نمایش اطلاعات آماری درباره اجراهای فعال Callgrind\&. .RE .PP \fB\-b \-\-back\fR .RS 4 نمایش رد پشته/ردیابی به عقب (stack/back traces) هر رشته (thread) در اجراهای فعال Callgrind\&. برای هر تابع فعال در رد پشته، همچنین تعداد فراخوانی‌ها از زمان شروع برنامه (یا آخرین dump) نشان داده می‌شود\&. این گزینه می‌تواند با \-e ترکیب شود تا هزینه فراگیر (inclusive cost) توابع فعال را نشان دهد\&. .RE .PP \fB\-e [A,B,\&.\&.\&.] \fR (پیش‌فرض: همه) .RS 4 نمایش مقادیر هزینه اختصاصی (exclusive cost) فعلی شمارنده‌های رویداد به ازای هر رشته\&. اگر هیچ نام رویداد صریحی داده نشود، آمار و ارقام تمام انواع رویدادهایی که در اجرای مشخص‌شده Callgrind جمع‌آوری شده‌اند، نشان داده می‌شوند\&. در غیر این صورت، تنها آمار مربوط به انواع رویدادهای A، B و \&.\&.\&. نمایش داده می‌شود\&. در صورتی که این گزینه با \-b ترکیب شود، هزینه فراگیر (inclusive cost) برای توابع مربوط به هر فریم پشته فعال نیز ارائه می‌شود\&. .RE .PP \fB\-\-dump[=] \fR (پیش‌فرض: بدون توضیحات) .RS 4 درخواست تخلیه (dump) اطلاعات پروفایل‌سازی\&. به صورت اختیاری، می‌توان یک شرح (description) مشخص کرد که به عنوان بخشی از اطلاعات بیانگر دلیل راه‌اندازی عمل dump، در آن نوشته می‌شود\&. از این مورد می‌توان برای تمایز قائل شدن میان چندین dump استفاده کرد\&. .RE .PP \fB\-z \-\-zero\fR .RS 4 صفر کردن تمام شمارنده‌های رویداد\&. .RE .PP \fB\-k \-\-kill\fR .RS 4 اجبار به خاتمه دادن به یک اجرای Callgrind\&. .RE .PP \fB\-\-instr=\fR .RS 4 روشن یا خاموش کردن حالت ابزاردقیق‌سازی (instrumentation)\&. اگر در یک اجرای Callgrind حالت instrumentation غیرفعال باشد، هیچ شبیه‌سازی انجام نمی‌شود و هیچ رویدادی شمرده نمی‌شود\&. این ویژگی برای نادیده گرفتن بخش‌های غیرمهم برنامه مفید است، زیرا افت سرعت بسیار کمتری رخ می‌دهد (مشابه ابزار "none" در Valgrind)\&. همچنین گزینه \fB\-\-instr\-atstart\fR در Callgrind را ببینید\&. .RE .PP \fB\-\-vgdb\-prefix=\fR .RS 4 مشخص کردن پیشوند vgdb برای استفاده توسط callgrind_control\&. ابزار callgrind_control در داخل خود از vgdb برای پیدا کردن و کنترل اجراهای فعال Callgrind استفاده می‌کند\&. اگر از گزینه \fB\-\-vgdb\-prefix\fR برای راه‌اندازی valgrind استفاده شده باشد، باید همان گزینه به callgrind_control نیز داده شود\&. .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 \&.