NAME
man - formāts un parādīt tiešsaistes rokasgrāmatas lapas
manpath - noteikt lietotāja meklēšanas vaicājumu personāla lapām
SINOPSIS
Man [ -acdfFhkKtwW ] [ -path ] [ -m sistēma ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ sekcija ] nosaukums ...
APRAKSTS
Man formatē un parāda tiešsaistes rokasgrāmatas lapas. Ja norādāt sadaļu , cilvēks tikai aplūko šo rokasgrāmatas sadaļu. nosaukums parasti ir rokasgrāmatas lapas nosaukums, kas parasti ir komandas, funkcijas vai faila nosaukums. Tomēr, ja vārdam ir slīpsvītra ( / ), tad cilvēks to interpretē kā faila specifikāciju, lai jūs varētu darīt vīrieti ./foo.5 vai pat vīrieti /cd/foo/bar.1.gz .
Zemāk aprakstīts, kur cilvēks meklē manuālo lapu failus.
OPTIONS
-C config_file
Norādiet izmantojamo konfigurācijas failu; noklusējums ir /etc/man.config . (Skatīt man.conf (5).)
-M ceļš
Norādiet sarakstu ar direktorijām, kas meklē vīriešu lapas. Atdaliet mapes ar kolu. Tukšais saraksts ir tāds pats kā nenosakot -M vispār. Skatiet SEARCH PATH ROKASGRĀMATA .
-P peidžeris
Norādiet, kurš peidžeris jāizmanto. Šī opcija ignorē vides mainīgo MANPAGER , kas savukārt ignorē mainīgo PAGER . Pēc noklusējuma cilvēks izmanto / usr / bin / less -isr .
-S section_list
Saraksts ir kolu atdalīts saraksts ar manuālajām sadaļām, lai meklētu. Šī opcija ignorē MANSECT vides mainīgo.
-a
Pēc noklusējuma cilvēks iziet no tā, kad būs parādīta pirmā rokasgrāmata, kuru tā atrod. Izmantojot šo opciju, cilvēks spiež attēlot visas rokasgrāmatas lapas, kas atbilst vārdam, nevis tikai pirmajai.
-c
Pārformatējiet avota cilnes lapu, pat ja pastāv aktuāla kaķu lapa . Tas var būt nozīmīgi, ja kaķu lapa ir formatēta ekrānam ar atšķirīgu kolonnu skaitu vai ja iepriekš formatēta lapa ir bojāta.
-d
Faktiski netiek parādīti vīriešu lapas, bet izdrukā informāciju par atkļūdošanu.
-D
Gan rādīšanas un drukas atkļūdošanas informācija.
-f
Līdzvērtīgs jebkuram .
-F vai --formatēt
Tikai formāts - neuzrāda.
-h
Drukājiet vienas līnijas palīdzības paziņojumu un izejiet.
-k
Līdzvērtīgs.
-K
Meklēt norādīto virkni * all * man lapas. Brīdinājums: tas, iespējams, ir ļoti lēns! Tas palīdz norādīt sadaļu. (Lai sniegtu aptuvenu priekšstatu, uz manas mašīnas tas aizņem apmēram vienu minūti uz 500 cilvēku lapām.)
-m sistēma
Norādiet alternatīvu virknes manu lapu meklēšanu, pamatojoties uz norādīto sistēmas nosaukumu.
-p virkne
Norādiet preprocesoru secību, lai palaistu pirms nroff vai troff . Ne visām iekārtām būs pilns preprocesoru komplekts. Daži preprocesori un burti, ko izmanto, lai tos apzīmētu, ir šādi: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), atsauce (r). Šī opcija ignorē MANROFFSEQ vides mainīgo.
-t
Izmantojiet / usr / bin / groff -Tps -mandoc, lai formatētu manuālo lapu, nododot izeju stdout. Lai izvadi no / usr / bin / groff-Tps -mandoc pirms izdrukāšanas, iespējams, vajadzēs nokļūt caur kādu filtru vai citu.
-w vai - ceļš
Faktiski netiek parādīti vīriešu lapas, bet izdrukā formatējumu vai parādīto failu atrašanās vietu (-us). Ja nav norādīts neviens arguments: parādīt (stdout) to direktoriju sarakstu, kurus vīrietis meklēja par vīriešu lapām. Ja manpath ir saite uz cilvēku, tad "manpath" ir līdzvērtīgs "man - ceļam".
-W
Tāpat kā -w, bet izdrukājiet failu nosaukumus katrā rindiņā bez papildu informācijas. Tas ir noderīgi čaulas komandās, piemēram, man -aW man | xargs ls -l
CAT PAGES
Cilvēks mēģinās saglabāt formatētus vīriešu lapas, lai saglabātu formatēšanas laiku nākamajā reizē, kad šīs lapas ir vajadzīgas. Tradicionāli DIR / manX lappušu formatētās versijas tiek saglabātas DIR / catX, bet citas mapes no cilvēka režīma uz cat dir var norādīt /etc/man.config . Katra lappuse netiek saglabāta, ja nepieciešamais kaķu katalogs nepastāv. Katra lapa netiek saglabāta, kad tā ir formatēta līnijas garumam, kas atšķiras no 80. Katra lapa netiek saglabāta, ja man.conf satur līniju NOCACHE.
Ir iespējams izdarīt vīrieti suid lietotājam cilvēkam. Tad, ja kaķu direktorijā ir īpašnieka cilvēks un režīms 0755 (to var rakstīt tikai cilvēks), un kaķu failos ir īpašnieka cilvēks un režīms 0644 vai 0444 (tikai cilvēks var rakstīt vai rakstīt vispār), neviens parasts lietotājs nevar mainīt kaķu lapas vai nodod citus failus kaķu direktorijā. Ja cilvēks nav izgatavots suid, tad kaķu katalogam vajadzētu būt režīmam 0777, ja visiem lietotājiem būtu iespēja atstāt kaķu lapas tur.
Opcija -c prasa pārformatēt lapu, pat ja pastāv pēdējā kaķu lapa.
MEKLĒŠANAS TĪKLS ROKASGRĀMATA
cilvēks izmanto sarežģītu metodi, kā atrast manuālu lapu failus, pamatojoties uz izsaukuma opcijām un vides mainīgajiem, konfigurācijas faila /etc/man.config un dažām iebūvētām konvencijām un heuristics.
Pirmkārt, ja vārda argumentam cilvēkam ir slīpsvītra ( / ), cilvēks pieņem, ka tas ir pašas faila specifikācija, un tajā nav iesaistīta meklēšana.
Taču normālā gadījumā, ja vārds nesatur slīpsvītru, vīrietis meklē dažādus direktorijus failam, kas varētu būt manuālas tēmas nosaukumam.
Ja norādāt opciju -M pathlist , ceļš ir kolekcija, kas ir atdalīta ar to direktoriju sarakstu, kuru vīrietis meklē.
Ja jūs nenorādāt -M, bet iestatījis MANPATH vides mainīgo, šī mainīgā vērtība ir to direktoriju saraksts, kurus cilvēks meklē.
Ja jūs neprecizējat nepārprotamu ceļa sarakstu ar -M vai MANPATH , cilvēks izstrādā savu ceļu sarakstu, pamatojoties uz konfigurācijas faila /etc/man.config saturu . MANPATH paziņojumi konfigurācijas failā identificē konkrētus direktorijus, kas jāiekļauj meklēšanas ceļos.
Turklāt MANPATH_MAP paziņojumi papildina meklēšanas ceļu atkarībā no komandas meklēšanas ceļa (ti, jūsu PATH vides mainīgais). Par katru direktoriju, kas var būt komandu meklēšanas ceļš, MANPATH_MAP paziņojums norāda direktoriju, kas būtu jāpievieno meklēšanas ceļam manuālajiem lapu failiem. cilvēks aplūko PATH mainīgo un pievieno atbilstošos direktorijus manuālajai lappuses faila meklēšanas ceļam. Tādējādi, pareizi izmantojot MANPATH_MAP , kad jūs izsniedzat komandu man xyz , jūs saņemat manuālo lapu programmai, kas darbosies, ja izsniegsit komandu xyz .
Turklāt katram direktoram komandu meklēšanas ceļā (mēs to sauksim par "komandu direktoriju"), kuram nav MANPATH_MAP paziņojuma, cilvēks automātiski meklē rokasgrāmatas lappušu direktoriju "tuvumā", proti, kā apakšdirektoriju Komandu direktorija pati vai komandu direktorijas vecākajā direktorijā.
Jūs varat atspējot automātiskos "tuvumā esošos" meklēšanas vaicājumus, iekļaujot NOAUTOPATH paziņojumu vietnē /etc/man.config .
Katrā direktorijā meklēšanas ceļā, kā aprakstīts iepriekš, cilvēks meklē failu ar nosaukumu topic . sadaļā ar izvēles piedēkli sadaļas numuru un, iespējams, kompresijas piedēkli. Ja tas neatrod šādu failu, pēc tam viņš apskata jebkuru apakšdirektoriju ar nosaukumu cilvēks N vai kaķis N, kur N ir rokasgrāmatas nodaļas numurs. Ja fails atrodas kaķu N apakšdirektorijā, lietotājs pieņem, ka tas ir formatēts manuāla lapas fails (kaķu lapa). Pretējā gadījumā cilvēks pieņem, ka tas nav formatēts. Jebkurā gadījumā, ja faila nosaukumam ir zināms kompresijas piedēklis (piemēram, .gz ), cilvēks pieņem, ka tas ir gzip.
Ja vēlaties redzēt, kur (vai ja) cilvēks atradīs konkrētas tēmas rokasgrāmatas lapu, izmantojiet opciju -path ( -w ).
Svarīgi: izmantojiet vīriešu komandu ( % man ), lai redzētu, kā komanda tiek izmantota jūsu konkrētajā datorā.