[Índice de documentos] [Sección 1 - Introduccón a OpenBSD] [Sección 3 - Cómo obtener OpenBSD]

2 - Otros recursos de información sobre OpenBSD

Índice de contenidos

• 2.1 - Páginas en Internet
• 2.2 - Listas de correo
• 2.3 - Páginas del manual
• 2.4 - Sistema de informes de errores

2.1 - Páginas de interés en Internet

El sitio oficial del Proyecto OpenBSD en Internet está ubicado en:
http://www.OpenBSD.org/es/.

Aquí se puede encontrar mucha información útil relacionada con todos los aspectos del Proyecto OpenBSD.

OpenBSD Journal es un sitio de noticias y opinión enfocado en OpenBSD.

Muchos usuarios han puesto sitios y páginas con información específica sobre OpenBSD. Como todo en Internet, un buen motor de búsqueda hará su vida más fácil, así como una saludable dosis de escepticismo. Como siempre, no introduzca a ciegas órdenes en su computadora que no entiende.

2.2 - Listas de correo

El Proyecto OpenBSD mantiene varias listas de correo a las que los usuarios deberían suscribirse. Para darse de alta en una lista de correo, hay que enviar un mensaje a majordomo@openbsd.org. Esta dirección es un servicio de suscripción automática. En el contenido del mensaje, en una sola línea, debe incluirse la orden subscribe seguida del nombre de la lista a la que se desee realizar la suscripción. Por ejemplo:

subscribe announce

El procesador de listas enviará una contestación de vuelta requiriendo que se confirme la petición de suscripción a la lista, para que nadie pueda suscribirnos a una lista sin nuestra aprobación. El mensaje incluye instrucciones sobre varios modos diferentes de suscripción, incluido un en enlace a la página del servidor de listas como respuesta de confirmación, o para una respuesta a majordomo@openbsd.org. Se puede usar cualquiera de los métodos. Los tres métodos incluyen un número de identificación único y limitado, como A56D-70D4-52C3, para asegurarse de que la persona que requiere la suscripción es el dueño de la dirección.

Una vez que se haya enviado la confirmación de esta autorización de vuelta al procesador y que éste haya confirmado el alta, la dirección será añadida a la lista de inmediato, y el procesador enviará una notificación confirmando el alta en la lista.

Para darse de baja de una lista hay que enviar un mensaje a majordomo@openbsd.org con la orden unsubscribe seguida del nombre de la lista. Por ejemplo:

unsubscribe announce

Si se encuentran dificultades con el sistema de suscripción a las listas de correo, pueden verse las instrucciones de ayuda del gestor de listas, majordomo, que se pueden obtener enviando un mensaje a majordomo@openbsd.org con la orden help en el contexto del mensaje.

La suscripción a las listas de correo de OpenBSD también se puede gestionar a través de la interfaz de web en http://lists.openbsd.org.

Algunas de las listas de OpenBSD más frecuentadas son:

• announce - Anuncios importantes. Lista con poco tráfico.
• security-announce - Anuncios sobre temas de seguridad. Ésta es una lista con poco tráfico.
• misc - Preguntas y respuestas generales. Ésta es la lista más activa, y la mayoría de preguntas deberían ser enviadas a esta lista.
• bugs - Informes sobre errores recibidos a través de sendbug(1) y discusiones sobre estos errores.
• source-changes - Lista de distribución de correo automatizada de los cambios en el árbol de fuentes del CVS. Cada vez que un desarrollador efectúa un cambio en el árbol de fuentes de OpenBSD, CVS envía una copia del mensaje de entrega (generalmente breve) a través de esta lista.
• ports - Discusión sobre el árbol de portes de OpenBSD.
• ports-changes - Lista de distribución de correo automatizada de los cambios específicos en los portes, en el árbol de fuentes del CVS.
• advocacy - Difusión de OpenBSD y otros temas que no corresponden a misc.

