lcov

PROGRAMA:

NAME

lcov - isang graphical na GCOV na front-end

SINOPSIS

lcov -c|--huli
[-d|--direktoryo direktoryo] [-k|--kernel-directory direktoryo]
[-o|--output-file tracefile] [-t|--test-pangalan pangalan ng pagsubok]
[-b|--base-directory direktoryo] [-i|--paunang] [--gcov-tool kasangkapan]
[--checksum] [--walang-checksum] [--walang-recursion] [-f|--sundan]
[--compat-libtool] [--no-compat-libtool] [--ignore-errors error]
[--sa-package pakete] [--mula sa pakete pakete] [-q|--tahimik]
[--walang-marker] [--panlabas] [--walang-panlabas]
[--config-file config-file] [--rc keyword=halaga]
[--compat paraan=on|off|auto]

lcov -z|--zerocounters
[-d|--direktoryo direktoryo] [--walang-recursion] [-f|--sundan]
[-q|--tahimik]

lcov -l|--listahan tracefile
[-q|--tahimik] [--list-full-path] [--no-list-full-path]
[--config-file config-file] [--rc keyword=halaga]

lcov -a|--add-tracefile tracefile
[-o|--output-file tracefile] [--checksum] [--walang-checksum]
[-q|--tahimik] [--config-file config-file] [--rc keyword=halaga]

lcov -e|--extract tracefile huwaran
[-o|--output-file tracefile] [--checksum] [--walang-checksum]
[-q|--tahimik] [--config-file config-file] [--rc keyword=halaga]

lcov -r|--alisin tracefile huwaran
[-o|--output-file tracefile] [--checksum] [--walang-checksum]
[-q|--tahimik] [--config-file config-file] [--rc keyword=halaga]

lcov --diff tracefile Diff
[-o|--output-file tracefile] [--checksum] [--walang-checksum]
[--convert-filename] [--strip lalim] [--daanan landas] [-q|--tahimik]
[--config-file config-file] [--rc keyword=halaga]

lcov --buod tracefile
[-q|--tahimik]

lcov [-h|- Tumulong] [-v|--bersyon]

DESCRIPTION

lcov ay isang graphical na front-end para sa GCC's coverage testing tool gcov. Nangongolekta ito ng linya,
function at branch coverage data para sa maramihang source file at lumilikha ng mga HTML page
naglalaman ng source code na may annotate na impormasyon sa saklaw. Nagdaragdag din ito ng pangkalahatang-ideya
mga pahina para sa madaling pag-navigate sa loob ng istraktura ng file.

paggamit lcov upang mangolekta ng data ng saklaw at genhtml upang lumikha ng mga HTML na pahina. Ang data ng saklaw ay maaari
maaaring kolektahin mula sa kasalukuyang tumatakbong Linux kernel o mula sa isang user space
aplikasyon. Upang gawin ito, kailangan mong kumpletuhin ang mga sumusunod na hakbang sa paghahanda:

Para sa saklaw ng Linux kernel:
Sundin ang mga tagubilin sa pag-setup para sa imprastraktura ng gcov-kernel:
http://ltp.sourceforge.net/coverage/gcov.php

Para sa saklaw ng application ng espasyo ng gumagamit:
I-compile ang application gamit ang GCC gamit ang mga opsyon na "-fprofile-arcs" at
"-ftest-coverage".

Pakitandaan na ang man page na ito ay tumutukoy sa output format ng lcov bilang ".info file" o
"tracefile" at ang output ng GCOV ay tinatawag na ".da file".

Tandaan din na kapag ang mga porsyento ng pag-print, 0% at 100% ay naka-print lamang kapag ang mga halaga ay
eksaktong 0% at 100% ayon sa pagkakabanggit. Iba pang mga halaga na karaniwang bi-round sa 0%
o 100% sa halip ay naka-print bilang pinakamalapit na hindi hangganan na halaga. Ang pag-uugali na ito ay naaayon
kasama ng mga gcov(1) kasangkapan.

Opsyon

-a tracefile
--add-tracefile tracefile
Magdagdag ng mga nilalaman ng tracefile.

Tumukoy ng ilang tracefile gamit ang -a switch upang pagsamahin ang data ng saklaw
nakapaloob sa mga file na ito sa pamamagitan ng pagdaragdag ng mga bilang ng pagpapatupad para sa pagtutugma ng pagsubok at
mga kumbinasyon ng filename.

Ang resulta ng add operation ay isusulat sa stdout o sa tracefile
tinukoy ng -o.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

-b direktoryo
--base-directory direktoryo
paggamit direktoryo bilang base na direktoryo para sa mga kamag-anak na landas.

