Uso del sistema de paginas man

Las páginas man describen programas, archivos de configuración y otras características de una instalación de linux. Algunas palabras clave nos dirigen a varias entradas en múltiples entrada en múltiples secciones.


Se utiliza de la siguiente manera:
man y-lo-que-buscar
man ls
Tambien se puede buscar una sección determinada:
man nº-de-seccion lo-que-buscar
man 5 passwd

La busqueda del comando man se define en el archivo /etc/man.conf, especificado en la opción MANSECT, en Debian 7 y opensuse 12 lo he encontrado en /etc/manpath.conf en la opción SECTION.

Seciones de man system

Numeros de sección     Descripción
1                                  Programas ejecutables y comandos shell.
2                                  LLamadas del sistema proporcionadas por el núcleo.
3                                  LLamadas de librerías proporcionadas por librerías de programas.
4                                  Archivos de dispositivos (generalmente se guardan en /dev).
5                                  Formatos de archivo.
6                                  Juegos.
7                                  Miscelánea: paquetes  macros, convenciones, etc.
8                                  Comandos de administración del sistema. Programas que suele ejecutar
                                    exclusivamente el superusuario (root).
9                                  Rutinas de núcleo.

Los detalles sobre que paginas man estan disponibles varian entre las distintas distribuciones. Esto puede aceptar a los resultados de las búsquedas tanto con whatis como con apropos.

Whatis busca resumenes de informacion contenidos en las paginas man para la palabra clave que introduzcamos.. El comando devuelvo una linea de resumen por cada página man que se corresponda con la búsqueda. Se puede utilizar esta información para localizar y leer la página man necesaria sobre un tema.

Apropos o man -k realiza una búsqueda más exhaustiva tanto de la sección Name como en Description de las páginas man. Buscar por teminos poco comunes para que sea mas util, no es lo mismo colocar the (que soltara una burrada de datos) que samba (soltara menos datos)

Lectura de las páginas man:
-Name: Una página man comienza con una declaración del comando, llamada o archivo descrito, junto con unas pocas palabras de explicación.
-Synopsis: La sipnosis ofrece una descripción breve de cómo se utiliza un comando . Parámetros opcionales aparecen entre corchetes [ ]. Una elipsis (...) denota un conjunto opcional  de elementos repetidos, tales como múltiples nombres de archivos si un comando adopta uno o varios nombres de archivo como opciones.
-Description: La descripción es un resumen  de lo que hace un comando, archivo, etc.
-Options: Esta sección elabora sobre las opciones esbozadas en la sección sipnosis.
-Files: Esta sección lista archivos asociados con el tema de la página man.
-See Also (ver también): Esta sección ofrece indicaciones sobre información relacionada en el sistema de páginas man, típicamente junto con el número de sección.
-Bugs: Númerosas páginas ofrecen una sección de bugs en la que el autordescribe cualquier error o limitación conocidos. o bien indica que no existe ningun error.
-Hystory: Algunas páginas de man incluyen resúmenes de la hhistoria del programa.
-Author: La mayoría de las páginas man finalizan con la sección autor, que suele indicar cómo contactar con el autor del mismo.

Por defecto, man utiliza el comando less para permitirnos recorrer el documento hacia atras y hacia delante.