Helix Core P4コマンドリファレンス (2019.1)

p4 changes

サブミットされたチェンジリストと作業中のチェンジリストのリストを出力します。

p4 changelistsコマンドはp4 changesと同等に機能します。

構文

p4 [g-opts] changes [-i -t -l -L -f] [-c client] [ -e changelist#][-m max][-r][-s status] [-u user | --me] [[FileSpec][revSpec]]

説明

p4 changesにより、サブミットされたチェンジリストと作業中のチェンジリストのリストを表示することができます。 引数を指定せずにp4 changesを実行すると、すべての番号付きチェンジリストが表示されます。 (デフォルトのチェンジリストは表示されません。)

デフォルトでは、各行の形式は次のとおりです。

Change num on date by user@client [status] description

-tオプションを使用してそれぞれのチェンジリストの時刻を表示する場合、各行の形式は次のようになります。

Change num on datehh:mm:ss by user@client [status] description

statusの値は、そのチェンジリストがpendingまたはshelvedの場合にのみ表示されます。 descriptionは、最初の31字に制限されますが、-Lオプションを指定すると最初の250文字、-lオプションを指定すると全テキストが表示されます。

ファイルパターンを引数として指定すると、そのパターンに一致するファイルに影響を及ぼすsubmittedまたはpendingのチェンジリストのリストが表示されます。

ファイルパターンには、リビジョン指定子およびリビジョン範囲を含めることができます。

  • リビジョン範囲内のすべてのファイルのリストを取得するには、リビジョン範囲を含めます。 例: p4 jobs //...#20,52
  • リビジョン1から指定したリビジョンに含まれるすべての変更のリストを取得するには、単一のリビジョン指定子を含めます。 例: p4 jobs //...#20
  • 指定したクライアントワークスペースまたはユーザによって作成されたチェンジリストのみに出力を制限するには、-c clientまたは-u userオプションを使用します。
  • 指定したstatus値(pendingshelved、またはsubmitted)のチェンジリストのみに出力を制限するには、-s statusオプションを使用します。
  • 指定したチェンジリスト番号以上の変更のみに出力を制限するには、-e changelist#オプションを使用します。

分散環境において、エッジサーバで作業中または保留状態の変更は、その他のサーバではp4 changesコマンドにより表示されます。

管理者は、-fオプションを使用して制限付きのチェンジリストを表示することができます。

オプションとファイルパターンを組み合わせることにより、表示されるチェンジリストを制限することができます。

ヒント

-m maxオプションを使用して、maxオプションで指定された件数の変更のみを出力することもできます。

p4 changes -m 5と指定すると、最新の変更が5件表示されます。

表示順序を逆にして、古い変更から順に表示する場合は、-rオプションを指定します。

p4 changes -r -m 5と指定すると、最も古い変更が5件表示されます。

注意

グローバルオプションの「-u」(グローバルオプションを参照)の動作は、「p4 changes -u」コマンドで使用される「-u」オプションの動作とは異なります。

$ p4 -u bruno changes -u gale

上記の「p4 -u bruno」の部分では、現在のユーザを「bruno」に変更するためのグローバルオプションが使用され、「-u gale」の部分では、「gale」というユーザが行った変更のリストを表示するためのグローバルオプションが使用されています。

オプション

-c client

指定したクライアントワークスペースによって行われた変更のみを一覧表示します。

-f

制限付きの変更を表示します(admin権限が必要です)。

-i

指定したファイルに反映されたファイルに影響を及ぼしたチェンジリストを含めます。

-l

各チェンジリストの説明のテキストをすべて含めて、長い出力形式で一覧表示します。

-L

各チェンジリストの説明を250文字で切り捨て、長い出力形式で一覧表示します。

-m max

一番大きい番号からmax個までの変更のみを一覧表示します。

-r リストの順番を逆にして、最も新しいものが先頭ではなく、最も古いものを先頭にします。

-s status

チェンジリストに対するリストを、指定の状態(pendingsubmittedまたはshelved)に限定します。

-t

各変更の日付に加えて時刻も表示します。

-u user

指定したユーザによって行われた変更のみを一覧表示します。

--me

-u $P4USERと同義

g-opts

詳しくは、「グローバルオプション」を参照してください

使用上の留意点

ファイル引数にリビジョン指定子を使えるか? ファイル引数にリビジョン範囲を使えるか? 最低限必要なアクセスレベル

使用可

使用可

list

  • p4 changesが複数のファイル引数を伴って呼び出されると、各引数に影響するチェンジリストの集合が個別に評価されます。 最後の出力は結合もソートもされません。 その効果はファイル引数ごとに1回ずつ、p4 changesを複数回呼び出したときと同じになります。
  • ファイルが指定されていない場合、p4 changesは変更がpublicであるかrestrictedであるかに従って出力内容を制限します。 restrictedタイプのsubmittedまたはshelvedの変更は、その変更を所有しているか、変更の内の1つ以上のファイルにlist権限を持っていない限り、出力されません。 restrictedタイプのpending(ただし保留解除された)変更は、その変更の所有者にのみ表示されます。
  • p4 changes myfile#haveを実行すると、計算フェーズ中は、ロックされていないdb.haveテーブルへのアクセスが実行されます。

p4 changes -m 5 //depot/project/...

ディレクトリprojectのファイルを1つでも含む、サブミット済、作業中、または保留状態のチェンジリストのうち、最新のもの5つを表示します。

p4 changes -m 5 -c eds_elm

クライアントワークスペースeds_elmから、サブミット済、作業中、または保留状態のチェンジリストのうち、最新のもの5つを表示します。

p4 changes -m 5 -s submitted -u edk

ユーザedkがサブミットしたチェンジリストのうち、最新のもの5つを表示します。

p4 changes file.c@2010/05/01,2010/06/01

クライアントビューを介してディポへマッピングされた、ファイルfile.cを含むすべてのチェンジリストのうち、日付が2010年5月のものを表示します。

p4 changes -m 1 -s submitted

最新のサブミット済みチェンジリストのチェンジリスト番号を示す1行を出力します。

p4 changes @2011/04/01,@now

2011年4月1日から現在までにサブミットされたチェンジリストをすべて表示します。

p4 changes @2011/04/01

2011年4月1日よりも前にサブミットされたチェンジリストをすべて表示します。

p4 changes -r -m 1 //depot/project/branch/...

指定されたブランチに最初の変更を表示します。

関連コマンド

作業中チェンジリストをサブミットする

p4 submit

新しい作業中チェンジリストを生成する

p4 change

特定のチェンジリストに関する詳細なレポートを読み込む

p4 describe