Ini ialah arahan lcov yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
lcov - bahagian hadapan GCOV grafik
SINOPSIS
lcov -c|--menangkap
[-d|--direktori direktori] [-k|--direktori-kernel direktori]
[-o|--fail keluaran fail surih] [-t|--nama-ujian nama ujian]
[-b|--base-direktori direktori] [-i|--awal] [--gcov-tool alat]
[--checksum] [--tiada-checksum] [--tiada-rekursi] [-f|--ikut]
[--compat-libtool] [--no-compat-libtool] [--abaikan-kesilapan kesilapan]
[--untuk-pakej pakej] [--dari-pakej pakej] [-q|--senyap]
[--tiada-penanda] [--luaran] [--tiada-luaran]
[--config-file fail konfigurasi] [--rc kata kunci=nilai]
[--compat mod=hidup|mati|auto]
lcov -z|--sifar
[-d|--direktori direktori] [--tiada-rekursi] [-f|--ikut]
[-q|--senyap]
lcov -l|--senarai fail surih
[-q|--senyap] [--list-penuh-laluan] [--tiada-senarai-laluan-penuh]
[--config-file fail konfigurasi] [--rc kata kunci=nilai]
lcov -a|--add-tracefile fail surih
[-o|--fail keluaran fail surih] [--checksum] [--tiada-checksum]
[-q|--senyap] [--config-file fail konfigurasi] [--rc kata kunci=nilai]
lcov -e|--ekstrak fail surih pola
[-o|--fail keluaran fail surih] [--checksum] [--tiada-checksum]
[-q|--senyap] [--config-file fail konfigurasi] [--rc kata kunci=nilai]
lcov -r|--buang fail surih pola
[-o|--fail keluaran fail surih] [--checksum] [--tiada-checksum]
[-q|--senyap] [--config-file fail konfigurasi] [--rc kata kunci=nilai]
lcov --berbeza fail surih diff
[-o|--fail keluaran fail surih] [--checksum] [--tiada-checksum]
[--convert-nama fail] [--jalur kedalaman] [--laluan jalan] [-q|--senyap]
[--config-file fail konfigurasi] [--rc kata kunci=nilai]
lcov --ringkasan fail surih
[-q|--senyap]
lcov [-h|- membantu] [-v|--versi]
DESCRIPTION
lcov ialah bahagian hadapan grafik untuk alat ujian liputan GCC gcov. Ia mengumpul garis,
data liputan fungsi dan cawangan untuk berbilang fail sumber dan mencipta halaman HTML
mengandungi kod sumber beranotasi dengan maklumat liputan. Ia juga menambah gambaran keseluruhan
halaman untuk navigasi mudah dalam struktur fail.
Penggunaan lcov untuk mengumpul data liputan dan genhtml untuk membuat halaman HTML. Data liputan boleh
sama ada dikumpulkan daripada kernel Linux yang sedang berjalan atau dari ruang pengguna
permohonan. Untuk melakukan ini, anda perlu melengkapkan langkah penyediaan berikut:
Untuk liputan kernel Linux:
Ikut arahan persediaan untuk infrastruktur gcov-kernel:
http://ltp.sourceforge.net/coverage/gcov.php
Untuk liputan aplikasi ruang pengguna:
Susun aplikasi dengan GCC menggunakan pilihan "-fprofile-arcs" dan
"-ftest-liputan".
Sila ambil perhatian bahawa halaman manual ini merujuk kepada format output bagi lcov sebagai "fail info" atau
"fail jejak" dan output GCOV dipanggil "fail .da".
Juga ambil perhatian bahawa apabila peratusan mencetak, 0% dan 100% hanya dicetak apabila nilainya
tepat 0% dan 100% masing-masing. Nilai lain yang secara konvensional akan dibundarkan kepada 0%
atau 100% sebaliknya dicetak sebagai nilai bukan sempadan terdekat. Tingkah laku ini sesuai
dengan yang gcov(1) alat.
PILIHAN
-a fail surih
--add-tracefile fail surih
Tambah kandungan fail surih.
Tentukan beberapa fail surih menggunakan suis -a untuk menggabungkan data liputan
terkandung dalam fail ini dengan menambah kiraan pelaksanaan untuk ujian pemadanan dan
gabungan nama fail.
Hasil daripada operasi tambah akan ditulis ke stdout atau fail surih
dinyatakan dengan -o.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
-b direktori
--base-direktori direktori
Penggunaan direktori sebagai direktori asas untuk laluan relatif.
Gunakan pilihan ini untuk menentukan direktori asas bina-persekitaran apabila lcov
menghasilkan mesej ralat seperti:
RALAT: tidak dapat membaca fail sumber
/home/user/project/subdir1/subdir2/subdir1/subdir2/file.c
Dalam contoh ini, gunakan /home/user/project sebagai direktori asas.
Pilihan ini diperlukan apabila menggunakan lcov pada projek yang dibina dengan libtool atau yang serupa
bina persekitaran yang berfungsi dengan direktori asas, iaitu persekitaran, di mana
direktori kerja semasa apabila menggunakan pengkompil bukan direktori yang sama dalam
yang mana fail kod sumber berada.
Ambil perhatian bahawa pilihan ini tidak akan berfungsi dalam persekitaran di mana berbilang direktori asas
digunakan. Dalam kes itu gunakan tetapan fail konfigurasi geninfo_auto_base=1 (Lihat
lcovrc(5)).
-c
--menangkap
Tangkap data liputan.
Secara lalai menangkap kiraan pelaksanaan kernel semasa dan menulis yang terhasil
data liputan kepada output standard. Gunakan pilihan --directory untuk menangkap kiraan
untuk program angkasa pengguna.
Hasil operasi tangkapan akan ditulis ke stdout atau fail surih
dinyatakan dengan -o.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
--checksum
--tiada-checksum
Tentukan sama ada untuk menjana data semak semasa menulis fail surih.
Gunakan --checksum untuk mendayakan penjanaan checksum atau --no-checksum untuk melumpuhkannya.
Penjanaan semak adalah orang kurang upaya secara lalai.
Apabila penjanaan checksum didayakan, checksum akan dijana untuk setiap sumber
baris kod dan disimpan bersama dengan data liputan. Checksum ini akan digunakan untuk
menghalang percubaan untuk menggabungkan data liputan daripada versi kod sumber yang berbeza.
Jika anda tidak menggunakan versi kod sumber yang berbeza, lumpuhkan pilihan ini untuk mempercepatkan
meningkatkan pemprosesan data liputan dan untuk mengurangkan saiz fail surih.
--compat mod=nilai[,mod=nilai,...]
Tetapkan mod keserasian.
Gunakan --compat untuk menentukan bahawa lcov harus mendayakan satu atau lebih mod keserasian
apabila menangkap data liputan. Anda boleh menyediakan senarai mod=nilai yang dipisahkan koma
berpasangan untuk menentukan nilai untuk berbilang mod.
Sah nilai ialah:
on
Dayakan mod keserasian.
off
Lumpuhkan mod keserasian.
auto
Gunakan pengesanan automatik untuk menentukan sama ada mod keserasian diperlukan. Catatan
bahawa pengesanan automatik tidak tersedia untuk semua mod keserasian.
Jika tiada nilai dinyatakan, 'hidup' diandaikan sebagai nilai lalai.
Sah mod ialah:
libtool
Dayakan mod ini jika anda menangkap data liputan untuk projek yang pernah
dibina menggunakan mekanisme libtool. Lihat juga --compat-libtool.
Nilai lalai untuk tetapan ini ialah 'hidup'.
menukul
Dayakan mod ini jika anda menangkap data liputan untuk projek yang pernah
dibina menggunakan versi GCC 3.3 yang mengandungi pengubahsuaian (tampalan tukul)
versi GCC kemudiannya. Anda boleh mengenal pasti GCC 3.3 yang diubah suai dengan menyemak
bina direktori projek anda untuk fail yang berakhir dengan sambungan '.bbg'.
Versi GCC 3.3 yang tidak diubah suai menamakan fail ini sebagai '.bb'.
Nilai lalai untuk tetapan ini ialah 'auto'.
split_crc
Dayakan mod ini jika anda menangkap data liputan untuk projek yang pernah
dibina menggunakan versi GCC 4.6 yang mengandungi pengubahsuaian (split
fungsi semak) versi GCC kemudian. Mesej ralat biasa apabila
menjalankan lcov pada data liputan yang dihasilkan oleh versi GCC tersebut adalah ´kehabisan
memori' dan 'mencapai hujung fail yang tidak dijangka'.
Nilai lalai untuk tetapan ini ialah 'auto'
--compat-libtool
--no-compat-libtool
Tentukan sama ada untuk mendayakan mod keserasian libtool.
Gunakan --compat-libtool untuk mendayakan mod keserasian libtool atau --no-compat-libtool untuk
melumpuhkannya. Mod keserasian libtool ialah membolehkan secara lalai.
Apabila mod keserasian libtool didayakan, lcov akan menganggap bahawa kod sumber
berkaitan dengan fail .da yang terletak dalam direktori bernama ".libs" boleh didapati di dalamnya
Direktori Ibubapa.
Jika anda mempunyai direktori bernama ".libs" dalam persekitaran binaan anda tetapi tidak gunakan
libtool, lumpuhkan pilihan ini untuk mengelakkan masalah semasa menangkap data liputan.
--config-file fail konfigurasi
Tentukan fail konfigurasi untuk digunakan.
Apabila pilihan ini ditentukan, bukan fail konfigurasi seluruh sistem
/etc/lcovrc, mahupun fail konfigurasi setiap pengguna ~/.lcovrc dibaca.
Pilihan ini mungkin berguna apabila terdapat keperluan untuk menjalankan beberapa contoh lcov
dengan pilihan fail konfigurasi yang berbeza secara selari.
--convert-nama fail
Tukar nama fail apabila menggunakan diff.
Gunakan pilihan ini bersama-sama dengan --diff untuk menamakan semula nama fail data yang diproses
set mengikut data yang disediakan oleh diff.
--berbeza fail surih difffile
Tukar data liputan ke dalam fail surih menggunakan fail diff kod sumber difffile.
Gunakan pilihan ini jika anda ingin menggabungkan data liputan daripada kod sumber yang berbeza
peringkat program, contohnya apabila anda mempunyai data yang diambil daripada versi lama dan mahu
untuk menggabungkannya dengan data daripada versi yang lebih terkini. lcov akan cuba memetakan sumber
baris kod antara versi tersebut dan laraskan data liputan masing-masing.
difffile perlu dalam format bersatu, iaitu ia perlu dibuat menggunakan "-u"
pilihan untuk diff alat.
Ambil perhatian bahawa baris yang tidak terdapat dalam versi lama tidak akan dikira sebagai
diperalatkan, oleh itu fail surih yang terhasil daripada operasi ini tidak sepatutnya
ditafsirkan secara individu tetapi bersama-sama dengan fail surih lain yang diambil dari yang lebih baru
versi. Juga perlu diingat bahawa data liputan yang ditukar hanya boleh digunakan untuk
tujuan gambaran keseluruhan kerana proses itu sendiri memperkenalkan kehilangan ketepatan.
Hasil daripada operasi diff akan ditulis ke stdout atau fail surih
dinyatakan dengan -o.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
-d direktori
--direktori direktori
Gunakan fail .da dalam direktori bukannya kernel.
Jika anda ingin mengusahakan data liputan untuk program ruang pengguna, gunakan pilihan ini untuk
nyatakan lokasi di mana program disusun (di situlah fail pembilang
berakhir dengan .da akan disimpan).
Ambil perhatian bahawa anda boleh menentukan pilihan ini lebih daripada sekali.
--luaran
--tiada-luaran
Tentukan sama ada untuk menangkap data liputan untuk fail sumber luaran.
Fail sumber luaran ialah fail yang tidak terdapat dalam salah satu direktori
ditentukan oleh --directory atau --base-directory. Gunakan --external untuk memasukkan luaran
fail sumber semasa menangkap data liputan atau --no-external untuk mengabaikan data ini.
Data untuk fail sumber luaran ialah dimasukkan secara lalai.
-e fail surih pola
--ekstrak fail surih pola
Ekstrak data daripada fail surih.
Gunakan suis ini jika anda ingin mengekstrak data liputan untuk set tertentu sahaja
fail daripada fail surih. Parameter baris arahan tambahan akan ditafsirkan sebagai
corak kad bebas shell (perhatikan bahawa ia mungkin perlu dilepaskan dengan sewajarnya
menghalang cangkerang daripada mengembangkannya terlebih dahulu). Setiap kemasukan fail fail surih yang
padanan sekurang-kurangnya satu daripada corak tersebut akan diekstrak.
Hasil operasi ekstrak akan ditulis ke stdout atau fail surih
dinyatakan dengan -o.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
-f
--ikut
Ikuti pautan semasa mencari fail .da.
--dari-pakej pakej
Gunakan fail .da dalam pakej bukannya kernel atau direktori.
Gunakan pilihan ini jika anda mempunyai mesin yang berasingan untuk membina dan menguji dan mahu
lakukan penciptaan fail .info pada mesin bina. Lihat --to-package untuk maklumat lanjut
maklumat.
--gcov-tool alat
Nyatakan lokasi alat gcov.
-h
- membantu
Cetak teks bantuan ringkas, kemudian keluar.
--abaikan-kesilapan kesilapan
Tentukan senarai ralat selepas itu untuk meneruskan pemprosesan.
Gunakan pilihan ini untuk menentukan senarai satu atau lebih kelas ralat selepas itu lcov
harus meneruskan pemprosesan dan bukannya menggugurkan.
kesilapan boleh menjadi senarai yang dipisahkan koma bagi kata kunci berikut:
gcov: alat gcov dikembalikan dengan kod pulangan bukan sifar.
sumber: fail kod sumber untuk set data tidak ditemui.
graf: fail graf tidak ditemui atau rosak.
-i
--awal
Tangkap data liputan sifar awal.
Jalankan lcov dengan -c dan pilihan ini pada direktori yang mengandungi .bb, .bbg atau .gcno
fail sebelum menjalankan sebarang kes ujian. Hasilnya ialah fail data liputan "garis dasar".
yang mengandungi liputan sifar untuk setiap talian berinstrumen. Gabungkan fail data ini
(menggunakan lcov -a) dengan fail data liputan yang ditangkap selepas ujian dijalankan untuk memastikannya
peratusan jumlah baris yang diliputi adalah betul walaupun tidak semua kod sumber
fail telah dimuatkan semasa ujian.
Prosedur yang disyorkan semasa menangkap data untuk kes ujian:
1. cipta fail data liputan garis dasar
# lcov -c -i -d appdir -o app_base.info
2. melaksanakan ujian
# appdir/test
3. cipta fail data liputan ujian
# lcov -c -d appdir -o app_test.info
4. menggabungkan data liputan garis dasar dan ujian
# lcov -a app_base.info -a app_test.info -o app_total.info
-k subdirektori
--direktori-kernel subdirektori
Tangkap data liputan kernel hanya dari subdirektori.
Gunakan pilihan ini jika anda tidak mahu mendapatkan data liputan untuk semua kernel, tetapi
hanya untuk subdirektori tertentu. Pilihan ini boleh ditentukan lebih daripada sekali.
Ambil perhatian bahawa anda mungkin perlu menentukan laluan penuh ke subdirektori kernel
bergantung pada versi sokongan gcov kernel.
-l fail surih
--senarai fail surih
Senaraikan kandungan fail surih.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
--list-penuh-laluan
--tiada-senarai-laluan-penuh
Tentukan sama ada untuk menunjukkan laluan penuh semasa operasi senarai.
Gunakan --list-full-path untuk menunjukkan laluan penuh semasa operasi senarai atau
--no-list-full-path untuk menunjukkan laluan yang dipendekkan. Laluan adalah dipendekkan secara lalai.
--tiada-penanda
Gunakan pilihan ini jika anda ingin mendapatkan data liputan tanpa mengambil kira pengecualian
penanda dalam fail kod sumber. Lihat geninfo (1) untuk butiran tentang penanda pengecualian.
--tiada-rekursi
Gunakan pilihan ini jika anda ingin mendapatkan data liputan untuk direktori yang ditentukan sahaja
tanpa memproses subdirektori.
-o fail surih
--fail keluaran fail surih
Tulis data ke fail surih bukannya stdout.
Tentukan "-" sebagai nama fail untuk menggunakan output standard.
Mengikut konvensyen, fail data liputan yang dijana oleh lcov dipanggil "fail surih" dan
harus mempunyai sambungan nama fail ".info".
--laluan jalan
Keluarkan laluan daripada nama fail apabila menggunakan diff.
Gunakan pilihan ini bersama-sama dengan --diff untuk memberitahu lcov supaya mengabaikan yang ditentukan
komponen laluan awal apabila memadankan antara nama fail surih dan diff.
-q
--senyap
Jangan cetak mesej kemajuan.
Pilihan ini tersirat apabila tiada nama fail output ditentukan untuk menghalang kemajuan
mesej untuk mengacaukan data liputan yang juga dicetak ke output standard.
--rc kata kunci=nilai
Gantikan arahan konfigurasi.
Gunakan pilihan ini untuk menentukan a kata kunci=nilai pernyataan yang mengatasi
pernyataan konfigurasi yang sepadan dalam fail konfigurasi lcovrc. Awak boleh
tentukan pilihan ini lebih daripada sekali untuk mengatasi berbilang pernyataan konfigurasi.
Lihat lcovrc(5) untuk senarai kata kunci yang tersedia dan maksudnya.
-r fail surih pola
--buang fail surih pola
Alih keluar data daripada fail surih.
Gunakan suis ini jika anda ingin mengalih keluar data liputan untuk set fail tertentu
daripada fail surih. Parameter baris arahan tambahan akan ditafsirkan sebagai shell
corak kad bebas (perhatikan bahawa ia mungkin perlu dilepaskan dengan sewajarnya untuk mengelakkan
shell daripada mengembangkannya dahulu). Setiap kemasukan fail fail surih yang sepadan di
sekurang-kurangnya satu daripada corak tersebut akan dialih keluar.
Hasil daripada operasi alih keluar akan ditulis ke stdout atau fail surih
dinyatakan dengan -o.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
--jalur kedalaman
Jalur komponen jalur apabila menggunakan diff.
Gunakan pilihan ini bersama-sama dengan --diff untuk memberitahu lcov supaya mengabaikan nombor yang ditentukan
direktori awal apabila memadankan fail surih dan nama fail berbeza.
--ringkasan fail surih
Tunjukkan maklumat liputan ringkasan untuk fail surih yang ditentukan.
Ambil perhatian bahawa anda boleh menentukan pilihan ini lebih daripada sekali.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
-t nama ujian
--nama-ujian nama ujian
Tentukan nama ujian untuk disimpan dalam fail surih.
Nama ini mengenal pasti set data liputan apabila lebih daripada satu set data digabungkan
fail surih gabungan (lihat pilihan -a).
Nama ujian yang sah boleh terdiri daripada huruf, digit perpuluhan dan garis bawah
aksara ("_").
--untuk-pakej pakej
Simpan fail .da untuk diproses kemudian.
Gunakan pilihan ini jika anda mempunyai mesin yang berasingan untuk membina dan menguji dan mahu
lakukan penciptaan fail .info pada mesin bina. Untuk melakukan ini, ikuti ini
langkah-langkah:
Pada mesin ujian:
- jalankan ujian
- jalankan lcov -c [-d directory] --to-package fail
- salinan fail kepada mesin binaan
Pada mesin binaan:
- jalankan lcov -c --from-package fail [-o dan pilihan lain]
Ini berfungsi untuk kedua-dua kernel dan data liputan ruang pengguna. Ambil perhatian bahawa anda mungkin mempunyai
untuk menentukan laluan ke direktori binaan menggunakan -b dengan sama ada --to-package atau
--dari-pakej. Ambil perhatian juga bahawa data pakej mesti ditukar kepada fail .info
sebelum menyusun semula atur cara atau ia akan menjadi tidak sah.
-v
--versi
Cetak nombor versi, kemudian keluar.
-z
--sifar
Tetapkan semula semua kiraan pelaksanaan kepada sifar.
Secara lalai cuba menetapkan semula kiraan pelaksanaan kernel. Gunakan pilihan --directory untuk
menetapkan semula semua pembilang program ruang pengguna.
Hanya satu daripada -z, -c, -a, -e, -r, -l, --diff atau --ringkasan boleh ditentukan pada
pada bila-bila masa.
Gunakan lcov dalam talian menggunakan perkhidmatan onworks.net
