نام (NAME)

llvm2lcov - مستندات llvm2lcov

نام (NAME)

خلاصه دستور (SYNOPSIS)

llvm2lcov [--output filename] [--testname name] [options] json_file [json_file ...]

توضیحات (DESCRIPTION)

دستور llvm2lcov داده‌های پوشش کد C/C++ در قالب JSON (تولیدشده توسط llvm-cov export -format=text ...) را پیمایش کرده و آن‌ها را به قالب .info در LCOV تبدیل می‌کند.

توجه داشته باشید که LLVM از دو مسیر برای جمع‌آوری داده‌های پوشش کد پشتیبانی می‌کند: مسیری که در این صفحه شرح داده شده است - بر اساس داده‌های پروفایل - و یک مسیر gcov - مشابه آنچه توسط gcc پشتیبانی می‌شود. برای جزئیات بیشتر درباره پشتیبانی از gcov در LLVM، مستندات LLVM را ببینید.

پوشش MC/DC (MC/DC COVERAGE)

برای تولید داده‌های MC/DC:

توجه داشته باشید که LLVM هنگام استفاده از مسیر جمع‌آوری داده‌های gcov از معیارهای MC/DC پشتیبانی نمی‌کند.

گزینه‌ها (OPTIONS)

افزون بر گزینه‌های عمومی که توسط ابزارهای دیگر در مجموعه LCOV پشتیبانی می‌شوند (مانند --comment، --version-script، --ignore-error، --substitute، --exclude و غیره)، این ابزار گزینه‌های زیر را فراهم می‌کند:

برای جزئیات سایر گزینه‌ها و تنظیمات پیکربندی، lcov(1) <file://../man/lcov.1.html> و lcovrc(5) <file://../man/lcovrc.5.html> را ببینید.

مثال‌ها (EXAMPLES)

گردش کار پایه:

# کامپایل به همراه ابزاردقیق‌سازی پوشش کد (شامل MC/DC)
$ clang++ -o myExe -fprofile-inst-generate -fcoverage-mapping \
    -fcoverage-mcdc myCode.cpp
# اجرای موردآزمون‌ها
$ ./myExe ...
# تبدیل داده‌های پروفایل
$ llvm-profdata merge -o myExe.profdata --sparse *.profraw
# برون‌بری داده‌های پوشش در قالب JSON
$ llvm-cov export -format=text -instr-profile=myExe.profdata \
    ./myExe > myExe.json
# تبدیل به قالب LCOV
$ llvm2lcov --output myExe.info --test-name myTestcase \
    --mcdc-coverage --branch-coverage myExe.json ...
# تولید گزارش پوشش کد در قالب HTML
$ genhtml -o html_report myExe.info ...

(... نشان‌دهنده سایر گزینه‌های ابزار است که ممکن است استفاده کنید - برای مثال، برای پالایش و مستثنی‌سازی.)

اجرای همین مثال از طریق gcov به این صورت است:

# کامپایل با ابزاردقیق‌سازی gcov
$ clang++ -o myExe --coverage myCode.cpp
# اجرای موردآزمون‌ها
$ ./myExe ...
# تبدیل به قالب LCOV
#   توجه داشته باشید که گزینه '--gcov-tool' دو بار ذکر شده است: یک بار برای تعیین
#   ابزار و یک بار برای ارسال گزینه ابزار. برای اطلاعات بیشتر
#   به صفحه راهنمای lcov مراجعه کنید.
$ lcov --capture -d . --branch-coverage -o myExe.info --gcov-tool llvm-cov --gcov-tool gcov ...
# تولید گزارش پوشش کد در قالب HTML
$ genhtml -o html_report myExe.info ...

نویسندگان (AUTHORS)

Henry Cox <<henry.cox@mediatek.com>>

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

lcov(1) <file://../man/lcov.1.html>, genhtml(1) <file://../man/genhtml.1.html>, geninfo(1) <file://../man/geninfo.1.html>, lcovrc(5) <file://../man/lcovrc.5.html>,

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

2024-2026, LCOV Project