Cómo informar de un fallo en Debian usando reportbug

+ +

Rogamos encarecidamente que informe de fallo en Debian usando el programa reportbug. Para instalar e iniciar reportbug sencillamente ejecute aptitude install reportbug; reportbug. Le guiará por el proceso de informar de un fallo paso a paso.

si tiene dudas que peticiones interactivas 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

¿En qué paquete está fallo del que está informando?

Necesita saber a que paquete hay que asignar el informe de fallo. Vea este ejemplo si desea información sobre como enconrar 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, haga el favor de enviar 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 le ha ocurrido?

Debería comrobar si si ya se ha informado del fallo que le ha ocurrido antes de remitir el informe. Puede ver que 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 #<numero>, debería remitir sus comentarios enviando un correo electrónico a <número>@bugs.debian.org en lugar de enviar un informe nuevo.

Envie 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 usted mismo copia al desarrollador del programa, ya que es posible que el fallo sólo exista en Debian. Si fuera necesario, el mantenedor 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 submit@bugs.debian.org con un formato especial que se describe a continuación. reportbug (ver más adelante) formatea adecuadamente los correos electrónicos por usted. ¡ú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. Este asunto que proporciona 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 le gustaría 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 a qué paquete y versión se aplica 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. Por favor no incluya ningún otro texto aquí, mas que únicamente la versión, debido a que el sistema de rastreo de fallos necesita este campo para ubicar las liberaciones afectadas por el bug.

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

Version: <versióndelpaquete>

Cambie <versióndelpaquete> por la versión del paquete.

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. Vea este ejemplo si desea averiguar la forma de conseguir esta información.

Si desea conocer otras pseudocabeceras válidas, véase pseudocabeceras adicionales

El cuerpo del informe

Por favor, incluya en su informe:

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 cualesquiera ficheros que esté usando para reproducir el problema. (Si son grandes, considere publicarlos en sitio web disponible públicamente, si es posible.)

Si desea más indicaciones sobre cómo ayudar a los desarrolladores a resolver su problema, lea por favor 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: submit@bugs.debian.org
  From: diligente@prueba.linux.org
  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 submit@bugs.debian.org 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 cabecera X-Debbugs-CC. Añada una línea como esta a la cabecera de su mensaje:

 X-Debbugs-CC: other-list@cosmic.edu

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.

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 (lea más adelante).

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.

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 cuando 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.

Forwarded: foo@example.com

marcará el nuevo fallo remitido como reenviado a foo@example.com. Mire Registrar que ha aprobado un informe de fallo en la documentación de desarrolladores si desea detalles.

Owner: foo@example.com

indicará que foo@example.com ahora es responsable de arreglar este fallo. Mire Cambiar la propiedad de un fallo en la documentación de desarrolladores si desea detalles.

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 quiere usar esta opción.

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 maintonly@bugs.debian.org en lugar de a submit@bugs.debian.org. 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 maintonly@bugs.debian.org, 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 quiet@bugs.debian.org. Los mensajes enviados a través de quiet@bugs.debian.org 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-maintonly@bugs.debian.org en lugar de a nnn@bugs.debian.org, a menos por supuesto que 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 X-Debbugs-No-Ack en el mensaje (el contenido de la cabecera no importa; sin embargo, debe estar en la cabecera del mensaje, y no en la pseudocabecera con el campo Package field). 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 control@bugs.debian.org, ya que éstas pueden contener mensajes de fallo que deberían leerse para poder actuar en consecuencia.

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 maintonly@bugs.debian.org o nnn-maintonly@bugs.debian.org 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 control@bugs.debian.org para (re)asignar el informe apropiadamente si no lo estaba ya.

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 <deity@lists.debian.org>
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 <owner@bugs.debian.org>

Debian bug tracking system
Copyright © 1999 Darren O. Benham, 1997, 2003 nCipher Corporation Ltd, 1994-1997 Ian Jackson.