p4 label
ラベル仕様およびそのビューの生成または編集を行います。
構文
p4 [g-opts] label [-f -g] [-t template] labelname
p4 [g-opts] label -d [-f -g] labelname
p4 [g-opts] label -o [-t template] labelname
p4 [g-opts] label -i [-f -g]
説明
p4 label
を使用して新しいラベル仕様の生成または既存のラベル仕様の編集を行います。 labelname
が必要です。
p4 label
を実行すると、ラベルに含めることが認められている一連のファイルを管理するマッピングを構成することができます。 ラベルを構成した後、p4 labelsync
またはp4 tag
を使用して、そのラベルでファイルにタグ付けします。
ラベルは自動または静的に設定することができます。 自動ラベルは、[View:
]フィールドおよび[Revision:
]フィールドで指定されたリビジョンを参照します。 静的ラベルは、p4
labelsync
コマンドまたはp4
tag
コマンドによりラベルにタグ付けされた特定のリビジョンのみを参照します。
unlocked
のラベルのOwner:
のみが、p4 labelsync
またはp4 tag
を使用して、そのラベルでファイルにタグ付けすることができます。 グループの所有者は、1人のユーザまたは1つのグループを設定します。
ブランチ、ディポ、ラベル、ワークスペースを同じ名前にすることはできません。
自動ラベル
自動ラベルは、ラベル仕様の[View:
]フィールドおよび[Revision:
]フィールドで指定されたリビジョンを参照します。 自動ラベルを作成するには、p4 label
スペックの[Revision:
]フィールドにリビジョン指定子を入力します。 ワークスペースを自動ラベルに同期させると、Revision:
フィールドの内容がView:
フィールドのすべてのファイルに適用されます。
例 自動ラベルをチェンジリスト番号のエイリアスとして使用します。
ブルーノはビルドプロセスを毎晩実行していて、チェンジリスト1234の製品のビルドに成功しました。 毎晩のビルドごとの固有のチェンジリストを覚えておかなくてもいいように、p4 label
nightly20111201
と入力して、ラベルのRevision:
フィールドを使用し、チェンジリスト1234のすべてのファイルにnightly20111201
ラベルがタグ付けされるようにしています。
Label: nightly20111201 Owner: bruno Description: Nightly build process. Options: unlocked noautoreload View: //depot/... Revision: @1234
この方法の利点は、非常に簡単にスクリプトを修正することができ、ラベルテーブルのスペースをほとんど必要としないことに加えて、どのチェンジリスト番号が毎晩のビルドプロセスに関連付けられているかを覚えておかずに毎晩のビルドを簡単に参照できることです。
例 1つのチェンジリストでサブミットされたファイルセットに限定して参照する
チェンジリスト1238で修正されたバグには、その修正に関連付けられたファイルのみを参照するパッチラベルが必要です。 ブルーノはp4 label patch20111201
と入力してラベルの[Revision:
]フィールドを使用し、チェンジリスト1238でサブミットされたファイルのみに自動的にpatch20111201
ラベルでタグ付けします。
Label: patch20111201 Owner: bruno Description: Patch to 2011/12/01 nightly build. Options: unlocked noautoreload View: //depot/... Revision: @1238,1238
この自動ラベルは、チェンジリスト1238でサブミットされたファイルのみを参照します。
例 複数のチェンジリストですべてのファイルの最初のリビジョンを参照する。
チェンジリスト指定子ではなく、リビジョン指定子を使用することもできます。 この例では、ブルーノはブランチ内のすべてのファイルの最初のリビジョン(#1)を参照しています。 ブランチの実装方法によっては、これらのファイルは長い時間をかけて複数のチェンジリストから作成された可能性があります。
Label: first2.2 Owner: bruno Description: The first revision in the 2.2 branch Options: unlocked noautoreload View: //JamCode/release/jam/2.2/src/... Revision: "#1"
Helixサーバフォームでは#
文字がコメントを表すため、ブルーノは#
を引用符で囲んで、リビジョン指定子として解析されるようにしました。
フォームフィールド
フィールド名 | タイプ | 説明 |
---|---|---|
|
読み取り専用 |
コマンドで指定されたラベル名です。 ファイル名およびエンティティに関する文字の制限に注意してください。 |
|
書き込み可能、任意入力 |
ラベルの所有者です。 デフォルトでは、ラベルを生成したユーザです。 ラベルの所有者のみが、どのファイルにそのラベルでタグ付けするかを変更することができます。 指定する所有者は、Helixサーバユーザである必要はありません。 ユーザがまだ存在していないため任意の名前を使用する場合や、ユーザを削除してから仕様を新しいユーザに割り当てるまでのプレースホルダーが必要となる場合があります。 |
|
読み取り専用 |
ラベル仕様が最後に更新された日付です。 |
|
読み取り専用 |
ラベル上の |
|
書き込み可能、任意入力 |
ラベルの目的を記述します。任意入力です。 |
|
書き込み可能 |
ラベルの動作と保存場所を制御するオプションです。
|
|
書き込み可能 |
自動ラベル用の任意指定のリビジョン仕様です。 リビジョン番号の指定に |
|
書き込み可能 |
ラベルでタグ付けすることができるディポファイルのリストです。 1つのファイルの集合を別のファイルの集合にマッピングするクライアントビューやブランチビューとは異なり、ラベルビューは単なるディポファイルのリストです。 詳細については、「ビュー」を参照してください。 |
|
書き込み可能、任意入力 |
設定されている場合、ラベルは指定されたサーバに限り使用可能です。 設定されていない場合、このラベルはすべてのサーバで使用可能です。 |
オプション
|
名前の付いたラベルが |
|
[ |
|
マルチサーバ環境では、 |
|
エディタを起動せずに、標準入力からラベル定義を読み込みます。 |
|
エディタを起動せずに、標準出力へラベル定義を書き出します。 |
|
ラベル |
|
詳細については、「グローバルオプション」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? | ファイル引数にリビジョン範囲を使えるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
- 自動ラベルを作成するには、
p4 label
フォームのRevision:
フィールドにリビジョン指定子を入力します。 ワークスペースを自動ラベルに同期させると、Revision:
フィールドの内容がView:
フィールドのすべてのファイルに適用されます。 -
マルチサーバ環境内でPerforceサービスを使用して、ラベルをローカルなラベルにすることも、グローバルなラベルにすることもできます。 ローカルラベルは単一のエッジサーバに限定されるため、その他のサーバに使用することはできません。 グローバルラベルは、コミットサーバ上で作成および更新されるため、すべてのサーバから見ることができます。 ただし、グローバルラベルはグローバルな(バインドされていない)クライアントワークスペースでのみ使用することができます。
ローカルラベル
グローバルラベル
rpl.labels.global
が設定されていない場合(値が0とみなされます)rpl.labels.global
値を1に設定した場合デフォルトの場合、ラベルはエッジサーバに対してローカルのラベルになります デフォルトの場合、 ラベルはグローバルなラベルになります -g
オプションを指定すると、コミットサーバ上のグローバルラベルにアクセスできるようになります-g
オプションを指定すると、ローカルラベルを更新できるようになりますrpl.labels.globalが設定されていない状態でエッジサーバ上にラベルが存在し、そのラベルをエッジサーバとコミットサーバの両方で使用できるようにするには、そのラベルをエッジサーバからアンロードしてからコミットサーバ上にリロードします
例
|
|
関連コマンド
ラベルをクライアントワークスペースと同期させる |
|
システムに認識されているすべてのラベルをリストする |
|
ラベルを作成して、そのラベルでファイルにタグ付けする |