Home - Comando Linux

home-acdfFhkKtwW --Camí -m sistema -p cadena -C config_file -M pathlist -P paginador -S section_list secció nom …

Opcions

-C config_file

Especifiqueu el fitxer de configuració que voleu utilitzar; el valor per defecte és/etc/man.config. (Veureman.conf(5).)

-M ruta

Especifiqueu la llista de directoris per cercar pàgines de manuals. Separeu els directoris amb els colons. Una llista buida és igual que no s'especifica-M en absolut. VeureRUTA DE CERQUES DE PÀGINES MANUALS.

-P locador

Especifiqueu quin pager voleu utilitzar. Aquesta opció invalida laMANPAGER variable d 'entorn, que al seu torn anul · la laPAGER variable. Per defecte,home usos/ usr / bin / less -isr.

-S section_list

La llista és una llista separada per punts de seccions manuals per cercar. Aquesta opció invalida laMANSECTvariable d'entorn.

-a

Per defecte,home sortirà després de mostrar la primera pàgina de manual que troba. L'ús d'aquesta opció obligahome per mostrar totes les pàgines de manual que coincideixennom,no només el primer.

-c

Reforma la pàgina d'origen del home, fins i tot quan existeix una pàgina actualitzada de gat. Això pot tenir sentit si la pàgina del gat s'ha formatat per a una pantalla amb un nombre diferent de columnes o si la pàgina preformatada està danyada.

-d

En realitat, no mostreu les pàgines de manual, però sí imprimiu les memòries d'informació de depuració.

-D

Tots dos mostren i imprimeixen informació de depuració.

-f

Equivalent aQuè és.

-F o--preformat

Format només - no es mostra.

-h

Imprimiu un missatge d'ajuda d'una línia i sortiu.

-k

Equivalent aapropos.

-K

Cerqueu la cadena especificada a les pàgines * all * man. Avís: probablement això sigui molt lent! Ajuda a especificar una secció. (Només per donar una idea aproximada, a la meva màquina això fa aproximadament un minut per cada 500 pàgines d'home).

-m sistema

Especifiqueu un conjunt alternatiu de pàgines d'usuari per cercar en funció del nom del sistema indicat.

-p cadena

Especifiqueu la seqüència de preprocessadors per executar abansnroff oTroff. No totes les instal·lacions tindran un conjunt complet de preprocessadors. Alguns dels preprocessadors i les lletres que s'utilitzen per designar-los són: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Aquesta opció invalida laMANROFFSEQ variable d'entorn.

-t

Ús/ usr / bin / groff-Tps-mandoc per donar format a la pàgina de manual, passant la sortida astdout. La sortida de/ usr / bin / groff-Tps-mandoc potser haurem de passar per un filtre o un altre abans d'imprimir-lo.

-wo - ruta

No mostri les pàgines man, però imprimiu les ubicacions dels fitxers que es formularan o mostraran. Si no es dóna cap argument: mostra (a la línia de sortida) la llista de directoris en què es buscahome per a pàgines d'home. Simanpath és un enllaç a l'home, llavors "manpath" equival a "home - path".

-W

Igual que -w, però imprimiu els noms d'un per línia, sense informació addicional. Això és útil en ordres de shell comhome -aW home | xargs ls -l

Pàgines de CAT

L'home intentarà guardar les pàgines man formateades, per tal de guardar el temps de format la propera vegada que es necessitin aquestes pàgines. Tradicionalment, les versions amb format de pàgines en DIR / manX es guarden a DIR / catX, però es poden especificar altres assignacions de dir d'home a dir./etc/man.config. No es guarden pàgines de cat quan el directori de cat necessari no existeix. No es guarden pàgines de cat quan es formatequen per una longitud de línia diferent de 80. No es guarden pàgines de cat quan man.conf conté la línia NOCACHE.

Es pot ferhome li correspon a un home usuari. A continuació, si un directori de cat té l'home propietari i la manera 0755 (només es pot escriure per l'home), i els fitxers de cat tenen l'home propietari i la modalitat 0644 o 0444 (només es pot escriure per l'home o no es pot escriure), cap usuari normal no pot canviar pàgines de gat o altres fitxers al directori de cat. Sihome no es fa suid, llavors un directori de cat hauria de tenir la manera 0777 si tots els usuaris han de poder deixar les pàgines de cat allà.

L'opció-c obliga a reformatar una pàgina, encara que hi hagi una pàgina de gat recent.

Ruta de cerca per a pàgines manuals

home utilitza un mètode sofisticat de trobar fitxers de pàgina manual, segons les opcions d 'invocació i les variables d' entorn, el/etc/man.configfitxer de configuració, i algunes convencions incorporades i heurístiques.

En primer lloc, quan el nom argument ahome conté una barra inclinada (/), home suposa que és una especificació de fitxer en si mateixa, i no hi ha cap cerca implicada.

Però en el cas normal on nom no conté una barra inclinada,home cerca una varietat de directoris per a un fitxer que podria ser una pàgina manual del tema anomenat.

Si especifiqueu el-M pathlist opció, pathlist és una llista separada per punts dels directoris quehomecerques.

Si no s'especifica-M però configureu elMANPATH variable d'entorn, el valor d'aquesta variable és la llista dels directoris quehome cerques.

Si no especifiqueu una llista de ruta explícita amb-M oMANPATH, home desenvolupa una llista de ruta pròpia basada en el contingut del fitxer de configuració/etc/man.config. ElMANPATH Les declaracions en el fitxer de configuració identifiquen determinats directoris per incloure en la ruta de cerca.

A més, elMANPATH_MAPLes declaracions s'agreguen a la ruta de cerca segons la vostra ruta de cerca d'ordres (p. exCAMÍvariable d'entorn). Per a cada directori que es pugui trobar a la ruta de cerca d'ordres, aMANPATH_MAP La instrucció especifica un directori que s'ha d'afegir a la ruta de cerca dels fitxers de pàgina manual.home mira elCAMÍ variable i afegeix els directoris corresponents a la ruta de cerca de fitxers de pàgina de manual. Per tant, amb l'ús adequat deMANPATH_MAP, quan emeti la comandahome xyz, obtindreu una pàgina de manual del programa que s'executaria si heu emès la comandaxyz.

A més, per a cada directori de la ruta de cerca d'ordres (anomenarem un "directori de comandaments") pel que feu no tenir unMANPATH_MAPdeclaració,home busca automàticament un directori de la pàgina manual "a prop", és a dir, com a subdirectori al propi directori d'ordres o al directori principal del directori d'ordres.

Podeu desactivar les cerques automàtiques "properes" incloent unNOAUTOPATH declaració a/etc/man.config.

A cada directori de la ruta de cerca tal com s'ha descrit anteriorment,home cerca un fitxer anomenat tema . secció , amb un sufix opcional al número de la secció i possiblement un sufix de compressió. Si no troba aquest tipus de fitxer, es visualitza en qualsevol subdirectori anomenathome N ogat N on N és el número de la secció manual. Si el fitxer es troba en ungat N subdirectori,home Suposa que és un fitxer de pàgina manual amb format (pàgina de cat). D'una altra manera,home Suposa que no està format. En qualsevol cas, si el nom del fitxer té un sufix de compressió conegut (com.gz), home se suposa que és gzip.

Si voleu veure on (o si)home Trobeu la pàgina de manual per a un tema concret, utilitzeu el--Camí(-w) opció.

Important: Utilitzar el home comandament ( % home ) per veure com s'utilitza una comanda a l'ordinador en particular.