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
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; ¡ú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 (escribals -l /lib/*/libc.so.6
oapt 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' (escribaperl -v
odpkg -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: 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 pseudocabecera
X-Debbugs-CC
. Añada una línea como esta a las pseudocabeceras 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
.
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: 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.
Establecer propiedad
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.
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
control@bugs.debian.org
puedan enviarse a submit@bugs.debian.org
o a
nnn@bugs.debian.org
. -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 12345@bugs.debian.org
:
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
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 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 control@bugs.debian.org
, 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 owner@bugs.debian.org
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 mail@foobar.com
. 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 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.
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):
- Página principal del sistema de seguimiento de fallos de Debian.
- Instrucciones sobre cómo informar de un fallo.
- Acceso a los registros del sistema de seguimiento de fallos.
- Información para desarrolladores sobre el sistema de seguimiento de fallos.
- Información para desarrolladores sobre cómo manipular fallos utilizando la interfaz de correo electrónico.
- Tarjeta de referencia de los servidores de correo.
- Cómo pedir informes de fallos por correo electrónico.
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.