.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "LCOV" "1" "2026-07-07" "2.5" "LCOV" .SH "نام (NAME)" lcov \- ابزار گرافیکی و خط فرمانی استخراج و مدیریت پوشش کد GCOV .SH "خلاصه دستور (SYNOPSIS)" .sp استخراج فایل ردگیری داده‌های پوشش کد (از داده‌های تولیدشده توسط کامپایلر). قالب فایل ردگیری lcov (فایل «.info») در \fBgeninfo(1) \%\fP\& شرح داده شده است. .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-c | \-\-capture [ \-d | \-\-directory *directory* ] [ \-k | \-\-kernel\-directory *directory* ] [ \-o | \-\-output\-file *tracefile* ] [ \-t | \-\-test\-name *testname* ] [ \-b | \-\-base\-directory *directory* ] [ \-\-build\-directory *directory* ] [ \-\-source\-directory *directory* ] [ \-i | \-\-initial ] [ \-\-all ] [ \-\-gcov\-tool *tool* ] [ \-\-branch\-coverage ] [ \-\-mcdc\-coverage ] [ \-\-demangle\-cpp [ *param* ] ] [ \-\-checksum ] [ \-\-no\-checksum ] [ \-\-no\-recursion ] [ \-f | \-\-follow ] [ \-\-sort\-input ] [ \-\-compat\-libtool ] [ \-\-no\-compat\-libtool ] [ \-\-msg\-log [ *log_file_name* ] ] [ \-\-ignore\-errors *errors* ] [ \-\-expect\-message\-count *message_type=expr[,message_type=expr..]* ] [ \-\-preserve ] [ \-\-to\-package *package* ] [ \-\-from\-package *package* ] [ \-\-no\-markers ] [ \-\-external ] [ \-\-no\-external ] [ \-\-compat *mode*\e =on|off|auto] [ \-\-context\-script *script_file* ] [ \-\-criteria\-script *script_file* ] [ \-\-history\-script *callback* ] [ \-\-resolve\-script *script_file* ] [ \-\-version\-script *script_file* ] [ \-\-unreachable\-script *callback* ] [ \-\-comment *comment_string* ] [ \-\-large\-file *regexp* ] .EE .UNINDENT .UNINDENT .sp تولید فایل ردگیری (از داده‌های تولیدشده توسط کامپایلر) با صفر کردن مقادیر تمام شمارنده‌ها: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-z | \-\-zerocounters [ \-d | \-\-directory *directory* ] [ \-\-no\-recursion ] [ \-f | \-\-follow ] .EE .UNINDENT .UNINDENT .sp نمایش شمارش‌های پوشش ثبت‌شده در فایل‌های ردگیری پیش‌تر تولیدشده: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-l | \-\-list *tracefile* [ \-\-list\-full\-path ] [ \-\-no\-list\-full\-path ] .EE .UNINDENT .UNINDENT .sp تجمیع چندین فایل ردگیری پوشش در یک فایل: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-a | \-\-add\-tracefile *tracefile_patterns* [ \-o | \-\-output\-file *tracefile* ] [ \-\-prune\-tests ] [ \-\-forget\-test\-names ] [ \-\-map\-functions ] [ \-\-branch\-coverage ] [ \-\-mcdc\-coverage ] [ \-\-checksum ] [ \-\-no\-checksum ] [ \-\-sort\-input ] .EE .UNINDENT .UNINDENT .sp بسته به مدل استفاده شما، ممکن است نیازی به ایجاد فایل‌های داده پوشش تجمیعی نباشد. به‌عنوان مثال، اگر آزمون‌های رگرسیون شما به چندین مجموعه (suite) تقسیم شده باشند، ممکن است بخواهید داده‌های هر مجموعه را جداگانه نگه دارید و نتایج هر مجموعه و نتایج تجمیعی را در طول زمان با یکدیگر مقایسه کنید. دستور \fBgenhtml\fP به شما اجازه می‌دهد فایل‌های ردگیری را از طریق یک یا چند الگوی glob مشخص کنید \- که امکان تولید گزارش‌های تجمیعی را بدون تولید صریح فایل‌های ردگیری تجمیع‌شده فراهم می‌کند. صفحه راهنمای \fBgenhtml\fP را ببینید. .sp تولید فایل ردگیری جدید از فایل ردگیری موجود، فقط با حفظ داده‌های فایل‌های منطبق بر الگو: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-e | \-\-extract *tracefile pattern* [ \-o | \-\-output\-file *tracefile* ] [ \-\-checksum ] [ \-\-no\-checksum ] .EE .UNINDENT .UNINDENT .sp تولید فایل ردگیری جدید از فایل ردگیری موجود، با حذف داده‌های فایل‌های منطبق بر الگو: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-r | \-\-remove *tracefile pattern* [ \-o | \-\-output\-file *tracefile* ] [ \-\-checksum ] [ \-\-no\-checksum ] .EE .UNINDENT .UNINDENT .sp تولید فایل ردگیری جدید از فایل‌های ردگیری موجود با انجام عملیات مجموعه‌ها روی داده‌های پوشش کد: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-\-intersect *rh_glob_pattern* [ \-o | \-\-output\-file *tracefile* ] lh_glob_pattern .EE .UNINDENT .UNINDENT .sp خروجی منعکس‌کننده .INDENT 0.0 .INDENT 3.5 \fI(اجتماع فایل‌های منطبق با lh_glob_patterns)\fP \fIاشتراک\fP \fI(اجتماع فایل‌های منطبق با rh_glob_patterns)\fP .UNINDENT .UNINDENT .sp خواهد بود، به‌طوری که نقاط پوشش (coverpoints) یافت‌شده در هر دو مجموعه ادغام (جمع) می‌شوند، در حالی که نقاط پوشش یافت‌شده در تنها یکی از مجموعه‌ها کنار گذاشته می‌شوند. توجه داشته باشید که بلوک‌های انشعاب (branch blocks) یکسان در نظر گرفته می‌شوند اگر و فقط اگر شناسه بلوک و فهرست عبارات انشعاب مرتبط با آن‌ها یکسان باشد. توابع نیز در صورتی یکسان در نظر گرفته می‌شوند که نام و مکان آن‌ها یکسان باشد. .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-\-subtract *rh_glob_pattern* [ \-o | \-\-output\-file *tracefile* ] lh_glob_pattern .EE .UNINDENT .UNINDENT .sp خروجی منعکس‌کننده .INDENT 0.0 .INDENT 3.5 \fI(اجتماع فایل‌های منطبق با lh_glob_patterns)\fP \fIتفاضل\fP \fI(اجتماع فایل‌های منطبق با rh_glob_patterns)\fP .UNINDENT .UNINDENT .sp خواهد بود، به‌طوری که فقط نقاط پوشش یافت‌شده در مجموعه سمت چپ نگهداری شده و سایر موارد حذف می‌شوند. .sp خلاصه‌سازی محتوای فایل ردگیری: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov \-\-summary *tracefile* .EE .UNINDENT .UNINDENT .sp چاپ نسخه یا پیام راهنما و خروج: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov [ \-h | \-\-help ] [ \-\-version ] .EE .UNINDENT .UNINDENT .sp گزینه‌های عمومی lcov \- پشتیبانی‌شده در تمام موارد کاربرد بالا: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov [ \-\-keep\-going ] [ \-\-filter *type* ] [ \-q | \-\-quiet ] [ \-v | \-\-verbose ] [ \-\-comment *comment_string* ] [ \-\-debug ] [ \-\-parallel | \-j [*integer*] ] [ \-\-memory *integer_num_Mb* ] [ \-\-tempdir *dirname* ] [ \-\-branch\-coverage ] [ \-\-mcdc\-coverage ] [ \-\-config\-file *config\-file* ] [ \-\-rc *keyword*\e =\e *value* ] [ \-\-profile [ *profile\-file* ] ] [ \-\-include *glob_pattern* ] [ \-\-exclude *glob_pattern* ] [ \-\-erase\-functions *regexp_pattern* ] [ \-\-substitute *regexp_pattern* ] [ \-\-omit\-lines *regexp_pattern* ] [ \-\-fail\-under\-branches *percentage* ] [ \-\-fail\-under\-lines *percentage* ] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp برنامه \fBlcov\fP یک رابط کاربری گرافیکی برای ابزار آزمون پوشش کد gcov در GCC است. این ابزار داده‌های پوشش خطوط، توابع و انشعاب‌ها را برای چندین فایل منبع جمع‌آوری کرده و صفحات HTML شامل کدهای منبع حاشیه‌نویسی‌شده با اطلاعات پوشش کد را ایجاد می‌کند. همچنین صفحاتی برای نمای کلی جهت ناوبری آسان در ساختار فایل‌ها اضافه می‌نماید. .sp از \fBlcov\fP برای جمع‌آوری داده‌های پوشش و از \fBgenhtml\fP برای ایجاد صفحات HTML استفاده کنید. داده‌های پوشش می‌توانند از هسته لینوکس در حال اجرا یا از برنامه‌های فضای کاربر جمع‌آوری شوند. برای انجام این کار، باید مراحل آماده‌سازی زیر را طی کنید: .sp برای پوشش کد هسته لینوکس: .INDENT 0.0 .INDENT 3.5 دستورالعمل‌های راه‌اندازی زیرساخت gcov\-kernel را دنبال کنید: \fIhttps://docs.kernel.org/dev\-tools/gcov.html\fP .UNINDENT .UNINDENT .sp برای پوشش کد برنامه‌های فضای کاربر: .INDENT 0.0 .INDENT 3.5 برنامه را با GCC و با استفاده از گزینه‌های «\-fprofile\-arcs» و «\-ftest\-coverage» یا «–coverage» کامپایل کنید. .UNINDENT .UNINDENT .sp لطفاً توجه داشته باشید که در این صفحه راهنما، قالب خروجی \fBlcov\fP به عنوان «فایل .info» یا «tracefile» نامیده می‌شود و خروجی GCOV «فایل .da» خوانده می‌شود. .sp همچنین توجه داشته باشید که هنگام چاپ درصدها، مقادیر 0% و 100% تنها زمانی چاپ می‌شوند که مقادیر دقیقاً برابر با 0% و 100% باشند. سایر مقادیری که به طور معمول به 0% یا 100% گرد می‌شوند، در عوض به عنوان نزدیک‌ترین مقدار غیرمرزی چاپ می‌گردند. این رفتار مطابق با رفتار ابزار \fBgcov(1) \%\fP است. .sp به‌طور پیش‌فرض، \fBlcov\fP و ابزارهای مرتبط، داده‌های پوشش خط و تابع را تولید و جمع‌آوری می‌کنند. داده‌های انشعاب به‌طور پیش‌فرض جمع‌آوری یا نمایش داده نمی‌شوند؛ تمام ابزارها به ترتیب از گزینه‌های \fB\-\-branch\-coverage\fP و \fB\-\-mcdc\-coverage\fP برای فعال‌سازی پوشش انشعاب و MC/DC پشتیبانی می‌کنند \- یا می‌توانید با افزودن تنظیمات مناسب به فایل پیکربندی lcov شخصی، گروهی یا سیستمی خود، پوشش انشعاب را به‌طور دائمی فعال کنید. برای جزئیات به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه نمایید. .SH "گزینه‌ها (OPTIONS)" .sp به‌طور کلی، (تقریباً) تمام گزینه‌های \fBlcov\fP را می‌توان در یک فایل پیکربندی نیز مشخص کرد \- برای جزئیات به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .sp \fB\-a\fP \fItracefile_patterns\fP \fB\-\-add\-tracefile\fP \fItracefile_patterns\fP .INDENT 0.0 .INDENT 3.5 افزودن محتوای تمام فایل‌های منطبق با الگوی سراسری \fItracefile_patterns\fP\&. .sp با استفاده از گزینه \-a چندین فایل ردگیری (tracefile) را مشخص کنید تا داده‌های پوشش موجود در این فایل‌ها با جمع زدن تعداد دفعات اجرا برای ترکیب‌های منطبق تست و نام فایل با یکدیگر ترکیب شوند. .sp نتیجه عملیات افزودن در خروجی استاندارد (stdout) یا فایل ردگیری مشخص‌شده با \-o نوشته خواهد شد. .sp در هر زمان فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l یا –summary را می‌توان مشخص کرد. .UNINDENT .UNINDENT .sp \fB\-b\fP \fIdirectory\fP \fB\-\-base\-directory\fP \fIdirectory\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fIdirectory\fP به‌عنوان دایرکتوری پایه برای مسیرهای نسبی. .sp از این گزینه برای تعیین دایرکتوری پایه محیط ساخت (build-environment) زمانی که lcov پیام‌های خطایی مانند زیر تولید می‌کند استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX ERROR: could not read source file /home/user/project/subdir1/subdir2/subdir1/subdir2/file.c .EE .UNINDENT .UNINDENT .sp در این مثال، از /home/user/project به‌عنوان دایرکتوری پایه استفاده کنید. .sp این گزینه هنگام استفاده از lcov در پروژه‌های ساخته‌شده با libtool یا محیط‌های ساخت مشابه که با یک دایرکتوری پایه کار می‌کنند لازم است؛ \fIیعنی\fP محیط‌هایی که در آن‌ها دایرکتوری کاری جاری هنگام فراخوانی کامپایلر، با دایرکتوری محل قرارگیری فایل کد منبع یکسان نیست. .sp توجه داشته باشید که این گزینه در محیط‌هایی که از چندین دایرکتوری پایه استفاده می‌کنند کار نخواهد کرد. در این حالت از تنظیم فایل پیکربندی \fBgeninfo_auto_base=1\fP استفاده کنید (به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید). .UNINDENT .UNINDENT .sp \fB\-\-build\-directory\fP \fIbuild_directory\fP .INDENT 0.0 .INDENT 3.5 جستجو برای فایل‌های داده .gcno از build_directory به‌جای جستجو در کنار فایل متناظر .gcda. .sp برای جزئیات بیشتر به صفحه راهنمای \fBgeninfo(1) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-source\-directory\fP \fIdirname\fP .INDENT 0.0 .INDENT 3.5 افزودن ‘dirname’ به فهرست مکان‌های جستجوی فایل‌های منبع. .sp برای مسیرهای نسبی فایل‌های منبع فهرست‌شده در \fIبه‌عنوان مثال\fP مسیرهای یافت‌شده در \fItracefile\fP، یا یافت‌شده در خروجی gcov در حین \fI–capture\fP \- احتمالاً پس از اعمال جایگزینی‌ها \- ابزار \fBlcov\fP ابتدا مسیر را از ‘cwd’ (جایی که genhtml فراخوانی شده است) و سپس از هر نام دایرکتوری جایگزین به ترتیب مشخص‌شده جستجو خواهد کرد. نخستین مکان منطبق استفاده می‌شود. .sp این گزینه می‌تواند چندین بار مشخص شود تا دایرکتوری‌های بیشتری به مسیر جستجوی منبع افزوده شود. .UNINDENT .UNINDENT .sp \fB\-c\fP \fB\-\-capture\fP .INDENT 0.0 .INDENT 3.5 ضبط داده‌های پوشش زمان اجرا (runtime). .sp به‌طور پیش‌فرض تعداد دفعات اجرای جاری هسته را ضبط کرده و داده‌های پوشش حاصل را در خروجی استاندارد می‌نویسد. از گزینه –directory برای ضبط شمارنده‌ها برای یک برنامه فضای کاربری استفاده کنید. .sp نتیجه عملیات ضبط در stdout یا فایل ردگیری مشخص‌شده با \-o نوشته خواهد شد. .sp هنگام ترکیب با فلگ \fB\-\-all\fP هر دو پوشش زمان اجرا و زمان کامپایل در یک مرحله استخراج خواهند شد. توضیحات مربوط به فلگ \fB\-\-initial\fP در زیر را ببینید. .sp برای جزئیات بیشتر درباره فرآیند ضبط و گزینه‌ها و پارامترهای موجود به صفحه راهنمای \fBgeninfo(1) \%\fP) مراجعه کنید. .sp در هر زمان فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary را می‌توان مشخص کرد. .UNINDENT .UNINDENT .sp \fB\-\-branch\-coverage\fP .INDENT 0.0 .INDENT 3.5 جمع‌آوری و/یا نگه‌داری داده‌های پوشش انشعاب (branch coverage). .sp این معادل استفاده از گزینه “–rc branch_coverage=1” است؛ این گزینه برای سازگاری بهتر با رابط genhtml اضافه شده است. .UNINDENT .UNINDENT .sp \fB\-\-mcdc\-coverage\fP .INDENT 0.0 .INDENT 3.5 جمع‌آوری و نگه‌داری داده‌های MC/DC. .sp این معادل استفاده از گزینه “–rc mcdc_coverage=1” است. پوشش MC/DC برای نگارش‌های GCC نسخه 14.2 و بالاتر، یا LLVM نسخه 18.1 و بالاتر پشتیبانی می‌شود. .sp برای جزئیات بیشتر درباره ضبط داده‌های MC/DC در LLVM به \fIllvm2lcov –help\fP مراجعه کنید. .sp برای جزئیات بیشتر بخش MC/DC از صفحه راهنمای \fBgenhtml(1) \%\fP را ببینید. .UNINDENT .UNINDENT .sp \fB\-\-checksum\fP \fB\-\-no\-checksum\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن اینکه آیا هنگام نوشتن فایل‌های ردگیری داده‌های چکسام تولید شود و/یا هنگام ترکیب فایل‌های ردگیری، تطابق چکسام‌ها اعتبارسنجی شود یا خیر. .sp از –checksum برای فعال‌سازی تولید چکسام یا از –no\-checksum برای غیرفعال کردن آن استفاده کنید. تولید چکسام به‌طور پیش‌فرض \fBغیرفعال\fP است. .sp هنگامی که تولید چکسام فعال باشد، برای هر خط از کد منبع یک چکسام ایجاد شده و همراه با داده‌های پوشش ذخیره می‌شود. این چکسام برای جلوگیری از تلاش برای ترکیب داده‌های پوشش از نگارش‌های مختلف کد منبع استفاده خواهد شد. .sp اگر با نگارش‌های مختلف کد منبع کار نمی‌کنید، این گزینه را غیرفعال کنید تا پردازش داده‌های پوشش سریع‌تر شده و اندازه فایل‌های ردگیری کاهش یابد. .sp توجه داشته باشید که این گزینه تا حدی تحت‌الشعاع گزینه \fB\-\-version\-script\fP قرار دارد \- که عملکردی مشابه انجام می‌دهد، اما در سطح «کل فایل». .UNINDENT .UNINDENT .sp \fB\-\-compat\fP \fImode\fP=\fIvalue*[,*mode\fP=\fIvalue\fP,…] .INDENT 0.0 .INDENT 3.5 تنظیم حالت سازگاری. .sp از –compat برای تعیین اینکه lcov باید هنگام ضبط داده‌های پوشش یک یا چند حالت سازگاری را فعال کند استفاده کنید. می‌توانید یک فهرست جداشده با کاما از جفت‌های mode=value برای مشخص کردن مقادیر چندین حالت ارائه دهید. .sp \fIمقادیر\fP معتبر عبارتند از: .sp \fBon\fP .INDENT 0.0 .INDENT 3.5 فعال کردن حالت سازگاری. .UNINDENT .UNINDENT .sp \fBoff\fP .INDENT 0.0 .INDENT 3.5 غیرفعال کردن حالت سازگاری. .UNINDENT .UNINDENT .sp \fBauto\fP .INDENT 0.0 .INDENT 3.5 اعمال تشخیص خودکار برای تعیین اینکه آیا حالت سازگاری لازم است یا خیر. توجه داشته باشید که تشخیص خودکار برای همه حالت‌های سازگاری در دسترس نیست. .UNINDENT .UNINDENT .sp اگر مقداری مشخص نشود، ‘on’ به‌عنوان مقدار پیش‌فرض در نظر گرفته می‌شود. .sp \fIحالت‌های\fP معتبر عبارتند از: .sp \fBlibtool\fP .INDENT 0.0 .INDENT 3.5 اگر در حال ضبط داده‌های پوشش برای پروژه‌ای هستید که با استفاده از مکانیزم libtool ساخته شده است، این حالت را فعال کنید. همچنین –compat\-libtool را ببینید. .sp مقدار پیش‌فرض برای این تنظیم ‘on’ است. .UNINDENT .UNINDENT .sp \fBhammer\fP .INDENT 0.0 .INDENT 3.5 اگر در حال ضبط داده‌های پوشش برای پروژه‌ای هستید که با استفاده از نگارشی از GCC 3.3 که شامل یک اصلاحیه (وصله hammer) از نگارش‌های بعدی GCC است ساخته شده است، این حالت را فعال کنید. می‌توانید یک GCC 3.3 اصلاح‌شده را با بررسی دایرکتوری ساخت پروژه خود برای فایل‌های دارای پسوند ‘.bbg’ شناسایی کنید. نگارش‌های اصلاح‌نشده GCC 3.3 این فایل‌ها را ‘.bb’ نام‌گذاری می‌کنند. .sp مقدار پیش‌فرض برای این تنظیم ‘auto’ است. .UNINDENT .UNINDENT .sp \fBsplit_crc\fP .INDENT 0.0 .INDENT 3.5 اگر در حال ضبط داده‌های پوشش برای پروژه‌ای هستید که با استفاده از نگارشی از GCC 4.6 که شامل یک اصلاحیه (چکسام‌های تابع تقسیم‌شده یا split function checksums) از نگارش‌های بعدی GCC است ساخته شده است، این حالت را فعال کنید. پیام‌های خطای متداول هنگام اجرای lcov روی داده‌های پوشش تولیدشده توسط چنین نگارش‌هایی از GCC عبارتند از ‘out of memory’ و ‘reached unexpected end of file’. .sp مقدار پیش‌فرض برای این تنظیم ‘auto’ است. .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp \fB\-\-compat\-libtool\fP \fB\-\-no\-compat\-libtool\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن اینکه آیا حالت سازگاری libtool فعال شود یا خیر. .sp از –compat\-libtool برای فعال‌سازی حالت سازگاری libtool یا از –no\-compat\-libtool برای غیرفعال کردن آن استفاده کنید. حالت سازگاری libtool به‌طور پیش‌فرض \fBفعال\fP است. .sp هنگامی که حالت سازگاری libtool فعال باشد، lcov فرض می‌کند که کد منبع مربوط به یک فایل .da واقع در دایرکتوری با نام “.libs” را می‌توان در دایرکتوری والد آن پیدا کرد. .sp اگر در محیط ساخت خود دایرکتوری‌هایی با نام “.libs” دارید اما از libtool استفاده نمی‌کنید، این گزینه را غیرفعال کنید تا از بروز مشکل هنگام ضبط داده‌های پوشش جلوگیری شود. .UNINDENT .UNINDENT .sp \fB\-\-config\-file\fP \fIconfig\-file\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن فایل پیکربندی برای استفاده. برای جزئیات مربوط به قالب فایل و گزینه‌ها به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. همچنین مدخل \fIconfig_file\fP در همان صفحه راهنما را برای جزئیات در مورد نحوه گنجاندن یک فایل کانفیگ در فایل دیگر مشاهده کنید. .sp هنگامی که این گزینه مشخص شود، نه فایل پیکربندی سراسری سیستم /etc/lcovrc و نه فایل پیکربندی ویژه هر کاربر ~/.lcovrc خوانده نخواهد شد. .sp این گزینه ممکن است زمانی مفید باشد که نیاز به اجرای همزمان چند نمونه از \fBlcov\fP با گزینه‌های مختلف فایل پیکربندی وجود داشته باشد. .sp توجه داشته باشید که این گزینه باید به‌طور کامل مشخص شود \- مخفف‌سازی پشتیبانی نمی‌شود. .UNINDENT .UNINDENT .sp \fB\-\-profile\fP [\fIprofile\-data\-file\fP] .INDENT 0.0 .INDENT 3.5 دستور دادن به ابزار برای ردیابی عملکرد و سایر داده‌های پیکربندی. اگر فایل اختیاری \fIprofile\-data\-file\fP مشخص نشود، داده‌های پروفایل در فایلی با همان نام پایه \fI–output\-filename\fP همراه با پسوند الحاق‌شده \fI“.json”\fP نوشته می‌شوند. داده‌های پروفایل زمانی مفید هستند که در حال تلاش برای بهینه‌سازی پیاده‌سازی \fBlcov\fP باشید (به \fB$LCOV_ROOT/share/lcov/support\-scripts/spreadsheet.py\fP مراجعه کنید)، و همچنین می‌توانند اجرای سریع‌تر \fI–parallel\fP را ممکن سازند (بخش \fI“–history\-script”\fP از این صفحه راهنما را ببینید). .UNINDENT .UNINDENT .sp \fB\-\-history\-script\fP \fIcallback\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fIcallback\fP برای پیش‌بینی هزینه زمان اجرای فعلی با استفاده از هزینه مشاهده‌شده در اجرای پیشین. .sp برای اطلاعات بیشتر به صفحه راهنمای \fBgenhtml(1) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp در هر زمان فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary را می‌توان مشخص کرد. .sp \fB\-d\fP \fIdirectory\fP \fB\-\-directory\fP \fIdirectory\fP .INDENT 0.0 .INDENT 3.5 استفاده از فایل‌های .da در \fIdirectory\fP به‌جای هسته. .sp اگر می‌خواهید روی داده‌های پوشش برای یک برنامه فضای کاربری کار کنید، از این گزینه برای تعیین مکانی که برنامه در آن کامپایل شده است استفاده کنید (اینجاست که فایل‌های شمارنده با پسوند .da ذخیره می‌شوند). .sp توجه داشته باشید که می‌توانید این گزینه را بیش از یک بار مشخص کنید. .UNINDENT .UNINDENT .sp \fB\-\-exclude\fP \fIpattern\fP .INDENT 0.0 .INDENT 3.5 مستثنی کردن فایل‌های مبدأ منطبق با \fIpattern\fP\&. .sp اگر می‌خواهید داده‌های پوشش را برای مجموعه خاصی از فایل‌های مبدأ منطبق با هر یک از الگوهای داده‌شده مستثنی کنید، از این سوییچ استفاده کنید. با استفاده از چندین سوییچ خط فرمان \fB\-\-exclude\fP می‌توان چندین الگو را مشخص کرد. \fIpattern\fPها به عنوان الگوهای وایلدکارت شل تفسیر خواهند شد (توجه داشته باشید که ممکن است لازم باشد برای جلوگیری از بسط اولیه آن‌ها توسط شل، به درستی اسکیپ شوند). .sp نکته: الگو باید طوری مشخص شود که با مسیر \fBمطلق (absolute)\fP هر فایل مبدأ مطابقت داشته باشد. اگر الگویی را مشخص کنید که به نظر می‌رسد به درستی اعمال نمی‌شود \- فایل‌هایی که انتظار داشتید مستثنی شوند همچنان در خروجی ظاهر می‌شوند \- می‌توانید به دنبال پیام‌های هشدار در فایل لاگ بگردید. \fBlcov\fP برای هر الگویی که حداقل یک بار اعمال نشود، یک هشدار صادر می‌کند. .sp می‌تواند با سوییچ خط فرمان \fB\-\-include\fP ترکیب شود. اگر یک فایل مشخص هم با الگوی include و هم با الگوی exclude مطابقت داشته باشد، الگوی exclude اولویت خواهد داشت. .UNINDENT .UNINDENT .sp \fB\-\-erase\-functions\fP \fIregexp\fP .INDENT 0.0 .INDENT 3.5 مستثنی کردن داده‌های پوشش از خطوطی که در درون تابعی قرار دارند که نام آن با عبارت منظم (regexp) ارائه‌شده مطابقت دارد. توجه داشته باشید که این نام با توجه به استفاده یا عدم استفاده از گزینه –demangle\-cpp، می‌تواند نام درهم‌ریخته (mangled) یا بازسازی‌شده (demangled) باشد. .sp توجه داشته باشید که این گزینه نیازمند استفاده از نسخه‌ای از gcc است که به اندازه کافی جدید باشد تا از گزارش خط شروع/پایان تابع پشتیبانی کند، یا اینکه ابزار را برای استخراج داده‌های لازم پیکربندی کنید \- به بحث \fBderive_function_end_line\fP در صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید\&. .UNINDENT .UNINDENT .sp \fB\-\-substitute\fP \fIregexp_pattern\fP .INDENT 0.0 .INDENT 3.5 اعمال عبارت منظم پرل \fIregexp_pattern\fP روی نام فایل‌های مبدأ یافت‌شده در حین پردازش. این گزینه برای مثال زمانی مفید است که نام مسیر گزارش‌شده توسط gcov با چیدمان مبدأ شما مطابقت ندارد و فایل پیدا نمی‌شود، یا در محیط‌های پیچیده‌تری که در آن‌ها ساختار دایرکتوری بیلد با چیدمان کد منبع یا چیدمان در سیستم کنترل نسخه پروژه مطابقت ندارد. .sp از این گزینه در شرایطی استفاده کنید که geninfo نمی‌تواند مسیر صحیح فایل‌های کد منبع یک پروژه را پیدا کند. با ارائه یک \fIregexp_pattern\fP در قالب عبارت منظم پرل (به صفحه راهنمای \fBperlre(1) \%\fP مراجعه کنید)، می‌توانید به geninfo دستور دهید بخش‌هایی از مسیر نادرست مبدأ را حذف یا تغییر دهد. همچنین به گزینه \fB\-\-resolve\-script\fP مراجعه کنید. .sp می‌توان یک یا چند الگوی \fI–substitution\fP و/یا یک \fI–resolve\-script\fP را مشخص کرد. هنگامی که چندین الگو مشخص می‌شود، آن‌ها به ترتیبی که تعیین شده‌اند اعمال می‌شوند؛ ابتدا الگوهای جایگزینی و سپس کال‌بک resolve. ترتیب جستجوی فایل به این صورت است: .INDENT 0.0 .IP 1. 3 جستجو برای نام فایل (تغییرنیافته). .sp اگر فایل وجود دارد: آن را برگردان. .IP 2. 3 اعمال تمام الگوهای جایگزینی به ترتیب \- نتیجه الگوی اول به عنوان ورودی الگوی دوم استفاده می‌شود و به همین ترتیب. .sp اگر فایلی مطابق با نام حاصل وجود دارد: آن را برگردان. .IP 3. 3 اعمال کال‌بک ‘resolve’ روی نتیجه نهایی جایگزینی‌های الگو. .sp اگر فایلی مطابق با نام حاصل وجود دارد: آن را برگردان. .IP 4. 3 در غیر این صورت: نام اصلی فایل (تغییرنیافته) را برگردان. .sp بسته به زمینه، نام فایل حل‌نشده ممکن است منجر به خطا شود یا نشود. .UNINDENT .sp جایگزینی‌ها در چندین زمینه توسط lcov/genhtml/geninfo استفاده می‌شوند: .INDENT 0.0 .IP \(bu 2 در حین \fI–capture\fP، اعمال‌شده روی نام فایل‌های مبدأ یافت‌شده در فایل‌های داده پوشش تولیدشده توسط gcov (به صفحه راهنمای \fBgcov(1) \%\fP مراجعه کنید). .IP \(bu 2 در حین \fI–capture\fP، اعمال‌شده روی مسیرهای جایگزین \fI–build\-dir\fP، هنگام جستجو برای فایل داده \fI\&.gcno\fP (زمان کامپایل) متناظر با یک فایل داده \fI\&.gcda\fP (زمان اجرا). .IP \(bu 2 اعمال‌شده روی نام فایل‌های یافت‌شده در فایل‌های داده lcov (فایل‌های “.info”) \- \fIبرای مثال\fP، در حین تجمیع داده‌های lcov یا تولید گزارش‌های متنی و HTML. .sp برای مثال، نام‌های جایگزین‌شده برای یافتن فایل‌های مبدأ جهت فیلتر کردن مبتنی بر متن استفاده می‌شوند (به بخش \fI–filter\fP در زیر مراجعه کنید) و به کال‌بک‌های \fI–version\-script\fP، \fI–annotate\-script\fP و \fI–criteria\-script\fP ارسال می‌شوند. .IP \(bu 2 اعمال‌شده روی نام فایل‌های یافت‌شده در \fI–diff\-file\fP ارسال‌شده به genhtml. .UNINDENT .UNINDENT .UNINDENT .sp \fBمثال:\fP .INDENT 0.0 .IP 1. 3 هنگامی که geninfo گزارش می‌دهد که نمی‌تواند فایل مبدأ زیر را پیدا کند: .INDENT 3.0 .INDENT 3.5 .sp .EX /path/to/src/.libs/file.c .EE .UNINDENT .UNINDENT .sp در حالی که فایل در واقع در مسیر زیر قرار دارد: .INDENT 3.0 .INDENT 3.5 .sp .EX /path/to/src/file.c .EE .UNINDENT .UNINDENT .sp از پارامتر زیر استفاده کنید: .INDENT 3.0 .INDENT 3.5 .sp .EX \-\-substitute \(aqs#/.libs##g\(aq .EE .UNINDENT .UNINDENT .sp این کار تمام رشته‌های “/.libs” را از مسیر حذف می‌کند. .IP 2. 3 هنگامی که geninfo گزارش می‌دهد که نمی‌تواند فایل مبدأ زیر را پیدا کند: .INDENT 3.0 .INDENT 3.5 .sp .EX /tmp/build/file.c .EE .UNINDENT .UNINDENT .sp در حالی که فایل در واقع در مسیر زیر قرار دارد: .INDENT 3.0 .INDENT 3.5 .sp .EX /usr/src/file.c .EE .UNINDENT .UNINDENT .sp از پارامتر زیر استفاده کنید: .INDENT 3.0 .INDENT 3.5 .sp .EX \-\-substitute \(aqs#/tmp/build#/usr/src#g\(aq .EE .UNINDENT .UNINDENT .sp این کار تمام رشته‌های “/tmp/build” را در مسیر به “/usr/src” تغییر می‌دهد. .UNINDENT .sp \fB\-\-omit\-lines\fP \fIregexp\fP .INDENT 0.0 .INDENT 3.5 مستثنی کردن داده‌های پوشش از خطوطی که محتوای آن‌ها با \fIregexp\fP مطابقت دارد\&. .sp اگر می‌خواهید داده‌های پوشش خط و انشعاب را برای برخی ساختارهای خاص در کد خود مستثنی کنید (\fIبرای مثال\fP، یک ماکروی پیچیده)، از این سوییچ استفاده کنید. با استفاده از چندین سوییچ خط فرمان \fB\-\-omit\-lines\fP می‌توان چندین الگو را مشخص کرد. \fIregexp\fP به عنوان عبارات منظم پرل تفسیر خواهد شد (توجه داشته باشید که ممکن است لازم باشد برای جلوگیری از بسط اولیه آن‌ها توسط شل، به درستی اسکیپ شوند). اگر می‌خواهید الگو به صراحت از ابتدا یا انتهای خط مطابقت داده شود، regexp شما باید با “^” و/یا “$” شروع و/یا پایان یابد. .sp توجه داشته باشید که تنظیم فایل پیکربندی \fBlcovrc\fP یعنی \fBlcov_excl_line = regexp\fP مشابه با \fB\-\-omit\-lines\fP است\&. \fB\-\-omit\-lines\fP زمانی مفید است که چندین تیم وجود دارند که هر کدام می‌خواهند الگوهای خاصی را مستثنی کنند. \fB\-\-omit\-lines\fP خاصیت افزایشی دارد و می‌تواند در چندین فایل کانفیگ مشخص شود، در حالی که هر بار فراخوانی \fBlcov_excl_line\fP مقدار قبلی را بازنویسی می‌کند \- و بنابراین تیم‌ها باید هماهنگ باشند. .UNINDENT .UNINDENT .sp \fB\-\-external\fP \fB\-\-no\-external\fP .INDENT 0.0 .INDENT 3.5 تعیین اینکه آیا داده‌های پوشش برای فایل‌های مبدأ خارجی ثبت شوند یا خیر. .sp فایل‌های مبدأ خارجی فایل‌هایی هستند که در هیچ‌یک از دایرکتوری‌های مشخص‌شده توسط \fI–directory\fP یا \fI–base\-directory\fP قرار ندارند\&. برای گنجاندن نقاط پوشش (coverpoints) در فایل‌های مبدأ خارجی هنگام دریافت داده‌های پوشش از \fI–external\fP و برای مستثنی کردن آن‌ها از \fI–no\-external\fP استفاده کنید. اگر مسیر \fI–directory\fP یا \fI–base\-directory\fP شما حاوی یک پیوند نرم (soft link) باشد، دایرکتوری هدف واقعی «داخلی» در نظر گرفته نمی‌شود مگر اینکه از گزینه \fI–follow\fP استفاده شود. .sp گزینه \fI–no\-external\fP ابزاری تا حدی خام و کلی است؛ گزینه‌های \fI–exclude\fP و \fI–include\fP کنترل دقیق‌تری بر اینکه چه داده‌های پوششی گنجانده شده یا نشوند در صورت پیچیده بودن ساختار پروژه و/یا در حالتی که \fI–no\-external\fP رفتار مد نظر شما را انجام ندهد، فراهم می‌کنند. .sp داده‌های فایل‌های مبدأ خارجی به صورت پیش‌فرض \fBگنجانده می‌شوند (included)\fP\&. .UNINDENT .UNINDENT .sp \fB\-\-forget\-test\-names\fP .INDENT 0.0 .INDENT 3.5 در صورت غیرصفر بودن، نادیده گرفتن نام‌های موارد آزمون (testcase) در فایل info. \- \fIیعنی\fP، رفتار با تمام داده‌های پوشش به گونه‌ای که گویی از همان مورد آزمون آمده‌اند. اگر کاربر در گزارش‌های پوشش نیازی به خلاصه پوشش بر اساس هر مورد آزمون نداشته باشد، این کار ممکن است کارایی را بهبود بخشیده و مصرف حافظه را کاهش دهد. .sp این گزینه همچنین می‌تواند به صورت دائمی با استفاده از گزینه فایل پیکربندی \fIforget_testcase_names\fP پیکربندی شود\&. .UNINDENT .UNINDENT .sp \fB\-\-prune\-tests\fP .INDENT 0.0 .INDENT 3.5 تعیین فهرست فایل‌های ردگیری (tracefiles) یکتا. .sp از این گزینه برای تعیین فهرستی از فایل‌های ردگیری یکتا از میان فهرست مشخص‌شده توسط \fB\-\-add\-tracefile\fP استفاده کنید\&. یک فایل ردگیری در صورتی یکتا در نظر گرفته می‌شود که تنها فایل ردگیری باشد که: .INDENT 0.0 .IP 1. 3 حاوی داده برای یک فایل مبدأ خاص باشد .IP 2. 3 حاوی داده برای یک نام مورد آزمون خاص باشد .IP 3. 3 حاوی داده‌های پوشش غیرصفر برای یک خط، تابع یا انشعاب خاص باشد .UNINDENT .sp توجه داشته باشید که فهرست فایل‌های نگه‌داشته‌شده ممکن است به ترتیبی که پردازش می‌شوند بستگی داشته باشد. برای مثال، اگر \fIA\fP و \fIB\fP حاوی داده‌های پوشش یکسان باشند، اولین فایلی که مشاهده می‌شود نگه‌داشته شده و دومی هرس (prune) خواهد شد. هنگامی که از گزینه \fB\-\-parallel\fP استفاده می‌شود، ترتیب پردازش فایل غیرقطعی (nondeterministic) است \- به این معنی که نتیجه هرس‌شده در این حالت ممکن است از یک اجرا تا اجرای بعدی متفاوت باشد. .sp \fB\-\-prune\-tests\fP باید همراه با \fB\-\-add\-tracefile\fP مشخص شود\&. در صورت مشخص شدن، \fBlcov\fP به جای داده‌های فایل ردگیری ترکیبی، فهرست فایل‌های یکتا را صادر خواهد کرد. .UNINDENT .UNINDENT .sp \fB\-\-map\-functions\fP .INDENT 0.0 .INDENT 3.5 فهرست کردن فایل‌های ردگیری دارای پوشش غیرصفر برای هر تابع. .sp از این گزینه برای تعیین فهرست فایل‌های ردگیری حاوی داده‌های پوشش غیرصفر برای هر تابع از میان فهرست فایل‌های ردگیری مشخص‌شده توسط \fB\-\-add\-tracefile\fP استفاده کنید\&. .sp این گزینه باید همراه با \fB\-\-add\-tracefile\fP مشخص شود\&. در صورت مشخص شدن، \fBlcov\fP به جای داده‌های فایل ردگیری ترکیبی، فهرست توابع و فایل‌های ردگیری مرتبط را صادر خواهد کرد. .UNINDENT .UNINDENT .sp \fB\-\-context\-script\fP \fIscript\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fIscript\fP برای جمع‌آوری اطلاعات تکمیلی درباره زمینه اجرای ابزار \- جهت کمک به اشکال‌زدایی زیرساخت و/یا رهگیری. .sp برای جزئیات بیشتر درباره اسکریپت زمینه (context script)، به صفحه راهنمای genhtml مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-criteria\-script\fP \fIscript\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fIscript\fP برای آزمودن معیارهای پذیرش پوشش آزمون. .sp برای جزئیات بیشتر درباره اسکریپت معیارها، صفحه راهنمای genhtml را ببینید. توجه داشته باشید که lcov اطلاعات تاریخ و مالک را ردیابی نمی‌کند (به مدخل \fI–annotate\-script\fP در صفحه راهنمای genhtml مراجعه کنید) \- بنابراین این اطلاعات به بازخوانی (callback) lcov منتقل نمی‌شوند. .UNINDENT .UNINDENT .sp \fB\-\-resolve\-script\fP \fIscript\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fIscript\fP برای یافتن مسیر فایلی از برخی فایل‌های منبع که در یک فایل داده ورودی ظاهر می‌شود، در صورتی که فایل پس از اعمال الگوهای \fI–substitute\fP و جستجو در فهرست \fI–source\-directory\fP یافت نشود. این گزینه معادل گزینه پیکربندی \fBresolve_script\fP است. برای جزئیات به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-version\-script\fP \fIscript\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fIscript\fP برای دریافت شناسه نسخه فایل منبع از سیستم کنترل نسخه هنگام استخراج داده‌ها، و مقایسه شناسه‌های نسخه به منظور بررسی خطا هنگام ادغام فایل‌های .info. .sp برای جزئیات بیشتر درباره اسکریپت نسخه، صفحه راهنمای genhtml را ببینید. .UNINDENT .UNINDENT .sp \fB\-\-unreachable\-script\fP \fImodule\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fImodule\fP برای تصمیم‌گیری درباره اینکه آیا عبارات شرطی شاخه‌ای خاص و/یا شرایط MC/DC باید از گزارش پوشش آزمون حذف شوند یا خیر. این گزینه معادل گزینه پیکربندی \fBunreachable_script\fP است. برای جزئیات به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .sp توجه داشته باشید که \fI“module”\fP الزاماً باید یک ماژول Perl باشد. .sp برای جزئیات بیشتر، صفحه راهنمای genhtml را ببینید. .UNINDENT .UNINDENT .sp \fB\-\-comment\fP \fIcomment_string\fP .INDENT 0.0 .INDENT 3.5 افزودن \fIcomment_string\fP به انتهای فهرست یادداشت‌های درج‌شده در فایل نتیجه خروجی. این گزینه می‌تواند چندین بار مشخص شود. یادداشت‌ها در بالای فایل و به همان ترتیبی که مشخص شده‌اند چاپ می‌شوند. .sp یادداشت‌ها می‌توانند برای مستندسازی شرایطی که فایل ردگیری تحت آن تولید شده مفید باشند: میزبان، تاریخ، محیط و \fIغیره\fP\&. .sp توجه داشته باشید که این گزینه برای عملیات‌های lcov که فایل نتیجه خروجی نمی‌نویسند هیچ تاثیری ندارد: \fI–list\fP \fI–summary\fP، \fI–prune\-tests\fP، و \fI–map\-functions\fP\&. .sp برای شرح قالب یادداشت‌ها در فایل نتیجه، به صفحه راهنمای \fBgeninfo\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-e\fP \fItracefile pattern\fP \fB\-\-extract\fP \fItracefile pattern\fP .INDENT 0.0 .INDENT 3.5 استخراج داده‌ها از \fItracefile\fP\&. .sp اگر می‌خواهید داده‌های پوشش آزمون را تنها برای مجموعه‌ای خاص از فایل‌ها از یک فایل ردگیری استخراج کنید، از این سوییچ استفاده نمایید. پارامترهای خط فرمان اضافی به عنوان الگوهای وایلدکارت شل تفسیر خواهند شد (توجه داشته باشید که ممکن است لازم باشد به شکل مناسب اسکیپ شوند تا از بسط زودهنگام توسط شل جلوگیری شود). هر مدخل فایل در \fItracefile\fP که حداقل با یکی از آن الگوها مطابقت داشته باشد استخراج خواهد شد. .sp توجه: الگو باید طوری مشخص شود که با مسیر \fBمطلق\fP هر فایل منبع مطابقت داشته باشد. .sp نتیجه عملیات استخراج در stdout یا فایل ردگیری مشخص‌شده با \-o نوشته خواهد شد. .sp در هر بار فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary را می‌توان مشخص کرد. .UNINDENT .UNINDENT .sp \fB\-f\fP \fB\-\-follow\fP .INDENT 0.0 .INDENT 3.5 دنبال کردن پیوندها هنگام جستجوی فایل‌های .da. .UNINDENT .UNINDENT .sp \fB\-\-large\-file\fP \fIregexp\fP .INDENT 0.0 .INDENT 3.5 برای جزئیات بیشتر به بخش \fI–large\-file\fP در صفحه راهنمای \fBgeninfo(1) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-from\-package\fP \fIpackage\fP .INDENT 0.0 .INDENT 3.5 استفاده از فایل‌های .da موجود در \fIpackage\fP به جای هسته یا دایرکتوری. .sp اگر ماشین‌های جداگانه‌ای برای ساخت و آزمایش دارید و می‌خواهید ایجاد فایل .info را روی ماشین ساخت انجام دهید، از این گزینه استفاده کنید. برای اطلاعات بیشتر به –to\-package مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-sort\-input\fP .INDENT 0.0 .INDENT 3.5 مشخص می‌کند که آیا نام فایل‌ها قبل از ضبط و/یا تجمیع مرتب شوند یا خیر. مرتب‌سازی تفاوت‌های خروجی وابسته به ترتیب پردازش را کاهش می‌دهد. به بخش \fBsort_input\fP در صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-gcov\-tool\fP \fItool\fP .INDENT 0.0 .INDENT 3.5 تعیین مکان ابزار gcov. .sp برای جزئیات بیشتر، صفحه راهنمای geninfo را ببینید. .UNINDENT .UNINDENT .sp \fB\-h\fP \fB\-\-help\fP .INDENT 0.0 .INDENT 3.5 چاپ متن راهنمای کوتاه و سپس خروج. .UNINDENT .UNINDENT .sp \fB\-\-include\fP \fIpattern\fP .INDENT 0.0 .INDENT 3.5 شامل کردن فایل‌های منبع مطابق با \fIpattern\fP\&. .sp اگر می‌خواهید داده‌های پوشش آزمون را فقط برای مجموعه خاصی از فایل‌های منبع که با هر یک از الگوهای داده‌شده مطابقت دارند شامل کنید، از این سوییچ استفاده نمایید. با استفاده از چندین سوییچ خط فرمان \fB\-\-include\fP می‌توان چندین الگو را مشخص کرد. \fIpatterns\fP به عنوان الگوهای وایلدکارت شل تفسیر خواهند شد (توجه داشته باشید که ممکن است برای جلوگیری از بسط آنها توسط شل، نیاز به اسکیپ مناسب باشد). .sp توجه: الگو باید به گونه‌ای مشخص شود که با مسیر \fBمطلق\fP هر فایل منبع مطابقت داشته باشد. .sp اگر الگویی مشخص کنید که به نظر نمی‌رسد به درستی اعمال شود \- فایل‌هایی که انتظار داشتید در خروجی گنجانده شوند ظاهر نشوند \- ابزار lcov یک پیام خطای نوع ‘unused’ تولید خواهد کرد. برای چگونگی نادیده گرفتن خطا یا تبدیل آن به یک هشدار توسط lcov، به گزینه –ignore\-errors مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-msg\-log\fP [\fIlog_file_name\fP] .INDENT 0.0 .INDENT 3.5 مشخص کردن مکان ذخیره پیام‌های خطا و هشدار (علاوه بر نوشتن در STDERR). اگر \fIlog_file_name\fP مشخص نشود، از مکان پیش‌فرض استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-ignore\-errors\fP \fIerrors\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن فهرستی از خطاها که پس از آنها پردازش باید ادامه یابد. .sp از این گزینه برای مشخص کردن فهرستی از یک یا چند دسته از خطاها استفاده کنید که lcov پس از آنها به جای توقف، باید پردازش را ادامه دهد. توجه داشته باشید که ابزار یک هشدار (به جای خطای مهلک) تولید خواهد کرد، مگر اینکه دو (یا چند) بار خطا را نادیده بگیرید: .INDENT 0.0 .INDENT 3.5 .sp .EX lcov ... \-\-ignore\-errors source,source ... .EE .UNINDENT .UNINDENT .sp \fIerrors\fP می‌تواند فهرستی از کلمات کلیدی زیر باشد که با کاما از هم جدا شده‌اند: .sp \fBbranch\fP .INDENT 0.0 .INDENT 3.5 شناسه شاخه (فیلد دوم در مدخل ‘BRDA’ فایل .info) از توالی عددی صحیح مورد انتظار پیروی نمی‌کند. .UNINDENT .UNINDENT .sp \fBcallback\fP .INDENT 0.0 .INDENT 3.5 خطای اسکریپت نسخه. .UNINDENT .UNINDENT .sp \fBchild\fP .INDENT 0.0 .INDENT 3.5 فرایند فرزند در حین اجرای \fI–parallel\fP کد خروج غیر صفر برگردانده است. این معمولاً نشان می‌دهد که فرزند با خطایی مواجه شده است: فایل گزارش را بلافاصله بالای این پیام بررسی کنید. در مقابل: خطای \fBparallel\fP نشان‌دهنده یک استثنای غیرمنتظره/کنترل‌نشده در فرایند فرزند است \- نه یک خطای ‘معمول’ lcov. .UNINDENT .UNINDENT .sp \fBcorrupt\fP .INDENT 0.0 .INDENT 3.5 فایل خراب/غیرقابل‌خواندن یافت شد. .UNINDENT .UNINDENT .sp \fBcount\fP .INDENT 0.0 .INDENT 3.5 تعداد بیش از حدی از پیام‌های یک دسته گزارش شده است \- پیام‌های بعدی از آن نوع سرکوب خواهند شد. این حد را می‌توان توسط متغیر ‘max_message_count’ کنترل کرد. به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fBdeprecated\fP .INDENT 0.0 .INDENT 3.5 شما از یک گزینه منسوخ‌شده استفاده می‌کنید. این گزینه در نسخه‌های آینده حذف خواهد شد \- بنابراین باید اسکریپت‌های خود را همین حالا اصلاح کنید. .UNINDENT .UNINDENT .sp \fBempty\fP .INDENT 0.0 .INDENT 3.5 فایل داده .info خالی است (\fIبرای مثال\fP، به دلیل اینکه تمام کد ‘حذف’ یا مستثنی شده است). .UNINDENT .UNINDENT .sp \fBexcessive\fP .INDENT 0.0 .INDENT 3.5 داده‌های پوشش آزمون شما شامل تعداد دفعات اجرای (‘hit’) به طور مشکوکی بالاست که بعید است صحیح باشد \- این امر احتمالاً نشان‌دهنده یک باگ در زنجیره ابزار شماست. برای جزئیات به بخش \fIexcessive_count_threshold\fP در صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fBfork\fP .INDENT 0.0 .INDENT 3.5 عدم توانایی در ایجاد فرایند فرزند در حین اجرای \fI–parallel\fP\&. .sp اگر پیام نادیده گرفته شود ( \fI–ignore\-errors fork\fP )، ابزار genhtml مدتی کوتاه منتظر می‌ماند و سپس اجرای ناموفق را مجدداً تلاش می‌کند. .sp اگر خطاهای مداوم مشاهده می‌کنید، یا موازی‌سازی را غیرفعال کرده یا کاهش دهید، یک محدودیت حافظه تعیین کنید، یا سرور بزرگ‌تری برای اجرای کار بیابید. .UNINDENT .UNINDENT .sp \fBformat\fP .INDENT 0.0 .INDENT 3.5 نحو یا مقدار غیرمنتظره در فایل .info یافت شد \- برای مثال، برخورد با عدد منفی یا شماره خط صفر. .UNINDENT .UNINDENT .sp \fBgcov\fP .INDENT 0.0 .INDENT 3.5 ابزار gcov با یک کد بازگشتی غیر صفر خارج شد. .UNINDENT .UNINDENT .sp \fBgraph\fP .INDENT 0.0 .INDENT 3.5 فایل گراف یافت نشد یا خراب است. .UNINDENT .UNINDENT .sp \fBinconsistent\fP .INDENT 0.0 .INDENT 3.5 داده‌های پوشش آزمون شما از نظر داخلی ناسازگار هستند: دو یا چند ادعای متناقض و مانعة‌الجمع دارند. برای مثال، یک عبارت هم به عنوان شاخه استثنا و هم به عنوان غیر استثنا علامت‌گذاری شده است. (برای جزئیات بیشتر به صفحه راهنمای \fBgenhtml(1) \%\fP مراجعه کنید). .UNINDENT .UNINDENT .sp \fBinternal\fP .INDENT 0.0 .INDENT 3.5 مشکل داخلی در ابزار شناسایی شد. لطفاً این باگ را به همراه یک مورد آزمایشی گزارش دهید. .UNINDENT .UNINDENT .sp \fBmismatch\fP .INDENT 0.0 .INDENT 3.5 مدخل‌های ناسازگار در فایل ردگیری یافت شد: .INDENT 0.0 .IP \(bu 2 عبارت شاخه (فیلد ۳ در مدخل ‘BRDA’ فایل .info) از داده‌های ادغام همخوانی ندارد، یا .IP \(bu 2 تعداد دفعات اجرای تابع (FNDA:…) وجود دارد اما اعلان تابع (FN:…) یافت نمی‌شود. .UNINDENT .UNINDENT .UNINDENT .sp \fBmissing\fP .INDENT 0.0 .INDENT 3.5 فایل وجود ندارد یا قابل خواندن نیست. .UNINDENT .UNINDENT .sp \fBnegative\fP .INDENT 0.0 .INDENT 3.5 تعداد دفعات اجرای (‘hit’) منفی یافت شد. .sp توجه داشته باشید که مقادیر منفی ممکن است ناشی از یک باگ شناخته‌شده GCC باشند \- ببینید: .INDENT 0.0 .INDENT 3.5 \% .UNINDENT .UNINDENT .sp و کامپایل با “\-fprofile\-update=atomic” را امتحان کنید. باید مجدداً کامپایل کرده، آزمون‌های خود را دوباره اجرا نمایید و داده‌های پوشش را مجدداً ضبط کنید. .UNINDENT .UNINDENT .sp \fBpackage\fP .INDENT 0.0 .INDENT 3.5 یک بسته پرل لازم روی سیستم شما نصب نیست. در برخی موارد، امکان نادیده گرفتن این پیام و ادامه دادن وجود دارد \- با این حال، قابلیت‌های خاصی در این صورت غیرفعال خواهند شد. .UNINDENT .UNINDENT .sp \fBparallel\fP .INDENT 0.0 .INDENT 3.5 انواع مختلف خطاهای مربوط به موازی‌سازی \- \fIیعنی\fP یک فرایند فرزند به دلیل خطا متوقف شده است. پیام خطای مربوطه در فایل لاگ دقیقاً قبل از خطای \fIparallel\fP ظاهر می‌شود. .sp اگر خطایی در رابطه با اجرای موازی مشاهده می‌کنید که نامعتبر به نظر می‌رسد، بهتر است فلگ –parallel را برداشته و دوباره تلاش کنید. اگر حذف این فلگ منجر به نتیجه متفاوتی شد، لطفاً مشکل را (به همراه یک مورد آزمایشی) گزارش دهید تا ابزار اصلاح شود. .UNINDENT .UNINDENT .sp \fBparent\fP .INDENT 0.0 .INDENT 3.5 فرایند والد در حین فعال بودن فرایند فرزند در جریان اجرای \fI–parallel\fP خارج شد. این اتفاق زمانی رخ می‌دهد که والد با یک خطای مهلک مواجه شده باشد \- \fIبرای مثال\fP خطایی در یک فرزند دیگر که نادیده گرفته نشده است. این فرزند نمی‌تواند بدون والد خود به کار ادامه دهد \- و بنابراین خارج خواهد شد. .UNINDENT .UNINDENT .sp \fBrange\fP .INDENT 0.0 .INDENT 3.5 داده‌های پوشش به شماره خطی اشاره می‌کنند که بزرگتر از تعداد خطوط فایل منبع است. این امر می‌تواند ناشی از عدم تطابق نسخه یا مشکلی در داده‌های \fIgcov\fP باشد. .UNINDENT .UNINDENT .sp \fBsource\fP .INDENT 0.0 .INDENT 3.5 فایل کد منبع برای یک مجموعه داده یافت نشد. .UNINDENT .UNINDENT .sp \fBunreachable\fP .INDENT 0.0 .INDENT 3.5 یک نقطه پوشش (خط، شاخه، تابع یا MC/DC) درون یک ناحیه “دست‌نیافتنی” اجرا شده است (hit خورده است)؛ یا کد، یا جایگذاری دستورالعمل، یا هر دو اشتباه هستند. اگر خطا نادیده گرفته شود، بسته به مقدار پارامتر پیکربندی \fIretain_unreachable_coverpoints_if_executed\fP نقطه پوشش خطاکار حفظ می‌شود (مستثنی نمی‌شود) یا حذف می‌گردد. برای اطلاعات بیشتر به صفحه راهنمای \fBlcovrc(5) \%\fP و بخش \fI“Exclusion markers”\fP در صفحه راهنمای \fBgeninfo(1) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fBunsupported\fP .INDENT 0.0 .INDENT 3.5 قابلیت درخواست‌شده برای پیکربندی این ابزار پشتیبانی نمی‌شود. به عنوان مثال، استثناهای محدوده خطوط شروع/پایان تابع از برخی قابلیت‌های GCOV استفاده می‌کنند که در نسخه‌های قدیمی‌تر GCC در دسترس نیستند. .UNINDENT .UNINDENT .sp \fBunused\fP .INDENT 0.0 .INDENT 3.5 الگوی include/exclude/erase/omit/substitute با هیچ مسیر فایلی مطابقت نداشت. .UNINDENT .UNINDENT .sp \fBusage\fP .INDENT 0.0 .INDENT 3.5 استفاده پشتیبانی‌نشده شناسایی شد \- \fIبرای مثال\fP ترکیب پشتیبانی‌نشده‌ای از گزینه‌ها. .UNINDENT .UNINDENT .sp \fButility\fP .INDENT 0.0 .INDENT 3.5 ابزاری که در حین پردازش فراخوانی شده کد خطا برگردانده است (\fIبرای مثال\fP، ابزار ‘find’ با یک پوشه غیرقابل خواندن مواجه شده است). .UNINDENT .UNINDENT .sp \fBversion\fP .INDENT 0.0 .INDENT 3.5 شناسه‌های کنترل نسخه فایلی که در تلاش برای ادغام آن هستیم یکسان نیستند \- شماره‌گذاری خطوط و سایر اطلاعات ممکن است نادرست باشند. .UNINDENT .UNINDENT .sp همچنین برای بررسی پارامتر ‘max_message_count’ که می‌توان از آن برای کنترل تعداد هشدارهای صادرشده پیش از سرکوب تمام پیام‌های بعدی استفاده کرد، به صفحه راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. از این کار می‌توان برای کاهش حجم فایل لاگ استفاده کرد. .UNINDENT .UNINDENT .sp \fB\-\-expect\-message\-count message_type:expr[,message_type:expr]\fP .INDENT 0.0 .INDENT 3.5 به \fBlcov\fP یک محدودیت روی تعداد پیام‌های یک یا چند نوع که انتظار می‌رود در طول اجرا تولید شوند، اعمال کنید. اگر این شرط درست نباشد، خطایی از نوع \fI“count”\fP (به بالا مراجعه کنید) ایجاد می‌شود. .sp برای جزئیات بیشتر درباره این گزینه به راهنمای \fBgenhtml(1) \%\fP و همچنین برای شرح گزینه معادل در پرونده پیکربندی به بخش \fI“expect_message_count”\fP در راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-keep\-going\fP .INDENT 0.0 .INDENT 3.5 در صورت بروز خطا متوقف نشوید: تلاش برای تولید نتیجه، هرچند ناقص یا دارای نقص. .sp این گزینه خط فرمان متناظر با گزینه \fIstop_on_error [0|1]\fP در lcovrc است. برای جزئیات بیشتر به راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-preserve\fP .INDENT 0.0 .INDENT 3.5 حفظ پرونده‌های داده میانی تولیدشده توسط مراحل مختلف ابزار \- \fIبرای مثال\fP جهت اشکال‌زدایی. به طور پیش‌فرض، این پرونده‌ها حذف می‌شوند. .UNINDENT .UNINDENT .sp \fB\-\-filter\fP \fIfilters\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن فهرستی از فیلترهای coverpoint برای اعمال روی داده‌های ورودی. برای جزئیات به صفحه راهنمای genhtml مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-demangle\-cpp\fP [\fIparam\fP] .INDENT 0.0 .INDENT 3.5 نام‌های توابع C++ را ساده‌سازی و رمزگشایی (Demangle) کنید. برای جزئیات به صفحه راهنمای genhtml مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-i\fP \fB\-\-initial\fP .INDENT 0.0 .INDENT 3.5 ثبت داده‌های اولیه پوشش با مقدار صفر \- \fIیعنی\fP از پرونده‌های داده ‘.gcno’ زمان کامپایل. همچنین گزینه \fB\-\-all\fP را ببینید، که به ابزار می‌گوید داده‌های زمان کامپایل (‘.gcno’) و زمان اجرا (‘.gcda’) را به طور همزمان ثبت کند. .sp پیش از اجرای هر مورد آزمون، lcov را با گزینه \-c و این گزینه روی دایرکتوری‌های حاوی پرونده‌های .bb، .bbg یا .gcno اجرا کنید. نتیجه یک پرونده داده پوشش «پایه» (baseline) خواهد بود که برای هر خط کد دارای ابزار دقیق، مقدار پوشش صفر دارد. این پرونده داده را (با استفاده از lcov \-a) با پرونده‌های داده پوشش ثبت‌شده پس از اجرای آزمون ترکیب کنید تا مطمئن شوید که درصد کل خطوط پوشش داده شده حتی زمانی که تمام پرونده‌های کد منبع در طول آزمون بارگذاری نشده‌اند، صحیح است. .sp روال پیشنهادی هنگام ثبت داده‌ها برای یک مورد آزمون: .INDENT 0.0 .IP 1. 3 ایجاد پرونده داده پوشش پایه .INDENT 3.0 .INDENT 3.5 .sp .EX # lcov \-c \-i \-d appdir \-o app_base.info .EE .UNINDENT .UNINDENT .IP 2. 3 اجرای آزمون .INDENT 3.0 .INDENT 3.5 .sp .EX # appdir/test .EE .UNINDENT .UNINDENT .IP 3. 3 ایجاد پرونده داده پوشش آزمون .INDENT 3.0 .INDENT 3.5 .sp .EX # lcov \-c \-d appdir \-o app_test.info .EE .UNINDENT .UNINDENT .IP 4. 3 ترکیب داده‌های پوشش پایه و آزمون .INDENT 3.0 .INDENT 3.5 .sp .EX # lcov \-a app_base.info \-a app_test.info \-o app_total.info .EE .UNINDENT .UNINDENT .UNINDENT .sp چهار مرحله فوق معادل است با: .INDENT 0.0 .INDENT 3.5 .sp .EX # lcov \-\-capture \-\-all \-o app_total.info \-d appdir .EE .UNINDENT .UNINDENT .sp اگر پروژه شما شامل چند واحد کامپایل باشد که در هیچ‌یک از برنامه‌های اجرایی یا کتابخانه‌های مشترک موارد آزمون استفاده نشده باشند \- یعنی برخی پرونده‌های داده ‘.gcno’ (زمان کامپایل) وجود داشته باشند که پرونده داده ‘.gcda’ (زمان اجرا) متناظر ندارند \- داده‌های ترکیبی زمان کامپایل و زمان اجرا نتیجه متفاوتی نسبت به ثبت داده‌های زمان اجرا به تنهایی ایجاد می‌کنند. در این حالت، گزارش فقط زمان اجرا شامل هیچ نقطه پوششی (coverpoint) از پرونده‌های استفاده‌نشده نخواهد بود، در حالی که این نقاط پوشش (با تعداد دفعات اجرای صفر) در گزارش ترکیبی ظاهر خواهند شد. .sp گزینه \fB\-\-initial\fP به جز در حالت \fB\-\-capture\fP نادیده گرفته می‌شود. در صورت مشخص شدن گزینه \fB\-\-initial\fP ، گزینه \fB\-\-all\fP نادیده گرفته خواهد شد. .UNINDENT .UNINDENT .sp \fB\-k\fP \fIsubdirectory\fP \fB\-\-kernel\-directory\fP \fIsubdirectory\fP .INDENT 0.0 .INDENT 3.5 ثبت داده‌های پوشش کرنل فقط از \fIsubdirectory\fP\&. .sp اگر نمی‌خواهید داده‌های پوشش را برای تمام کرنل دریافت کنید، بلکه فقط برای زیردایرکتوری‌های خاص می‌خواهید، از این گزینه استفاده کنید. این گزینه می‌تواند بیش از یک بار مشخص شود. .sp توجه داشته باشید که بسته به نسخه پشتیبانی gcov در کرنل، ممکن است لازم باشد مسیر کامل زیردایرکتوری کرنل را مشخص کنید. .UNINDENT .UNINDENT .sp \fB\-l\fP \fItracefile\fP \fB\-\-list\fP \fItracefile\fP .INDENT 0.0 .INDENT 3.5 فهرست کردن محتویات \fItracefile\fP\&. .sp در هر بار فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary قابل استفاده است. .UNINDENT .UNINDENT .sp \fB\-\-list\-full\-path\fP \fB\-\-no\-list\-full\-path\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن نمایش یا عدم نمایش مسیرهای کامل هنگام عملیات لیست. .sp از –list\-full\-path برای نمایش مسیرهای کامل هنگام عملیات لیست، یا از –no\-list\-full\-path برای نمایش مسیرهای کوتاه شده استفاده کنید. مسیرها به صورت پیش‌فرض \fBکوتاه شده\fP هستند. .UNINDENT .UNINDENT .sp \fB\-\-no\-markers\fP .INDENT 0.0 .INDENT 3.5 اگر می‌خواهید داده‌های پوشش را بدون توجه به نشانگرهای استثنا (exclusion markers) در پرونده کد منبع دریافت کنید، از این گزینه استفاده کنید. برای جزئیات در مورد نشانگرهای استثنا به \fBgeninfo (1)\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-no\-recursion\fP .INDENT 0.0 .INDENT 3.5 اگر می‌خواهید داده‌های پوشش را فقط برای دایرکتوری مشخص‌شده بدون پردازش زیردایرکتوری‌ها دریافت کنید، از این گزینه استفاده کنید. .UNINDENT .UNINDENT .sp \fB\-o\fP \fItracefile\fP \fB\-\-output\-file\fP \fItracefile\fP .INDENT 0.0 .INDENT 3.5 نوشتن داده‌ها در \fItracefile\fP به جای خروجی استاندارد (stdout). .sp برای استفاده از خروجی استاندارد، “\-” را به عنوان نام پرونده مشخص کنید. .sp طبق قرارداد، پرونده‌های داده پوشش تولیدشده توسط lcov به عنوان «tracefile» شناخته می‌شوند و باید پسوند نام پرونده “.info” داشته باشند. .UNINDENT .UNINDENT .sp \fB\-v\fP \fB\-\-verbose\fP .INDENT 0.0 .INDENT 3.5 افزایش پرگویی (verbosity) پیام‌های اطلاعاتی. این عمدتاً برای اشکال‌زدایی اسکریپت و/یا جریان کار استفاده می‌شود \- \fIبرای مثال\fP، برای پی بردن به اینکه کدام پرونده داده در کجا پیدا شده است. همچنین گزینه –quiet را ببینید. .sp پیام‌ها به stdout فرستاده می‌شوند مگر اینکه هیچ پرونده خروجی وجود نداشته باشد (\fIیعنی\fP اگر داده‌های پوشش به جای پرونده در stdout نوشته شوند)، که در این صورت به stderr فرستاده می‌شوند. .UNINDENT .UNINDENT .sp \fB\-q\fP \fB\-\-quiet\fP .INDENT 0.0 .INDENT 3.5 کاهش پرگویی پیام‌های اطلاعاتی. .sp کاهش پرگویی برای مثال پیام‌های «پیشرفت» را سرکوب می‌کند \- در حالی که پیام‌های خطا و هشدار همچنان چاپ خواهند شد. .UNINDENT .UNINDENT .sp \fB\-\-debug\fP .INDENT 0.0 .INDENT 3.5 افزایش پرگویی «پیام‌های اشکال‌زدایی». این ویژگی در درجه اول برای توسعه‌دهندگانی مفید است که می‌خواهند مجموعه ابزار lcov را بهبود دهند. .UNINDENT .UNINDENT .sp \fB\-\-parallel\fP [\fIinteger\fP] \fB\-j\fP [\fIinteger\fP] .INDENT 0.0 .INDENT 3.5 مشخص کردن میزان موازی‌سازی مورد استفاده در طول پردازش (حداکثر تعداد فرآیندهای فرزند موازی). اگر پارامتر اختیاری عدد صحیح موازی‌سازی صفر باشد یا مشخص نشود، از تمام هسته‌های موجود در دستگاه استفاده می‌شود. حالت پیش‌فرض استفاده از یک فرآیند منفرد (بدون موازی‌سازی) است. .sp همچنین به مدخل‌های \fImemory, memory_percentage, max_fork_fails\fP و \fIfork_fail_timeout\fP در راهنمای \fBlcovrc(5) \%\fP\& مراجعه کنید. یک نمایه (profile) اجرای از پیش تولید شده می‌تواند به بهره‌برداری بهتر و اجرای موازی سریع‌تر کمک کند. بخش‌های \fI“–profile”\fP و \fI“–history”\fP در این صفحه راهنما را ببینید. .UNINDENT .UNINDENT .sp \fB\-\-memory\fP \fIinteger\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن حداکثر مقدار حافظه مورد استفاده در طول پردازش موازی، بر حسب مگابایت. در عمل، در صورتی که این حد فراتر رود، فرآیند fork() انجام نمی‌شود. مقدار پیش‌فرض 0 (صفر) است \- به این معنی که هیچ محدودیتی وجود ندارد. .sp این گزینه زمانی مفید است که محیط محاسباتی محدودیت‌های شدیدی بر مصرف منابع اعمال می‌کند به طوری که اگر کار سعی کند فرآیندهای موازی بیش از حدی ایجاد کند، متوقف خواهد شد \- اما کاربر از قبل نمی‌داند حداکثر مجاز چقدر است. این گزینه ابزار را قادر می‌سازد تا از حداکثر موازی‌سازی \- تا حد تعیین‌شده توسط محدودیت حافظه \- استفاده کند. .sp گزینه \fImemory_percentage\fP در پرونده پیکربندی روش دیگری برای تنظیم حداکثر مصرف حافظه ارائه می‌دهد. برای جزئیات به راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-rc\fP \fIkeyword\fP=\fIvalue\fP .INDENT 0.0 .INDENT 3.5 بازنویسی و نادیده‌گیری یک دستورالعمل پیکربندی. .sp از این گزینه برای مشخص کردن دستور \fIkeyword\fP=\fIvalue\fP استفاده کنید که دستور پیکربندی متناظر را در پرونده پیکربندی lcovrc لغو و بازنویسی می‌کند. می‌توانید این گزینه را بیش از یک بار مشخص کنید تا چندین دستور پیکربندی را بازنویسی کنید. برای مشاهده فهرستی از کلیدواژه‌های موجود و معنای آن‌ها به راهنمای \fBlcovrc(5) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-r\fP \fItracefile pattern\fP \fB\-\-remove\fP \fItracefile pattern\fP .INDENT 0.0 .INDENT 3.5 حذف داده‌ها از \fItracefile\fP\&. .sp اگر می‌خواهید داده‌های پوشش را برای مجموعه خاصی از پرونده‌ها از یک tracefile حذف کنید، از این سوییچ استفاده کنید. پارامترهای اضافی خط فرمان به عنوان الگوهای وایلدکارد پوسته تفسیر می‌شوند (توجه داشته باشید که ممکن است نیاز باشد آن‌ها را به درستی اسکیپ کنید تا از گسترش زودهنگام توسط پوسته جلوگیری شود). هر مدخل پرونده در \fItracefile\fP که با حداقل یکی از این الگوها مطابقت داشته باشد، حذف خواهد شد. .sp توجه: الگو باید به گونه‌ای مشخص شود که با مسیر \fBمطلق\fP هر پرونده کد منبع مطابقت داشته باشد. .sp نتیجه عملیات حذف در خروجی استاندارد یا tracefile مشخص‌شده با \-o نوشته خواهد شد. .sp در هر بار فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary قابل استفاده است. .UNINDENT .UNINDENT .sp \fB\-\-summary\fP \fItracefile\fP .INDENT 0.0 .INDENT 3.5 نمایش خلاصه اطلاعات پوشش برای tracefile مشخص‌شده. .sp توجه داشته باشید که می‌توانید این گزینه را بیش از یک بار مشخص کنید. .sp در هر بار فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary قابل استفاده است. .UNINDENT .UNINDENT .sp \fB\-\-fail\-under\-branches\fP \fIpercentage\fP .INDENT 0.0 .INDENT 3.5 از این گزینه استفاده کنید تا به lcov دستور دهید در صورتی که پوشش کل شاخه‌ها کمتر از \fIpercentage\fP باشد، با وضعیت خروج 1 خارج شود. .UNINDENT .UNINDENT .sp \fB\-\-fail\-under\-lines\fP \fIpercentage\fP .INDENT 0.0 .INDENT 3.5 از این گزینه استفاده کنید تا به lcov دستور دهید در صورتی که پوشش کل خطوط کمتر از \fIpercentage\fP باشد، با وضعیت خروج 1 خارج شود. .UNINDENT .UNINDENT .sp \fB\-t\fP \fItestname\fP \fB\-\-test\-name\fP \fItestname\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن نام آزمون برای ذخیره در tracefile. .sp این نام یک مجموعه داده پوشش را زمانی که بیش از یک مجموعه داده در یک tracefile ترکیبی ادغام می‌شوند، مشخص می‌کند (گزینه \-a را ببینید). .sp نام‌های معتبر آزمون می‌توانند شامل حروف، ارقام ده‌دهی و نویسه زیرخط (“_”) باشند. .UNINDENT .UNINDENT .sp \fB\-\-to\-package\fP \fIpackage\fP .INDENT 0.0 .INDENT 3.5 ذخیره پرونده‌های .da برای پردازش‌های بعدی. .sp اگر دستگاه‌های مجزایی برای ساخت و آزمون دارید و می‌خواهید ایجاد پرونده .info را روی دستگاه ساخت انجام دهید، از این گزینه استفاده کنید. برای انجام این کار، مراحل زیر را دنبال کنید: .sp روی دستگاه آزمون: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 اجرای آزمون .IP \(bu 2 اجرای lcov \-c [\-d directory] –to\-package \fIfile\fP .IP \(bu 2 کپی \fIfile\fP به دستگاه ساخت .UNINDENT .UNINDENT .UNINDENT .sp روی دستگاه ساخت: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 اجرای lcov \-c –from\-package \fIfile\fP [\-o و سایر گزینه‌ها] .UNINDENT .UNINDENT .UNINDENT .sp این روش هم برای داده‌های پوشش کرنل و هم فضای کاربر کار می‌کند. توجه داشته باشید که ممکن است لازم باشد مسیر دایرکتوری ساخت را با استفاده از \-b همراه با –to\-package یا –from\-package مشخص کنید. همچنین توجه داشته باشید که داده‌های بسته باید قبل از کامپایل مجدد برنامه به پرونده .info تبدیل شوند، در غیر این صورت نامعتبر خواهند شد. .UNINDENT .UNINDENT .sp \fB\-\-version\fP .INDENT 0.0 .INDENT 3.5 چاپ شماره نسخه و سپس خروج. .UNINDENT .UNINDENT .sp \fB\-z\fP \fB\-\-zerocounters\fP .INDENT 0.0 .INDENT 3.5 بازنشانی تمام شمارنده‌های اجرا به صفر. .sp به طور پیش‌فرض تلاش می‌کند شمارنده‌های اجرای کرنل را بازنشانی کند. از گزینه –directory برای بازنشانی تمام شمارنده‌های یک برنامه در فضای کاربر استفاده کنید. .sp در هر بار فقط یکی از گزینه‌های \-z، \-c، \-a، \-e، \-r، \-l، –diff یا –summary قابل استفاده است. .UNINDENT .UNINDENT .sp \fB\-\-tempdir\fP \fIdirname\fP .INDENT 0.0 .INDENT 3.5 نوشتن داده‌های موقت و میانی در دایرکتوری مشخص‌شده. مقدار پیش‌فرض “/tmp” است. .UNINDENT .UNINDENT .SH "فایل‌ها (FILES)" .sp \fI/etc/lcovrc\fP .INDENT 0.0 .INDENT 3.5 پرونده پیکربندی سراسری سیستم. .UNINDENT .UNINDENT .sp \fI~/.lcovrc\fP .INDENT 0.0 .INDENT 3.5 پرونده پیکربندی اختصاصی هر کاربر. .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" .sp Peter Oberparleiter <\%> .sp Henry Cox <\%> .INDENT 0.0 .INDENT 3.5 بخش‌های فیلترسازی، مدیریت خطا، اجرای موازی. .UNINDENT .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fBlcovrc(5) \%\fP, \fBgenhtml(1) \%\fP, \fBgeninfo(1) \%\fP, \fBgendesc(1) \%\fP, \fBgcov(1) \%\fP \fBllvm2lcov(1) \%\fP \fBpy2lcov(1) \%\fP \fBperl2lcov(1) \%\fP .sp \fIhttps://github.com/linux\-test\-project/lcov\fP .SH "حق نشر (COPYRIGHT)" 2024-2026, LCOV Project .\" End of generated man page.