Skip to main content

Hombre - comando de linux

Mastering Linux Man Pages - A Definitive Guide (Junio 2026)

Mastering Linux Man Pages - A Definitive Guide (Junio 2026)
Anonim

Hombre Formatea y muestra las páginas de manual en línea. Si usted especifica sección , hombre Sólo se ve en esa sección del manual. Nombre Normalmente es el nombre de la página del manual, que suele ser el nombre de un comando, función o archivo. Sin embargo, si nombre contiene una barra (/) entonceshombreLo interpreta como una especificación de archivo para que puedas hacerlo.hombre ./foo.5 o inclusoman /cd/foo/bar.1.gz. Vea a continuación una descripción de dóndehombre busca los archivos de página manual.

Nombre

man - formatear y mostrar las páginas de manual en líneamanpath - determina la ruta de búsqueda del usuario para las páginas man

Sinopsis

hombre-acdfFhkKtwW --camino -metro sistema -pag cuerda -DO archivo de configuración -METRO lista de rutas -PAG buscapersonas -S section_list sección nombre …

Opciones

-C config_file

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

-M ruta

Especifique la lista de directorios para buscar páginas de manual. Separar los directorios con dos puntos. Una lista vacía es lo mismo que no especificar-METRO en absoluto. VerBUSCAR CAMINO PARA PÁGINAS MANUALES.

-P pager

Especifique qué buscapersonas utilizar. Esta opción anula laEmpacador variable de entorno, que a su vez anula laBUSCAPERSONAS variable. Por defecto,hombre usos/ usr / bin / less -isr.

-S section_list

Lista es una lista de secciones de manual separadas por dos puntos para buscar. Esta opción anula laMANSECTVariable ambiental.

-una

Por defecto,hombre Saldrá después de mostrar la primera página del manual que encuentre. El uso de esta opción obligahombre para visualizar todas las páginas del manual que coincidennombre,no solo el primero

-do

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

-re

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

-RE

Tanto mostrar como imprimir información de depuración.

-F

Equivalente aque es.

-F o--preformato

Sólo formato - no mostrar.

-h

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

-k

Equivalente aa propósito.

-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 de manual para buscar según el nombre del sistema dado.

-p cadena

Especifique la secuencia de preprocesadores para ejecutar antesnroff otroff. 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), consulte (r). Esta opción anula laMANROFFSEQ Variable ambiental.

-t

Utilizar/ usr / bin / groff -Tps -mandoc para formatear la página de manual, pasando la salida astdout La salida de/ usr / bin / groff -Tps -mandoc Es posible que deba pasar por un filtro u otro antes de imprimir.

-wo - ruta

No muestre realmente las páginas de manual, pero sí imprima la (s) ubicación (es) de los archivos que se formatearían o mostrarían. Si no se proporciona ningún argumento: muestre (en la salida estándar) la lista de directorios en los que se buscahombre para páginas de manual. Sisenda del hombre es un enlace al hombre, entonces "manpath" es equivalente a "man --path".

-W

Como -w, pero imprima los nombres de los archivos uno por línea, sin información adicional. Esto es útil en comandos de shell comohombre -AW hombre | xargs ls -l

Páginas CAT

Man intentará guardar las páginas de manual formateadas para ahorrar tiempo de formato la próxima vez que se necesiten estas páginas. Tradicionalmente, las versiones formateadas de las páginas en DIR / manX se guardan en DIR / catX, pero otras asignaciones de man dir a cat dir se pueden especificar en/etc/man.config. No se guardan páginas cat cuando no existe el directorio cat requerido. 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 hacerhombre Suid a un usuario hombre. Luego, si un directorio cat tiene un propietario y modo 0755 (solo se puede escribir por el hombre), y los archivos del gato tienen un propietario y modo 0644 o 0444 (solo se puede escribir por el hombre, o no se puede escribir), ningún usuario ordinario puede cambiar Páginas del gato o poner otros archivos en el directorio del gato. Sihombre no se hace suid, entonces un directorio cat debe tener el modo 0777 si todos los usuarios pueden dejar las páginas cat allí.

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

Ruta de búsqueda para páginas manuales

hombre utiliza un método sofisticado para encontrar archivos de páginas manuales, en función de las opciones de invocación y las variables de entorno, el/etc/man.configarchivo de configuración, y algunas convenciones y heurísticas incorporadas.

En primer lugar, cuando el nombre argumento ahombre contiene una barra (/), hombre asume que es una especificación de archivo en sí misma, y ​​no hay búsqueda involucrada.

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

Si especifica el-METRO lista de rutas opción, lista de rutas es una lista separada por dos puntos de los directorios quehombrebúsquedas

Si no especificas-METRO pero establece elMANPATH variable de entorno, el valor de esa variable es la lista de los directorios quehombre búsquedas

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

Además, elMANPATH_MAPlas declaraciones se agregan a la ruta de búsqueda dependiendo de su ruta de búsqueda de comandos (es decir, suCAMINOVariable ambiental). Para cada directorio que pueda estar en la ruta de búsqueda de comandos, unMANPATH_MAP declaración especifica un directorio que debe agregarse a la ruta de búsqueda para archivos de páginas de manual.hombre mira elCAMINO variable y agrega los directorios correspondientes a la ruta de búsqueda manual del archivo de página. Así, con el uso adecuado deMANPATH_MAP, cuando se emite el comandohombre xyz, obtendrá una página de manual para el programa que se ejecutaría si emitiera el comandoxyz.

Además, para cada directorio en la ruta de búsqueda de comandos (lo llamaremos "directorio de comandos") para el que realiza no tener unMANPATH_MAPdeclaración,hombre busca automáticamente un directorio de página 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 "cercanas" automáticas incluyendo unNOAUTOPAT declaración en/etc/man.config.

En cada directorio en la ruta de búsqueda como se describe anteriormente,hombre busca un archivo llamado tema . sección , 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 llamadohombre norte ogato norte dónde norte Es el número de sección manual. Si el archivo está en unagato norte subdirectorio,hombre asume que es un archivo de página de manual formateado (página de cat). De otra manera,hombre asume que está sin formato. En cualquier caso, si el nombre de archivo tiene un sufijo de compresión conocido (como.gz), hombre asume que está comprimido.

Si quieres ver dónde (o si)hombre encontraría la página del manual para un tema en particular, use el--camino(-w) opción.

Importante: Utilizar el hombre comando % hombre ) para ver cómo se usa un comando en su computadora en particular.