p4 stream
概要
ストリーム仕様を作成、編集、または削除します。
構文
p4 [g-opts
] stream [-P parent
] -t type
name
p4 [g-opts
] stream [-f -d] [-o [-v]] [-P parent
] -t type
name
p4 [g-opts
] stream -i [-f]
解説
p4 streamコマンドによってPerforceストリームを管理することができます。ストリームとは、変更の構造とフローを制御するための戦略を持つ、階層構造からなるブランチです。ストリームの階層は、ユーザがストリームに割り当てるタイプによって指定されるストリームの安定性に基づきます。開発(development)ストリームは最も安定性が低く(最も変化しやすい)、メインライン(mainline)ストリームは比較的安定性が高く、リリース(release)ストリームは非常に安定しています。仮想(Virtual)ストリームを使用すると、ローカルデータを保存せずに親ストリームと子ストリームの間でコピーおよびマージを行うことができます。タスク(Task)ストリームは軽量の短期的なブランチであり、バグ修正や、ブランチデータのほんの一部しか修正しない新機能の使用に役立ちます。
ストリームの内容はユーザがマッピングするパスによって定義されます。デフォルトでは、ストリームはその親(ブランチ元となったストリーム)と同じ構造を持ちますが、その構造をオーバーライドして、例えば特定のファイルを他のストリームにサブミットするか反映することができないようにすることができます。
ストリームの詳細については、『P4ユーザーズガイド』を参照してください。
フォームフィールド
フィールド名 |
タイプ |
解説 |
---|---|---|
|
書き込み可能、入力必須 |
ストリームの名前(永続的な識別子)およびストリームディポでのパスを、 |
|
読み取り専用 |
ストリーム仕様が最後に変更された日付。 |
|
読み取り専用 |
ストリーム仕様が最後にPERFORCEコマンドによってアクセスされた日時 |
|
書き込み可能、入力必須 |
ストリームを所有しているPerforceユーザまたはグループ。デフォルトは、ストリームを作成したユーザです。 |
|
書き込み可能 |
ストリームの名前を表示します。 |
|
書き込み可能 |
このストリームの親。ストリームの |
|
書き込み可能、入力必須 |
ストリームのタイプによって、想定される変更フローが決定されます。有効なストリームタイプは、
デフォルトのストリームタイプは |
|
書き込み可能、任意入力 |
ストリームに関する説明。 |
|
書き込み可能 |
以下に示す、ストリームの動作を構成する設定:
|
|
書き込み可能 |
ファイルがどのようにストリーム構造に組み込まれるかを定義します。以下の形式を使用して、パスを指定します。
ただし、
デフォルトのパスは 有効なパス・タイプを以下に示します。
デフォルトでは、ストリームは親ストリームの構造を引き継ぎます(メインラインは親がないため除外)。
パスは子ストリームのビューから引き継がれます。子ストリームのパスでは引き継がれたビューのダウングレードは可能ですが、アップグレードすることはできません。(例えば、子ストリームでは
|
|
書き込み可能、任意入力 |
ワークスペース・ファイルの位置を再割り当てします。反映元パスとワークスペース内での位置を指定するには、以下の構文を使用します。
ただし、
|
|
書き込み可能、任意入力 |
クライアント・ビューで無視されるべきファイル名またはディレクトリ名のリスト。例: /tmp # ignores files named "tmp" /tmp/... # ignores directories named "tmp" .tmp # ignores file names ending in .tmp
|
オプション
|
ストリーム仕様を削除します。ストリーム仕様は、子ストリームまたはストリームのクライアント・ワークスペースによって参照されている場合には削除できません。ストリームを削除しても、その中のファイルは削除されませんが、変更をそのストリームにサブミットできなくなります。 |
|
管理者は |
|
ストリーム仕様を標準入力から読み取ります。 |
|
ストリーム仕様を標準出力に書き出します。 |
|
冗長オプション。このストリーム用に自動生成されたクライアントビューを含めます。 |
|
新しいストリーム仕様を作成する際にストリームの親を指定します。(このオプションは既存のストリーム仕様には効果がありません。) |
|
新しいストリーム仕様を作成する際に、ストリームのタイプを |
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
-
その名前が示すとおり、タスクストリームは短期的な使用が意図されています。変更を親ストリームに昇格させてタスクストリームの使用を終了したら、タスクストリームを削除してください。
例
p4 stream -t development -P main //projectX/bruno-dev |
メインラインをブランチすることにより、プロジェクトX用の開発ストリームを作成します。 |