Exécution de la couverture de code en mode sans interface graphique

L'exécution de la couverture de code en mode sans interface graphique vous permet d'exécuter une analyse de couverture de code sans ouvrir d'interface utilisateur. Ce mode est idéal pour les environnements dépourvus de plan de travail à interface utilisateur et/ou dans lesquels il est parfois nécessaire d'exécuter la couverture de code depuis la ligne de commande ou dans le cadre d'un script.

Pourquoi et quand exécuter cette tâche

Vous pouvez exécuter une couverture de code pour toutes les applications en langage compilé que vous pouvez déboguer depuis la ligne de commande ou dans le cadre d'un script. La couverture de code sans interface graphique peut être exécutée dans deux modes :

  1. En tant que démon à l'écoute d'une connexion (à utiliser avec un moteur de débogage à distance, utilisant le port spécifié (voir Exécuter la couverture de code en mode sans interface graphique : Démon pour plus d'informations).
  2. Agissant directement sur un programme compilé avec des informations de débogage, spécifié comme argument (mode ponctuel).
    Remarque : Le mode ponctuel est seulement disponible pour AIX/Linux. Il ne l'est pas pour z Series.
    $ codecov testProg
Remarque : Les résultats sont stockés par date dans la racine du répertoire de base de l'utilisateur, sous le dossier CC.
Le diagramme de syntaxe de la commande codecov est présenté ci-après :
>>-codecov--+----------------------------------------------------------------------------------------------------------------+--><
            |                                                                                                                |
            + -stopdaemon=<NUMERO_PORT> -------------------------------------------------------------------------------------+
            |                                                                                                                |
            + <NOM_PROG>  <PARAMETRES_PROG>  -optionsfile=<CHEMIN> -------+                                                  |
            |                                                             |                                                  |
            |                                     .------------------.    |                                                  |
            |                                     v                  |    v                                                  |
            + -startdaemon  -optionsfile=<CHEMIN> --+------------------------+--------------------------------------------+--+
            |                                     |                  |       |                                            |  |
            |                                     + -singleconnect --+       + -output=<CHEMIN> --------------------------+  |
            |                                     |           	     |       |                                            |  |
            |                                     + -localonly ------+       + -cclevel=<"LINE" | "FUNCTION" | "LEVEL"> --+  |
            |                                                                |                                            |  |
            |                                                                + -prevresultpath=<"NONE" | "PREV" | CHEMIN> +  |
            |                                                                |                                            |  |
            |                                                                + -reportformat=<"HTML" | "NONE"> -----------+  |
            |                                                                |                                            |  |
            |                                                                + -savesource -------------------------------+  |
            |                                                                |                                            |  |
            |                                                                + -startupcommandlist=<CHEMIN> --------------+  |
            |                                                                |                                            |  |
            |                                                                + -zipresult --------------------------------+  |
            |                                                                |                                            |  |
            |                                                                + -port=<LISTE_PORTS> -----------------------+  |
            |                                                                                                                |  
            + -help ---------------------------------------------------------------------------------------------------------+
                                           
Liste d'options
Format : codecov [options] [nom_prog] [paramètres_prog]
nom_prog
Le chemin complet de l'exécutable sur lequel la couverture de code doit être exécutée.
Remarque : Le mode ponctuel est seulement disponible sur AIX/Linux. Il ne l'est pas sur z Series.
paramètres_prog
Les paramètres du programme.
Remarque : Le mode ponctuel est seulement disponible sur AIX/Linux. Il ne l'est pas sur z Series.
-startdaemon
Permet de démarrer en mode démon et d'attendre une connexion.
-stopdaemon=<port>
Arrête le démon qui est à l'écoute sur le port.
-cclevel=<"LINE" | "FUNCTION" | "MODULE">
Le niveau de couverture de code appliqué ("LINE", "FUNCTION" ou "LINE")
-modulelist=<chemin>
Au besoin, spécifiez un fichier contenant la liste des modules utilisés par le niveau MODULE.
-prevresultpath=<"NONE" | "PREV" | chemin>
Spécifiez le chemin du fichier de résultats précédents.
-reportformat=<"HTML" | "NONE">
Permet de générer un rapport HTML si le format du rapport est HTML.
-singleconnect
Quitter après la première connexion du démon (à utiliser avec -startDaemon).
-localonly
Le démon acceptera uniquement les connexions de l'hôte local.
startupcommandlist=<chemin>
Désigne un fichier contenant des commandes qui seront envoyées au moteur de débogage au démarrage.
-savesource
Sauvegarde la source avec les résultats.
-optionsfile=<chemin>
Lit les arguments de la commande dans un fichier d'options spécifié ici.
-tag="texte"
Spécifie une balise (ou étiquette) qui sera associée aux résultats de la couverture de code. Par exemple, l'ID du scénario de test.
-zipresult
Le répertoire de résultats est compressé dans un fichier zip portant le même nom que ce répertoire.
-port=<liste_ports>
Le numéro de port, la liste de ports (port,port) ou la plage de ports (port-port) à utiliser par le démon de débogage.
-help
Imprime l'écran d'aide.

Commentaires