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*\ =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* ]

lcov -z | --zerocounters
    [ -d | --directory *directory* ]
    [ --no-recursion ]
    [ -f | --follow ]

lcov -l | --list *tracefile*
    [ --list-full-path ]
    [ --no-list-full-path ]

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 ]

lcov -e | --extract *tracefile pattern*
    [ -o | --output-file *tracefile* ]
    [ --checksum ]
    [ --no-checksum ]

lcov -r | --remove *tracefile pattern*
    [ -o | --output-file *tracefile* ]
    [ --checksum ]
    [ --no-checksum ]

lcov --intersect *rh_glob_pattern*
    [ -o | --output-file *tracefile* ]
    lh_glob_pattern

lcov --subtract *rh_glob_pattern*
    [ -o | --output-file *tracefile* ]
    lh_glob_pattern

lcov --summary *tracefile*

lcov [ -h | --help ]
    [ --version ]

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*\ =\ *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* ]

با استفاده از گزینه -a چندین فایل ردگیری (tracefile) را مشخص کنید تا داده‌های پوشش موجود در این فایل‌ها با جمع زدن تعداد دفعات اجرا برای ترکیب‌های منطبق تست و نام فایل با یکدیگر ترکیب شوند.

نتیجه عملیات افزودن در خروجی استاندارد (stdout) یا فایل ردگیری مشخص‌شده با -o نوشته خواهد شد.

در هر زمان فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l یا –summary را می‌توان مشخص کرد.

از این گزینه برای تعیین دایرکتوری پایه محیط ساخت (build-environment) زمانی که lcov پیام‌های خطایی مانند زیر تولید می‌کند استفاده کنید:

ERROR: could not read source file /home/user/project/subdir1/subdir2/subdir1/subdir2/file.c

در این مثال، از /home/user/project به‌عنوان دایرکتوری پایه استفاده کنید.

این گزینه هنگام استفاده از lcov در پروژه‌های ساخته‌شده با libtool یا محیط‌های ساخت مشابه که با یک دایرکتوری پایه کار می‌کنند لازم است؛ یعنی محیط‌هایی که در آن‌ها دایرکتوری کاری جاری هنگام فراخوانی کامپایلر، با دایرکتوری محل قرارگیری فایل کد منبع یکسان نیست.

توجه داشته باشید که این گزینه در محیط‌هایی که از چندین دایرکتوری پایه استفاده می‌کنند کار نخواهد کرد. در این حالت از تنظیم فایل پیکربندی geninfo_auto_base=1 استفاده کنید (به صفحه راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید).

برای جزئیات بیشتر به صفحه راهنمای geninfo(1) <file://../man/geninfo.1.html> مراجعه کنید.

برای مسیرهای نسبی فایل‌های منبع فهرست‌شده در به‌عنوان مثال مسیرهای یافت‌شده در tracefile، یا یافت‌شده در خروجی gcov در حین –capture - احتمالاً پس از اعمال جایگزینی‌ها - ابزار lcov ابتدا مسیر را از ‘cwd’ (جایی که genhtml فراخوانی شده است) و سپس از هر نام دایرکتوری جایگزین به ترتیب مشخص‌شده جستجو خواهد کرد. نخستین مکان منطبق استفاده می‌شود.

این گزینه می‌تواند چندین بار مشخص شود تا دایرکتوری‌های بیشتری به مسیر جستجوی منبع افزوده شود.

به‌طور پیش‌فرض تعداد دفعات اجرای جاری هسته را ضبط کرده و داده‌های پوشش حاصل را در خروجی استاندارد می‌نویسد. از گزینه –directory برای ضبط شمارنده‌ها برای یک برنامه فضای کاربری استفاده کنید.

نتیجه عملیات ضبط در stdout یا فایل ردگیری مشخص‌شده با -o نوشته خواهد شد.

هنگام ترکیب با فلگ --all هر دو پوشش زمان اجرا و زمان کامپایل در یک مرحله استخراج خواهند شد. توضیحات مربوط به فلگ --initial در زیر را ببینید.

