ggcov-webdb - En ligne dans le cloud

PROGRAMME:

Nom

ggcov-webdb - génère une base de données intermédiaire pour l'interface Web ggcov

SYNOPSIS

ggcov-webdb [[-r] annuaire|filet]...

DESCRIPTION

Ggcov-webdb génère une base de données intermédiaire et une arborescence de fichiers sources à partir d'un développement
répertoire, sous la forme d'une archive tar. Les fichiers de cette archive tar sont ensuite utilisés par le
gggov Pages PHP pour présenter les données de couverture de test aux navigateurs WWW.

Les données de couverture de test sont produites par des programmes C et C++ compilés avec gcc -fprofile-arcs
-ftest-couverture. Donc la combinaison de ggcov-webdb et la gggov Les pages PHP sont fondamentalement un
Remplacement WWW pour le gcov programme fourni avec gcc.

L'approche de la base de données intermédiaire est utilisée pour gérer le cas courant où le développement
la machine et la machine du serveur Web sont distinctes. La base de données contient des données de couverture en
un formulaire indexé, indépendant de la plate-forme et compatible avec PHP. Parce que le format de la base de données est
indépendamment de la plate-forme, les pages PHP peuvent être déployées sur des serveurs Web d'un autre
architecture aux machines de développement. En fait le gggov les pages Web prennent en charge n'importe quel site Web
serveur répondant aux critères suivants :

· prend en charge PHP version 4.3 ou ultérieure, et

· fournit le dba prolongation avec le db4 fournisseur (qui gggov utilise pour lire le
base de données intermédiaire), et

· fournit le gd rallonge (qui gggov utilise pour générer les bargraphes sur le
page récapitulative).

Le site de sourceforge.net Le serveur Web du projet est un exemple d'un tel serveur.

Ggcov-webdb produit une archive tar compressée contenant la base de données intermédiaire elle-même et
copies de tous les fichiers sources qui sont mentionnés dans la base de données. C'est tout le
informations que le gggov les pages Web ont besoin, dans un seul paquet qui est pratique à copier à partir
la machine de développement au serveur Web. Habituellement, cette archive tar serait extraite dans un
sous-répertoire de /var/ggcov/tests/ sur le serveur Web.

Les arguments sont utilisés pour spécifier comment rechercher les fichiers de données de couverture. Les arguments peuvent
combinaisons de :

annuaire
Le répertoire est analysé à la recherche de fichiers source, qui sont traités comme s'ils avaient été
spécifié sur la ligne de commande (sauf que les fichiers de données de couverture manquants sont silencieusement
ignoré). Si la -r flag est activé, les sous-répertoires sont scannés de manière récursive.
Plusieurs répertoires peuvent être spécifiés et sont analysés dans l'ordre indiqué.

exécutable
Le fichier exécutable est analysé pour les enregistrements de débogage qui contiennent le fichier source
noms, et chaque fichier source existant est traité comme s'il avait été spécifié sur
la ligne de commande (sauf que les fichiers de données de couverture manquants sont ignorés en silence).
Toutes les bibliothèques partagées dont dépend l'exécutable sont également analysées. Plusieurs
les exécutables peuvent être spécifiés et sont analysés dans l'ordre indiqué. Cette fonctionnalité est
uniquement disponible sur certaines plates-formes (par exemple, i386-linux).

