Tutorial del comando man de Linux para principiantes (8 ejemplos)

Un aspecto muy útil de la línea de comandos de Linux es que la documentación para casi todas las herramientas de línea de comandos es fácilmente accesible. Estos documentos se conocen como páginas man, y puedes acceder a ellos fácilmente a través de la línea de comandos usando el comando man.

En este tutorial, discutiremos los conceptos básicos de man usando algunos ejemplos fáciles de entender. Pero antes de hacer eso, vale la pena mencionar que todos los ejemplos en este artículo han sido probados en una máquina Ubuntu 16.04 LTS.

Comando man de Linux

El comando man da a los usuarios acceso a las páginas manuales para utilidades y herramientas de línea de comandos. A continuación se muestra la sintaxis de este comando:

man [nombre del comando/herramienta]

Y así es como la propia página manual de man lo describe:

 man - una interfaz a los manuales de referencia en línea  
  man es el paginador manual del sistema. Cada argumento de página dado a man es  
  normalmente el nombre de un programa, utilidad o función. La página manual  
  asociada con cada uno de estos argumentos se encuentra y se muestra. Una  
  sección, si se proporciona, dirigirá a man a buscar solo en esa sección del  
  manual. La acción predeterminada es buscar en todas las secciones  
  disponibles siguiendo un orden predefinido ("1 n l 8 3 2 3posix 3pm 3perl 5  
  4 9 6 7" por defecto, a menos que se anule mediante la directiva SECTION en  
  /etc/manpath.config), y mostrar solo la primera página encontrada, incluso si  
  la página existe en varias secciones.  

La tabla a continuación muestra los números de sección del manual seguidos de los  
  tipos de páginas que contienen.  

 1 Programas ejecutables o comandos de shell  
 2 Llamadas al sistema (funciones proporcionadas por el núcleo)  
 3 Llamadas a bibliotecas (funciones dentro de bibliotecas de programas)  
 4 Archivos especiales (generalmente encontrados en /dev)  
 5 Formatos de archivo y convenciones, por ejemplo, /etc/passwd  
 6 Juegos  
 7 Varios (incluyendo paquetes de macros y convenciones), por ejemplo,  
 man(7), groff(7)  
 8 Comandos de administración del sistema (generalmente solo para root)  
 9 Rutinas del núcleo [No estándar]  

Una página manual consta de varias secciones.  

Los nombres de sección convencionales incluyen NOMBRE, SINOPSIS, CONFIGURACIÓN,  
 DESCRIPCIÓN, OPCIONES, ESTADO DE SALIDA, VALOR DE RETORNO, ERRORES, ENTORNO,  
 ARCHIVOS, VERSIONES, CONFORMIDAD, NOTAS, ERRORES, EJEMPLO, AUTORES y  
 VEASE TAMBIÉN.

A continuación se presentan algunos ejemplos en formato de preguntas y respuestas que deberían darte una buena idea de cómo funciona el comando man.

P1. ¿Cómo usar el comando man?

El uso básico de man es muy simple: solo ejecuta el comando con el nombre de la herramienta cuyo manual de referencia deseas acceder.

man [nombre del comando/herramienta]

Por ejemplo:

man ls

P2. ¿Cómo hacer que man muestre la página manual de secciones específicas?

Como ya se mencionó al principio, todas las páginas manuales disponibles están segregadas en secciones, y hay secciones que contienen entradas de páginas man con el mismo nombre. Para facilitarte las cosas, el comando man te permite acceder directamente a las páginas manuales de secciones específicas, algo que puedes hacer simplemente especificando el número de sección antes del nombre del comando/herramienta.

man [número-de-sección] [nombre del comando/herramienta]

Por ejemplo:

man 3 printf 

P3. ¿Cómo buscar páginas manuales y imprimir descripciones cortas también?

Mientras revisabas la P2, uno podría preguntarse cómo recordar los números de sección para las entradas manuales con el mismo nombre. Bueno, no tienes que hacer eso, ya que existe una opción de línea de comandos ‘f’ que permite a man mostrar todas las páginas manuales que coinciden con el nombre en la entrada.

Por ejemplo:

man -f printf

Aquí está la salida que produjo el comando anterior en mi sistema:

Así que puedes ver que todas las entradas con el nombre ‘printf’, junto con los números de sección, se mostraron en la salida.

P4. ¿Cómo hacer que man muestre todas las páginas manuales para una entrada dada?

Ahora, ¿qué pasa si deseas que man muestre una por una todas las páginas manuales correspondientes a una entrada dada? Bueno, eso es posible, y tendrás que usar la opción de línea de comandos -a para ello.

Por ejemplo, si deseas ver en serie todas las páginas man para ‘printf’, puedes hacerlo de la siguiente manera:

man -a printf

El comando anterior abrirá primero la página man de printf de la sección 1, y cuando la cierres, el comando te preguntará si deseas ver la siguiente página man de ‘printf’.

P5. ¿Cómo hacer que man busque considerando la entrada como una expresión regular?

En caso de que desees que el comando man busque y liste las páginas manuales considerando la entrada como una expresión regular, puedes hacerlo usando la opción de línea de comandos -k.

man -k [nombre del comando/herramienta]

Por ejemplo:

man -k printf

Aquí está la salida que produjo el comando anterior en mi sistema:

P6. ¿Cómo hacer que man muestre la ubicación de las páginas manuales?

En caso de que la necesidad sea solo conocer la ubicación de las páginas manuales, puedes obligar a man a hacer esto usando la opción de línea de comandos -w.

man -w [nombre del comando/herramienta]

Por ejemplo:

man -w printf

A continuación se muestra la salida que produjo este comando en mi sistema:

/usr/share/man/man1/printf.1.gz

P7. ¿Cómo hacer que man muestre páginas manuales en el navegador web?

Usa la opción de línea de comandos -H para esto.

man -H[comando-del-navegador] [nombre del comando/herramienta]

Por ejemplo:

man -Hfirefox printf

P8. ¿Cómo hacer que el comando man sea sensible a mayúsculas y minúsculas?

Por defecto, el comando man ignora las mayúsculas y minúsculas al buscar páginas manuales. Sin embargo, si lo deseas, puedes habilitar la sensibilidad a mayúsculas y minúsculas usando la opción de línea de comandos -I.

man -I [nombre del comando/herramienta]

Conclusión

Así que puedes ver que man es un comando extremadamente importante que los usuarios, tanto principiantes como profesionales, deben saber cómo usar. Solo hemos arañado la superficie aquí, ya que la herramienta ofrece muchas características. Practica estas primero, y cuando hayas terminado, dirígete a la página man de man para más información.