Home - Comando Linux - Comando Unix

NAME

man - format e amosar as páxinas manuais en liña
manpath - determine a ruta de busca do usuario para as páxinas man

SINOPSE

home [ -acdfFhkKtwW ] [ --path ] [ -m sistema ] [ -p cadea ] [ -C config_file ] [ -M pathlist ] [ -P buscador ] [ -S sección_list ] [ sección ] nome ...

DESCRICIÓN

man e mostra as páxinas de manual en liña. Se especifica a sección , o home só ve nesa sección do manual. O nome normalmente é o nome da páxina de manual, que normalmente é o nome dun comando, función ou ficheiro. Non obstante, se o nome contén unha barra ( / ), o home o interpreta como unha especificación de ficheiro, para que poida facer o home / .5 ou mesmo o home /cd/foo/bar.1.gz .

Vexa a continuación para obter unha descrición de onde o home busca os ficheiros de páxina manuais.

OPCIÓNS

-C config_file

Especifique o ficheiro de configuración a usar; o valor predeterminado é /etc/man.config . (Vexa man.conf (5).)

-M ruta

Especifique a lista de directorios para buscar páxinas man. Separa os directorios con colóns. Unha lista baleira é a mesma que non especifica -M en absoluto. Consulte CAMIÑO DE PÁXAS MANUALES .

-P buscador

Especifique o buscapersoal a usar. Esta opción anula a variable de ambiente MANPAGER , que á súa vez anula a variable PAGER . Por defecto, o home usa / usr / bin / less -isr .

-S sección_list

A lista é unha lista separada por dous puntos das seccións manuais para buscar. Esta opción anula a variable de ambiente MANSECT .

-a

Por defecto, o home sairá despois de mostrar a primeira páxina de manual que atopa. Usando esta opción obriga ao home a mostrar todas as páxinas de manual que coinciden co nome, e non só o primeiro.

-c

Reformate a páxina do home de orixe, mesmo cando existe unha páxina de gato actualizada. Isto pode ser significativo se a páxina do gato foi formateada para unha pantalla cun número diferente de columnas ou se a páxina preformateada está mal.

-d

Non mostre as páxinas do manual, pero imprime as copias da información de depuración.

-D

Mostra e elimina información de depuración.

-f

Equivalente ao whatis .

-F ou --preformato

Só o formato - non se amosa.

-h

Imprimir unha mensaxe de axuda dunha liña e saír.

-k

Equivalente a apropos .

-K

Busca a cadea especificada en * todas as páxinas man. Aviso: isto pode ser moi lento. Axuda a especificar unha sección. (Só para dar unha idea aproximada, na miña máquina isto leva aproximadamente un minuto por cada 500 páxinas manuais).

-m sistema

Especifique un conxunto alternativo de páxinas man para buscar en función do nome do sistema indicado.

-p cadea

Especifique a secuencia de preprocesadores para executar antes do nroff ou troff . Non todas as instalacións terán un conxunto completo de preprocesadores. Algúns dos preprocesadores e as letras utilizadas para designalos son: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Esta opción anula a variable de ambiente MANROFFSEQ .

-t

Use / usr / bin / groff -Tps -mandoc para formatear a páxina de manual, pasando a saída a stdout. A saída de / usr / bin / groff -Tps -mandoc pode necesitar ser pasada por algún filtro ou outra antes de ser impreso.

-w ou - ruta

Non mostre realmente as páxinas do manual, pero imprime a (s) localización (s) dos ficheiros que se formatarían ou mostrarían. Se non se fornece ningún argumento: amosar (en stdout) a lista de directorios que se busca no home para as páxinas man. Se manpath é unha ligazón ao home, entón "manpath" equivale a "man - path".

-W

Do mesmo xeito que -w, pero imprimir os nomes dos ficheiros un por liña, sen información adicional. Isto é útil nos comandos shell como home -aW man | xargs ls -l

PÁXINAS CAT

