Accueil
Référence
Consultez les informations de référence relatives au produit.
L'utilitaire de génération Ounce/Make
Ounce/Make est un outil automatisant l'importation d'informations de configuration dans AppScan® Source à partir d'environnements de génération utilisant un fichier makefile. Ounce/Make vous évite d'avoir à importer manuellement ces informations des fichiers makefiles. C'est la méthode recommandée pour configurer ces projets.
Exemples
Cette section décrit trois façons d'utiliser Ounce/Make.
Exemple 2 : Ounce/Make avec option de récursivité
Avec l'option -r, Ounce/Make opère en mode récursif (en suivant les appels à d'autres fichiers makefile depuis un fichier makefile). Etant donné que le mode de fichier à plusieurs projets est celui par défaut, lorsqu'il est utilisé avec l'option -r, Ounce/Make crée un fichier de projet AppScan® Source pour chaque fichier makefile rencontré compilant le code source.

Référence
Consultez les informations de référence relatives au produit.
- L'utilitaire de génération Ounce/Make
  Ounce/Make est un outil automatisant l'importation d'informations de configuration dans AppScan® Source à partir d'environnements de génération utilisant un fichier makefile. Ounce/Make vous évite d'avoir à importer manuellement ces informations des fichiers makefiles. C'est la méthode recommandée pour configurer ces projets.
  - Configuration requise
    Pour créer correctement des fichiers de projet AppScan® Source, vous devez exécuter Ounce/Make dans un environnement adapté. La liste suivante répertorie les exigences pour une exécution correcte d'Ounce/Make. Si toutes ces exigences ne sont pas remplies, l'exécution Ounce/Make échouera.
  - Eléments pris en charge par Ounce/Make
    Ounce/Make prend en charge plusieurs plateformes d'ordinateur, compilateurs et versions de make.
  - Opération
    Ounce/Make fonctionne avec votre commande Make afin d'extraire de vos fichiers makefile les informations de configuration nécessaires et de créer les fichiers de projet AppScan® Source appropriés (ppf). Pour ce faire, Ounce/Make requiert que vous fournissiez certaines informations sur l'environnement de génération, comme la version de la commande make utilisée.
  - Options make et syntaxe de commande Ounce/Make
    Ounce/Make prend en charge de nombreuses options pouvant modifier son comportement lors de son exécution.
  - Fichier de propriétés Ounce/Make
    Le fichier de propriétés Ounce/Make (ouncemake_properties.xml) est un fichier au format XML contenant des informations sur l'environnement de génération. Lors de son exécution, Ounce/Make localise ce fichier d'après le chemin de recherche ou l'option -p. Le fichier de propriétés doit indiquer le compilateur utilisé dans l'environnement de génération, l'éditeur de liens et les éléments make.
  - Exemples
    Cette section décrit trois façons d'utiliser Ounce/Make.
    - Exemple 1 : Ounce/Make sans options
      Cet exemple illustre une utilisation non récursive d'Ounce/Make. Sous ce mode, Ounce/Make n'examine que le fichier makefile dans le répertoire depuis lequel il est appelé. Si le fichier makefile original comporte des appels à d'autres fichiers makefiles, Ounce/Make les ignore.
    - Exemple 2 : Ounce/Make avec option de récursivité
      Avec l'option -r, Ounce/Make opère en mode récursif (en suivant les appels à d'autres fichiers makefile depuis un fichier makefile). Etant donné que le mode de fichier à plusieurs projets est celui par défaut, lorsqu'il est utilisé avec l'option -r, Ounce/Make crée un fichier de projet AppScan® Source pour chaque fichier makefile rencontré compilant le code source.
    - Exemple 3 : Ounce/Make avec projet unique et option de récursivité
      L'exemple 3 illustre une utilisation récursive d'Ounce/Make en mode de projet unique. Ounce/Make génère un seul fichier de projet AppScan® Source combinant le code source compilé par tous les fichiers makefile rencontrés.
- AppScan® Source
  L'interface CLI est une interface de la fonctionnalité de base AppScan® Source.
- L'outil de génération Ounce/Ant
  Cette section décrit comment utiliser Ounce/Ant, qui est un utilitaire de génération AppScan® Source intégrant AppScan Source et Apache Ant. L’intégration d’Ounce/Ant avec votre environnement Ant vous aide à automatiser les générations et les évaluations de code.
- API d'accès aux données AppScan® Source
  L'API d'accès aux données fournit l'accès aux résultats d'évaluation générés par AppScan® Source, y compris aux constatations et aux détails des constatations. Elle donne également accès aux métriques d'évaluation telles que la date et l'heure de l'analyse, le nombre de lignes de code, la densité V et le nombre de constatations.
- Glossaire
  Apprenez la terminologie courante du produit

Exemple 2 : Ounce/Make avec option de récursivité

Avec l'option -r, Ounce/Make opère en mode récursif (en suivant les appels à d'autres fichiers makefile depuis un fichier makefile). Etant donné que le mode de fichier à plusieurs projets est celui par défaut, lorsqu'il est utilisé avec l'option -r, Ounce/Make crée un fichier de projet AppScan® Source pour chaque fichier makefile rencontré compilant le code source.

Voir Structure de répertoire et de fichiers pour une illustration graphique de la structure de répertoires et de fichiers sur laquelle repose cet exemple.

Commande

ouncemake -r

L'option -r (récursivité) indique à Ounce/Make de suivre les appels du fichier makefile à d'autres fichiers makefile. Pour une description plus détaillée de l'option de récursivité, reportez-vous au tableau de la rubrique Options make et syntaxe de commande Ounce/Make.

Le diagramme suivant présente le contenu des répertoires à l'issue de l'exécution d'Ounce/Make :

Structure de répertoire après exécution de Ounce/Make

Dans cet exemple, Ounce/Make crée un fichier de projet AppScan® Source dans /usr/source et /usr/source/server. Etant donné que le fichier makefile dans /usr/source a appelé les fichiers dans /usr/source/database et /usr/source/server, Ounce/Make a vérifié si ces derniers ont compilé un code source.

Dans le cas du fichier makefile du répertoire /usr/source/database, Ounce/Make a déterminé qu'il ne compile pas de code source ; par conséquent, il n'a pas créé de fichier de projet AppScan® Source. En revanche, Ounce/Make a déterminé que le fichier makefile du répertoire /usr/source/server compile les fichiers source de ce répertoire et an donc généré un fichier de projet AppScan® Source pour les fichiers source dans /usr/source/server.