From a20fe7d0663c7b184a268c2c28a5cca0abcd176a Mon Sep 17 00:00:00 2001 From: Kazuo Horikawa Date: Sun, 24 Sep 2000 00:24:58 +0000 Subject: [PATCH] Add newly translated Japanese manuals. Submitted by:Jpman Project --- ja_JP.eucJP/man/man1/Makefile | 4 +- ja_JP.eucJP/man/man1/less.1 | 1507 ++++++++++++++++++++++++++++++ ja_JP.eucJP/man/man1/lesskey.1 | 395 ++++++++ ja_JP.eucJP/man/man1/more.1 | 341 ------- ja_JP.eucJP/man/man5/Makefile | 1 + ja_JP.eucJP/man/man5/linprocfs.5 | 94 ++ ja_JP.eucJP/man/man8/Makefile | 1 + ja_JP.eucJP/man/man8/faithd.8 | 366 ++++++++ 8 files changed, 2367 insertions(+), 342 deletions(-) create mode 100644 ja_JP.eucJP/man/man1/less.1 create mode 100644 ja_JP.eucJP/man/man1/lesskey.1 delete mode 100644 ja_JP.eucJP/man/man1/more.1 create mode 100644 ja_JP.eucJP/man/man5/linprocfs.5 create mode 100644 ja_JP.eucJP/man/man8/faithd.8 diff --git a/ja_JP.eucJP/man/man1/Makefile b/ja_JP.eucJP/man/man1/Makefile index 7ed2c20098..b076059ff4 100644 --- a/ja_JP.eucJP/man/man1/Makefile +++ b/ja_JP.eucJP/man/man1/Makefile @@ -151,6 +151,8 @@ MAN1 = a2p.1\ ld.1\ ldd.1\ leave.1\ + less.1\ + lesskey.1\ lex.1\ limits.1\ lint.1\ @@ -193,7 +195,6 @@ MAN1 = a2p.1\ mklocale.1\ mkstr.1\ mktemp.1\ - more.1\ mptable.1\ msgs.1\ mt.1\ @@ -425,6 +426,7 @@ MLINKS+=ftp.1 pftp.1 MLINKS+=ftp.1 gate-ftp.1 MLINKS+=hexdump.1 hd.1 MLINKS+=intro.1 introduction.1 +MLINKS+=less.1 more.1 MLINKS+=lex.1 flex.1 MLINKS+=lex.1 flex++.1 MLINKS+=lex.1 lex++.1 diff --git a/ja_JP.eucJP/man/man1/less.1 b/ja_JP.eucJP/man/man1/less.1 new file mode 100644 index 0000000000..8fd27db143 --- /dev/null +++ b/ja_JP.eucJP/man/man1/less.1 @@ -0,0 +1,1507 @@ +.TH LESS 1 "Version 358: 08 Jul 2000" +.\" jpman %Id: less.1,v 1.3 2000/09/21 03:08:29 horikawa Stab % +.\" +.\" 以下は参考にした Linux JM のクレジット +.\" Japanese Version Copyright (c) 1999 Yuichi SATO +.\" all rights reserved. +.\" Translated Fri Sep 17 03:26:44 JST 1999 +.\" by Yuichi SATO +.\"WORD: caret キャレット +.\"WORD: curly bracket 中括弧 +.\"WORD: parentheses 小括弧 +.\"WORD: square bracket 大括弧 +.\"WORD: pound sign シャープ符号 +.\"WORD: window ウィンドウ +.\"WORD: screen 画面 +.\"WORD: literalize 機能打ち消し +.\"WORD: examine (ファイルを)読み込む +.\"WORD: quote 括る (XXX) +.\"WORD: more than one 複数 +.\"WORD: standout 強調 +.\"WORD: text 文字 +.\"WORD: printable characters 印刷可能文字 +.\"WORD: angle bracket 角括弧 + +.SH 名称 +less \- more の反対 +.SH 書式 +.B "less -?" +.br +.B "less --help" +.br +.B "less -V" +.br +.B "less --version" +.br +.B "less [-[+]aBcCdeEfgGiImMnNqQrsSuUVwX]" +.br +.B " [-b \fIbufs\fP] [-h \fIlines\fP] [-j \fIline\fP] [-k \fIkeyfile\fP]" +.br +.B " [-{oO} \fIlogfile\fP] [-p \fIpattern\fP] [-P \fIprompt\fP] [-t \fItag\fP]" +.br +.B " [-T \fItagsfile\fP] [-x \fItab\fP] [-y \fIlines\fP] [-[z] \fIlines\fP]" +.br +.B " [+[+]\fIcmd\fP] [--] [\fIfilename\fP]..." +.br +(長いオプション名による代替オプション文法に関してはオプション節を参照してく +ださい。) + +.SH 解説 +.I less +は +.I more +(1) と似たプログラムですが、 +ファイル内での前方移動と同様に後方移動も可能となっています。 +また +.I less +は起動時に入力ファイル全体を読み込む必要がないため、 +入力ファイルが大きい場合には +.I vi +(1) のようなテキストエディタより速く起動します。 +.I less +は termcap（いくつかのシステムでは terminfo) を使用するため、 +多様な端末上で動作可能です。 +機能は限られてはいますが、ハードコピー端末においてでさえも動作します。 +(ハードコピー端末では、画面の一番上に表示されるべき行には +頭にキャレットが付きます。) +.PP +コマンドは +.I more +と +.I vi +の両方に基づいています。 +コマンドには対し、10 進数値を前に付けることが可能です。 +この数値は、以下の説明においては N で表します。 +コマンドによってはこの数字を使用するものがあり、 +この用法は以下に示します。 + +.SH コマンド +以降の説明で ^X は control-X を意味します。 +ESC は ESCAPE キーです。例えば ESC-v は "ESCAPE" を押した後に "v" を +押すという意味です。 +.IP "h or H" +ヘルプ: これらのコマンドの概要を表示します。 +もし他のコマンド全てを忘れたとしても、このコマンドだけは忘れないでください。 +.IP "SPACE or ^V or f or ^F" +前方に N 行、デフォルトでは 1 ウィンドウスクロールします +(後述する -z オプションを参照してください)。 +N が画面サイズより大きい場合には、 +最後の表示可能な部分のみが表示されます。 +警告: いくつかのシステムでは、 +^V は特殊な機能打ち消し文字として使われています。 +.IP "z" +SPACE と似ていますが、N を指定すると N が新しいウィンドウサイズとなります。 +.IP "ESC-SPACE" +SPACE と似ていますが、ファイルの終わりに達した場合でも +1 画面分スクロールします。 +.IP "RETURN or ^N or e or ^E or j or ^J" +前方に N 行、デフォルトでは 1 行スクロールします。 +たとえ N が画面サイズより大きい場合でも、N 行全てを表示します。 +.IP "d or ^D" +前方に N 行、デフォルトでは半画面スクロールします。 +N が指定された場合、その後の d コマンドと u コマンドの +新しいデフォルトサイズが N になります。 +.IP "b or ^B or ESC-v" +後方に N 行、デフォルトでは 1 ウィンドウスクロールします +(後述する -z オプションを参照してください)。 +N が画面サイズより大きい場合には、 +最後の表示可能な部分のみが表示されます。 +.IP "w" +ESC-v と似ていますが、N を指定すると、N が新しいウィンドウサイズとなります。 +.IP "y or ^Y or ^P or k or ^K" +後方に N 行、デフォルトでは 1 行スクロールします。 +たとえ N が画面サイズより大きい場合でも、N 行全てを表示します。 +警告: いくつかのシステムでは、^Y が特殊なジョブ制御文字として使われています。 +.IP "u or ^U" +後方に N 行、デフォルトでは半画面スクロールします。 +N が指定された場合、その後の d コマンドと u コマンドの +新しいデフォルトサイズが N になります。 +.IP "ESC-) or RIGHTARROW" +右水平方向に N 文字、デフォルトでは画面幅の半分スクロールします +(-# オプションを参照)。 +文字がスクロールされている間、(長い行を切り落とす) -S オプションが +有効であるかのように動作します。 +文字数 N を入力する場合は、 +右矢印キーが行編集コマンド (行編集の節を参照) で使われるため、 +ESC-) を使用しなければなりません。 +.IP "ESC-( or LEFTARROW" +左水平方向に N 文字、デフォルトでは画面幅の半分スクロールします +(-# オプションを参照)。 +.IP "r or ^R or ^L" +画面を再描画します。 +.IP R +画面の再描画をしますが、バッファリングされた入力を破棄します。 +ファイルを閲覧中に、ファイルが変更される場合に便利です。 +.IP "F" +前方にスクロールし、ファイルの末尾に達した後も読み続けようとします。 +通常このコマンドは、既にファイルの終わりに達している場合に使われます。 +このコマンドにより、閲覧中に大きくなり続けるファイルの末尾を +監視できます。 +("tail -f" コマンドと同じような動作をします。) +.IP "g or < or ESC-<" +ファイルの N 行目、デフォルトでは 1 行目 (ファイルの始め) に移動します。 +(警告: N が大きいと遅くなります。) +.IP "G or > or ESC->" +ファイルの N 行目、デフォルトではファイルの終わりに移動します。 +(警告: N が大きい場合や、N が指定されておらず +しかもファイルでなく標準入力から読み込んでいる場合には遅くなります。) +.IP "p or %" +ファイルの N パーセント目の位置に移動します。 +N は 0 から 100 の間でなければなりません。 +.IP "{" +画面内で一番上の行にある左中括弧に対し、 +{ コマンドで対応する右中括弧の位置に移動します。 +対応した右中括弧は画面の最下行に表示されます。 +複数の左中括弧が画面の先頭行にある場合、 +数字 N で行の N 個目の括弧かを指定できます。 +.IP "}" +画面内で一番下の行にある右中括弧に対し、 +} コマンドで対応する左中括弧の位置に移動します。 +対応した左中括弧は画面の先頭行に表示されます。 +複数の右中括弧が画面の先頭行にある場合、 +数字 N で行の N 個目の括弧かを指定できます。 +.IP "(" +{ コマンドと似ていますが、中括弧ではなく小括弧に対して動作します。 +.IP ")" +} コマンドと似ていますが、中括弧ではなく小括弧に対して動作します。 +.IP "[" +{ コマンドと似ていますが、中括弧ではなく大括弧に対して動作します。 +.IP "]" +} コマンドと似ていますが、中括弧ではなく大括弧に対して動作します。 +.IP "ESC-^F" +2 つの文字を続けて入力することで、{ コマンドと似た動作をします。 +2 つの文字はそれぞれ開括弧と閉括弧として扱われます。 +例えば "ESC ^F < >" を実行すると、 +一番上の行に表示されている < に対応する > に進むことができます。 +.IP "ESC-^B" +2 つの文字を続けて入力することで、} コマンドと似た動作をします。 +2 つの文字はそれぞれ開括弧と閉括弧として扱われます。 +例えば "ESC ^B < >" を実行すると、 +一番下の行に表示されている > に対応する < に戻ることができます。 +.IP m +任意の小文字を続けて入力することで、現在の位置を、入力した文字でマークします。 +.IP "'" +(シングルクォート)。 +任意の小文字を続けて入力することで、以前この文字でマークした位置に戻ります。 +シングルクォートをもう 1 つ続けることで、 +「大きく」移動するコマンド実行前の位置に戻ります。 +^ や $ で、それぞれファイルの先頭行と最終行にジャンプします。 +新しいファイルを読み込んでもマークは保存されるので、' コマンドは +入力ファイルの切り替えに使うことができます。 +.IP "^X^X" +シングルクォートと同じです。 +.IP /pattern +ファイルの中で N 番目の pattern を含む行を前方検索します。 +N のデフォルトは 1 です。 +このパターンは +.I ed +で認識される正規表現です。 +検索は画面に表示されている第 2 行から始まります +(しかし -a と -j オプションはこれを変更しますので、参照してください)。 +.sp +いくつかの文字はパターンの始めに置かれた場合は特殊文字とされます。 +これらの文字はパターンの一部としてではなく +検索方法を変更するために使われます: +.RS +.IP "^N or !" +パターンにマッチしない行を検索します。 +.IP "^E or *" +複数のファイルを検索します。 +つまり、検索がマッチしないまま現在のファイルの終わりに達した場合、 +コマンドラインリストにある次のファイルで検索を続行します。 +.IP "^F or @" +現在の画面表示や -a または -j オプションの設定に関係なく、 +コマンドラインリストの最初のファイルの先頭行から +検索を開始します。 +.IP "^K" +現在の画面中でマッチする全てのパターンをハイライト表示しますが、 +一番始めのマッチする位置へは移動しません (現在の位置を保持します)。 +.IP "^R" +正規表現のメタキャラクタを解釈しません。 +つまり、単純な文字列比較を行います。 +.RE +.IP ?pattern +ファイルの中で N 番目の pattern を含む行を後方検索します。 +検索は、画面の一番上に表示されている行の直前の行から行います。 +.sp +/ コマンドの時と同様に、いくつかの文字は特殊です: +.RS +.IP "^N or !" +パターンにマッチしない行を検索します。 +.IP "^E or *" +複数のファイルで検索します。 +つまり、検索がマッチしないまま現在のファイルの先頭に達した場合、 +コマンドラインリストにある前のファイルで検索を続行します。 +.IP "^F or @" +現在の画面表示や -a または -j オプションの設定に関係なく、 +コマンドラインリストにある最後のファイルの最終行から +検索を開始します。 +.IP "^K" +前方検索の時と同じです。 +.IP "^R" +前方検索の時と同じです。 +.RE +.IP "ESC-/pattern +"/*" と同じです。 +.IP "ESC-?pattern" +"?*" と同じです。 +.IP n +前回使用した検索パターンを含む N 番目の行に対して検索を繰り返します。 +前回の検索が ^N で修飾されていた場合、 +パターンを含まない N 番目の行を検索します。 +前回の検索が ^E で修飾されていた場合、現在のファイルで条件が満たされない +場合には、次の (前の) ファイルで検索を続けます。 +前回の検索が ^R で修飾されていた場合、正規表現を用いずに検索を行います。 +前回の検索が ^F または ^K で修飾されていた場合、その効果はなくなります。 +.IP N +前回の検索を逆方向に繰り返します。 +.IP "ESC-n" +前回の検索をファイル境界を越えて繰り返します。 +前回の検索が * によって修飾されていた場合と同じです。 +.IP "ESC-N" +前回の検索を逆方向にファイル境界を越えて繰り返します。 +.IP "ESC-u" +検索結果のハイライト表示を元の状態に戻します。 +現在の検索パターンにマッチした文字列のハイライト表示をオフにします。 +もし既に以前の ESC-u コマンドによりハイライト表示がオフになっている場合は、 +ハイライトをオンに戻します。全ての検索コマンドも +ハイライト表示をオンに戻します。 +(-G オプションでもハイライトをオフに切り替えることができます。 +この場合検索コマンドでハイライトがオンになることはありません。) +.IP ":e [filename]" +新しいファイルを読み込みます。 +ファイル名が指定されなかった場合は、コマンドラインのファイルリストから +「現在の」ファイル (後述する :n と :p コマンド参照) が読み直されます。 +filename 中のパーセント記号 (%) は現在のファイル名で置き換えられます。 +filename 中のシャープ記号 (#) は前に読み込んだファイル名で置き換えられます。 +しかし、2 つ続けたパーセント記号は、 +単純に 1 つのパーセント記号に置き換えられます。 +これはパーセント記号を含むファイル名を入力できるようにするためです。 +同様に、2 つ続けたシャープ記号は、 +1 つのシャープ記号に置き換えられます。 +このファイル名は、ファイルのコマンドラインリストに挿入されるので、 +その後の :n コマンドと :p コマンドで閲覧できるようになります。 +filename に複数のファイルを指定すると、全てをファイルリストに加え、 +最初のファイルを読み込みます。 +ファイル名が、複数のスペースを含む場合、 +ファイル名全体はダブルクォートで囲まれていなければなりません +(-" オプションも参照してください)。 +.IP "^X^V or E" +:e コマンドと同じです。 +警告: いくつかのシステムでは ^V が特殊な機能打ち消し文字として +使われています。 +そのようなシステムでは、^V を使うことはできないでしょう。 +.IP ":n" +(コマンドラインで与えられたファイルリストから) 次のファイルを読み込みます。 +数字 N が指定されている場合は、N 個後のファイルを読み込みます。 +.IP ":p" +コマンドラインリストの中にある前のファイルを読み込みます。 +数字 N が指定されている場合は、N 個前のファイルを読み込みます。 +.IP ":x" +コマンドラインリストの中の一番最初のファイルを読み込みます。 +数字 N が指定されている時は、N 番目のファイルを読み込みます。 +.IP ":d" +現在閲覧中のファイルをファイルリストから削除します。 +.IP "= or ^G or :f" +閲覧中のファイルについて、ファイル名、 +表示中の最下行の行番号とバイトオフセットといった情報を表示します。 +可能な場合には、ファイルの長さ、ファイルの行数、 +表示中の最下行より上にあるファイルの割り合い (パーセント) も表示します。 +.IP \- +コマンドラインオプション文字 (後述するオプション参照) のうちの 1 つを続けて +入力することで、オプション設定を変更し新しい設定を解説するメッセージを +表示します。 +ダッシュの直後に ^P (CONTROL-P) が入力された場合、 +オプションの設定は変更されますが、メッセージは表示されません。 +オプション文字が、(-b や -h のように) 数値を持ったり、 +(-P や -t のように) 文字列値を持つ場合、 +オプション文字の後に新しい値を入力します。 +値を入力しなかった場合、現在の設定を示すメッセージを +表示するのみで、設定は変わりません。 +.IP \-\- +\- コマンドと似ていますが、1 文字オプションではなく、 +長いオプション名 (後述するオプション節を参照) を受け付けます。 +オプション名を打ち込んだ後に RETURN を押す必要があります。 +2 個目のダッシュ直後の ^P は \- コマンドと同じように、新しい設定を +解説するメッセージの表示を抑制します。 +.IP \-+ +コマンドラインオプション文字のうちの 1 つを続けて入力することで、 +オプションをデフォルト設定に戻して、新しい設定を表示します。 +("\-+\fIX\fP" コマンドは、 +コマンドラインで "\-+\fIX\fP" とするのと同じです。) +このコマンドは文字列の値を持つオプションには働きません。 +.IP \-\-+ +\-+ コマンドと似ていますが、1 文字オプションではなく、 +長いオプション名を受け付けます。 +.IP \-! +コマンドラインオプション文字のうちの 1 つを続けて入力することで、 +オプションをデフォルト設定の「反対」にして、新しい設定を表示します。 +このコマンドは数値または文字列の値を持つオプションには働きません。 +.IP \-\-! +\-! コマンドと似ていますが、1 文字オプションではなく、 +長いオプション名を受け付けます。 +.IP _ +(アンダスコア。) +コマンドラインオプション文字のうちの 1 つを続けて入力することで、 +そのオプションの現在設定を表示します。 +オプションの設定は変化しません。 +.IP __ +(2 つのアンダスコア。) +_ (アンダスコア) コマンドと似ていますが、1 文字オプションではなく、 +長いオプション名を受け付けます。 +オプション名を打ち込んだ後に RETURN を押す必要があります。 +.IP +cmd +新しいファイルを読み込む度に、指定したコマンド cmd を実行します。 +例えば +G は +.I less +がファイルを最初に表示する際に、始めではなく終わりから表示させます。 +.IP V +現在起動している +.I less +のバージョンを表示します。 +.IP "q or Q or :q or :Q or ZZ" +.I less +を終了します。 +.PP +以下の 4 つのコマンドが有効であるかどうかは、 +インストールした方法に依存します。 +.PP +.IP v +現在閲覧しているファイルを編集するため、エディタを起動します。 +エディタは、環境変数 VISUAL が定義されている場合はその値が用いられます。 +VISUAL が定義されていない時は、EDITOR の値が使われます。 +もし VISUAL も EDITOR も定義されていない場合は、"vi" がデフォルトになります。 +後述するプロンプト節の LESSEDIT に関する話題も参照してください。 +.IP "! shell-command" +与えられたシェルコマンドを実行するため、シェルを起動します。 +コマンド中のパーセント記号 (%) は現在のファイル名で置き換えられます。 +コマンド中のシャープ記号 (#) は前に読み込んだファイル名で置き換えられます。 +"!!" は、直前のシェルコマンドを繰り返します。 +シェルコマンドを伴わない "!" は、単にシェルを起動します。 +Unix システムでは、シェルは環境変数 SHELL で設定されたもの、もしくは +デフォルトの "sh" です。 +MS-DOS や OS/2 システムでは、シェルは通常のコマンドプロセッサです。 +.IP "| shell-command" + は任意のマーク文字です。 +入力ファイルのある部分を、与えられたシェルコマンドにパイプで渡します。 +渡されるファイルの部分は、現在の画面の一番上の行から +文字でマークされた場所までです。 + が ^ と $ の場合、それぞれファイルの先頭行と最終行を示します。 + が . または改行の場合、現在の画面がパイプで渡されます。 +.IP "s filename" +入力をファイルに保存します。 +このオプションは入力が一般のファイルでなく、パイプの時のみ有効です。 +.PP +.SH オプション +コマンドラインオプションを以下に説明します。 +大部分のオプションは +.I less +の実行中に "\-" コマンドを用いて変更できます。 +.PP +多くのオプションは 1 つのダッシュの後に 1 つの文字か、または +2 つのダッシュの後に長いオプション名の 2 つの形式のうち片方で指定できます。 +長いオプション名は省略があいまいでない長さまで省略できます。 +例えば --quit-at-eof は --quit と省略できますが、 +--quit-at-eof と --quiet の両方が --qui で始まるので、 +--qui とは省略できません。 +いくつかの長いオプション名は --QUIT-AT-EOF のように、 +--quit-at-eof とは別に大文字になっています。 +このようなオプション名は最初の 1 文字が大文字になっていればよく、 +名前の残りは大文字でも小文字でも構いません。 +例えば --Quit-at-eof は --QUIT-AT-EOF と同等です。 +.PP +オプションは環境変数 "LESS" の値からも取られます。 +例えば +.I less +を起動する度に "less -options ..." とタイプするのを避けるには、 +.I csh +では: +.sp +setenv LESS "-options" +.sp +.I sh +を使っている場合は: +.sp +LESS="-options"; export LESS +.sp +とします。 +MS-DOS 上では、クォートする必要はありませんが、オプション文字列中の +パーセント記号を 2 つのパーセント記号に置き換える必要があります。 +.sp +環境変数は、コマンドラインより先に解析されますので、 +コマンドラインオプションは、環境変数 LESS に優先します。 +あるオプションが環境変数 LESS にあった場合でも、 +コマンドラインオプションに "-+" を含めて起動すると、そのオプションは +デフォルトにリセットされます。 +.sp +-P または -D オプションのように、後に文字列が続くオプションでは、 +ドル記号 ($) が文字列の終わりを表す記号として使われます。 +例えば MS-DOS 上で -D オプションを 2 つ設定するには、下記のように +それらの間にドル記号を入れる必要があります: +.sp +LESS="-Dn9.1$-Ds4.1" +.sp +.IP "-? or --help" +このオプションは、 +.I less +が受け付けるコマンドの概要を表示します (h コマンドと同じです)。 +(使用しているシェルが疑問符をどのように解釈するかに依存し、 +"-\\?" のように疑問符をクォートする必要があるかもしれません。) +.IP "-a or --search-skip-screen" +画面に表示されている最下行の次の行から検索を開始します。 +つまり、現在画面に表示されている行中の検索は行いません。 +デフォルトでは、検索は画面中の第 2 行目 +(もしくは最後に検索対象が見付かった行のあと; -j オプション参照) +から行われます。 +.IP "-b\fIn\fP or --buffers=\fIn\fP" +.I less +が各ファイルに対して使うバッファの数を指定します。 +各バッファは 1K で、 +デフォルトでは各ファイルに対し 10 個のバッファが使われます +(ただし、ファイルがパイプの場合は例外です; -B オプションを参照)。 +数字 \fIn\fP で、使用するバッファの数を指定します。 +.IP "-B or --auto-buffers" +データがパイプから読み込まれる場合、 +デフォルトではバッファは必要に応じて自動的に割り当てられます。 +そのため、大容量のデータがパイプから読み込まれる場合、 +多くのメモリを割り当ててしまいます。 +-B オプションはパイプでの自動的な割り当てを禁止しますので、 +-b オプションで指定されたバッファ数のみを使用します。 +警告: -B オプションを使った場合、ファイルの最も最近閲覧している +部分しかメモリに保持されず以前のデータが無くなっているため、 +誤った表示になる場合があります。 +.IP "-c or --clear-screen" +全画面の最描画を、先頭行から下に向かって行わせるようにします。 +デフォルトでは、 +全画面の最描画は、画面の最終行からのスクロールによって行われます。 +.IP "-C or --CLEAR-SCREEN" +-C オプションは、-c オプションと似ていますが、 +画面をクリアしてから最描画します。 +.IP "-d or --dumb" +-d オプションは端末がダム端末の場合、 +通常表示されるエラーメッセージの表示を抑制します。 +ダム端末とは画面のクリア、後方にスクロールといった +いくつかの重要な機能がない端末のことをいいます。 +-d オプションは、それ以外の点についてはダム端末における +.I less +.\" XXX 原文 ) が余計？ +の挙動を変化させません。 +.IP "-D\fBx\fP\fIcolor\fP or --color=\fBx\fP\fIcolor\fP" +[MS-DOS のみ] +表示する文字の色を設定します。 +\fBx\fP は設定する文字の種類を表す 1 文字です: +n=標準, s=強調, d=太字, u=下線, k=点滅。 +\fIcolor\fP は、ピリオドで区切られた数値の組です。 +1 つ目の数値で文字の前景色、2 つ目の数値で文字の背景色を選びます。 +単独の数値、\fIN\fP は、\fIN.0\fP と同じです。 +.IP "-e or --quit-at-eof" +ファイルの終わりに 2 度達した際に、自動的に +.I less +を終了させます。 +デフォルトでは、 +.I less +は "q" コマンドでのみ終了できます。 +.IP "-E or --QUIT-AT-EOF" +ファイルの終わりに 1 度達した際に、自動的に +.I less +を終了させます。 +.IP "-f or --force" +非標準ファイルを強制的にオープンさせます。 +(非標準ファイルとは、ディレクトリまたは +デバイス型特殊ファイルのことです。) +またバイナリファイルをオープンする際の警告メッセージも表示しません。 +デフォルトでは +.I less +は非標準ファイルのオープンを拒否します。 +.IP "-F or --quit-if-one-screen" +ファイル全体が最初の画面に表示可能だった場合には、 +.I less +を自動的に終了させます。 +.IP "-g or --hilite-search" +通常、 +.I less +は、前回の検索コマンドでマッチした画面中全ての文字列をハイライト表示します。 +-g オプションは、この動作を前回の検索コマンドでマッチした文字列のみを +ハイライト表示するように変更します。 +このオプションは、 +.I less +の動作をデフォルトより多少速くします。 +.IP "-G or --HILITE-SEARCH" +-G オプションは、検索コマンドで見付かった文字列に対する +全てのハイライト表示を抑制します。 +.IP "-h\fIn\fP or ---max-back-scroll=\fIn\fP" +後方にスクロールする最大行数を指定します。 +もし \fIn\fP 行を上回って後方にスクロールする必要がある場合は、 +代わりに画面が前方に向かって最描画されます。 +(ターミナルが後方に戻る機能を持たない場合は、-h0 が暗に意味されています。) +.IP "-i or --ignore-case" +大文字小文字の区別をしません。 +つまり、大文字と小文字を同一と見なして検索を行います。 +このオプションは、検索パターンに大文字が含まれていた場合には無視されます。 +いいかえると、検索パターンに大文字が含まれていた場合、 +大文字小文字の区別をした検索をします。 +.IP "-I or --IGNORE-CASE" +-i コマンドと似ていますが、検索パターンが大文字を含んでいた場合でも、 +大文字小文字の違いを無視して検索をします。 +.IP "-j\fIn\fP or --jump-target=\fIn\fP" +「ターゲット」行の位置を画面上の何行目に表示するか指定します。 +ターゲット行とは、文字検索、タグ検索、行番号へのジャンプ、 +ファイルのパーセンテージでのジャンプ、マーク位置へのジャンプ +の対象となる行です。 +画面の行は数字で指定します: 画面の一番上の行は 1、その次の行は 2、 +以下同様に指定します。 +画面の最終行から何行目かを指定する場合は、数値を負に指定します: +画面の一番下の行は -1、下から 2 行目は -2、以下同様に指定します。 +-j オプションが用いられている場合、 +検索はターゲット行の直後の行から始まります。 +例えば "-j4" の場合、ターゲット行は画面の 4 行目なので、 +検索は画面の 5 行目から始まります。 +.IP "-J or --status-column" +画面の左端にステータスカラムを表示します。 +ステータスカラムは -w または -W オプションが有効な場合のみ使用されます。 +.IP "-k\fIfilename\fP or --lesskey-file=\fIfilename\fP" +指定したファイルを +.I lesskey +(1) のファイルであるとして +.I less +にオープンさせ、処理させます。 +複数の -k オプションを指定することもできます。 +環境変数 LESSKEY または LESSKEY_SYSTEM が設定された場合、あるいは +lesskey ファイルが標準位置 (キー割り当ての節を参照) に見付かった場合、 +そのファイルも +.I lesskey +ファイルとして使用されます。 +.IP "-m or --long-prompt" +.I less +に (\fImore\fP のような)、 +冗長なパーセント表示のプロンプトを表示させます。 +デフォルトでは、 +.I less +は、コロンのプロンプトを表示します。 +.IP "-M or --LONG-PROMPT" +.I more +より、さらに冗長なプロンプトを +.I less +に表示させます。 +.IP "-n or --line-numbers" +行番号の使用を抑制します。 +(行番号を使用する) デフォルトの設定では、 +特に、入力ファイルが非常に大きな場合に +.I less +の速度の低下を引き起こすことがあります。 +-n オプションで行番号の使用を抑制することで、この問題を避けられます。 +行番号の使用とは、冗長なプロンプトと = コマンドでの行番号の表示と、 +v コマンドが現在の行番号をエディタに渡すことです +(下記のプロンプト節における LESSEDIT に関する話題も参照してください)。 +.IP "-N or --LINE-NUMBERS" +画面の各行の先頭に行番号を表示します。 +.IP "-o\fIfilename\fP or --log-file=\fIfilename\fP" +.I less +の入力ファイルを閲覧されている状態のまま、 +指定した名前のファイルにコピーします。 +このオプションは入力ファイルが通常ファイルではなく、 +パイプである場合にのみ適用されます。 +ファイルが既に存在する場合は、 +.I less +は上書きする前に確認を求めます。 +.IP "-O\fIfilename\fP or --LOG-FILE=\fIfilename\fP" +-O オプションは -o に似ていますが、 +既にあるファイルを確認することなく上書きします。 +.sp +ログファイルが指定されてない場合、 +-o と -O オプションは、 +.I less +のなかから、ログファイルを指定するために使えます。 +ファイル名を指定しない場合は、単にログファイル名を表示するだけです。 +"s" コマンドは、 +.I less +のなかから、-o を指定するのと同等です。 +.IP "-p\fIpattern\fP or --pattern=\fIpattern\fP" +コマンドラインでの -p オプションは、 ++/\fIpattern\fP を指定するのと同じです。つまり、 +.I less +はファイル中で \fIpattern\fP が最初に現れるところから表示を開始します。 +.IP "-P\fIprompt\fP or --prompt=\fIprompt\fP" +3 つのプロンプトスタイルを好みに合わせて仕立てる方法を提供します。 +このオプションは通常、 +.I less +コマンドを呼び出す度に打込んだりせずに、 +環境変数 LESS で指定します。 +このオプションは、変数 LESS の中で +最後のオプションになっているか、 +ドル記号で終了している必要があります。 +-Ps の後の文字列は、デフォルトの (短い) プロンプトを +その文字列に変更します。 +-Pm は、中間の (-m) プロンプトを変更します。 +-PM は、長い (-M) プロンプトを変更します。 +-Ph は、ヘルプ画面のプロンプトを変更します。 +-P= は、= コマンドで表示されるメッセージを変更します。 +全てのプロンプト文字列は、 +文字と特別なエスケープシーケンスの連続から構成されます。 +詳細は、プロンプト節を参照してください。 +.IP "-q or --quiet or --silent" +適度に「静かな」動作にします: +ファイルの終わりを越えて、またはファイルの始まりを越えて +スクロールしようとした場合に端末ベルが鳴らなくなります。 +端末が「ビジュアルベル」を持っている場合は代わりにそれを使います。 +無効な文字を打った時のような、 +その他の確かなエラーに関してはベルを鳴らします。 +デフォルトでは、全ての場合において端末ベルを鳴らします。 +.IP "-Q or --QUIET or --SILENT" +完全に「静かな」動作にします: +端末ベルは全く鳴らしません。 +.IP "-r or --raw-control-chars" +制御文字を「そのまま」表示します。 +デフォルトでは、制御文字をキャレットを使って表示します。 +例えば control-A (8 進数 001) は、"^A" と表示します。 +警告: -r オプションが使われると、 +.I less +は、(画面が各制御文字の種類にどのように反応するかに依存しているために) +画面の実際の表示状態を追うことができません。 +よって長い行が誤った位置で分割されてしまうといったような、 +多くの表示上の問題が生じます。 +.IP "-R or --RAW-CONTROL-CHARS" +-r と似ていますが、可能な限り画面の表示状態を追おうとします。 +この機能は入力が通常の文字といくつかの ANSI 「カラー」エスケープシーケンス +からなっている場合にのみ働きます。 +ANSI 「カラー」エスケープシーケンスとは +.sp + ESC [ ... m +.sp +のような形式で、"..." には 0 個以上の "m" でない文字が入ります。 +画面表示状態を追うために、全ての制御文字と +全ての ANSI カラーエスケープシーケンスは +カーソルを動かさないと仮定されます。 +カラーエスケープシーケンスを終了させることのできる文字のリストを +LESSANSIENDCHARS 環境変数に設定することにより、"m" 以外の文字が +ANSI カラーエスケープシーケンスを終了できることを +.I less +に教えることができます。 +.IP "-s or --squeeze-blank-lines" +連続した空白行を、1 行の空白行にまとめます。 +これは、 +.I nroff +の出力を閲覧する際に便利です。 +.IP "-S or --chop-long-lines" +画面幅より長い行を折り返さずに切り捨てます。 +つまり、長い行の残りの部分を単純に捨ててしまいます。 +デフォルトでは長い行を折り返します。つまり残りが次の行に表示されます。 +.IP "-t\fItag\fP or --tag=\fItag\fP" +-t オプションの直後にはタグ名が続き、そのタグを含むファイルを編集します。 +このオプションを使うためには、 +.I ctags +(1) コマンドであらかじめ作られた "tags" と呼ばれる +ファイルがカレントディレクトリにある必要があります。 +このオプションは、 +.I less +の中から (\- コマンドを用いて) 新しいファイルを読み込む方法として +指定することもできます。 +コマンド ":t" は、 +.I less +の中で、-t を指定するのと同じです。 +.IP "-T\fItagsfile\fP or --tag-file=\fItagsfile\fP" +"tags" の代わりに使用するタグファイルを指定します。 +.IP "-u or --underline-special" +バックスペースと復帰文字 (carrage return) を印刷可能文字として扱います。 +つまり、これらが入力に現れた時は端末に送られます。 +.IP "-U or --UNDERLINE-SPECIAL" +バックスペース、タブ、復帰文字を制御文字として扱います。 +つまり、これらの文字は -r オプションで指定されたものとして扱います。 +.sp +-u と -U のどちらも指定されていない場合、デフォルトでは +下線文字の隣にあるバックスペースは特別に扱われます。 +すなわち、 +下線の引かれた文字が、端末のハードウェア下線機能を使って表示されます。 +さらに、同一の 2 文字の間にあるバックスペースも特別な扱われ方をします。 +すなわち、 +重ね打ちされた文字が、端末のハードウェア太字機能を使って表示されます。 +その他のバックスペースは、前の文字と共に削除されます。 +直後に改行が続く復帰文字は、削除されます。 +その他の復帰文字は -r オプションで指定されたように扱われます。 +重ね打ちや下線の引かれた文字の検索は +-u と -U のどちらも有効でない場合にのみ可能です。 +.IP "-V or --version" +.I less +のバージョン番号を表示します。 +.IP "-w or --hilite-unread" +1 ページ前方に移動した後最初の「新しい」行を一時的にハイライト表示します。 +最初の「新しい」行とは、移動前に画面の最後だった行の直後の行のことです。 +また g や p コマンドの後、ターゲット行をハイライト表示します。 +ハイライト表示は次の移動を伴うコマンドで消去されます。 +行の全てがハイライト表示されますが、-J オプションが有効な場合は、 +ステータスカラムのみがハイライト表示されます。 +.IP "-W or --HILITE-UNREAD" +-w と似ていますが、1 行より多く前方に移動する全てのコマンドのあと、 +最初の新しい行を一時的にハイライト表示します。 +.IP "-x\fIn\fP or --tabs=\fIn\fP" +タブストップを \fIn\fP 文字ごとに設定します。 +デフォルトの \fIn\fP は 8 です。 +.IP "-X or --no-init" +.\" XXX deinitialize って非初期化でいいの？ +ターミナルに、termcap 初期化文字列と非初期化文字列を送らないようにします。 +画面をクリアする際のように非初期化文字列が何か不必要なことをする場合には、 +望ましい場合があります。 +.IP "-y\fIn\fP or --max-forw-scroll=\fIn\fP" +前方にスクロールする最大行数を指定します。 +もし \fIn\fP 行を上回って前方にスクロールする必要がある場合は、 +代わりに画面が最描画されます。 +必要ならば、-c か -C オプションを使用して、 +画面の先頭から最描画できます。 +デフォルトでは、全ての前方移動はスクロールになります。 +.IP "-[z]\fIn\fP or --window=\fIn\fP" +デフォルトのスクロールするウィンドウの大きさを \fIn\fP 行に変更します。 +デフォルトは 1 画面分の行数です。 +z と w コマンドはウィンドウの大きさを変更するためにも使えます。 +z は、 +.I more +との互換性のために省略できます。 +数値 +.I n +が負の場合は、現在の画面サイズより +.I n +行小さくウィンドウサイズを設定することを意味しています。 +例えば画面が 24 行の場合、\fI-z-4\fP はスクロールする +ウィンドウを 20 行に設定することを意味しています。 +画面が 40 行に変更された場合には、 +スクロールウィンドウは自動的に 36 行に変更されます。 +.IP -"\fIcc\fP\ or\ --quotes=\fIcc\fP +ファイル名をクォートする文字を変更します。 +スペースとクォート文字の両方を含むファイル名を指定する場合には +このオプションが必要となるでしょう。 +1 文字続けた場合、クォート文字が指定した文字に変更されます。 +この場合スペースを含むファイル名はダブルクォートではなく、 +この文字で囲まなければなりません。 +また、2 文字続けた場合は、 +1 文字目が開クォートに、2 文字目が閉クォートになります。 +この場合スペースを含むファイル名の前に開クォート文字をおき、 +ファイル名の後に閉クォート文字をおきます。 +引用文字を変更した後でも、このオプションは -" +(ダッシュの後にダブルクォート) のままであることに注意してください。 +.IP "-~ or --tilde" +通常、ファイルの終わりより後の行は、1 つのチルダ (~) で表示されます。 +このオプションを使うと、ファイルの終わりより後の行を空白行で表示します。 +.IP "-# or --shift" +RIGHTARROW と LEFTARROW コマンドで水平スクロールする +デフォルトの桁数を指定します。 +0 を指定した場合には、デフォルトの数は画面幅の半分の桁数になります。 +.IP -- +コマンドライン引き数 "--" は、オプション引数の終わりを示します。 +この後の、いかなる引数もファイル名として解釈されます。 +このオプションは、"-" や "+" で名前が始まる +ファイルを閲覧する場合に便利です。 +.IP + +あるコマンドラインオプションが \fB+\fP で始まる場合、 +オプションの残りは、 +.I less +に初期コマンドとして渡されます。 +例えば +G は、 +.I less +が、ファイルの始めではなくファイルの終わりを表示して起動するように働きます。 +また、オプション +/xyz は、ファイル中で "xyz" が初めて現れる場所から +起動させるように働きます。 +特殊な場合として、+ は +g と同じ働きをします。 +つまり、このオプションでは指定された行番号から表示が始まります +(ただし、上記の "g" コマンドの注意書きを参照のこと)。 +もしこのオプションが ++ で始められた場合は、 +初期コマンドは閲覧する最初のファイルにだけでなく +全てのファイルに対して適用されます。 +上述した "+" コマンドも、全てのファイルに対する初期コマンドの +設定 (および変更) に使われます。 + +.SH "行編集" +画面の一番下でコマンドラインに (例えば :e コマンドに対するファイル名や、 +検索コマンドに対するパターンを) 入力する際に、 +いくつかのキーをコマンドラインを操作するために使用できます。 +多くのコマンドは、ある種のキーボードでキーが存在しない場合でも +使用できるように、[ 大括弧 ] 中にある代替形式を持っています。 +(大括弧の中の形式は、MS-DOS 版では機能しません。) +これらの特殊キーはどれでも、^V や ^A といった「リテラル」文字を +前に置くことで文字として入力できます。 +バックスラッシュ自身は、2 つのバックスラッシュを入力することで、 +文字として入力できます。 +.IP "LEFTARROW [ ESC-h ]" +カーソルを 1 文字分左へ移動します。 +.IP "RIGHTARROW [ ESC-l ]" +カーソルを 1 文字分右へ移動します。 +.IP "^LEFTARROW [ ESC-b or ESC-LEFTARROW ]" +(CONTROL と LEFTARROW を同時入力) +カーソルを 1 単語分左へ移動します。 +.IP "^RIGHTARROW [ ESC-w or ESC-RIGHTARROW ]" +(CONTROL と RIGHTARROW を同時入力) +カーソルを 1 単語分右へ移動します。 +.IP "HOME [ ESC-0 ]" +カーソルを行頭へ移動します。 +.IP "END [ ESC-$ ]" +カーソルを行末へ移動します。 +.IP "BACKSPACE" +カーソルの左にある文字の消去、 +または、コマンドラインが空の場合にコマンドをキャンセルします。 +.IP "DELETE or [ ESC-x ]" +カーソルの下にある文字を消去します。 +.IP "^BACKSPACE [ ESC-BACKSPACE ]" +(CONTROL と BACKSPACE を同時入力) +カーソルの左にある単語を消去します。 +.IP "^DELETE [ ESC-X or ESC-DELETE ]" +(CONTROL と DELETE を同時入力) +カーソルの下にある単語を消去します。 +.IP "UPARROW [ ESC-k ]" +前のコマンドラインを呼び出します。 +.IP "DOWNARROW [ ESC-j ]" +次のコマンドラインを呼び出します。 +.IP "TAB" +カーソルの左にある部分的なファイル名を補完します。 +複数のファイル名にマッチした場合は、 +最初にマッチしたファイル名がコマンドラインに入力されます。 +TAB を繰り返し打つと、マッチした他のファイル名を順番に表示します。 +補完したファイル名がディレクトリの場合、"/" がファイル名に付け加えられます。 +(MS-DOS システムでは、"\\" が付け加えられます。) +ディレクトリ名に異なる文字を付け加えたい場合は、 +環境変数 LESSSEPARATOR で指定できます。 +.IP "BACKTAB [ ESC-TAB ]" +TAB と似ていますが、マッチしたファイル名を逆順に循環して入力します。 +.IP "^L" +カーソルの左にある部分的なファイル名を補完します。 +複数のファイル名にマッチした場合は、 +(もし収まれば) マッチした全てのファイル名がコマンドラインに入力されます。 +.IP "^U (Unix) or ESC (MS-DOS)" +全てのコマンドラインを消去するか、 +またはコマンドが空の場合にはコマンドをキャンセルします。 +Unix において、line-kill 文字を ^U 以外の文字に変更している場合は、 +その文字が ^U の代わりに使われます。 + +.SH "キー割り当て" +lesskey ファイルを作成する +.I lesskey +(1) を用いて、独自の +.I less +コマンドを定義できます。 +このファイルはコマンドキーの集合と +それぞれのキーに関係づけられた動作を指定します。 +また、 +.I lesskey +を使って行編集キー (行編集を参照) を変更したり、 +環境変数を設定したりできます。 +環境変数 LESSKEY が設定されている場合には、 +.I less +は lesskey ファイル名としてその値を使用します。 +設定されていない場合、 +.I less +は、標準の位置にある lesskey ファイルを探します: +Unix システムでは、 +.I less +は "$HOME/.less" という名前のファイルを探します。 +MS-DOS と Windows システムでは、 +.I less +は "$HOME/_less" という lesskey ファイルを探し、 +そこに見つからないない場合は、 +環境変数 PATH で指定されている全てのディレクトリの下にある +"_less" という lesskey ファイルを探します。 +OS/2 システムでは、 +.I less +は "$HOME/less.ini" という lesskey ファイルを探し、 +見つからない場合は、環境変数 INIT で指定されている全てのディレクトリの下にある +"less.ini" ファイルを探し、 +そこに見つからない場合は、 +環境変数 PATH で指定されている全てのディレクトリの下にある +"less.ini" ファイルを探します。 +詳細は、 +.I lesskey +のマニュアルページを参照してください。 +.P +システム標準 lesskey ファイルを用いて +キー割り当てを提供することもできます。 +あるキーがローカル lesskey ファイルとシステム標準ファイルの両方に +見つかった場合は、システム標準のものよりもローカルファイルの +キー割り当てが優先されます。 +環境変数 LESSKEY_SYSTEM が設定されていた場合は、 +.I less +はシステム標準 lesskey ファイルとしてその値を使用します。 +設定されてない場合、 +.I less +はシステム標準 lesskey ファイルを標準の場所で探します。 +Unix システムでは、システム標準ファイルは /usr/local/bin/.sysless です。 +(ただし、 +.I less +が /usr/local/bin とは別のバイナリディレクトリで作成されていた場合は、 +そのディレクトリで .sysless は見つかります。) +MS-DOS と Windows システムでは、 +システム標準 lesskey ファイルは c:\\_sysless です。 +OS/2 システムでは、 +システム標準 lesskey ファイルは c:\\sysless.ini です。 + +.SH 入力プリプロセッサ +.I less +に対して、「入力プリプロセッサ」を定義できます。 +.I less +はファイルをオープンする前に、まず入力プリプロセッサで +入力ファイルの内容の表示方法を変更する機会を与えます。 +入力プリプロセッサは、ファイルの内容を +代替ファイルと呼ばれる別ファイルに書き出す +単純な実行可能プログラム (またはシェルスクリプト) です。 +そして代替ファイルの内容がオリジナルファイルの内容の代わりに表示されます。 +しかし、ユーザにとってはオリジナルファイルが +オープンされているかのように見えます。 +つまり +.I less +は現在のファイルの名前としてオリジナルファイルの名前を表示します。 +.PP +入力プリプロセッサは、ユーザによって入力された +オリジナルファイル名をコマンドライン引数として 1 つ受け付けます。 +入力プリプロセッサは代替ファイルを作成し、 +また終了した際に代替ファイル名を標準出力に表示しなければなりません。 +入力プリプロセッサが代替ファイル名を出力しない場合は、 +.I less +は通常どおりオリジナルファイルを使用します。 +入力プリプロセッサは、標準入力を閲覧する場合には呼び出されません。 +入力プリプロセッサを設定するためには、 +入力プリプロセッサを呼び出すコマンドラインを環境変数 LESSOPEN に設定します。 +このコマンドラインは、文字列 "%s" を 1 つ含んでいなければなりません。 +これは、入力プリプロセッサコマンドが呼び出される際に、 +ファイル名に置き換えられます。 +.PP +.I less +がそのようにしてオープンしたファイルをクローズする際には、 +入力ポストプロセッサと呼ばれるもう 1 つのプログラムを呼び出します。 +このプログラムは、(LESSOPEN によって作られた代替ファイルを消去するといった) +必要な全ての後処理を行います。 +このプログラムは、ユーザによって入力されたオリジナルファイル名と +代替ファイル名の 2 つを引数として受け付けます。 +入力ポストプロセッサを設定するためには、 +入力ポストプロセッサを呼び出すコマンドラインを +環境変数 LESSCLOSE に設定します。 +入力ポストプロセッサコマンドはファイル名に置き換えられる +文字列 "%s" を 2 つ含んでいます。1 つ目はファイルのオリジナルの +名前に置き換えられ、2 つ目は LESSOPEN の出力である +代替ファイルの名前に置き換えられます。 +.PP +例えば多くの Unix システムでは、次の 2 つのスクリプトにより +圧縮されているファイルを圧縮された状態のまま +.I less +でそのファイルを直接閲覧できます。 +.PP +lessopen.sh: +.br + #! /bin/sh +.br + case "$1" in +.br + *.Z) uncompress -c $1 >/tmp/less.$$ 2>/dev/null +.br + if [ -s /tmp/less.$$ ]; then +.br + echo /tmp/less.$$ +.br + else +.br + rm -f /tmp/less.$$ +.br + fi +.br + ;; +.br + esac +.PP +lessclose.sh: +.br + #! /bin/sh +.br + rm $2 +.PP +これらのスクリプトを使うためには、それらの両方を実行可能な場所に置き、 +LESSOPEN="lessopen.sh\ %s", LESSCLOSE="lessclose.sh\ %s\ %s" +と設定します。 +異なった種類の圧縮ファイルなどを受け付ける +より複雑な LESSOPEN と LESSCLOSE スクリプトを書くこともできるでしょう。 +.PP +データを代替ファイルに書き出さず、直接 +.I less +にパイプするような入力プリプロセッサを設定することも可能です。 +こうすることにより、 +閲覧する前に圧縮ファイル全体を展開することを避けられます。 +このような働きをする入力プリプロセッサは、入力パイプと呼ばれます。 +入力パイプは、代替ファイル名を標準出力に表示する代わりに、 +代替ファイルの内容全てを標準出力に書き出します。 +入力パイプが標準出力に何も書き出さない場合は代替ファイルはなく、 +.I less +は通常どおりオリジナルファイルを使用します。 +入力パイプを使う場合は、 +入力プリプロセッサが入力パイプであることを知らせるために、 +環境変数 LESSOPEN の最初の文字を、縦棒 (|) に設定します。 +.PP +例えば多くの Unix システムで、 +このスクリプトは上述したスクリプト例と似た働きをします。 +.PP +lesspipe.sh: +.br + #! /bin/sh +.br + case "$1" in +.br + *.Z) uncompress -c $1 2>/dev/null +.br + ;; +.br + esac +.br +.PP +このスクリプトを使うためには、これを実行可能な場所に置いて、 +LESSOPEN="|lesspipe.sh %s" と設定します。 +入力パイプを使用する際もポストプロセッサ LESSCLOSE を使用できますが、 +削除する代替ファイルがないので通常必要ありません。 +この例では、LESSCLOSE ポストプロセッサに渡される +代替ファイル名は "-" です。 + +.SH "各国文字集合" +入力ファイルには、3 種類の文字が含まれています。 +.IP "通常文字" +画面に直接表示できる文字。 +.IP "制御文字" +画面に直接表示すべきではありませんが、(バックスペースやタブのように) +普通のテキストファイル中で見つかることが予期される文字。 +.IP "バイナリ文字" +画面に直接表示すべきではなく、 +テキストファイル中で見つかることが予期されていない文字。 +.PP +「文字集合」は簡潔にいうとどの文字が通常文字、制御文字、 +バイナリ文字として考えられるかということです。 +環境変数 LESSCHARSET で文字セットを選択できます。 +環境変数 LESSCHARSET に設定できるのは: +.IP ascii +BS, TAB, NL, CR, formfeed が制御文字で、 +32 と 126 の間の値を持つ全ての文字が通常で、 +その他全てがバイナリです。 +.IP iso8859 +ISO 8859 文字集合を選択します。 +160 から 255 までが通常文字として扱われること以外は、ASCII と同じです。 +.IP latin1 +iso8859 と同じです。 +.IP dos +MS-DOS に適した文字集合を選択します。 +.IP ebcdic +EBCDIC 文字集合を選択します。 +.IP koi8-r +ロシアの文字集合を選択します。 +.IP next +NeXT コンピュータに適した文字集合を選択します。 +.IP utf-8 +ISO 10646 文字集合の UTF-8 符号を選択します。 +.PP +環境変数 LESSCHARSET が設定されていない場合の +デフォルト文字集合は latin1 です。 +しかし、環境変数 LC_ALL, LC_CTYPE, LANG のなかに "UTF-8" の文字列が +見つかった場合は、代わりに utf-8 がデフォルトの文字集合になります。 +.PP +ある特殊な場合には、 +.I less +が LESSCHARSET で指定できない文字セットを使うように調整したい場合があります。 +このような場合、環境変数 LESSCHARDEF を用いて文字集合を定義できます。 +この環境変数は、文字列中の各文字が、 +文字集合中の 1 文字を表すように設定します。 +文字 "." は通常文字を表すのに使われ、 +文字 "c" は制御文字を、文字 "b" はバイナリ文字を表します。 +10 進数は繰り返しに使用できます。 +例えば "bccc4b." は値 0 の文字がバイナリ、 +1, 2, 3 は制御、4, 5, 6, 7 はバイナリ、 +そして 8 は通常文字を意味します。 +最後の文字より後の文字は全て最後の文字と同じと扱われるので、 +9 から 255 までの文字は通常となります。 +(これは例なので、 +必ずしもなにか実際の文字集合セットを表しているわけではありません。) +.PP +下の表は、LESSCHARSET として有効な値に対し、 +それぞれ等価な LESSCHARDEF の値を示しています。 +.sp + ascii\ 8bcccbcc18b95.b +.br + dos\ \ \ 8bcccbcc12bc5b95.b. +.br + ebcdic 5bc6bcc7bcc41b.9b7.9b5.b..8b6.10b6.b9.7b +.br + \ \ \ \ \ \ 9.8b8.17b3.3b9.7b9.8b8.6b10.b.b.b. +.br + iso8859 8bcccbcc18b95.33b. +.br + koi8-r 8bcccbcc18b95.b128. +.br + latin1 8bcccbcc18b95.33b. +.br + next\ \ 8bcccbcc18b95.bb125.bb +.PP +LESSCHARSET と LESSCHARDEF のどちらも設定されていない場合でも、 +システムが +.I setlocale +インタフェースをサポートしていれば、 +.I less +は文字集合の決定に setlocale を使用します。 +setlocale は環境変数 LANG もしくは LC_CTYPE で制御されます。 +.PP +制御文字とバイナリ文字は強調 (反転) して表示されます。 +これらの文字はそれぞれ可能であるならば (例えば control-A を ^A というように) +キャレット表記で表示されます。 +キャレット表記は、0100 ビットを反転した結果が +印刷可能文字になる場合にのみ使用されます。 +そうでない場合は、角括弧で囲まれた 16 進数で表します。 +このフォーマットは、環境変数 LESSBINFMT により変更できます。 +LESSBINFMT は "*"で始まり、もう1つの文字で表示属性を選択します: +"*k" は点滅、"*d" は太字、"*u" は下線、 +"*s" は強調、そして、"*n" は通常です。 +LESSBINFMT が "*" で始まっていない場合は、通常属性と仮定します。 +LESSBINFMT の残りの部分は、1 つの printf スタイルのエスケープシーケンス +(x, X, o, d などが後ろに続く %) を含む文字列です。 +LESSBINFMT が "*u[%x]" の場合、バイナリキャラクタは +大括弧で囲まれた 16 進数に下線をして表示されます。 +LESSBINFMT が指定されていない場合のデフォルトは、"*s<%X>" です。 + +.SH "プロンプト" +-P オプションにより、プロンプトを好みに合わせて仕立てることができます。 +-P オプションに与えられた文字列は、指定したプロンプト文字列を置き換えます。 +文字列中のある文字は特殊な解釈をされます。 +プロンプト機構は柔軟性を持たせるために少々複雑になっていますが、 +一般のユーザは、個人用プロンプト文字列の作り方の詳細を理解する必要は +ありません。 +.sp +パーセント記号は後に続く 1 文字が何かによって展開のされ方が異なります: +.IP "%b\fIX\fP" +現在の入力ファイルでのバイトオフセットで置き換えられます。 +b の後には、(上記で \fIX\fP で示されている) 1 文字が続き、 +どの行のバイトオフセットを使用するかを指定します。 +その文字が "t" の場合は、画面の先頭行のバイトオフセットが使われます。 +"m" の場合は真中の行、"b" の場合は最下行、 +"B" の場合は最下行の直後の行の、 +"j" の場合には -j オプションで指定したターゲット行の +バイトオフセットを使うことを意味しています。 +.IP "%B" +現在の入力ファイルの大きさに置き換えられます。 +.IP "%c" +画面の最初の桁に表示されている文字の桁番号に置き換えられます。 +.IP "%d\fIX\fP" +ある行が存在する入力ファイル中のページ番号に置き換えられます。 +使用する行は %b オプションと同じように \fIX\fP で決定されます。 +.IP "%D" +入力ファイルのページ数、 +いいかえると入力ファイルの最終行のページ番号に置き換えられます。 +.IP "%E" +エディタの名前 (環境変数 VISUAL、VISUAL が定義されていない場合は +環境変数 EDITOR) に置き換えられます。 +後述する LESSEDIT 機能に関する話題を参照してください。 +.IP "%f" +現在の入力ファイル名に置き換えられます。 +.IP "%i" +入力ファイルのリスト中における現在のファイルのインデックスで置き換えらます。 +.IP "%l\fIX\fP" +ある行の入力ファイル中での行番号で置き換えられます。 +使用する行は %b オプションと同じように \fIX\fP で決定されます。 +.IP "%L" +入力ファイルの最終行の行番号で置き換えられます。 +.IP "%m" +入力ファイルの合計数で置き換えられます。 +.IP "%p\fIX\fP" +現在の入力ファイルでのバイトオフセットに基づいたパーセントで置き換えられます。 +使用する行は %b オプションと同じように \fIX\fP で決定されます。 +.IP "%P\fIX\fP" +現在の入力ファイルでの行番号に基づいたパーセントで置き換えられます。 +使用する行は %b オプションと同じように \fIX\fP で決定されます。 +.IP "%s" +%B と同じです。 +.IP "%t" +後に続くスペースを取り除きます。 +通常は文字列の最後に使われますが、どこに置いても構いません。 +.IP "%x" +ファイルリストのうち次の入力ファイル名で置き換えられます。 +.PP +もし (例えば入力がパイプのためファイルサイズが分からない場合など) +項目が不明な場合は、代わりに疑問符が表示されます。 +.PP +プロンプト文字列のフォーマットは、ある条件によって変更できます。 +疑問符とその後に続く 1 文字で、"IF" のように働き、 +どのようような文字が続くかで、条件が評価されます。 +条件が真ならば、疑問符と条件文字の後に続く文字列から +ピリオドまでがプロンプトの中に表示されます。 +条件が偽ならば、そのような文字列はプロンプトに挿入されません。 +疑問符とピリオドの間にあるコロンは、"ELSE" として働き、 +コロンとピリオドの間にある文字列は、IF の条件が偽の場合にのみ +プロンプト文字列に挿入されます。 +(疑問符に続く) 条件文字には次のようなものがあります: +.IP "?a" +プロンプトに既に任意の文字列が含まれている場合に真。 +.IP "?b\fIX\fP" +指定した行のバイトオフセットが既知の場合に真。 +.IP "?B" +現在の入力ファイルの大きさが既知の場合に真。 +.IP "?c" +文字が水平に移動している (%c が 0 でない) 場合に真。 +.IP "?d\fIX\fP" +指定した行のページ番号が既知の場合に真。 +.IP "?e" +ファイルの終わりの場合に真。 +.IP "?f" +入力ファイル名がある (つまり、入力がパイプでない) 場合に真。 +.IP "?l\fIX\fP" +指定した行の行番号が既知の場合に真。 +.IP "?L" +ファイルの最終行の行番号が既知の場合に真 +.IP "?m" +複数の入力ファイルがある場合に真。 +.IP "?n" +新しい入力ファイルの最初のプロンプトの場合に真。 +.IP "?p\fIX\fP" +指定した行の現在の入力ファイルでの +バイトオフセットに基づくパーセントが既知の場合に真。 +.IP "?P\fIX\fP" +指定した行の現在の入力ファイルでの +行番号に基づくパーセントが既知の場合に真。 +.IP "?s" +"?B" と同じです。 +.IP "?x" +次の入力ファイルがある +(つまり、現在の入力ファイルが最後のファイルでない) 場合に真。 +.PP +特殊文字 (疑問符、コロン、ピリオド、パーセント、バックスラッシュ) 以外の +全ての文字がプロンプトにそのまま表示されます。 +特殊文字をプロンプトにそのまま表示させるには、 +その文字の前にバックスラッシュを置きます。 +.PP +例: +.sp +?f%f:Standard input. +.sp +このプロンプトは、ファイル名が既知の場合にはファイル名を、 +そうでない場合には "Standard input" と表示します。 +.sp +?f%f .?ltLine %lt:?pt%pt\\%:?btByte %bt:-... +.sp +このプロンプトはファイル名が既知の場合に表示します。 +行番号が既知の場合には、ファイル名に続けて行番号を表示します。 +もし行番号が既知でなくパーセントが既知の場合には、パーセントを表示します。 +パーセントも既知でなくバイトオフセットが既知の場合には、 +バイトオフセットを表示します。 +バイトオフセットも既知でない場合には、ダッシュを表示します。 +各疑問符にピリオドがどのように対応しているかに注意してください。 +また、%pt の後の % を実際に挿入するために、 +バックスラッシュでエスケープしていることに注意してください。 +.sp +?n?f%f\ .?m(file\ %i\ of\ %m)\ ..?e(END)\ ?x-\ Next\\:\ %x..%t +.sp +このプロンプトがファイルにおける最初のプロンプトの場合には +ファイル名を表示します。 +さらに、複数のファイルがある場合には、 +"file N of N" というメッセージを加えます。 +そして、ファイルの終わりに達した場合には、文字列 "(END)" が表示され、 +引き続いて次のファイルがある場合にはそのファイル名を表示します。 +最後に、後に続くスペースを切り詰めます。 +これはデフォルトのプロンプトです。 +参考として、(-m と -M オプションに対応する) +2 つのプロンプトのデフォルトを挙げます。 +ここでは読みやすさのために 2 行に分けています。 +.nf +.sp +?n?f%f\ .?m(file\ %i\ of\ %m)\ ..?e(END)\ ?x-\ Next\\:\ %x.: + ?pB%pB\\%:byte\ %bB?s/%s...%t +.sp +?f%f\ .?n?m(file\ %i\ of\ %m)\ ..?ltlines\ %lt-%lb?L/%L.\ : + byte\ %bB?s/%s.\ .?e(END)\ ?x-\ Next\\:\ %x.:?pB%pB\\%..%t +.sp +.fi +そして、次に挙げるのは = コマンドで表示されるデフォルトのメッセージです。 +.nf +.sp +?f%f\ .?m(file\ %i\ of\ %m)\ .?ltlines\ %lt-%lb?L/%L.\ . + byte\ %bB?s/%s.\ ?e(END)\ :?pB%pB\\%..%t +.fi +.PP +プロンプト展開の機能は他の目的でも使われます: +環境変数 LESSEDIT が定義されている場合、この変数は +v コマンドで実行されるコマンドとして使われます。 +LESSEDIT の文字列は、プロンプト文字列と同じ方法で展開されます。 +LESSEDIT のデフォルトの値は以下のとおりです: +.nf +.sp + %E\ ?lm+%lm.\ %f +.sp +.fi +この文字列は、エディタ名と、その後に + と行番号、その後にファイル名と +いうように展開されます。 +あなたの指定したエディタが、"+行番号" という構文を受け付けない場合や、 +呼び出しの構文が違う場合には、 +このデフォルトの LESSEDIT を修正できます。 + +.SH セキュリティ +環境変数 LESSSECURE が 1 に設定されている場合、 +.I less +は「安全な」モードで実行されます。この場合、以下の機能は使えません: +.RS +.IP "!" +シェルコマンド +.IP "|" +パイプコマンド +.IP ":e" +ファイルの読み込みコマンド +.IP "v" +編集コマンド +.IP "s -o" +ファイルの記録 +.IP "-k" +lesskey ファイルの使用 +.IP "-t" +タグファイルの使用 +.IP " " +ファイル名での * といったメタキャラクタ +.IP " " +ファイル名補完 (TAB, ^L) +.RE +.PP +less を「安全な」モードでしか実行できないように +コンパイルすることも可能です。 + +.SH 環境変数 +環境変数は普通にシステム環境で設定するか、または +.I lesskey +(1) ファイルで指定できます。 +環境変数が複数の個所で定義されている場合、 +ローカルな lesskey ファイルでの変数定義、 +システム環境での変数定義、 +システム標準 lesskey ファイルでの変数定義の順で優先されます。 +.IP COLUMNS +画面の 1 行あたりの桁数を設定します。 +環境変数 TERM で設定された桁数よりも優先されます。 +(ただし画面サイズを知ることができる TIOCGWINSZ または WIOCGETD を +サポートしているウィンドウシステムを使用しているのであれば、 +その情報が環境変数 LINES と COLUMNS よりも優先されます。) +.IP EDITOR +(v コマンドで使用される) エディタの名前。 +.IP HOME +(Unix システムで lesskey ファイルを探すのに使われる) +ユーザのホームディレクトリ名。 +.IP "HOMEDRIVE, HOMEPATH" +変数 HOME が設定されていない場合に、 +環境変数 HOMEDRIVE と HOMEPATH を連結した名前が +ユーザのホームディレクトリになります (Windows 版のみ)。 +.IP INIT +(OS/2 システムで lesskey ファイルを探すのに使われる) +ユーザの init ディレクトリ名。 +.IP LANG +文字集合を決定するための言語。 +.IP LC_CTYPE +文字集合を決定するための言語。 +.IP LESS +自動的に +.I less +に渡されるオプション。 +.IP LESSANSIENDCHARS +ANSI カラーエスケープシーケンスを終了させるとみなす文字 +(デフォルトは "m")。 +.IP LESSBINFMT +印字可能文字でもなく、制御文字でもない文字を +表示する際のフォーマット。 +.IP LESSCHARDEF +文字集合を定義します。 +.IP LESSCHARSET +あらかじめ定義された文字集合を選択します。 +.IP LESSCLOSE +(オプションの) 入力ポストプロセッサを呼び出すためのコマンドライン。 +.IP LESSECHO +lessecho プログラムの名前 (デフォルトは、"lessecho")。 +lessecho プログラムは、Unix システムにおいてファイル名の +* や ? といったメタキャラクタの展開に必要です。 +.IP LESSEDIT +(v コマンドで使用される) エディタのプロトタイプ文字列。 +プロンプト節での話題を参照してください。 +.IP LESSKEY +デフォルトの lesskey(1) ファイル名。 +.IP LESSKEY_SYSTEM +デフォルトのシステム標準 lesskey(1) ファイル名。 +.IP LESSMETACHARS +シェルに「メタキャラクタ」として解釈される文字のリスト。 +.IP LESSMETAESCAPE +less がシェルにコマンドを送る際にメタキャラクタの前に付加する +プレフィックス。 +LESSMETAESCAPE が空の文字列である場合、 +メタキャラクタを含むコマンドはシェルに送られません。 +.IP LESSOPEN +(オプションの) 入力プリプロセッサを呼び出すためのコマンドライン。 +.IP LESSSECURE +less を「安全な」モードで実行させます。 +セキュリティ節での話題を参照してください。 +.IP LESSSEPARATOR +ファイル名補完においてディレクトリ名に付加される文字列。 +.IP LINES +画面の行数を設定します。 +環境変数 TERM で設定された行数よりも優先されます。 +(ただし画面サイズを知ることができる TIOCGWINSZ または WIOCGETD を +サポートしているウィンドウシステムを使用しているのであれば、 +その情報が環境変数 LINES と COLUMNS よりも優先されます。) +.IP PATH +(MS-DOS と OS/2 システムで lesskey ファイルを探すのに使われる) +ユーザの検索パス。 +.IP SHELL +! コマンドを実行したり、ファイル名の補完に使用されるシェル。 +.IP TERM +.I less +が実行されている端末の種類。 +.IP VISUAL +(v コマンドで使用される) エディタ名。 + +.SH 関連項目 +lesskey(1) + +.SH 警告 +(-P オプションで変更されない限り) = コマンドとプロンプトで表示される +行番号は画面の先頭行と最終行のものですが、 +表示されるバイト数とパーセントは画面の最終行の後のものです。 +.PP +:e コマンドが複数のファイルに対して使われ、 +ファイルのうちの 1 つが既に閲覧されている場合、 +新しいファイルは予期しない順番でリストに入るかもしれません。 +.PP +ある種の古い端末 (いわゆる「マジッククッキー」端末) では、 +検索の際のハイライト表示が誤った表示を起こします。 +そのような端末では、この問題を避けるため、 +検索の際のハイライト表示がデフォルトで無効に設定されています。 +.PP +検索の際のハイライト表示が有効で、検索パターンが ^ で始まっている場合、 +ある特定の条件下では +マッチした文字列以上の部分までハイライト表示されることがあります。 +(この問題は less が POSIX 正規表現パッケージを用いて +コンパイルされている場合には起きません。) +.PP +あるシステムでは、 +.I setlocale +が 0 から 31 の ASCII 文字をバイナリ文字ではなく +制御文字であると主張します。 +そのためいくつかのバイナリファイルが +.I less +に普通の非バイナリファイルとして扱われてしまいます。 +この問題を回避するには、環境変数 LESSCHARSET を "ascii" +(もしくは、何か適切な文字集合) に設定します。 +.PP +このバージョンの less の最新の既知なバグのリストは +http://www.flash.net/~marknu/less +を参照してください。 + +.SH COPYRIGHT +Copyright (C) 2000 Mark Nudelman +.PP +less is part of the GNU project and is free software. +You can redistribute it and/or modify it +under the terms of either +(1) the GNU General Public License as published by +the Free Software Foundation; or (2) the Less License. +See the file README in the less distribution for more details +regarding redistribution. +You should have received a copy of the GNU General Public License +along with the source for less; see the file COPYING. +If not, write to the Free Software Foundation, 59 Temple Place, +Suite 330, Boston, MA 02111-1307, USA. +You should also have received a copy of the Less License; +see the file LICENSE. +.PP +less is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +or FITNESS FOR A PARTICULAR PURPOSE. +See the GNU General Public License for more details. +.SH 作者 +.PP +Mark Nudelman +.br +バグ報告やコメントは上記のアドレスまたは bug-less@gnu.org へ +送ってください。 diff --git a/ja_JP.eucJP/man/man1/lesskey.1 b/ja_JP.eucJP/man/man1/lesskey.1 new file mode 100644 index 0000000000..f079b9c249 --- /dev/null +++ b/ja_JP.eucJP/man/man1/lesskey.1 @@ -0,0 +1,395 @@ +.TH LESSKEY 1 "Version 358: 08 Jul 2000" +.\" jpman %Id: lesskey.1,v 1.3 2000/09/21 03:08:18 horikawa Stab % +.\" +.\" 以下は参考にした Linux JM のクレジット +.\" Japanese Version Copyright (c) 1999 Yuichi SATO +.\" all rights reserved. +.\" Translated Fri Sep 17 03:26:44 JST 1999 +.\" by Yuichi SATO +.\"WORD: caret キャレット +.\"WORD: pound sign シャープ符号 +.SH 名前 +lesskey \- less のキー割当てを指定する +.SH 書式 +.B "lesskey [-o output] [--] [input]" +.br +.B "lesskey [--output=output] [--] [input]" +.br +.B "lesskey -V" +.br +.B "lesskey --version" +.SH 解説 +.I lesskey +は +.I less +で使われるキー割り当てのセットを指定するために使われます。 +入力ファイルはキー割り当てを記述したテキストファイルです。 +入力ファイルが "-" のときは、標準入力が読み込まれます。 +入力ファイルが何も指定されない場合は、 +使用しているシステムに応じた +標準のファイル名が入力ファイルの名前として使用されます: +Unix システムでは $HOME/.lesskey が、 +MS-DOS システムでは $HOME/_lesskey が、 +OS/2 システムでは $HOME/lesskey.ini または +$HOME が定義されてない場合は $INIT/lesskey.ini が +使用されます。 +出力ファイルは +.I less +で使われるバイナリファイルです。 +出力ファイルが何も指定されておらず、 +環境変数 LESSKEY が設定されている場合は、 +LESSKEY の値が出力ファイルの名前として使われます。 +そうでない場合は、 +使用しているシステムに応じた +標準のファイル名が出力ファイルの名前として使われます: +Unix と OS-9 システムでは $HOME/.less が、 +MS-DOS システムでは $HOME/_less が、 +OS/2 システムでは $HOME/less.ini または +$HOME が定義されない場合は $INIT/less.ini が +使用されます。 +出力ファイルが既に存在する場合は、 +.I lesskey +は上書きします。 +.PP +-V または --version オプションは、 +.I lesskey +にバージョン番号を表示してすぐに終了させます。 +-V または --version がある場合は、他のオプションと引き数は無視されます。 +.PP +入力ファイルは、1 つ以上の +.I セクション +から構成されます。 +各セクションは、セクションのタイプを明らかにする行から始まります。 +指定できるセクションは次の通りです: +.IP #command +新しいコマンドキーを定義します。 +.IP #line-edit +新しい行編集キーを定義します。 +.IP #env +環境変数を定義します。 +.PP +空白行と、特別なセクションヘッダ行を除いたシャープ符号 (#) から始まる行は +無視されます。 + +.SH コマンドセクション +コマンドセクションは次の行から始まります。 +.sp +#command +.sp +コマンドセクションがファイル中で最初のセクションである場合は、 +この行は省略することもできます。 +コマンドラインセクションは次の形式の行から構成されます: +.sp + \fIstring\fP \fIaction\fP [extra-string] +.sp +空白 (whitespace) とは 1 つ以上のスペースと (または) +タブの連続です。 +\fIstring\fP はアクションを起こすコマンドキーです。 +\fIstring\fP は単一のコマンドキー、または 15 個までのキーの連続です。 +\fIaction\fP は下記のリストにある less のアクション名です。 +\fIstring\fP 中の文字はそのまま書くか、あるいは +キャレットを前においてコントロールキーであることを示します。 +バックスラッシュとそれに続く 3 桁までの 8 進数で、 +文字を 8 進数で指定できます。 +バックスラッシュと、それに続く特定の文字は以下の入力を指定します: +.IP \eb +BACKSPACE +.IP \ee +ESCAPE +.IP \en +NEWLINE +.IP \er +RETURN +.IP \et +TAB +.IP \eku +UP ARROW +.IP \ekd +DOWN ARROW +.IP \ekr +RIGHT ARROW +.IP \ekl +LEFT ARROW +.IP \ekU +PAGE UP +.IP \ekD +PAGE DOWN +.IP \ekh +HOME +.IP \eke +END +.IP \ekx +DELETE +.PP +バックスラッシュの後に続く上に挙げた以外の文字は、 +その文字が特殊文字としてでなく、文字通りに使われることを意味しています。 +バックスラッシュを前に置かなければならない文字には、 +キャレット、スペース、タブ、そしてバックスラッシュ自身が含まれます。 +.PP +アクションの後には「追加の」文字列 (extra-string) が続くことがあります。 +.I less +を実行している際にそのようなコマンドが入力されると、 +アクションが実行された後、 +.I less +に入力されたかのように追加の文字列が解釈されます。 +この機能を用いてコマンドの機能を拡張することができます。 +下の "{" と ":t" コマンドの例を参照してください。 +"quit" アクションに対する追加の文字列は特別な意味を持っています: +.I less +が終了するとき、追加の文字列の最初の 1 文字が終了ステータスとして使われます。 + +.SH 使用例 +以下の入力ファイルは、less で使われるデフォルトのコマンドキーの +セットを記述しています: +.sp +.nf + #command + \er forw-line + \en forw-line + e forw-line + j forw-line + \ekd forw-line + ^E forw-line + ^N forw-line + k back-line + y back-line + ^Y back-line + ^K back-line + ^P back-line + J forw-line-force + K back-line-force + Y back-line-force + d forw-scroll + ^D forw-scroll + u back-scroll + ^U back-scroll + \e40 forw-screen + f forw-screen + ^F forw-screen + ^V forw-screen + \ekD forw-screen + b back-screen + ^B back-screen + \eev back-screen + \ekU back-screen + z forw-window + w back-window + \ee\e40 forw-screen-force + F forw-forever + R repaint-flush + r repaint + ^R repaint + ^L repaint + \eeu undo-hilite + g goto-line + < goto-line + \ee< goto-line + p percent + % percent + \ee[ left-scroll + \ee] right-scroll + \ee( left-scroll + \ee) right-scroll + { forw-bracket {} + } back-bracket {} + ( forw-bracket () + ) back-bracket () + [ forw-bracket [] + ] back-bracket [] + \ee^F forw-bracket + \ee^B back-bracket + G goto-end + \ee> goto-end + > goto-end + = status + ^G status + :f status + / forw-search + ? back-search + \ee/ forw-search * + \ee? back-search * + n repeat-search + \een repeat-search-all + N reverse-search + \eeN reverse-search-all + m set-mark + ' goto-mark + ^X^X goto-mark + E examine + :e examine + ^X^V examine + :n next-file + :p prev-file + :x index-file + - toggle-option + :t toggle-option t + s toggle-option o + _ display-option + | pipe + v visual + ! shell + + firstcmd + H help + h help + V version + 0 digit + 1 digit + 2 digit + 3 digit + 4 digit + 5 digit + 6 digit + 7 digit + 8 digit + 9 digit + q quit + Q quit + :q quit + :Q quit + ZZ quit +.fi +.sp +.SH 優先 +.I lesskey +で指定されたコマンドは、デフォルトのコマンドよりも優先されます。 +デフォルトのコマンドキーは、"invalid" アクションが指定されて +入力ファイルに含まれた場合は、無効化されます。 +あるいは、"noaction" アクションが指定された場合は、 +そのキーは何もしないと定義されます。 +"noaction" は "invalid" と似ていますが、 +.I less +は、"invalid" なコマンドにはエラービープ音を鳴らしますが、 +"noaction" なコマンドには鳴らしません。 +さらに、次の制御行を入力ファイルに加えることにより、 +全てのデフォルトのコマンドを無効化できます: +.sp +#stop +.sp +これにより、全てのデフォルトコマンドは無視されます。 +#stop 行は、ファイル中の当該セクションの最後の行に置く必要があります。 +.PP +#stop は危険を伴うことに気をつけてください。 +全てのデフォルトコマンドが無効になるため、 +必要な全てのアクションを有効にするために +#stop 行の前に十分なコマンドを与える必要があります。 +例えば "quit" コマンドを与え忘れると、失敗するでしょう。 + +.SH 行編集セクション +行編集セクションは次の行で始まります: +.sp +#line-edit +.sp +このセクションは、#command セクションでの通常のコマンドのキー割り当ての +指定と似た方法で、 +行編集コマンドの新しいキー割り当てを指定します。 +行編集セクションは以下の例のように 1 行毎の +キーとアクションのリストからなります。 + +.SH 使用例 +以下の入力ファイルは less で使用される +デフォルトの行編集キーのセットを記述しています。 +.sp +.nf + #line-edit + \et forw-complete + \e17 back-complete + \ee\et back-complete + ^L expand + ^V literal + ^A literal + \eel right + \ekr right + \eeh left + \ekl left + \eeb word-left + \ee\ekl word-left + \eew word-right + \ee\ekr word-right + \eei insert + \eex delete + \ekx delete + \eeX word-delete + \eekx word-delete + \ee\eb word-backspace + \ee0 home + \ekh home + \ee$ end + \eke end + \eek up + \eku up + \eej down +.fi +.sp + +.SH LESS 環境変数セクション +環境変数セクションは次の行から始まります: +.sp +#env +.sp +この行の後には、環境変数割り当てのリストが続きます。 +各行は、環境変数名、等号 (=)、環境変数に割り当てる値で構成されます。 +等号の前後の空白は無視されます。 +この方法で割り当てられる変数は、 +.I less +にしか見えません。 +ある変数がシステム環境と、 +さらに lesskey ファイルでも指定されている場合、 +lesskey ファイルでの値が優先されます。 +lesskey ファイルは環境で設定されている変数を上書きする用途に +使用することもできますが、 +lesskey ファイルで変数を割り当てる主な目的は、単に +.I less +の全ての設定情報を 1 つのファイルに保存することです。 + +.SH 使用例 +以下の入力ファイルは、 +.I less +の実行時に常に -i オプションを設定し、 +文字集合を "latin1" にするように指定しています: +.sp +.nf + #env + LESS = -i + LESSCHARSET = latin1 +.fi +.sp + +.SH 関連項目 +less(1) + +.SH 警告 +上矢印のような特殊キーをキーボードに依存しない方法で指定することは +できません。 +そのようなキーを指定する唯一の方法は、 +そのキーが押された際にそのキーボードが送るエスケープシーケンスを +指定することです。 +.PP +MS-DOS と OS/2 システムでは、いくつかのキーは NUL 文字 (0) で +始まる文字列を送ります。 +この NUL 文字は、lesskey ファイルでは \e340 と表記する必要があります。 + +.SH COPYRIGHT +Copyright (C) 2000 Mark Nudelman +.PP +lesskey is part of the GNU project and is free software; +you can redistribute it and/or modify it +under the terms of the GNU General Public License as published by +the Free Software Foundation; +either version 2, or (at your option) any later version. +.PP +lesskey is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +or FITNESS FOR A PARTICULAR PURPOSE. +See the GNU General Public License for more details. +.PP +You should have received a copy of the GNU General Public License +along with lesskey; see the file COPYING. +If not, write to the Free Software Foundation, 59 Temple Place, +Suite 330, Boston, MA 02111-1307, USA. + +.SH 作者 +.PP +Mark Nudelman +.br +バグ報告やコメントは上記のアドレスまたは bug-less@gnu.org へ +送ってください。 diff --git a/ja_JP.eucJP/man/man1/more.1 b/ja_JP.eucJP/man/man1/more.1 deleted file mode 100644 index 3feeaecf9c..0000000000 --- a/ja_JP.eucJP/man/man1/more.1 +++ /dev/null @@ -1,341 +0,0 @@ -.\" Copyright (c) 1988, 1990 The Regents of the University of California. -.\" Copyright (c) 1988 Mark Nudleman -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" from: @(#)more.1 5.15 (Berkeley) 7/29/91 -.\" %FreeBSD: src/usr.bin/more/more.1,v 1.18 2000/03/01 12:19:56 sheldonh Exp % -.\" -.\" jpman %Id: more.1,v 1.4 1997/08/11 14:30:57 horikawa Stab % -.\" -.Dd April 18, 1994 -.Dt MORE 1 -.Os -.Sh 名称 -.Nm more -.Nd CRT 上でファイルをページ単位に閲覧する -.Sh 書式 -.Nm -.Op Fl ceinsu -.Op Fl t Ar tag -.Op Fl x Ar tabs -.Op Fl / Ar pattern -.Op Ar -.Sh 解説 -.Nm -は、画面上に 1 度に表示できる量の行数を 1 ページの行数とみなし、 -.Ar file -が指定されていれば -そのファイルを、指定されていないか ``-'' の場合は、標準入力 (標準入力が -端末の場合は、何もせずに終了します) を読み込んで、1 ページ分表示する毎に -キー入力を待つようにします。 -.Pp -さまざまな端末に対応するため、 -.Xr termcap 3 -を使用します。また、制限はありますが、ハードコピー形式の端末も -サポートしています。ハードコピー端末では、画面の上端に対応する位置に -``^'' が印刷されます。 -.Sh オプション -オプションとしては以下のものがあります。なお、これらのオプションは、 -あらかじめ環境変数 -.Ev MORE -で指定しておくことができます (``-'' をつけること)。 -コマンドラインオプションでオーバーライドします。 -.Bl -tag -width flag -.It Fl c -通常、 -.Nm -は次のページを表示する時、現在表示されている画面を 1 行づつ -スクロールしていって新しいページを表示していきますが、 -このオプションを指定した場合、画面の上端から書き替えます。 -.It Fl e -通常 -.Nm -は、ファイルの最後に達し次に表示すべきファイルがない -場合には終了しますが、このオプションを指定した場合にはファイルの最後に -達した時点でキー入力待ちになります。このオプションは、最後まで見た後、 -前のページに遡って見たい場合に便利です。 -.\"ただし、元々ファイルが小さく、最初の 1 ページに納まっている場合は、 -.\"すぐ終了します。 -.\"(訳中)原文で内容が削られていますが、とりあえずコメントで残します。 -.\" 2.2.1R 対象(1997/05/06) Takeshi MUTOH -.It Fl i -サーチするとき、大文字と小文字を区別しないようにします。 -.It Fl n -行番号の処理をしないようにします。デフォルトで、 -.Xr more -は、 -.Cm = -コマンドを使用した行情報の表示や、 -.Cm v -コマンドでエディタを起動して現在見ている行にジャンプさせるために、 -行番号を内部で管理しています。しかし、この処理のために動作が -遅くなっており、これは、大きなファイルを扱う場合、特に顕著です。 -このオプションを指定して行番号を使用しないことを -明示すれば、速度の低下を回避することができます。 -.It Fl s -複数の空行が連続している場合、空行を 1 行にします。 -.It Fl t Ar tag -タグ情報を含むファイル ``tags'' から、tag で指定されたエントリを検索し、 -対応するファイルの指定位置から表示を開始します。 -タグファイル ``tags'' については、 -.Xr ctags 1 -を参照してください。 -.It Fl u -デフォルトでは、 -.Nm -は -.Dv BS -や -.Dv CR-LF -などのシーケンスを特別に処理します。 -.Dv BS -とアンダースコア文字があった場合は、文字にアンダーラインをつけて -表示しますし、2 つの同じ文字の間にBSがあったら、強調表示にします。 -.Dv CR-LF -は、1 つの改行にします。 -このオプションは、これらの処理をやめ、 -.Dv BS -は ``^H'' に、 -.Dv CR-LF -は ``^M'' と改行にします。 -.It Fl x -タブ幅を -.Ar N -文字にします。デフォルトでは 8 です。 -.It Fl / -.Ar pattern -で指定した検索を実行し、見つかった位置から表示します。 -.El -.Pp -.Sh コマンド -.Nm -は、1 ページ表示する毎に、キーボードから各種のコマンドを受け付けます。 -コマンドは、 -.Xr vi 1 -のコマンド体系をベースにしたものです。 -以下の説明で、``^''は``Control''キーを押しながら入力するキーの意味です。 -また、コマンドのキーを押す前に数字を入力することで、そのコマンドに -対する引数を与えることができます。これは、説明のなかで``N''として -記述しています。 -.Bl -tag -width Ic -.It Ic h -コマンドのヘルプを表示します。もし他の全てのコマンドを忘れても、 -このコマンドは覚えておいてください。 -.It Xo -.Ic q -.No or -.Ic \&:q -.No or -.Ic ZZ -.Xc -.Nm -を終了します。 -.It Xo -.Ic SPACE -.No or -.Ic f -.No or -.Ic \&^F -.Xc -N 行分スクロールします。デフォルトは 1 画面分です。 -N が画面サイズよりも大きい場合、1 画面分のみ表示されます。 -.It Ic b No or Ic \&^B -N 行け戻るようにスクロールします。 -デフォルトは 1 仮面分です (-z オプション参照)。 -N が画面サイズよりも大きい場合、1 画面分のみ表示されます。 -.It Xo -.Ic j -.No or -.Ic RETURN -.No or -.Ic DOWN-ARROW -.Xc -N 行分スクロールします。デフォルトは 1 行です。 -N が画面サイズよりも大きくても、N 行すべてが表示されます。 -.It Ic k No or Ic UP-ARROW -N 行だけ前に戻るようにスクロールします。デフォルトは 1 行です。 -N が画面サイズよりも大きくても、N 行すべてが表示されます。 -.It Ic LEFT-ARROW -N 桁だけ左スクロールします。デフォルトは 1 桁です。 -画面を左スクロールできない場合、行折り返しをオンにします。 -.It Ic RIGHT-ARROW -行折り返しをオフにします。 -既に桁折り返しがオフの場合、N 桁だけ右スクロールします。 -デフォルトは 1 桁です。 -.It Ic HOME -水平スクロールと行折り返しのオンオフを切り替えます。 -.It Ic d No or Ic \&^D -N 行スクロールします。デフォルトは画面サイズの半分です。 -N の指定後は、以降の d と u のコマンドでのデフォルト値がこの値になります。 -N が画面サイズより大きい場合でも、N 行すべてが表示されます。 -.It Ic u No or Ic \&^U -N 行戻るようにスクロールします。デフォルトは画面サイズの半分です。 -N の指定後は、以降の d と u のコマンドでのデフォルト値がこの値になります。 -N が画面サイズより大きい場合でも、N 行すべてが表示されます。 -.It Ic g -ファイルの N 行目から表示します。引数を指定しなかった場合は、 -ファイル先頭から表示します。 -.It Ic G -ファイルの N 行目から表示します。引数を指定しなかった場合は、 -ファイルの最後から表示します。 -.It Ic p No or Ic \&% -ファイルの N パーセント目から表示します。 N は 0 から 100 までです。 -file で指定したファイルの場合では、標準入力を読み込んで -表示するようにしている場合は、ファイルエンドに達してからでないと、 -このコマンドは使用できません。 -これは速いのですが、いつも有効とは限りません。 -.It Ic r No or Ic \&^L -画面を表示し直します。 -.It Ic R -バッファに入っている入力を捨て、再読み込みして同じ行番号に当たる所から -画面を表示し直します。これは、表示を見ている間にファイルが -変更されたような場合に有効です。 -.It Ic m -行マークをするコマンドです。``m'' を押すと、画 -面下に ``mark: '' と表示されるので、a から z までの英小文字を使ってマークの -指定をすることができます。これで、現在の表示行がその文字にマーク -されます。次の `` ' '' コマンドによって、ここでマークした行に -ジャンプさせることができます。 -.It Ic \&' -m コマンドでマークした行にジャンプするコマンドで -す。画面下に ``goto mark: '' と表示されますので、m コマンドで -マークした a から z までの英小文字を入力すれば、 -その行にジャンプできます。 -なお、a から z のかわりに再度 `` ' '' を -入力すると、その前に大きく移動した位置に戻ります。この場合の大きな移動とは、 -`` ' ''コマンドによる移動や、``g'' コマンドでのファイル先頭に移動することを -指します。 -このあと、`` '' ''と入力すると、移動前の位置に戻ることができます。 -全てのマークは、新しいファイルを読み込んだ時に失われます。 -.It Ic \&/ Ns Ar pattern -現在行 (画面の 1 番上に表示されている行) の次の -行からファイルの末端に向かって、pattern で指定した検索を実行し、 -一致した行から表示します。引数が指定された場合は、検索を繰り返し -実行し、N 回目に一致した行からの表示になります。pattern には、 -.Xr re_format 7 -で解説されているPOSIX.2 -.Dq extended format -正規表現が使用できます。 -.It Ic \&? Ns Ar pattern -現在行 (画面の 1 番上に表示されている行) の直前から -ファイルの先頭に向かって、 -.Ar pattern -で指定した検索を実行します。 -.It Ic \&/\&! Ns Ar pattern -.Ar pattern -に一致しない行を検索する以外は ``/'' と同じです。 -.It Ic \&?\&! Ns Ar pattern -.Ar pattern -に一致しない行を検索する以外は ``?'' と同じです。 -.It Ic n No and Ic N -直前に実行した検索コマンドを再実行し、パターンを含む N 番目の行を表示します。 -それぞれ、同方向および逆方向を意味します。 -.It Ic E Ns Op Ar filename -コマンドラインのファイルリストの中から現在表示しているファイル -(N, Pコマンド参照) にかわって、 -filename で指定したファイルを表示対象にします。 -ファイルが見つからない場合は、現在のファイルを再度表示します。 -ファイル名が "#" なら、1 つ前に読み込んだファイルを再度表示します。 -.It Ic \&:n -コマンドラインから file として複数のファイルを指 -定して起動した場合に、現在表示しているファイルの次のファイルに表示を -切り替えます。引数を指定した場合は、N 個先のファイルになります。 -.It Ic \&:p -コマンドラインから file として複数のファイルを指 -定して起動した場合に、現在表示しているファイルの 1 つ前のファイルに -表示を切り替えます。引数を指定した場合は、N 個前のファイルになります。 -.It Ic \&:t -タグエントリの入力をします。 -``:t'' を押すと、画面下に ``Tag: '' と表示されるので、新しいタグエントリの -入力をします。 -対応するタグエントリが見つからなかった場合は、その旨を表示して、 -前のファイルを表示します。 -.It Ic t -タグキューにおいて進みます [gtags のみ]。 -.It Ic T -タグキューにおいて戻ります [gtags のみ]。 -.It Ic v -現在表示しているファイルを編集対象にして、エディタを起動します。 -エディタはデフォルトでは -.Xr vi 1 -が起動されるようになっていますが、 -環境変数 -.Ev EDITOR -が指定されていた場合には、そこで指定したエディタが起動されます。 -.It Ic \&= No or Ic \&^G -現在表示しているファイルについて、画面の最下行がファイル全体の -何行目にあたるか、また、ファイルの総バイト数に対する現在行の -バイト数とそのパーセンテージを表示します。 -.Nm -が標準入力から読み込んでいるか、ファイルが一画面より短い場合は、 -いくつかの情報は有効ではありません。これらの情報は、画面の最下行の最初の -1 バイトによって得られる事を覚えておいてください。 -.El -.Sh 環境変数 -.Bl -tag -width Fl -.It Ev MORE -コマンドラインで指定するかわりに、あらかじめよく使うオプションを -設定しておくことができます。 -.It Ev EDITOR -起動するエディタを指定します。 -.It Ev SHELL -起動するシェルを指定します。通常、この変数はログイン時 -にシェルが自分でセットします。 -.It Ev TERM -端末のタイプを指定します。 -.El -.Sh 関連項目 -.Xr ctags 1 , -.Xr global 1 , -.Xr gtags 1 , -.Xr vi 1 -.Sh バグ -長い行を含むファイルの読み込みは、遅いです。 -.Pp -CRLF で終端された 80 文字の行は、余計な改行を生じさせます。 -.Pp -ボールドテキストからアンダラインテキストへすぐ変わると、 -アンダラインが消えてしまいます。 -.Pp -マッチする行を検索するとき、 -パターンを含まない行を探してしまうことがあります。 -.Pp -HOME と ARROW のキーは、 -正しい vt100 エスケープシーケンスを使用した場合のみ動作します。 -.Sh 作者 -このソフトウェアは -.An Mark Nudleman -によって Berkeley に寄贈されました。 -.Sh 歴史 -.Nm -コマンドは -.Bx 3.0 -から登場しました。 diff --git a/ja_JP.eucJP/man/man5/Makefile b/ja_JP.eucJP/man/man5/Makefile index 7021d13863..64aaf59b43 100644 --- a/ja_JP.eucJP/man/man5/Makefile +++ b/ja_JP.eucJP/man/man5/Makefile @@ -47,6 +47,7 @@ MAN5 = a.out.5\ kernfs.5\ keycap.5\ link.5\ + linprocfs.5\ loader.conf.5\ login.access.5\ login.conf.5\ diff --git a/ja_JP.eucJP/man/man5/linprocfs.5 b/ja_JP.eucJP/man/man5/linprocfs.5 new file mode 100644 index 0000000000..5833625c1d --- /dev/null +++ b/ja_JP.eucJP/man/man5/linprocfs.5 @@ -0,0 +1,94 @@ +.\" %FreeBSD: src/share/man/man5/linprocfs.5,v 1.1.2.2 2000/03/26 12:23:36 des Exp % +.\" Written by Garrett Wollman +.\" This file is in the public domain. +.\" +.Dd August 10, 1994 +.\" jpman %Id: linprocfs.5,v 1.3 2000/09/18 12:53:24 horikawa Stab % +.Dt LINPROCFS 5 +.Os BSD 4.4 +.Sh 名称 +.Nm linprocfs +.Nd Linux プロセスファイルシステム +.Sh 書式 +.Bd -literal +linproc /compat/linux/proc linprocfs rw 0 0 +.Ed +.Sh 解説 +Linux プロセスファイルシステム、すなわち +.Nm linprocfs +は、Linux のプロセスファイルシステムのサブセットをエミュレートします。 +いくつかの Linux バイナリが完全動作するために必要です。 +.Pp +.Nm +はプロセス空間の 2 つのレベルのビューを提供します。 +高いレベルでは、プロセスは、先頭に 0 の付かない +10 進数のプロセス ID に従って名前付けされます。 +また、調査要求を行っているプロセスを常に参照する、 +.Pa self +と呼ばれる特別なノードも存在します。 +.Pp +各ノードは以下の項目を含むディレクトリです: +.Pp +各ディレクトリはいくつかのファイルを含んでいます: +.Bl -tag -width status +.It Pa exe +プロセステキストが読まれた vnode への参照。 +これはプロセスのシンボルテーブルへのアクセスを得るか、または +プロセスのもう 1 つのコピーを始めるために使われます。 +.It Pa mem +プロセスの完全な仮想メモリイメージ。 +プロセス中に存在するアドレスのみにアクセス可能です。 +このファイルへ読み書きするとプロセスを修正します。 +テキストセグメントへの書き込みは、そのプロセスのみに留まります。 +.El +.Pp +各ノードはプロセスのユーザによって所有され、 +ユーザのプライマリグループに属します。 +.Pa mem +ノードは例外で、 +.Li kmem +グループに属します。 +.Sh 関連ファイル +.Bl -tag -width /compat/linux/proc/self/XXXXXXX -compact +.It Pa /compat/linux/proc +.Nm linprocfs +の標準マウントポイント。 +.It Pa /compat/linux/proc/cpuinfo +人間が判読しやすい形式の、CPU のベンダとモデルに関する情報。 +.It Pa /compat/linux/proc/meminfo +人間が判読しやすい形式の、システムのメモリ情報。 +.It Pa /compat/linux/proc/pid +プロセス +.Pa pid +のプロセス情報を含んだディレクトリ。 +.It Pa /compat/linux/proc/self +カレントプロセスのプロセス情報を含んだディレクトリ +.It Pa /compat/linux/proc/self/exe +実行形式イメージ +.It Pa /compat/linux/proc/self/mem +プロセスの完全な仮想アドレス空間 +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr procfs 5 , +.Xr mount_linprocfs 8 +.Sh 作者 +.Nm +は、 +.An Pierre Beyssac +によって +.Nm procfs +から作られました。 +このマニュアルページは、 +.An Garrett Wollman +が書いた +.Xr procfs 5 +マニュアルページに基づいて、 +.An Dag-Erling Smorgrav +が書きました。 +.Sh 歴史 +.Nm +は +.Fx 4.0 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man8/Makefile b/ja_JP.eucJP/man/man8/Makefile index 74bc047361..344709b4a0 100644 --- a/ja_JP.eucJP/man/man8/Makefile +++ b/ja_JP.eucJP/man/man8/Makefile @@ -50,6 +50,7 @@ MAN8 = IPXrouted.8\ dumpfs.8\ dumpon.8\ edquota.8\ + faithd.8\ fdcontrol.8\ fdisk.8\ fingerd.8\ diff --git a/ja_JP.eucJP/man/man8/faithd.8 b/ja_JP.eucJP/man/man8/faithd.8 new file mode 100644 index 0000000000..be3ff9ac37 --- /dev/null +++ b/ja_JP.eucJP/man/man8/faithd.8 @@ -0,0 +1,366 @@ +.\" $KAME: faithd.8,v 1.12 2000/07/04 13:15:01 itojun Exp $ +.\" +.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the project nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %FreeBSD: src/usr.sbin/faithd/faithd.8,v 1.2.2.2 2000/07/15 07:36:21 kris Exp % +.\" +.\" jpman %Id: faithd.8,v 1.3 2000/08/14 23:52:29 horikawa Stab % +.Dd January 27, 2000 +.Dt FAITHD 8 +.Os +.Sh 名称 +.Nm faithd +.Nd FAITH IPv6/v4 変換デーモン +.Sh 書式 +.Nm +.Op Fl dp +.Op Ar service Op Ar serverpath Op Ar serverargs +.Sh 解説 +.Nm +は IPv6 から IPv4 への TCP リレー機能を提供します。 +.Pp +.Nm +は IPv4/v6 デュアルスタックルータ上で起動しなければなりません。 +.Pp +.Tn TCPv6 +トラフィックが見つかると、 +.Nm +はその +.Tn TCPv6 +トラフィックを +.Tn TCPv4 +にリレーします。 +リレーする +.Tn TCPv4 +コネクションの終点は、元の +.Tn IPv6 +終点の末尾 4 オクテットから決定されます。 +例えば、 +.Nm +用に +.Li 3ffe:0501:4819:ffff:: +が予約されていて、 +.Tn TCPv6 +終点アドレスが +.Li 3ffe:0501:4819:ffff::0a01:0101 +なら、このトラフィックは IPv4 の終点 +.Li 10.1.1.1 +に向けてリレーされます。 +.Pp +.Nm +による変換サービスを用いるには、 +IPv4 アドレスをマップするための IPv6 アドレスプレフィクスを +予約しておく必要があります。 +カーネルは、そこで予約した IPv6 アドレスプレフィックスへの +すべての TCP コネクションを、 +.Xr route 8 +を用いて疑似インターフェース +.Xr faith 4 +にルーティングするように、適切に構築されていなければなりません。 +また、 +.Xr sysctl 8 +を用いて +.Dv net.inet6.ip6.keepfaith +を +.Dv 1 +に設定しておくべきです。 +.Pp +ルータは、予約された +.Tn IPv6 +アドレスプレフィックス行きのすべての TCP トラフィックを捕まえるように +設定しなければなりません。このためには +.Xr route 8 +と +.Xr sysctl 8 +のコマンドを使用します。 +.Ss デーモンモード +.Nm +がスタンドアロンプログラムとして起動されると、 +.Nm +は自分自身をデーモン化します。 +.Nm +は +.Tn TCPv6 +のポート +.Ar service +を listen します。 +ポート +.Ar service +への +.Tn TCPv6 +トラフィックを見付けると、コネクションをリレーします。 +.Pp +.Nm +が TCP ポート +.Ar service +を listen するので、 +.Xr inetd 8 +や他の標準的な仕組みを用いて、そのルータ上で +.Ar service +ポートを使うローカルな TCP デーモンを動作させることはできません。 +.Nm +に対して +.Ar serverpath +を指定することで、 +ルータ上でローカルデーモンを走らせることができます。 +終点アドレスがローカルのインターネットアドレスであれば、 +.Nm +は +.Ar serverpath +においてローカルデーモンを起動します。 +それ以外の場合、 +.Nm +は IPv4 TCP への変換を行います。 +ローカルデーモンの引数は +.Ar serverargs +を用いて指定することができます。 +.Pp +.Ar service +を省略すると +.Li telnet +が仮定され、 +.Nm +は TCP の +.Li telnet +ポートの TCP トラフィックをリレーします。 +.Ar service +を指定すると、 +.Nm +は前述のように、指定された +.Ar service +向けの TCP リレーデーモンとして動作します。 +.Pp +.Fl d +オプションを指定すると、 +.Xr syslog 3 +を用いてデバッグ情報を出力します。 +.Fl p +オプションを指定すると、 +IPv4 TCP コネクションを最終の終点向けにリレーする際、 +.Nm +はソースポートとして特権 TCP ポートを使用します。 +.Xr ftp 1 +や +.Xr rlogin 1 +をリレーする際は +.Fl p +オプションは不要です。そのための特別なプログラムコードが含まれています。 +.Pp +.Nm +は通常の TCP データも帯域外 TCP データもリレーします。 +TCP half close をエミュレートすることも可能です。 +.Nm +は +.Xr ftp 1 +と +.Xr rlogin 1 +で用いられるプロトコルに対して、特別なサポートを行います。 +FTP プロトコルを転送する際は、 +.Nm +は、 +.Li PORT/LPRT/EPRT +コマンドおよび +.Li PASV/LPSV/EPSV +コマンドにおけるネットワークレベルアドレスも変換します。 +RLOGIN プロトコルに対しては、 +.Nm +は、サーバ側の +.Xr rlogind 8 +からクライアント側の +.Xr rlogin 1 +への逆方向コネクションもリレーします。 +.Pp +アクティブでないセッションは 30 分で切断します。 +これは、使わなくなったセッションのせいでリソースが消費されるのを +防ぐためです。 +サービスによってはこの機能は適切でないかもしれません。 +.Pq この機能をコンフィギュレーション可能にすべきでしょうか? +.Ss inetd モード +.Nm +が +.Xr inetd 8 +から起動されると、 +.Nm +は標準入力から渡されるコネクションを扱います。 +コネクションの終点が、予約した IPv6 アドレスプレフィックスの範囲内の場合、 +.Nm +はコネクションをリレーします。 +それ以外の場合、 +.Nm +はサービスに対応する +.Xr telnetd 8 +のようなデーモンを起動し、 +.Xr inetd 8 +から渡されるコマンド引数を使用します。 +.Pp +.Nm +は、ローカルな TCP ポート番号を元に動作モードを決定し、 +必要な時/可能な時には特別なプロトコル処理を有効にします。 +例えば、 +.Nm +が FTP ポート上で +.Xr inetd 8 +から起動されると、これは FTP リレーとして動作します。 +.Pp +この動作モードでは、 +.Xr inetd 8 +中に +.Nm +用の特別なサポートを必要とします。 +.Sh 使用例 +.Nm +を起動する前に、 +.Xr faith 4 +インタフェースを適切に設定しておく必要があります。 +.Bd -literal -offset +# sysctl -w net.inet6.ip6.accept_rtadv=0 +# sysctl -w net.inet6.ip6.forwarding=1 +# sysctl -w net.inet6.ip6.keepfaith=1 +# ifconfig faith0 up +# route add -inet6 3ffe:501:4819:ffff:: -prefixlen 96 ::1 +# route change -inet6 3ffe:501:4819:ffff:: -prefixlen 96 -ifp faith0 +.Ed +.Ss デーモンモードのサンプル +.Li telnet +サービスを変換し、そしてローカルな telnet サービスを提供しない場合は、 +次のいずれかのように +.Nm +を起動します: +.Bd -literal -offset +# faithd +# faithd telnet +.Ed +.Pp +もし +.Pa /usr/local/v6/libexec/telnetd +にある +.Xr telnetd 8 +によるローカル telnet サービスを提供したい場合は、 +次のコマンドラインを使用します: +.Bd -literal -offset +# faithd telnet /usr/local/v6/libexec/telnetd telnetd +.Ed +.Pp +ローカルデーモンに追加の引数を渡したい場合は: +.Bd -literal -offset +# faithd ftpd /usr/local/v6/libexec/ftpd ftpd -l +.Ed +.Pp +他の使用例です。 +rsh/rlogin サービスを変換するには +.Fl p +が必要かもしれません。 +.Bd -literal -offset +# faithd sshd +# faithd login /usr/local/v6/libexec/rlogin rlogind +# faithd shell /usr/local/v6/libexec/rshd rshd +.Ed +.Pp +しかしながら、rlogin や rsh のコネクションを変換するときには注意が必要です。 +更なる詳細については +.Sx セキュリティ情報 +を参照してください。 +.Ss inetd モードのサンプル +.Xr inetd.conf 5 +に次の行を追加します。 +構文はオペレーティングシステムによって様々でしょう。 +.Bd -literal -offset +telnet stream faith/tcp6 nowait root faithd telnetd +ftp stream faith/tcp6 nowait root faithd ftpd -l +ssh stream faith/tcp6 nowait root faithd /usr/pkg/bin/sshd -i +.Ed +.Pp +.Xr inetd 8 +は、listen するソケットをオープンし、 +カーネルの TCP リレーサポートを有効化します。 +コネクションが到着すると、 +.Nm +が +.Xr inetd 8 +から起動されます。 +コネクションの終点が、予約した IPv6 アドレスプレフィックスの範囲内の場合、 +.Nm +はコネクションをリレーします。 +それ以外の場合、 +.Nm +はサービスに対応する +.Xr telnetd 8 +のようなデーモンを起動します。 +.Sh 戻り値 +成功すると +.Nm +は +.Dv EXIT_SUCCESS +.Pq 0 +で終了し、エラーがある場合は +.Dv EXIT_FAILURE +.Pq 1 +で終了します。 +.Sh 関連項目 +.Xr faith 4 , +.Xr route 8 , +.Xr sysctl 8 +.Rs +.%A Jun-ichiro itojun Hagino +.%A Kazu Yamamoto +.%T "An IPv6-to-IPv4 transport relay translator" +.%R internet draft +.%N draft-ietf-ngtrans-tcpudp-relay-01.txt +.%O work in progress material +.Re +.Sh セキュリティ情報 +.Nm +.Pq および他の TCP リレーサービス +でリレーされたコネクションに対し、 +.Xr rhosts 5 +をはじめとする IP アドレスベースの認証を用いるのは大変危険です。 +.Pp +.Nm +自身はアクセス制御を実装していません。 +これは、透過な TCP リレーサービスの実装を意図しているためです。 +管理者が IPv6 アドレスに基づいてパケットフィルタリングを行うことを、 +お勧めします。 +IPv6 の終点アドレスについては、 +.Xr route 8 +を用いて、 +.Xr faith 4 +を指す経路エントリを注意深く設定することで、制限可能です。 +IPv6 の始点アドレスについては、 +パケットフィルタでフィルタする必要があります。 +.Sx 関連項目 +に列挙した文書に、本件に関する更なる議論が記述されています。 +.\" +.Sh 歴史 +.Nm +コマンドは WIDE Hydrangea IPv6 プロトコルスタックキットで +初めて登場しました。 +.Pp +KAME プロジェクト (http://www.kame.net/) スタックに +基づく IPv6, IPsec サポートは、 +.Fx 4.0 +で初めて統合されました。