برای جزئیات بیشتر درباره فرآیند ضبط و گزینه‌ها و پارامترهای موجود به صفحه راهنمای geninfo(1) <file://../man/geninfo.1.html>) مراجعه کنید.

در هر زمان فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l، –diff یا –summary را می‌توان مشخص کرد.

این معادل استفاده از گزینه “–rc branch_coverage=1” است؛ این گزینه برای سازگاری بهتر با رابط genhtml اضافه شده است.

این معادل استفاده از گزینه “–rc mcdc_coverage=1” است. پوشش MC/DC برای نگارش‌های GCC نسخه 14.2 و بالاتر، یا LLVM نسخه 18.1 و بالاتر پشتیبانی می‌شود.

برای جزئیات بیشتر درباره ضبط داده‌های MC/DC در LLVM به llvm2lcov –help مراجعه کنید.

برای جزئیات بیشتر بخش MC/DC از صفحه راهنمای genhtml(1) <file://../man/genhtml.1.html> را ببینید.

از –checksum برای فعال‌سازی تولید چکسام یا از –no-checksum برای غیرفعال کردن آن استفاده کنید. تولید چکسام به‌طور پیش‌فرض غیرفعال است.

هنگامی که تولید چکسام فعال باشد، برای هر خط از کد منبع یک چکسام ایجاد شده و همراه با داده‌های پوشش ذخیره می‌شود. این چکسام برای جلوگیری از تلاش برای ترکیب داده‌های پوشش از نگارش‌های مختلف کد منبع استفاده خواهد شد.

اگر با نگارش‌های مختلف کد منبع کار نمی‌کنید، این گزینه را غیرفعال کنید تا پردازش داده‌های پوشش سریع‌تر شده و اندازه فایل‌های ردگیری کاهش یابد.

توجه داشته باشید که این گزینه تا حدی تحت‌الشعاع گزینه --version-script قرار دارد - که عملکردی مشابه انجام می‌دهد، اما در سطح «کل فایل».

از –compat برای تعیین اینکه lcov باید هنگام ضبط داده‌های پوشش یک یا چند حالت سازگاری را فعال کند استفاده کنید. می‌توانید یک فهرست جداشده با کاما از جفت‌های mode=value برای مشخص کردن مقادیر چندین حالت ارائه دهید.

مقادیر معتبر عبارتند از:

on

off

auto

اگر مقداری مشخص نشود، ‘on’ به‌عنوان مقدار پیش‌فرض در نظر گرفته می‌شود.

حالت‌های معتبر عبارتند از:

libtool

hammer

split_crc

از –compat-libtool برای فعال‌سازی حالت سازگاری libtool یا از –no-compat-libtool برای غیرفعال کردن آن استفاده کنید. حالت سازگاری libtool به‌طور پیش‌فرض فعال است.

هنگامی که حالت سازگاری libtool فعال باشد، lcov فرض می‌کند که کد منبع مربوط به یک فایل .da واقع در دایرکتوری با نام “.libs” را می‌توان در دایرکتوری والد آن پیدا کرد.

اگر در محیط ساخت خود دایرکتوری‌هایی با نام “.libs” دارید اما از libtool استفاده نمی‌کنید، این گزینه را غیرفعال کنید تا از بروز مشکل هنگام ضبط داده‌های پوشش جلوگیری شود.

هنگامی که این گزینه مشخص شود، نه فایل پیکربندی سراسری سیستم /etc/lcovrc و نه فایل پیکربندی ویژه هر کاربر ~/.lcovrc خوانده نخواهد شد.

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

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

برای اطلاعات بیشتر به صفحه راهنمای genhtml(1) <file://../man/genhtml.1.html> مراجعه کنید.

اگر می‌خواهید روی داده‌های پوشش برای یک برنامه فضای کاربری کار کنید، از این گزینه برای تعیین مکانی که برنامه در آن کامپایل شده است استفاده کنید (اینجاست که فایل‌های شمارنده با پسوند .da ذخیره می‌شوند).

توجه داشته باشید که می‌توانید این گزینه را بیش از یک بار مشخص کنید.

