p4 tag

概要

ファイルにラベルでタグ付けします。

構文

p4 [g-opts] tag [-d -g -n -U] -l labelname file[revRange] …

解説

p4 tagを使用して、指定したファイルリビジョンにラベルでタグ付けします。labelnameが必要です。labelnameという名前のラベルがない場合は、その名前のラベルが自動的に作成されます。このラベルがすでに存在する場合、そのラベルでファイルのタグ付けまたはタグ解除を行うには、ユーザはそのラベルのOwner:でなければならず、ラベルはunlockedでなければなりません(ラベルの所有者やロックステータスを変更するには、p4 labelを使用します)。

file引数にリビジョン指定が含まれていない場合は、最新リビジョンがラベルでタグ付けされます。file引数にリビジョン範囲指定が含まれている場合は、その範囲のリビジョンを持つファイルだけがタグ付けされます(指定した範囲に1つのファイルの複数のリビジョンが存在する場合は、指定した範囲で最も大きい番号のリビジョンがタグ付けされます)。

オプション

-d

指定したファイルからラベルタグを削除します。

-g

分散環境では-gオプションを使用して、適用するラベルをエッジサーバに対してローカルにするか、またはコミットサーバからグローバルに使用できるようにするかを指定します。グローバルラベルを更新するには、クライアントワークスペースもバインドされていない(グローバル)ワークスペースにする必要があります。

-l labelname

ファイルリビジョンに適用されるラベルを指定します。

-n

実際の操作を実行せずに、p4 tagの動作内容を表示します。

-U

ファイルに新しいラベルをタグ付けするとき、新しく作成されるラベルにunloadオプションを設定します。このオプションを既存のラベルに使用しても何の効果もありません。

g-opts

“グローバルオプション”」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか?

ファイル引数にリビジョン範囲を使えるか?

最低限必要なアクセスレベル

使用可

使用可

list

  • デフォルトでは、p4 tagは、ディポ内のファイルの最新リビジョンに対して動作します。クライアントワークスペースの状態を保存するには、p4 labelsyncを使用します。このコマンドはクライアントワークスペースに最後に同期されたファイルのリビジョンに対して動作します。

  • 分散Perforceサービスでは、p4 labelsyncはエッジサーバのローカルなラベルに対して動作します。-gオプションは、グローバルラベルを適用するときに使用できます。ただし、クライアントワークスペースはバインドされていない(グローバルである)必要があります。

    ラベルはデフォルトでエッジサーバに対してローカルになります。コミットサーバのグローバルラベルには-gオプションを使用してアクセスします。管理者がrpl.labels.global1に設定している場合、ラベルはデフォルトでグローバルになります。つまり、-gオプションは反転してローカルラベルの更新を可能にします。

p4 tag -l rel1 //depot/1.0/...

//depot/1.0/...内のファイルの最新リビジョンにラベルrel1でタグ付けします。

ラベルrel1が存在しない場合は、それを作成します。

p4 tag -l build //depot/1.0/...@1234

//depot/1.0/...内のファイルでチェンジリスト1234のサブミット時点で最も新しいリビジョンにラベルbuildでタグ付けします。

ラベルbuildが存在しない場合は、それを作成します。

p4 files @labelname

labelnameでタグ付けされたファイルリビジョンをリストします。

関連コマンド

ラベルを作成または編集する。

p4 label

システムに認識されているすべてのラベルをリストする。

p4 labels

クライアントワークスペースのリビジョンにラベルでタグ付けする。

p4 labelsync