| MANPATH(5) | /etc/manpath.config | MANPATH(5) |
NOSAUKUMS¶
manpath - faila /etc/manpath.config formāts
APRAKSTS¶
Manpath konfigurācijas failu izmanto rokasgrāmatas lapu utilītas, lai darbības laikā novērtētu lietotāju manpath, norādītu, kuras rokasgrāmatas lapu hierarhijas (manpath) uzskatāmas par sistēmas hierarhijām, un piešķirtu tām direktorijas cat failu glabāšanai.
Ja vides mainīgais $MANPATH jau ir iestatīts, informācija no /etc/manpath.config to neignorēs.
MEKLĒŠANAS CEĻŠ¶
Pēc noklusējuma man-db pārbauda lietotāja $PATH. Katram tur atrastajam ceļa_elementam tā pievieno meklēšanas ceļam manpath_elementu.
Ja konfigurācijas failā konkrētajam ceļa_elementam nav rindas MANPATH_MAP, tad meklēšanas ceļam tiek pievienoti visi no ceļa_elements/../man, ceļa_elements/man, ceļa_elements/../share/man un ceļa_elements/share/man, kas eksistē kā direktorijas.
Pēc tam tā meklēšanas ceļam pievieno visus MANDATORY_MANPATH ierakstus no konfigurācijas faila.
Visbeidzot, ja izmantota opcija --systems vai iestatīts vides mainīgais $SYSTEM, tam jāsastāv no operētājsistēmu nosaukumu virknes, atdalītu ar komatiem vai koliem. Tas darbojas kā veidne, vēlreiz izvēršot meklēšanas ceļu, lai ļautu piekļūt citu operētājsistēmu rokasgrāmatas lapām: katram sistēmas nosaukumam man-db meklē šo nosaukumu kā apakšdirektoriju katrā meklēšanas ceļa ierakstā un, ja tā eksistē, pievieno to galīgajam meklēšanas ceļam. Sistēmas nosaukums man ievieto parasto meklēšanas ceļu bez apakšdirektorijām. Piemēram, ja meklēšanas ceļš citādi būtu /usr/share/man:/usr/local/man un $SYSTEM ir iestatīts uz newOS:man, tad galīgais meklēšanas ceļš būs /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man.
Vides mainīgais $MANPATH ignorē man-db noklusējuma rokasgrāmatas lapu meklēšanas ceļus. Lielākajai daļai lietotāju to nevajadzētu iestatīt. Tā sintakse ir līdzīga vides mainīgajam $PATH: tas sastāv no ar koliem atdalītu direktoriju nosaukumu virknes. Tas ignorē iepriekš aprakstīto noklusējuma meklēšanas ceļu.
Ja $MANPATH vērtība sākas ar kolu, noklusējuma meklēšanas ceļš tiek pievienots tās sākumā. Ja $MANPATH vērtība beidzas ar kolu, noklusējuma meklēšanas ceļš tiek pievienots tās beigās. Ja $MANPATH vērtība satur dubultkolu (::), noklusējuma meklēšanas ceļš tiek ievietots vērtības vidū starp abiem koliem.
FORMĀTS¶
Pašlaik tiek atpazīti šādi lauku tipi:
- # komentārs
- Tukšas rindas vai rindas, kas sākas ar #, tiks uzskatītas par komentāriem un ignorētas.
- MANDATORY_MANPATH manpath_elements
- Šādas formas rindas norāda manpath, kam jābūt katrā automātiski ģenerētajā $MANPATH. Parasti tas ietver /usr/man.
- MANPATH_MAP ceļa_elements manpath_elements
- Šādas formas rindas iestata $PATH uz $MANPATH attēlojumus. Katram lietotāja $PATH atrastajam ceļa_elementam $MANPATH tiks pievienots manpath_elements.
- MANDB_MAP manpath_elements [ catpath_elements ]
- Šādas formas rindas norāda, kuri manpath
uzskatāmi par sistēmas manpath un, pēc
izvēles, kur glabājami to cat faili. Šis lauka tips
ir īpaši svarīgs, ja man ir setuid programma,
jo (ja tas ir sistēmas konfigurācijas failā
/etc/manpath.config, nevis lietotāja konfigurācijas
failā .manpath) tas norāda, kurām
rokasgrāmatas lapu hierarhijām piekļūt
kā setuid lietotājam un kurām — kā
izsaucējam lietotājam.
Sistēmas rokasgrāmatas lapu hierarhijas parasti ir tās, kas glabājas zem /usr, piemēram, /usr/man, /usr/local/man un /usr/X11R6/man.
Ja cat lapas no konkrēta manpath_elementa nav jāglabā vai jāglabā tradicionālajā vietā, catpath_elementu var izlaist.
Tradicionālais cat izvietojums nebūtu iespējams tikai lasīšanai montētās rokasgrāmatas lapu hierarhijās, tāpēc to glabāšanai ir iespējams norādīt jebkuru derīgu direktoriju hierarhiju. Lai ievērotu Linux FSSTND, īstas direktorijas vietā var izmantot atslēgvārdu FSSTND.
Diemžēl ir jānorāda visi sistēmas man koka ceļi, ieskaitot alternatīvo operētājsistēmu ceļus, piemēram, /usr/man/sun, un visus NLS lokāļu ceļus, piemēram, /usr/man/de_DE.88591.
Tā kā informācija tiek parsēta rindu pa rindai rakstītajā secībā, katram manpath, kas ir citas hierarhijas apakšhierarhija, jābūt norādītam pirmajam, citādi tiks konstatēta nepareiza atbilstība. Piemēram, /usr/man/de_DE.88591 jābūt pirms /usr/man.
- DEFINE atslēga vērtība
- Šādas formas rindas definē dažādus konfigurācijas mainīgos; rokasgrāmatu lapotāja utilītu izmantotos mainīgos skatiet noklusējuma konfigurācijas failā. Tie ietver dažādu programmu (piemēram, grep un tbl) noklusējuma ceļus un šo programmu noklusējuma argumentu kopas.
- SECTION sadaļa ...
SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7
Ja norādītas vairākas SECTION direktīvas, to sadaļu saraksti tiks apvienoti.
Ja kāds paplašinājums nav šajā sarakstā (piemēram, 1mh), tas tiks parādīts kopā ar pārējo sadaļu, kurai tas pieder. Tas nozīmē, ka paplašinājumi jānorāda skaidri tikai tad, ja vēlaties piespiest noteiktu secību. Sadaļām ar paplašinājumiem parasti jābūt blakus savai galvenajai sadaļai (piem., "1 1mh 8 ...").
SECTIONS tiek pieņemts kā alternatīvs šīs direktīvas nosaukums.
- MINCATWIDTH platums
- Ja termināļa platums ir mazāks par platumu, cat lapas netiks veidotas (ja trūkst) vai rādītas. Noklusējums ir 80.
- MAXCATWIDTH platums
- Ja termināļa platums ir lielāks par platumu, cat lapas netiks veidotas (ja trūkst) vai rādītas. Noklusējums ir 80.
- CATWIDTH platums
- Ja platums nav nulle, cat lapas vienmēr tiks formatētas norādītā platuma terminālim neatkarīgi no faktiski izmantotā termināļa platuma. Tas ignorē MINCATWIDTH un MAXCATWIDTH.
- NOCACHE
- Šis karogs neļauj man(1) automātiski veidot cat lapas.
KĻŪDAS¶
Ja iepriekš minētās kārtulas netiek precīzi ievērotas, rokasgrāmatu lapotāja utilītas nedarbosies, kā vēlams. Kārtulas ir pārāk sarežģītas.
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
| 2026-11-15 | 2.13.2 |