callgrind_control -
مشاهده و
کنترل
برنامه‌های
در حال اجرا
توسط Callgrind
callgrind_control [options]
[pid|program-name...]
callgrind_control
برنامه‌های
در حال اجرا
توسط ابزار
Callgrind از مجموعه
Valgrind را کنترل
می‌کند.
هنگامی که
آرگومان pid/program
name مشخص نشده
باشد، تمام
برنامه‌هایی
که در حال
حاضر توسط Callgrind
روی این
سیستم اجرا
می‌شوند،
برای
عملیات‌های
تعیین‌شده
با
گزینه(های)
مشخص به کار
گرفته
خواهند شد.
عمل
پیش‌فرض
این است که
اطلاعات
مختصری
درباره
برنامه‌های
در حال اجرا
توسط Callgrind
ارائه شود.
-h --help
نمایش
توضیحی
کوتاه،
نحوه
استفاده و
خلاصه‌ای
از
گزینه‌ها.
--version
نمایش
نسخه callgrind_control.
-l --long
علاوه بر
اطلاعات
مختصری که
به طور
پیش‌فرض
داده
می‌شود،
دایرکتوری
کاری را نیز
نمایش
می‌دهد.
-s --stat
نمایش
اطلاعات
آماری
درباره
اجراهای
فعال Callgrind.
-b --back
نمایش رد
پشته/ردیابی
به عقب (stack/back traces) هر
رشته (thread) در
اجراهای
فعال Callgrind. برای
هر تابع
فعال در رد
پشته،
همچنین
تعداد
فراخوانی‌ها
از زمان
شروع
برنامه (یا
آخرین dump)
نشان داده
می‌شود. این
گزینه
می‌تواند
با -e ترکیب
شود تا
هزینه
فراگیر (inclusive cost)
توابع فعال
را نشان
دهد.
-e [A,B,...]
(پیش‌فرض:
همه)
نمایش
مقادیر
هزینه
اختصاصی (exclusive cost)
فعلی
شمارنده‌های
رویداد به
ازای هر
رشته. اگر
هیچ نام
رویداد
صریحی داده
نشود، آمار
و ارقام
تمام انواع
رویدادهایی
که در اجرای
مشخص‌شده Callgrind
جمع‌آوری
شده‌اند،
نشان داده
می‌شوند. در
غیر این
صورت، تنها
آمار مربوط
به انواع
رویدادهای
A، B و ... نمایش
داده
می‌شود. در
صورتی که
این گزینه
با -b ترکیب
شود، هزینه
فراگیر (inclusive cost)
برای توابع
مربوط به هر
فریم پشته
فعال نیز
ارائه
می‌شود.
--dump[=<desc>]
(پیش‌فرض:
بدون
توضیحات)
درخواست
تخلیه (dump)
اطلاعات
پروفایل‌سازی.
به صورت
اختیاری،
می‌توان یک
شرح (description) مشخص
کرد که به
عنوان بخشی
از اطلاعات
بیانگر
دلیل
راه‌اندازی
عمل dump، در آن
نوشته
می‌شود. از
این مورد
می‌توان
برای تمایز
قائل شدن
میان چندین dump
استفاده
کرد.
-z --zero
صفر کردن
تمام
شمارنده‌های
رویداد.
-k --kill
اجبار به
خاتمه دادن
به یک اجرای
Callgrind.
--instr=<on|off>
روشن یا
خاموش کردن
حالت
ابزاردقیق‌سازی
(instrumentation). اگر در یک
اجرای Callgrind
حالت instrumentation
غیرفعال
باشد، هیچ
شبیه‌سازی
انجام
نمی‌شود و
هیچ
رویدادی
شمرده
نمی‌شود.
این ویژگی
برای
نادیده
گرفتن
بخش‌های
غیرمهم
برنامه
مفید است،
زیرا افت
سرعت بسیار
کمتری رخ
می‌دهد
(مشابه
ابزار "none" در
Valgrind). همچنین
گزینه --instr-atstart
در Callgrind را
ببینید.
--vgdb-prefix=<prefix>
مشخص
کردن
پیشوند vgdb
برای
استفاده
توسط callgrind_control.
ابزار callgrind_control در
داخل خود از
vgdb برای پیدا
کردن و
کنترل
اجراهای
فعال Callgrind
استفاده
می‌کند. اگر
از گزینه --vgdb-prefix
برای
راه‌اندازی
valgrind استفاده
شده باشد،
باید همان
گزینه به callgrind_control
نیز داده
شود.
Josef Weidendorfer <Josef.Weidendorfer@gmx.de>.
