bls-standalone - En ligne dans le Cloud

PROGRAMME:

Nom

bls-standalone - scanner de journaux de construction, version autonome

SYNOPSIS

bls-autonome --Aidez-moi

bls-autonome [ de défis Options ] vérifier [ --fichier de règles compilé fichier de règles ] [ --blhc blhc-
Danse ] fichiers journaux

bls-autonome [ de défis Options ] compiler [ options-compilation ]

bls-autonome [ de défis Options ] caisse

DESCRIPTION

bls-standalone est l'utilitaire de ligne de commande pour exécuter manuellement le scanner de journal de génération
fichiers journaux spécifiés, y compris la prise en charge de la gestion des définitions de règles compilées nécessaires.

GLOBAL OPTIONS

Les options globales peuvent être données avant la commande, les options disponibles sont :

Les options peuvent être spécifiées avant la commande. Chacun affecte un sous-ensemble différent de commandes
et est ignoré par les autres commandes.

-v --verbeux
augmenter la verbosité

--libdir annuaire
spécifiez le répertoire où les binaires de scan et de compilation sont recherchés

--répertoire partagé annuaire
spécifier le répertoire où la copie des fichiers de règles et le package
les données de règle précompilées résident.

COMMANDES

bls-standalone a trois commandes : vérifier, compiler ainsi que le caisse.

vérifier [ --fichier de règles compilé fichier de règles ] [ --blhc programme-blhc ] fichiers journaux
Cette commande exécute le scanner bls et le scanner blhc sur le journal de construction donné
des dossiers. Si aucun fichier de règles compilé n'est fourni avec --fichier de règles compilé puis un
un compilé précédemment est recherché et s'il n'y en a aucun autre que celui livré
avec le paquet est utilisé. blhc est également appelé s'il est trouvé ou spécifié
des --blhcp option. Pour faire taire un avertissement indiquant qu'il n'est pas trouvé, définissez-le sur
NON.

compiler [ -o fichier de sortie ] [ --pas de valeurs par défaut] [ --ignorecheckout] supplémentaire exclure
descriptions
Compile les contrôles dans un formulaire compilé.

Petite remarque, -o est donné pour déterminer un autre endroit, il est stocké dans une cache
répertoire (déterminé par certaines variables d'environnement) où le futur vérifier
les invocations l'utiliseront à la place des règles précompilées empaquetées.

Des descriptions de règles supplémentaires peuvent être données en tant qu'arguments de ligne de commande.

Les règles stockées aux endroits appropriés de votre répertoire personnel sont également examinées. (Voir
où ils sont recherchés, utilisez --verbeux.)

Petite remarque, --pas de valeurs par défaut reçoit le contenu d'un précédent caisse ou la copie de
les règles fournies avec le colis sont également utilisées.

S'il existe des règles du même nom, celles données comme arguments de ligne de commande remplacent
les locaux et les originaux et les locaux remplacent les originaux.

caisse
Découvrez les règles actuelles utilisées pour le scanner de build non autonome dans un
répertoire où le suivant compiler run les utilisera à la place des règles fournies.

Actuellement, cela extrait des parties du référentiel QA svn. Cette URL peut obtenir
obsolète à l'avenir. Si la version bls-standalone que vous utilisez et la version non-
la version autonome de bls se désynchronise, ces règles peuvent contenir des éléments que votre
bls-stanalone ne peut pas gérer.

L'ÉCRITURE DES RÈGLES

Un guide bien trop court pour écrire de nouveaux fichiers de description :

L'analyseur de journal de build non autonome n'est exécuté que pour les builds jugées réussies. Alors vérifie
pour les choses qui devraient généralement faire échouer une construction n'a souvent pas beaucoup de sens (une suite de tests
générer des faux positifs est souvent plus probable que d'attraper une erreur ignorée
incorrectement).

Le nom de fichier est la balise produite pour le test. Trouver un bon nom est souvent le plus difficile
partie sur la rédaction de nouveaux chèques.

La majeure partie du fichier de description est en fait le code html décrivant ce que le résultat est généralement
signifie être affiché sur ⟨http://qa.debian.org/bls/à l'exception des lignes
commençant par ## en haut du fichier.

La description doit contenir les informations suivantes :

Quoi fait le vérifier a trouvé?
Aidez les gens à trouver facilement ce qui correspond. Facilite la recherche du problème, moins
susceptible de le considérer comme un faux positif s'il ne l'est pas, et de perdre moins de temps s'il
est en fait un faux positif.

Constat is est ce que nous faisons is trouvé a problème?
Même les défauts les plus graves peuvent facilement être ignorés comme des problèmes mineurs dus à l'ignorance.
Et certaines choses ne sont dangereuses que dans certaines situations et ne nécessitent pas la plus haute
priorité dans d'autres situations. Distinguer les deux cas est difficile et quelques mots supplémentaires dans le
description à ce sujet peut aider beaucoup.

Quoi vous be fait à opposer à il?
Quelques astuces pour éviter le problème aident à la fois celui qui doit le résoudre un certain temps à chercher
une solution. Ceci est particulièrement utile pour aider les gens à le réparer correctement au lieu de seulement
cacher le problème plus complètement.

Les directives ## réelles au début du fichier sont :

