p4 labels

概要

定義されたラベルのリストを表示します。

構文


p4 [g-opts] labels [-t] [-u user] [[-e|-E] filter] [-m max] [file[revrange]]
p4 [g-opts] labels [-t] [-u user] [[-e|-E] filter] [-m max] [-a | -s serverID]
p4 [g-opts] labels -U

解説

p4 labelsは、Perforceサービスが認識している全ラベルのリストを次のフォーマットで表示します。

Label labelname date description

ラベルへの最終更新時刻を表示するには、-tオプションを使用します。

Label labelname date time description

特定のファイルにタグ付けされた静的ラベルのリストを見るには、ファイルパターンを指定し、必要に応じてリビジョン範囲を指定します。(自動ラベルは特定のリビジョン範囲のラベルビューにあるすべてのファイルを参照するため、p4 labelsと共にファイルパターンを使用すると、自動ラベルは表示されません。)

ラベルの出力をmax個までに限定するには、-m maxオプションを使用します。

filterパターンに一致する名前を持つラベルに出力を限定するには、-eまたは-E filterオプションを使用します。-eオプションでは大文字と小文字が区別され、-Eではそれらが区別されません。

指定されたユーザが所有しているラベルに出力を限定するには、-u userオプションを使用します。

オプション

-a

このサーバにバインドされているものだけでなく、すべてのラベルをリストします。このオプションは、ファイル仕様と共に使用することはできません。

-e filter

filterに一致するラベルのみを一覧表示します(大文字と小文字を区別)。

-E filter

filterに一致するラベルのみを一覧表示します(大文字と小文字を区別しない)。

-m max

max個までのラベルのみを一覧表示します。

-s serverID

指定されたserverIDにバインドされたラベルのみを一覧表示します。このオプションは、ファイル仕様と共に使用することはできません。

-t

ラベルの最終更新日とともに時刻も表示します。

-u user

userが所有しているラベルのみを一覧表示します。

-U

アンロードディポにあるラベルをリストします。詳しくは、p4 unloadを参照してください。

g-opts

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

使用上の留意点

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

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

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

適用外

適用外

list

  • 特定のラベルにタグ付けされているファイルのリストを見るには、p4 files @labelnameを使用します。

  • 分散環境では、エッジサーバに接続しているユーザは、-aオプションまたは-s serverIDオプションで明示的に別のリクエストをしていない限り、そのエッジサーバにバインドされているラベルのみを受け取ります。

例

システムの全ラベルをリスト表示します。

p4 labels

file.cのいずれかのリビジョンを含む全ラベルをリスト表示します。

p4 labels file.c

file.cの#3から#5いずれかのリビジョンを含む全ラベルをリスト表示します。

p4 labels file.c#3,5

関連コマンド

ラベルを作成して、そのラベルでファイルにタグ付けする。

p4 tag

ラベル仕様の生成または編集を行う。

p4 label

1つのラベルに含まれるファイルの追加、削除、変更を行う。

p4 labelsync

1つのラベルに含まれるファイルのリストを参照する。

p4 files @labelname