ggcov-webdb - Online di Cloud

PROGRAM:

NAMA

ggcov-webdb - buat database perantara untuk antarmuka web ggcov

RINGKASAN

ggcov-webdb [[-r] direktori|fillet] ...

DESKRIPSI

Ggcov-webdb menghasilkan database perantara dan pohon file sumber dari pengembangan
direktori, dalam bentuk tarball. File-file dalam tarball ini nantinya digunakan oleh
ggcov Halaman PHP untuk menyajikan data cakupan pengujian ke browser WWW.

Data cakupan pengujian dihasilkan oleh program C dan C++ yang dikompilasi dengan gcc -fprofile-arc
-cakupan-ftest. Jadi kombinasi dari ggcov-webdb dan ggcov Halaman PHP pada dasarnya adalah
pengganti WWW untuk gcov program yang datang dengan gcc.

Pendekatan basis data perantara digunakan untuk menangani kasus umum di mana pengembangan
mesin dan mesin server web terpisah. Basis data berisi data cakupan di
formulir yang diindeks, tidak bergantung pada platform, dan ramah-PHP. Karena format databasenya adalah
platform-independen halaman PHP dapat digunakan pada server web yang berbeda
arsitektur ke mesin pengembangan. Sebenarnya ggcov halaman web mendukung web apa pun
server yang memenuhi kriteria berikut:

· mendukung PHP versi 4.3 atau yang lebih baru, dan

· menyediakan dba ekstensi dengan db4 penyedia (yang ggcov digunakan untuk membaca
database perantara), dan

· menyediakan gd ekstensi (yang ggcov menggunakan untuk menghasilkan bargraphs pada
halaman ringkasan).

Grafik sourceforge.net server web proyek adalah contoh dari server semacam itu.

Ggcov-webdb menghasilkan tarball gzip yang berisi database perantara itu sendiri dan
salinan semua file sumber yang disebutkan dalam database. Ini semua
informasi bahwa ggcov halaman web perlu, dalam satu bundel yang nyaman untuk disalin
mesin pengembangan ke server web. Biasanya tarball ini akan diekstraksi menjadi
subdirektori dari /var/ggcov/tes/ di server web.

Argumen digunakan untuk menentukan cara menemukan file data cakupan. Argumen bisa
kombinasi dari:

direktori
Direktori dipindai untuk mencari file sumber, yang ditangani seolah-olah telah
ditentukan pada baris perintah (kecuali bahwa file data cakupan yang hilang diam-diam
diabaikan). jika -r flag berlaku, sub-direktori dipindai secara rekursif.
Beberapa direktori dapat ditentukan dan dipindai dalam urutan yang diberikan.

executable
File yang dapat dieksekusi dipindai untuk men-debug catatan yang berisi file sumber
nama, dan setiap file sumber yang ada ditangani seolah-olah telah ditentukan pada
baris perintah (kecuali bahwa file data cakupan yang hilang diabaikan secara diam-diam).
Pustaka bersama apa pun yang menjadi tumpuan executable juga dipindai. Beberapa
executable dapat ditentukan dan dipindai dalam urutan yang diberikan. Fitur ini adalah
hanya tersedia di beberapa platform (misalnya, i386-linux).

sumber data
Apakah ada file biasa yang diakhiri dengan salah satu ekstensi file? .c, Cc., .cxx, .cpp, atau
.C. File sumber dicocokkan dengan file data cakupan yang sesuai (.gcno dan
.gcda file, atau .bb, .bbg, dan .da file dengan kompiler yang lebih lama) dan file objek oleh
mencari file dengan nama dasar yang sama dan ekstensi yang sesuai terlebih dahulu di
direktori yang sama dengan file sumber dan kemudian di semua direktori yang ditentukan pada
baris perintah (dalam urutan yang ditentukan).

PILIHAN

-f tes.tgz, --berkas keluaran=tes.tgz
Hasilkan output ke nama file tes.tgz alih-alih default ggcov.webdb.tgz. itu
nama file khusus - dapat digunakan untuk menghasilkan output ke stdout.

