Cómo informar de un fallo en Debian usando reportbug

Rogamos que informe del fallo en Debian usando el programa reportbug.

reportbug se instala por omisión en la mayoría de los sistemas. Si no está disponible, puede instalarse utilizando la herramienta de gestión de paquetes disponible en el sistema.

Se puede iniciar reportbug desde la sección «Sistema» del menú o ejecutando reportbug desde la línea de órdenes.

Le guiará en cada paso del proceso de creación de un informe de fallo.

Si tiene dudas que las ventanas de diálogo de reportbug no resuelven, puede dirigirse a la documentación que se describe a continuación o preguntar en la lista de usuarios de Debian (en inglés) o en la lista de usuarios de Debian (en castellano).

Cómo informar de un fallo en Debian usando el correo (y uso avanzado de reportbug)

Cosas importantes a tener en cuenta antes de enviar un informe de fallo

¿A qué paquete pertenece el informe de fallo?

Necesita saber a qué paquete hay que asignar el informe de fallo. Consulte este ejemplo si desea información sobre cómo encontrar esta información. (Usará esta información para ver si ya se ha informado del fallo.)

Si no es capaz de determinar a qué paquete se debería asignar el fallo, envíe un mensaje a la lista de correo de usuarios de Debian pidiendo ayuda.

Si el problema no se refiere a un paquete, sino a algún servicio general de Debian, existen varios pseudopaquetes o incluso listas de correo que puede usar para indicarnos el fallo.

¿Se ha informado ya del fallo que ha encontrado?

Debería comprobar si ya se ha informado del fallo que le ha ocurrido antes de remitir el informe. Puede ver qué informes se han remitido a un paquete concreto usando la opción de paquete del formulario de búsqueda de fallos. Si hay un informe de fallo designado #<número>, debería remitir sus comentarios enviando un correo electrónico a <número>@bugs.debian.org en lugar de enviar un informe nuevo.

Envíe varios informes para varios fallos

Por favor, no informe de varios fallos no relacionados — especialmente de diferentes paquetes — en un solo informe de fallo.

No envíe los informes a los desarrolladores

Si rellena un informe de fallo en Debian, no envíe una copia al desarrollador del programa, ya que es posible que el fallo sólo exista en Debian. Si fuera necesario, el responsable del paquete lo reenviará al desarrollador.

Envío del informe mediante correo electrónico

Puede informar de fallos en Debian enviando un correo electrónico a [email protected] con un formato especial que se describe a continuación. reportbug (ver más adelante) formatea adecuadamente los correos electrónicos; ¡úselo, por favor!

Cabeceras

Como en cualquier correo electrónico, debería incluir un Asunto (<<subject>>) descriptivo y claro en la cabecera de su mensaje. El asunto que introduzca se usará como título del informe inicial de fallo en la página de seguimiento de fallos, de manera que, ¡intente que sea informativo!

Si quiere enviar una copia de su informe de fallo a más destinatarios (como listas de correo), no debería usar las cabeceras de correo normales, sino un método diferente, descrito más adelante.

Pseudocabeceras

La primera parte del informe de fallo son las pseudocabeceras que contienen información sobre el paquete y la versión relacionados con su informe de fallo. La primera línea del cuerpo del mensaje tiene que incluir una pseudocabecera. Debería poner:

Package: <nombredelpaquete>

Cambie <nombredelpaquete> por el nombre del paquete que contenga el fallo.

En la segunda línea del mensaje debería poner:

Version: <versióndelpaquete>

Cambie <versióndelpaquete> por la versión del paquete. Por favor, no incluya otro texto aquí, tan solo la versión, ya que el sistema de seguimiento de fallos usa este campo para averiguar qué distribuciones están afectadas por el fallo.

Debe proporcionar una línea Package correcta en la pseudocabecera para que el sistema de seguimiento de fallos envíe un mensaje al responsable del paquete. Consulte este ejemplo si desea averiguar la forma de conseguir esta información.

Si desea conocer otras pseudocabeceras válidas, consulte pseudocabeceras adicionales

El cuerpo del informe

Por favor, incluya en su informe:

