Comando man de Linux: Cómo leer y buscar páginas del manual

En Linux, usar el comando man permite ver las páginas del manual de los comandos instalados y funciones del sistema. Por ejemplo, ejecutar man ls permite leer el uso y las opciones de ls, y en general, se puede presionar q para salir de la pantalla.

Abriendo una página del manual

man significa manual y ayuda a encontrar y mostrar las páginas de manual instaladas en el sistema. Además de los programas, hay páginas relacionadas con formatos de archivos de configuración, llamadas al sistema y funciones de la biblioteca. Por ejemplo, el siguiente comando abre el manual para ls.

man ls

Los manuales usualmente incluyen el nombre y una breve descripción en NAME, el formato del comando en SYNOPSIS, y funciones y opciones en DESCRIPTION y OPTIONS. Los contenidos y los títulos de sección pueden variar para cada programa. Leer el manual no ejecuta los comandos descritos ni cambia la configuración del sistema.

Navegación en Pantalla y Búsqueda

man utiliza un programa de paginación para mostrar contenido largo una página a la vez. Las instrucciones a continuación se basan en el comúnmente usado less. Si se configura un programa diferente, las teclas pueden variar.

• Flecha Abajo/Arriba: Moverse una línea a la vez.
• Espacio o Av Pág: Moverse hacia abajo una pantalla. b o Re Pág se mueve hacia arriba una pantalla.
• / seguido de un término de búsqueda y Enter: Buscar hacia adelante desde la posición actual. n se mueve al siguiente resultado en la misma dirección, N se mueve al resultado en la dirección opuesta.
• g y G: Mover al principio y al final del documento, respectivamente. Sensible a mayúsculas y minúsculas.
• h y q: h abre la ayuda de la operación, y q sale de la pantalla de ayuda o manual.

Por ejemplo, si ingresa /sort en la pantalla man ls y presiona Enter, busca hacia adelante esa expresión. El término de búsqueda se ingresa dentro de la pantalla del manual, no como un comando de shell. Para teclas detalladas y reglas de búsqueda, consulte el manual de less.

Selección de secciones del manual con el mismo nombre

Los manuales están divididos en secciones numeradas según los temas. Si un nombre de página existe en varias secciones, puede especificar un número para abrir la página deseada. Por ejemplo, passwd se utiliza tanto para comandos relacionados con la contraseña del usuario como para los nombres de archivos de información de cuenta.

man 1 passwd
man 5 passwd

El primer comando encuentra el manual del comando, y el segundo encuentra el manual del formato de archivo. La página correspondiente debe estar instalada en el sistema para poder mostrarse. Si se omite el número, se abrirá la página que se encuentre primero según el orden de búsqueda configurado.

• 1: Comandos generales y programas ejecutables
• 2: Llamadas al sistema
• 3: Funciones de la biblioteca
• 5: Formatos de archivos y reglas
• 8: Comandos de administración del sistema

La notación passwd(5) indica el nombre de la página y el número de sección. Las secciones completas y los métodos de búsqueda se pueden encontrar en el manual man.

Buscar una página por nombre o tema

Si no conoce el nombre exacto del comando, puede buscar el nombre del manual y una breve descripción usando man -k. El siguiente ejemplo encuentra elementos relacionados con password.

man -k password

Los resultados mostrarán el nombre de la página, el número de sección y una breve descripción. Los términos de búsqueda pueden interpretarse como expresiones regulares, y esta búsqueda no cubre todo el texto del manual. Los elementos encontrados pueden abrirse como man 5 passwd usando el nombre y el número de sección.

Si ya conoce el nombre y solo desea ver la breve descripción, ejecútelo de la siguiente manera.

man -f ls

man -k y man -f utilizan el índice del manual, por lo que los resultados pueden variar según los documentos instalados o el estado del índice.

Cuando no se puede encontrar el manual

• Página no encontrada: Verifique la ortografía del nombre y confirme si el programa y el paquete de documentos asociados están instalados. El manual puede faltar en un entorno de instalación mínima.
• Comandos integrados: Los comandos integrados en el shell, como cd, pueden no tener páginas separadas. En Bash, puede verificar help cd o man bash.
• Sin resultados de búsqueda: Asegúrese de que la documentación esté instalada y que el índice del manual esté preparado. Para regenerar el índice y administrar los permisos, siga la documentación de la distribución.
• Idioma diferente: Dependiendo de la traducción instalada y la configuración regional, puede aparecer en inglés. Verifique las opciones y ejemplos según la documentación de la versión de software instalada.

Si necesita una ayuda simple proporcionada por el propio comando, también puede consultar la opción --help de ese programa. El uso del propio man se puede ver en man man.