Antes de enviar una pregunta a misc o a cualquier otra lista es conveniente buscar entre los archivos, ya que la mayoría de preguntas comunes pueden haber sido formuladas anteriormente y en repetidas ocasiones. Aunque para un usuario puede ser la primera vez que se encuentre con un cierto problema o duda, es muy probable que otros suscriptores de las listas de correo lo hayan tratado ya varias veces en semanas anteriores, y pueden encontrar molesto volverlo a ver repetido. Si la pregunta tiene qué ver con hardware, ¡siempre incluya un dmesg(8)!

Se puede ver una lista con los archivos de los mensajes de correo de las listas de OpenBSD y otra información en la página de las listas de correo. Una lista de correo no oficial que puede ser del interés de los usuarios nuevos de OpenBSD y UNIX es la lista OpenBSD Newbies.

2.3 - Páginas del manual

OpenBSD viene con una extensa documentación en forma de páginas del manual (man pages), así como de documentos más extensos sobre aplicaciones específicas. Se hace un esfuerzo considerable para asegurarse de que las páginas del manual estén actualizadas y precisas.

Para acceder a las páginas del manual y demás documentación, es necesario tener instalados los paquetes man35.tgz y misc35.tgz.

He aquí una lista de las páginas del manual más útiles para los usuarios noveles:

Comenzando

• afterboot(8) - primeras comprobaciones después de iniciar el sistema por primera vez.
• help(1) - ayuda para usuarios y administradores nuevos.
• hier(7) - estructura del los sistemas de archivo.
• man(1) - uso de las páginas del manual.
• intro(1) - introducción a instrucciones generales, vea también los intros de las otras secciones del manual: intro(2), intro(3), intro(4) (nota: intro(4) es dependiente de la plataforma), intro(5), intro(6), intro(7), intro(8) e intro(9).
• adduser(8) - orden para añadir nuevos usuarios.
• vipw(8) - edición del fichero maestro de contraseñas.
• disklabel(8) - leer y escribir las clasificaciones del disco.
• reboot, halt(8) - parar y reiniciar el sistema.
• shutdown(8) - cerrar el sistema en un tiempo especificado.
• dmesg(8) - despliega de nuevo los mensajes de inicio del núcleo.
• sudo(8) - no se registre como root, pero ejecute instrucciones como root.
• mg(1) - editor de texto semejante a emacs.

• boot(8) - procedimientos de arranque del sistema.
• login.conf(5) - formato del fichero de configuración de la clase de ingreso.
• ifconfig(8) - configurar los parámetros de la interfaz de red.
• netstat(1) - estado de la red.
• boot_config(8) - cambiar la configuración del núcleo del sistema durante el arranque.
• release(8) - construye una distribución de OpenBSD.
• sendbug(1) - enviar un informe sobre un problema (PR) en OpenBSD al sitio central de asistencia.
• sysctl(8) - consulta o establece el estado del núcleo.
• style(9) - guía de estilo para el código fuente del núcleo de OpenBSD.

Se pueden ver todas las páginas del manual de OpenBSD en Internet desde http://www.openbsd.org/cgi-bin/man.cgi, y también en la pantalla si se ha instalado el archivo man35.tgz.

Por regla general, si se conoce el nombre de una orden o de una página del manual, se puede leer ejecutando man <orden> (en donde <orden> es el nombre de la orden o función sobre la que se desea obtener información). Por ejemplo, man vi mostraría la página del manual del editor vi. Si no se sabe el nombre de la orden o función, o si man <orden> no encuentra la página del manual que se esté buscando, se puede realizar una búsqueda en la base de datos de las páginas del manual mediante la orden "apropos <clave>" o "man -k <clave>" (en donde <clave> es una palabra que puede aparecer en el título de la página del manual que se desee consultar). Por ejemplo:

# apropos "time zone" tzfile (5) - time zone information zdump (8) - time zone dumper zic (8) - time zone compiler

Los números entre paréntesis indican la sección del manual en la que se encuentra esa página. En algunos casos puede ocurrir que para una misma orden o función exista más de una página del manual con el mismo nombre y en secciones separadas del manual. Pongamos como ejemplo que necesitáramos conocer el formato de los ficheros de configuración para el dæmon cron. Una vez que supiéramos la sección del manual para la página que deseamos consultar, ejecutaríamos man <n> <orden> (en donde <n> sería el número de la sección del manual).

