Provided by: man-db_2.13.1-1_amd64 

NAMN
manpath - formatet för filen /etc/manpath.config
BESKRIVNING
Konfigurationsfilen för manpath används av verktygen för manualsidor för att bedöma användarnas
man-sökvägar i körtid, för att indikera vilka hierarkier av manualsidor (man-sökvägar) som ska hanteras
som systemhierarkier och för att tilldela dem kataloger som används för att lagra cat-filer.
Om miljövariabeln $MANPATH redan är satt kommer informationen i /etc/manpath.config inte att åsidosätta
den.
SÖKVÄG
Som standard genomsöker man-db användarens $SÖKVÄG. För varje path_element som hittas där lägger det till
manpath_element till sökvägen.
Om det inte finns någon MANPATH_MAP-rad i konfigurationsfilen för ett givet path_element, då läggs alla
path_element/../man, path_element/man, path_element/../share/man och path_element/share/man till som
existerar som kataloger i sökvägen.
Det lägger sedan till de MANDATORY_MANPATH-poster från konfigurationsfilen till sökvägen.
Finally, if the --systems option is used or the $SYSTEM environment variable is set, then that should
consist of a sequence of operating system names separated by commas or colons. This acts as a template,
expanding the search path once more to allow access to other operating systems' manual pages: for each
system name, man-db looks for that name as a subdirectory of each entry in the search path, and adds it
to the final search path if it exists. A system name of man inserts the normal search path without
subdirectories. For example, if the search path would otherwise have been /usr/share/man:/usr/local/man,
and $SYSTEM is set to newOS:man, then the final search path will be /usr/share/man/newOS:/usr/share/man:
/usr/local/man/newOS:/usr/local/man.
Miljövariabeln $MANPATH åsidosätter man-dbs standardsökväg för manualsidor. De flesta användare behöver
inte sätta den. Dess syntax liknar den för miljövariabeln $PATH: den består av en sekvens av katalognamn
separerade av kolon. Den åsidosätter standardsökvägen som beskrivits ovan.
Om värdet av $MANPATH börjar med ett kolon så kommer standardsökvägen att läggas till i dess början. Om
värdet av $MANPATH slutar med ett kolon så kommer standardsökvägen att läggas till i dess slut. Om värdet
av $MANPATH innehåller dubbla kolon (::) så kommer standardsökvägen att infogas mitt i värdet mellan de
två kolonen.
FORMAT
Följande fälttyper erkänns för närvarande:
# kommentar
Tomma rader eller de som börjar med ett # kommer att hanteras som kommentarer och ignoreras.
MANDATORY_MANPATH man-sökvägselement
Rader på detta format indikerar man-sökvägar som varje automatiskt genererad $MANPATH bör
innehålla. Detta kommer typiskt att inkludera /usr/man.
MANPATH_MAP sökvägselement man-sökvägselement
Rader på detta format ställer in mappningarna från $PATH till $MANPATH. För varje sökvägselement
som hittas i användarens $PATH, kommer man-sökvägselement att läggas till i $MANPATH.
MANDB_MAP man-sökvägselement [ cat-sökvägselement ]
Rader på detta format indikerar vilka man-sökvägar som ska behandlas som systemman-sökvägar och
valfritt om deras cat-filer bör lagras. Denna fälttyp är särskilt viktig om man är ett
setuid-program eftersom (när det finns i systemkonfigurationsfilen /etc/manpath.config snarare än
i användarnas konfigurationsfil .manpath) det indikerar vilka hierarkier av manualsidor som ska
nås som setuid-användaren och vilka som ska nås som den anropande användaren.
Systemets hierarkier av manualsidor är vanligtvis de som lagras under /usr så som /usr/man,
/usr/local/man och /usr/X11R6/man.
Om cat-sidor från ett visst man-sökvägselement inte ska lagras eller ska lagras på den
traditionella platsen kan cat-sökvägselement utelämnas.
Traditionell cat-placering skulle vara omöjlig för skrivskyddade hierarkier av manualsidor och på
grund av detta är det möjligt att ange vilken giltig kataloghierarki som helst för att lagra dem.
För att vara kompatibel med Linux FSSTND kan nyckelordet FSSTND användas istället för en riktig
katalog.
Tyvärr är det nödvändigt att ange alla systemsökvägar för manualträd, inklusive alternativa
operativsystemssökvägar så som /usr/man/sun och eventuella NLS-lokal-sökvägar så som
/usr/man/de_DE.88591.
Eftersom informationen tolkas rad för rad i den ordning de är skrivna, så är det nödvändigt att
först lista den man-sökväg som är underhierarki till en annan hierarki, annars kommer felaktiga
matchningar att göras. Ett exempel är att /usr/man/de_DE.88591 måste komma före /usr/man.
DEFINE nyckel värde
Rader på detta format definierar diverse konfigurationsvariabler; se standardkonfigurationsfilen
för vilka de variabler är som används av sidvisaren för manualsidor. De inkluderar
standardsökvägar till diverse program (så som grep och tbl), och standarduppsättningar av argument
för dessa program.
SECTION avsnitt ...
Rader på denna form definierar ordningen i vilken manualavsnitt bör genomsökas. Om det inte finns
några SECTION-direktiv i konfigurationsfilen är standardvärdet:
SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7
Om flera SECTION-direktiv anges kommer avsnittslistorna att konkateneras.
If a particular extension is not in this list (say, 1mh) it will be displayed with the rest of the
section it belongs to. The effect of this is that you only need to explicitly list extensions if
you want to force a particular order. Sections with extensions should usually be adjacent to their
main section (e.g. "1 1mh 8 ...").
SECTIONS accepteras som ett alternativt namn på detta direktiv.
MINCATWIDTH bredd
Om terminalbredden är mindre än bredd kommer cat-sidor inte att skapas (om de saknas) eller visas.
Standardvärdet är 80.
MAXCATWIDTH bredd
Om terminalbredden är större än bredd kommer cat-sidor inte att skapas (om de saknas) eller visas.
Standardvärdet är 80.
CATWIDTH bredd
Om bredd inte är noll kommer cat-sidor alltid att formateras för en terminal av en angivna
bredden, oavsett bredden på terminalen som faktiskt används. Detta åsidosätter MINCATWIDTH och
MAXCATWIDTH.
NOCACHE
Denna flagga förhindrar man(1) från att automatiskt skapa cat-sidor.
FEL
Om reglerna ovan inte följs till punkt och pricka kommer verktygen för sidvisning av manualer inte att
fungera som önskat. Dessa regler är överdrivet komplicerade.
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
2.13.1 2025-05-02 MANPATH(5)