Reportar fallos

Ya que nuestros desarrolladores no pueden verificar todas las combinaciones de hardware, ni todas las posibles maneras de interactuar con el sistema operativo, confiamos que los usuarios nos den retroalimentación sobre cómo funcionan las cosas de su lado. Dado que Haiku todavía es muy joven, muy probablemente encontrará fallos. Le agradecemos por tomarse el tiempo para reportarlos. Juntos podemos mejorar a Haiku, bit a bit.

Para mantener nuestro rastreador de fallos efectivo, es esencial supeditarse a la Etiqueta del rastreador de fallos.

Obtener una cuenta de Trac

Para llenar un reporte, necesita tener una cuenta en el Rastreador de fallos de Haiku.
Cuando se cree una cuenta nueva, asegurese de proporcionar su correo electrónico pues es necesario obtener privilegios de modificación básica del reporte. Asegúrese de comprobar su carpeta de correo no deseado (spam) brevemente después, ya que a menudo toda verificación de correo importante termina allí.

Crear un reporte de fallo

Antes de reportar un fallo, por favor asegúrese que aún no exista. Puede también usar la función de búsqueda para esto.
Tras haber establecido que es un fallo nuevo, haga su información tan puntual como sea posible:

• Incluya información básica tal como dónde está probando a Haiku (sobre hardware real, en VMWare, en QEMU, etc.).

• Mencione cuál revisión de SVN esté corriendo. Puede encontrar esta información en 'About This System...' (Acerca de este sistema) desde el menú Deskbar.

• Describa el problema que esté experimentando. Intente ser tan preciso como pueda: describa el comportamiento actual, y el comportamiento esperado.

• Describa qué pasos necesita realizar para exponer el fallo. Esto ayudará a los desarrolladores a reproducir el fallo.

• Adjunte tanta información como tenga. Si es un fallo de interfaz de usuario, o un fallo en una de las aplicaciones, intente hacer una captura de pantalla (la tecla Impr pant guarda un PNG en /boot/home/).

Fallos de software

Cuando falla una aplicación, debería invocar el depurador desde la alerta que aparece. Al ingresar bt dentro de la terminal de depuración ejecutada, se crea un "backtrace" que debiera copiarse dentro del reporte de fallo.

Fallos de hardware

Cuando se enfrente a fallos relacionados con hardware/controladores, debería adjuntarse la siguiente información:

• listdev - un listado detallado de su hardware, incluyendo las IDs de fabricante y dispositivo PCI, similar a los comandos lshw y lspci de Linux.
• listusb -v - asumiendo que el conflicto se relacione con USB, de manera similar a lsusb.
• open /var/log/syslog - el historial de sucesos de sitema primario utilizado por Haiku, análogamente a la pantalla de depuración durante el arranque. Con el comando open se puede acortar la parte relevante de los sucesos de sistema en un editor de textos.
• listimage | grep drivers/ - lista todos los controladores utilizados.
• ints - sólo disponible en la Tierra de depuración del núcleo (ve debajo). Muestra el uso de interrupciones. No debería haber demasiados que se compartan por dispositivos diferentes.

Se pueden ingresar estos comandos en la Terminal. Agregue un > output.txt tras un comando, y se hará una operación de tubería dentro de un texto llamado "output.txt" que se puede adjuntar al reporte de fallos o correo electrónico.

Tierra de depuración del núcleo - KDL

Cuando algún componente de sistema de muy bajo nivel deja de funcionar, se puede terminar en el depurador de núcleo (KDL por sus siglas en inglés, Kernel Debugging Land). También puede ingresarse deliberadamente con ALT PetSis D (siendo PetSis el mismo botón que Impr pant en la mayoría de los teclados).

• co - saldrá de KDL y continuará la operación del sistema, si es posible.
• int - mostrará el uso de interrupciones (como se describió arriba).
• bt - muestra el "backtrace", detallando dónde exactamente sucedió el fallo.

¿Qué sigue?

Después que un fallo se ha reportado, un desarrollador verá el reporte e intentará clasificarlo. Recuerde, todos somos voluntarios, y por ello, algunas veces un fallo pudiera estar sin responderse por un tiempo. Agregar nueva información cuando esté disponible usualmente ayuda a que se escoja un fallo más rápidamente, pero no intente 'levantar' el fallo agregando comentarios no descriptivos.

Recuerde, reportar un fallo no es algo en lo que tome un poquito de tiempo y sea todo. Si se reporta un fallo, se vuelve parte del proceso de desarrollo de Haiku. Los desarrolladores podrían llegar con preguntas mientras intentan arreglar el fallo reportado. Por favor, permanezca atento para responderlas. Considere su participación 'terminada' cuando el fallo se marque como 'arreglado'.