اگر می‌خواهید داده‌های پوشش را برای مجموعه خاصی از فایل‌های مبدأ منطبق با هر یک از الگوهای داده‌شده مستثنی کنید، از این سوییچ استفاده کنید. با استفاده از چندین سوییچ خط فرمان --exclude می‌توان چندین الگو را مشخص کرد. patternها به عنوان الگوهای وایلدکارت شل تفسیر خواهند شد (توجه داشته باشید که ممکن است لازم باشد برای جلوگیری از بسط اولیه آن‌ها توسط شل، به درستی اسکیپ شوند).

نکته: الگو باید طوری مشخص شود که با مسیر مطلق (absolute) هر فایل مبدأ مطابقت داشته باشد. اگر الگویی را مشخص کنید که به نظر می‌رسد به درستی اعمال نمی‌شود - فایل‌هایی که انتظار داشتید مستثنی شوند همچنان در خروجی ظاهر می‌شوند - می‌توانید به دنبال پیام‌های هشدار در فایل لاگ بگردید. lcov برای هر الگویی که حداقل یک بار اعمال نشود، یک هشدار صادر می‌کند.

می‌تواند با سوییچ خط فرمان --include ترکیب شود. اگر یک فایل مشخص هم با الگوی include و هم با الگوی exclude مطابقت داشته باشد، الگوی exclude اولویت خواهد داشت.

توجه داشته باشید که این گزینه نیازمند استفاده از نسخه‌ای از gcc است که به اندازه کافی جدید باشد تا از گزارش خط شروع/پایان تابع پشتیبانی کند، یا اینکه ابزار را برای استخراج داده‌های لازم پیکربندی کنید - به بحث derive_function_end_line در صفحه راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید.

