p4 journals

サーバに対するチェックポイントとジャーナルの活動の履歴を表示します。

構文規則 

p4 [g-opts] journals [-F filter] [-T fields] [-m max]

説明

p4 journalsコマンドを実行すると、チェックポイントとジャーナルの操作に関する 履歴情報が保管されるdb.ckphistテーブルの情報が表示されます。 サーバは、このテーブルを使用して、次にあげるチェックポイントおよび ジャーナルのイベントを記録します。

  • サーバがチェックポイントを取得
  • サーバがジャーナルをローテーション
  • サーバがジャーナルをリプレイ
  • レプリカがチェックポイントをスケジュール

複数サーバインストール環境において、それぞれのサーバは各自固有の db.ckphistテーブルを保有します。すなわち、テーブルはレプリカの複製ではありません。 このテーブルは、メインサーバデータベースの一部ではなく、ジャーナルに記録されず、 またバックアップの必要もありません。チェックポイントに含まれることもありません。 不具合が発生した場合は、破棄されます。

p4 journalsからの出力の例を以下に示します。

mbp-jbujes:~ jbujes$ p4 -p qaplay:20141 journals
... start 1381278576
... startDate 2013/10/08 17:29:36
... end 1381278576
... endDate 2013/10/08 17:29:36
... pid 19960
... type checkpoint
... flags
... jnum 19
... jfile checkpoint.19
... jdate 1381278576
... jdateDate 2013/10/08 17:29:36
... jdigest E4EB1FF5B589D05E9F5A8EE1F8183A86
... jsize 27183115
... jtype text
... failed 0
... errmsg

... start 1381278576
... startDate 2013/10/08 17:29:36
... end 1381278576
... endDate 2013/10/08 17:29:36
... pid 19960
... type checkpoint
... flags
... jnum 18
... jfile journal.18
... jdate 1381278575
... jdateDate 2013/10/08 17:29:35
... jdigest 00000000000000000000000000000000
... jsize 15737
... jtype text
... failed 1
... errmsg

... start 1374629669
... startDate 2013/07/23 18:34:29
... end 1374629669
... endDate 2013/07/23 18:34:29
... pid 14700
... type replay
... flags -r . -j r
... jnum -1
... jfile basis.ckp
... jdate 1366076427
... jdateDate 2013/04/15 18:40:27
... jdigest 00000000000000000000000000000000
... jsize 27181640
... jtype text
... failed 1
... errmsg

このコマンドは、失敗したチェックポイントに対するエラーメッセージの フルテキストを表示します。

グローバル-Fオプションを使用して、p4 journalsからの出力を フォーマットします。以下に例を示します。

p4 -F "%jfile% %jnum%" journals -F type=checkpoint

各フィールドの意味について、以下のテーブルで説明します。 出力のエントリは、新しいイベントから古いイベントへリストされます。

start

実行されたコマンドのUnixタイムスタンプを開始します。 どのコマンドが実行されたか判断するには、タイプフィールドを確認します。

startDate

人間が読める形式の開始値です。

end

実行されたコマンドのUnixタイムスタンプを終了します。

endDate

人間が読める形式の終了値です。

pid

コマンドのプロセスIDであり、その実行によりこのレコードが作成されたもの。 この値は、別のログで関連するエントリを検索する場合に便利です。

type

コマンドであり、その実行によりこのレコードが作成されたもの。 タイプには次のものが含まれます。

  • journal: p4 -Jコマンドまたは p4 admin journalコマンドです。
  • checkpoint: p4 -jcコマンドまたはp4 admin checkpointコマンドです。
  • replay: p4d -jrコマンドです。
  • schedule: レプリカサーバでのチェックポイント取得です。 これにより2つのレコード、すなわちチェックポイントとスケジュールが作成されます。

flags

タイプフィールドによりコマンドへ黙示的に渡されたフラグ。

jnum

チェックポイント番号。値が-1の場合は、ジャーナル番号が不明です。

jfile

タイプフィールドにより黙示的にコマンドに入力された、ジャーナルまたは チェックポイントファイルの名前。

jdate

jfileにより指定されたフィールドが作成された時のUnixタイムスタンプ。

jdateDate

人間が読める形式のjdateの値。

jdigest

チェックポイントファイルのダイジェスト。

jsize

jfileにより指定されるファイルのサイズ。

jtype

jtypeにより指定されるファイルのタイプ。

オプション

-F filter

フィルタ表現を満足させるレコードのみを示すリスト。 フィルタ表現構築のインストラクションについては、 「ジョブビュー」を参照してください。

-m max

指定した数のレコードに出力を制限します。

-T fields

指定したフィールドに出力を制限します。 フィールドをカンマまたはスペースで区切ります。

g-opts

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

使用上の注意点

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

適用外

適用外

super

関連コマンド

チェックポイントを作成する。

p4 admin checkpoint

ジャーナルを作成する。

p4 admin journal