Tutorial del comando manpath de Linux para principiantes (5 ejemplos)

Las páginas del manual en Linux son el lugar de referencia para el soporte de primer nivel cuando se trata de utilidades de línea de comandos. Como la mayoría de ustedes sabrán, solo escriben ‘man [nombre-del-comando]’ y la página del manual correspondiente aparece. Pero, ¿saben la ruta donde se buscan estas páginas del manual?

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í han sido probados en una máquina Ubuntu 18.04 LTS.

Tutorial de manpath en Linux

El comando manpath en Linux te ayuda a determinar la ruta de búsqueda para las páginas manuales. A continuación se muestra su sintaxis:

manpath [-qgdc?V] [-m system[,...]] [-C file]

Y así es como la página del manual de la herramienta lo describe:

       Si  $MANPATH está configurado, manpath simplemente mostrará su contenido y emitirá  
       una advertencia.  Si no, manpath determinará una ruta de búsqueda adecuada para la jerarquía de páginas manuales y mostrará los resultados.  

       La  ruta  delimitada por dos puntos  se determina utilizando información obtenida del  
       archivo de configuración de man-db - (/etc/manpath.config)  y  el  entorno del  
       usuario.

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 manpath.

P1. ¿Cómo funciona el comando manpath?

El uso básico es bastante sencillo: solo ejecuta ‘manpath’ sin ninguna opción.

manpath

Por ejemplo, esto es lo que produjo el comando anterior en mi sistema:

/usr/local/man:/usr/local/share/man:/usr/share/man

Así que puedes ver, manpath produce una lista de rutas separadas por dos puntos para las páginas manuales.

Ten en cuenta que puedes usar la opción de línea de comandos -g en caso de que quieras producir un manpath que consista en todas las rutas nombradas como ‘global’ dentro del archivo de configuración de man-db.

P2. ¿Cómo tener catpath en la salida en lugar de manpath?

Para esto, usa la opción de línea de comandos -c.

manpath -c

Así es como la página del manual de la herramienta explica esta operación:

Una vez que se determina el manpath, cada elemento de la ruta se convierte en su catpath relativo.

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 esto, usa la opción de línea de comandos -d.

manpath -d

Por ejemplo, aquí está la salida que produjo este comando en mi sistema:

Es cierto que puede que no uses esta opción con mucha frecuencia, pero al menos deberías estar al tanto de ella en caso de que necesites depurar la salida de la herramienta.

P4. ¿Cómo hacer que manpath acceda a las jerarquías manuales de otros sistemas operativos?

Para esto, usa la opción de línea de comandos -m. Así es como la página del manual de la herramienta explica esta opción:

-m system[,...], --systems=system[,...]  
                
              Si  este  sistema  tiene acceso a las jerarquías manuales de otros sistemas operativos, esta opción se puede usar para  
              incluirlas en la salida de manpath.  Para incluir las jerarquías de páginas manuales de NewOS, usa la opción -m  
              NewOS.  
  
              El  sistema  especificado puede ser una combinación de nombres de sistemas operativos delimitados por comas.   Para  incluir  las  
              jerarquías de páginas manuales del sistema operativo nativo,  el nombre del sistema man debe incluirse en la cadena de argumentos.  
              Esta opción anulará la variable de entorno $SYSTEM.

P5. ¿Cómo hacer que manpath use un archivo de configuración personalizado?

Por defecto, manpath obtiene información del siguiente archivo:

/etc/manpath.config

Sin embargo, si lo deseas, puedes forzar a manpath a leer cualquier otro archivo. Esto lo puedes hacer usando la opción de línea de comandos -C.

manpath -C NUEVO-RUTA-DEL-ARCHIVO

Conclusión

Si tu trabajo en la línea de comandos de Linux implica tratar con páginas manuales, el comando manpath es una herramienta útil para ti. Aquí, en este tutorial, hemos discutido la mayoría de las opciones de línea de comandos de manpath. Para más información sobre la herramienta, dirígete a su página del manual.