ggcov-webdb - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

ggcov-webdb - створити проміжну базу даних для веб-інтерфейсу ggcov

СИНТАКСИС

ggcov-webdb [[-r] каталог|файл] ...

ОПИС

Ggcov-webdb створює проміжну базу даних і дерево вихідних файлів з розробки
каталог у вигляді архіву. Файли в цьому tar-архіві пізніше використовуються
ggcov Сторінки PHP для представлення даних тестового покриття для WWW-браузерів.

Дані тестового покриття створюються програмами C і C++, скомпільованими з ПКУ -fprofile-arcs
-ftest-покриття. Отже, поєднання ggcov-webdb і ggcov Сторінки PHP - це в основному a
WWW заміна для gcov програма, яка постачається з ПКУ.

Проміжний підхід до бази даних використовується для обробки звичайного випадку, коли розробка
машина і машина веб-сервера є окремо. База даних містить дані про покриття в
індексована, незалежна від платформи, зручна для PHP форма. Оскільки формат бази даних є
Незалежно від платформи сторінки PHP можуть бути розгорнуті на різних веб-серверах
архітектури до машин розробки. Насправді ggcov веб-сторінки підтримують будь-який Інтернет
сервер, який відповідає наступним критеріям:

· підтримує PHP версії 4.3 або новішої, і

· забезпечує адміністратор бази даних розширення з db4 провайдер (який ggcov використовує для читання
проміжна база даних), і

· забезпечує gd розширення (яке ggcov використовує для створення стовпчастих графіків на
Підсумкова сторінка).

Команда sourceforge.net Прикладом такого сервера є веб-сервер проекту.

Ggcov-webdb створює запакований файл tar-архів, що містить саму проміжну базу даних і
копії всіх вихідних файлів, які згадуються в базі даних. Це все
інформація про те, що ggcov потрібні веб-сторінки в одному пакеті, з якого зручно копіювати
машину розробки на веб-сервер. Зазвичай цей файл архіву витягується в файл
підкаталог /var/ggcov/tests/ на веб -сервері.

Аргументи використовуються для визначення способу пошуку файлів даних покриття. Аргументи можуть
комбінації:

каталог
Каталог перевіряється на наявність вихідних файлів, які обробляються так, ніби вони були
вказано в командному рядку (за винятком того, що відсутні файли даних покриття без звуку
ігнорується). Якщо -r прапорець діє, підкаталоги скануються рекурсивно.
Можна вказати кілька каталогів, які скануються в заданому порядку.

виконуваний файл
Виконуваний файл сканується на наявність записів налагодження, які містять вихідний файл
імена, і кожен вихідний файл, який існує, обробляється так, ніби він був вказаний на
командний рядок (за винятком того, що файли даних покриття, які відсутні, ігноруються).
Будь-які спільні бібліотеки, від яких залежить виконуваний файл, також перевіряються. Кілька
можна вказати виконувані файли та їх сканувати в зазначеному порядку. Ця функція є
доступний лише на деяких платформах (наприклад, i386-linux).

вихідний файл
Будь-який звичайний файл, що закінчується на одне з розширень файлу .c, . CC, .cxx, .cppабо
.C. Вихідні файли зіставляються з відповідними файлами даних покриття (.gcno та
.gcda файли, або .bb, .bbg та .da файли зі старими компіляторами) та об’єктні файли by
пошук файлу з таким самим базовим іменем і відповідним розширенням спочатку в
той самий каталог, що й вихідний файл, а потім у всіх каталогах, зазначених на
командний рядок (у тому порядку, в якому вони були вказані).

ВАРІАНТИ

-f test.tgz, -- вихідний файл=test.tgz
Згенеруйте вихідні дані для імені файлу test.tgz замість за замовчуванням ggcov.webdb.tgz,
спеціальне ім'я файлу - можна використовувати для створення виводу в стандартний вихід.

-o реж, --об'єктний каталог=реж
Додайте каталог реж до шляху пошуку файлів об’єктів та файлів даних покриття.

-r, --рекурсивний
Коли в командному рядку вказано каталог, шукайте файли даних покриття
рекурсивно у всіх дочірніх каталогах.

-X Символи, --suppress-ifdef=Символи
Не включайте в статистику чи зведення код всередині директив препроцесора C
які залежать від будь-якого з даного Символи. Можна надати один або кілька символів,
розділені комами або пробілами. Ggcov-webdb розуміє наступну підмножину
набір команд попереднього процесора C:

· # якщо СИМВОЛ
· # якщо визначено (СИМВОЛ)
· #ifdef СИМВОЛ
· #ifndef СИМВОЛ
· #else
· #endif

Наприклад, -X DEBUG буде придушувати fprintf() зателефонуйте за цим кодом:

неподписаний int
my_function (unsigned int x)
{
х += 42;
#ifdef НАЛАШТУВАННЯ
fprintf(stderr, "моя_функція: x=%u\n", x);
#endif
повернути х;
}

Цей параметр корисний для придушення коду тестової інфраструктури, коду налагодження або
інший код, який скомпільовано у виконуваний файл тесту покриття, але покриття якого
не має значення.

-Y слова, --suppress-comment=слова
Не включайте в статистику чи зведення код, у рядках якого також міститься a
однорядковий коментар, що містить лише один із наведених слова. Один або кілька символів
може бути подано, відокремлюючись комами або пробілами. Наприклад, уточнюючи -Y
ІГНОРУВАТИ МЕНЕ буде придушувати assert() у цьому коді:

неподписаний int
my_function (unsigned int x)
{
х += 42;
стверджувати (x >= 42); /* ІГНОРУВАТИ МЕНЕ */
повернути х;
}

Цей параметр корисний для придушення коду тестової інфраструктури, коду налагодження або
інший код, який скомпільовано у виконуваний файл тесту покриття, але покриття якого
не має значення.

-Z початкове слово, кінцеве слово,...

--suppress-comment-between=початкове слово, кінцеве слово,...
Не включайте в статистику чи зведення код у рядках між тими, що містять a
однорядковий коментар, що містить лише початкове слово і наступний однорядковий коментар
містить тільки кінцеве слово. Два або більше символів можуть бути наведені парами, розділені символами
коми або пробіли. Наприклад, -Z СТАРТІГНУРАЙТЕ, НЕГЛЯДУЙТЕ буде придушувати
всю функцію в цьому коді:

/* ПОЧАТКІГНУТИ */
неподписаний int
my_function (unsigned int x)
{
х += 42;
повернути х;
}
// ENDIGNORE

Цей параметр корисний для придушення коду тестової інфраструктури, коду налагодження або
інший код, який скомпільовано у виконуваний файл тесту покриття, але покриття якого
не має значення.

ПРИКЛАДИ

Створіть проміжну базу даних для всіх доступних джерел у виконуваному файлі а (увімкнено
лише на деяких платформах) і встановіть як тест Foo у розташуванні тестів за замовчуванням.

mkdir /var/ggcov/tests/foo
ggcov-webdb -f - а |
(cd /var/ggcov/tests/foo ; дьоготь -xzf - )

Створити проміжну базу даних для всіх джерел C у поточному каталозі.

ggcov-webdb *.c

Створити проміжну базу даних для всіх джерел C в одному каталозі, де знаходиться об’єкт
файли та файли даних тестового покриття знаходяться в різних каталогах:

ggcov-webdb /foo/obj/ /foo/cov-дані/ /foo/src/

Використовуйте ggcov-webdb онлайн за допомогою служб onworks.net