# man -k cron cron (8) - clock daemon crontab (1) - maintain crontab files for individual users crontab (5) - tables for driving cron # man 5 crontab

Además de las páginas del manual de UNIX, existe una documentación a la que se puede dar formato para la impresión y que está incluida en la distribución misc35.tgz. Esta documentación se encuentra en el directorio /usr/share/doc. Se puede dar formato a cada grupo de documentos con la orden make desde dentro del subdirectorio apropiado. El subdirectorio psd es el de la distribución Programmer's Supplementary Documents (Documentos Suplementarios para el Programador); el subdirectorio smm es el del System Manager's Manual (Manual de Gestión del Sistema); y el subdirectorio usd es el del UNIX User's Supplementary Documents (Documentos Suplementarios del Usuario de UNIX). Es posible ejecutar 'make' sobre las tres distribuciones, o puede hacerse sobre cada una de ellas por separado desde el correspondiente subdirectorio.

Algunos de los subdirectorios están vacíos. El formato predeterminado del documento será Postscript, un formato ideal para la impresión de los documentos. El resultado de la salida en Postscript suele ser bastante voluminoso; el incremento en volumen será de entre 250% y 300%. Si no se dispone de acceso a una impresora con capacidad para Postscript o a un programa de visualización para este formato, también se puede dar formato a los documentos en texto simple. En el subdirectorio de cada documento existe un target para construir copias en ASCII de estos documentos (llamado "paper.txt") que puede ser generado con make(1). Por ejemplo:

# cd /usr/share/doc/usd/04.csh # make paper.txt # more paper.txt

Tome en cuenta que para construir estos documentos podrían requerirse prvilegios de superusuario en estos directorios y que la ejecución de make clean borrará cualquier documento generado por un make anterior. Para más información acerca de los documentos en /usr/share/doc/ vea /usr/share/doc/README.

Las páginas del manual de UNIX están, por lo general, más actualizadas y son por tanto más fiables que los documentos formateables. Sin embargo, los documentos formateables suelen ofrecer aclaraciones sobre las aplicaciones complicadas con más detalle que las páginas del manual.

Para muchos usuarios puede ser de gran utilidad disponer de una copia impresa de las páginas del manual. A continuación se explica cómo obtener un copia imprimible de una página del manual.

¿Cómo se puede ver el fichero fuente de una página del manual (o sea, aquél cuyo nombre acabe en número, como tcpdump.8)?

Éstos se encuentran por todo el árbol de fuentes. Las páginas del manual se encuentran dentro del árbol en formato fuente, y muchas veces se actualizan mediante el uso de CVS. Para poder ver esas páginas:

# nroff -Tascii -mandoc <fichero> | more

¿Cómo se puede obtener una página del manual sin caracteres de control o de formato?

Esto es útil para la obtención de una salida directa, sin caracteres no imprimibles.
Por ejemplo:

# man <orden> | col -b

¿Cómo se puede obtener una copia en Postscript de una página del manual lista para la impresión?

Nótese que <fichero> debe ser el fichero fuente de la página del manual (probablemente un fichero que termine con un número, como tcpdump.8). Las versiones en formato Postscript de las páginas del manual son muy vistosas. Se pueden imprimir o se pueden visualizar en pantalla con un programa como gv (GhostView). GhostView se puede obtener desde nuestro árbol de portes. A fin de obtener una versión en formato PostScript de una página del manual de OpenBSD se usará la orden nroff(1) con las siguientes opciones:

# nroff -Tps -mandoc <archivo> > resultado.ps

¿Cómo genero copias comprimidas de las páginas del manual?

Para quienes construyen sus sistemas desde el código fuente, hay varias opciones a tomar en cuenta acerca de la construcción de las páginas del manual. Estas opciones pueden colocarse en /etc/mk.conf (podría ser necesario crear este archivo) y están incluidas durante la construcción del sistema. Una opción especialmente útil es la que genera páginas del manual comprimidas con el fin de ahorrar espacio en disco. Estas páginas del manual pueden visualizarse normalmente con la instrucción man. Para conseguirlo añada lo siguiente a /etc/mk.conf:

MANZ=yes

¿Qué son los archivos info?

