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

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

تفاوت هیستوگرام: این ابزار آفلاین پس از ادغام شمارنده‌ها، هیستوگرام را مجدداً محاسبه می‌کند. بنابراین، هیستوگرام حاصل دقیق است. ادغام آنلاین این قابلیت را ندارد -- هیستوگرام از دو هیستوگرام ادغام می‌شود و نتیجه یک تقریب است.
تفاوت چک‌سام خلاصه: چک‌سام خلاصه از یک عملیات 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 به ترتیب مجموع مقادیر شمارنده‌ها در پروفایل ۱ و پروفایل ۲ هستند.

-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)، نگارش ۱٫۳ یا هر نگارش بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد (Free Software Foundation) اعطا می‌شود؛ با بخش‌های تغییرناپذیر «GNU General Public License» و «Funding Free Software»، متن‌های روی جلد (a) (زیر را ببینید) و متن‌های پشت جلد (b) (زیر را ببینید). یک نسخه از این مجوز در صفحهٔ راهنمای gfdl(7) گنجانده شده است.

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

A GNU Manual

(b) متن پشت جلد 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.