Linux Certif

Toute la documentation sur la certification Linux LPI

manpath

NAZWA

manpath - format pliku /etc/man_db.config

OPIS

Plik konfiguracyjny ¶cie¿ek przeszukiwania stron man stosowany jest przez narzêdzia obs³ugi stron man do oszacowania ¶cie¿ek manpath u¿ytkowników na bie¿±co, podczas wykonywania programu. Wskazuje, jakie hierarchie stron man (manpaths) powinny byæ traktowane jako globalne oraz przypisuje im katalogi, które bêd± u¿yte do sk³adowania plików cat.

Je¿eli jest ju¿ ustawiona zmienna ¶rodowiska $MANPATH, to informacja zawarta w /etc/man_db.config nie bêdzie jej uniewa¿niaæ.

FORMAT

Obecnie rozpoznawane s± nastêpuj±ce typy pól:

# komentarz

Wiersze puste b±d¼ rozpoczynaj±ce siê znakiem # zostan± uznane za komentarze i zignorowane.

MANDATORY_MANPATH element_manpath

Wiersze tej postaci wskazuj± ¶cie¿ki man, które powinna zawieraæ ka¿da automatycznie utworzona warto¶æ zmiennej $MANPATH. Zwykle obejmuje to /usr/man.

MANPATH_MAP element_path element_manpath

Wiersze tej postaci ustawiaj± odwzorowania $PATH na $MANPATH. Dla ka¿dego elementu_path znalezionego w ¶cie¿ce $PATH u¿ytkownika do zmiennej $MANPATH zostanie dodany element_manpath.

MANDB_MAP element_manpath [ element_catpath ]

Wiersze tej postaci wskazuj±, które ¶cie¿ki man powinny byæ traktowane jako systemowe, i opcjonalnie, gdzie powinny byæ sk³adowane ich pliki cat. Ten typ pola jest szczególnie wa¿ny, gdy man jest programem setuid, gdy¿ (je¿eli jest umieszczony w systemowym pliku konfiguracyjnym /etc/man_db.config, a nie w pliku konfiguracyjnym u¿ytkownika .manpath) mówi, do których hierarchii (katalogów) stron man siêgaæ jako u¿ytkownik setuid, a do których jako u¿ytkownik wywo³uj±cy program.

Systemowe hierarchie stron man s± zwykle sk³adowane wewn±trz katalogu /usr jak na przyk³ad /usr/man, /usr/local/man czy /usr/X11R6/man.

Je¶li strony cat z danej ¶cie¿ki element_manpath maj± nie byæ przechowywane albo maj± byæ sk³adowane w tradycyjnym miejscu, to element_catpath mo¿na pomin±æ.

Tradycyjne umieszczanie stron cat nie jest mo¿liwe dla hierarchii stron man zamontowanych jako read-only. Z tego powodu mo¿na podaæ dowoln± poprawn± hierarchiê katalogów dla ich sk³adowania. W celu przestrzegania Linuksowego FSSTND (File System Standard Group - ustalenia standardu struktury drzewa katalogów Linuksa) mo¿na pos³u¿yæ siê s³owem kluczowym `FSSTND' w miejscu faktycznego katalogu.

Niestety, niezbêdne jest podanie wszystkich systemowych ¶cie¿ek drzew man, ³±cznie ze ¶cie¿kami kolejnych systemów, jak np. /usr/man/sun czy te¿ ¶cie¿ki NLS locale, takie jak /usr/man/de_DE.88591.

Poniewa¿ informacja jest analizowana wiersz po wierszu, w kolejno¶ci zapisu, ka¿da ¶cie¿ka manpath bêd±ca podhierarchi± innej hierarchii powinna byæ podana jako pierwsza. W przeciwnym razie zostan± wykonane niepoprawne dopasowania. Na przyk³ad /usr/man/de_DE.88591 musi wyst±piæ przed /usr/man.

DEFINE klucz warto¶æ

Linie tej postaci definiuj± ró¿norodne zmienne konfiguracyjne - domy¶lny plik konfiguracyjny zawiera zmienne u¿ywane przez programy u¿ytkowe przegl±darki stron man. Zawieraj± one domy¶lne ¶cie¿ki do ró¿nych programów (takich jak grep i tbl) oraz domy¶lne argumenty wywo³añ tych programów.

B£ÊDY

Je¿eli nie s± ¶ci¶le przestrzegane powy¿sze regu³y, to narzêdzia przegl±dania stron man nie bêd± dzia³aæ w po¿±dany sposób.