man – Comando Linux – Comando Unix

Man formatea y muestra las páginas del manual en línea. Si especifica section , man solo aparece en esa sección del manual. Nombre es normalmente el nombre de la página del manual, que normalmente es el nombre de un comando, función o archivo.

Man formatea y muestra las páginas del manual en línea. Si especifica section , man solo aparece en esa sección del manual. Nombre es normalmente el nombre de la página del manual, que normalmente es el nombre de un comando, función o archivo. Sin embargo, si name contiene una barra diagonal (/), entonces man lo interpreta como una especificación de archivo para que pueda hacer man ./ foo.5 o incluso man /cd/foo/bar.1.gz . Vea a continuación una descripción de dónde man busca los archivos de la página del manual.

Nombre

man – formatea y muestra las páginas del manual en línea
manpath – determina la ruta de búsqueda del usuario para las páginas man

Sinopsis

hombre [ -acdfFhkKtwW ] [ –path ] [ -m sistema ] [ -p cadena ] [ -C config_file ] [ -M lista de ruta ] [ -P localizador ] [ -S section_list ] [ sección ] nombre …

Opciones

-C archivo_configuración

Especifique el archivo de configuración a utilizar; el valor predeterminado es /etc/man.config . (Consulte man.conf (5)).

-M ruta

Especifique la lista de directorios para buscar páginas de manual. Separe los directorios con dos puntos. Una lista vacía es lo mismo que no especificar -M en absoluto. Consulte RUTA DE BÚSQUEDA DE PÁGINAS MANUALES .

-P localizador

Especifique qué buscapersonas usar. Esta opción anula la variable de entorno MANPAGER , que a su vez anula la variable PAGER . De forma predeterminada, man usa /usr/bin/less -isr .

-S section_list

Lista es una lista separada por dos puntos de secciones manuales para buscar. Esta opción anula la variable de entorno MANSECT .

-a

De forma predeterminada, man se cerrará después de mostrar la primera página manual que encuentra. El uso de esta opción obliga a man a mostrar todas las páginas del manual que coinciden con nombre, no solo la primera.

-c

Vuelva a formatear la página de manual de origen, incluso cuando exista una página cat actualizada. Esto puede ser significativo si la página cat fue formateada para una pantalla con un número diferente de columnas, o si la página preformateada está dañada.

-d

En realidad, no muestra las páginas de manual, pero imprime cantidades de información de depuración.

-D

Muestra e imprime información de depuración.

-f

Equivalente a whatis .

-F o –preformat

Solo formato: no mostrar.

-h

Imprima un mensaje de ayuda de una línea y salga.

-k

Equivalente a apropos .

-K

Busque la cadena especificada en * todas * las páginas man. Advertencia : ¡esto es probablemente muy lento! Ayuda a especificar una sección. (Solo para dar una idea aproximada, en mi máquina esto toma aproximadamente un minuto por cada 500 páginas de manual).

-m sistema

Especifique un conjunto alternativo de páginas man para buscar en función del nombre del sistema proporcionado.

-p cadena

Especifique la secuencia de preprocesadores para ejecutar antes de nroff o troff . No todas las instalaciones tendrán un conjunto completo de preprocesadores. Algunos de los preprocesadores y las letras utilizadas para designarlos son: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refiérase (r). Esta opción anula la variable de entorno MANROFFSEQ .

-t

Utilice /usr/bin/groff -Tps -mandoc para formatear la página del manual, pasando la salida a stdout. La salida de /usr/bin/groff – Tps -mandoc puede necesitar pasar a través de un filtro u otro antes de imprimirse.

-w o –path

En realidad, no muestra las páginas de manual, pero imprime las ubicaciones de los archivos que se formatearían o mostrarían. Si no se proporciona ningún argumento: muestre (en stdout) la lista de directorios en los que man busca páginas de man. Si manpath es un enlace a man, entonces «manpath» es equivalente a «man –path».

-W

Como -w, pero imprime los nombres de los archivos uno por línea, sin información adicional. Esto es útil en comandos de shell como man -aW man | xargs ls -l

Páginas CAT