از این گزینه در شرایطی استفاده کنید که geninfo نمی‌تواند مسیر صحیح فایل‌های کد منبع یک پروژه را پیدا کند. با ارائه یک regexp_pattern در قالب عبارت منظم پرل (به صفحه راهنمای perlre(1) <file://../man/perlre.1.html> مراجعه کنید)، می‌توانید به geninfo دستور دهید بخش‌هایی از مسیر نادرست مبدأ را حذف یا تغییر دهد. همچنین به گزینه --resolve-script مراجعه کنید.

می‌توان یک یا چند الگوی –substitution و/یا یک –resolve-script را مشخص کرد. هنگامی که چندین الگو مشخص می‌شود، آن‌ها به ترتیبی که تعیین شده‌اند اعمال می‌شوند؛ ابتدا الگوهای جایگزینی و سپس کال‌بک resolve. ترتیب جستجوی فایل به این صورت است:

جایگزینی‌ها در چندین زمینه توسط lcov/genhtml/geninfo استفاده می‌شوند:

اگر می‌خواهید داده‌های پوشش خط و انشعاب را برای برخی ساختارهای خاص در کد خود مستثنی کنید (برای مثال، یک ماکروی پیچیده)، از این سوییچ استفاده کنید. با استفاده از چندین سوییچ خط فرمان --omit-lines می‌توان چندین الگو را مشخص کرد. regexp به عنوان عبارات منظم پرل تفسیر خواهد شد (توجه داشته باشید که ممکن است لازم باشد برای جلوگیری از بسط اولیه آن‌ها توسط شل، به درستی اسکیپ شوند). اگر می‌خواهید الگو به صراحت از ابتدا یا انتهای خط مطابقت داده شود، regexp شما باید با “^” و/یا “$” شروع و/یا پایان یابد.

توجه داشته باشید که تنظیم فایل پیکربندی lcovrc یعنی lcov_excl_line = regexp مشابه با --omit-lines است. --omit-lines زمانی مفید است که چندین تیم وجود دارند که هر کدام می‌خواهند الگوهای خاصی را مستثنی کنند. --omit-lines خاصیت افزایشی دارد و می‌تواند در چندین فایل کانفیگ مشخص شود، در حالی که هر بار فراخوانی lcov_excl_line مقدار قبلی را بازنویسی می‌کند - و بنابراین تیم‌ها باید هماهنگ باشند.

فایل‌های مبدأ خارجی فایل‌هایی هستند که در هیچ‌یک از دایرکتوری‌های مشخص‌شده توسط –directory یا –base-directory قرار ندارند. برای گنجاندن نقاط پوشش (coverpoints) در فایل‌های مبدأ خارجی هنگام دریافت داده‌های پوشش از –external و برای مستثنی کردن آن‌ها از –no-external استفاده کنید. اگر مسیر –directory یا –base-directory شما حاوی یک پیوند نرم (soft link) باشد، دایرکتوری هدف واقعی «داخلی» در نظر گرفته نمی‌شود مگر اینکه از گزینه –follow استفاده شود.

گزینه –no-external ابزاری تا حدی خام و کلی است؛ گزینه‌های –exclude و –include کنترل دقیق‌تری بر اینکه چه داده‌های پوششی گنجانده شده یا نشوند در صورت پیچیده بودن ساختار پروژه و/یا در حالتی که –no-external رفتار مد نظر شما را انجام ندهد، فراهم می‌کنند.

داده‌های فایل‌های مبدأ خارجی به صورت پیش‌فرض گنجانده می‌شوند (included).

این گزینه همچنین می‌تواند به صورت دائمی با استفاده از گزینه فایل پیکربندی forget_testcase_names پیکربندی شود.

از این گزینه برای تعیین فهرستی از فایل‌های ردگیری یکتا از میان فهرست مشخص‌شده توسط --add-tracefile استفاده کنید. یک فایل ردگیری در صورتی یکتا در نظر گرفته می‌شود که تنها فایل ردگیری باشد که:

توجه داشته باشید که فهرست فایل‌های نگه‌داشته‌شده ممکن است به ترتیبی که پردازش می‌شوند بستگی داشته باشد. برای مثال، اگر A و B حاوی داده‌های پوشش یکسان باشند، اولین فایلی که مشاهده می‌شود نگه‌داشته شده و دومی هرس (prune) خواهد شد. هنگامی که از گزینه --parallel استفاده می‌شود، ترتیب پردازش فایل غیرقطعی (nondeterministic) است - به این معنی که نتیجه هرس‌شده در این حالت ممکن است از یک اجرا تا اجرای بعدی متفاوت باشد.

--prune-tests باید همراه با --add-tracefile مشخص شود. در صورت مشخص شدن، lcov به جای داده‌های فایل ردگیری ترکیبی، فهرست فایل‌های یکتا را صادر خواهد کرد.

از این گزینه برای تعیین فهرست فایل‌های ردگیری حاوی داده‌های پوشش غیرصفر برای هر تابع از میان فهرست فایل‌های ردگیری مشخص‌شده توسط --add-tracefile استفاده کنید.

این گزینه باید همراه با --add-tracefile مشخص شود. در صورت مشخص شدن، lcov به جای داده‌های فایل ردگیری ترکیبی، فهرست توابع و فایل‌های ردگیری مرتبط را صادر خواهد کرد.

برای جزئیات بیشتر درباره اسکریپت زمینه (context script)، به صفحه راهنمای genhtml مراجعه کنید.

برای جزئیات بیشتر درباره اسکریپت معیارها، صفحه راهنمای genhtml را ببینید. توجه داشته باشید که lcov اطلاعات تاریخ و مالک را ردیابی نمی‌کند (به مدخل –annotate-script در صفحه راهنمای genhtml مراجعه کنید) - بنابراین این اطلاعات به بازخوانی (callback) lcov منتقل نمی‌شوند.

برای جزئیات بیشتر درباره اسکریپت نسخه، صفحه راهنمای genhtml را ببینید.

توجه داشته باشید که “module” الزاماً باید یک ماژول Perl باشد.

برای جزئیات بیشتر، صفحه راهنمای genhtml را ببینید.

یادداشت‌ها می‌توانند برای مستندسازی شرایطی که فایل ردگیری تحت آن تولید شده مفید باشند: میزبان، تاریخ، محیط و غیره.

توجه داشته باشید که این گزینه برای عملیات‌های lcov که فایل نتیجه خروجی نمی‌نویسند هیچ تاثیری ندارد: –list –summary، –prune-tests، و –map-functions.

برای شرح قالب یادداشت‌ها در فایل نتیجه، به صفحه راهنمای geninfo مراجعه کنید.

اگر می‌خواهید داده‌های پوشش آزمون را تنها برای مجموعه‌ای خاص از فایل‌ها از یک فایل ردگیری استخراج کنید، از این سوییچ استفاده نمایید. پارامترهای خط فرمان اضافی به عنوان الگوهای وایلدکارت شل تفسیر خواهند شد (توجه داشته باشید که ممکن است لازم باشد به شکل مناسب اسکیپ شوند تا از بسط زودهنگام توسط شل جلوگیری شود). هر مدخل فایل در tracefile که حداقل با یکی از آن الگوها مطابقت داشته باشد استخراج خواهد شد.

توجه: الگو باید طوری مشخص شود که با مسیر مطلق هر فایل منبع مطابقت داشته باشد.

نتیجه عملیات استخراج در stdout یا فایل ردگیری مشخص‌شده با -o نوشته خواهد شد.

در هر بار فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l، –diff یا –summary را می‌توان مشخص کرد.

اگر ماشین‌های جداگانه‌ای برای ساخت و آزمایش دارید و می‌خواهید ایجاد فایل .info را روی ماشین ساخت انجام دهید، از این گزینه استفاده کنید. برای اطلاعات بیشتر به –to-package مراجعه کنید.

برای جزئیات بیشتر، صفحه راهنمای geninfo را ببینید.

اگر می‌خواهید داده‌های پوشش آزمون را فقط برای مجموعه خاصی از فایل‌های منبع که با هر یک از الگوهای داده‌شده مطابقت دارند شامل کنید، از این سوییچ استفاده نمایید. با استفاده از چندین سوییچ خط فرمان --include می‌توان چندین الگو را مشخص کرد. patterns به عنوان الگوهای وایلدکارت شل تفسیر خواهند شد (توجه داشته باشید که ممکن است برای جلوگیری از بسط آنها توسط شل، نیاز به اسکیپ مناسب باشد).

توجه: الگو باید به گونه‌ای مشخص شود که با مسیر مطلق هر فایل منبع مطابقت داشته باشد.

اگر الگویی مشخص کنید که به نظر نمی‌رسد به درستی اعمال شود - فایل‌هایی که انتظار داشتید در خروجی گنجانده شوند ظاهر نشوند - ابزار lcov یک پیام خطای نوع ‘unused’ تولید خواهد کرد. برای چگونگی نادیده گرفتن خطا یا تبدیل آن به یک هشدار توسط lcov، به گزینه –ignore-errors مراجعه کنید.

از این گزینه برای مشخص کردن فهرستی از یک یا چند دسته از خطاها استفاده کنید که lcov پس از آنها به جای توقف، باید پردازش را ادامه دهد. توجه داشته باشید که ابزار یک هشدار (به جای خطای مهلک) تولید خواهد کرد، مگر اینکه دو (یا چند) بار خطا را نادیده بگیرید:

lcov ... --ignore-errors source,source ...

errors می‌تواند فهرستی از کلمات کلیدی زیر باشد که با کاما از هم جدا شده‌اند:

branch

callback

child

corrupt

count

deprecated

empty

excessive

fork

format

gcov

graph

inconsistent

internal

mismatch

missing

negative

package

parallel

parent

range

source

unreachable

unsupported

unused

usage

utility

version

همچنین برای بررسی پارامتر ‘max_message_count’ که می‌توان از آن برای کنترل تعداد هشدارهای صادرشده پیش از سرکوب تمام پیام‌های بعدی استفاده کرد، به صفحه راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید. از این کار می‌توان برای کاهش حجم فایل لاگ استفاده کرد.

برای جزئیات بیشتر درباره این گزینه به راهنمای genhtml(1) <file://../man/genhtml.1.html> و همچنین برای شرح گزینه معادل در پرونده پیکربندی به بخش “expect_message_count” در راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید.

این گزینه خط فرمان متناظر با گزینه stop_on_error [0|1] در lcovrc است. برای جزئیات بیشتر به راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید.

پیش از اجرای هر مورد آزمون، lcov را با گزینه -c و این گزینه روی دایرکتوری‌های حاوی پرونده‌های .bb، .bbg یا .gcno اجرا کنید. نتیجه یک پرونده داده پوشش «پایه» (baseline) خواهد بود که برای هر خط کد دارای ابزار دقیق، مقدار پوشش صفر دارد. این پرونده داده را (با استفاده از lcov -a) با پرونده‌های داده پوشش ثبت‌شده پس از اجرای آزمون ترکیب کنید تا مطمئن شوید که درصد کل خطوط پوشش داده شده حتی زمانی که تمام پرونده‌های کد منبع در طول آزمون بارگذاری نشده‌اند، صحیح است.

روال پیشنهادی هنگام ثبت داده‌ها برای یک مورد آزمون:

# lcov -c -i -d appdir -o app_base.info

# appdir/test

# lcov -c -d appdir -o app_test.info

# lcov -a app_base.info -a app_test.info -o app_total.info

چهار مرحله فوق معادل است با:

# lcov --capture --all -o app_total.info -d appdir

اگر پروژه شما شامل چند واحد کامپایل باشد که در هیچ‌یک از برنامه‌های اجرایی یا کتابخانه‌های مشترک موارد آزمون استفاده نشده باشند - یعنی برخی پرونده‌های داده ‘.gcno’ (زمان کامپایل) وجود داشته باشند که پرونده داده ‘.gcda’ (زمان اجرا) متناظر ندارند - داده‌های ترکیبی زمان کامپایل و زمان اجرا نتیجه متفاوتی نسبت به ثبت داده‌های زمان اجرا به تنهایی ایجاد می‌کنند. در این حالت، گزارش فقط زمان اجرا شامل هیچ نقطه پوششی (coverpoint) از پرونده‌های استفاده‌نشده نخواهد بود، در حالی که این نقاط پوشش (با تعداد دفعات اجرای صفر) در گزارش ترکیبی ظاهر خواهند شد.

گزینه --initial به جز در حالت --capture نادیده گرفته می‌شود. در صورت مشخص شدن گزینه --initial ، گزینه --all نادیده گرفته خواهد شد.

اگر نمی‌خواهید داده‌های پوشش را برای تمام کرنل دریافت کنید، بلکه فقط برای زیردایرکتوری‌های خاص می‌خواهید، از این گزینه استفاده کنید. این گزینه می‌تواند بیش از یک بار مشخص شود.

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

در هر بار فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l، –diff یا –summary قابل استفاده است.

از –list-full-path برای نمایش مسیرهای کامل هنگام عملیات لیست، یا از –no-list-full-path برای نمایش مسیرهای کوتاه شده استفاده کنید. مسیرها به صورت پیش‌فرض کوتاه شده هستند.

برای استفاده از خروجی استاندارد، “-” را به عنوان نام پرونده مشخص کنید.

طبق قرارداد، پرونده‌های داده پوشش تولیدشده توسط lcov به عنوان «tracefile» شناخته می‌شوند و باید پسوند نام پرونده “.info” داشته باشند.

پیام‌ها به stdout فرستاده می‌شوند مگر اینکه هیچ پرونده خروجی وجود نداشته باشد (یعنی اگر داده‌های پوشش به جای پرونده در stdout نوشته شوند)، که در این صورت به stderr فرستاده می‌شوند.

کاهش پرگویی برای مثال پیام‌های «پیشرفت» را سرکوب می‌کند - در حالی که پیام‌های خطا و هشدار همچنان چاپ خواهند شد.

همچنین به مدخل‌های memory, memory_percentage, max_fork_fails و fork_fail_timeout در راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید. یک نمایه (profile) اجرای از پیش تولید شده می‌تواند به بهره‌برداری بهتر و اجرای موازی سریع‌تر کمک کند. بخش‌های “–profile” و “–history” در این صفحه راهنما را ببینید.

این گزینه زمانی مفید است که محیط محاسباتی محدودیت‌های شدیدی بر مصرف منابع اعمال می‌کند به طوری که اگر کار سعی کند فرآیندهای موازی بیش از حدی ایجاد کند، متوقف خواهد شد - اما کاربر از قبل نمی‌داند حداکثر مجاز چقدر است. این گزینه ابزار را قادر می‌سازد تا از حداکثر موازی‌سازی - تا حد تعیین‌شده توسط محدودیت حافظه - استفاده کند.

گزینه memory_percentage در پرونده پیکربندی روش دیگری برای تنظیم حداکثر مصرف حافظه ارائه می‌دهد. برای جزئیات به راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید.

از این گزینه برای مشخص کردن دستور keyword=value استفاده کنید که دستور پیکربندی متناظر را در پرونده پیکربندی lcovrc لغو و بازنویسی می‌کند. می‌توانید این گزینه را بیش از یک بار مشخص کنید تا چندین دستور پیکربندی را بازنویسی کنید. برای مشاهده فهرستی از کلیدواژه‌های موجود و معنای آن‌ها به راهنمای lcovrc(5) <file://../man/lcovrc.5.html> مراجعه کنید.

اگر می‌خواهید داده‌های پوشش را برای مجموعه خاصی از پرونده‌ها از یک tracefile حذف کنید، از این سوییچ استفاده کنید. پارامترهای اضافی خط فرمان به عنوان الگوهای وایلدکارد پوسته تفسیر می‌شوند (توجه داشته باشید که ممکن است نیاز باشد آن‌ها را به درستی اسکیپ کنید تا از گسترش زودهنگام توسط پوسته جلوگیری شود). هر مدخل پرونده در tracefile که با حداقل یکی از این الگوها مطابقت داشته باشد، حذف خواهد شد.

توجه: الگو باید به گونه‌ای مشخص شود که با مسیر مطلق هر پرونده کد منبع مطابقت داشته باشد.

نتیجه عملیات حذف در خروجی استاندارد یا tracefile مشخص‌شده با -o نوشته خواهد شد.

در هر بار فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l، –diff یا –summary قابل استفاده است.

توجه داشته باشید که می‌توانید این گزینه را بیش از یک بار مشخص کنید.

در هر بار فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l، –diff یا –summary قابل استفاده است.

این نام یک مجموعه داده پوشش را زمانی که بیش از یک مجموعه داده در یک tracefile ترکیبی ادغام می‌شوند، مشخص می‌کند (گزینه -a را ببینید).

نام‌های معتبر آزمون می‌توانند شامل حروف، ارقام ده‌دهی و نویسه زیرخط (“_”) باشند.

اگر دستگاه‌های مجزایی برای ساخت و آزمون دارید و می‌خواهید ایجاد پرونده .info را روی دستگاه ساخت انجام دهید، از این گزینه استفاده کنید. برای انجام این کار، مراحل زیر را دنبال کنید:

روی دستگاه آزمون:

روی دستگاه ساخت:

این روش هم برای داده‌های پوشش کرنل و هم فضای کاربر کار می‌کند. توجه داشته باشید که ممکن است لازم باشد مسیر دایرکتوری ساخت را با استفاده از -b همراه با –to-package یا –from-package مشخص کنید. همچنین توجه داشته باشید که داده‌های بسته باید قبل از کامپایل مجدد برنامه به پرونده .info تبدیل شوند، در غیر این صورت نامعتبر خواهند شد.

به طور پیش‌فرض تلاش می‌کند شمارنده‌های اجرای کرنل را بازنشانی کند. از گزینه –directory برای بازنشانی تمام شمارنده‌های یک برنامه در فضای کاربر استفاده کنید.

در هر بار فقط یکی از گزینه‌های -z، -c، -a، -e، -r، -l، –diff یا –summary قابل استفاده است.