'\" te
.\"  Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\"  Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
.\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. This notice shall appear on any product containing this material.
.TH pg 1 "1996 年 2 月 25 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
pg \- CRT 用のファイル閲覧フィルタ
.SH 形式
.LP
.nf
\fBpg\fR [\fB-\fInumber\fR\fR] [\fB-p\fR \fIstring\fR] [\fB-cefnrs\fR] [+ \fIlinenumber\fR] [+/ \fIpattern\fR /] [\fIfilename\fR]...
.fi

.SH 機能説明
.sp
.LP
\fBpg\fR コマンドは、\fIfilename\fR を CRT 上で 1 度に 1 画面分調べることができるフィルタです。ユーザーが復帰改行を入力すると、他のページが表示されます。他の機能については次に示します。
.sp
.LP
このコマンドは、ユーザーがすでに通過したものを元に戻って見直すことができるという点で、今までのページングコマンドと異なります。この方法については、以下で説明します。
.sp
.LP
端末の属性を判定するために、\fBpg\fR は、\fBterminfo\fR(4) データベースを走査し、環境変数 \fBTERM\fR によって指定された端末タイプを求めます。\fBTERM\fR が定義されていない場合、端末タイプは \fBdumb\fR と見なされます。
.SH オプション
.sp
.ne 2
.mk
.na
\fB\fB-\fR\fInumber\fR \fR
.ad
.RS 16n
.rt  
\fBpg\fR がデフォルトの代わりに使用するウィンドウのサイズ (行数) を指定するための整数 (24 行を表示する端末では、デフォルトのウィンドウサイズは 23)。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-p\fR\fI string\fR \fR
.ad
.RS 16n
.rt  
\fBpg\fR は、\fIstring\fR をプロンプトとして使用します。プロンプトの文字列に \fB%d\fR がある場合は、プロンプトの中の \fB%d\fR は、プロンプトが出されたときの現在のページ番号と置き換えられます。デフォルトのプロンプト文字列は ``\fB:\fR'' です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-c\fR\fR
.ad
.RS 16n
.rt  
各ページを表示する前にカーソルをホームポジションに戻し、画面をクリアします。\fBterminfo\fR(4) データベースに、使用する端末タイプ用の \fBclear_screen\fR が定義されていない場合、このオプションは無視されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-e\fR\fR
.ad
.RS 16n
.rt  
\fBpg\fR は、各ファイルの終りで停止しません。\fI\fR
.RE

.sp
.ne 2
.mk
.na
\fB\fB-f\fR\fR
.ad
.RS 16n
.rt  
通常、\fBpg\fR は、スクリーン幅よりも長い行を分割します。しかし、表示されているテキストの文字シーケンスのなかには、好ましくない結果を生じるものもあります (たとえば、下線のためのエスケープシーケンス)。\fB-f\fR オプションは、\fBpg\fR が行を分割しないようにします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.RS 16n
.rt  
通常、コマンドは <\fInewline\fR> 文字で終了しなければなりません。このオプションを指定すると、コマンド文字を入力するとすぐにコマンドは自動的に終了します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR\fR
.ad
.RS 16n
.rt  
制限モード。シェルエスケープは却下されます。\fBpg\fR は、エラーメッセージを出力しますが、終了しません。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-s\fR\fR
.ad
.RS 16n
.rt  
\fBpg\fR は、標準出力モード (通常は、反転映像) ですべてのメッセージおよびプロンプトを出力します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB+\fR\fIlinenumber\fR \fR
.ad
.RS 16n
.rt  
\fIlinenumber\fR から表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB+/\fR\fIpattern\fR\fB/\fR \fR
.ad
.RS 16n
.rt  
正規表現パターンを含む最初の行から開始します。
.RE

.SH オペランド
.sp
.LP
次のオペランドがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fIfilename\fR\fR
.ad
.RS 12n
.rt  
表示するテキストファイルのパス名。\fIfilename\fR を省略するか、あるいは – を指定すると、標準入力と見なされます。
.RE

.SH 使用法
.SS "コマンド"
.sp
.LP
\fBpg\fR 入力を待っているときに打ち込むことができる応答は、次の 3 つのカテゴリに分割できます。閲覧の続行、検索、および閲覧環境の変更です。
.sp
.LP
閲覧を続けるためのコマンドには、前に \fIaddress\fR が来ます。これは、次のテキストが表示される場所を示す任意の符号付き数です。この \fIaddress\fR は、コマンドによって、ページか行のいずれかに解釈されます。符号付き \fIaddress\fR は、現在のページまたは行からの相対的な場所を指定し、符号なし \fIaddress\fR は、ファイルの先頭からの絶対アドレスを指定します。いずれのコマンドにも、アドレスが指定されていない場合に使用されるデフォルトのアドレスがあります。
.sp
.LP
閲覧のためのコマンドとそのデフォルトは、次のとおりです。
.sp
.ne 2
.mk
.na
\fB(+1)<\fInewline\fR> または <\fIblank\fR> \fR
.ad
.sp .6
.RS 4n
1 ページ表示します。アドレスは、ページ単位で指定されます。
.RE