Gamitin ang opsyong ito upang tukuyin ang batayang direktoryo ng isang build-environment kapag lcov
gumagawa ng mga mensahe ng error tulad ng:

ERROR: hindi mabasa ang source file
/home/user/project/subdir1/subdir2/subdir1/subdir2/file.c

Sa halimbawang ito, gamitin ang /home/user/project bilang base na direktoryo.

Kinakailangan ang opsyong ito kapag gumagamit ng lcov sa mga proyektong binuo gamit ang libtool o katulad nito
bumuo ng mga kapaligiran na gumagana sa isang base na direktoryo, ibig sabihin, mga kapaligiran, kung saan ang
kasalukuyang gumaganang direktoryo kapag ang pagtawag sa compiler ay hindi ang parehong direktoryo sa
kung saan matatagpuan ang source code file.

Tandaan na ang opsyong ito ay hindi gagana sa mga kapaligiran kung saan maraming base na direktoryo
ay ginamit. Sa kasong iyon, gamitin ang configuration file setting geninfo_auto_base=1 (Tingnan ang
lcovrc(5)).

-c
--huli
Kunin ang data ng saklaw.

Bilang default, kinukuha ang kasalukuyang kernel execution counts at isinulat ang resulta
data ng saklaw sa karaniwang output. Gamitin ang --directory na opsyon upang makuha ang mga bilang
para sa isang user space program.

Ang resulta ng operasyon ng pagkuha ay isusulat sa stdout o sa tracefile
tinukoy ng -o.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

--checksum
--walang-checksum
Tukuyin kung bubuo ng data ng checksum kapag nagsusulat ng mga tracefile.

Gamitin ang --checksum upang paganahin ang pagbuo ng checksum o --no-checksum upang hindi paganahin ito.
Checksum henerasyon ay hindi pinagana bilang default.

Kapag pinagana ang pagbuo ng checksum, bubuo ng checksum para sa bawat pinagmulan
linya ng code at nakaimbak kasama ng data ng saklaw. Magagamit ang checksum na ito
pigilan ang mga pagtatangka na pagsamahin ang data ng saklaw mula sa iba't ibang bersyon ng source code.

Kung hindi ka gumana sa iba't ibang bersyon ng source code, huwag paganahin ang opsyong ito upang mapabilis
pataasin ang pagpoproseso ng data ng saklaw at upang bawasan ang laki ng mga tracefile.

--compat paraan=halaga[,paraan=halaga,...]
Itakda ang compatibility mode.

Gamitin ang --compat upang tukuyin na dapat paganahin ng lcov ang isa o higit pang mga mode ng compatibility
kapag kumukuha ng data ng saklaw. Maaari kang magbigay ng comma-separated list ng mode=value
mga pares upang tukuyin ang mga halaga para sa maramihang mga mode.

Balido halaga ay:

on
I-enable ang compatibility mode.
off
I-disable ang compatibility mode.
kotse
Ilapat ang auto-detection upang matukoy kung kinakailangan ang compatibility mode. Tandaan
na ang auto-detection ay hindi available para sa lahat ng compatibility mode.

Kung walang tinukoy na halaga, ang 'on' ay ipinapalagay bilang default na halaga.

Balido mode ay:

libtool
Paganahin ang mode na ito kung kumukuha ka ng data ng saklaw para sa isang proyekto noon
binuo gamit ang mekanismo ng libtool. Tingnan din ang --compat-libtool.

Ang default na value para sa setting na ito ay 'on'.

martilyo
Paganahin ang mode na ito kung kumukuha ka ng data ng saklaw para sa isang proyekto noon
binuo gamit ang isang bersyon ng GCC 3.3 na naglalaman ng pagbabago (hammer patch)
ng mga susunod na bersyon ng GCC. Makikilala mo ang isang binagong GCC 3.3 sa pamamagitan ng pagsuri sa
bumuo ng direktoryo ng iyong proyekto para sa mga file na nagtatapos sa extension na '.bbg'.
Pangalanan ng mga hindi binagong bersyon ng GCC 3.3 ang mga file na ito na '.bb'.

Ang default na halaga para sa setting na ito ay 'auto'.

split_crc
Paganahin ang mode na ito kung kumukuha ka ng data ng saklaw para sa isang proyekto noon
binuo gamit ang isang bersyon ng GCC 4.6 na naglalaman ng pagbabago (split
function checksums) ng mga susunod na bersyon ng GCC. Karaniwang mga mensahe ng error kapag
ang pagpapatakbo ng lcov sa data ng saklaw na ginawa ng naturang mga bersyon ng GCC ay ´wala sa
memory' at 'naabot ang hindi inaasahang dulo ng file'.

