Un aspecto muy útil de la línea de comandos de Linux es que se puede acceder fácilmente a la documentación de casi todas las herramientas de línea de comandos. Estos documentos se conocen como páginas de manual y puede acceder a ellos fácilmente a través de la línea de comando usando el man comando.
En este tutorial, discutiremos los conceptos básicos del hombre usando algunos ejemplos fáciles de entender. Pero antes de hacerlo, vale la pena mencionar que todos los ejemplos de este artículo se probaron en una máquina con Ubuntu 16.04 LTS.
Comando Linux man
El comando man brinda a los usuarios acceso a las páginas del manual para las utilidades y herramientas de la línea de comandos. La siguiente es la sintaxis de este comando:
man [command/tool name]
Y así es como lo describe la propia página del manual del hombre:
man - an interface to the on-line reference manuals
man is the system's manual pager. Each page argument given to man is
normally the name of a program, utility or function. The manual page
associated with each of these arguments is then found and displayed. A
section, if provided, will direct man to look only in that section of
the manual. The default action is to search in all of the available
sections following a pre-defined order ("1 n l 8 3 2 3posix 3pm 3perl 5
4 9 6 7" by default, unless overridden by the SECTION directive in
/etc/manpath.config), and to show only the first page found, even if
page exists in several sections.
The table below shows the section numbers of the manual followed by the
types of pages they contain.
1 Executable programs or shell commands
2 System calls (functions provided by the kernel)
3 Library calls (functions within program libraries)
4 Special files (usually found in /dev)
5 File formats and conventions eg /etc/passwd
6 Games
7 Miscellaneous (including macro packages and conventions), e.g.
man(7), groff(7)
8 System administration commands (usually only for root)
9 Kernel routines [Non standard]
A manual page consists of several sections.
Conventional section names include NAME, SYNOPSIS, CONFIGURATION,
DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT,
FILES, VERSIONS, CONFORMING TO, NOTES, BUGS, EXAMPLE, AUTHORS, and
SEE ALSO.
Los siguientes son algunos ejemplos de preguntas y respuestas que le darán 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:simplemente ejecute el comando con el nombre de la herramienta a cuyo manual de referencia desea acceder.
man [command/tool name]
Por ejemplo:
man ls
P2. ¿Cómo hacer que man muestre la página del manual desde secciones específicas?
Como ya se mencionó al principio, todas las páginas de manual disponibles están segregadas en secciones, y hay secciones que contienen entradas de página de manual con el mismo nombre. Para facilitarle las cosas, el comando man le permite acceder directamente a las páginas del manual desde secciones específicas, algo que puede hacer simplemente especificando el número de sección antes del nombre del comando/herramienta.
man [section-num] [command/tool name]
Por ejemplo:
man 3 printf
P3. ¿Cómo buscar páginas de manual e imprimir descripciones breves también?
Al pasar por la pregunta y respuesta 2, uno puede 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 comando 'f' que permite que man muestre todas las páginas del manual que coincidan con el nombre en la entrada.
Por ejemplo:
man -f printf
Aquí está el resultado del comando anterior producido en mi sistema:
Para que pueda ver todas las entradas con el nombre 'printf', junto con los números de sección, se muestran en la salida.
P4. ¿Cómo hacer que man muestre todas las páginas del manual para una entrada determinada?
Ahora, ¿qué sucede si desea que man muestre una por una todas las páginas del manual correspondientes a una entrada dada? Bueno, eso es posible, y tendrás que usar la opción de línea de comando -a para ello.
Por ejemplo, si desea ver en serie todas las páginas man de 'printf', puede hacerlo de la siguiente manera:
man -a printf
El comando anterior abrirá primero la página de manual de printf desde la sección 1, y cuando salga, el comando le preguntará si desea ver la siguiente página de manual de 'printf'.
P5. ¿Cómo hacer que el hombre busque considerando la entrada como una expresión regular?
En caso de que desee que el comando man busque y enumere las páginas del manual considerando la entrada como una expresión regular, puede hacerlo usando la opción de línea de comando -k.
man -k [command/tool name]
Por ejemplo:
man -k printf
Aquí está el resultado del comando anterior producido en mi sistema:
P6. ¿Cómo hacer que el hombre muestre la ubicación de las páginas del manual?
En caso de que el requisito sea conocer solo la ubicación de las páginas del manual, puede obligar a man a hacerlo utilizando la opción de línea de comando -w.
man -w [command/tool name]
Por ejemplo:
man -w printf
El siguiente es el resultado que este comando produjo en mi sistema:
/usr/share/man/man1/printf.1.gz
P7. ¿Cómo hacer que man muestre páginas de manual en el navegador web?
Use la opción de línea de comando -H para esto.
man -H[browser-command] [command/tool name]
Por ejemplo:
man -Hfirefox printf
P8. ¿Cómo hacer que el comando man distinga entre mayúsculas y minúsculas?
De forma predeterminada, el comando man ignora las mayúsculas y minúsculas mientras busca páginas de manual. Sin embargo, si lo desea, puede habilitar la distinción entre mayúsculas y minúsculas mediante la opción de línea de comando -I.
man -I [command/tool name]
Conclusión
Entonces puede ver que man es un comando extremadamente importante que los usuarios, tanto novatos como profesionales, deben saber cómo usar. Acabamos de arañar la superficie aquí, ya que la herramienta ofrece muchas funciones. Practique esto primero y, cuando haya terminado, diríjase a la página de manual del hombre para obtener más información.