نام (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].SH "توضیحات (DESCRIPTION)" gcov-tool یک ابزار آفلاین برای پردازش فایل‌های پروفایل gcda متعلق به gcc است.

در حال حاضر gcov-tool از قابلیت‌های زیر پشتیبانی می‌کند:

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

نمونه‌هایی از کاربردهای این ابزار عبارتند از:

جمع‌آوری پروفایل‌ها برای مجموعه‌های متفاوتی از ورودی‌ها، و استفاده از این ابزار برای ادغام آن‌ها. می‌توان برای لحاظ کردن اهمیت نسبی هر ورودی، وزن مشخص کرد.
جمع‌آوری پروفایل‌ها از سیستم‌های مقصد فاقد سامانه پرونده (محیط‌های مستقل یا freestanding). ادغام پروفایل‌های جمع‌آوری‌شده با پروفایل‌های متناظر موجود در سیستم میزبان. می‌توان برای در نظر گرفتن اهمیت نسبی هر ورودی، وزن مشخص کرد.
بازنویسی پروفایل پس از حذف زیرمجموعه‌ای از فایل‌های gcda، در حالی که سازگاری خلاصه (summary) و بافت‌نگار (histogram) حفظ شود.
همچنین می‌تواند برای اشکال‌زدایی کدهای libgcov به کار رود، زیرا بخش عمده‌ای از کد این ابزار با کتابخانه زمان اجرا مشترک است.

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

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

گزینه‌ها (OPTIONS)

-h
--help: نمایش راهنما درباره نحوه استفاده از gcov-tool (در خروجی استاندارد)، و خروج بدون انجام هیچ‌گونه پردازش دیگر.
-v
--version: نمایش شماره نسخه gcov-tool (در خروجی استاندارد)، و خروج بدون انجام هیچ‌گونه پردازش دیگر.
merge: ادغام دو دایرکتوری پروفایل.

-o directory
--output directory: تنظیم دایرکتوری خروجی پروفایل. نام دایرکتوری خروجی پیش‌فرض merged_profile است.
-v
--verbose: تنظیم حالت پرگو (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: تنظیم حالت پرگو (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: تنظیم حالت پرگو (verbose).

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 به ترتیب مجموع مقادیر شمارنده‌ها در پروفایل ۱ و پروفایل ۲ می‌باشند.

-f
--function: چاپ امتیاز هم‌پوشانی در سطح تابع..IP -F 4
--fullname: چاپ نام کامل فایل gcda.
-h
--hotonly: تنها چاپ اطلاعات مربوط به اشیاء/توابع پرکاربرد (hot).
-o
--object: چاپ امتیاز هم‌پوشانی در سطح شیء (object).
-t float
--hot_threshold <float>: تنظیم مقدار آستانه برای شمارنده پرکاربرد (hot counter).
-v
--verbose: فعال‌سازی حالت پرگو (verbose).

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

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

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

اجازه رونوشت‌برداری، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (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.