table of contents
- bullseye 2.9.4-2
- bullseye-backports 2.10.1-1~bpo11+1
- testing 2.11.2-1
- unstable 2.11.2-2
MANPATH(5) | /etc/manpath.config | MANPATH(5) |
NUME¶
manpath - formatează fișierul /etc/manpath.config
DESCRIERE¶
Fișierul de configurare a căii de manual este utilizat de utilitățile paginilor de manual pentru a evalua căile man ale utilizatorului la executare, pentru a indica care dintre ierarhiile paginilor de manual (căilor de man) vor fi tratate ca ierarhii de sistem și pentru a le atribui directoare să fie utilizate pentru stocarea fișierelor cat.
Dacă variabila de mediu $MANPATH este stabilită deja, informațiile conținute în /etc/manpath.config nu o va suprascrie.
FORMAT¶
Următoarele tipuri de câmp sunt recunoscute curent:
- # comentariu
- Liniile goale sau cele care încep cu un # vor fi tratate ca și comentarii și vor fi ignorate.
- MANDATORY_MANPATH manpath_element
- Liniile de această formă indică căile man care fiecare $MANPATH generat automat ar trebui să conțină. Acest lucru va include tipic /usr/man.
- MANPATH_MAP path_element manpath_element
- Liniile de această formă stabilesc $PATH la mapări $MANPATH. Pentru fiecare path_element găsit în $PATH utilizatorului, manpath_element va fi adăugat la $MANPATH.
- MANDB_MAP manpath_element [ catpath_element ]
- Liniile de această formă indică care căi de
manual se vor trata precum căi de manual de sistem, și
opțional unde ar trebui să fie stocate fișierele cat.
Acest tip de câmp este în mod particular important
dacă man este un program setuid, pentru că
(când în fișierul de configurare a sistemului
/etc/manpath.config decât la fișierul de configurare
per-utilizator .manpath) acesta indică care ierarhii de pagini de
manual să se acceseze ca utilizatorul setuid și care
să se acceseze ca utilizatorul invocat.
Ierarhiile de pagini de manual ale sistemului sunt de obicei acele stocate sub /usr precum /usr/man, /usr/local/man și /usr/X11R6/man.
Dacă paginile cat de la un manpath_element particular nu vor fi stocate sau sunt pe cale să fie stocate în locația tradițională, catpath_element poate fi omis.
Plasarea cat tradițională ar fi imposibilă pentru ierarhiile de pagini de manual montate în doar citire și din cauza asta este posibil să specificați orice ierarhie de director validă pentru stocarea acestora. Pentru a observa Linux FSSTND cuvântul cheie FSSTND poate fi utilizat în locul unui director actual.
Din păcate, este necesar să specificați all căile de arbore de man ale sistemului, inclusiv căile de sistem de operare alternative precum căile /usr/man/sun și orice căi NLS locale precum /usr/man/de_DE.88591.
Deoarece informațiile sunt analizate linie cu linie în ordinea scrisă, este necesar pentru orice cale de man care este o sub-ierarhie a altei ierarhii să fie listată mai întâi, în caz contrar o potrivire incorectă va fi făcută. Un exemplu este că /usr/man/de_DE.88591 trebuie să vină înaintea lui /usr/man.
- DEFINE cheie valoare
- Liniile de această formă definesc variabilele de configurație diversă; vedeți fișierul de configurație implicit pentru acele variabile utilizate de utilitățile pagerului de manual. Acestea includ căile către programele variate (precum grep și tbl), și seturile implicite de argumente la acele programe.
- SECTION section ...
SECTION 1 n l 8 3 0 2 5 4 9 6 7
Dacă sunt date directive multiple SECTION, listele lor de secțiune vor fi concatenate.
Dacă o extensie particulară nu este în această listă (să spunem, 1mh) aceasta va fi afișată cu restul secțiunii de care aparține. Efectul acestui lucru este că aveți nevoie să listați explicit extensii dacă doriți să forțați o ordine particulară. Secțiunile cu extensii ar trebui de obicei să fie adiacente secțiunilor principale (de ex. „1 1mh 8 ...”).
SECTIONS este acceptat ca un nume alternativ pentru această directivă.
- MINCATWIDTH lățime
- Dacă lățimea terminalului este mai mică decât width, paginile cat nu vor fi create (dacă lipsesc) sau afișate. Implicitul este 80.
- MAXCATWIDTH lățime
- Dacă lățimea terminalului este mai mare decât width, paginile cat nu vor fi create (dacă lipsesc) sau afișate. Implicitul este 80.
- CATWIDTH lățime
- Dacă width nu este zero, paginile cat vor fi întotdeauna formatate pentru un terminal de lățimea dată, indiferent de lățimea terminalului actual utilizată. Acest lucru ar trebui în general să fie în intervalul stabilit de MINCATWIDTH și MAXCATWIDTH.
- NOCACHE
- Acest fanion previne man(1) din a cea pagini cat automat.
DEFECȚIUNI¶
Dacă regulile de mai sus nu sunt urmate și observate precis, utilitățile pagerului de manual nu vor funcționa așa cum este dorit. Regulile sunt prea complicate.
2021-02-08 | 2.9.4 |