1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
.\" Man page for format of the manpath.config data file
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man_db distribution.
.\"
.\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Fri 25 Sep 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.\"WORD: hierarchy 系列
.\"
.TH manpath 5 "July 12th, 1995" "2.3.10" "/etc/manpath.config"
.SH 名前
manpath \- /etc/manpath.config ファイルのフォーマット
.SH 説明
manpath 設定ファイルは、マニュアルページのユーティリティによって用いら
れる。ユーザの manpath を実行時に評価したり、どのマニュアルページ系列
(hierarchy) すなわち manpath を `global' として扱うかを判断したり、
どのディレクトリを cat ファイルを保管するディレクトリとして用いるかを
決定するために用いられる。
環境変数
.RB $ MANPATH
がすでに設定されている場合には、 /etc/manpath.config に含まれている
情報はそれを上書きしない。
.SH フォーマット
現在のところ、以下のフィールドタイプが認識される。
.TP
.BI # \ comment
空行や
.B #
で始まる行はコメントとみなされ、無視される。
.TP
.BI MANDATORY_MANPATH \ manpath_element
この形式の行は、自動的に生成される
.RB $ MANPATH
には必ず含まれているべき manpath を示す。
.I /usr/man
などが典型である。
.TP
.BI MANPATH_MAP \ path_element\ manpath_element
この形式の行は
.RB PATH
から
.RB $ MANPATH
へのマッピングを設定する。それぞれの
.I path_element
がユーザの
.RB $ PATH
に含まれていると、
.I manpath_element
が
.RB $ MANPATH
に追加される。
.TP
\fBMANDB_MAP \fImanpath_element \fR\|[\| \fIcatpath_element\fR \|]
この形式の行は、どの manpath を `global' として扱い、またそれらの cat
ページをどこに保存するかを指定する (後半は省略可)。この形式のフィール
ドは、
.B man
が setuid されたプログラムである場合に特に重要である。なぜなら、これは
どの系列を setuid されたユーザー権限でアクセスし、どれを起動ユーザーの
権限でアクセスするかを指定することになるからである。
`global' なマニュアルページの系列は、通常
.I /usr
以下に保管されている。例えば
.IR /usr/man ,
.IR /usr/local/man ,
.I /usr/X11R6/man
などがこれにあたる。
特定の
.I manpath_element
からの cat ページは保管したくない場合や、伝統的な位置に保管したい場合には、
.I catpath_element
は省略する。
伝統的な cat の場所は、リードオンリーでマウントされているマニュアルペー
ジの系列下にすることはできない。この理由から、これらの保管場所としては、
任意のディレクトリ系列を指定することが可能になっている (もちろん指定した
ディレクトリは有効なものでなければならない)。
.B Linux FSSTND
に従う場合には、
キーワード
.RB ` FSSTND '
を実際のディレクトリ名の代わりに用いることができる。
残念ながら、 `global' な man のツリーパスはすべて指定しなければならない。
他のシステムパス (
.I /usr/man/sun
のようなもの) やすべての
.B NLS ロケール
パス (
.I /usr/man/de_DE.88591
のようなもの) も、それぞれすべて指定する必要がある。
情報は書かれた順に一行ずつ評価されるので、他の系列のサブツリーとなって
いるような manpath は先に書かなければならない。さもないと、マッチが正
しく行われない可能性がある。例えば
.I /usr/man/de_DE.88591
は
.I /usr/man
より先に来なければならない。
.SH バグ
上記のルールが正しく守られない場合には、マニュアルページャーの機能は
正しく動作しない。これらのルールは不必要に難しい。
|
