Las páginas de manual en Linux son el lugar al que acudir para obtener soporte de primer nivel cuando se trata de utilidades de línea de comandos. Como la mayoría de ustedes sabrá, simplemente escriba 'man [command-name]' y aparecerá la página de manual correspondiente. Pero, ¿conoce la ruta donde se buscan estas páginas man?
En este tutorial, discutiremos manpath , una utilidad que te muestra esta información. Pero antes de comenzar con la explicación, vale la pena mencionar que todos los ejemplos aquí se han probado en una máquina con Ubuntu 18.04 LTS.
Tutorial de ruta de manual de Linux
El comando manpath en Linux lo ayuda a determinar la ruta de búsqueda de páginas de manual. La siguiente es su sintaxis:
manpath [-qgdc?V] [-m system[,...]] [-C file]
Y así es como la página de manual de la herramienta lo describe:
If $MANPATH is set, manpath will simply display its contents and issue
a warning. If not, manpath will determine a suitable manual page hier?
archy search path and display the results.
The colon-delimited path is determined using information gained from
the man-db configuration file - (/etc/manpath.config) and the user's
environment.
Los siguientes son algunos ejemplos de estilo de preguntas y respuestas que le darán una buena idea de cómo funciona el comando manpath.
P1. ¿Cómo funciona el comando manpath?
El uso básico es bastante sencillo:simplemente ejecute 'manpath' sin ninguna opción.
manpath
Por ejemplo, esto es lo que produjo el comando anterior en la salida de mi sistema:
/usr/local/man:/usr/local/share/man:/usr/share/man
Como puede ver, manpath produce una lista de rutas separadas por dos puntos para las páginas de manual.
Tenga en cuenta que puede utilizar la opción de línea de comando -g en caso de que desee generar una ruta man que conste de todas las rutas nombradas como 'globales' dentro del archivo de configuración man-db.
P2. ¿Cómo tener catpath en la salida en lugar de manpath?
Para ello, utilice la opción de línea de comando -c.
manpath -c
Así es como la página de manual de la herramienta explica esta operación:
Once the manpath is determined, each path element is converted to its relative catpath.
Por ejemplo, aquí está la salida producida en mi sistema:
/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man
P3. ¿Cómo hacer que manpath imprima información de depuración?
Para ello, utilice la opción de línea de comando -d.
manpath -d
Por ejemplo, aquí está el resultado que produjo este comando en mi sistema:
De acuerdo, es posible que no use esta opción con mucha frecuencia, pero al menos debe tenerla en cuenta en caso de que necesite depurar la salida de la herramienta.
P4. ¿Cómo hacer que manpath acceda a las jerarquías manuales de otros sistemas operativos?
Para ello, utilice la opción de línea de comando -m. Así es como la página de manual de la herramienta explica esta opción:
-m system[,...], --systems=system[,...]
If this system has access to other operating sys?
tem's manual hierarchies, this option can be used to
include them in the output of manpath. To include
NewOS's manual page hierarchies use the option -m
NewOS.
The system specified can be a combination of comma
delimited operating system names. To include the
native operating system's manual page hierarchies,
the system name man must be included in the argument
string. This option will override the $SYSTEM envi?
ronment variable.
P5. ¿Cómo hacer que manpath use un archivo de configuración personalizado?
De forma predeterminada, manpath obtiene información del siguiente archivo:
/etc/manpath.config
Sin embargo, si lo desea, puede obligar a manpath a leer cualquier otro archivo. Esto lo puede hacer usando la opción de línea de comando -C.
manpath -C NEWFILE-PATH
Conclusión
Si su trabajo de línea de comandos de Linux implica tratar con páginas man, el comando manpath es una herramienta útil para usted. Aquí, en este tutorial, hemos discutido la mayoría de las opciones de línea de comandos de manpath. Para obtener más información sobre la herramienta, diríjase a su página de manual.