Comando man de Linux
En Linux y otra Unix -como sistemas operativos , hombre es la interfaz utilizada para ver los manuales de referencia del sistema.
- Sintaxis
- Ejemplos de
- Comandos relacionados
- Ayuda de comandos de Linux
Descripción
hombre es el visor manual del sistema; se puede utilizar para mostrar páginas de manual, desplazarse hacia arriba y hacia abajo, buscar ocurrencias de texto específico y otras funciones útiles.
Cada argumento dado a hombre es normalmente el nombre de un programa , utilidad o función . A continuación, se encuentra y se muestra la página de manual asociada con cada uno de estos argumentos. Un número de sección, si se proporciona, dirigirá hombre para mirar solo en esa sección del manual. La acción predeterminada es buscar en todas las secciones disponibles, siguiendo un orden predefinido y mostrar solo la primera página encontrada, incluso si la página existe en varias secciones.
Sintaxis
|_+_| |_+_| |_+_| |_+_| |_+_| |_+_| |_+_| |_+_|Opciones generales
| -h , --ayuda | Imprima un mensaje de ayuda y salga. |
| -V , --versión | Muestra la información de la versión y sale. |
| -C expediente , --config-file = expediente | Usar archivo de configuración expediente en lugar del valor predeterminado de ~ / .manpath . |
| -D , --depurar | Imprime información de depuración. |
| -D , --defecto | Esta opción, cuando se utiliza, normalmente se especifica como la primera opción; se reinicia hombre comportamiento a su valor predeterminado. Su uso es restablecer aquellas opciones que se hayan configurado en $ MANOPT . Cualquier opción que siga -D tendrá su efecto habitual. |
| - advertencias [ = advertencias ] | Habilite las advertencias del groff formateador de texto. Esto se puede utilizar para realizar comprobaciones de cordura en el texto fuente de las páginas del manual. La advertencias es una lista de nombres de advertencia separados por comas; si no se proporciona, el valor predeterminado es ' mac '. Ver el ' Advertencias 'nodo en el groff página de información para obtener una lista de los nombres de advertencia disponibles. |
Opciones: modos de funcionamiento principales
| -F , --que es | Equivalente al comando whatis; muestra una breve descripción de la página del manual, si está disponible. |
| -a , --a propósito | Equivalente al a propósito mando; Busque palabras clave en las descripciones breves de las páginas del manual y muestre las coincidencias. |
| -A , - global-apropos | Busque texto en todas las páginas del manual. Esta opción es una búsqueda de fuerza bruta y es probable que lleve algún tiempo; si puede, debe especificar una sección para reducir el número de páginas que deben buscarse. Los términos de búsqueda pueden ser simples instrumentos de cuerda (el predeterminado), o expresiones regulares Si el --regex se utiliza la opción. |
| -l , --archivo local | Active el modo 'local'. Formatee y muestre archivos manuales locales en lugar de buscar en la colección de manuales del sistema. Cada argumento de la página del manual se interpretará como un archivo fuente nroff en el formato correcto. No gato se produce el archivo. Si un guión (' - ') aparece como uno de los argumentos, la entrada se tomará de stdin . Cuando esta opción no se utiliza, y hombre no encuentra la página requerida, antes de mostrar el mensaje de error, intenta actuar como si se hubiera proporcionado esta opción, utilizando el nombre como nombre de archivo y buscando una coincidencia exacta. |
| -en , --dónde , --localización | En realidad, no muestre las páginas del manual; en su lugar, imprima la (s) ubicación (es) de la fuente nroff archivos que serían formateados. |
| -EN , --donde-gato , --ubicación-gato | En realidad, no muestre las páginas del manual, pero imprima la (s) ubicación (es) del gato archivos que se mostrarían. Si -en y -EN se especifican ambos, imprime ambos, separados por un espacio. |
| -c , --hombre gato | Esta opción no es para uso general y solo debe ser utilizada por el hombre gato programa. |
| -R codificacion , --recode = codificacion | En lugar de formatear la página del manual de la forma habitual, genere su fuente convertida a la codificación especificada. Si ya conoce la codificación del archivo fuente, también puede usar manconv directamente. Sin embargo, esta opción le permite convertir varias páginas de manual a una única codificación sin tener que indicar explícitamente la codificación de cada una, siempre que ya estén instaladas en una estructura similar a una jerarquía de páginas de manual. |
Opciones: búsqueda de páginas del manual
| -L local , --local = local | hombre normalmente determinará su ubicación actual mediante una llamada a la función C setlocale que comprueba los valores de varios Variables de entorno , posiblemente incluyendo $ LC_MESSAGES y $ LANG . Para anular temporalmente el valor determinado, utilice esta opción para proporcionar una cadena de configuración regional directamente a hombre . Tenga en cuenta que no entrará en vigor hasta que comience realmente la búsqueda de páginas. Los resultados, como el mensaje de ayuda, siempre se mostrarán en la configuración regional determinada inicialmente. |
| -metro sistema [ , ...], --sistemas = sistema [ , ...] | Si este sistema tiene acceso a las páginas del manual de otros sistemas operativos, se puede acceder a ellas mediante esta opción. Para buscar una página de manual de (por ejemplo) la colección de páginas de manual 'NewOS', use la opción -m NewOS . El sistema especificado puede ser una combinación de nombres de sistemas operativos delimitados por comas. Para incluir una búsqueda de las páginas del manual del sistema operativo nativo, incluya el nombre del sistema hombre en la cadena de argumentos. Esta opción anulará la $ SYSTEM Variable ambiental. |
| -METRO camino , --manpath = camino | Especifique una ruta de acceso manual alternativa para usar. Esta opción anula la $ MANPATH Variable de entorno y opción de causas -metro para ser ignorado. Una ruta especificada como ruta de manual debe ser la raíz de una jerarquía de páginas de manual estructurada en secciones como se describe en el man-db manual (en 'El sistema de página del manual'). Para ver páginas de manual fuera de dichas jerarquías, consulte la -l opción. |
| -S lista , -s lista , --secciones = lista | La lista es una lista separada por dos puntos o comas de secciones manuales 'específicas de orden' para buscar. Esta opción anula la $ MANSECT Variable ambiental. (La -s la ortografía es para compatibilidad con System V). |
| -es sub-extensión , --extension = sub-extensión | Algunos sistemas incorporan grandes paquetes de páginas de manual, como las que acompañan al paquete Tcl, en la jerarquía principal de páginas de manual. Para solucionar el problema de tener dos páginas de manual con el mismo nombre, como salir, el Tcl por lo general, todas las páginas se asignaban a la sección l (L minúscula). Sin embargo, ahora es posible poner las páginas en la sección correcta y asignarles una 'extensión' específica, en este caso, salir (3tcl) . En funcionamiento normal, hombre muestra Salida en preferencia a salir (3tcl) . Para negociar esta situación y evitar tener que saber en qué sección reside la página que necesita, ahora es posible dar hombre una cadena de subextensión que indica el paquete de la página. Usando el ejemplo anterior, proporcionando la opción -e tcl a hombre restringirá la búsqueda a páginas que tengan una extensión de * tcl . |
| -I , --ignorar caso | Ignore las mayúsculas y minúsculas al buscar páginas de manual. Esta opción es la predeterminada. |
| -I , - estuche de emparejamiento | Buscar páginas de manual sensible a mayúsculas y minúsculas . |
| --regex | Muestre todas las páginas con cualquier parte de sus nombres o sus descripciones que coincidan con cada argumento de página como una expresión regular, como con a propósito . Dado que generalmente no hay una forma razonable de elegir una 'mejor' página cuando se busca una expresión regular, esta opción implica -a . |
| --comodín | Muestre todas las páginas con cualquier parte de sus nombres o sus descripciones que coincidan con cada argumento de página usando estilo shell comodines , Al igual que con apropos - tarjeta salvaje . El argumento de la página debe coincidir con el nombre completo o la descripción, o coincidir con los límites de palabras en la descripción. Dado que normalmente no existe una forma razonable de elegir una 'mejor' página al buscar un comodín, esta opción implica -a . |
| --sólo nombres | Si el --regex o --comodín se utiliza la opción, coincida solo con nombres de página, no con descripciones de página, como con whatis. De lo contrario, esta opción no tiene ningún efecto. |
| -a , --todas | Por defecto, hombre saldrá después de mostrar la página de manual más adecuada que encuentre. El uso de esta opción obliga hombre para mostrar todas las páginas del manual con nombres que coincidan con los criterios de búsqueda. |
| -u , --actualizar | Esta opción provoca hombre para realizar una comprobación de coherencia a nivel de inodo en su base de datos cachés para garantizar que sean una representación precisa de los sistema de archivos . Solo tendrá un efecto útil si hombre se instala con el setuid un poco colocar. |
| --no-subpáginas | Por defecto, hombre intentará interpretar pares de nombres de páginas de manual dados en el línea de comando como equivalente a un solo nombre de página de manual que contiene un guión o un guión bajo. Esto admite el patrón común de programas que implementan una serie de subcomandos, lo que les permite proporcionar páginas de manual para cada uno a las que se puede acceder utilizando una sintaxis similar a la que se utilizaría para invocar los propios subcomandos. Por ejemplo, el comando: man [-C file ] [-d] [-D] [--warnings[= warnings ]] [-R encoding ] [-L locale ] [-m system [,...]] [-M path ] [-S list ] [-e extension ] [-i|-I] [--regex|--wildcard] [--names-only] [-a] [-u] [--no-subpages] [-P pager ] [-r prompt ] [-7] [-E encoding ] [--no-hyphenation] [--no-justification] [-p string ] [-t] [-T[ device ]] [-H[ browser ]] [-X[ dpi ]] [-Z] [[ section ] page ...] ...muestra la página del manual: man -k [ apropos options ] regexp ...Para deshabilitar este comportamiento, use el --no-subpáginas opción. Por ejemplo: man -K [-w|-W] [-S list ] [-i|-I] [--regex] [ section ] term ...en su lugar, mostrará las páginas del manual para ambos ir y diff : |_+_| |
Opciones: Control de salida formateada
| -PAG buscapersonas , --pager = buscapersonas | Especifique qué buscapersonas de salida utilizar. Por defecto, hombre usos pager -s . Esta opción anula la $ MANPAGER variable de entorno, que a su vez anula la $ PAGER Variable ambiental. No se utiliza junto con -F o -a . El valor puede ser un nombre de comando simple o un comando con argumentos, y puede usar comillas de shell (barras invertidas, comillas simples o comillas dobles). No puede utilizar tuberías para conectar varios comandos; si lo necesita, use un script de envoltura, que puede tomar el archivo para mostrarse como un argumento o en entrada estándar . | ||||||||||||||||||||
| -r inmediato , --prompt = inmediato | Si una versión reciente de menos se utiliza como buscapersonas, hombre intenta establecer su aviso y algunas opciones sensatas. El indicador predeterminado se ve así: man -f [ whatis options ] page ......dónde nombre indica el nombre de la página del manual, segundo denota la sección en la que se encontró y x el número de línea actual. Esto se logra utilizando el $ MENOS Variable ambiental. Abastecimiento -r con una cadena anula este valor predeterminado. La cuerda puede contener el texto $ MAN_PN que se expande al nombre de la página del manual actual y el nombre de su sección rodeado por ' ( ' y ' ) '. La cadena utilizada para producir el valor predeterminado podría expresarse como man -l [-C file ] [-d] [-D] [--warnings[=warnings]] [-R encoding] [-L locale ] [-P pager ] [-r prompt ] [-7] [-E encoding ] [-p string ] [-t] [-T[ device ]] [-H[ browser ]] [-X[ dpi ]] [-Z] file ...Aquí se divide en tres líneas solo por motivos de legibilidad. Para conocer su significado, consulte el manual de menos . La cadena de comandos primero es evaluada por el shell. Todas las comillas dobles, las comillas inversas y las barras diagonales invertidas en el indicador deben tener un escape con una barra invertida anterior. La cadena de solicitud puede terminar en un escape $ que puede ir seguido de otras opciones para menos . Por defecto, hombre establece el -ix8 opciones. Si quieres anular hombre procesamiento de la cadena de solicitud por completo, utilice el $ SIN HOMBRE variable de entorno que se describe a continuación. | ||||||||||||||||||||
| -7 , --ascii | Al ver un puro ASCII página de manual en un terminal de 7 bits o un emulador de terminal, es posible que algunos caracteres no se muestren correctamente al utilizar el latin1 descripción del dispositivo con GNU nroff. Esta opción permite que las páginas del manual ASCII puro se muestren en ASCII con la latin1 dispositivo. No traducirá ninguna latin1 texto. La siguiente tabla muestra las traducciones realizadas: algunas partes solo pueden mostrarse correctamente cuando se usa GNU nroff 's latin1 dispositivo.
Esta opción se ignora cuando se usan opciones -t , -H , -T , o -CON y puede ser inútil para versiones de nroff que no sean de GNU. | ||||||||||||||||||||
| -ES codificacion , --encoding = codificacion | Genere una salida para una codificación de caracteres distinta a la predeterminada. Para compatibilidad con versiones anteriores, la codificación puede ser una nroff dispositivo como ascii , latin1 , o utf8 así como una verdadera codificación de caracteres como UTF-8 . | ||||||||||||||||||||
| --no-guiones , --Nueva Hampshire | Normalmente, nroff dividirá automáticamente el texto en los saltos de línea incluso en palabras que no contengan guiones, si es necesario hacerlo para colocar las palabras en una línea sin espacios excesivos. Esta opción deshabilita la división automática, por lo que las palabras solo se dividirán si ya contienen guiones. Si está escribiendo una página de manual y desea evitar nroff de dividir una palabra en un punto inapropiado, no use esta opción, pero consulte el nroff documentación en su lugar; por ejemplo, puedes poner ' \% 'dentro de una palabra para indicar que puede estar dividida con guión en ese punto, o poner' \% 'al comienzo de una palabra para evitar que se separe con guión. | ||||||||||||||||||||
| --no-justificación , --Nueva Jersey | Normalmente, nroff automáticamente justificará el texto en ambos márgenes. Esta opción deshabilita la justificación completa, dejando la justificación solo en el margen izquierdo, a veces llamado texto 'irregular a la derecha'. Si está escribiendo una página de manual y desea evitar nroff para justificar ciertos párrafos, no utilice esta opción, pero consulte el nroff documentación en su lugar; por ejemplo, puede usar el ' .en ', ' .nf ', ' .ser ', y ' .a 'solicita deshabilitar temporalmente el ajuste y el llenado. | ||||||||||||||||||||
| -pag cuerda , --preprocesador = cuerda | Especifique la secuencia de preprocesadores que se ejecutarán antes nroff o troff / groff . No todas las instalaciones tendrán un conjunto completo de preprocesadores. Algunos de los preprocesadores y las letras que se utilizan para designarlos son: eqn ( es ), broma ( gramo ), Foto ( pag ), tbl ( t ), vgrind ( v ), consulte ( r ). Esta opción anula la $ MANROFFSEQ Variable ambiental. zsoelim siempre se ejecuta como el primer preprocesador. | ||||||||||||||||||||
| -t , --troff | Usar groff -mandoc para formatear la página del manual a salida estándar. Esta opción no es necesaria junto con -H , -T , o -CON . | ||||||||||||||||||||
| -T [ dispositivo ], --dispositivo de troff [ = dispositivo ] | Esta opción se usa para cambiar groff (o posiblemente troff 's) para que sea adecuada para un dispositivo que no sea el predeterminado. Eso implica -t . Ejemplos incluyen dos , latin1 , ps , utf8 , X75 y X100 . | ||||||||||||||||||||
| -H [ navegador ], --html [ = navegador ] | Esta opción causará groff para producir HTML salida, y mostrará esa salida en un navegador web . La elección del navegador está determinada por el argumento del navegador opcional, si se proporciona uno, por el $ NAVEGADOR variable de entorno, o por un valor predeterminado en tiempo de compilación si no está establecido (generalmente lynx). Esta opción implica -t , y solo funcionará con GNU troff . | ||||||||||||||||||||
| -X [ dpi ], --gxditview [ = dpi ] | Esta opción muestra la salida de groff en una ventana gráfica usando el gxditview programa. La dpi (puntos por pulgada) puede ser 75 , 75-12 , 100 , o 100-12 , por defecto a 75 ; la -12 las variantes utilizan una base de 12 puntos hacen . Esta opción implica -T con el dispositivo X75, X75-12, X100 o X100-12, respectivamente. | ||||||||||||||||||||
| -CON , --ditroff | groff se ejecutará troff y luego use un postprocesador apropiado para producir una salida adecuada para el dispositivo elegido. Si groff -mandoc es groff , esta opción se pasa a groff y suprimirá el uso de un postprocesador. Eso implica -t . |
Números de sección
Los números de sección del manual se enumeran a continuación. Mientras lee la documentación, si ve el nombre de un comando seguido de un número entre paréntesis, el número se refiere a una de estas secciones. Por ejemplo, hombre es la documentación de hombre encontrado en la sección número 1 . Algunos comandos pueden tener documentación en más de una sección, por lo que los números después del nombre del comando pueden dirigirlo a la sección correcta para encontrar un tipo específico de información.
Los números de sección y los temas que cubren son los siguientes:
| sección # | tema |
|---|---|
| 1 | Ejecutable programas o comandos de shell |
| 2 | Llamadas al sistema ( funciones proporcionado por el kernel) |
| 3 | Llamadas a la biblioteca (funciones dentro de las bibliotecas de programas) |
| 4 | Archivos especiales (generalmente se encuentran en / dev ) |
| 5 | Convenciones y formatos de archivo, p. Ej. / etc / passwd |
| 6 | Juegos |
| 7 | Varios (incluido macro paquetes y convenciones), por ejemplo, hombre , groff |
| 8 | Comandos de administración del sistema (generalmente solo para raíz ) |
| 9 | Núcleo rutinas [No estándar] |
Estado de salida
Cuando termina, hombre devolverá uno de los siguientes estados de salida:
| 0 | Devuelto tras la ejecución exitosa del programa. |
| 1 | Devuelto si hubo un error de uso, sintaxis o archivo de configuración. |
| 2 | Devuelto si hubo un error operativo. |
| 3 | Se devuelve si un proceso hijo devolvió un estado de salida distinto de cero. |
| 16 | Se devuelve si una o más de las páginas, archivos o palabras clave buscadas no existían o no coincidían. |
Ambiente
hombre hace uso de lo siguiente Variables de entorno :
| MANPATH | Si $ MANPATH está configurado, su valor se utiliza como la ruta para buscar páginas de manual. |
| MANROFFOPT | Los contenidos de $ MANROFFOPT se agregan a la línea de comando cada vez hombre invoca el formateador (nroff, troff o groff ). |
| MANROFFSEQ | Si $ MANROFFSEQ está configurado, su valor se utiliza para determinar el conjunto de preprocesadores que deben pasar por cada página del manual. La lista de preprocesadores predeterminada depende del sistema. |
| MANSECT | Si $ MANSECT está establecido, su valor es una lista de secciones delimitada por dos puntos y se utiliza para determinar qué secciones manuales buscar y en qué orden. |
| ADMINISTRADOR , BUSCAPERSONAS | Si $ MANPAGER o $ PAGER Está establecido ( $ MANPAGER se utiliza con preferencia), su valor se utiliza como el nombre del programa utilizado para mostrar la página del manual. Por defecto, pager -s se utiliza. El valor puede ser un nombre de comando simple o un comando con argumentos, y puede usar comillas de shell (barras invertidas, comillas simples o comillas dobles). No puede utilizar tuberías para conectar varios comandos; si lo necesita, use un script de envoltura, que puede tomar el archivo para mostrarse como un argumento o en entrada estándar . |
| SIN HOMBRE | Si $ SIN HOMBRE está configurado, man no realizará ninguno de sus procesos habituales para configurar una cadena de menos buscapersonas. En cambio, el valor de $ SIN HOMBRE se copiará literalmente en $ MENOS . Por ejemplo, si desea establecer la cadena de solicitud incondicionalmente en 'mi cadena de solicitud', establezca $ SIN HOMBRE a ' -Secuencia de solicitud de Psmy ’. |
| NAVEGADOR | Si $ NAVEGADOR está configurado, su valor es una lista de comandos delimitada por dos puntos, cada uno de los cuales, a su vez, se usa para intentar iniciar un navegador web para hombre --html . En cada comando, %s se reemplaza por un nombre de archivo que contiene la salida HTML de groff , %% se reemplaza por un solo signo de porcentaje ( % ), y %c se reemplaza por dos puntos ( : ). |
| SISTEMA | Si $ SYSTEM está establecido, tendrá el mismo efecto que si se hubiera especificado como argumento de la -metro opción. |
| MANOPT | Si $ MANOPT está configurado, se analizará antes de hombre línea de comandos y se espera que tenga un formato similar. Como todas las demás variables de entorno específicas de man pueden expresarse como opciones de línea de comando y, por lo tanto, son candidatas para ser incluidas en $ MANOPT se espera que se vuelvan obsoletos. Nota: todos los espacios que deben interpretarse como parte del argumento de una opción deben tener un escape (precedidos por una barra invertida). |
| ANCHO DE MANO | Si $ ANCHO DE HOMBRE está configurado, su valor se utiliza como la longitud de línea para la que se deben formatear las páginas del manual. Si no está configurado, las páginas del manual se formatearán con una longitud de línea apropiada para el terminal actual (usando un ioctl si está disponible, el valor de $ COLUMNAS , o retrocediendo a 80 caracteres si ninguno está disponible). gato las páginas solo se guardarán cuando se pueda utilizar el formato predeterminado, es decir, cuando la longitud de la línea del terminal esté entre 66 y 80 caracteres. |
| MAN_KEEP_FORMATTING | Normalmente, cuando la salida no se dirige a una terminal (como un archivo o una tubería), los caracteres de formato se descartan para facilitar la lectura del resultado sin herramientas especiales. Sin embargo, si $ MAN_KEEP_FORMATTING se establece en cualquier valor no vacío, estos caracteres de formato se conservan. Esto puede ser útil para envoltorios de hombre que puede interpretar caracteres de formato. |
| MAN_KEEP_STDERR | Normalmente, cuando la salida se dirige a una terminal (generalmente a un buscapersonas), cualquier salida de error del comando utilizado para producir versiones formateadas de páginas de manual se descarta para evitar interferir con la pantalla del buscapersonas. Programas como groff a menudo producen mensajes de error relativamente menores sobre problemas tipográficos, como una mala alineación, que son antiestéticos y generalmente confusos cuando se muestran junto con la página del manual. Sin embargo, es posible que desee verlos de todos modos, así que si $ MAN_KEEP_STDERR se establece en cualquier valor que no esté vacío, la salida de error se mostrará como de costumbre. |
| LANG , LC_MESSAGES | Dependiendo del sistema y la implementación, uno o ambos $ LANG y $ LC_MESSAGES será interrogado por la ubicación actual del mensaje. hombre mostrará sus mensajes en esa configuración regional (si está disponible). |
Archivos
Los siguientes archivos son utilizados por hombre :
| /etc/manpath.config | La man-db archivo de configuración. |
| / usr / share / man | Una jerarquía global de páginas de manual. |
| / usr / share / man / index. ( bt | db | para ti | pag ) | Una caché de base de datos de índice global tradicional. |
| / var / cache / man / index. ( bt | db | para ti | pag ) | Una caché de base de datos de índice global compatible con FHS. |
Ejemplos de
|_+_|Ver la página del manual para hombre mando.
|_+_|Ver la página del manual para hombre , sin palabras con guiones ni líneas justificadas.
Comandos relacionados
a propósito - Busque en las páginas del manual una palabra clave o expresión regular.
info - Leer documentos de información.
que es - Mostrar descripciones breves de las páginas del manual.