Ang default na halaga para sa setting na ito ay 'auto'

--compat-libtool
--no-compat-libtool
Tukuyin kung paganahin ang libtool compatibility mode.

Gamitin ang --compat-libtool upang paganahin ang libtool compatibility mode o --no-compat-libtool upang
huwag paganahin ito. Ang libtool compatibility mode ay Pinagana bilang default.

Kapag pinagana ang libtool compatibility mode, ipapalagay ng lcov na ang source code
may kaugnayan sa isang .da file na matatagpuan sa isang direktoryo na pinangalanang ".libs" ay matatagpuan sa nito
direktoryo ng magulang.

Kung mayroon kang mga direktoryo na pinangalanang ".libs" sa iyong build environment ngunit huwag gumamit
libtool, huwag paganahin ang pagpipiliang ito upang maiwasan ang mga problema kapag kumukuha ng data ng saklaw.

--config-file config-file
Tumukoy ng configuration file na gagamitin.

Kapag tinukoy ang opsyong ito, hindi ang file ng configuration sa buong system
/etc/lcovrc, o ang file ng pagsasaayos ng bawat user ~/.lcovrc binabasa.

Maaaring maging kapaki-pakinabang ang opsyong ito kapag may pangangailangang magpatakbo ng ilang pagkakataon ng lcov
na may magkakaibang mga pagpipilian sa pagsasaayos ng file nang magkatulad.

--convert-filename
I-convert ang mga filename kapag nag-aaplay ng diff.

Gamitin ang opsyong ito kasama ng --diff para palitan ang pangalan ng mga pangalan ng file ng naprosesong data
nagtatakda ayon sa data na ibinigay ng diff.

--diff tracefile difffile
I-convert ang data ng saklaw sa tracefile gamit ang source code diff file difffile.

Gamitin ang opsyong ito kung gusto mong pagsamahin ang data ng saklaw mula sa iba't ibang source code
mga antas ng isang programa, hal. kapag mayroon kang data na kinuha mula sa isang mas lumang bersyon at gusto mo
upang pagsamahin ito sa data mula sa isang mas kasalukuyang bersyon. lcov susubukan na i-map ang pinagmulan
mga linya ng code sa pagitan ng mga bersyong iyon at ayusin ang data ng saklaw ayon sa pagkakabanggit.
difffile kailangang nasa pinag-isang format, ibig sabihin, dapat itong gawin gamit ang "-u"
opsyon ng Diff tool.

Tandaan na ang mga linyang wala sa lumang bersyon ay hindi mabibilang bilang
instrumented, samakatuwid ang mga tracefile na nagreresulta mula sa operasyong ito ay hindi dapat
isa-isang binibigyang kahulugan ngunit kasama ng iba pang mga tracefile na kinuha mula sa mas bago
bersyon. Tandaan din na ang na-convert na data ng saklaw ay dapat lang gamitin para sa
pangkalahatang-ideya dahil ang proseso mismo ay nagpapakilala ng pagkawala ng katumpakan.

Ang resulta ng diff operation ay isusulat sa stdout o sa tracefile
tinukoy ng -o.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

-d direktoryo
--direktoryo direktoryo
Gamitin ang mga .da file sa direktoryo sa halip na kernel.

Kung gusto mong magtrabaho sa data ng saklaw para sa isang space program ng user, gamitin ang opsyong ito upang
tukuyin ang lokasyon kung saan pinagsama-sama ang programa (doon ang mga counter file
na nagtatapos sa .da ay itatabi).

Tandaan na maaari mong tukuyin ang opsyong ito nang higit sa isang beses.

--panlabas
--walang-panlabas
Tukuyin kung kukuha ng data ng saklaw para sa mga external na source file.

Ang mga panlabas na source file ay mga file na hindi matatagpuan sa isa sa mga direktoryo
tinukoy ng --directory o --base-directory. Gamitin ang --external upang isama ang panlabas
source file habang kumukuha ng data ng saklaw o --no-external upang balewalain ang data na ito.

Ang data para sa mga external na source file ay kasama bilang default.

-e tracefile huwaran
--extract tracefile huwaran
I-extract ang data mula sa tracefile.

Gamitin ang switch na ito kung gusto mong kunin ang data ng saklaw para lamang sa isang partikular na hanay ng
mga file mula sa isang tracefile. Ang mga karagdagang parameter ng command line ay bibigyang-kahulugan bilang
mga pattern ng wildcard ng shell (tandaan na maaaring kailanganin nilang i-escape nang naaayon sa
pigilan muna ang shell na palawakin ang mga ito). Bawat pagpasok ng file tracefile alin
tugma sa kahit isa sa mga pattern na iyon ay makukuha.