O home tentará gardar as páxinas man formateadas, para gardar o tempo de formato a próxima vez que se precisen estas páxinas. Tradicionalmente, as versións con formato de páxinas en DIR / manX gárdanse en DIR / catX, pero outras asignacións de dir dir ao dir do can poden especificarse en /etc/man.config . Non se gardan páxinas de cat cando o directorio de cat requerido non existe. Non se gardan páxinas de cat cando están formateadas para unha lonxitude de liña distinta de 80. Non se gardan páxinas de cat cando man.conf contén a liña NOCACHE.

É posíbel facer o home suid a un home de usuario. Entón, se un directorio de cat ten o home propietario e o modo 0755 (só pode escribilo polo home), e os ficheiros de gato teñen o home propietario e modo 0644 ou 0444 (só pode escribilo polo usuario ou non se pode escribir nada), ningún usuario normal pode cambiar páxinas de gato ou pór outros ficheiros no directorio de cat. Se o home non está configurado, entón un directorio de cat debe ter o modo 0777 se todos os usuarios deben poder deixar as páxinas de gato alí.

A opción -c forxa reformatar unha páxina, aínda que exista unha páxina recente de gatos.

CAMIÑO DE CAMBIOS PARA PÁX. MANUALES

O home usa un método sofisticado para atopar ficheiros de páxina manual, en función das opcións de invocación e variables de entorno, o ficheiro de configuración /etc/man.config e algunhas construídas en convencións e heurísticas.

Primeiro de todo, cando o argumento de nome para o home contén unha barra ( / ), o home asume que é unha especificación de arquivo en si e non hai ningunha investigación implicada.

Pero no caso normal no que o nome non contén unha barra, o home busca unha variedade de directorios para un ficheiro que podería ser unha páxina manual para o tema chamado.

Se especifica a opción -M ruta de ruta , a lista de rutas é unha lista separada por dous puntos dos directorios que busca o home .

Se non especifica -M pero configure a variable de ambiente MANPATH , o valor desta variable é a lista dos directorios que busca o home .

Se non especifica unha lista de rutas explícita con -M ou MANPATH , o home desenvolve a súa propia lista de rutas en función dos contidos do ficheiro de configuración /etc/man.config . As instrucións MANPATH no ficheiro de configuración identifican determinados directorios para incluír na ruta de busca.

Ademais, as instrucións MANPATH_MAP engádense ao camiño de busca en función da súa ruta de busca de comandos (isto é, a súa variable de ambiente PATH ). Para cada directorio que pode estar no camiño de busca de comando, unha instrución MANPATH_MAP especifica un directorio que debería engadirse á ruta de busca para os ficheiros de páxina manual. O home mira a variable PATH e engade os directorios correspondentes á ruta de busca de ficheiros de páxina manual. Deste xeito, co uso correcto de MANPATH_MAP , cando emita o comando man xyz , obtén unha páxina manual para o programa que se executaría se emitiu o comando xyz .

Ademais, para cada directorio no camiño de busca de comandos (chamalo "directorio de comando") para o cal non ten unha declaración de MANPATH_MAP , o home busca automaticamente un directorio de páxina manual "próximo" ou sexa, como un subdirectorio no O directorio de comandos ou o directorio principal do directorio de comandos.

Pode desactivar as procuras automáticas "próximas", incluíndo unha declaración NOAUTOPATH en /etc/man.config .

En cada directorio do camiño de busca descrito anteriormente, o home busca un ficheiro chamado tema . sección , cun sufijo opcional no número da sección e posiblemente un sufijo de compresión. Se non atopa ese ficheiro, entón verase nalgún subdirectorio chamado home N ou cat N onde N é o número da sección manual. Se o ficheiro está nun subdirectorio de cat N , o home asume que é un ficheiro de páxina manual formatado (páxina de cat). Se non, o home asume que non está formatado. En calquera caso, se o nome de ficheiro ten un sufijo de compresión coñecido (como .gz ), o home asume que está gzipido.

Se queres ver onde (ou se) o home atoparía a páxina de manual para un tema en particular, use a opción --path ( -w ).

Importante: use o comando man ( % home ) para ver como se usa un comando na súa computadora particular.