.sp
.ne 2
.mk
.na
\fB(+1) \fBl\fR\fR
.ad
.sp .6
.RS 4n
相対アドレスとともに使うと、\fBpg\fR は指定された行数だけ画面を順方向または逆方向にスクロールをシミュレートします。絶対アドレスとともに使うと、このコマンドは、指定された行から始まる 1 画面を出力します。
.RE

.sp
.ne 2
.mk
.na
\fB(+1) \fBd\fR または \fB^D\fR\fR
.ad
.sp .6
.RS 4n
順方向または逆方向に半画面のスクロールをシミュレートします。
.RE

.sp
.ne 2
.mk
.na
\fB\fIi\fR\fBf\fR\fR
.ad
.sp .6
.RS 4n
テキストの \fIi\fR 個のスクリーンをスキップします。
.RE

.sp
.ne 2
.mk
.na
\fB\fIi\fR\fBz\fR\fR
.ad
.sp .6
.RS 4n
<\fInewline\fR> と同じですが、\fIi\fR がある場合、i がデフォルトの新しい 1 画面の行数になります。
.RE

.sp
.LP
次の閲覧コマンドに \fIaddress\fR は必要ありません。
.sp
.ne 2
.mk
.na
\fB\fB\&.\fR または \fB^L\fR\fR
.ad
.RS 20n
.rt  
ピリオドを単独で打ち込むと、テキストの現在のページが再表示されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB$\fR\fR
.ad
.RS 20n
.rt  
ファイルの中の最後のフルウィンドウを表示します。入力がパイプである場合は、注意してください。
.RE

.sp
.LP
以下のコマンドは、テキスト中のテキストパターンの検索に利用できます。正規表現については、\fBregex\fR(5) のマニュアルページを参照してください。\fB-n\fR オプションを指定する場合でも、必ず <\fInewline\fR> で終了しなければなりません。
.sp
.ne 2
.mk
.na
\fB\fIi\fR\fB/\fR\fIpattern\fR\fB/\fR\fR
.ad
.RS 14n
.rt  
\fIi\fR 回目の \fIpattern\fR の出現を順方向に検索します (デフォルトは \fIi\fR=1)。検索は、現在のページの直後から、現在のファイルが終了するまで続きます。循環はしません。
.RE

.sp
.ne 2
.mk
.na
\fB\fIi\fR\fB^\fR\fIpattern\fR\fB^\fR\fR
.ad
.RS 14n
.rt  

.RE

.sp
.ne 2
.mk
.na
\fB\fIi\fR\fB?\fR\fIpattern\fR\fB?\fR\fR
.ad
.RS 14n
.rt  
\fIi\fR 回目の \fIpattern\fR の出現を逆方向に検索します (デフォルトは \fIi\fR=1) 。検索は、現在のページの直前から、現在のファイルの初めまで続きます。循環はしません。^ 表記は、? の取り扱いが適切でない Adds 100 端末に有効です。
.RE

.sp
.LP
通常 \fBpg\fR は検索の後で、発見された行を画面の最上段に表示します。検索コマンドに \fBm\fR または \fBb\fR を追加することによって、それ以降ウィンドウの中央または最下段で見つかった行を残しておくことができます。接尾辞 \fBt\fR を使用して、元の状態に戻すことができます。
.sp
.LP
\fBpg\fR のユーザーは、以下のコマンドを使用して、閲覧の環境を変更することができます。
.sp
.ne 2
.mk
.na
\fB\fIi\fR\fBn\fR\fR
.ad
.RS 17n
.rt  
コマンド行の中の \fIi\fR 個後のファイルの閲覧を始めます。\fIi\fR は、符号なしの数で、デフォルトは 1 です。
.RE

.sp
.ne 2
.mk
.na
\fB\fIi\fR\fBp\fR\fR
.ad
.RS 17n
.rt  
コマンド行の中の \fIi\fR 個前のファイルの閲覧を始めます。\fIi\fR は、符号なしの数で、デフォルトは 1 です。
.RE

.sp
.ne 2
.mk
.na
\fB\fIi\fR\fBw\fR\fR
.ad
.RS 17n
.rt  
テキストの他のウィンドウを表示します。\fIi\fR が存在する場合は、ウィンドウサイズを \fIi\fR に設定します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBs\fR \fIfilename\fR\fR
.ad
.RS 17n
.rt  
指定されたファイルに入力を保存します。現在閲覧されているファイルのみが保存されます。\fBs\fR と \fIfilename\fR の間のスペースは任意です。\fB-n\fR オプションを指定する場合でも、このコマンドは、必ず <\fInewline\fR> で終了しなければなりません。
.RE

.sp
.ne 2
.mk
.na
\fB\fBh\fR\fR
.ad
.RS 17n
.rt  
利用可能なコマンドの一覧を簡略化して表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBq\fR または \fBQ\fR\fR
.ad
.RS 17n
.rt  
\fBpg\fR を終了します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB!\fR\fBcommand\fR\fR
.ad
.RS 17n
.rt  
\fIcommand\fR を、\fBSHELL\fR 環境変数に指定されているシェルに引き渡します。SHELL 環境変数に値が指定されていない場合は 、デフォルトのシェルを使用します。\fB-n\fR オプションを指定する場合でも、このコマンドは、必ず <\fInewline\fR> で終了しなければなりません。
.RE

