bls-standalone: ​​en línea en la nube

PROGRAMA:

NOMBRE

bls-standalone: ​​escáner de registro de compilación, versión independiente

SINOPSIS

bls-independiente --ayuda

bls-independiente [ global opciones ] check [ --archivo de reglas compilado archivo de reglas ] [ --blhc blhc-
programa ] los archivos de registro

bls-independiente [ global opciones ] compilar [ opciones de compilación ]

bls-independiente [ global opciones ] caja

DESCRIPCIÓN

bls-standalone es la utilidad de línea de comandos para ejecutar el escáner de registro de compilación manualmente
archivos de registro especificados, incluido el soporte para administrar las definiciones de reglas compiladas necesarias.

GLOBAL OPCIONES

Las opciones globales se pueden dar antes del comando, las opciones disponibles son:

Las opciones se pueden especificar antes del comando. Cada uno afecta a un subconjunto diferente de comandos
y es ignorado por otros comandos.

-v --verboso
aumentar la verbosidad

--libdir directorio
especificar el directorio donde se buscan los binarios de escaneo y compilación

--compartirir directorio
especificar el directorio donde la copia de los archivos de reglas y el paquete
residen datos de reglas precompilados.

COMANDOS

bls-standalone tiene tres comandos: check, compilar y caja.

check [ --archivo de reglas compilado archivo de reglas ] [ --blhc programa blhc ] los archivos de registro
Este comando ejecuta el escáner bls y el escáner blhc en el registro de compilación dado
archivos. Si no se proporciona un archivo de reglas compilado con --archivo de reglas compilado Entonces un
se busca uno previamente compilado y si no hay ninguno que el enviado
junto con el paquete se utiliza. blhc también se llama si se encuentra o se especifica
con el --blhcp opción. Para silenciar una advertencia acerca de que no se encuentra, configúrelo en
NO.

compilar [ -o archivo de salida ] [ - sin valores predeterminados] [ --ignorar el pago] adicional gobernar
descripciones
Compila las comprobaciones en un formato compilado.

A no ser que -o se da para determinar un lugar diferente, se almacena en un caché
directorio (determinado por algunas variables de entorno) donde el futuro check
las invocaciones lo usarán además de las reglas precompiladas empaquetadas.

Se pueden proporcionar descripciones de reglas adicionales como argumentos de línea de comando.

También se examinan las reglas almacenadas en los lugares adecuados de su directorio personal. (Para ver
donde se buscan, utilizar --verboso.)

A no ser que - sin valores predeterminados se le da el contenido de un anterior caja o la copia de
También se utilizan las reglas enviadas con el paquete.

Si hay reglas con el mismo nombre, las dadas como argumentos de la línea de comando anulan
los locales y originales y los locales prevalecen sobre los originales.

caja
Consulte las reglas actuales utilizadas para el escáner de compilación no independiente en un
directorio donde el siguiente compilar run los usará en lugar de las reglas enviadas.

Actualmente, esto comprueba partes del repositorio svn de QA. Esta URL podría obtener
desactualizado en el futuro. Si utiliza la versión independiente de bls y la versión no
la versión standlone bls se desincroniza, esas reglas pueden contener cosas que su
bls-stanalone no puede manejar.

ESCRITURA REGLAS

Una guía demasiado corta para escribir nuevos archivos de descripción:

El escáner de registro de compilación no independiente solo se ejecuta para compilaciones que se consideren correctas. Entonces cheques
para las cosas que normalmente deberían hacer que una compilación falle, a menudo no tiene mucho sentido (un conjunto de pruebas
generar falsos positivos es a menudo más probable que detectar un error ignorado
inadecuadamente).

El nombre del archivo es la etiqueta producida para la prueba. Encontrar un buen nombre suele ser lo más difícil
parte sobre la emisión de cheques nuevos.

La mayor parte del archivo de descripción es en realidad el código html que describe lo que suele ocurrir con el hallazgo.
significa que se mostrará en ⟨http://qa.debian.org/bls/⟩ Con la excepción de las líneas
comenzando con ## en la parte superior del archivo.

La descripción debe contener la siguiente información:

Qué did el check ¿encontró?
Facilite que las personas encuentren lo que coincide. Hace que sea más fácil encontrar el problema, menos
probable que lo descarte como falso positivo si no lo es, y menos tiempo perdiendo si
en realidad es un falso positivo.

Por qué is Lo que is determinaron  a ¿problema?
Incluso los defectos más graves pueden fácilmente descartarse como problemas menores debido a la ignorancia.
Y algunas cosas solo son peligrosas en algunas situaciones y no requieren el más alto
prioridad en otras situaciones. Distinguir ambos casos es difícil y algunas palabras más en el
La descripción al respecto puede ayudar mucho.

Qué can be done en contra que?
Algunos consejos sobre cómo evitar el problema ayudan al que debe solucionarlo en algún momento buscando
una solución. Esto es especialmente útil para ayudar a las personas a solucionarlo correctamente en lugar de solo
ocultando el problema más a fondo.