Man intentará guardar las páginas man formateadas para ahorrar tiempo de formateo la próxima vez que se necesiten estas páginas.Tradicionalmente, las versiones formateadas de páginas en DIR/manX se guardan en DIR/catX, pero se pueden especificar otras asignaciones del directorio man al directorio cat en /etc/man.config . No se guardan páginas cat cuando el directorio cat requerido no existe. No se guardan páginas cat cuando se formatean para una longitud de línea diferente de 80. No se guardan páginas cat cuando man.conf contiene la línea NOCACHE.

Es posible hacer man suid a un usuario man. Luego, si un directorio cat tiene el propietario man y el modo 0755 (solo escribible por el hombre), y los archivos cat tienen el propietario man y el modo 0644 o 0444 (solo escribible por el hombre, o no escribible), ningún usuario común puede cambiar el páginas cat o poner otros archivos en el directorio cat. Si man no se convierte en suid, entonces un directorio cat debería tener el modo 0777 si todos los usuarios deberían poder dejar páginas cat allí.

La opción -c obliga a formatear una página, incluso si existe una página cat reciente.

Ruta de búsqueda de páginas del manual

man utiliza un método sofisticado para buscar archivos de páginas manuales, basado en las opciones de invocación y las variables de entorno, el archivo de configuración /etc/man.config y algunas convenciones integradas y heurística.

En primer lugar, cuando el argumento name para man contiene una barra diagonal (/), man asume que es un especificación de archivo en sí, y no hay búsqueda involucrada.

Pero en el caso normal en el que nombre no contiene una barra, man busca en una variedad de directorios un archivo que podría ser una página manual para el tema mencionado.

Si especifica la opción -M ruta , ruta es una lista separada por dos puntos de los directorios que man busca .

Si no especifica -M pero establece la variable de entorno MANPATH , el valor de esa variable es la lista de los directorios que man busca .

Si no especifica una lista de ruta explícita con -M o MANPATH , man desarrolla su propia lista de ruta basada en el contenido de la configuración archivo /etc/man.config . Las declaraciones MANPATH en el archivo de configuración identifican directorios particulares para incluir en la ruta de búsqueda.

Además, las instrucciones MANPATH_MAP se agregan a la ruta de búsqueda dependiendo de la ruta de búsqueda de comandos (es decir, su variable de entorno PATH ). Para cada directorio que puede estar en la ruta de búsqueda de comandos, una instrucción MANPATH_MAP especifica un directorio que debe agregarse a la ruta de búsqueda de archivos de páginas manuales. man examina la variable PATH y agrega los directorios correspondientes a la ruta de búsqueda de archivos de la página manual. Por lo tanto, con el uso adecuado de MANPATH_MAP , cuando ejecuta el comando man xyz , obtiene una página manual para el programa que se ejecutaría si emitiera el comando xyz .

Además, para cada directorio en la ruta de búsqueda de comandos (lo llamaremos «directorio de comandos») para el que no tiene una instrucción MANPATH_MAP , man busca automáticamente un directorio de páginas de manual «cercano», es decir, como un subdirectorio en el directorio de comandos o en el directorio principal del directorio de comandos.

Puede deshabilitar las búsquedas automáticas «cercanas» al incluir una declaración NOAUTOPATH en /etc/man.config .

En cada directorio en la ruta de búsqueda como se describió anteriormente, man busca un archivo llamado topic . section , con un sufijo opcional en el número de sección y posiblemente un sufijo de compresión. Si no encuentra dicho archivo, busca en cualquier subdirectorio llamado man N o cat N donde N es el número de sección manual. Si el archivo está en un subdirectorio cat N , man supone que es un archivo de página manual formateado (página cat). De lo contrario, man supone que no está formateado. En cualquier caso, si el nombre de archivo tiene un sufijo de compresión conocido (como .gz ), man asume que está comprimido.

Si desea ver dónde (o si) man encontraría la página del manual para un tema en particular, use –path ( -w ) opción.

Use el comando man (% man ) para ver cómo se usa un comando en su computadora en particular.

Rate article
labsfabs.com
Add a comment