p4 stream

ストリームの名前(永続的な識別子)およびストリームディポでのパスを、 //depotname/streamnameの形式で指定します。

Error in stream specification. Stream streamname does not reflect depot
depth-field streamdepth.

ファイル名とエンティティに関する文字の制限に 注意してください。

ストリーム仕様が最後に変更された日付。

ストリームの仕様が 最後にHelixサーバコマンドによって アクセスされた日時。

ストリームを所有しているHelixサーバユーザ またはグループ。 デフォルトは、ストリームを作成したユーザです。

ストリームの名前を表示します。Stream:フィールドとは異なり、 このフィールドは変更可能です。デフォルト値は、 ストリームパスのstreamnameの部分です。

このストリームの親。ストリームのType:がmainlineの場合はnoneにし、 それ以外の場合は//depotname/streamnameの形式で 既存のストリーム識別子に設定しなければなりません。

ストリームのタイプによって、想定される変更フローが決定されます。有効なストリームタイプは、mainline、 development、release、 virtual、taskです。

• mainline

  メインラインストリームはストリームディポ内のすべてのストリームの親です。 あらゆるストリームディポには少なくとも1つのメインラインストリームが 存在しなければなりません。

• virtual

  バーチャルストリームを使用すると、ローカルデータを保存せずに親ストリームと 子ストリームの間でマージおよびコピーを行うことができます。 データはバーチャルストリームのビューに定義されている ファイル範囲に関する制約を適用した後に、 コピー/マージ先(バーチャルストリーム以外)に送られます。

  バーチャルストリームはディポのネームスペースにファイルを持たないため、 バーチャルストリームをインポートすることはできません。

• release

  メインラインよりも安定性の高いストリームです。 リリースストリームは親からコピーされ、親へとマージされます。

• development

  メインラインよりも安定性の低いストリームです。開発ストリームは、親ストリームからマージされ、 親へとコピーされることが想定されます。

  注意

  デフォルトのストリームタイプはdevelopmentです。

• task

  タスクストリームは軽量の短期的なブランチであり、バグ修正や、 ブランチデータのほんの一部しか修正しない新機能の使用に役立ちます。

  リポジトリのメタデータを最小限に抑えるには、シャドウテーブルは、 分岐(コピー)ファイルのみを追跡させます。 タスクストリームを削除またはアンロードすると、シャドウテーブルが削除されます。

  注意

  タスクストリームに関連付けられたワークスペースではすべてのブランチ済ファイルを 参照できますが、ストリームの名前空間へのアクセス権があるユーザには、 変更されたか昇格したファイルのみが可視となります。

  例えば、タスクのストリームに関連付けられていないワークスペースから、タスクストリームのチェンジリストのためにp4 describeを実行する場合、サブミットしたファイルのサブセットのみが表示されます。

  ヒント

  タスクストリームでimport+パスにファイルをサブミットすることはできません。 「import+ view_path [depot_path]」でパスタイプの説明を参照してください。

ストリームに関する説明。

ストリームの動作を構成する設定を以下に示します。

• [un]locked

  他のユーザによるストリームの編集または削除を有効/無効にします。 ロックされている場合、ストリーム仕様は削除できず、 所有者のみが変更可能です。デフォルト値はunlockedです。

• [all|owner]submit

  ストリームの変更のサブミットを、すべてのユーザに許可するか、 所有者にのみ許可するかを指定します。デフォルト値はallsubmitです。 ownersubmitがマークされたストリームの Owner:がグループである場合、そのグループのメンバーである すべてのユーザが変更をストリームにサブミットできます。

• [no]toparent

  当該ストリームからその親への反映が想定されるかどうかを指定します。 デフォルト値はtoparentです。

• [no]fromparent

  親から当該ストリームへの反映が想定されるかどうかを指定します。 デフォルト値は、メインラインおよび開発ストリームはfromparent、 リリースストリームはnofromparentです。

• mergeany | mergedown

  マージフローの制限、または他のストリームからのマージの許可を設定します。 例えば、mergeanyオプションは、警告なく子から親へのマージを 可能にします。