fichier source
Un fichier normal se termine-t-il par l'une des extensions de fichier .c, . Cc, .cxx, .cpp, ou
.C. Les fichiers sources sont appariés à leurs fichiers de données de couverture correspondants (.gcno et
.gcda des fichiers, ou .bb, .bbget la bien-aimée Sonate en la majeur .da avec des compilateurs plus anciens) et des fichiers objets par
rechercher un fichier du même nom de base et de l'extension appropriée en premier dans
le même répertoire que le fichier source puis dans tous les répertoires spécifiés sur
la ligne de commande (dans l'ordre où ils ont été spécifiés).

OPTIONS

-f test.tgz, --fichier de sortie=test.tgz
Générer une sortie vers le nom de fichier test.tgz au lieu de la valeur par défaut ggcov.webdb.tgzL’
nom de fichier spécial - peut être utilisé pour générer une sortie sur stdout.

-o dir, --répertoire-objet=dir
Ajouter le répertoire dir au chemin de recherche des fichiers d'objets et des fichiers de données de couverture.

-r, --recursive
Lorsqu'un répertoire est spécifié sur la ligne de commande, recherchez les fichiers de données de couverture
récursivement dans tous les répertoires enfants.

-X symboles, --suppress-ifdef=symboles
Ne pas inclure dans les statistiques ou les résumés, le code à l'intérieur des directives du préprocesseur C
qui dépendent de l'un des donnés symboles. Un ou plusieurs symboles peuvent être indiqués,
séparés par des virgules ou des espaces. Ggcov-webdb comprend le sous-ensemble suivant de
le jeu de commandes du préprocesseur C :

· #si SYMBOLE
· #si défini(SYMBOLE)
· #ifdef SYMBOLE
· #ifndef SYMBOLE
· #else
· #endif

Par exemple, -X DEBUG supprimera le fprintf() appelez ce code :

entier non signé
ma_fonction (entier non signé x)
{
x += 42 ;
#ifdef DÉBOGAGE
fprintf(stderr, "ma_fonction : x=%u\n", x);
#endif
renvoie x ;
}

Cette option est utile pour supprimer le code d'infrastructure de test, le code de débogage ou
autre code qui est compilé dans l'exécutable de test de couverture mais dont la couverture
n'est pas significatif.

-Y gentils, --suppress-comment=gentils
Ne pas inclure dans les statistiques ou les résumés, le code sur les lignes qui contiennent également un
commentaire d'une seule ligne comprenant un seul des gentils. Un ou plusieurs symboles
peut être donné, séparé par des virgules ou des espaces. Par exemple, en spécifiant -Y
IGNORE MOI supprimera le affirmer() dans ce code :

entier non signé
ma_fonction (entier non signé x)
{
x += 42 ;
affirmer (x >= 42); /* IGNORE MOI */
renvoie x ;
}

Cette option est utile pour supprimer le code d'infrastructure de test, le code de débogage ou
autre code qui est compilé dans l'exécutable de test de couverture mais dont la couverture
n'est pas significatif.

-Z mot de début, mot de fin,...

--suppress-comment-entre=mot de début, mot de fin,...
Ne pas inclure dans les statistiques ou les résumés, le code sur les lignes entre celles contenant un
commentaire d'une seule ligne comprenant seulement mot de départ et le prochain commentaire sur une seule ligne
comprenant seulement mot final. Deux symboles ou plus peuvent être donnés, par paires, séparés par
des virgules ou des espaces. Par exemple, -Z DÉBUTIGNORE,ENDIGNORE supprimera le
fonction entière dans ce code :

/* COMMENCER IGNORER */
entier non signé
ma_fonction (entier non signé x)
{
x += 42 ;
renvoie x ;
}
// ENDIGNORER

Cette option est utile pour supprimer le code d'infrastructure de test, le code de débogage ou
autre code qui est compilé dans l'exécutable de test de couverture mais dont la couverture
n'est pas significatif.

EXEMPLES

Générer une base de données intermédiaire pour toutes les sources disponibles dans l'exécutable a.out (sur
certaines plates-formes uniquement) et installer en tant que test foo dans l'emplacement de test par défaut.

mkdir /var/ggcov/tests/foo
ggcov-webdb -f - a.out |
(CD /var/ggcov/tests/foo ; goudron -xzf - )

Générer une base de données intermédiaire pour toutes les sources C du répertoire courant.

ggcov-webdb *.c

Générer une base de données intermédiaire pour toute la source C dans un répertoire où l'objet
les fichiers et les fichiers de données de couverture de test se trouvent dans des répertoires différents :

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

Utilisez ggcov-webdb en ligne en utilisant les services onworks.net