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を使用して、そのラベルでファイルにタグ付けすることができます。
フォームフィールド
フィールド名 |
タイプ |
解説 |
---|---|---|
|
読み取り専用 |
コマンドで指定されたラベル名です。 |
|
書き込み可能、任意選択 |
ラベルの所有者です。デフォルトでは、ラベルを生成したユーザです。ラベルの所有者だけが、どのファイルにそのラベルでタグ付けするかを変更することができます。 指定する所有者は、Perforceユーザである必要はありません。ユーザがまだ存在していないため任意の名前を使用する場合や、ユーザを削除してから仕様を新しいユーザに割り当てるまでのプレースホルダーが必要となる場合があります。 |
|
読み取り専用 |
ラベル仕様が最後に更新された日付です。 |
|
読み取り専用 |
ラベル上のp4
labelsyncの実行によって、またはラベルのリビジョン指定子 |
|
書き込み可能、任意選択 |
ラベルの目的を記述します。任意入力です。 |
|
書き込み可能 |
ラベルの動作と保存場所を制御するオプションです。
|
|
書き込み可能 |
自動ラベル用の、任意指定のリビジョン仕様。
リビジョン番号の指定に |
|
書き込み可能 |
ラベルでタグ付けすることができるディポファイルのリストです。p4 labelsyncが実行されるまでは、実際にはどのファイルもタグ付けされません。 1つのファイルの集合を別のファイルの集合にマッピングするクライアントビューやブランチビューとは異なり、ラベルビューは単なるディポファイルのリストです。詳しくは、「“ビュー”」を参照してください。 |
|
書き込み可能、任意選択 |
設定されている場合、ラベルは指定されたサーバに限り使用可能です。設定されていない場合、このラベルはすべてのサーバで使用可能です。 |
オプション
|
名前の付いた |
|
フィールド[ |
|
分散環境では |
|
エディタを起動せずに、標準入力からラベル定義を読み込みます。 |
|
エディタを起動せずに、標準出力へラベル定義を書き出します。 |
|
ラベル |
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
-
自動ラベルを作成するには、p4 labelフォームの
Revision:
フィールドにリビジョン指定子を入力します。ワークスペースを自動ラベルに同期させると、Revision:
フィールドの内容がView:
フィールドのすべてのファイルに適用されます。 -
分散Perforceサービスで、ラベルはローカルにすることも、グローバルにすることもできます。ローカルラベルは単一のエッジサーバに限定されるため、その他のサーバに使用することはできません。グローバルラベルは、コミットサーバ上で作成および更新されるため、すべてのサーバから見ることができます。しかし、グローバルラベルはグローバルな(バインドされていない)クライアントワークスペースでのみ使用することができます。
ラベルはデフォルトでエッジサーバに対してローカルになります。コミットサーバのグローバルラベルには
-g
オプションを使用してアクセスします。管理者がrpl.labels.global
を1
に設定している場合、ラベルはデフォルトでグローバルになります。つまり、-g
オプションは反転してローカルラベルの更新を可能にします。
例
p4 files @labelname |
|