release/man5/dir_colors.5

   1 .\" manpage for /etc/dir_colors, config file for dircolors(1)
   2 .\" extracted from color-ls 3.12.0.3 dircolors(1) manpage
   3 .\"
   4 .\" %%%LICENSE_START(LDPv1)
   5 .\" This file may be copied under the conditions described
   6 .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
   7 .\" that should have been distributed together with this file.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" Modified Sat Dec 22 22:25:33 2001 by Martin Schulze <joey@infodrom.org>
  11 .\"
  12 .\"*******************************************************************
  13 .\"
  14 .\" This file was generated with po4a. Translate the source file.
  15 .\"
  16 .\"*******************************************************************
  17 .\"
  18 .\" Japanese Version Copyright (c) 2000-2002 Yuichi SATO
  19 .\"         all rights reserved.
  20 .\" Translated Tue Jul  4 18:44:50 JST 2000
  21 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  22 .\" Updated & Modified Tue Apr 24 21:49:43 JST 2001
  23 .\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
  24 .\" Updated & Modified Sat Jan  5 22:25:30 JST 2002 by Yuichi SATO
  25 .\" Updated 2013-03-26, Akihiro MOTOKI <amotoki@gmail.com>
  26 .\" Updated 2013-07-31, Akihiro MOTOKI <amotoki@gmail.com>
  27 .\"
  28 .TH DIR_COLORS 5 2013\-08\-09 GNU "Linux User Manual"
  29 .SH 名前
  30 dir_colors \- dircolors(1) の設定ファイル
  31 .SH 説明
  32 プログラム \fBls\fP(1)  は、環境変数 \fBLS_COLORS\fP を使い、ファイル名を何色で表示するかを決定する。 この環境変数は、通常
  33
  34 .RS
  35 eval \`dircolors some_path/dir_colors\`
  36 .RE
  37
  38 のようなコマンドで設定される。 このコマンドは \fI/etc/profile\fP や \fI/etc/csh.cshrc\fP
  39 といったシステムのシェル初期化ファイルにある。 (\fBdircolors\fP(1)  を参照すること。)  通常、ここで使われるファイルは
  40 \fI/etc/DIR_COLORS\fP であるが、ホームディレクトリの \fI.dir_colors\fP ファイルで上書きすることができる。
  41 .PP
  42 設定ファイルは 1 行毎に書かれたステートメントで構成される。 ハッシュマーク (#) が行の始めにある場合や、 ハッシュマークの前に少なくとも 1
  43 つの空白がある場合、 ハッシュマークの後ろはコメントとして扱われる。 空行は無視される。
  44 .PP
  45 このファイルの \fIグローバル\fP セクションは、 最初の \fBTERM\fP ステートメントより前にある任意のステートメントからなる。
  46 グローバルセクションにあるステートメントは、 すべての端末タイプについて有効であるとみなされる。 グローバルセクションの次には、 \fI端末固有\fP
  47 セクションが続く。 各端末固有セクションの先頭には、1 つ以上の \fBTERM\fP ステートメントが置かれる。 \fBTERM\fP
  48 ステートメントは、その後に続く宣言が適用される (環境変数 \fBTERM\fP で与えられる) 端末タイプを指定する。
  49 グローバル宣言をその後に続く端末固有の宣言で上書きすることが常に可能である。
  50 .PP
  51 次のステートメントが認識される。大文字と小文字は区別されない。
  52 .TP
  53 \fBTERM \fP\fIterminal\-type\fP
  54 端末固有セクションを開始し、どの端末に適用するかを指定する。 複数の端末タイプに適用するため、複数の \fBTERM\fP ステートメントを使うことができる。
  55 .TP
  56 \fBCOLOR yes|all|no|none|tty\fP
  57 (Slackware のみ; GNU \fBdircolors\fP(1)  では無視される。)  カラー表示を常に有効にするのか (\fIyes\fP または
  58 \fIall\fP)、 常に無効にするのか (\fIno\fP または \fInone\fP)、 出力先が端末の場合にのみ有効にするのか (\fItty\fP) を指定する。
  59 デフォルトは \fIno\fP である。
  60 .TP
  61 \fBEIGHTBIT yes|no\fP
  62 (Slackware のみ; GNU \fBdircolors\fP(1)  では無視される。)  デフォルトで 8 ビットの ISO 8859
  63 文字を有効にするかを指定する。 互換性のため、1 で \fIyes\fP を、0 で \fIno\fP を指定することができる。 デフォルトは \fIno\fP である。
  64 .TP
  65 \fBOPTIONS \fP\fIoptions\fP
  66 (Slackware のみ; GNU \fBdircolors\fP(1)  では無視される。)  コマンドラインオプションをデフォルトの \fBls\fP
  67 コマンドラインに追加する。 このオプションには、すべての有効な \fBls\fP のコマンドラインオプションを指定できる。
  68 オプションの前にはマイナス記号を置かなければならない。 \fBdircolors\fP がオプションの有効性を検証しない点に注意すること。
  69 .TP
  70 \fBNORMAL \fP\fIcolor\-sequence\fP
  71 (ファイル名でない) 通常のテキストに使われる色を指定する。
  72
  73 \fBNORM\fP の同義語。
  74 .TP
  75 \fBFILE \fP\fIcolor\-sequence\fP
  76 通常のファイルに使われる色を指定する。
  77 .TP
  78 \fBDIR \fP\fIcolor\-sequence\fP
  79 ディレクトリに使われる色を指定する。
  80 .TP
  81 \fBLINK \fP\fIcolor\-sequence\fP
  82 シンボリックリンクに使われる色を指定する。
  83
  84 \fBLNK\fP, \fBSYMLINK\fP の同義語。
  85 .TP
  86 \fBORPHAN \fP\fIcolor\-sequence\fP
  87 孤立した (存在しないファイルを指している)  シンボリックリンクに使われる色を指定する。 指定されない場合、 \fBls\fP は \fBLINK\fP
  88 の色を代わりに使う。
  89 .TP
  90 \fBMISSING \fP\fIcolor\-sequence\fP
  91 行方不明のファイル (存在しないにもかかわらず シンボリックリンクが指しているファイル) に使われる色を指定する。 指定されない場合、 \fBls\fP は
  92 \fBFILE\fP の色を代わりに使う。
  93 .TP
  94 \fBFIFO \fP\fIcolor\-sequence\fP
  95 FIFO (名前付きパイプ) に使われる色を指定する。
  96
  97 \fBPIPE\fP の同義語。
  98 .TP
  99 \fBSOCK \fP\fIcolor\-sequence\fP
 100 ソケットに使われる色を指定する。
 101 .TP
 102 \fBDOOR \fP\fIcolor\-sequence\fP
 103 (fileutils 4.1 以降でサポートされる)  door (Solaris 2.5 以降) で使われる色を指定する。
 104 .TP
 105 \fBBLK \fP\fIcolor\-sequence\fP
 106 ブロックデバイススペシャルファイルに使われる色を指定する。
 107
 108 \fBBLOCK\fP の同義語。
 109 .TP
 110 \fBCHR \fP\fIcolor\-sequence\fP
 111 キャラクターデバイススペシャルファイルに使われる色を指定する。
 112
 113 \fBCHAR\fP の同義語。
 114 .TP
 115 \fBEXEC \fP\fIcolor\-sequence\fP
 116 実行属性が設定されているファイルに使われる色を設定する。
 117 .TP
 118 \fBSUID \fP\fIcolor\-sequence\fP
 119 set\-user\-ID 属性が設定されているファイルに使われる色を設定する。
 120
 121 \fBSETUID\fP の同義語。
 122 .TP
 123 \fBSGID \fP\fIcolor\-sequence\fP
 124 set\-group\-ID 属性が設定されているファイルに使われる色を設定する。
 125
 126 \fBSETGID\fP の同義語。
 127 .TP
 128 \fBSTICKY \fP\fIcolor\-sequence\fP
 129 sticky 属性が設定されているディレクトリに使われる色を設定する。
 130 .TP
 131 \fBSTICKY_OTHER_WRITABLE \fP\fIcolor\-sequence\fP
 132 実行属性が設定されている他人が書き込み可能なディレクトリに使われる色を設定する。
 133
 134 \fBOWT\fP の同義語。
 135 .TP
 136 \fBOTHER_WRITABLE \fP\fIcolor\-sequence\fP
 137 実行属性が設定されていない他人が書き込み可能なディレクトリに使われる色を設定する。
 138
 139 \fBOWR\fP の同義語。
 140 .TP
 141 \fBLEFTCODE \fP\fIcolor\-sequence\fP
 142 ISO\ 6429 端末 (下記参照) 以外で \fIleft code\fP に使われる色を指定する。
 143
 144 \fBLEFT\fP の同義語。
 145 .TP
 146 \fBRIGHTCODE \fP\fIcolor\-sequence\fP
 147 ISO\ 6429 端末 (下記参照) 以外で \fIright code\fP に使われる色を指定する。
 148
 149 \fBRIGHT\fP の同義語。
 150 .TP
 151 \fBENDCODE \fP\fIcolor\-sequence\fP
 152 ISO\ 6429 端末 (下記参照) 以外で \fIend code\fP に使われる色を指定する。
 153
 154 \fBEND\fP の同義語。
 155 .TP
 156 \fB*\fP\fIextension\fP \fIcolor\-sequence\fP
 157 \fIextension\fP で終るすべてのファイルに使われる色を指定する。
 158 .TP
 159  \fB.\fP\fIextension\fP \fIcolor\-sequence\fP
 160 \fB*\fP.\fIextension\fP と同じ。 \fIextension\fP で終るすべてのファイルに使われる色を指定する。 ピリオドは拡張子に含まれ、
 161 \fBemacs\fP のバックアップファイル \fB~\fP のようなピリオドで始まらない拡張子を指定することができない点に注意すること。
 162 この形式は古いものと考えられている。
 163 .SS "ISO 6429 (ANSI) カラーシーケンス"
 164 最近のカラー表示可能な ASCII 端末の大部分は、 ISO 6429 (ANSI) カラーシーケンスを用いる。 \fBxterm\fP や広く使われている
 165 DEC VT100 クローンを含む カラー表示できない一般的な端末の多くは、 ISO 6429
 166 カラーコードを認識し、出力から実害なく削除するか、エミュレートする。 \fBls\fP は、カラー表示が有効であることを仮定し、ISO 6429
 167 コードをデフォルトで使う。
 168
 169 ISO 6429 カラーシーケンスは、セミコロンで区切られた数字のシーケンスで作られる。 最も一般的なコードを示す。
 170 .sp
 171 .RS
 172 .TS
 173 l l.
 174  0      デフォルトカラーを復元
 175  1      より明るい色
 176  4      下線付きのテキスト
 177  5      点滅するテキスト
 178 30      文字表示色：黒
 179 31      文字表示色：赤
 180 32      文字表示色：緑
 181 33      文字表示色：黄 (または茶)
 182 34      文字表示色：青
 183 35      文字表示色：紫
 184 36      文字表示色：シアン
 185 37      文字表示色：白 (またはグレー)
 186 40      背景色：黒
 187 41      背景色：赤
 188 42      背景色：緑
 189 43      背景色：黄 (または茶)
 190 44      背景色：青
 191 45      背景色：紫
 192 46      背景色：シアン
 193 47      背景色：白 (またはグレー)
 194 .TE
 195 .RE
 196 .sp
 197 システムと表示デバイスによっては、動作しないコマンドもある。
 198 .PP
 199 \fBls\fP は以下をデフォルトとして使う。
 200 .sp
 201 .TS
 202 lb l l.
 203 NORMAL  0               (ファイル名でない) 通常のテキスト
 204 FILE    0               通常のファイル
 205 DIR     32              ディレクトリ
 206 LINK    36              シンボリックリンク
 207 ORPHAN  undefined       孤立したシンボリックリンク
 208 MISSING undefined       行方不明のファイル
 209 FIFO    31              名前付きパイプ (FIFO)
 210 SOCK    33              ソケット
 211 BLK     44;37           ブロックデバイス
 212 CHR     44;37           キャラクターデバイス
 213 EXEC    35              実行ファイル
 214 .TE
 215 .sp
 216 デフォルトの設定を完全に認識できない端末プログラムも少数存在する。 ディレクトリをリストした後にすべてのテキストがカラー表示されたなら、
 217 \fBNORMAL\fP と \fBFILE\fP のコードを通常の前景色と背景色のための数値コードに変更すること。
 218 .SS "その他の端末タイプ (高度な設定)"
 219 カラー表示可能 (またはハイライト表示可能) だが、 異なるコードセットを使う端末 (あるいはプリンター!) を持っている場合でも、
 220 それに適した設定を作ることができる。 そのためには、 \fBLEFTCODE\fP, \fBRIGHTCODE\fP, \fBENDCODE\fP 定義を使う必要がある。
 221 .PP
 222 ファイル名を出力する場合、 \fBls\fP は " \fBLEFTCODE\fP \fItypecode\fP \fBRIGHTCODE\fP \fIfilename\fP
 223 \fBENDCODE\fP " という出力シーケンスを生成する。 ここで、 \fItypecode\fP はファイルのタイプや名前に依存したカラーシーケンスである。
 224 \fBENDCODE\fP が未定義の場合、シーケンス \fBLEFTCODE NORMAL RIGHTCODE\fP が代わりに使われる。 leftcode と
 225 rightcode の目的は、単に必要な打ち込む回数を減らす (さらに、見苦しいエスケープコードをユーザーに隠す) ことにある。
 226 シーケンスがその端末にとって適切でない場合、 行内のそれぞれのキーワード自身を指定して削除することができる。
 227 .PP
 228 \fB注意：\fP \fBENDCODE\fP が設定ファイルのグローバルセクションで定義されている場合、 ファイルの端末固有セクションで未定義にすることは
 229 \fIできない\fP。 これは、 \fBNORMAL\fP の定義が何も影響を及ぼさないことを意味する。 しかし、異なった \fBENDCODE\fP
 230 を指定することで同じ効果を得ることができる。
 231 .SS エスケープシーケンス
 232 カラーシーケンスやファイル名の拡張子で制御文字やブランク文字を指定するために、 C 言語スタイルの \e エスケープ表記と \fBstty\fP スタイルの
 233 ^ 表記の両方を使うことができる。 C 言語スタイルの表記には以下の文字が含まれる。
 234 .sp
 235 .RS
 236 .TS
 237 lb l.
 238 \ea     ベル (ASCII 7)
 239 \eb     バックスペース (ASCII 8)
 240 \ee     エスケープ (ASCII 27)
 241 \ef     改ページ (ASCII 12)
 242 \en     改行 (ASCII 10)
 243 \er     復帰 (ASCII 13)
 244 \et     タブ (ASCII 9)
 245 \ev     垂直タブ (ASCII 11)
 246 \e?     削除 (ASCII 127)
 247 \e\fInnn        (8 進数表記の) 任意の文字\fP
 248 \fI\exnnn       (16 進数表記の) 任意の文字\fP
 249 \fI\e_  スペース\fP
 250 \fI\e\e バックスラッシュ (\e)\fP
 251 \fI\e^  キャレット (^)\fP
 252 \fI\e#  ハッシュマーク (#)\fP
 253 .TE
 254 .RE
 255 .sp
 256 \fIハッシュマークを最初の文字として入力する場合と同様に、 スペース、 バックスラッシュ、
 257 キャレット、任意の制御文字を、文字列の任意の部分に入力するためには、 エスケープが必要であることに注意すること。\fP
 258 .SH ファイル
 259 .TP
 260 \fI/etc/DIR_COLORS\fP
 261 システム全体の設定ファイル。
 262 .TP
 263 \fI~/.dir_colors\fP
 264 ユーザー毎の設定ファイル。
 265 .PP
 266 このページは fileutils\-4.1 パッケージで使われている \fBdir_colors\fP のファイル形式について説明している。
 267 その他のバージョンでは少し違いがあるかも知れない。
 268 .SH 注意
 269 ISO 6429 端末で使われる \fBLEFTCODE\fP と \fBRIGHTCODE\fP のデフォルトの定義は、次のようになっている。
 270 .sp
 271 .RS
 272 .TS
 273 lb l.
 274 LEFTCODE        \ee[
 275 RIGHTCODE       m
 276 .TE
 277 .RE
 278 .sp
 279 \fBENDCODE\fP のデフォルトは定義されていない。
 280 .SH 関連項目
 281 \fBdircolors\fP(1), \fBls\fP(1), \fBstty\fP(1), \fBxterm\fP(1)
 282 .SH この文書について
 283 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
 284 である。プロジェクトの説明とバグ報告に関する情報は
 285 http://www.kernel.org/doc/man\-pages/ に書かれている。