Fusionner:
Cette ligne indique que cette vérification se déclenche si d'autres vérifications apparaissent sur la même ligne.

Il n'y a actuellement que deux formulaires pris en charge :

##Fusionner: même nom de balise1 nom de balise2

ainsi que le

##Fusionner: même nom de balise1 nom de balise2a or nom de balise2b

Afficher les résultats avec:
Il s'agit d'une expression régulière décrivant ce à quoi correspond chaque ligne du journal de construction
pour trouver le problème, préfixé par expression régulière :. Comme extension à la syntaxe régulière, il y a
un atome \/ qui spécifie qu'une fois qu'une ligne correspond à cette partie, aucune vérification qui ne
avoir un \/ à cet endroit est censé correspondre à cette ligne. (Il s'agit d'une optimisation pour
rogner fortement la machine d'état de compilation, mais il peut également être utilisé pour éviter les faux-
positifs).

Comme toutes les expressions régulières de toutes les vérifications sont compilées dans une seule machine à états finis,
les chèques qui sont très spécifiques en début de ligne sont assez bon marché alors que les chèques ne
spécifiques au départ sont souvent assez chers. La taille de la machine d'état produite par
le compiler commande est une bonne mesure du coût du contrôle spécifique.

Puisque:
S'il y a de nouvelles règles alors les informations à ⟨http://qa.debian.org/bls/⟩ pourrait être
obsolète jusqu'à ce que tous les journaux soient réanalysés avec la nouvelle version. Pour chaque journal scanné par le
scanner de journaux de construction non autonome, le numéro de version des règles utilisées est mémorisé. Les
numéro spécifié avec le Depuis que le champ indique au rapport Web généré où placer
avertit que les informations sur cette vérification peuvent être obsolètes.

Extrait:
Cela indique comment extraire les informations du fichier correspondant à afficher avec le
ligne correspondante (comme un nom de fichier dans lequel quelque chose a été trouvé).

Les formulaires suivants sont actuellement pris en charge ici :

##Extrait: simple 0 compte final 'caractère de fin'
##Extrait: simple 0 'réinitialiser' compte final 'caractère de fin'
##Extrait: simple nombre de départ 'char de démarrage' compte final 'caractère de fin'
##Extrait: simple nombre de départ 'char de démarrage' 'réinitialiser' compte final 'caractère de fin'

Où char de démarrage est un caractère à rechercher pour le début de la zone extraite (après le
nombre de départème occurrence). réinitialiser est un caractère pour interrompre l'extraction. caractère de fin est une
caractère à rechercher pour la fin de la zone extraite (après le compte finalth
occurrence).

Par exemple :
##Extrait: simple 2 '|' '/' 1 '|' signifie extraire le contenu entre le 2e et le 3e
symbole de tuyau, sauf s'il y a une barre oblique entre les deux.

D'action:
décrit ce qu'il faut faire si un commutateur correspond. Cela peut être utilisé pour définir des variables référencées
dans d'autres règles pour générer des règles contextuelles.

Etat:
ajouter des conditions (sur les variables définies par ##Action). Si la condition n'est pas remplie, le
la génération d'un résultat est supprimée.

CEVEATS

Alors que la compilation de toutes les correspondances dans une seule machine à états finis produit des résultats très rapides,
cela n'est faisable que tant que la machine d'état ne grandit pas trop. Il faut donc faire attention
pris pour ne pas utiliser des recherches trop coûteuses.

Certains contrôles (en particulier ceux spécifiques au contexte) sont assez peu fiables. Le non autonome
les vérifications du journal de génération n'incluent pas certains résultats pour le résumé à moins qu'ils n'apparaissent sur
plusieurs architectures, ce que bls-standalone ne peut évidemment pas faire.

bls est optimisé pour être rapide. Ne l'exécutez pas avec des fichiers de règles auxquels vous ne faites pas confiance. (Seulement le
le contenu des fichiers journaux analysés est censé être des données non fiables).

blhc est assez lent, ce qui n'est heureusement pas perceptible s'il n'analyse pas les fichiers journaux de
l'ensemble des archives. Si vous testez de nouvelles règles sur un plus grand ensemble de fichiers journaux, utilisez --blhc=NON vous
accélérer un peu les choses.

blhc ne rapporte pas les numéros de ligne, donc bls-standalone ne peut pas les rapporter pour ces résultats.

Notez que vérifier les journaux d'une exécution de dpkg-buildpackage -b et d'une exécution de dpkg-buildpackage -B
peut faire une différence (donc si vous ne pouvez pas reproduire un E-binary-arch-produces-all assurez-vous
vous vérifiez le bon type de journal).

DE LA LIGNE BOGUES

Signaler des bogues ou des demandes de liste de souhaits au BTS Debian
(par exemple en utilisant Rapportez une erreur bls-autonome sous Debian)
ou directement à [email protected]

DROIT D'AUTEUR

Copyright © 2013,2014,2015 Bernhard R. Lien ⟨http://www.brlink.eu⟩
C'est un logiciel libre ; voir la source pour les conditions de copie. Il n'y a AUCUNE garantie ; ne pas
même pour la QUALITÉ MARCHANDE ou l'ADAPTATION À UN USAGE PARTICULIER.

Utilisez bls-standalone en ligne à l'aide des services onworks.net