Cuando busque el uso de un comando de Linux/Unix, no tiene que buscar en Google ni en los foros de discusión, páginas wiki, blogs o cualquier recurso fuera de línea/en línea. Todo está documentado en las páginas del manual (en breve, páginas man) del comando. Solo necesita aprender a usar las páginas man de manera eficiente para obtener los detalles de un comando o sus opciones/indicadores de manera fácil y rápida. Hoy, compartiré un truco de la página de manual menos conocido, es decir, cómo ver una sección específica en las páginas de manual en Linux y Unix.
Estructura predeterminada de la página del manual
Una página de manual consta de varias secciones diferentes, organizadas con encabezados para cada sección, como NOMBRE, SINOPSIS, CONFIGURACIÓN, DESCRIPCIÓN, OPCIONES, ESTADO DE SALIDA, VALOR DEVUELTO, ERRORES, ENTORNO, ARCHIVOS, VERSIONES, CONFORME A, NOTAS, FALLOS, EJEMPLO, AUTORES, y VER TAMBIÉN. Cada página del manual tiene su nombre de comando seguido del número de sección entre paréntesis.
Aquí está la lista de números de sección del manual seguido de los tipos de páginas que contienen:
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 e.g. /etc/passwd. 6 - Games. 7 - Miscellaneous (including macro packages and conventions), e.g. man(7). 8 - System administration commands (usually only for root). 9 - Kernel routines [Non standard].
Algunas páginas tienen todas estas secciones y otras no. Ahora veamos cómo ver una sección específica de la página de manual de un comando.
Ver una sección específica en las páginas man en Linux
Abramos una página man de un comando, por ejemplo uname .
$ man uname
Desplácese hacia abajo hasta el final de la página del manual y verá referencias a otros comandos.
[...]
SEE ALSO
arch(1), uname(2)
[...] 
página del comando man uname
¿Ves todos esos números detrás de los comandos al final? Verá uno o más comandos de referencia con números entre paréntesis al final de casi todas las páginas man de los comandos. Estos números indican la sección específica de la página de manual del comando que desea consultar. En otras palabras, el número corresponde a la sección del manual de la que proviene esa página.
Para decirle a man explícitamente que abra la sección 2 del comando uname, simplemente ejecute:
$ man 2 uname
O,
$ man uname.2
En la siguiente captura de pantalla, la ventana Terminal del lado izquierdo muestra el resultado del comando "man uname". El lado derecho de la ventana de Terminal muestra el resultado de "man 2 uname" (es decir, sección 2 de uname ) comando.
Ver una sección específica en las páginas man en Linux
Tenga en cuenta que cuando ejecutamos el comando man sin ningún número, generalmente es equivalente a:
$ man 1 <command>
Algunas páginas man no tienen una sección específica. En esos casos, no obtiene nada cuando intenta ver la página del manual con el número de sección. Por ejemplo, ejecuto el siguiente comando para ver la quinta sección del comando uname:
$ man 5 uname
Dado que el comando uname no tiene la sección 5, obtengo el siguiente resultado:
No manual entry for uname in section 5 See 'man 7 undocumented' for help when manual pages are not available.
Mostrar todas las secciones seguidas
Como ya dije, la página de manual de un comando específico tiene muchas secciones. Para ver todas las páginas coincidentes seguidas, utilice -a marca como a continuación.
$ man -a uname
Presiona q para salir de una sección y pasar a la siguiente.
Mostrar todos los comandos que coinciden con una cadena con números de sección
Podemos buscar páginas man que contengan una cadena de búsqueda usando -k bandera. Entonces, si desea recuperar todos los números de sección de un comando específico en la página del manual, use -k opción como la siguiente.
$ man -k uname
Salida de muestra:
arch (1) - print machine hardware name (same as uname -m) oldolduname (2) - get name and information about current kernel olduname (2) - get name and information about current kernel uname (1) - print system information uname (1posix) - return system name uname (2) - get name and information about current kernel
Como puede ver en el resultado anterior, enumeramos todos los comandos (es decir, subcadenas) que coinciden con la cadena de palabras clave dada. Para limitar estrictamente la búsqueda dentro de la cadena coincidente, use:
$ man -k '^uname'
Salida de muestra:
uname (1) - print system information uname (1posix) - return system name uname (2) - get name and information about current kernel
Alternativamente, puede usar -f bandera.
$ man -f uname
Salida de muestra:
uname (1) - print system information uname (2) - get name and information about current kernel uname (1posix) - return system name
Para obtener más detalles, consulte las páginas man de "man".
$ man man
Además, consulte otras secciones de ayuda para las páginas man.
$ man -k man
$ info man
Lectura recomendada:
- Buenas alternativas a las páginas man que todo usuario de Linux debe conocer
- Cómo encontrar la página man más larga en Linux
- Cómo recuperar fácilmente comandos de Linux olvidados
- Cómo crear y mantener sus propias páginas man
- Cómo instalar páginas man faltantes de comandos en Ubuntu
- Pinfo:un programa CLI para leer información y páginas man en color
Espero que esto ayude.