El texto exacto y completo de cualquier mensaje de fallo mostrado o registrado. ¡Es muy importante!
Qué escribió o hizo exactamente para mostrar el problema.
Una descripción del comportamiento incorrecto: qué era exactamente lo que esperaba, y qué fue lo que observó. Una transcripción de una sesión de ejemplo es una buena manera de mostrarlo.
Una sugerencia de corrección, si es que la tiene.
Detalles de la configuración del programa con el problema. Incluya el texto completo de sus ficheros de configuración.
La versión de cualquier paquete del que dependa el que tiene fallos.
Qué versión del núcleo está usando (escriba uname -a), su versión de la biblioteca compartida de C (escriba ls -l /lib/*/libc.so.6 o apt show libc6 | grep ^Version), y cualquier otro detalle sobre su sistema Debian, si parece apropiado. Por ejemplo, si tiene un problema con un script en Perl, puede que quiera incluir la versión del ejecutable `perl' (escriba perl -v o dpkg -s perl | grep ^Version:).
Detalles apropiados sobre el hardware de su sistema. Si está informando sobre un problema con un controlador de dispositivo, incluya una lista de todo el hardware de su sistema, ya que los problemas pueden venir a causa de conflictos de dirección E/S o de IRQ.
Si tiene instalado reportbug, lo que muestre el ejecutar reportbug --template -T none -s none -S normal -b --list-cc none -q <paquete> también será muy útil, ya que contiene lo que muestran los scripts específicos del mantenedor e información sobre la versión.

Incluya cualquier detalle que crea relevante — no crea que su informe será demasiado largo por incluir demasiada información. Si son pequeños, incluya en su informe cualquier fichero que esté usando para reproducir el problema. (Si son grandes, considere publicarlos en un sitio web disponible públicamente, si es posible.)

Si desea más indicaciones sobre cómo ayudar a los desarrolladores a resolver su problema, consulte Cómo informar de fallos de forma efectiva (en inglés).

Ejemplo de informe de fallo

Un informe de fallo, con la cabecera y pseudocabecera, tiene este aspecto:

  To: [email protected]
  From: [email protected]
  Subject: Hello tells `goodbye'

  Package: hello
  Version: 1.3-16

  When I invoke `hello' without arguments from an ordinary shell
  prompt it prints `goodbye', rather than the expected `hello, world'.
  Here is a transcript:

  $ hello
  goodbye
  $ /usr/bin/hello
  goodbye
  $

  I suggest that the output string, in hello.c, be corrected.

  I am using Debian GNU/Linux 2.2, kernel 2.2.17-pre-patch-13
  and libc6 2.1.3-10.

Nota: Se ha dejado en el inglés original, puesto que éste será el idioma en el que se envíen los informes de fallos.

Enviar copias de un informe de fallos a otra dirección

Algunas veces es necesario enviar una copia de un informe de fallo a algún otro sitio aparte de debian-bugs-dist y al responsable del paquete, donde es enviado normalmente.

Podría hacerlo indicando otras direcciones en el CC de su informe de fallo, pero entonces las copias no tendrán indicado el número del fallo en el campo Reply-To ni en la línea Subject. Cuando los destinatarios contesten, posiblemente conserven la entrada [email protected] en la cabecera y su mensaje aparecerá como un nuevo informe de fallo. Esto lleva a muchos informes duplicados.

La forma correcta de hacerlo es usar la pseudocabecera X-Debbugs-CC. Añada una línea como esta a las pseudocabeceras de su mensaje:

 X-Debbugs-CC: [email protected]

Esto hará que el sistema de seguimiento de fallos envíe una copia de su informe a las direcciones que haya en la línea X-Debbugs-CC al igual que a la lista debian-bugs-dist.

Si desea enviar copias a más de una dirección, añada las direcciones separadas por comas en una única línea X-Debbugs-CC.

Evite enviar tales copias a las direcciones de otros informes de fallo, ya que podrían ser capturadas por las comprobaciones que impiden los bucles de correo. De todas maneras, tiene bastante poco sentido usar X-Debbugs-CC para hacer esto, ya que el número de fallo añadido por el mecanismo será sustituido por otro; use una cabecera CC corriente en su lugar.

Esta característica a menudo puede ser combinada enviando un mensaje quiet — vea más adelante.

Pseudocabeceras adicionales

Niveles de importancia

Si un informe se refiere a un fallo particularmente serio, o es meramente una petición de características, puede indicar la importancia del fallo al informarlo. No es algo obligatorio, y los desarrolladores asignarán el nivel de importancia adecuado a su informe si usted no lo hace (o indica uno incorrecto).

Para asignar un nivel de importancia ponga una línea como ésta en la pseudocabecera:

Severity: <importancia>

Sustituya <importancia> por uno de los niveles disponibles, que están descritos en la documentación avanzada.

Asignar etiquetas

Puede asignar etiquetas a un fallo cuando informa de él. Por ejemplo, si está incluyendo un parche con el informe, quizá desee activar la etiqueta patch. No es necesario, sin embargo, y los desarrolladores etiquetarán el informe cómo y cuándo sea apropiado.

Para poner etiquetas, ponga una línea como ésta en una de las pseudocabeceras:

Tags: <etiquetas>

Sustituya <etiquetas> por una o más de las etiquetas de que dispone, tal como se describe en la documentación avanzada. Separe las etiquetas con comas, espacios o ambos.

User: <nombredeusuario>
Usertags: <etiquetasdeusuario>

Reemplace <etiquetasdeusuario> con una o más etiquetas de usuario. Separe varias etiquetas con comas, espacios o ambos. Si especifica un <nombredeusuario>, se establecerán las etiquetas de ese usuario. De lo contrario, se utilizará la dirección de correo electrónico del remitente como nombre de usuario.

Puede establecer etiquetas de usuario para varios usuarios en el momento de remitir el informe de fallo incluyendo varias pseudocabeceras User. Cada pseudocabecera Usertags establece las etiquetas de usuario para la pseudocabecera User precedente. Esto es especialmente útil para establecer etiquetas de usuario para un equipo con varios usuarios, para establecer etiquetas de usuario para varios equipos o para establecer las etiquetas de usuario de arquitectura en fallos que afectan a varias arquitecturas.

User: <primer-nombredeusuario>
Usertags: <etiquetasdeusuario para el primer-nombredeusuario>
User: <segundo-nombredeusuario>
Usertags: <etiquetasdeusuario para el segundo-nombredeusuario>

Establecer dirección de reenvío

Forwarded: [email protected]

marcará el nuevo fallo remitido como reenviado a [email protected]. Mire Registrar que ha aprobado un informe de fallo en la documentación de desarrolladores si desea detalles.

Establecer propiedad

Owner: [email protected]

indicará que [email protected] ahora es responsable de arreglar este fallo. Mire Cambiar la propiedad de un fallo en la documentación de desarrolladores si desea detalles.

Paquete fuente

Source: foopackage

El equivalente de Package: para fallos presentes en el paquete fuente de foopackage; para la mayoría de los fallos en la mayoría de los paquetes no querrá usar esta opción.

Órdenes de control

Control: control commands

Permite que cualquiera de las órdenes que deben ser enviadas a [email protected] puedan enviarse a [email protected] o a [email protected]. -1 en principio se refiere al informe de error actual (que es el informe de error creado al enviar un correo electrónico a submit@ o el informe de fallo enviado a nnn@). Consulte la documentación del servidor de control para más información de las órdenes de control válidas.

Por ejemplo, la siguiente pseudocabecera en un mensaje enviado a [email protected]:

Control: retitle -1 this is the title
Control: severity -1 normal
Control: summary -1 0
Control: forwarded -1 https://bugs.debian.org/nnn

causará que 12345 sea renombrado, su nivel de importancia sea cambiado, se indica que existe resumen y se marcará como reenviado.

Cabeceras de X-Debbugs-

Finalmente, si su MUA no le permite editar las cabeceras, puede establecer las distintas cabeceras X-Debbugs- en las pseudocabeceras.

Información adicional

Diferentes direcciones de envío (informes menores o en masa)

Si un informe trata de un fallo menor (por ejemplo, una errata en la documentación o cualquier otro problema trivial), ajuste por favor el nivel de gravedad de forma apropiada y envíelo a [email protected] en lugar de a [email protected]. maintonly sólo enviará el informe al responsable del paquete, sin mandar copia a las listas de correo del BTS.

Si está enviando varios fallos a la vez, definitivamente debería usar [email protected], de manera que no cause mucho tráfico redundante en las listas de correo del BTS. Quizá desee enviar también un mensaje a debian-bugs-dist con un resumen si va a enviar varios fallos asociados entre sí.

Si desea informar en el sistema de seguimiento sobre un fallo que ya ha sido enviado al responsable, puede usar [email protected]. Los mensajes enviados a través de [email protected] no se redirigen a ninguna parte, sólo quedan archivados.

Cuando use diferentes direcciones de envío, el sistema de seguimiento establecerá el Reply-To de cualquier mensaje reenviado de manera que las repuestas serán procesadas por omisión de la misma manera que el mensaje original. Esto significa que, por ejemplo, las respuestas a maintonly irán a nnn[email protected] en lugar de a nnn@bugs.debian.org, a menos que, por supuesto, se cambie esto de forma manual.

Confirmación

Normalmente, el sistema de seguimiento de fallos le enviará una confirmación por correo electrónico cuando informe de un nuevo fallo o envíe información adicional a uno ya existente. Si desea suprimir esta confirmación, incluya una cabecera o pseudocabecera X-Debbugs-No-Ack en el mensaje (el contenido de la cabecera no importa). Si informa de un nuevo fallo con esta cabecera, necesitará mirar en la interfaz web usted mismo para averiguar su número.

Tenga en cuenta que esta cabecera no suprime confirmaciones del servidor [email protected], ya que éstas pueden contener mensajes de fallo que deberían leerse para poder actuar en consecuencia.

Lucha contra el correo basura y correos perdidos

EL sistema de fallos implementa una extensa colleción de reglas para evitar que el correo basura llegue al BTS. Aunque intentamos minimizar el número de falsos positivos, ocurren. Si sospecha que su correo ha sido reconocido como un falso positivo, siéntase libre de contactar en [email protected] para más asistencia. Otra causa común para que un correo no entre en el BTS es utilizar direcciones que coinciden con el valor FROM_DAEMON de procmail, que incluye correos con direcciones como [email protected]. Si sospecha que su correo coincide con FROM_DAEMON, consulte procmailrc(5) para verificarlo y vuelva a enviar el correo usando una dirección que no concuerde con FROM_DAEMON.

Informe de fallos sobre paquetes desconocidos

Si el sistema de seguimiento de fallos no conoce al responsable del paquete, reenviará el informe a debian-bugs-dist incluso si se usó maintonly.

Cuando envíe a [email protected] o nnn[email protected] debería asegurarse de que el informe de fallo queda asignado al paquete correcto, poniendo un renglón Package adecuado al principio del envío original de un informe, o usando el servicio [email protected] para (re)asignar el informe apropiadamente.

Uso de `dpkg` para averiguar el paquete y la versión a usar en el informe

Cuando use reportbug para informar de un fallo en una orden, digamos grep, lo siguiente selecciona automáticamente el paquete adecuado y le permite escribir el informe correctamente reportbug --file $(which grep)

También puede encontrar qué paquete lo instaló usando dpkg --search. Puede encontrar que versión de un paquete tiene instalada usando dpkg --list o dpkg --status.

Por ejemplo:

$ which apt-get
/usr/bin/apt-get
$ type apt-get
apt-get is /usr/bin/apt-get
$ dpkg --search /usr/bin/apt-get
apt: /usr/bin/apt-get
$ dpkg --list apt
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed
|/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad)
||/ Name           Version        Description
+++-==============-==============-============================================
ii  apt            0.3.19         Advanced front-end for dpkg
$ dpkg --status apt
Package: apt
Status: install ok installed
Priority: standard
Section: base
Installed-Size: 1391
Maintainer: APT Development Team <[email protected]>
Version: 0.3.19
Replaces: deity, libapt-pkg-doc (<< 0.3.7), libapt-pkg-dev (<< 0.3.7)
Provides: libapt-pkg2.7
Depends: libapt-pkg2.7, libc6 (>= 2.1.2), libstdc++2.10
Suggests: dpkg-dev
Conflicts: deity
Description: Advanced front-end for dpkg
 This is Debian's next generation front-end for the dpkg package manager.
 It provides the apt-get utility and APT dselect method that provides a
 simpler, safer way to install and upgrade packages.
 .
 APT features complete installation ordering, multiple source capability
 and several other unique features, see the Users Guide in
 /usr/doc/apt/guide.text.gz

Otras órdenes y paquetes útiles

La herramienta querybts, disponible en el mismo paquete que reportbug, proporciona una interfaz basada en texto conveniente para usar el sistema de seguimiento de fallos.

Los usuarios de Emacs también pueden usar la orden debian-bug que proporciona el paquete debian-el. Cuando lo invoque con M-x debian-bug, le preguntará toda la información necesaria de forma similar a reportbug.

Otras páginas del sistema de seguimiento de fallos (BTS en inglés):

Debian BTS administrators <[email protected]>