خلاصه دستور (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، زیرا این ابزار بخش عمده‌ای از کدها را با کتابخانه زمان اجرا به اشتراک می‌گذارد.

توجه داشته باشید که در عملیات ادغام، این پروفایلِ تولیدشده به‌صورت آفلاین ممکن است حاوی مقادیر کمی متفاوت نسبت به پروفایل ادغام‌شده به‌صورت آنلاین باشد. در اینجا فهرستی از تفاوت‌های معمول آورده شده است:

• تفاوت هیستوگرام: این ابزار آفلاین هیستوگرام را پس از ادغام شمارنده‌ها مجدداً محاسبه می‌کند. بنابراین هیستوگرام حاصل دقیق است. ادغام آنلاین چنین قابلیتی ندارد -- هیستوگرام از ادغام دو هیستوگرام حاصل می‌شود و نتیجه تقریبی است.
• تفاوت جمع‌وارسی (checksum) خلاصه: جمع‌وارسی خلاصه از عملیات CRC32 استفاده می‌کند. این مقدار به ترتیب پیوند لیست اشیاء gcov-info بستگی دارد. این ترتیب در gcov-tool با ادغام آنلاین متفاوت است. انتظار می‌رود که جمع‌وارسی‌های خلاصه متفاوتی حاصل شود. این موضوع اهمیتی ندارد زیرا کامپایلر در هیچ کجایی از این جمع‌وارسی استفاده نمی‌کند.
• تفاوت در مقادیر شمارنده پروفایل مقداری (value profile): برخی از مقادیر شمارنده برای پروفایل مقداری، به زمان اجرا وابسته هستند، مانند آدرس‌های حافظه heap. مشاهده تفاوت در این نوع شمارنده‌ها طبیعی است.

گزینه‌ها (OPTIONS)

-h

--help

نمایش راهنمای استفاده از gcov-tool (در خروجی استاندارد) و خروج بدون انجام هیچ پردازش دیگری.

-v

--version

نمایش شماره نسخه gcov-tool (در خروجی استاندارد) و خروج بدون انجام هیچ پردازش دیگری.

merge

ادغام دو دایرکتوری پروفایل.

merge-stream

جمع‌آوری پروفایل‌ها به همراه نام فایل‌های مربوطه از جریان داده gcfn و gcda. خواندن جریان از فایل مشخص‌شده توسط file یا از stdin. ادغام پروفایل‌ها با پروفایل‌های متناظر در سیستم‌فایل میزبان. اعمال وزن‌های اختیاری هنگام ادغام پروفایل‌ها.

برای تولید جریان داده gcfn و gcda روی سیستم مقصد، لطفاً به توابع "__gcov_filename_to_gcfn()" و "__gcov_info_to_gcda()" که در "#include <gcov.h>" اعلان شده‌اند توجه کنید.

rewrite

خواندن دایرکتوری پروفایل مشخص‌شده و بازنویسی آن در یک دایرکتوری جدید.

overlap

محاسبه امتیاز هم‌پوشانی بین دو دایرکتوری پروفایل مشخص‌شده. امتیاز هم‌پوشانی بر اساس پروفایل‌های کمان (arc profiles) محاسبه می‌شود. این امتیاز به‌صورت مجموع 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 به ترتیب مجموع مقادیر شمارنده در پروفایل ۱ و پروفایل ۲ هستند.

همچنین ببینید (SEE ALSO)

gpl(7)، gfdl(7)، fsf-funding(7)، gcc(1)، gcov(1) و مدخل Info برای gcc.

کپی‌رایت و تکثیر (COPYRIGHT)

Copyright (c) 2014-2025 Free Software Foundation, Inc.

اجازه نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخهٔ متأخرتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ با بخش‌های تغییرناپذیر شامل "GNU General Public License" و "Funding Free Software"، با متون روی جلد (الف) (در زیر آمده است)، و با متون پشت جلد (ب) (در زیر آمده است). یک نسخه از مجوز در صفحهٔ راهنمای gfdl(7) گنجانده شده است.

(الف) متن روی جلد FSF عبارت است از:

A GNU Manual

(ب) متن پشت جلد FSF عبارت است از:

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.