-o dir, --objek-direktori=dir
Tambahkan direktori dir ke jalur pencarian untuk file objek dan file data cakupan.

-r, --rekursif
Ketika direktori ditentukan pada baris perintah, cari file data cakupan
secara rekursif di semua direktori anak.

-X simbol, --menekan-ifdef=simbol
Jangan sertakan dalam statistik atau ringkasan, kode di dalam arahan pra-prosesor C
yang tergantung pada salah satu yang diberikan simbol. Satu atau lebih simbol dapat diberikan,
dipisahkan dengan koma atau spasi. Ggcov-webdb memahami subset berikut dari
set perintah pra-prosesor C:

· #jika SYMBOL
· #jika didefinisikan (SIMBOL)
· #ifdef SYMBOL
· #ifndef SYMBOL
· #lain
· #berakhir jika

Sebagai contoh, -X DEBUG akan menekan fprintf() panggilan dalam kode ini:

tidak ditandatangani
my_function (tidak ditandatangani int x)
{
x += 42;
#ifdef DEBUG
fprintf(stderr, "fungsi_saya: x=%u\n", x);
#berakhir jika
kembali x;
}

Opsi ini berguna untuk menekan kode infrastruktur pengujian, kode debug, atau
kode lain yang dikompilasi ke dalam uji cakupan yang dapat dieksekusi tetapi cakupannya
tidak signifikan.

-Y kata, --tekan-komentar=kata
Jangan sertakan dalam statistik atau ringkasan, kode pada baris yang juga mengandung a
komentar satu baris hanya terdiri dari satu yang diberikan kata. Satu atau lebih simbol
dapat diberikan, dipisahkan dengan koma atau spasi. Misalnya, menentukan -Y
ABAIKAN SAYA akan menekan menegaskan() dalam kode ini:

tidak ditandatangani
my_function (tidak ditandatangani int x)
{
x += 42;
menegaskan(x >= 42); /* ABAIKAN SAYA */
kembali x;
}

Opsi ini berguna untuk menekan kode infrastruktur pengujian, kode debug, atau
kode lain yang dikompilasi ke dalam uji cakupan yang dapat dieksekusi tetapi cakupannya
tidak signifikan.

-Z kata awal, kata akhir,...

--tekan-komentar-antara=kata awal, kata akhir,...
Jangan sertakan dalam statistik atau ringkasan, kode pada baris di antara yang mengandung a
komentar satu baris hanya terdiri dari kata pembuka dan komentar satu baris berikutnya
hanya terdiri dari kata akhir. Dua atau lebih simbol dapat diberikan, berpasangan, dipisahkan oleh
koma atau spasi. Sebagai contoh, -Z MULAI ABAIKAN, AKHIRKAN akan menekan
seluruh fungsi dalam kode ini:

/* MULAI ABAIKAN */
tidak ditandatangani
my_function (tidak ditandatangani int x)
{
x += 42;
kembali x;
}
// AKHIRKAN

Opsi ini berguna untuk menekan kode infrastruktur pengujian, kode debug, atau
kode lain yang dikompilasi ke dalam uji cakupan yang dapat dieksekusi tetapi cakupannya
tidak signifikan.

CONTOH

Hasilkan database perantara untuk semua sumber yang tersedia di executable keluar (di
beberapa platform saja), dan instal sebagai tes foo di lokasi tes default.

mkdir /var/ggcov/tes/foo
ggcov-webdb -f - keluar |
(CD /var/ggcov/tes/foo ; ter -xzf - )

Hasilkan database perantara untuk semua sumber C di direktori saat ini.

ggcov-webdb *.C

Hasilkan database perantara untuk semua sumber C dalam satu direktori tempat objek
file dan file data cakupan pengujian berada di direktori yang berbeda:

ggcov-webdb /foo/obj/ /foo/cov-data/ /foo/src/

Gunakan ggcov-webdb online menggunakan layanan onworks.net