ggcov-webdb - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

ggcov-webdb - tạo cơ sở dữ liệu trung gian cho giao diện web ggcov

SYNOPSIS

gccov-webdb [[-r] thư mục|hồ sơ] ...

MÔ TẢ

Ggcov-webdb tạo cơ sở dữ liệu trung gian và cây các tệp nguồn từ một quá trình phát triển
thư mục, ở dạng tarball. Các tệp trong tarball này sau đó được sử dụng bởi
gcov Các trang PHP để trình bày dữ liệu về phạm vi kiểm tra cho các trình duyệt WWW.

Dữ liệu phạm vi kiểm tra được tạo ra bởi các chương trình C và C ++ được biên dịch với gcc -fprofile-arc
-phải bảo hiểm tốt nhất. Vì vậy, sự kết hợp của gccov-webdb và gcov Các trang PHP về cơ bản là một
WWW thay thế cho gcov chương trình đi kèm với gcc.

Phương pháp tiếp cận cơ sở dữ liệu trung gian được sử dụng để xử lý trường hợp phổ biến khi phát triển
máy và máy chủ web là riêng biệt. Cơ sở dữ liệu chứa dữ liệu phạm vi trong
một biểu mẫu thân thiện với PHP được lập chỉ mục, độc lập với nền tảng. Vì định dạng cơ sở dữ liệu là
độc lập với nền tảng, các trang PHP có thể được triển khai trên các máy chủ web khác
kiến trúc của máy phát triển. Trên thực tế gcov các trang web hỗ trợ bất kỳ web nào
máy chủ đáp ứng các tiêu chí sau:

· Hỗ trợ PHP phiên bản 4.3 trở lên, và

· Cung cấp dba mở rộng với db4 nhà cung cấp (mà gcov sử dụng để đọc
cơ sở dữ liệu trung gian), và

· Cung cấp gd phần mở rộng (mà gcov sử dụng để tạo các thanh đồ thị trên
Trang tóm tắt).

nguồnforge.net máy chủ web dự án là một ví dụ về máy chủ như vậy.

Ggcov-webdb tạo ra một tarball được gzipped chứa chính cơ sở dữ liệu trung gian và
bản sao của tất cả các tệp nguồn được đề cập trong cơ sở dữ liệu. Đây là tất cả
thông tin rằng gcov các trang web cần, trong một gói, thuận tiện để sao chép từ
máy phát triển đến máy chủ web. Thông thường tarball này sẽ được trích xuất thành một
thư mục con của / var / ggcov / tests / trên máy chủ web.

Đối số được sử dụng để chỉ định cách tìm tệp dữ liệu vùng phủ sóng. Các đối số có thể
sự kết hợp của:

thư mục
Thư mục được quét để tìm các tệp nguồn, được xử lý như thể chúng đã được
được chỉ định trên dòng lệnh (ngoại trừ việc các tệp dữ liệu phạm vi bị thiếu vẫn đang âm thầm
mặc kệ). Nếu -r cờ có hiệu lực, các thư mục con được quét đệ quy.
Nhiều thư mục có thể được chỉ định và được quét theo thứ tự đã cho.

thực thi được
Tệp thực thi được quét để gỡ lỗi các bản ghi có chứa tệp nguồn
tên và mỗi tệp nguồn tồn tại được xử lý như thể nó đã được chỉ định trên
dòng lệnh (ngoại trừ việc các tệp dữ liệu vùng bị thiếu sẽ bị bỏ qua một cách im lặng).
Mọi thư viện dùng chung mà tệp thực thi phụ thuộc vào đó cũng được quét. Nhiều
các tệp thực thi có thể được chỉ định và được quét theo thứ tự đã cho. Tính năng này là
chỉ khả dụng trên một số nền tảng (ví dụ: i386-linux).

tập tin nguồn
Có phải bất kỳ tệp thông thường nào kết thúc bằng một trong các phần mở rộng tệp không .c, . Cc, .cxx, .cpp, hoặc là
.C. Các tệp nguồn được đối sánh với các tệp dữ liệu phạm vi tương ứng của chúng (.gcno và
.gcda tệp, hoặc .bb, .bbgvà .gives tệp với trình biên dịch cũ hơn) và tệp đối tượng bởi
tìm kiếm một tệp có cùng tên cơ sở và phần mở rộng thích hợp trước tiên trong
cùng thư mục với tệp nguồn và sau đó trong tất cả các thư mục được chỉ định trên
dòng lệnh (theo thứ tự chúng đã được chỉ định).

LỰA CHỌN

-f kiểm tra.tgz, --output-tệp=kiểm tra.tgz
Tạo đầu ra cho tên tệp kiểm tra.tgz thay vì mặc định gccov.webdb.tgz. Các
tên tập tin đặc biệt - có thể được sử dụng để tạo đầu ra cho stdout.

