Tutorial de comando Linux manpath para principiantes (5 ejemplos)
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 saben, solo escriben ‘hombre [command-name]’ y aparece 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 probaron en una máquina con Ubuntu 18.04 LTS.
Tutorial de la ruta de acceso manual de Linux
El comando manpath en Linux lo ayuda a determinar la ruta de búsqueda de páginas de manual. A continuación se muestra 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.
Q1. ¿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. Esta es una muestra del «ejemplo de man» en uso, mostrando la simplicidad y eficacia del comando.
Tenga en cuenta que puede usar la opción de línea de comando -g en caso de que desee generar una ruta man que conste de todas las rutas denominadas como ‘globales’ dentro del archivo de configuración man-db.
Q2. ¿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 del 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
Este es otro «man ejemplos», que ilustra cómo el comando puede ser utilizado para obtener resultados específicos.
Q3. ¿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.
Q4. ¿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 del 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.
Este es uno de los «5 ejemplos de hacer» uso de manpath, mostrando cómo puede expandir su funcionalidad para incluir múltiples sistemas.
Q5. ¿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 comandos -C.
manpath -C NEWFILE-PATH
Este sería el «comando 5» en la secuencia de ejemplos que hemos estado discutiendo.
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 man. Con estos «man en linux» ejemplos, debería estar bien equipado para manejar sus consultas de páginas man con facilidad.