MANPATH(5) /etc/man_db.conf MANPATH(5) NAMN manpath - formatet for filen /etc/man_db.conf BESKRIVNING Konfigurationsfilen for manpath anvands av verktygen for manualsidor for att bedoma anvandarnas man-sokvagar i kortid, for att indikera vilka hierarkier av manualsidor (man-sokvagar) som ska hanteras som systemhierarkier och for att tilldela dem kataloger som anvands for att lagra cat-filer. Om miljovariabeln $MANPATH redan ar satt kommer informationen i /etc/man_db.conf inte att asidosatta den. SOKVAG Som standard genomsoker man-db anvandarens $SOKVAG. For varje path_element som hittas dar lagger det till manpath_element till sokvagen. Om det inte finns nagon MANPATH_MAP-rad i konfigurationsfilen for ett givet path_element, da laggs alla path_element/../man, path_element/man, path_element/../share/man och path_element/share/man till som existerar som kataloger i sokvagen. Det lagger sedan till de MANDATORY_MANPATH-poster fran konfigurationsfilen till sokvagen. Avslutningsvis, om flaggan --systems anvands eller om miljovariabeln $SYSTEM ar satt, da bor denna besta av en sekvens av operativsystemsnamn separerade av komman eller kolon. Detta fungerar som en mall och expanderar sokvagen annu en gang for att tillata atkomst till andra operativsystems manualsidor: for varje systemnamn kommer man-db att leta efter det namnet som en underkatalog i varje post i sokvagen och lagger till den till den slutgiltiga sokvagen om den existerar. Systemnamnet man infogar den normala sokvagen utan underkataloger. Om till exempel sokvagen annars hade varit /usr/share/man:/usr/local/man och $SYSTEM ar satt till nyttOS:man, da kommer den slutgiltiga sokvagen att vara /usr/share/man/nyttOS:/usr/share/man:/usr/local/man/nyttwOS:/usr/local/man. Miljovariabeln $MANPATH asidosatter man-dbs standardsokvag for manualsidor. De flesta anvandare behover inte satta den. Dess syntax liknar den for miljovariabeln $PATH: den bestar av en sekvens av katalognamn separerade av kolon. Den asidosatter standardsokvagen som beskrivits ovan. Om vardet av $MANPATH borjar med ett kolon sa kommer standardsokvagen att laggas till i dess borjan. Om vardet av $MANPATH slutar med ett kolon sa kommer standardsokvagen att laggas till i dess slut. Om vardet av $MANPATH innehaller dubbla kolon (::) sa kommer standardsokvagen att infogas mitt i vardet mellan de tva kolonen. FORMAT Foljande falttyper erkanns for narvarande: # kommentar Tomma rader eller de som borjar med ett # kommer att hanteras som kommentarer och ignoreras. MANDATORY_MANPATH man-sokvagselement Rader pa detta format indikerar man-sokvagar som varje automatiskt genererad $MANPATH bor innehalla. Detta kommer typiskt att inkludera /usr/man. MANPATH_MAP sokvagselement man-sokvagselement Rader pa detta format staller in mappningarna fran $PATH till $MANPATH. For varje sokvagselement som hittas i anvandarens $PATH, kommer man-sokvagselement att laggas till i $MANPATH. MANDB_MAP man-sokvagselement [ cat-sokvagselement ] Rader pa detta format indikerar vilka man-sokvagar som ska behandlas som systemman-sokvagar och valfritt om deras cat-filer bor lagras. Denna falttyp ar sarskilt viktig om man ar ett setuid-program eftersom (nar det finns i systemkonfigurationsfilen /etc/man_db.conf snarare an i anvandarnas konfigurationsfil .manpath) det indikerar vilka hierarkier av manualsidor som ska nas som setuid-anvandaren och vilka som ska nas som den anropande anvandaren. Systemets hierarkier av manualsidor ar vanligtvis de som lagras under /usr sa som /usr/man, /usr/local/man och /usr/X11R6/man. Om cat-sidor fran ett visst man-sokvagselement inte ska lagras eller ska lagras pa den traditionella platsen kan cat-sokvagselement utelamnas. Traditionell cat-placering skulle vara omojlig for skrivskyddade hierarkier av manualsidor och pa grund av detta ar det mojligt att ange vilken giltig kataloghierarki som helst for att lagra dem. For att vara kompatibel med Linux FSSTND kan nyckelordet FSSTND anvandas istallet for en riktig katalog. Tyvarr ar det nodvandigt att ange alla systemsokvagar for manualtrad, inklusive alternativa operativsystemssokvagar sa som /usr/man/sun och eventuella NLS-lokal-sokvagar sa som /usr/man/de_DE.88591. Eftersom informationen tolkas rad for rad i den ordning de ar skrivna, sa ar det nodvandigt att forst lista den man-sokvag som ar underhierarki till en annan hierarki, annars kommer felaktiga matchningar att goras. Ett exempel ar att /usr/man/de_DE.88591 maste komma fore /usr/man. DEFINE nyckel varde Rader pa detta format definierar diverse konfigurationsvariabler; se standardkonfigurationsfilen for vilka de variabler ar som anvands av sidvisaren for manualsidor. De inkluderar standardsokvagar till diverse program (sa som grep och tbl), och standarduppsattningar av argument for dessa program. SECTION avsnitt ... Rader pa denna form definierar ordningen i vilken manualavsnitt bor genomsokas. Om det inte finns nagra SECTION-direktiv i konfigurationsfilen ar standardvardet: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Om flera SECTION-direktiv anges kommer avsnittslistorna att konkateneras. Om en sarskild andelse inte finns i denna lista (sag, 1mh) kommer den att visas med resten av avsnittet som den hor till. Effekten av detta ar att du bara behover att uttryckligen lista andelser om du vill tvinga fram en sarskild ordning. Avsnitt med andelser bor vanligtvis finnas intill deras huvudavsnitt (t.ex. "1 1mh 8..."). SECTIONS accepteras som ett alternativt namn pa detta direktiv. MINCATWIDTH bredd Om terminalbredden ar mindre an bredd kommer cat-sidor inte att skapas (om de saknas) eller visas. Standardvardet ar 80. MAXCATWIDTH bredd Om terminalbredden ar storre an bredd kommer cat-sidor inte att skapas (om de saknas) eller visas. Standardvardet ar 80. CATWIDTH bredd Om bredd inte ar noll kommer cat-sidor alltid att formateras for en terminal av en angivna bredden, oavsett bredden pa terminalen som faktiskt anvands. Detta asidosatter MINCATWIDTH och MAXCATWIDTH. NOCACHE Denna flagga forhindrar man(1) fran att automatiskt skapa cat-sidor. FEL Om reglerna ovan inte foljs till punkt och pricka kommer verktygen for sidvisning av manualer inte att fungera som onskat. Dessa regler ar overdrivet komplicerade. https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANPATH(5)