Ang resulta ng operasyon ng extract ay isusulat sa stdout o sa tracefile
tinukoy ng -o.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

-f
--sundan
Sundin ang mga link kapag naghahanap ng mga .da file.

--mula sa pakete pakete
Gamitin ang mga .da file sa pakete sa halip na kernel o direktoryo.

Gamitin ang opsyong ito kung mayroon kang hiwalay na mga makina para sa pagbuo at pagsubok at gusto mo
isagawa ang paggawa ng .info file sa build machine. Tingnan ang --to-package para sa higit pa
impormasyon.

--gcov-tool kasangkapan
Tukuyin ang lokasyon ng tool ng gcov.

-h
- Tumulong
Mag-print ng maikling text ng tulong, pagkatapos ay lumabas.

--ignore-errors error
Tukuyin ang isang listahan ng mga error pagkatapos ay magpapatuloy sa pagproseso.

Gamitin ang opsyong ito upang tukuyin ang isang listahan ng isa o higit pang mga klase ng mga error pagkatapos kung saan lcov
dapat magpatuloy sa pagproseso sa halip na i-abort.

error ay maaaring isang listahan na pinaghihiwalay ng kuwit ng mga sumusunod na keyword:

gcov: ibinalik ang gcov tool na may non-zero return code.

pinagmulan: hindi mahanap ang source code file para sa isang set ng data.

graph: ang graph file ay hindi mahanap o nasira.

-i
--paunang
Kunin ang paunang data ng zero coverage.

Patakbuhin ang lcov gamit ang -c at ang opsyong ito sa mga direktoryo na naglalaman ng .bb, .bbg o .gcno
file bago patakbuhin ang anumang kaso ng pagsubok. Ang resulta ay isang "baseline" coverage data file
na naglalaman ng zero coverage para sa bawat instrumentong linya. Pagsamahin ang data file na ito
(gamit ang lcov -a) na may mga file ng data ng saklaw na nakuha pagkatapos ng isang pagsubok na tumakbo upang matiyak iyon
ang porsyento ng kabuuang mga linyang sakop ay tama kahit na hindi lahat ng source code
na-load ang mga file sa panahon ng pagsubok.

Inirerekomendang pamamaraan kapag kumukuha ng data para sa isang test case:

1. gumawa ng baseline coverage data file
# lcov -c -i -d appdir -o app_base.info

2. magsagawa ng pagsusulit
# appdir/test

3. lumikha ng file ng data ng saklaw ng pagsubok
# lcov -c -d appdir -o app_test.info

4. pagsamahin ang baseline at data ng saklaw ng pagsubok
# lcov -a app_base.info -a app_test.info -o app_total.info

-k subdirectory
--kernel-directory subdirectory
Kunin ang data ng saklaw ng kernel mula lamang sa subdirectory.

Gamitin ang opsyong ito kung hindi mo gustong makakuha ng data ng saklaw para sa lahat ng kernel, ngunit
para lamang sa mga partikular na subdirectory. Maaaring tukuyin ang opsyong ito nang higit sa isang beses.

Tandaan na maaaring kailanganin mong tukuyin ang buong landas sa kernel subdirectory
depende sa bersyon ng kernel gcov support.

-l tracefile
--listahan tracefile
Ilista ang mga nilalaman ng tracefile.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

--list-full-path
--no-list-full-path
Tukuyin kung magpapakita ng mga buong path sa panahon ng pagpapatakbo ng listahan.

Gumamit ng --list-full-path upang ipakita ang mga buong path sa panahon ng pagpapatakbo ng listahan o
--no-list-full-path upang ipakita ang mga pinaikling landas. Ang mga landas ay pinaikling bilang default.

--walang-marker
Gamitin ang opsyong ito kung gusto mong makakuha ng data ng saklaw nang hindi isinasaalang-alang ang pagbubukod
mga marker sa source code file. Tingnan mo geninfo (1) para sa mga detalye sa mga marker ng pagbubukod.

--walang-recursion
Gamitin ang opsyong ito kung gusto mong makakuha ng data ng saklaw para sa tinukoy na direktoryo lamang
nang walang pagproseso ng mga subdirectory.

-o tracefile
--output-file tracefile
Sumulat ng data sa tracefile sa halip na stdout.

Tukuyin ang "-" bilang isang filename upang magamit ang karaniwang output.