-o dir, --object-thư mục=dir
Thêm thư mục dir tới đường dẫn tìm kiếm tệp đối tượng và tệp dữ liệu vùng phủ.

-r, --đệ quy
Khi một thư mục được chỉ định trên dòng lệnh, hãy tìm kiếm các tệp dữ liệu vùng phủ
đệ quy trong tất cả các thư mục con.

-X biểu tượng, --suppress-ifdef =biểu tượng
Không đưa vào số liệu thống kê hoặc tóm tắt, mã bên trong C chỉ thị tiền xử lý
mà phụ thuộc vào bất kỳ biểu tượng. Một hoặc nhiều ký hiệu có thể được đưa ra,
phân tách bằng dấu phẩy hoặc khoảng trắng. Ggcov-webdb hiểu tập hợp con sau của
bộ lệnh tiền xử lý C:

· #nếu KÝ HIỆU
· #nếu được xác định (SYMBOL)
· #ifdef KÝ HIỆU
· #ifndef KÝ HIỆU
· #khác
· #endif

Ví dụ, -X DEBUG sẽ ngăn chặn fprintf () gọi trong mã này:

int không dấu
my_ function (unsigned int x)
{
x + = 42;
#ifdef GỢI Ý
fprintf (stderr, "my_ function: x =% u \ n", x);
#endif
trả về x;
}

Tùy chọn này hữu ích để loại bỏ mã cơ sở hạ tầng thử nghiệm, mã gỡ lỗi hoặc
mã khác được biên dịch thành khả năng thực thi kiểm tra phạm vi nhưng có phạm vi bảo hiểm
không đáng kể.

-Y từ, --suppress-comment =từ
Không đưa vào số liệu thống kê hoặc tóm tắt, mã trên các dòng cũng chứa
nhận xét một dòng chỉ bao gồm một trong các nhận xét đã cho từ. Một hoặc nhiều ký hiệu
có thể được cho trước, phân tách bằng dấu phẩy hoặc khoảng trắng. Ví dụ, chỉ định -Y
PHỚT LỜ TÔI sẽ ngăn chặn khẳng định () trong mã này:

int không dấu
my_ function (unsigned int x)
{
x + = 42;
khẳng định (x> = 42); /* PHỚT LỜ TÔI */
trả về x;
}

Tùy chọn này hữu ích để loại bỏ mã cơ sở hạ tầng thử nghiệm, mã gỡ lỗi hoặc
mã khác được biên dịch thành khả năng thực thi kiểm tra phạm vi nhưng có phạm vi bảo hiểm
không đáng kể.

-Z từ đầu, từ cuối, ...

--suppress-comment-between =từ đầu, từ cuối, ...
Không đưa vào số liệu thống kê hoặc tóm tắt, mã trên các dòng giữa những thứ có chứa
bình luận một dòng chỉ bao gồm từ đầu và nhận xét một dòng tiếp theo
chỉ bao gồm lời kết. Hai hoặc nhiều ký hiệu có thể được đưa ra, theo từng cặp, cách nhau bằng
dấu phẩy hoặc khoảng trắng. Ví dụ, -Z STARTIGNORE, ENDIGNORE sẽ ngăn chặn
toàn bộ chức năng trong mã này:

/ * BẮT ĐẦU * /
int không dấu
my_ function (unsigned int x)
{
x + = 42;
trả về x;
}
// KẾT THÚC

Tùy chọn này hữu ích để loại bỏ mã cơ sở hạ tầng thử nghiệm, mã gỡ lỗi hoặc
mã khác được biên dịch thành khả năng thực thi kiểm tra phạm vi nhưng có phạm vi bảo hiểm
không đáng kể.

VÍ DỤ

Tạo cơ sở dữ liệu trung gian cho tất cả nguồn có sẵn trong tệp thực thi a.ra (trên
chỉ một số nền tảng) và cài đặt dưới dạng thử nghiệm foo ở vị trí thử nghiệm mặc định.

mkdir / var / ggcov / tests / foo
gccov-webdb -f - a.ra |
(CD / var / ggcov / tests / foo ; tar - xzf - )

Tạo cơ sở dữ liệu trung gian cho tất cả nguồn C trong thư mục hiện tại.

gccov-webdb *.NS

Tạo cơ sở dữ liệu trung gian cho tất cả nguồn C trong một thư mục chứa đối tượng
tệp và tệp dữ liệu vùng kiểm tra nằm trong các thư mục khác nhau:

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

Sử dụng ggcov-webdb trực tuyến bằng các dịch vụ onworks.net