Parte de la documentación de OpenBSD viene en archivos info, ubicados comúnmente en /usr/share/info. Éste es un formato alternativo de documentación proporcionado por GNU. Muchos de estos archivos están más actualizados que las páginas de los manuales proporcionados por GNU y pueden ser accedidos con la instrucción info(1). Por ejemplo, para ver información acerca del compilador de GNU gcc(1), escriba:

# info gcc

¿Cómo veo las páginas del manual a color en XTerm?

El archivo de configuración por omisión para xterm(1) no despliega las páginas del manual a color. Para verlas a color copie el archivo /etc/X11/app-defaults/XTerm-color a su directorio personal y renómbrelo a ".Xdefaults". Tenga cuidado de no sobreescribir cualquier configuración previa de ".Xdefaults". Este archivo contiene todas las opciones que necesita para habilitar el color en XTerm. Sin embargo, es necesario quitar antes el comentario de de tres líneas:

!*VT100*colorULMode: on !*VT100*underLine: off !*VT100*colorBDMode: on

*VT100*colorUL: yellow *VT100*colorBD: white

¿Cómo escribo mi propia página del manual?

Si desea escribir su propia página del manual para alguna aplicación que haya escrito, se proporciona un tutorial en mdoc.samples(7). También se proporciona una práctica guía de referencia en mdoc(7).

2.4 - ¿Cómo se envía un informe sobre un error?

Antes de enviar un informe sobre cualquier error es necesario leer http://www.openbsd.org/es/report.html.

Un informe sobre un error bien escrito es una de las responsabilidades más importantes de los usuarios finales. Para poder diagnosticar los errores más serios se requiere una información muy detallada. Los desarrolladores suelen recibir informes por correo electrónico como el siguiente:

Espero que resulte obvio el porqué este tipo de «informes» son eliminados sin mediar palabra. Todos los informes sobre errores deben contener información detallada. Si el usuario del mensaje anterior hubiera querido realmente que el error sobre el que pretendía informar hubiera sido investigado, habría dado más información; algo así:

Véase report.html para más información sobre cómo crear y enviar informes sobre errores. Si alguien cree que el error podría estar relacionado de algún modo con su hardware o con la configuración de su hardware, será necesario que también incluya información sobre su hardware. Generalmente, la salida de la orden dmesg(8) será suficiente. También es necesaria una descripción detallada del problema. En el ejemplo se puede ver que dmesg describía el hardware, la explicación que se incluía explicaba por qué el usuario creía que el sistema no estaba estropeado (anteriormente funcionaba con 3.2 correctamente), cómo ocurrió el problema (iniciando X), y la salida de la órdenes ps y trace del depurador, ddb. En este caso, el usuario obtuvo esta salida capturándola en una consola serie; si no fuera posible usar una consola serie, sería necesario escribir a mano el registro de la caída del sistema (el ejemplo era el de un caso real en el que ese mismo informe ayudó a solucionar el problema en los sistemas Sun4c).

Si se dispone de un sistema OpenBSD desde el que se pueda enviar el informe sobre el error, es conveniente usar la utilidad sendbug(1) para enviar el informe a GNATS, el sistema de seguimiento de errores. Lógicamente, no se puede usar sendbug(1) si el sistema no arranca, pero en caso contrario hay que usarlo siempre que sea posible. Se debe incluir información detallada sobre el problema que se ha tenido, la configuración exacta del sistema, y cómo podemos reproducir el problema. Para el uso de la orden sendbug(1) se requiere que el sistema pueda enviar correo electrónico por Internet.

Después de enviar un informe de error a través de sendbug(1), se recibirá una notificación por correo electrónico sobre el estado del informe. Los desarrolladores pueden contactar con la persona que haya enviado el informe para requerirle más información o para que pruebe algún parche. También se puede monitorizar los archivos de la lista de correo bugs@openbsd.org. Véase la información en la página sobre listas de correo para más detalles, o bien se puede realizar una búsqueda en la base de datos de informes de error a través del Sistema de Seguimiento de Errores.

[Índice de documentos] [Sección 1 - Introduccón a OpenBSD] [Sección 3 - Cómo obtener OpenBSD]