Esta pagina se ve mejor con JavaScript habilitado

Man pages

 ·  ūüéÉ kr0m

En este art√≠culo explicar√© el modo correcto de utilizaci√≥n de las man pages ya que se trata de la primera fuente a consultar cuando tenemos alg√ļn problema con una herramienta del sistema operativo, es mas no haber le√≠do la p√°gina de man correspondiente y haber preguntado online en foros o listas de correo se considera una falta de respeto e inter√©s en muchos circulos de sysadmins.

Lo primero que debmos saber es que hay varias secciones:

1. General user commands
2. System calls and error numbers
3. C programming libraries
4. Devices and device drivers
5. File formats
6. Game instructions
7. Miscellaneous information
8. System maintenance commands
9. Kernel interfaces

Podemos consultar una descripción de cada sección de la siguiente manera:

man N√öMERO_SECCI√ďN intro

Si queremos consultar la descripción de la sección 8. System maintenance commands sería:

man 8 intro

Como ejemplo vamos a consultar la p√°gina de manual de la herramienta dhclient:

man dhclient

En la primera línea vemos:

DHCLIENT(8)             FreeBSD System Manager's Manual            DHCLIENT(8)

El n√ļmero 8 indica que esta p√°gina de manual corresponde a comandos de administraci√≥n del sistema:

8. System maintenance commands

Si no sabemos con certeza que p√°gina de manual buscar para un comando en concreto podemos ejecutar varios comandos:

  • apropos: Buscar√° el patr√≥n en las p√°gina de manual.
  • whatis: Buscar√° la palabra exacta en las p√°ginas de manual.

Las p√°ginas de man se dividen en varias secciones:

  • NAME: Nombre del programa o utilidad. Algunos programas tienen multiples nombres como vi por ejemplo: vi, ex, view
  • SYNOPSIS: Lista posibles opciones y argumentos. Si ya estamos familiarizados con un programa pero no recordamos una opci√≥n esta cabecera nos resultar√° √ļtil.
  • DESCRIPTION: Contiene una breve descripci√≥n del programa, librer√≠a o feature. El contenido de esta secci√≥n variar√° dependiendo del programa, fichero o librer√≠a.
  • OPTIONS: Muestra las opciones de l√≠nea de comandos y sus efectos.
  • BUGS: Describe problemas conocidos con el c√≥digo, en multitud de ocasiones podemos evitarnos dolores de cabeza con programas que est√°n bugeados si leemos esta secci√≥n antes de buscar soluciones inexistentes.
  • EXAMPLES: Son ejemplos de uso de los programas. Algunos programas son realmente complicados y un par de ejemplos sobre su uso arrrojan mas luz que una lista de opciones.
  • HISTORY: Muestra cuando el comando o c√≥digo fueron a√Īadidos al sistema y si no forma parte de FreeBSD indicar√° su origen.
  • SEE ALSO: Comandos, ficheros o librer√≠as relacionadas con el comando consultado actualmente.
Si te ha gustado el artículo puedes invitarme a un RedBull aquí