prs コマンド (SCCS)
目的
ソース・コード制御システム (SCCS) のファイルを表示します。
構文
prs [ -a ] [ -d String ] [ -r [ SID ] | [ -c Cutoff ] ] [ -e | -l ] File ...
説明
prs コマンドは、まず指定ファイルを読み取り、次にソース・コード制御システム (SCCS) ファイルの一部またはすべてを標準出力へ書き出します。File パラメーターにディレクトリーを指定すると、prs コマンドはすべての SCCS ファイル (s. 接頭部の付いたファイル) で要求されたアクションを実行します。File パラメーターに - (マイナス) を設定すると、prs コマンドは標準入力を読み取り、各行を SCCS ファイル名として解釈します。prs コマンドは、ファイル終わり文字に達するまで、入力の読み取りを続けます。
データ・キーワード
データ・キーワードは SCCS ファイルの中で、検索されて標準出力に書き出される部分を指定します。SCCS ファイルのすべての部分に、関連するデータ・キーワードがあります。データ・キーワードは指定された指定ファイル内で、何度でも使用できます。
prs コマンドが表示する情報は、ユーザー提供のテキスト、および認識されたデータ・キーワードが該当する値 (SCCS ファイルから抽出された値) で置き換えられて、指定されたファイルに表示される順番で示されます。データ・キーワード値のフォーマットは、キーワード置き換えが直接行われる単純フォーマットか、または置き換えの後に復帰が続く複数行フォーマットです。テキストは、認識されたデータ・キーワード以外の文字で構成されます。¥t (円記号、文字 t) でタブ文字を、¥n (円記号、文字 n) で復帰または改行文字を指定します。¥t および ¥n に余分な ¥ (円記号) を付けると、シェルが ¥ を解釈しなくなり、文字 t または n のみをテキストとして prs コマンドに渡すので注意してください。
以下の表は、SCCS ファイルのデルタ・テーブルの情報と関連したキーワードをリストしたものです。 特に断りがない限り、すべてのキーワードは単純フォーマットです。
| キーワード | 表されるデータ | 値 |
|---|---|---|
| :R: | リリース番号 | 数値 |
| :L: | レベル番号 | 数値 |
| :B: | 分岐番号 | 数値 |
| :S: | シーケンス番号 | 数値 |
| :I: | SCCS の ID 文字列 (SID) | :R::L::B::S: |
| :Dy: | デルタ作成年 | YY |
| :Dm: | デルタ作成月 | MM |
| :Dd: | デルタ作成日 | DD |
| :D: | デルタ作成日付 | YY/MM/DD |
| :Th: | デルタ作成時 | HH |
| :Tm: | デルタ作成分 | MM |
| :Ts: | デルタ作成秒 | SS |
| :T: | デルタ作成時刻 | HH/MM/SS |
| :DT: | デルタ・タイプ | D または R |
| 項目 | 説明 | 値 |
|---|---|---|
| :P: | デルタ作成者 | ログイン名 |
| :DS: | デルタ・シーケンス番号 | 数値 |
| :DP: | 直前のデルタ・シーケンス番号 | 数値 |
| :Dt: | デルタ情報 | :DT::I::D::T::P::DS::DP: |
| :Dn: | 含まれるデルタのシーケンス番号 | :DS: . . . |
| :Dx: | 除外されるデルタのシーケンス番号 | :DS: . . . |
| :Dg: | 無視されるデルタのシーケンス番号 | :DS: . . . |
| :DI: | 含まれ、除外され、無視されるデルタのシーケンス番号 | :Dn:/:Dx:/:Dg: |
| :Li: | デルタが挿入する行数 | 数値 |
| :Ld: | デルタが削除する行数 | 数値 |
| :Lu: | デルタが変更しない行数 | 数値 |
| :DL: | デルタ行の統計情報 | :Li:/:Ld:/:Lu: |
| :MR: (複数行フォーマット) | デルタの MR 番号 | テキスト |
| :C: (複数行フォーマット) | デルタ用のコメント | テキスト |
以下の表は、SCCS ファイルのヘッダー・フラグと関連したキーワードをリストしたものです。 特に断りがない限り、すべてのキーワードは単純フォーマットです。
| キーワード | 表されるデータ | 値 |
|---|---|---|
| :Y: | モジュール・タイプ | テキスト |
| :MF: | MR 妥当性検査フラグ・セット | yes または no |
| :MP: | MR 妥当性検査プログラム名 | テキスト |
| :KF: | キーワード/エラー警告フラグのセット | yes または no |
| :BF: | 分岐フラグのセット | yes または no |
| :J: | 結合編集フラグのセット | yes または no |
| :LK: | ロック・リリース | :R: . . . |
| :Q: | ユーザー定義のキーワード | テキスト |
| :M: | モジュール名 | テキスト |
| :FB: | フロア境界 | :R: |
| :CB: | シーリング境界 | :R: |
| :Ds: | デフォルト SID | :I: |
| :ND: | null デルタ・フラグ・セット | yes または no |
| :FL: (複数行フォーマット) | ヘッダー・フラグ・リスト | テキスト |
以下の表は、SCCS ファイルのほかの部分と関連したキーワードをリストしたものです。 特に断りがない限り、すべてのキーワードは単純フォーマットです。
| キーワード | 表されるデータ | 値 |
|---|---|---|
| :UN: (複数行フォーマット) | ユーザー名 | テキスト |
| :FD: (複数行フォーマット) | 記述テキスト | テキスト |
| :BD: (複数行フォーマット) | テキストの本体 | テキスト |
| :GB: (複数行フォーマット) | g ファイル内のテキスト | テキスト |
| :W: | what 文字列 | :Z::M: ¥tab :I: |
| :A: | what 文字列 | :Z::Y::M::I::Z: |
| :Z: | what 文字列の区切り文字 | @(#) |
| :F: | SCCS ファイル名 | テキスト |
| :PN: | SCCS ファイルのパス名 | テキスト |
フラグ
指定された各ファイルには、各フラグまたはフラグ・グループが個別に適用されます。
| 項目 | 説明 |
|---|---|
| -a | 指定デルタの情報を、除去されているか否かに関係なく書き込みます (rmdel コマンドを参照してください)。 -a フラグを指定しない場合には、prs コマンドは除去されていない指定デルタについてのみ情報を提供します。 |
| -c Cutoff | -e および -l フラグに対して、カットオフの日付と時刻を指定します。以下のフォーマットで、
Cutoff 値を指定します。
省略されたエントリーにはすべてデフォルト値として最大値が使用されるので、-c8402 と指定するのは -c840229235959 と指定するのと同じことになります。フィールドは、非数値文字で区切ることができます。例えば、-c84/2/20,9:22:25 または -c"84/2/20 9:22:25" または "-c84/2/20 9:22:25" と指定できます。-c フラグは -r フラグとともに指定することはできません。 |
| -d String | 表示されるデータ・エントリーを指定します。文字列は、オプションのテキストおよび SCCS ファイル・データ・キーワードで構成されます。文字列には MBCS (マルチバイト文字セット) 文字を含めることができます。文字列にスペースが入っている場合、その文字列は引用符で囲まなければなりません。 |
| -e | -r フラグで指定されたデルタを含めて、それ以前に作成されたすべてのデルタに関する情報を要求します。 |
| -l | -r フラグで指定されたデルタを含めて、それ以降に作成されたすべてのデルタに関する情報を要求します。 |
| -r[SID] | prs コマンドが情報を検索するデルタの SCCS ID 文字列 (SID) を指定します。-r フラグとオプションの SID パラメーターの間には、スペースを入れないでください。SID が指定されない場合は、このコマンドは最高番号のデルタの SID に関する情報を検索します。-r フラグは -c フラグとともに指定することはできません。 |
終了状況
このコマンドは、以下の終了値を戻します。
| 項目 | 説明 |
|---|---|
| 0 | 正常終了。 |
| >0 | エラーが発生しました。 |
例
- SCCS ファイル名 s.test.c について作成されたすべてのデルタ
(rmdel コマンドを使用して除去したすべてのデルタを含む) に関する情報を表示するには、以下のように入力します。
prs -a s.test.c - s.test.c の SID 1.2 に関して、ユーザー・ログイン名、デルタによって挿入された行数、およびデルタによって削除された行数を表示するには、以下のように入力します。
prs -r1.2 -d":P:¥n:Li:¥n:Ld:" s.test.c
ファイル
| 項目 | 説明 |
|---|---|
| /usr/bin/prs | prs コマンドが入っています。 |