virtualタイプのストリームには、フローオプションとしてnotoparentとnofromparentを 設定する必要があります。

mainlineタイプのストリームでは、フローオプションは無視されます。

親ストリームからビューを継承するかどうかを指定します。

開発ストリーム、リリースストリーム、またはメインラインストリームを初めて作成すると、 --parentviewパラメータを使用してParentViewフィールドを設定できるようになります。 このパラメータで、「inherit」または「noinherit」という値を設定します。

--parentviewパラメータを指定せずに、開発ストリーム、 リリースストリーム、またはメインラインストリームを作成する場合は、 dm.stream.parentview構成可能変数により、 ParentViewフィールドのデフォルト値が決まります。

ストリームの作成後に、ストリーム仕様を編集してParentViewフィールドの値を 変更することはできません。代わりに、p4 stream parentviewコマンドを使用して、 ストリームのParentViewフィールドの値を変更する必要があります。 詳しくは、p4 help streamcmdsコマンドの出力情報を参照してください。

ファイルがどのようにストリーム構造に組み込まれるかを定義します。 以下の形式を使用して、パスを指定します。

path_type view_path [depot_path]

ただし、path_typeは単一のキーワード、 view_pathは頭にスラッシュが付かないファイルパスです。 任意指定のdepot_pathは、//で始まるファイルパスです。

デフォルトのパスはshare ...です

有効なパスタイプを以下に示します。

• share view_path

  指定されたファイルは、親ストリームからのまたは親ストリームへの同期、 サブミット、反映が可能です。

• isolate view_path

  指定されたファイルは、親ストリームからのまたは親ストリームへの同期および サブミットが可能ですが、反映は実行できません。

• import view_path [depot_path]

  指定されたファイルは、親ストリームからのまたは親ストリームへの同期が可能ですが、 サブミットまたは反映は実行できません。 view_pathは親ストリームのビューにマッピングされるか、 (任意指定の)depot_pathにマッピングされます。

  depot_pathには、チェンジリスト指定子が含まれる場合があります。 ストリームに関連付けられたクライアントワークスペースには、 このディポパス内の変更のリビジョンまたはそれ以下の リビジョンのみが表示されます。例えば、ディポパスに//depot/import/...@1000を指定すると、 1000より大きいチェンジリストのリビジョンは、 ほとんどのコマンドで非表示になります。

  注意

  チェンジリスト番号の代わりに、自動ラベル定義を使用できます。

  特定のストリームワークスペースのチェンジリストの制限内容は、 ChangeViewと呼ばれる読み取り専用のクライアント ワークスペース仕様フィールドで表示されます。

• import+ view_path [depot_path]

  ストリームディポの外部からストリームへパスをマッピングする場合は、 標準のimportパスと同様に機能しますが、標準のimportパスとは異なり、 import+パス内のファイルに対して変更をサブミットすることができます。

• ストリーム仕様の1対多の反復マッピングを実行する場合は、import& <view_path> <depot_path>を使用します。これはimportパスに似ていますが、複数のimport&パスで1つの<depot_path>を複数の<view_path>にマッピングできる点が異なっています。この方法でマーキングされたファイルは、読み取り専用ファイルになります。<depot_path>が必要になります。import&機能を使用するには、リリース2021.2以降のHelix Coreサーバが必要になります。この機能では、グラフディポ HelixサーバにGitリポを保存するために使用されるグラフタイプのディポ。「Helix4Git」と「クラシックディポ」も参照してください。はサポートされていません。

• exclude view_path

  指定されたファイルは、親ストリームからのまたは親ストリームへの同期、 サブミットまたは反映を実行できません。

デフォルトでは、ストリームは親ストリームの構造を引き継ぎます (メインラインは親がないため除外)。

パスは子ストリームのビューから引き継がれます。子ストリームのパスでは引き継がれたビューの ダウングレードは可能ですが、アップグレードすることはできません。 (例えば、子ストリームではsharedパスをisolatedパスにダウングレードできますが、 親ストリームでパスがisolatedとして定義されている場合、 子ストリームでパスをsharedに指定してフルアクセスに戻すことはできません)