Sa pamamagitan ng convention, ang lcov-generated coverage data files ay tinatawag na "tracefiles" at
dapat magkaroon ng extension ng filename na ".info".

--daanan landas
I-strip ang path mula sa mga filename kapag nag-aaplay ng diff.

Gamitin ang opsyong ito kasama ng --diff para sabihin sa lcov na balewalain ang tinukoy
paunang bahagi ng path kapag tumutugma sa pagitan ng tracefile at diff filename.

-q
--tahimik
Huwag mag-print ng mga mensahe ng pag-unlad.

Ang pagpipiliang ito ay ipinahiwatig kapag walang output filename na tinukoy upang maiwasan ang pag-unlad
mga mensahe para guluhin ang data ng saklaw na naka-print din sa karaniwang output.

--rc keyword=halaga
I-override ang isang direktiba sa pagsasaayos.

Gamitin ang opsyong ito upang tukuyin ang a keyword=halaga pahayag na nangingibabaw sa
kaukulang configuration statement sa lcovrc configuration file. Kaya mo
tukuyin ang opsyong ito nang higit sa isang beses upang i-override ang maramihang configuration statement.
Tingnan lcovrc(5) para sa isang listahan ng magagamit na mga keyword at ang kahulugan nito.

-r tracefile huwaran
--alisin tracefile huwaran
Alisin ang data mula sa tracefile.

Gamitin ang switch na ito kung gusto mong alisin ang data ng saklaw para sa isang partikular na hanay ng mga file
mula sa isang tracefile. Ang mga karagdagang parameter ng command line ay bibigyang-kahulugan bilang shell
mga pattern ng wildcard (tandaan na maaaring kailanganin nilang i-escape nang naaayon upang maiwasan ang
shell mula sa pagpapalawak ng mga ito muna). Bawat pagpasok ng file tracefile na tumutugma sa
kahit isa sa mga pattern na iyon ay aalisin.

Ang resulta ng operasyon sa pag-alis ay isusulat sa stdout o sa tracefile
tinukoy ng -o.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

--strip lalim
I-strip ang mga bahagi ng path kapag nag-aaplay ng diff.

Gamitin ang opsyong ito kasama ng --diff para sabihin sa lcov na balewalain ang tinukoy na numero
ng mga unang direktoryo kapag tumutugma sa tracefile at diff filename.

--buod tracefile
Ipakita ang buod ng impormasyon sa saklaw para sa tinukoy na tracefile.

Tandaan na maaari mong tukuyin ang opsyong ito nang higit sa isang beses.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

-t pangalan ng pagsubok
--test-pangalan pangalan ng pagsubok
Tukuyin ang pangalan ng pagsubok na iimbak sa tracefile.

Tinutukoy ng pangalang ito ang isang hanay ng data ng saklaw kapag pinagsama ang higit sa isang set ng data
isang pinagsamang tracefile (tingnan ang opsyon -a).

Ang mga wastong pangalan ng pagsubok ay maaaring binubuo ng mga titik, decimal digit at underscore
karakter ("_").

--sa-package pakete
Mag-imbak ng mga .da file para sa pagpoproseso sa ibang pagkakataon.

Gamitin ang opsyong ito kung mayroon kang hiwalay na mga makina para sa pagbuo at pagsubok at gusto mo
isagawa ang paggawa ng .info file sa build machine. Upang gawin ito, sundin ang mga ito
mga hakbang:

Sa makina ng pagsubok:
- patakbuhin ang pagsubok
- patakbuhin ang lcov -c [-d directory] --to-package file
- kopya file sa build machine

Sa build machine:
- patakbuhin ang lcov -c --from-package file [-o at iba pang mga opsyon]

Gumagana ito para sa parehong data ng saklaw ng kernel at espasyo ng gumagamit. Tandaan na maaaring mayroon ka
upang tukuyin ang landas patungo sa direktoryo ng build gamit ang -b na may alinman sa --to-package o
--mula sa pakete. Tandaan din na ang data ng package ay dapat ma-convert sa isang .info file
bago i-recompile ang program o ito ay magiging invalid.

-v
--bersyon
I-print ang numero ng bersyon, pagkatapos ay lumabas.

-z
--zerocounters
I-reset ang lahat ng execution counts sa zero.

Bilang default, sinusubukang i-reset ang mga bilang ng kernel execution. Gamitin ang --directory na opsyon upang
i-reset ang lahat ng counter ng isang user space program.

Isa lamang sa -z, -c, -a, -e, -r, -l, --diff o --buod ang maaaring tukuyin sa isang
time.

Gamitin ang lcov online gamit ang mga serbisyo ng onworks.net