.sp
.LP
出力が端末に送信されるときはいつでも、ユーザーは、中止キー (通常は CTRL-\) または割り込み (ブレーク) キーを打つことができます。これによって、\fBpg\fR は出力の送信を停止し、プロンプトを表示します。またユーザーは、前述のコマンドの 1 つを通常の方法で入力することができます。残念ながら、この場合、出力がなくなる場合があります。なぜなら、終了シグナルが発生すると、端末の出力待ちキューの文字がフラッシュされるからです。
.sp
.LP
標準出力が端末ではない場合は、\fBpg\fR は \fBcat\fR(1) と同じような働きをします。ただし、ファイルが 2 つ以上ある場合、各ファイルの前にヘッダーが出力されます。
.SS "大規模ファイルの動作"
.sp
.LP
ファイルが 2G バイト (2^31 バイト) 以上ある場合の \fBpg\fR の動作については、\fBlargefile\fR(5) を参照してください。
.SH 使用例
.LP
\fB例 1 \fR\fBpg\fR を使用してシステム情報を読み取る
.sp
.LP
次のコマンド行は、\fBpg\fR を使用してシステム情報を読み取ります。

.sp
.LP
\fBexample% news | pg \fR\fB-p\fR\fB "(Page %d):"\fR

.SH 環境
.sp
.LP
\fBpg\fR の実行に影響を与える次の環境変数についての詳細は、\fBenviron\fR(5) を参照してください。 \fBLC_CTYPE\fR、\fBLC_MESSAGES\fR、および \fBNLSPATH\fR。
.sp
.LP
以下の環境変数も \fBpg\fR の実行に影響を与えます。
.sp
.ne 2
.mk
.na
\fB\fBCOLUMNS\fR\fR
.ad
.RS 11n
.rt  
水平方向の画面サイズを決定します。この変数が設定されていない、あるいは \fINULL\fR に設定されているときは、\fBTERM\fR の値、ウィンドウサイズ、またはボーレート、もしくはこれらの値の組み合わせにより、画面サイズ計算用の端末タイプが表されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fBLINES\fR\fR
.ad
.RS 11n
.rt  
画面に表示する行数を決定します。この変数が設定されていない、あるいは \fINULL\fR に設定されているときは、\fBTERM\fR の値、ウィンドウサイズ、またはボーレート、もしくはこれらの値の組み合わせにより、画面サイズ計算用の端末タイプが表されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fBSHELL\fR\fR
.ad
.RS 11n
.rt  
! コマンド用に実行するコマンドインタプリタの名前を決定します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBTERM\fR\fR
.ad
.RS 11n
.rt  
端末の属性を決定します。またオプションとして、\fBTERM\fR の値に基づいた、システムに依存するデータベースの検索を試みます。情報が何も存在しない場合には、カーソルによるアドレス指定が不可能な端末と見なされます。
.RE

.SH 終了ステータス
.sp
.LP
次の終了ステータスが返されます。
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
.rt  
正常終了。
.RE

.sp
.ne 2
.mk
.na
\fB>\fB0\fR\fR
.ad
.RS 6n
.rt  
エラーが発生した。
.RE

.SH ファイル
.sp
.ne 2
.mk
.na
\fB\fB/tmp/pg*\fR \fR
.ad
.sp .6
.RS 4n
入力がパイプからの場合の一時ファイル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/share/lib/terminfo/?/*\fR\fR
.ad
.sp .6
.RS 4n
端末情報データベース
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp

.sp
.TS
tab() box;
cw(2.75i) cw(2.75i) 
lw(2.75i) lw(2.75i) 
.
属性タイプ属性値
使用条件system/core-os
CSI有効
.TE

.SH 関連項目
.sp
.LP
\fBcat\fR(1), \fBgrep\fR(1), \fBmore\fR(1), \fBterminfo\fR(4), \fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBregex\fR(5)
.SH 注意事項
.sp
.LP
端末入力を待っている間に、\fBpg\fR は BREAK、CTRL-C、および CTRL–\ に応答して実行を終了します。しかし、プロンプトの出ている間であれば、これらのシグナルは、\fBpg\fR の現在のタスクに割り込み、プロンプトモードに戻ります。割り込みによってパイプラインの中の他のコマンドが終了してしまう可能性があるので、パイプから入力を読み取るときには注意が必要です。
.sp
.LP
区切り記号 \fB/\fR、\fB^\fR、または \fB?\fR は、検索コマンドから省略することができます。
.sp
.LP
区切り記号タブが 8 カラムごとに設定されていないと、好ましくない結果が生じることがあります。
.sp
.LP
端末 I/O オプションを変更する他のコマンドとともに \fBpg\fR をフィルタとして使用すると、端末設定が正しく復元されないことがあります。