Las directivas ## reales al comienzo del archivo son:

Unir:
Esta línea indica que esta verificación se activa si aparecen otras verificaciones en la misma línea.

Actualmente solo se admiten dos formularios:

##Unir: mismo etiqueta1 etiqueta2

y

##Unir: mismo etiqueta1 etiquetanombre2a or etiquetanombre2b

Presentar los resultados con:
Esta es una expresión regular que describe con qué hacer coincidir cada línea del registro de compilación
para encontrar el problema, con el prefijo expresión regular:. Como una extensión de la sintaxis regular hay
un átomo \ / que especifica que una vez que una línea coincide con esta parte, no se comprueba que no
tener un \ / en este lugar se supone que coincide con esta línea. (Esta es una optimización para
recortar en gran medida la máquina de estado de compilación, pero también se puede utilizar para evitar falsas
positivos).

Como todas las expresiones regulares de todas las comprobaciones se compilan en una sola máquina de estados finitos,
Los cheques que son muy específicos al comienzo de la línea son bastante baratos, mientras que los cheques no
específicos al principio suelen ser bastante caros. El tamaño de la salida de la máquina de estado por
el compilar El comando es una buena medida de lo caro que es el cheque específico.

Ya que:
Si hay nuevas reglas, la información en ⟨http://qa.debian.org/bls/⟩ puede ser
desactualizado hasta que todos los registros se vuelvan a escanear con la nueva versión. Para cada registro escaneado por el
analizador de registro de compilación no independiente, se recuerda el número de versión de las reglas utilizadas. los
número especificado con el Since El campo indica al informe web generado dónde colocarlo.
advierte que la información sobre esta comprobación puede estar desactualizada.

Extracto:
Esto indica cómo extraer información del archivo coincidente para que se muestre junto con el
línea coincidente (como un nombre de archivo en el que se encontró algo).

Actualmente, aquí se admiten los siguientes formularios:

##Extraer: simples 0 recuento final 'finalizar'
##Extraer: simples 0 'reajustar' recuento final 'finalizar'
##Extraer: simples cuenta de inicio 'iniciarchar' recuento final 'finalizar'
##Extraer: simples cuenta de inicio 'iniciarchar' 'reajustar' recuento final 'finalizar'

¿Dónde? iniciarchar es un carácter a buscar para el inicio del área extraída (después de la
cuenta de iniciola ocurrencia). reiniciar es un personaje para abortar la extracción. finalizar es un
carácter para buscar el final del área extraída (después de la recuento finalth
ocurrencia).

Por ejemplo:
##Extraer: simples 2 '|' "/" 1 '|' significa extraer el contenido entre el 2 y el 3
símbolo de tubería, a menos que haya una barra en el medio.

Acción:
describe qué hacer si un interruptor coincide. Esto se puede utilizar para establecer variables referenciadas
en otras reglas para generar reglas sensibles al contexto.

Estado:
agregar condiciones (en variables establecidas por ##Acción). Si no se cumple la condición, la
se suprime la generación de un hallazgo.

CEVEATS

Si bien la compilación de todas las coincidencias en una sola máquina de estados finitos produce resultados muy rápidos,
solo es factible mientras la máquina de estados no crezca demasiado. Así que el cuidado tiene que ser
tomado para no utilizar búsquedas demasiado caras.

Algunas comprobaciones (especialmente las específicas del contexto) son bastante poco fiables. El no autónomo
Las comprobaciones del registro de compilación no incluyen algunos hallazgos para el resumen a menos que aparezcan en
múltiples arquitecturas, lo que obviamente bls-standalone no puede hacer.

bls está optimizado para ser rápido. No lo ejecute con archivos de reglas en los que no confíe. (Solo el
el contenido de los archivos de registro analizados se supone que son datos que no son de confianza).

blhc es bastante lento, lo que afortunadamente no es tan notable si no se escanean los archivos de registro de
todo el archivo. Si prueba nuevas reglas en un conjunto mayor de archivos de registro, utilice --blhc = NO can
acelerar las cosas bastante.

blhc no informa los números de línea, por lo que bls-standalone no puede informarlos para esos hallazgos.

Tenga en cuenta que comprobar los registros de una ejecución de dpkg-buildpackage -b y una ejecución de dpkg-buildpackage -B
puede marcar la diferencia (por lo que si no puede reproducir un E-binary-arch-produce-all, asegúrese de
comprueba el tipo correcto de registro).

PRESENTACIÓN DE INFORMES LOCO

Informar errores o solicitudes de lista de deseos a Debian BTS
(por ejemplo, usando Reportar un error bls-independiente bajo Debian)
o directamente a [email protected]

DERECHOS DE AUTOR

Copyright © 2013,2014,2015 Bernhard R. Enlace ⟨http://www.brlink.eu⟩
Este es un software gratuito; consulte la fuente para conocer las condiciones de copia. NO hay garantía; no
incluso para COMERCIABILIDAD o APTITUD PARA UN PROPÓSITO PARTICULAR.

Use bls-standalone en línea usando los servicios de onworks.net