NAME
viro - formato kaj montri la retpaĝajn manlibrojn
manpath - determini la serĉpostilon de uzanto por homaj paĝoj
SYNOPSIS
viro [ -acdfFhkKtwW ] [ --path ] [ -m- sistemo ] [ -p- kordo ] [ -C- config_file ] [ -Ma paleta listo ] [ -Paĝilo ] [ -S- sekcio_list ] [ sekcio ] nomo ...
PRISKRIBO
Homaj formatoj kaj montras la enretajn manlibrojn. Se vi specifas sekcion , nur homo aspektas en tiu sekcio de la manlibro. nomo estas kutime la nomo de la manlibro, kiu estas tipe la nomo de komando, funkcio aŭ dosiero. Tamen, se la nomo enhavas slash ( / ) tiam la homo interpretas ĝin kiel dosieran specifon, por ke vi povu fari homon ./foo.5 aŭ eĉ homo /cd/foo/bar.1.gz .
Vidu sube por priskribo de kie viro serĉas la manlibro-dosierojn.
Obloj
-C config_file
Specifi la agordon-dosieron por uzi; la defaŭlta estas /etc/man.config . (Vidu man.conf (5).)
-M vojo
Specifi la liston de dosierujoj por serĉi homajn paĝojn. Apartigu la dosierujojn kun kolonoj. Malplena listo estas la sama, kiu ne specifas -M tute. Vidi SEARCH-AŬRONONONON POR MANAJ PAGOJ .
-Paĝilo
Indiku, kiun paĝisto uzu. Ĉi tiu opcio anstataŭigas la variablon de MANPAGER- medio, kiu siavice anstataŭigas la variablon de PAGERO . Defaŭlte, homo uzas / usr / bin / less -isr .
-S sekcio_list
Listo estas kolono apartigita listo de manlibroj por serĉi. Ĉi tiu opcio anstataŭigas la variablon de MANSECT- medio.
-a
Defaŭlte, la homo foriros post montri la unuan manlibron, kiun ĝi trovas. Uzante ĉi tiun opcion devigas homon montri ĉiujn manlibrojn, kiuj kunigas nomon, ne nur la unuan.
-c
Reformu la paĝon de fonto, eĉ kiam ekzistas ĝisdatigita kato paĝo . Ĉi tio povas esti grava se la kato-paĝo estis formatebla por ekrano kun malsama nombro da kolumnoj, aŭ se la paĝo antaŭformita estas difektita.
-d
Ne efektive montru la homajn paĝojn, sed pruvi preskribojn pri elpurigado de informoj.
-D
Ambaŭ montriĝas kaj presas elpurigi informojn.
-f
Ekvivalenta al kio .
-F aŭ --preformat
Formato nur - ne montriĝas.
-h
Printu unu-linia helpo-mesaĝon kaj eliradon.
-k
Ekvivalenta al apropos .
-K
Serĉu la specifitan ĉenon en * ĉiuj * homaj paĝoj. Averto: ĉi tio verŝajne estas tre malrapida! Ĝi helpas specifi sekcion. (Nur por doni malĝustan ideon, sur mia maŝino ĉi tio prenas proksimume minuton por 500 paĝoj.)
-m-sistemo
Indiku alternativan aron de homaj paĝoj por serĉi laŭ la nomo de la sistemo.
-p-kordo
Specifi la sekvencon de preprocesoroj por kuri antaŭ nroff aŭ troff . Ne ĉiuj instalaĵoj havos plenan aron de preprocesiloj. Iuj el la preprocesiloj kaj la literoj uzataj por nomumi ilin estas: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Ĉi tiu opcio anstataŭigas la varion de medio MANROFFSEQ .
-t
Uzu / usr / bin / groff -Tps -mandoc por formati la manlibron, pasante la eliron al stdout. La eligo de / usr / bin / groff -Tps -mandoc eble necesos pasi per iu filtrilo aŭ alia antaŭ presi.
-w aŭ -path
Ne efektive montru la homajn paĝojn, sed presi la lokon (j) de la dosieroj, kiuj estus formateblaj aŭ montritaj. Se neniu argumento estas donita: montru (sur stdout) la liston de dosierujoj, kiujn oni serĉas la homojn por la paĝoj de homoj. Se manpath estas ligo al homo, tiam "manpat" estas ekvivalenta al "homo - path".
-W
Kiel -w, sed presi dosiernomoj unu per linio, sen pliaj informoj. Ĉi tio estas utila en ŝlosilaj komandoj kiel homo-homo xargs ls -l
CAT PAGOJ
Homo provos savi la formatajn homajn paĝojn, por konservi formatan tempon la venontan fojon ĉi tiuj paĝoj estas bezonataj. Tradicie, formatoj de paĝoj formateblaj en DIR / manX savas en DIR / catX, sed aliaj mapigoj de homo dir to cat dir povas esti specifitaj en /etc/man.config . Neniu kato paĝoj konserviĝas kiam la postulata katalogo ne ekzistas. Neniu kato-paĝoj estas konservitaj kiam ili estas formatigitaj por linio longo malsama de 80. Neniu kato paĝoj konserviĝas kiam man.conf enhavas la linion NOCACHE.
Eblas fari homon al viro uzanto. Tiam, se kata dosierujo havas posedanton kaj modon 0755 (nur skribebla de homo), kaj la katoj-dosieroj havas posedulon kaj modon 0644 aŭ 0444 (nur skribebla de homo, aŭ ne skribebla), neniu ordinara uzanto povas ŝanĝi la katoj aŭ aldonu aliajn dosierojn en la katalogo. Se homo ne estas farita, tiam kataloga adresaro devus havi modon 0777 se ĉiuj uzantoj devas lasi katojn tie.
La opcio -c devigas reformatigi paĝon, eĉ se freŝa kata paĝo ekzistas.
Serĉi paŝon por manlibroj
viro uzas kompleksan metodon por trovi manlibro-dosierojn, surbaze de la alvokaj opcioj kaj mediaj variabloj, la dosierujo /etc/man.config-agordo , kaj iujn konstruitajn en konvencioj kaj heŭreismoj.
Antaŭ ĉio, kiam la nomo- argumento al homo enhavas slash ( / ), la homo supozas ke ĝi estas dosiero-specifigo, kaj ne ekzistas serĉado.
Sed en la normala kazo, kie nomo ne enhavas slash, la homo serĉas diversajn dosierujojn por dosiero, kiu povus esti manlibro por la temo nomata.
Se vi specifas la -listlist- opcion, pathlist estas listo de kolonoj apartigitaj de la dosierujoj kiujn vi serĉas.
Se vi ne specifas -M sed agordi la variablon de MANPATH- medio, la valoro de tiu variablo estas la listo de la adresaroj, kiujn vi serĉas.
Se vi ne specifas eksplicitan vojliston kun -M aŭ MANPATH , homo evoluigas sian propran liston laŭ la enhavo de la agorda dosiero /etc/man.config . La deklaroj de MANPATH en la agorda dosiero identigas apartajn dosierujojn por inkluzivi en la serĉa vojo.
Krome, la deklaroj MANPATH_MAP aldonas al la serĉpuro dependante de via komandila serĉo (tio estas, via variablo de PATH- medio). Por ĉiu dosierujo, kiu povas esti en la komandila serĉo, MANPATH_MAP- aserto specifas dosierujon, kiu devus esti aldonita al la serĉpuro por manlibro-dosieroj. viro rigardas la PATH- variablon kaj aldonas la respondajn dosierujojn al la manlibro-paĝa serĉa vojo. Tiel, kun la konvena uzo de MANPATH_MAP , kiam vi elsendas la komandan homon xyz , vi ricevos manlibron por la programo, kiu funkcios, se vi elsendis la komandon xyz .
Krome, por ĉiu dosierujo en la komando serĉo-vojo (ni nomos ĝin "komandosierujo"), por kiu vi ne havas MANPATH_MAP- deklaron, la homo aŭtomate serĉas manlibron de paĝaj dosierujoj "proksime", nome kiel subdosierujo en la komando dosierujon mem aŭ en la gepatra adresaro de la komando dosierujo.
Vi povas malŝalti la aŭtomatan "proksima" serĉojn per inkluzivanta NOAUTOPATH- deklaron en /etc/man.config .
En ĉiu dosierujo en la serĉpuro kiel priskribita supre, la homo serĉas dosieron nomatan temon . sekcio , kun laŭvola sufikso en la sekcio-numero kaj eble kunprema sufikso. Se ĝi ne trovas tian dosieron, ĝi tiam aspektas en iuj subdosierujoj nomataj viro N aŭ kato N kie N estas la mana sekcio-nombro. Se la dosiero estas en kato N- subdirectorio, la homo supozas ke ĝi estas formatita manlibro-dosiero-dosiero (paĝo de kato). Alie, homo supozas, ke ĝi estas neformata. En ĉiu kazo, se la dosiernomo havas konatan sufiksitan sufikson (kiel .gz ), la homo supozas, ke ĝi estas gzipita.
Se vi volas vidi, kie (aŭ se) homo trovos la manlibron por aparta temo, uzu la --path ( -w ) opcion.
Grava: Uzu la komandon ( % viro ) por vidi kiel komando estas uzata en via komputilo.