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.

gcc-16.1.0                        2026-04-30                      GCOV-TOOL(1)