>Stream //project1/mainQ mainline none 'mainQ'
Stream //project1/devQ1 development //project1/mainQ 'devQ1'
Stream //project1/devQ1-virt virtual //project1/devQ1 'devQ1-virt'

>import foo/...
share foo/src/libs/lib1/...

share ... 
  isolate BIN/....CLASS
  isolate BIN/....exe
  import imports/lib/*.a //depot/3rd_party/lib/*.a 
  import imports/lib/*.dll //depot/3rd_party/lib/*.dll
  import imports/src/*.h //depot/3rd_party/src/*.h
  exclude doc/....fm

ワークスペースファイルの位置を再割り当てします。 反映元パスとワークスペース内での位置を指定するには、 次の構文を使用します。

view_path_1 view_path_2

「view_path_1」と「view_path_2」は、 Helixサーバのビューパスです(パスの先頭に スラッシュとワイルドカードを指定しないでください。 また、ワイルドカードをパスに含めないでください。ただし、 パスの最後であれば、ワイルドカードを指定することができます)。 例えば、ファイルがローカルのProjectXフォルダに同期されるようにするには、 次のようにマッピングし直します。

... projectX/...

Remapped:フィールドでは行の順序に意味があります。 複数行が同じファイルに再割り当てされている場合、後の行が優先されます。 再割り当ては子ストリームおよび関連付けられたワークスペースに引き継がれます。

ストリームを削除します(そのストリームのストリーム仕様も削除されます)。

以下の要素によって参照されているストリーム仕様を削除することはできません。

• 任意の子ストリームのストリーム仕様

• 任意のストリームクライアントワークスペースのストリームパス

• 任意のクライアントワークスペースの仕様内のStream:フィールド

ストリーム仕様を削除する場合、以下のような動作になります。

• 対象のストリームに関連付けられたファイルは削除されません。p4 obliterateコマンドを実行した場合にのみ、ファイルが完全に削除されます。

• 削除されたストリームに関連付けられているファイルは変更されません。

• 同じストリーム仕様を同じストリーム名で再作成することができます。これにより、もう一度ファイルにアクセスできるようになります。

管理者は-fオプションを使用して、他のユーザが所有しているロックされた ストリームを削除または変更することが可能です。

ストリーム仕様を標準入力から読み取ります。

ストリーム仕様を標準出力に書き出します。デフォルトでは、 クライアントワークスペースに関連するストリームを出力します。 stream@change引数を渡した場合、 Helixサーバは、指定された時点の チェンジリストのストリームのバージョンを使用します。

冗長オプション。このストリーム用に自動生成されたクライアントビューを含めます。

新しいストリーム仕様を作成する際にストリームの親を指定します。 (このオプションは既存のストリーム仕様には効果がありません)

新しいストリーム仕様を作成する際に、 ストリームのタイプを、mainline、development、release、 task、virtualのどれかに指定しなければなりません。

メインラインストリーム、開発ストリーム、リリースストリームでp4 stream parentviewコマンドを使用して、 parentviewフィールドの値を「inherit」または「noinherit」に設定することができます。

このコマンドを実行するとストリーム仕様が作業状態になるため、 ParentViewフィールドの値を変更することができます。Pathsフィールド、Remappedフィールド、Ignoredフィールドの値を変更することもできます。

ストリーム仕様に対する変更内容は、サブミットするまで パブリックな変更になることはありません。ParentViewの変更をサブミットすると、その変更内容がストリーム仕様の 反映履歴に取り込まれます。

p4 stream resolveは、作業開始以降にストリーム仕様にサブミットされた 変更の衝突を解決します。 新しい変更の衝突が解決されるまで、ストリーム仕様に変更をサブミットすることはできません。

p4 resolve -Soコマンドは、p4 stream resolveコマンドと 同じ結果になります(p4 help editを参照)。

p4 stream revertコマンドを実行すると、作業状態の仕様に対する保留中の変更が元に戻ります。これにより、クライアントが、サブミット後の最新バージョンのストリームに戻ります。

p4 revert -Soコマンドは、p4 stream revertコマンドと同じ結果になります。

p4 streams