| GCOV-TOOL(1) | GNU | GCOV-TOOL(1) |
نام (NAME)
gcov-tool - ابزار پردازش برون‌خط (آفلاین) پروفایل‌های gcda
خلاصه دستور (SYNOPSIS)
gcov-tool [-v|--version] [-h|--help]
gcov-tool merge [merge-options] directory1
directory2
[-o|--output directory]
[-v|--verbose]
[-w|--weight w1,w2]
gcov-tool merge-stream [merge-stream-options] [file]
[-v|--verbose]
[-w|--weight w1,w2]
gcov-tool rewrite [rewrite-options] directory
[-n|--normalize long_long_value]
[-o|--output directory]
[-s|--scale float_or_simple-frac_value]
[-v|--verbose]
gcov-tool overlap [overlap-options] directory1
directory2
[-f|--function]
[-F|--fullname]
[-h|--hotonly]
[-o|--object]
[-t|--hot_threshold] float
[-v|--verbose]
توضیحات (DESCRIPTION)
gcov-tool یک ابزار برون‌خط (آفلاین) جهت پردازش فایل‌های پروفایل gcda متعلق به gcc است.
در حال حاضر gcov-tool از قابلیت‌های زیر پشتیبانی می‌کند:
- ادغام دو دسته از پروفایل‌ها با استفاده از وزن‌ها.
- خواندن جریانی از پروفایل‌ها به همراه نام‌های فایل مرتبط و ادغام آن با مجموعه‌ای از پروفایل‌ها به همراه وزن‌ها.
- خواندن یک دسته از پروفایل‌ها و بازنویسی محتویات پروفایل. کاربر می‌تواند مقادیر شمارنده را مقیاس‌بندی یا نرمال‌سازی کند.
نمونه‌هایی از کاربردهای این ابزار:
- جمع‌آوری پروفایل‌ها برای مجموعه‌های متفاوتی از ورودی‌ها، و استفاده از این ابزار برای ادغام آن‌ها. کاربر می‌تواند وزن را برای تعیین اهمیت نسبی هر ورودی مشخص کند.
- جمع‌آوری پروفایل‌ها از سیستم‌های مقصد بدون سیستم‌فایل (محیط‌های مستقل یا freestanding). ادغام پروفایل‌های جمع‌آوری‌شده با پروفایل‌های مرتبط موجود روی سیستم میزبان. کاربر می‌تواند ضریب وزنی مناسب را برای اهمیت نسبی هر ورودی مشخص نماید.
- بازنویسی پروفایل پس از حذف زیرمجموعه‌ای از فایل‌های gcda، در حین حفظ یکپارچگی خلاصه (summary) و بافت‌نگار (histogram).
- همچنین می‌توان از آن برای اشکال‌زدایی کدهای libgcov استفاده کرد زیرا بیشتر کدهای این ابزار با کتابخانه زمان اجرا مشترک است.
توجه داشته باشید که برای عملیات ادغام، این پروفایل تولیدشده برون‌خط ممکن است مقادیر اندکی متفاوت نسبت به پروفایل ادغام‌شده آنلاین داشته باشد. در زیر فهرستی از تفاوت‌های معمول آمده است:
- تفاوت در بافت‌نگار (histogram): این ابزار برون‌خط بافت‌نگار را پس از ادغام شمارنده‌ها مجدداً محاسبه می‌کند. بنابراین بافت‌نگار حاصل دقیق است. ادغام آنلاین این قابلیت را ندارد؛ یعنی بافت‌نگار از ادغام دو بافت‌نگار حاصل می‌شود و نتیجه تقریبی است.
- تفاوت در چک‌سام خلاصه: چک‌سام خلاصه از عملیات CRC32 استفاده می‌کند. مقدار آن به ترتیب لیست پیوندی اشیاء gcov-info بستگی دارد. این ترتیب در gcov-tool با ادغام آنلاین متفاوت است. وجود تفاوت در چک‌سام‌های خلاصه امری طبیعی و مورد انتظار است. این موضوع عملاً اهمیتی ندارد زیرا کامپایلر در هیچ کجایی از این چک‌سام استفاده نمی‌کند.
- تفاوت در مقادیر شمارنده پروفایل مقدار (value profile): برخی مقادیر شمارنده برای پروفایل مقدار وابسته به زمان اجرا هستند، مانند آدرس‌های هیپ (heap). مشاهده تفاوت در این‌گونه شمارنده‌ها طبیعی است.
گزینه‌ها (OPTIONS)
- -h
- --help
- نمایش راهنمای استفاده از gcov-tool (در خروجی استاندارد) و خروج بدون انجام هیچ‌گونه پردازش دیگر.
- -v
- --version
- نمایش شماره نگارش gcov-tool (در خروجی استاندارد) و خروج بدون انجام هیچ‌گونه پردازش دیگر.
- merge
- ادغام دو دایرکتوری پروفایل.
- -o directory
- --output directory
- تنظیم دایرکتوری خروجی پروفایل. نام پیش‌فرض دایرکتوری خروجی merged_profile است.
- -v
- --verbose
- تنظیم حالت پرگویی (نمایش جزئیات بیشتر).
- -w w1,w2
- --weight w1,w2
- تنظیم وزن‌های ادغام به ترتیب برای directory1 و directory2. وزن‌های پیش‌فرض برای هر دو برابر 1 است.
- merge-stream
- جمع‌آوری
پروفایل‌ها
به همراه
نام‌های
فایل مرتبط
از یک جریان
داده gcfn و gcda.
خواندن
جریان از
فایل
مشخص‌شده
با file یا از
stdin. ادغام
پروفایل‌ها
با
پروفایل‌های
مرتبط در
سیستم‌فایل
میزبان.
اعمال
وزن‌های
اختیاری در
هنگام
ادغام
پروفایل‌ها.
برای تولید جریان داده gcfn و gcda روی سیستم مقصد، لطفاً به توابع "__gcov_filename_to_gcfn()" و "__gcov_info_to_gcda()" که در "#include <gcov.h>" اعلان شده‌اند مراجعه فرمایید.
- -v
- --verbose
- تنظیم حالت پرگویی.
- -w w1,w2
- --weight w1,w2
- تنظیم وزن‌های ادغام به ترتیب برای پروفایل‌های حاصل از جریان داده gcfn و gcda و پروفایل‌های متناظر در سیستم‌فایل میزبان. وزن‌های پیش‌فرض برای هر دو 1 است.
- rewrite
- خواندن دایرکتوری پروفایل مشخص‌شده و بازنویسی آن در یک دایرکتوری جدید.
- -n long_long_value
- --normalize <long_long_value>
- نرمال‌سازی پروفایل. مقدار مشخص‌شده حداکثر مقدار شمارنده در پروفایل جدید خواهد بود.
- -o directory
- --output directory
- تنظیم دایرکتوری پروفایل خروجی. نام پیش‌فرض خروجی rewrite_profile است.
- -s float_or_simple-frac_value
- --scale float_or_simple-frac_value
- مقیاس‌بندی شمارنده‌های پروفایل. مقدار مشخص‌شده می‌تواند به صورت عدد ممیز شناور یا یک کسر ساده مانند 1، 2، 2/3 و 5/3 باشد.
- -v
- --verbose
- تنظیم حالت پرگویی.
- overlap
- محاسبه امتیاز همپوشانی میان دو دایرکتوری پروفایل مشخص‌شده. امتیاز همپوشانی بر پایه پروفایل‌های کمان (arc) محاسبه می‌شود. این امتیاز به صورت مجموع min (p1_counter[i] / p1_sum_all, p2_counter[i] / p2_sum_all) برای تمامی شمارنده‌های کمان i تعریف می‌شود، که در آن p1_counter[i] و p2_counter[i] دو شمارنده منطبق‌شده بوده و p1_sum_all و p2_sum_all به ترتیب مجموع مقادیر شمارنده در پروفایل 1 و پروفایل 2 هستند.
- -f
- --function
- چاپ امتیاز همپوشانی در سطح تابع.
- -F
- --fullname
- چاپ نام کامل فایل gcda.
- -h
- --hotonly
- تنها چاپ اطلاعات برای اشیاء یا توابع داغ (پربسامد).
- -o
- --object
- چاپ امتیاز همپوشانی در سطح شیء.
- -t float
- --hot_threshold <float>
- تنظیم مقدار آستانه برای شمارنده داغ.
- -v
- --verbose
- تنظیم حالت پرگویی.
همچنین ببینید (SEE ALSO)
gpl(7), gfdl(7), fsf-funding(7), gcc(1), gcov(1) و مدخل Info برای gcc.
حق نشر (COPYRIGHT)
حق نشر (c) 2014-2026 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
مجوز نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نگارش 1.3 یا هر نگارش بعدی منتشرشده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ با بخش‌های تغییرناپذیر «GNU General Public License» و «Funding Free Software»، و متون روی جلد (الف) (در زیر) و متون پشت جلد (ب) (در زیر). نسخه‌ای از این مجوز در صفحه راهنمای gfdl(7) گنجانده شده است.
(a) The FSF's Front-Cover Text is:
A GNU Manual
(b) The FSF's Back-Cover Text is:
You have freedom to copy and modify this GNU Manual, like GNU software. Copies published by the Free Software Foundation raise funds for GNU development.
| 2026-04-30 | gcc-16.1.0 |