p4 jobs
Helix Coreサーババージョン化サービスに既知のジョブをリスト表示します。
構文規則
p4 [g-opts] jobs [-e jobview] [-i -l -r] [-m max] [file[rev] ...]p4 jobs -R
説明
引数を指定せずにp4 jobsコマンドを実行すると、
Helixサーバに保存されているすべてのジョブが一覧表示されます。
このコマンドの出力は、オプションや引数でさまざまな基準を指定することにより、
制限することができます。
ファイルパターンを指定すれば、リスト表示されるジョブは特定のファイルに
影響を及ぼすチェンジリストにリンクされたもののみに制限されます。
-eオプションを使用すれば、リスト表示されたジョブをさらに特定の語を
含むもののみに制限することができます。
ジョブは、その名前をキーとして、英数字の昇順(あるいは、
-rオプションを使用すると、降順)に、1行に1つずつ表示されます。
各行の形式は次のとおりです。
>jobname on date by user *status* description
記述は、-l (long)オプションが使用されていない限り、
先頭から31文字までに制限されます。
date、user、status、またはdescriptionのフィールドのいずれかが、
Helixサーバスーパーユーザにより
p4
jobspecで削除されている場合、
そのフィールドの値は各ジョブの出力に表示されません。
ジョブのリストを、特定ファイルに関連するチェンジリストによって修正されたもののみに
制限するには、p4 jobs
filespecを使用します。ファイルまたはファイルパターンの指定には、
リビジョン指定子またはリビジョン範囲を含めることができます。
オプション
|
|
jobviewにより指定された基準に一致するジョブのみをリスト表示します。 「ジョブビュー」を参照してください。 |
|
|
指定ファイルに反映されたファイルに関連するチェンジリストによって修正された ジョブも含めます。 |
|
|
各ジョブの完全な記述を出力します。 |
|
|
英数字の昇順にソートし、先頭から |
|
|
ジョブを、その名前をキーとして、アルファベット順の降順で表示します。 |
|
|
ジョブテーブルを再構築し、各ジョブにあらためてインデックスを付けます。 |
|
|
「グローバルオプション」を参照してください。 |
使用上の注意点
| ファイル引数でリビジョン指定子を使用できるか？ | ファイル引数でリビジョン範囲を使用できるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
はい |
はい |
|
ジョブビュー
p4 jobs -e jobviewを使用すれば、リスト表示するジョブを特定の語を含む
ジョブのみに制限することができます。検索する語は特定のフィールドについて指定することも、
ジョブのテキストについて指定することもできます。
テキストに検索語を指定する場合ほど多くのオプションは使用できませんが、
日付のフィールドの値を指定してジョブを一致させるためにジョブビューを使用することもできます。
bulkタイプのジョブフィールドには検索用のインデックスは付けられません。
検索語の適合は大文字/小文字の区別なく調べられます。スペースで区切られたすべての英数文字列(句読記号が埋め込まれた単語を含む)は、 単語として索引付けされます。
ジョブビューを'' ... 'と記述すれば、word1からwordNまでの
完全セットが含まれているジョブを検索できます。 word1 word2
... wordN'
例:
-
p4 jobs -e "ReportedDate=2018/09/14 OwnedBy=mgaria FixVerifiedBy=jsmith"
-
p4 jobs -e "ReportedDate=2018/09/14 mgaria jsmith"
- p4 jobs -e "25* path QA closed job004* 2014* limit*"
すべての検索語を含むジョブを検索するには(ブール演算子AND)、検索語をアンパサンド(&)または空白文字で区切ります。
任意の検索語を含むジョブを検索するには(ブール演算子OR)、それぞれの検索語を 「|」の文字で区切ります。
| ブール演算子の優先度 | |
|---|---|
| 最高 | 括弧()内の文字 |
| & (AND) | |
| | (OR) | |
| 最低 | ANDに使用するスペース |
検索結果は、特定フィールド内の値をジョブビューシンタックス「fieldname=valuevalueは、英数字および句読記号を含む単一の字句で
なければなりません。
ワイルドカード「*」により、語の部分マッチングが可能です。ジョブビューに「fieldname=string*string」、「stringy」、「stringlike」などの
文字列を含むジョブを検索することができます。
日付フィールドは、
ジョブビュー日付を「yyyy/mm/ddyyyy/mm/dd:hh:mm:ss=)は
その日付に一致します。
通常の比較演算子(=、>、
<、>=、<=)も使用することができます。
さらに、NOT演算子(^)を使用して、一部の比較の意味を
打ち消すことができます。(詳細については、下記「制約」を参照してください)
正規表現マッチングは、正規表現マッチング演算子(~=)により
サポートされています。
検索で使用する演算子を文字として含む単語を検索するときは、
バックスラッシュ(\)でその文字をエスケープしてください。
バックスラッシュ文字を照合するには、もう1つのバックスラッシュで
エスケープします(\\)。
これらの演算子による動作は、比較対象となるジョブフィールドのタイプにより異なります。
| フィールドタイプ | ジョブビューにおける比較演算子の働き |
|---|---|
|
|
等価演算子( 関係演算子は、ASCIIコード順に比較を行います。 |
|
|
等価演算子( ここでは関係演算子の用途は限定的で、指定フィールド内のいずれかの語が、 与えられた値と一致する場合にジョブと一致します。 例えば、ジョブの |
|
|
上記のフィールドタイプ |
|
|
等価演算子( |
|
|
日付は年代順に比較されます。特定の時刻が与えられていない場合、演算子 |
フィールドタイプがよくわからない場合は、サイトで使用中のジョブ仕様を出力する
p4 jobspec -oを実行します。p4 jobspecのFields:フィールドには、
ジョブフィールドの名前とデータタイプが含まれています。フィールドのタイプについては、
p4 jobspecを参照してください。
その他の使用上の注意点
p4 userのフォームにはJobView:フィールドがあり、 ジョブビューを特定のユーザにリンクさせることができます。 ユーザがこのフィールドにジョブビューを入力すると、そのユーザが生成する チェンジリストにおいて、このフィールドのジョブビューと一致するジョブが 自動的にリスト表示されます。そのチェンジリストによって修正されたジョブは このフォームに残すことができますが、そうでないジョブは削除する必要があります。- p4 jobsこのコマンドは、出力を英数字順にジョブ名で並べ替えますが、 これはジョブが入力された時間順でもあります。 ただし、Helixサーバで使用される標準的なジョブ名と異なるジョブ名を 使用している場合には、この限りではありません。
-m max-rは、英数字順で最後からmaxの数のジョブを表示するのであって、 新しいものからmaxの数のジョブを表示するわけではありません。 しかし、デフォルトのHelixサーバジョブの名前付け規則(例えば、job001394のような名前が付く)を使用していれば、 英数字順と入力日付の古い順が同じになります。- テキストタイプのフィールドが値を含んでいるかどうかは、
ワイルドカード「
*」を使ってジョブビューを「field=*fieldがnull値でないジョブがすべて検索されます。 -e jobviewオプションを用いてジョブを検索する場合、 特にワイルドカード、論理演算子、括弧を使用する場合には、 オペレーティングシステムおよびコマンドシェルの構文解析、引用、 特殊文字のエスケープの動作に注意してください。
制限事項
- ジョブビューは、null値のフィールドを含むジョブの検索には利用できません。 言い換えれば、既存のジョブからあるフィールドが削除されたとすると、 該当フィールドはインデックスが付いていないことになり、その「削除済フィールド」の 値に一致するジョブビューは存在しません。
- ジョブビュー内では、ジョブビューNOT演算子(
^)はAND演算子の 後にしか使用できません。つまり、「gui ^name=joe」、「gui&^name=joe」というジョブビューは有効ですが、 「gui|^name=joe」、「^name=joe」というジョブビューは有効ではありません。 -
上記の制約を回避するには、ワイルドカード「
*」が有効です。例えば、文字列「
unwanted」を含まないすべてのジョブを検索するには、 ジョブビューを「job=* ^unwanted」と記述します。 ジョブビューの最初の部分ですべてのジョブが選択され、文字列「unwanted」を 含まないすべてのジョブとの論理積ANDがとられます。同様に、ジョブビュー「
field=*fieldがnullではない(つまり、jobフィールドは 空ではないと考えられる)あらゆる値と一致するため、 null値のフィールドを持つジョブは「job=* ^」で検索することができます。field=* - 現時点では、スペースで区切られたフィールドの条件検索は実行できません。
例えば、
p4 jobs -e "field=word1 word2"の代わりにp4 jobs -e "field=word1 field=word2"を使用しなければなりません。
例
|
|
|
|
|
|
|
|
いずれかのフィールドに単語 |
|
|
いずれかのフィールドに単語 |
|
|
いずれかのフィールドに単語 |
|
|
いずれかのフィールドに単語「 |
|
|
いずれかのフィールドで |
|
|
どのフィールドにも単語 |
|
|
いずれかのフィールドに単語 |
|
|
いずれかのフィールドに単語 |
関連コマンド
|
ジョブの生成または既存のジョブの編集を行う |
|
|
ジョブを特定のチェンジリストにリンクし、ジョブがそのチェンジリストによって 修正されることを指示する |
|
|
すべてのジョブとそれがリンクされているチェンジリストをリスト表示する |
|
|
特定のチェンジリストについて、それにリンクされているジョブも含め、 すべての情報を参照する |
|
|
サイトで使用されているジョブの形式を変更する(スーパーユーザ専用) |
|
|
サイトで使用されているジョブの形式に関する情報を読み出す(すべてのユーザ) |
|
|
デフォルトのジョブビューを設定することにより、そのジョブビューに一致するジョブが すべての新しいチェンジリストに含まれるようにする。 |
