PERFORCE 2013.1 コマン ド ・ リ フ ァ レン ス

2013 年 4 月

This manual copyright 1999-2013 Perforce Software.

All rights reserved.

Perforce software and documentation is available from http://www.perforce.com. You may download and use

Perforce programs, but you may not sell or redistribute them. You may download, print, copy, edit, and redistribute the

documentation, but you may not sell it, or sell any documentation derived from it. You may not modify or attempt to

reverse engineer the programs.

This product is subject to U.S. export control laws and regulations including, but not limited to, the U.S. Export

Administration Regulations, the International Traffic in Arms Regulation requirements, and all applicable end-use, end-

user and destination restrictions. Licensee shall not permit, directly or indirectly, use of any Perforce technology in or by

any U.S. embargoed country or otherwise in violation of any U.S. export control laws and regulations.

Perforce programs and documents are available from ourWeb site as is. No warranty or support is provided. Warranties and

support, along with higher capacity servers, are sold by Perforce Software.

Perforce Software assumes no responsibility or liability for any errors or inaccuracies that may appear in this book.

By downloading and using our programs and documents you agree to these terms.

Perforce and Inter-File Branching are trademarks of Perforce Software. Perforce software includes software developed by

the University of California, Berkeley and its contributors. This product includes softwaredeveloped by the OpenSSL

Project for use intheOpenSSL Toolkit (http://www.openssl.org/).

All other brands or product names are trademarks or registered trademarks of their respective companies or organizations.

© copyright 1999-2013 Perforce Software.

All rights reserved.

PERFORCE のソ フ ト ウ ェ アおよび関連文書は http://www.perforce.com よ り 入手でき ます。 プロ グ ラ ムは、

ダウ ン ロード し てご利用になれますが、 販売または再配布する こ と は禁じ ます。 関連文書は、 ダウ ン ロード、 印

刷、 コ ピー、 編集、 再配布する こ と を認めますが、 販売する こ と は禁じ ます。 また、 いかなる ものであれ、 本書

を元にし て作成し た文書を販売する こ と も禁じ ます。 プロ グ ラ ムについては、 変更を加え る こ と、 また リ バース

エンジニア リ ングを試みる こ と も禁じ ます。

本製品は米国輸出管理規則 (EAR)、 国際武器取引規則 (ITAR) を含むがこれに限定されない、 すべての米国輸出管

理法令、 および 終用途、 終使用者、 納入先地域のすべての適用規制の対象と な り ます。 被許諾者は、 直接ま

たは間接的に、 米国の禁輸国における、 またはそれらの国によ る PERFORCE の技術の使用あ るいはそれ以外の米

国輸出管理法令に違反する使用を許可し てはな り ません。

当社 Web サイ ト よ り 入手し た PERFORCE プロ グ ラ ムおよび関連文書は無条件受け取 り と な り ます。 保証もサポー

ト もいた し ません。 保証、 サポー ト は、 よ り 高機能のサーバ と と もに、 Perforce Software よ り 有償で提供いた し

ます。

Perforce Software は、 本書中の誤 り または不正確な記述について、 いっ さい責任も負担も負いません。

当社のプロ グ ラ ムおよび関連文書をダウ ン ロード し て使用する と、 以上の条件に同意な さ った こ と にな り ます。

本製品には OpenSSL Toolkit (http://www.openssl.org/) で使用する ために OpenSSL プロ ジェ ク ト によ って開発され

た ソ フ ト ウ ェアが含まれています。

PERFORCE、 Inter-File Branching は、 Perforce Software の商標です。 PERFORCE のソ フ ト ウ ェアには、 カ リ フ ォルニ

ア大学バーク レ イ校およびその協力者によ って開発された ソ フ ト ウ ェアが含まれています。

その他のブラ ン ド または製品名は、 それぞれ当該各社または団体の商標または登録商標です。

目 　 次

本書について ..................................................... 7

p4 add............................................................................................... 9

p4 admin ......................................................................................... 12

p4 annotate...................................................................................... 15

p4 attribute...................................................................................... 17

p4 archive........................................................................................ 18

p4 branch ........................................................................................ 20

p4 branches ..................................................................................... 22

p4 change ........................................................................................ 23

p4 changelist .................................................................................... 27

p4 changelists................................................................................... 28

p4 changes....................................................................................... 29

p4 client .......................................................................................... 32

p4 clients......................................................................................... 39

p4 configure ..................................................................................... 41

p4 copy ........................................................................................... 50

p4 counter ....................................................................................... 52

p4 counters...................................................................................... 54

p4 cstat........................................................................................... 55

p4 dbschema .................................................................................... 56

p4 dbstat ......................................................................................... 57

p4 dbverify....................................................................................... 59

p4 delete ......................................................................................... 60

p4 depot.......................................................................................... 62

p4 depots ........................................................................................ 66

p4 describe ...................................................................................... 67

p4 diff ............................................................................................. 69

p4 diff2............................................................................................ 72

p4 dirs ............................................................................................ 75

p4 diskspace .................................................................................... 77

p4 edit ............................................................................................ 79

p4 export......................................................................................... 82

p4 filelog ......................................................................................... 84

p4 files ............................................................................................ 87

p4 fix .............................................................................................. 89

p4 fixes ........................................................................................... 91

p4 flush ........................................................................................... 93

p4 fstat ........................................................................................... 96

p4 grep ..........................................................................................103

p4 group.........................................................................................104

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 3

目次

p4 groups .......................................................................................107

p4 have ..........................................................................................109

p4 help...........................................................................................111

p4 info ...........................................................................................112

p4 integrate ....................................................................................113

p4 integrated...................................................................................117

p4 interchanges ...............................................................................119

p4 istat ..........................................................................................120

p4 job ............................................................................................121

p4 jobs ...........................................................................................123

p4 jobspec ......................................................................................128

p4 journaldbchecksums .....................................................................131

p4 key............................................................................................132

p4 keys ..........................................................................................133

p4 label ..........................................................................................134

p4 labels.........................................................................................136

p4 labelsync ....................................................................................138

p4 list ............................................................................................140

p4 license .......................................................................................141

p4 lock...........................................................................................142

p4 lockstat......................................................................................143

p4 logappend...................................................................................144

p4 logger ........................................................................................145

p4 login ..........................................................................................146

p4 logout ........................................................................................148

p4 logparse .....................................................................................149

p4 logrotate ....................................................................................151

p4 logschema...................................................................................152

p4 logstat .......................................................................................153

p4 logtail ........................................................................................154

p4 merge ........................................................................................155

p4 monitor ......................................................................................157

p4 move .........................................................................................159

p4 obliterate ...................................................................................161

p4 opened.......................................................................................164

p4 passwd.......................................................................................166

p4 ping...........................................................................................169

p4 populate.....................................................................................170

p4 print ..........................................................................................171

p4 protect ......................................................................................173

p4 protects .....................................................................................182

p4 property.....................................................................................183

p4 proxy.........................................................................................185

p4 pull ...........................................................................................186

p4 reconcile ....................................................................................189

p4 rename.......................................................................................191

p4 reload ........................................................................................192

p4 reopen .......................................................................................193

p4 replicate.....................................................................................195

p4 resolve.......................................................................................197

p4 resolved .....................................................................................203

p4 restore.......................................................................................204

p4 revert ........................................................................................205

p4 review........................................................................................207

4 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

目次

p4 reviews ......................................................................................209

p4 set ............................................................................................211

p4 server ........................................................................................213

p4 serverid .....................................................................................215

p4 servers.......................................................................................216

p4 shelve ........................................................................................217

p4 sizes..........................................................................................219

p4 status ........................................................................................221

p4 stream .......................................................................................223

p4 streams ......................................................................................229

p4 submit .......................................................................................230

p4 sync ..........................................................................................235

p4 tag ............................................................................................239

p4 tickets .......................................................................................241

p4 triggers ......................................................................................242

p4 trust ..........................................................................................252

p4 typemap .....................................................................................253

p4 unload........................................................................................256

p4 unlock........................................................................................258

p4 unshelve.....................................................................................259

p4 update .......................................................................................261

p4 user...........................................................................................262

p4 users .........................................................................................267

p4 verify .........................................................................................268

p4 where ........................................................................................270

p4 workspace ..................................................................................272

p4 workspaces .................................................................................273

環境変数......................................................... 274

P4AUDIT .......................................................................................275

P4AUTH ........................................................................................276

P4BROKEROPTIONS.......................................................................277

P4CHARSET...................................................................................278

P4CHANGE....................................................................................279

P4COMMANDCHARSET ..................................................................280

P4CLIENT......................................................................................281

P4CLIENTPATH .............................................................................282

P4CONFIG .....................................................................................283

P4DEBUG ......................................................................................284

P4DIFF ..........................................................................................285

P4DIFFUNICODE............................................................................286

P4EDITOR .....................................................................................287

P4HOST.........................................................................................288

P4IGNORE .....................................................................................289

P4JOURNAL...................................................................................290

P4LANGUAGE................................................................................291

P4LOG ..........................................................................................292

P4LOGINSSO .................................................................................293

P4MERGE ......................................................................................294

P4MERGEUNICODE........................................................................295

P4NAME ........................................................................................296

P4PAGER.......................................................................................297

P4PASSWD.....................................................................................298

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 5

目次

P4PCACHE ....................................................................................299

P4PFSIZE .......................................................................................300

P4POPTIONS..................................................................................301

P4PORT.........................................................................................302

P4ROOT ........................................................................................305

P4SSLDIR.......................................................................................306

P4TARGET.....................................................................................308

P4TICKETS ....................................................................................309

P4TRUST .......................................................................................310

P4USER .........................................................................................311

PWD..............................................................................................312

TMP, TEMP....................................................................................313

追加情報......................................................... 314

グ ローバル ・ オプシ ョ ン.................................................................315

フ ァ イル指定.................................................................................318

ビ ュー...........................................................................................322

フ ァ イルタ イプ..............................................................................325

索 　 引 ............................................................ 332

6 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

本書について

本書について

書名

本書は 『PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス』 です。

内容

本書には、 PERFORCE のすべてのコマン ド と環境変数が記載されています。 本書は、 UNIX 形式

の入力画面を使用し て学習し たいユーザや、 PERFORCE の基本をすでに理解し てお り 、 個々の

コマン ド に関する情報を迅速に探し出す必要のあ るユーザを対象と し ています。

以下の表では、 機能ご と によ る コマン ド ・ リ フ ァ レ ン スのイ ンデッ ク ス を示し ます。

機能 参照するページ

ヘルプ p4 help, p4 info, フ ァ イル指定 , ビ ュ -, グ ローバル ・ オプシ ョ ン , フ ァ イルタ イプ

ク ラ イ ア ン ト ・ ワ ー ク ス

ペース

p4 client, p4 clients, p4 flush, p4 have, p4 sync, p4 update, p4 where, p4 workspace, p4 workspaces

フ ァ イル p4 add, p4 attribute, p4 copy, p4 delete, p4 diff, p4 diff2, p4 dirs, p4 edit, p4 files, p4 fstat, p4 grep, p4 move, p4 lock, p4 print, p4 reconcile, p4 rename, p4 revert, p4 status, p4 sizes, p4 unlock

チェ ンジ リ ス ト p4 change, p4 changelist, p4 changes, p4 changelists, p4 describe, p4 filelog, p4 opened, p4 reopen, p4 review, p4 shelve, p4 submit, p4 unshelve

ジ ョ ブ p4 fix, p4 fixes, p4 job, p4 jobs, p4 jobspec

ブラ ンチ と マージ p4 branch, p4 branches, p4 copy, p4 cstat, p4 integrate, p4 integrated, p4 interchanges, p4 istat, p4 label, p4 labels, p4 labelsync, p4 list, p4 merge, p4 populate, p4 tag, p4 resolve, p4 resolved, p4 stream, p4 streams

管理 p4 admin, p4 archive, p4 configure, p4 counter, p4 counters, p4 dbschema, p4 dbstat, p4 depot, p4 depots, p4 diskspace, p4 key, p4 keys, p4 license, p4 lockstat, p4 logappend, p4 logger, p4 logparse, p4 logrotate, p4 logschema, p4 logstat, p4 logtail, p4 monitor, p4 obliterate, p4 ping, p4 property, p4 proxy, p4 pull, p4 reload, p4 replicate, p4 restore, p4 reviews, p4 server, p4 serverid, p4 servers, p4 triggers, p4 typemap, p4 unload, p4 verify

セキ ュ リ テ ィ p4 group, p4 groups, p4 login, p4 logout, p4 passwd, p4 protect, p4 protects, p4 tickets, p4 trust, p4 user, p4 users, P4CLIENTPATH, P4SSLDIR, P4TRUST

環境 p4 set, 環境変数 と レジス ト リ 変数 , P4AUDIT, P4AUTH, P4BROKEROPTIONS, P4CHANGE, P4CHARSET, P4COMMANDCHARSET, P4CLIENT, P4CONFIG, P4DEBUG, P4DIFF, P4DIFFUNICODE, P4EDITOR, P4HOST, P4IGNORE, P4JOURNAL, P4LANGUAGE, P4LOG, P4MERGE, P4MERGEUNICODE, P4NAME, P4PAGER, P4PASSWD, P4PCACHE, P4PFSIZE, P4POPTIONS, P4PORT, P4ROOT, P4TARGET, P4TICKETS, P4USER, PWD, TMP, TEMP

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 7

本書について

PERFORCE の基礎と なっている コ ンセプト を学びたい場合や、例やコ マンド の具体的な使用方法

の説明が多く 盛り 込ま れている 解説書をお望みの場合は、 当社の Web サイ ト (http://www. perforce.com.) から入手でき る 『P4 ユーザ ・ ガイ ド』 をお読み く だ さい。

本書に代わる もの

本書は PDF 形式および HTML 形式のフ ァ イルで も ご覧になれます。

ご利用にあたって

本書の PDF フ ァ イル版および HTML フ ァ イル版は、 広範囲に相互参照が行われています。 オ

ン ラ イ ンで PDF フ ァ イル版をご覧になっている と きは、コマン ド名を ク リ ッ クするだけで、そ

のコマン ド の解説ページに移る こ と ができ ます。

こ う い う 情報 も 含 め た 方 が よ い と 思 わ れ る こ と が あ り ま し た ら、 ご 意 見 ・ ご 希望 を

manual@perforce.com までお送 り く だ さい。

8 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 add

p4 add

概要

デ ィ ポに追加する フ ァ イルを ク ラ イ アン ト ・ ワーク スペースで 作業状態にし ます。

構文

p4 [g-opts] add [-c changelist] [-d -f -I -n] [-t type] file...

解説

p4 add は、 デ ィ ポに追加する フ ァ イルを ク ラ イ アン ト ・ ワーク スペースで作業状態にし ます。

指定されたフ ァ イルはチェ ンジ リ ス ト に リ ン ク されます。指定されたフ ァ イルはチェ ンジ リ ス

ト に リ ン ク されます。 フ ァ イルは、 チェ ンジ リ ス ト が p4 submit でコ ミ ッ ト される までは、実

際にはデ ィ ポに追加されません。 追加する フ ァ イルは、 デ ィ ポに存在し ないフ ァ イルか、 デ ィ

ポに存在し ていて も 新 リ ビジ ョ ンで削除済み と し てマーク さ れている フ ァ イルでなければ

な り ません。

p4 add でフ ァ イルを作業状態にするには、 そのフ ァ イルが ク ラ イ アン ト ・ ビ ューに存在する

必要があ り ますが、 p4 add の実行時点でワーク スペースに存在する必要はあ り ません。 ただ

し、 p4 submit を実行する と きには、 ワーク スペースに存在する必要があ り ます。 フ ァ イルが

ワーク スペースに存在し ない場合、 サブ ミ ッ ト は失敗し ます。 p4 add は、 ワーク スペース内

のフ ァ イルの作成や上書き を行いません。 フ ァ イルが存在し ない場合は、 ユーザが作成し なけ

ればな り ません。

デフ ォル ト では、 指定されたフ ァ イルは default チェ ンジ リ ス ト で作業状態に されます。 指定

されたチェ ンジ リ ス ト でフ ァ イルを作業状態にするには、-c オプシ ョ ンを使用し ます。(default

チェ ンジ リ ス ト から番号付きチェ ンジ リ ス ト にフ ァ イルを移動させるには、 p4 change コマン

ド を使用し ます。 )

デフ ォル ト では、 p4 add は適用される P4IGNORE フ ァ イルに記述されたフ ァ イルを無視し ま

す。 こ の動作をオーバーラ イ ドするには、-l オプシ ョ ンを使用し て P4IGNORE フ ァ イルの内容

が無視される よ う にし ます。

フ ァ イルを追加する と きには、 PERFORCE はまずタ イプマ ッ プ ・ テーブル （p4 typemap） を調

べ、追加し よ う と し ている フ ァ イルのフ ァ イルタ イプをシステム管理者が定義し ているかど う

かを確かめます。 合致する ものが見つかれば、 そのフ ァ イルタ イプがタ イプマ ッ プ ・ テーブル

の定義に従って設定されます。 合致する も のが見つから ない場合、 PERFORCE は構成可能変数

filesys.binaryscan に従って該当フ ァ イルの先頭のバイ ト （デフ ォル ト では 65536 バイ ト ）を

調べ、 それが text か binary かを判断し た上、 フ ァ イルをデ ィ ポに保存し ます。 デフ ォル ト

では、 テ キ ス ト ・ フ ァ イ ルの リ ビ ジ ョ ンは リ バースデル タ 形式で保存 さ れ、 構成可能変数

filetype.maxtextsize によ る制限値 （デフ ォル ト では 10MB） を超え る、新規に追加されたテ

キ ス ト ・フ ァ イルには text+C フ ァ イルタ イプが割 り 当て られて完全な形で保存されます。.zip

形式 (.jar フ ァ イルを含む ) で圧縮されたフ ァ イルも自動的に検出され、 ubinary タ イプが割

り 当て られます。 その他のバイナ リ ・ フ ァ イルの リ ビジ ョ ンは、 圧縮されてフ ァ イル全体が保

存されます。

-t filetype オプシ ョ ンは、 フ ァ イルタ イプを明示的に指定し て、 タ イプマ ッ プ ・ テーブル と

PERFORCE のデフ ォル ト ・ フ ァ イルタ イプ検出機構の両方をオーバーラ イ ド し ます。

@、 #、 *、 および % の文字が含まれたフ ァ イルを追加するには、 -f オプシ ョ ンを使用し ます。

こ のオプシ ョ ンを指定する と、 通常は PERFORCE でワ イル ド カード と し て使用される文字が強

制的に文字解釈されます。

編集または移動 / 追加目的でフ ァ イルを作業状態に し た後で、 他のユーザがその作業状態の

フ ァ イルを削除する と、 チェ ンジ リ ス ト をサブ ミ ッ ト し た と きに処理がエ ラーで失敗し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 9

p4 add

目的とする フ ァ イルを確実に作成するには、-d オプシ ョ ン (" ダウ ングレード ") を指定し ます。

詳細に述べる と、 以下の とお り です。

• あなたが編集目的でフ ァ イルを作業状態にし た後、別のユーザがそのフ ァ イルを削除または

移動するチェ ンジ リ ス ト をサブ ミ ッ ト し ます。 あなたが編集をサブ ミ ッ ト する と、PERFORCE

はエ ラーを返し、 フ ァ イルは編集目的の作業状態のま まにな り ます。 チェ ッ ク ア ウ ト し た

デ ィ ポ内の場所か ら （あなたが行ったすべての変更も含めて） フ ァ イルを リ ス ト アする に

は、 -d オプシ ョ ンを追加し てフ ァ イルを追加目的で作業状態にし てから、 そのフ ァ イルを

サブ ミ ッ ト し ます。

• あなたが移動 / 追加目的でフ ァ イルを作業状態にし た後、別のユーザが元のフ ァ イルを削除

するチェ ンジ リ ス ト をサブ ミ ッ ト し ます。 あなたが移動をサブ ミ ッ ト する と、 PERFORCE は

エラーを返し、 フ ァ イルは移動 / 追加目的の作業状態のま まにな り ます。 目的とする フ ァ イ

ルを作成するには、 追加フ ァ イルを指定し て p4 add -d コマン ド を実行し、 そのフ ァ イル

をサブ ミ ッ ト し ます。

オプシ ョ ン

使用上の留意点

• p4 add のフ ァ イル指定に含めたワ イル ド カード は、 PERFORCE サービ スではな く 、 ローカル

のオペレーテ ィ ング ・ システムによ り 展開されます。 例えば、 p4 add にはワ イル ド カード

「...」 は使用でき ません。

• PERFORCE では、 空のデ ィ ポにフ ァ イルを追加する操作と、 すでに他のフ ァ イルが含まれる

デ ィ ポにフ ァ イルを追加する操作に違いはあ り ません。新しい空のデ ィ ポにフ ァ イルを追加

する場合も、 p4 add を使用し て、 ク ラ イ アン ト ・ ワーク スペースのフ ァ イルを追加し ます。

• p4 add -f では特殊文字の ASCII 拡張は使用し ないでく ださ い。 ファ イ ル status@june.txt

を追加する 場合は、 次のよ う に指定し ます。

p4 add -f status@june.txt

手動で @ 記号を拡張し て、 フ ァ イル status%40june.txt を追加し よ う とする と、 % 記号が

文字解釈されて 16 進コード %25 に拡張され、 フ ァ イル名は status%2540june.txt と な り

ます。

-c changelist 作業状態にし て追加する フ ァ イルの リ ン ク先チェ ンジ リ ス ト を指定し ます。 こ の

オプシ ョ ンが付いていなければ、 フ ァ イルはデフ ォル ト のチェ ンジ リ ス ト に リ ン

ク されます。

-d フ ァ イルを作業状態にする ステータ ス を、 単純な追加にダウ ングレード し ます。

-f -f オプシ ョ ンを使用する と、ワ イル ド カー ド がフ ァ イル名に強制的に含められま

す。 詳細については、 「フ ァ イル指定」 をご覧 く ださい。

-I 無視するかど う かのチェ ッ ク を行いません。 P4IGNORE によ って指定されたすべ

ての設定を無視し ます。

-n フ ァ イルや メ タデータ を実際に変更せずに、 追加目的で作業状態にする フ ァ イル

をプレ ビ ューし ます。

-t filetype タ イプマ ッ プ・テーブルの設定をオーバーラ イ ド し て、指定し た filetype でフ ァ

イルを追加し ます。

PERFORCE のフ ァ イルタ イプについては、「フ ァ イルタ イプ」 のセ ク シ ョ ンにあ る リ

ス ト をご覧 く ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 open

10 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 add

使用例

関連コ マン ド

p4 add -t binary file.pdf 新しいフ ァ イルに特定のフ ァ イルタ イ プを割 り 当て、 タ イプマ ッ

プ ・ テーブルの設定をオーバーラ イ ド し ます。

p4 add -c 13 * ユーザのカ レ ン ト ・ デ ィ レ ク ト リ のすべてのフ ァ イルをデ ィ ポに

追加する ために作業状態にし ます。 これら のフ ァ イルはチェ ンジ

リ ス ト 13 に リ ン ク されます。

p4 add README ~/src/*.c ユーザのデ ィ レ ク ト リ ~/srcにあ るすべての*.cフ ァ イルをデ ィ

ポに追加する ために作業状態にし ます。 ま た、 ユーザの現在の作

業デ ィ レ ク ト リ にあ る READMEフ ァ イルもデ ィ ポに追加する ため、

作業状態にし ます。 これら のフ ァ イルはデフ ォル ト のチェ ンジ リ

ス ト に リ ン ク されます。

p4 add -f *.c *.c と い う 名前のフ ァ イルを追加のための作業状態にし ます。

このフ ァ イルをビ ューまたは他の PERFOCE コマン ド で参照する た

めに、 その後はアス タ リ ス ク の代わ り に 16 進拡張 %2A を使用す

る必要があ り ます。 詳細については、 320 ページの 「フ ァ イル名お

よびエンテ ィ テ ィ に関する文字の制限」 をご覧 く ださい。

編集する フ ァ イルを作業状態にする。 p4 edit

削除する フ ァ イルを作業状態にする。 p4 delete

フ ァ イルを移動 （ リ ネーム） する。 p4 move

すべての作業状態のフ ァ イルをデ ィ ポにコ ピーする。 p4 submit

デ ィ ポから ク ラ イ アン ト ・ ワーク スペースへフ ァ イルを読み込む。 p4 sync

新しいチェ ンジ リ ス ト を作成または編集する。 p4 change

テキス ト / バイナ リ のフ ァ イル検出のデフ ォル ト の動作を変更する。 p4 configure

すべての作業状態のフ ァ イルを リ ス ト する。 p4 opened

フ ァ イルを非作業状態に戻す。 p4 revert

作業状態のフ ァ イルを別の作業中チェ ンジ リ ス ト に移動する。 p4 reopen

作業状態のフ ァ イルのフ ァ イルタ イプを変更する。 p4 reopen -t filetype

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 11

p4 admin

p4 admin

概要

サーバに対する管理操作を 実行し ます。

構文

p4 [g-opts] admin checkpoint [ -z | -Z ] [ prefix ]p4 [g-opts] admin journal [ -z ] [ prefix ]p4 [g-opts] admin stopp4 [g-opts] admin restartp4 [g-opts] admin updatespecdepot [ -a | -s type ]p4 [g-opts] admin resetpassword -a | -u user

解説

PERFORCE スーパー ・ ユーザは、 現在作業中のマシンが共有 PERFORCE サービ スが稼動し ている

マシン と は異な る場合で も、 p4 admin コマン ド を使って管理タ ス ク を実行する こ と ができ ま

す。

PERFORCE サービ ス を停止するには、 p4 admin stop を使用し ます。 こ のコマン ド は、 サーバ

の再起動時、 データベースが一貫し た状態にあ る よ う にする ためにデータベース を ロ ッ ク し、

その上で PERFORCE のバッ ク グ ラ ウ ン ド ・ プロセス を停止し ます。

サービ ス を再起動するには、 p4 admin restart を使用し ます。 データベースがロ ッ ク された

後、 サービ スが再起動し た後、 再起動を必要とする p4 configure の設定が適用されます。

チェ ッ ク ポ イ ン ト を作成するには、 p4 admin checkpoint [prefix] を使用し ます。 サーバ ・

マシンにロ グ イ ン し、 p4d -jc [prefix] でチェ ッ ク ポ イ ン ト を作成するの と 同じ こ と です。

チェ ッ ク ポ イ ン ト が作成され、 ジ ャーナルが連番を付けたフ ァ イルにコ ピーされます。prefix

を指定すれば、 これらのフ ァ イルはそれぞれ prefix.ckp.n 、 prefix.jnl.n-1 と い う 名前で

保存されます。 こ こ で、n は連番です。 チェ ッ ク ポ イ ン ト の MD5 チェ ッ クサムが別のフ ァ イル

checkpoint.n.md5 に書き込まれ、 lastCheckpointAction カ ウ ン タが正常終了を反映し て更

新されます。

prefix の一部に任意のデ ィ レ ク ト リ を指定する こ と によ り 、 そのデ ィ レ ク ト リ にチェ ッ ク ポ

イ ン ト およびジ ャーナルを格納する こ と ができ ます。 （循環ジ ャーナルは現在のジ ャーナルの

格納デ ィ レ ク ト リ に関わらず、 P4ROOT デ ィ レ ク ト リ に格納されます。） "prefix" の指定がな

ければ、 デフ ォル ト のフ ァ イル名 checkpoint.n と journal.n-1 が使用されます。

p4 admin journal コマン ド は、p4d -jj と実行するの と同等です。詳し く は、『システム管理

者ガ イ ド』 を ご覧 く だ さ い。 こ れ ら のフ ァ イルは、 PERFORCE サービ ス起動時の指定に従い、

サーバ ・ ルー ト に作成されます。

p4 admin updatespecdepot コマン ド を実行する と、 PERFORCE サービ スが保管フ ォーム（具体

的には、 client、 depot、 branch、 label、 typemap、 group、 user、 および job の各フ ォー

ム） を スペッ ク ・ デ ィ ポにアーカ イブし ます。 -a オプシ ョ ンを使用する と、 すべての仕様タ イ

プがアーカ イ ブ されます。 -s オプシ ョ ン を使用する と、 特定の type を持つフ ォームのみが

アーカ イブ されます。 まだアーカ イブ されていないフ ォームのみが作成されます。

p4 admin resetpassword コマン ド は、既存のパス ワード を持つ指定されたユーザが別のコマ

ン ド を実行する前にパス ワード を変更する こ と を強制し ます。パス ワード を持つすべてのユー

ザ （コマン ド を実行し たスーパーユーザを含む） にパス ワード の リ セ ッ ト を強制するには、 p4

admin resetpassword -a を使用し ます。単一のユーザにパス ワー ド の リ セ ッ ト を強制するに

は、 p4 admin resetpassword -u user を使用し ます。

12 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 admin

オプシ ョ ン

使用上の留意点

• p4 admin updatespecdepotコマン ド およびp4 admin resetpasswordコマン ド の実行には

super 権限が必要です。 その他のコマン ド には、 ユーザがオペレータであ るか （p4 user 参

照）、 super 権限を持っている必要があ り ます。

• パス ワー ド を持つ新規作成 さ れたすべてのユーザが 初に コ マ ン ド を実行す る前にパ ス

ワード を リ セ ッ ト する こ と を必須にするには、 構成可能変数 dm.user.resetpassword を以

下の とお り 設定し ます。

p4 configure set dm.user.resetpassword=1

p4 admin resetpassword -a の実行によ ってパス ワード が リ セ ッ ト されるのは、 その時点

で存在する （かつ、 パス ワード が設定済みの） ユーザのみです。

• p4 admin stopを実行する と PERFORCEサーバが停止するので、接続が予期せず切断された と

い う エラー ・ メ ッ セージが表示される場合があ り ますが、 この メ ッ セージは無視し てかまい

ません。

• p4 admin updatespecdepot を実行する前に、 スペッ ク ・ デ ィ ポが存在し ている必要があ

り ます。

• p4 dbstat、 p4 lockstat、 p4 logstat は独立し た コマン ド と な り 、p4 admin の古い構文は

下位互換性を保つためにエイ リ アス と し て残されています。

• PERFORCE の管理について、 詳し く は 『システム管理者ガイ ド 』 をご覧 く だ さい。

使用例

-z p4 admin checkpoint および p4 admin journal に付ける と、チェ ッ ク ポイ

ン ト と ジャーナル ・ フ ァ イルが拡張子 .gz を付けて圧縮 （gzip） フ ォーマ ッ ト で

保存されます。

-Z p4 admin checkpoint および p4 admin journal に付ける と、チェ ッ ク ポイ

ン ト は拡張子 .gz を付けて圧縮 （gzip） フ ォーマ ッ ト で保存されますが、 ジャー

ナル ・ フ ァ イルはレプ リ カ ・ サーバでの使用に備え、 圧縮されません。

-a p4 admin updatespecdepot に付ける と、 スペッ ク ・ デ ィ ポを現在のすべての

フ ォームで更新し ます。

-s type p4 admin updatespecdepot に付ける と、特定タ イプのフ ォームを持つスペッ

ク ・デ ィ ポを更新し ます。タ イプは client、depot、branch、label、typemap、group、user、job の う ち 1 つです。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 admin stop 共有 PERFORCE サービ ス を停止し ます。

p4 admin checkpoint checkpoint.n と い う 名前のチェ ッ ク ポ イ ン ト を作成し、 かつ

journal と い う 名前の新し いジ ャーナルを開始し ます。 以前の

ジャーナルの内容は journal.n-1 （n は連番） にコ ピーされます。

p4 admin checkpoint name name.ckp.n と い う 名前のチ ェ ッ ク ポ イ ン ト を 作成 し、 かつ

journal と い う 名前の新し いジ ャーナルを開始し ます。 以前の

ジャーナルの内容はname.jnl.n-1（nは連番）にコ ピーされます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 13

p4 admin

関連コ マン ド

後のチェ ッ ク ポイ ン ト のステータ ス を表示する。 p4 counter lastCheckpointAction

14 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 annotate

p4 annotate

概要

フ ァ イルの行を、 リ ビジ ョ ン番号 と と もに表示し ます。

構文

p4 [g-opts] annotate [ -a -c -i -I -q -t -dflag ] file[revRange] ...

解説

p4 annotate は、 フ ァ イルの リ ビジ ョ ン （または リ ビジ ョ ン範囲） に対し て、 各行が生成され

た リ ビジ ョ ン番号を表示し ます。 表示された リ ビジ ョ ン番号を p4 filelog で調べれば、 どの

チェ ンジで誰が、 いつ、 なぜ変更し たのかがわか り ます。

フ ァ イルのその行が生成された と きのチェ ンジ リ ス ト 番号を表示するには、 -c オプシ ョ ン を

指定し ます。

パラ メ タに リ ビジ ョ ン番号を指定し た場合は、 その リ ビジ ョ ン番号までの行が表示されます。

リ ビジ ョ ン範囲を指定し た場合は、 その範囲に該当する行が表示されます。

デフ ォル ト では、 出力される フ ァ イルの 初の行はヘッ ダ行 と な り ます。

filename#rev - action change num (type)

こ こ で、filename#rev はフ ァ イル名 と リ ビジ ョ ン指定子です。action はフ ァ イルが作業状態

に された と きの操作で add、 edit、 delete、 branch または integrate です。 num はサブ ミ ッ

ト されたチェ ンジ番号であ り 、 type はその リ ビジ ョ ンのフ ァ イルタ イプです。

ヘッ ダ行を抑制するには、 -q (quiet) オプシ ョ ンを指定し ます。

すべての行 （削除された行および （または） すでに 新 リ ビジ ョ ンにない行） を表示するには、

-a (all) オプシ ョ ンを指定し ます。

オプシ ョ ン

-a すべての行を表示し ます。 削除された行や、 新 リ ビジ ョ ンではも はや存在し な

い行を含みます。

それぞれの行では、 開始および終了 リ ビジ ョ ンを含みます。

-c 各行を、 リ ビジ ョ ン番号ではな く 、 チェ ンジ リ ス ト 番号 と と もに表示し ます。

-aオプシ ョ ン と -cオプシ ョ ンを と もに指定する と、それぞれの行に開始および終

了チェ ンジ リ ス ト 番号が含まれます。

-dflags 標準 UNIX の diff オプシ ョ ン ・ セ ッ ト の 1 つを使って比較ルーチンを実行し ます。

下の使用例にあ る フ ラ グの リ ス ト をご覧 く ださい。

-I フ ァ イルへの反映を追跡し ます。 行がマージによ ってフ ァ イルに挿入された場合、

マージの反映元が行を挿入し たチェ ンジ リ ス ト と し て示されます。 その反映元自

体が反映操作の結果であ る場合、 その反映元が代わ り に使用されます。 こ のよ う

に反映元が順次追跡されます。

-I オプシ ョ ンは -c オプシ ョ ンを暗黙的に指定し ます。 -I オプシ ョ ン と -i オ プ

シ ョ ンを組み合わせる こ と はでき ません。

-i ブ ラ ンチを またがってフ ァ イル履歴を追跡し ます。 フ ァ イルがブ ラ ンチ機能によ

り 作成された場合、 PERFORCE はブラ ンチ ・ ポイ ン ト に至る までの リ ビジ ョ ンを含

めます。

-i オプシ ョ ンは -c オプシ ョ ンを暗黙的に指定し ます。 -i オプシ ョ ン と -I オプ

シ ョ ンを組み合わせる こ と はでき ません。

-q 抑制モード です。 それぞれのフ ァ イルに対し て、 ヘッ ダ行の表示を抑制し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 15

p4 annotate

使用上の留意点

• p4 annotate の出力は、 ス ク リ プ ト 作成などの自動化処理のフ ォームに適し ています。

• デフ ォル ト では、p4 annotate は長さ が 10MB を超え る テキス ト フ ァ イルへの変更を無視し

ます。 PERFORCE スーパーユーザは、 構成可能変数 dm.annotate.maxsize を設定する こ と に

よ り 、 こ の制限を書き換え る こ と ができ ます。

• p4 annotate でサポー ト されている差分フ ラ グを以下に示し ます。

使用例

-t p4 annotate が非テキス ト （バイナ リ ） フ ァ イルを表示する こ と を強制し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 read

フ ラグ 名前

-db 空白についての変更を無視

-dl 行末を無視

-dw すべての空白を無視

p4 annotate file.c file.c のすべての行を表示し、先頭にはその行が記述された リ ビ

ジ ョ ン番号が示されます。

p4 annotate -c file.c file.c のすべての行を表示し、先頭にはその行が記述されたチェ

ンジ リ ス ト 番号が示されます。

p4 annotate -a file.c file.c のすべての行 （削除された行も含む） を表示し、 各行は リ

ビジ ョ ン範囲で始ま り ます。

リ ビジ ョ ン範囲は開始 と終了の リ ビジ ョ ン番号を示し ます。

P4 annotate -a -c file.c file.c のすべての行 （削除された行も含む） を表示し、 各行は

チェ ンジ リ ス ト の範囲で始ま り ます。

フ ァ イル内に存在する各行の開始および終了チェ ンジ リ ス ト 番号

を含みます。

16 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 attribute

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 17

p4 attribute

概要

リ ビジ ョ ン単位の属性を リ ビジ ョ ンに設定し ます。

構文

p4 [g-opts] attribute [ -e -f -p ] -n name [ -v value ] files...p4 [g-opts] attribute [ -e -f -p ] -i -n name file

解説

p4 attribute コマン ド は、 リ ビジ ョ ン単位の属性を フ ァ イル ・ リ ビジ ョ ンに設定し ます。

属性を表示するには、 p4 fstat -Oa を使用し ます。

オプシ ョ ン

使用上の留意点

• 複数の -n name オプシ ョ ン と、それに対応する同数の -v value オプシ ョ ン（設定する場合）

または -v を省略し たオプシ ョ ン （ク リ アする場合） を指定する こ と によ り 、 複数の属性を

設定またはク リ アする こ と ができ ます。

-e 値が 16 進数で指定されている こ と を示し ます。

-f サブ ミ ッ ト 済フ ァ イルに属性を設定し ます。 伝播される特徴がサブ ミ ッ ト 済フ ァ

イルに設定さ れる場合、 リ ビジ ョ ン指定子は使用でき ません。 また、 そのフ ァ イ

ルを ワーク スペース内で作業状態にし てお く こ と はでき ません。

-p 伝播さ れる属性を作成し ます。 これは、 フ ァ イルが p4 add、 p4 edit、 ま たは

p4 deleteによ って作業状態にされる たびにそれ以降の リ ビジ ョ ンに値が伝播さ

れる属性です。

-i 属性値を標準入力から読み取 り ます。 このオプシ ョ ンの使用時は、フ ァ イル引数を

1 つしか指定でき ません。

-n name 設定する属性の名前。

-v value 設定する属性の値。 属性を ク リ アするには、 -v オプシ ョ ンを省略し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 write、 -f を使 う には admin

p4 archive

p4 archive

概要

使われな く なった リ ビジ ョ ンをアーカ イブ ・ デ ィ ポにアーカ イブし ます。

構文

p4 [g-opts] archive [ -n -h -p -q -t ] -D depot file[revRange]...

解説

指定された リ ビジ ョ ンを archive タ イプの depot に格納し ます。

フ ァ イルがアーカ イブ ・ デ ィ ポに移される と、 フ ァ イルに対する 後の操作が archive に変

わ り ます。 フ ァ イルの内容にア ク セスする コマン ド （ p4 sync、 p4 diff など） では archive

の リ ビ ジ ョ ンは無視 さ れますが、 フ ァ イ ルの内容にア ク セ スする 必要がない コ マ ン ド （p4

filelog など） は引き続き アーカ イ ブ された リ ビジ ョ ンに関する情報を メ タデータに送 り ま

す。

p4 archive -p は慎重に使用し て く だ さい。 これは PERFORCE で実際にフ ァ イル ・ データ を消

去する 2 つのコマン ド の う ちの 1 つです ( フ ァ イル・データ を消去する も う 1 つのコマン ド は

p4 obliterate です )。

オプシ ョ ン

使用上の留意点

• デフ ォル ト では、フル (+F) または圧縮し て (+C) 格納されたフ ァ イルに限 り 、アーカ イブされ

ます。 フ ァ イルは （ リ モー ト ・ デ ィ ポや別のアーカ イブ ・ デ ィ ポではな く ） ローカル ・ デ ィ

ポに存在する必要があ り 、 別の リ ビジ ョ ンに （または別の リ ビジ ョ ンから） コ ピーやブラ ン

チが行われていないものでなければな り ません。

• デルタ形式で格納されたフ ァ イルをアーカ イブするには、-t オプシ ョ ンを使用し ます。大量

の RCS デルタ を操作する際には、 計算コ ス ト が生じ る可能性があ り ます。

• アーカ イブ ・ デ ィ ポに関連付け られたフ ァ イルシステムをマウ ン ト する前に、 p4 archive

-nをテス ト 目的で使用する こ と ができ ます。このコマン ド を-nオプシ ョ ンを付けずに実行す

る前に、 アーカ イブ ・ デ ィ ポ用の記憶領域をマウ ン ト し なければな り ません。

-n リ ビジ ョ ンをアーカ イブし ません。 どの リ ビジ ョ ンがアーカ イブされるかを報告し ま

す。

-h 新 リ ビジ ョ ンをアーカ イブし ません。

-p アーカ イブ ・ デ ィ ポ内の指定されたフ ァ イルのアーカ イブを消去し ます。 ( 影響する

リ ビジ ョ ンに対する操作は、 完了時に purge に設定されます。 p4 restore を用い

てフ ァ イルの内容にア ク セスでき な く な り ます。 )

-q ク ワ イエ ッ ト ・ モード。 無視された リ ビジ ョ ンに関する メ ッ セージは抑止されます。

-t テキス ト ・ フ ァ イル （または、 binary+D タ イプのフ ァ イルなど、 デルタ形式で格納

されたその他の リ ビジ ョ ン） をアーカ イブし ます。

-D depot フ ァ イルのアーカ イブ先と なる アーカ イブ ・ デ ィ ポを指定し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 admin

18 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 archive

• フ ァ イル引数 と し て単一の リ ビジ ョ ンが指定される と、 p4 archive はアーカ イブ対象 と し

て リ ビジ ョ ン #1 から指定 リ ビジ ョ ン までを想定し ます。単一の リ ビジ ョ ン、rev のみをアー

カ イブするには、 p4 archive file#rev,rev の形式を使用し ます。

• あ る リ ビジ ョ ンがアーカ イ ブ ・ デ ィ ポに格納され、 格納された リ ビジ ョ ンがバージ ョ ン化

サービ スにア ク セス可能であ る場合、エン ド ユーザは p4 print -A -o filename を使用し

て、 どのアーカ イブ済 リ ビジ ョ ンが必要であ るかを診断する こ と ができ、 さ らに （任意で）

PERFORCE 管理者に p4 restore によ る フ ァ イルの リ ス ト アを依頼する こ と ができ ます。

使用例

関連コ マン ド

p4 archive file#3 fileのリビジョン 1、2、3をアーカイブします。

p4 archive file#3,3 fileのリビジョン 3をアーカイブします。

p4 print -A -o file リ ス ト アを実行せずに、 アーカ イブ済フ ァ イルの内容を表

示し ます。 管理者権限は必要あ り ません。

デ ィ ポを作成する。 p4 depot

フ ァ イルをアーカ イブ ・ デ ィ ポから リ ス ト アする。 p4 restore

フ ァ イルをアーカ イブせずに完全消去する。 p4 obliterate

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 19

p4 branch

p4 branch

概要

ブラ ンチ ・ マ ッ ピング と そのビ ューの生成または編集を行います。

構文

p4 [g-opts] branch [ -f ] branchspecp4 [g-opts] branch [ -S stream ] [ -P parent ] -o branchspecp4 [g-opts] branch -d [ -f ] branchspecp4 [g-opts] branch -i [ -f ]

解説

p4 branch によ り 、 p4 integrate で反映操作する 2 つのフ ァ イル ・ セ ッ ト 間のマ ッ ピングを

作成する こ と ができ ます。 ブラ ンチ ・ ビ ューで、 反映元のフ ァ イル （fromFiles） と反映先の

フ ァ イル （toFiles） の間の関係を定義し ます。 デ ィ ポ ・ シン タ ッ ク スでビ ューの両側を指定

し ます。

ブラ ンチ・マ ッ ピングを生成し て名前を付けた後、 p4 integrate -b branchname と入力し て

フ ァ イルの反映操作を行います。 ブ ラ ンチ ・ マ ッ ピ ングは自動的にすべての toFiles をそれ

に対応する fromFiles にマ ッ ピング し ます。

p4 branch フ ォームを保存し て も、デ ィ ポやク ラ イ アン ト ・ ワーク スペースのフ ァ イルに直接

的な影響はあ り ません。 ワーク スペースにブラ ンチされたフ ァ イルを作成し、 チェ ンジ リ ス ト

内でフ ァ イルを作業状態にするには、 p4 integrate -b branchspecname を実行する必要が

あ り ます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Branch: 読み取 り 専用 コマン ド ラ イ ンで与え られたブラ ンチ名。

Owner: 入力必須 ブ ラ ンチ ・ マ ッ ピ ングの所有者。 デフ ォル ト ではブ ラ ンチを生成

し た ユーザに設定 さ れ ま す。 こ の フ ィ ール ド は、 ［Option: ］

フ ィ ール ド が locked になっていない限 り 重要ではあ り ません。

Access: 読み取 り 専用 ブラ ンチ ・ マ ッ ピングに 後にア ク セスがあった日付。

Update: 読み取 り 専用 ブラ ンチ ・ マ ッ ピングが 後に変更された日付。

Options: 入力必須 unlocked （デフ ォル ト ） または locked に設定し ます。

locked の場合には、［Owner:］ だけがブラ ンチ ・ マ ッ ピングを修

正する こ と ができ、そのマ ッ ピングはこのフ ィ ール ド がunlockedに設定される まで削除する こ と はでき ません。

Description: 任意入力 ブラ ンチの目的を簡潔に説明する コ メ ン ト 。

View: 入力必須 デ ィ ポにあ る 1 つのフ ァ イル ・ セ ッ ト （反映元フ ァ イル） からデ ィ

ポにあ る別のフ ァ イル ・ セ ッ ト （反映先フ ァ イル） へのマ ッ ピ ン

グを記述し ます。 ビ ューは、 デ ィ ポの 1 つの場所から別の場所に

マ ッ ピ ング し ます。 ク ラ イ アン ト ・ ワーク スペース を参照する こ

と はでき ません。

例えば、 ブラ ンチ ・ ビ ュー

//depot/main/... //depot/r2.1/...

は //depot/main のすべてのフ ァ イルを //depot/r2.1 にマ ッ

ピング し ます。

20 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 branch

オプシ ョ ン

使用上の留意点

• ブラ ンチ ・ ビ ューで、 2 つの関連する コード ラ イ ンの関係を定義し ます。 例えば、 あ るプロ

ジェ ク ト の開発フ ァ イルが //depot/project/dev/... に保存されていて、 そのプロ ジェ ク

ト の リ リ ース 2.0 用の関連コード ラ イ ンを //depot/project/r2.0/... に生成し たい とす

れば、 ブラ ンチ ・ ビ ューを次のよ う に指定し ます。

//depot/project/dev/... //depot/project/r2.0/...

ブラ ンチ ・ ビ ューには、 複数のマ ッ ピングを記述する こ と ができ ます。 ビ ューの指定につい

て さ らに詳し く は、 「ビ ュー」 のセ ク シ ョ ンをご覧 く だ さい。

• パ ス ま たは フ ァ イ ル名に空白が含 ま れ る 場合は、 パ ス を引用符で次の よ う に囲み ます。

//depot/project/dev/... "//depot/project/release 2.0/..."

• ブラ ンチ ・ ビ ューは、 p4 diff2 -b branchname fromFiles と い う 構文によ り 、 p4 diff2

で も利用する こ と ができ ます。これは、ブラ ンチ・ビ ューで定義された fromFiles対 toFiles

のパターンに合致する フ ァ イルの差分を表示し ます。

関連コ マン ド

-d 名前を指定し てブ ラ ンチ ・ マ ッ ピ ングを削除し ます。 フ ァ イルは、 こ の操作によ る

影響を受けません。1 つのコード ラ イ ンから別のコード ラ イ ンへの、保存されたマ ッ

ピ ングだけが削除されます。 通常、 こ のオプシ ョ ンは該当するブ ラ ンチ仕様を生成

し たユーザだけが使用でき ます。

-f 強制オプシ ョ ンです。 PERFORCE 管理者が -d と組み合わせて使用する と、 自分が所

有者でないブ ラ ンチを削除する こ と ができ ます。 また、 管理者がブ ラ ンチ ・ マ ッ ピ

ングの更新日を変更する こ と も可能にし ます （-f を使用する と、［Update:］ フ ィ ー

ル ド が書き込み可能にな り ます）。

-i エデ ィ タ を立ち上げずに標準入力からブラ ンチ ・ マ ッ ピングを読み取 り ます。

-o エデ ィ タ を立ち上げずに標準出力にブラ ンチ ・ マ ッ ピングを出力し ます。

-P parent 指定されたス ト リ ームを、 指定し た親の子ス ト リ ーム と し て処理し た場合に生成さ

れるマ ッ ピングを表示し ます。 -S が必要です。

-S stream 指定されたス ト リ ームに対し て生成されたマ ッ ピ ングを表示し ます。 こ のオプシ ョ

ンを指定する と、 ス ト リ ーム と その親 と の間で変更がどのよ う に伝播されるかが分

か り ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open

既存のブラ ンチ ・ マ ッ ピングの リ ス ト を参照する。 p4 branches

1 つのフ ァ イル ・ セ ッ ト から別フ ァ イル ・ セ ッ ト へ変更を コ ピーする。 p4 integrate

2 つのコード ラ イ ンの間の違いを参照する。 p4 diff2

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 21

p4 branches

22 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 branches

概要

既存のブラ ンチ ・ マ ッ ピングの リ ス ト を出力し ます。

構文

p4 [g-opts] branches [-t] [-u user] [[-e|-E] filter -m max]

解説

p4 branches は、 システムが現在認識し ているすべてのブラ ンチ ・ マ ッ ピングの リ ス ト を出力

し ます。

ブラ ンチ ・ マ ッ ピングの出力を max 個までに限定するには、-m max オプシ ョ ンを使用し ます。

filter と い う パターンに一致する名前を持つブラ ンチに出力を限定するには、 -e または -E

filter オプシ ョ ンを使用し ます。-e オプシ ョ ンでは大文字 と小文字が区別され、-E ではそれ

らが区別されません。

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

し ます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

-t ブラ ンチの 終更新日付に時刻も表示し ます。

-m max max 個までのブラ ンチ ・ マ ッ ピングのみを一覧表示し ます。

-e filter filter に一致するブラ ンチのみを一覧表示し ます （大文字と小文字を区別）。

-E filter filter に一致するブラ ンチのみを一覧表示し ます （大文字と小文字を区別し ない）。

-u user user が所有し ているブラ ンチのみを一覧表示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

ブラ ンチ ・ マ ッ ピングの生成または編集を行 う 。 p4 branch

p4 change

p4 change

概要

チェ ンジ リ ス ト 仕様の生成または編集を行います。

構文

p4 [g-opts] change [ -s ] [ -f | -u ] [[-O] change ]p4 [g-opts] change -d [ -f -s -O ] changep4 [g-opts] change -o [ -s ] [ -f ] [[-O] change ]p4 [g-opts] change -i [ -s ] [ -f | -u ]p4 [g-opts] change -t restricted|public [-U user] [ -f | -u | -O ] changep4 [g-opts] change -U user [-t restricted|public] [ -f ] change

解説

p4 add、p4 delete、p4 edit、 または p4 integrate でフ ァ イルを作業状態にする と、それら

のフ ァ イルはチェ ンジ リ ス ト に追加されます。 フ ァ イルの編集内容は、 チェ ンジ リ ス ト が p4

submit でデ ィ ポへ送られる まで、 ローカルの ク ラ イ アン ト ・ ワーク スペースに保存されます。

デフ ォ ル ト では、 フ ァ イ ルはデフ ォ ル ト ・ チ ェ ン ジ リ ス ト 内で作業状態にな り ますが、 p4

change コマン ド で複数のチェ ンジ リ ス ト を生成、 編集する こ と ができ ます。

p4 changeは、環境変数またはレジス ト リ 変数P4EDITORで定義されたエデ ィ タで編集または参

照でき る フ ォームを表示し ます。 引数が与え られていなければ、 このコマン ド は新しい番号付

チェ ンジ リ ス ト を生成し ます （デフ ォル ト ・ チェ ンジ リ ス ト 内で作業状態になっているすべて

のフ ァ イルは、 新しいチェ ンジ リ ス ト に移されます）。

チェ ンジ リ ス ト には連番が割 り 当て られます。 PERFORCE は、 サブ ミ ッ ト 済チェ ンジ リ ス ト の

番号の並び順を日付時刻の並び順 と同じにする目的で、サブ ミ ッ ト 時にチェ ンジ リ ス ト の番号

を振 り 直すこ と があ り ます。

作業中チ ェ ン ジ リ ス ト の コ メ ン ト を編集す る と き、 ま たはサブ ミ ッ ト 済チ ェ ン ジ リ ス ト の

フ ィ ール ド を参照する と きは、 p4 change changelist を使用し ます。

p4 submit が失敗する と、 デフ ォル ト のチェ ンジ リ ス ト に 1 つの番号が割 り 当て られます。 以

後、 このチェ ンジ リ ス ト を参照するには、 番号を指定する必要があ り ます。

p4 changelist は p4 change と同等に機能し ます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Change: 読み取 り 専用 既存チェ ンジ リ ス ト の編集時はその番号、 新しいチェ ンジ リ

ス ト の生成時は new が表示されます。

Client: 読み取 り 専用 現在のク ラ イ アン ト ・ ワーク スペースの名前。

Date: 読み取 り 専用 こ のチェ ンジ リ ス ト が 後に変更された日付。

User: 読み取 り 専用 現在の PERFORCE ユーザの名前。

空の作業中チェ ンジ リ ス ト （フ ァ イルを含まない作業中チェ

ンジ リ ス ト ） の所有者は、 こ のフ ィ ール ド を編集するか、 -U user オプシ ョ ンを使用する こ と によ り 、チェ ンジ リ ス ト の所

有権を別の既存ユーザに委譲でき ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 23

p4 change

オプシ ョ ン

Status: 読み取 り 専用 pending、 shelved、submitted、new のいずれかが表示さ

れます。 ユーザによ る編集はでき ません。

チ ェ ン ジ リ ス ト 作成時が new、 作成済みだが、 ま だ p4 submitでデ ィ ポへサブ ミ ッ ト し ていない と きがpending、そ

の内容が p4 shelve で保留されている場合が shelved、 すで

に p4 submit でデ ィ ポ に内容が保存 さ れ て い る 場合が

submitted です。

Description: 書き込み可能、

入力必須

こ のチェ ンジ リ ス ト に関する コ メ ン ト 。 サブ ミ ッ ト 前に変更

し なければな り ません。

Jobs: リ ス ト こ のチェ ンジ リ ス ト で修正完了 と な る ジ ョ ブの リ ス ト 。 初

に表示 さ れ る ジ ョ ブの リ ス ト は、 p4 user の フ ォ ー ム の

［JobView:］ の設定によ って制御されます。 表示される ジ ョ

ブは、 削除または追加する こ と ができ ます。

Type: 書き込み可能、

任意指定

変更のタ イプ : restricted または public。

Type: フ ィ ール ド を使用し て、 変更またはそのコ メ ン ト を

ユーザから隠すこ と ができ ます。 状態が shelved または

committed （Status: フ ィ ール ド に表示） でタ イプが

restricted であ るチェ ンジ リ ス ト には、 チェ ンジ リ ス ト を

所有するユーザ、 またはチェ ンジ リ ス ト 内の 1 つ以上のフ ァ

イルに list 権限を持っているユーザにのみア ク セスが可能

です。

public タ イプの変更にはこれらの制限はな く 、すべて表示さ

れます。

デフ ォル ト では、 チェ ンジ リ ス ト は public タ イプです。

PERFORCE スーパーユーザは、 構成可能変数

defaultChangeType を設定し て、 デフ ォル ト のチェ ンジ リ

ス ト ・ タ イプを設定する こ と ができ ます （こ の設定は、 構成

可能変数の設定後に作成されたチェ ンジ リ ス ト に対し て有効

です。）。

Files: リ ス ト こ のチェ ンジ リ ス ト でサブ ミ ッ ト さ れる フ ァ イ ルの リ ス ト 。

表示 さ れ る フ ァ イ ルは削除す る こ と がで き、 デフ ォ ル ト の

チェ ンジ リ ス ト に含まれている フ ァ イルを追加する こ と も で

き ます。

-d 指定のチ ェ ン ジ リ ス ト を削除 し ます。 通常はフ ァ イ ルが含まれていない作業中

チェ ンジ リ ス ト に対し てのみ使用でき ますが、 スーパー ・ ユーザはその他の場合

でも -f オプシ ョ ンを付けてチェ ンジ リ ス ト を削除する こ と ができ ます。

-f 強制オプシ ョ ンです。 サブ ミ ッ ト 済みチェ ンジ リ ス ト のコ メ ン ト の編集を可能に

し ます。 サブ ミ ッ ト 済みチェ ンジ リ ス ト を編集するには、 admin も し く は superの権限が必要です。スーパーユーザおよび管理者は -f オプシ ョ ンを使用し て読み

取 り 専用フ ィ ール ド を上書きする こ と ができ ます。

-u オプシ ョ ン と -f オプシ ョ ンを同時に使 う こ と はでき ません。

-f -d サブ ミ ッ ト 済チェ ンジ リ ス ト を強制的に削除し ます。 PERFORCE 管理者またはスー

パー ・ ユーザだけがこ のコマン ド を使 う こ と ができ ます。 コマン ド実行の前に、該

当チェ ンジ リ ス ト 内のすべてのフ ァ イルを p4 obliterate でシステムから削除

し てお く 必要があ り ます。

-o チェ ンジ リ ス ト の仕様を標準出力に書き出し ます。

-i チェ ンジ リ ス ト の仕様を標準入力から読み取 り ます。入力は p4 change のフ ォー

ムで使用されているの と同じ形式でなければな り ません。

フ ィ ールド名 タ イプ 説明

24 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 change

使用上の留意点

• 論理的に異なる作業を処理する ためにフ ァ イルを編集する場合、ユーザは複数のチェ ンジ リ

ス ト を生成する必要があ り ます。 例えば、 同じバグを修正する ためにフ ァ イル file1.C と

フ ァ イル file2.c を編集し、 一方、 新しい機能を追加する ためにフ ァ イル other.c を編集

する場合は、 file1.c と file2.c は同一のチェ ンジ リ ス ト で作業状態にし、 other.c は別

のチェ ンジ リ ス ト で作業状態にし ます。

• p4 change changelist は、 既存チェ ンジ リ ス ト の仕様を編集する と きに使用し ますが， こ

れを使用し て も、 そのチェ ンジ リ ス ト に リ ン ク し たフ ァ イルやジ ョ ブは表示されません。 特

定のチ ェ ン ジ リ ス ト に リ ン ク し た フ ァ イ ルの リ ス ト を 見 る には、 p4 opened -c

changelist を使い、 特定のチェ ンジ リ ス ト に リ ン ク し たジ ョ ブの リ ス ト を見る には、 p4

fixes -c changelist を使います。

• フ ァ イルをあ るチェ ンジ リ ス ト から別のチェ ンジ リ ス ト に移動する と きには、p4 reopen を

使 う か、 あ るいは p4 revert を使ってすべての作業中チェ ンジ リ ス ト から 1 つのフ ァ イル

を削除し ます。

-s チェ ンジ リ ス ト のサブ ミ ッ ト 時に、 デフ ォル ト の状態であ る closed ではな く 任

意の状態をジ ョ ブに割 り 当て られる よ う にし ます。 ジ ョ ブを未変更のま まにし て

お く には、 特殊な状態であ る same を使用し ます。

新規のチェ ンジ リ ス ト では、 修正完了の状態 と し て ignore と い う 特殊な状態が

表示されます （状態が変更されなければ、 ジ ョ ブはチェ ンジ リ ス ト をサブ ミ ッ ト

し て も修正完了にな り ません）。

このオプシ ョ ンは、 p4 fix の -s と合わせて使用し ます。 これは欠陥追跡システ

ム と連携し て使用する こ と を目的 と し たオプシ ョ ンです。

-O チェ ンジ リ ス ト の番号がサブ ミ ッ ト 時に変更されていて、 元のチェ ンジ リ ス ト 番

号しか知ら ない場合には、 -O および元のチェ ンジ リ ス ト 番号を使用すれば、 その

チェ ンジ リ ス ト の表示または編集が可能です。

-U user -U user オプシ ョ ンによ り 、空の作業中チェ ンジ リ ス ト の所有者が変更されます。

チェ ンジ リ ス ト を割 り 当て直すには、 既にそのチェ ンジ リ ス ト の所有者であ るか、

ま たは admin 権限のあ る ユーザが -f オプシ ョ ン を使用す る 必要があ り ます。

（p4 change フ ォームの User: フ ィ ール ド を手動で編集する場合と は異な り 、こ

のオプシ ョ ンは ト リ ガやス ク リ プ ト の中での使用に便利です。）

-t type サブ ミ ッ ト 済チェ ンジ リ ス ト のタ イプを restricted または public に変更し ま

す。

-u サブ ミ ッ ト 済チェ ンジ リ ス ト を更新し ます。[Jobs:]、[Description:]、[Type:]

のフ ィ ール ド のみが更新可能であ り 、 チェ ンジ リ ス ト のサブ ミ ッ ト 実行者のみが

このチェ ンジ リ ス ト を更新でき ます。

-u オプシ ョ ン と -f オプシ ョ ンを同時に使 う こ と はでき ません。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open、

または-oオプション使用時はlist、 または-fオプション使用時はadmin

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 25

p4 change

使用例

関連コ マン ド

p4 change 新しいチェ ンジ リ ス ト を生成し ます。

p4 change -f 25 サブ ミ ッ ト 済チェ ンジ リ ス ト 25 を編集し ます。管理者またはスーパー・ユー

ザのア ク セス権限が必要です。

p4 change -d 29 チェ ンジ リ ス ト 29 を削除し ます。 チェ ンジ リ ス ト 29 が作業中で、 しかも

フ ァ イルを全 く 含まない場合にのみ有効です。

デ ィ ポへチェ ンジ リ ス ト をサブ ミ ッ ト する。 p4 submit

あ るチェ ンジ リ ス ト から別のチェ ンジ リ ス ト へ 1 つのフ ァ イル

を移動する。

p4 reopen

すべての作業中チェ ンジ リ ス ト から 1 つのフ ァ イルを削除する。 p4 revert

特定の基準に合致するチェ ンジ リ ス ト の リ ス ト を出力する。 p4 changes

作業状態のフ ァ イルの リ ス ト を出力する。 p4 opened

特定のチェ ンジ リ ス ト に リ ン ク された修正完了の リ ス ト を出力

する。

p4 fixes

特定のチェ ンジ リ ス ト にジ ョ ブを リ ン クする。 p4 fix

特定のチェ ンジ リ ス ト から 1 つのジ ョ ブを削除する。 p4 fix -d

チェ ンジ リ ス ト に含まれるすべてのフ ァ イルの リ ス ト を出力す

る。

p4 opened -c changelist

あ るチェ ンジ リ ス ト 内で変更されたフ ァ イルに関する詳細を取

得する。

p4 describe changelist

26 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 changelist

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 27

p4 changelist

概要

チェ ンジ リ ス ト 仕様の生成または編集を行います。

構文

p4 [g-opts] changelist [ -s ] [ -f | -u ] [[-O] change ]p4 [g-opts] changelist -d [ -f -s -O ] changep4 [g-opts] changelist -o [ -s ] [ -f ] [[-O] change ]p4 [g-opts] changelist -i [ -s ] [ -f | -u ]p4 [g-opts] changelist -t restricted|public [-U user] [ -f | -u | -O ] changep4 [g-opts] changelist -U user [-t restricted|public] [ -f ] change

解説

p4 changelist は p4 change と同等に機能し ます。

p4 changelists

28 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 changelists

概要

サブ ミ ッ ト 済みおよび作業中チェ ンジ リ ス ト の リ ス ト を出力し ます。

構文

p4 [g-opts] changelists [-i -t -l -L -f -c client -m max -s status -u user] [file[RevRange]...]

解説

p4 changelists は p4 changes と同等に機能し ます。

p4 changes

p4 changes

概要

サブ ミ ッ ト 済みおよび作業中チェ ンジ リ ス ト の リ ス ト を出力し ます。

構文

p4 [g-opts] changes [-i -t -l -L -f -c client -m max -s status -u user] [file[RevRange]...]

解説

p4 changes によ り 、 サブ ミ ッ ト 済みおよび作業中チェ ンジ リ ス ト の リ ス ト を表示する こ と が

でき ます。 引数な しで p4 changes を使用する と、 すべての番号付チェ ンジ リ ス ト が表示され

ます。 デフ ォル ト のチェ ンジ リ ス ト は表示されません。

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

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

-tオプシ ョ ンを使ってそれぞれのチェ ンジ リ ス ト の時刻を表示する と、各行の形式は次の とお

り です。

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

status （状態） の値は、 そのチェ ンジ リ ス ト が作業中ま たは保留中の場合にのみ表示さ れま

す。 description （コ メ ン ト ） は、 オプシ ョ ンを指定し ない場合、 初の 31 字に制限されま

す。 -L オプシ ョ ンを指定する と 初の 250 文字、 -l オプシ ョ ンを指定する と全テキ ス ト が表

示されます。

フ ァ イル ・ パターンを引数と し て与えれば、 そのパターンに合致する フ ァ イルに影響を及ぼす

サブ ミ ッ ト 済または作業中のチェ ンジ リ ス ト の リ ス ト が表示されます。

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

ビジ ョ ン範囲を含める と、その範囲内のフ ァ イルに影響を及ぼすすべてのチェ ンジが表示され

ます。 リ ビジ ョ ン指定子を 1 つ与え る と、 1 から その指定 リ ビジ ョ ン までのすべてのチェ ンジ

が表示されます。

-c client オプシ ョ ンおよび -u user オプシ ョ ンは、p4 changes の出力を、指定された ク ラ イ

アン ト ・ ワーク スペース またはユーザによ って作成されたチェ ンジ リ ス ト に制限する ために使

用し ます。

-s status オプシ ョ ンは、p4 changes の出力を、指定された status 値（pending、shelved ま

たは submitted） を と るチェ ンジ リ ス ト に制限する ために使用し ます。

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

オプシ ョ ン と フ ァ イル ・ パターンを組み合わせれば、 表示されるチェ ンジ リ ス ト をかな り 絞る

こ と ができ ます。 -m max オプシ ョ ンを使用すれば、 出力対象を 新の max 個のチェ ンジ リ ス

ト に制限する こ と もでき ます。

p4 changelists は p4 changes と同等に機能し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 29

p4 changes

オプシ ョ ン

使用上の留意点

• p4 changes が複数のフ ァ イル引数を伴って呼び出される と、 各引数に影響するチェ ンジ リ

ス ト の集合が個別に評価されます。 後の出力は結合も されず、 ソー ト も されません。 その

効果はフ ァ イル引数ご と に 1回ずつ、p4 changeを複数回呼び出し た と き と同じにな り ます。

• フ ァ イルが指定されていない場合、p4 changesは変更がpublicであ るかrestrictedであ るかに

従って出力内容を制限し ます。 restricted タ イプのサブ ミ ッ ト 済または保留状態のチェ ンジ

リ ス ト は、 そのチェ ンジ リ ス ト を所有し ているか、 チェ ンジ リ ス ト 内の 1 つ以上のフ ァ イル

に リ ス ト 権限を持っていない限 り 、 出力されません。 restricted タ イプの作業中 （ただし保

留解除された） チェ ンジ リ ス ト は、 その所有者にのみ表示されます。

使用例

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

す。

-t 各チェ ンジ リ ス ト に対し て、 日付 と同様に時刻も表示し ます。

-l コマン ド の出力に、 各チェ ンジ リ ス ト のコ メ ン ト の全テキス ト を含めます。

-L 各チェ ンジ リ ス ト のコ メ ン ト を 250 文字に切 り 捨て、 長い出力形式で リ ス ト 表示

し ます。

-f 制限付きのチェ ンジを表示し ます （admin 権限が必要です）。

-c client 出力するチェ ンジ リ ス ト を、 指定された ク ラ イ アン ト ・ ワーク スペースによ って

作成された ものに限定し ます。

-m max 出力するチェ ンジ リ ス ト を、 大番号を含め番号が大きい max 個 （すなわち 新

の max 個の） のチェ ンジ リ ス ト に限定し ます。

-s status 指定の状態 （pending、 submitted または shelved） のチェ ンジ リ ス ト のみを

出力し ます。

-u user 出力するチェ ンジ リ ス ト を、 指定されたユーザによ って作成された も のに限定し

ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 list

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 つ

だけを表示し ます。

30 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 changes

関連コ マン ド

p4 changes @2011/04/01,@now 2011 年 4 月 1 日から現在までにサブ ミ ッ ト された

チェ ンジ リ ス ト をすべて表示し ます。

p4 changes @2011/04/01 2011 年 4 月 1 日よ り 前にサブ ミ ッ ト されたチェ ンジ

リ ス ト をすべて表示し ます。

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

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

特定のチェ ンジ リ ス ト に関する詳細なレポー ト を読み出す。 p4 describe

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 31

p4 client

p4 client

概要

ク ラ イ アン ト ・ ワーク スペース仕様およびそのビ ューの生成または編集を行います。

構文

p4 [g-opts] client [-f] [-t template] [clientname]p4 [g-opts] client -o [-t template] [clientname]p4 [g-opts] client -d [-f] clientnamep4 [g-opts] client -s [-S stream | -t clientname] clientnamep4 [g-opts] client -S stream [[-c change -o] clientnamep4 [g-opts] client -i [-f]

解説

PERFORCE ク ラ イ アン ト ・ ワーク スペースは、 ユーザのマシン上にあ る フ ァ イルの集合で、デ ィ

ポ内にあ る フ ァ イルの集合の一部に対応し ています。 p4 client コマン ド は、 ク ラ イ アン ト ・

ワーク スペース仕様の生成ま たは編集に使用し ます。 こ の コ マン ド を実行する と、 PERFORCE

がワーク スペース管理のために必要とする情報の入力フ ォームが表示されます。

ク ラ イ アン ト ・ ワーク スペースのフ ァ イル とデ ィ ポのフ ァ イルは、 常に 1 対 1 のマ ッ ピングで

関連づけ られていますが、 これらのフ ァ イルは、 同じ相対的位置に保存されている必要も なけ

れば、 同じ名前を持っている必要も あ り ません。 p4 client フ ォームの ［View:］ （ビ ュー ： ）

フ ィ ール ド で指定される ク ラ イ アン ト ・ ビ ューが、 ワーク スペースのフ ァ イルからデ ィ ポへの

マ ッ ピング経路、 およびその逆のマ ッ ピ ング経路を指定し ます。

引数 clientname な しで実行する と、 p4 client は、 環境変数 P4CLIENT または同等の変数で

指定 さ れ た ワ ー ク ス ペー ス に対 し て 動作 し ま す。 ロ ッ ク さ れ た ワ ー ク ス ペー ス を 引数

clientname に指定し て実行する と、 ワーク スペース仕様が読み取 り 専用で表示されます。

p4 client が完了す る と、 新 し く 生成 さ れた、 ま たは変更 さ れた ワ ー ク ス ペー ス 仕様が

PERFORCE データベースに保存されます。 こ の時点では、 ワーク スペースのフ ァ イルは影響を

受けません。 新しいビ ューは、 次に p4 sync が実行されて初めて有効にな り ます。

変更を ス ト リ ームにサブ ミ ッ ト するには、 ス ト リ ームに関連付け られたワーク スペース を使用

し なければな り ません。 ス ト リ ームに関連付け ら れた ワ ー ク スペース を作成す る には、 p4

client -S stream clientname を実行し ます。 ワーク スペースに関連付け られたス ト リ ーム

を変更するには、 p4 client -s -S stream clientname を実行し ます。

p4 workspace は p4 client と同等に機能し ます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Client: 読み取 り 専用 環境変数 P4CLIENT または同等の変数で指定された ク ラ イ アン

ト ・ ワーク スペース名。

Owner: 書き込み可能 ク ラ イ ア ン ト ・ ワー ク スペース を所有する ユーザの PERFORCE

ユーザ名。 デフ ォル ト は、 そのワーク スペース を生成し たユー

ザです。

Update: 読み取 り 専用 ワーク スペース仕様が 後に更新された日付。

Access: 読み取 り 専用 ワーク スペースが何らかの形で 後に使用された日付 と時刻。

( 注 : p4 reload によ る ワーク スペースの リ ロード は、 ア ク セ

ス時刻には反映されません。）

32 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 client

Host: 書 き 込 み 可

能、 任意入力

ワーク スペースが常駐する ワーク ス テーシ ョ ンの名前。 指定さ

れていれば、 こ の ク ラ イ アン ト ・ ワーク スペースは上記ホ ス ト

からのみ操作でき ます。

ホス ト 名は、そのホス ト から p4 info を実行し た と きの出力と

正確に一致し ていなければな り ません。

こ のフ ィ ール ド は、 ク ラ イ アン ト ・ ワーク スペースが誤って別

のホ ス ト 上で使用さ れるのを防ぐ ためにあ り ます。 こ れを行っ

て も セキ ュ リ テ ィ は保証さ れません。 その理由は、 ホ ス ト 名の

実効値は p4 コマン ド の -H オプシ ョ ンまたは環境変数 P4HOST によ り オーバーラ イ ド される こ と があ る ためです。 こ れ と 同様

の機能であ り なが ら セキ ュ リ テ ィ を保証する も の と し ては、 p4protect の IP ア ド レ ス制限機能があ り ます。

Description: 書 き 込 み 可

能、 任意入力

ワーク スペースに関する コ メ ン ト 。 デフ ォル ト は Created by owner です。

Root: 書 き 込 み 可

能、 入力必須

［View:］ に記述されているすべてのフ ァ イルの相対位置の基準

と な る （ローカル ・ ホ ス ト 上の） デ ィ レ ク ト リ 。 デフ ォル ト は

現在の作業デ ィ レ ク ト リ です。

AltRoots: 書 き 込 み 可

能、 任意入力

2 つまで任意で指定する ク ラ イ アン ト ・ ルー ト の別名 （代理） で

す。

PERFORCE のアプ リ ケーシ ョ ンでは、 初に メ イ ンのク ラ イ アン

ト ・ ルー ト 、 次に別名の ク ラ イ アン ト ・ ルー ト を検査する こ と

によ って、カレ ン ト ・ ワーキング・デ ィ レ ク ト リ と合致させます。

これによ り ユーザは、 異な るデ ィ レ ク ト リ 名の変換をする こ と

ができ、 複数プ ラ ッ ト フ ォーム上で同じ PERFORCE ク ラ イ アン

ト ・ ワーク スペース仕様を使用する こ と ができ ます。

ワーク スペース ・ ルー ト のいずれかで Windows デ ィ レ ク ト リ を

使用し ている場合には、 その Windows デ ィ レ ク ト リ を メ イ ンの

ワー ク スペース ・ ルー ト と し て指定し、 他の ワー ク スペース ・

ルー ト のデ ィ レ ク ト リ を AltRoots: フ ィ ール ド に指定し なけれ

ばな り ません。

例えば、 複数プ ラ ッ ト フ ォーム上で製品を ビル ド し ている エン

ジニアは、 Windows 上でのビル ド 用 と し て メ イ ンの ク ラ イ アン

ト ・ ルー ト を C:\Projects\Build、 UNIX 上でのビル ド に関す

る 作 業 用 と し て 別 名 の ル ー ト を

/staff/userid/projects/build と指定し ます。

Options: 書 き 込 み 可

能、 入力必須

ワーク スペース ・ オプシ ョ ンを制御する 7 つのス イ ッチを指定

し ます。 オプシ ョ ンの内容については、 後述の 「使用上の留意

点」 をご覧 く ださい。

フ ィ ールド名 タ イプ 説明

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 33

p4 client

SubmitOptions: 書 き 込 み 可

能、 入力必須

p4 submit のデフ ォル ト の動作を制御するオプシ ョ ン。

• submitunchanged

すべての作業状態のフ ァ イル （変更の有無にかかわ らず） が

デ ィ ポにサブ ミ ッ ト されます。これは PERFORCE のデフ ォル ト

の動作です。

･ submitunchanged+reopen

すべての作業状態のフ ァ イル （変更の有無にかかわ らず） が

デ ィ ポにサブ ミ ッ ト さ れ、 すべての フ ァ イ ルが自動的にデ

フ ォル ト ・ チェ ンジ リ ス ト で再度作業状態にされます。

･ revertunchanged

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ

ポにサブ ミ ッ ト されます。未変更のフ ァ イルは元に戻し ます。

･ revertunchanged+reopen

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ

ポにサブ ミ ッ ト され、 デフ ォル ト ・ チェ ンジ リ ス ト で再度作

業状態に されます。 未変更のフ ァ イルは元に戻し ますが、 デ

フ ォル ト ・ チェ ンジ リ ス ト では作業状態にされません。

･ leaveunchanged

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ

ポにサブ ミ ッ ト さ れます。 未変更のフ ァ イルはデフ ォル ト ・

チェ ンジ リ ス ト に移動されます。

･ leaveunchanged+reopen

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ

ポにサブ ミ ッ ト さ れます。 未変更のフ ァ イルはデフ ォル ト ・

チェ ンジ リ ス ト に移動され、 変更済みのフ ァ イルはデフ ォル

ト ・チェ ンジ リ ス ト で再度作業状態にされます。こ のオプシ ョ

ンは submitunchanged+reopen と似ていますが、 未変更

のフ ァ イルはデ ィ ポにサブ ミ ッ ト されません。

LineEnd: 書 き 込 み 可

能、 入力必須

復帰 / 改行 （CR/LF） の変換を設定し ます。 設定については、 後

述の 「使用上の留意点」 をご覧 く ださい。

Stream: 書 き 込 み 可

能、 任意入力

ワ ー ク ス ペー ス を、 指定 し た ス ト リ ー ム に 関連付 け ま す。

PERFORCE は ス ト リ ー ム に関連付け ら れた ワ ー ク ス ペー ス の

ビ ューを生成し ます。 ユーザは手動でそれを変更でき ません。

StreamAtChange: 書 き 込 み 可

能、 任意入力

過去のあ る時点におけ る ス ト リ ームのビ ューを設定するチェ ン

ジ リ ス ト 番号。

StreamAtChange が設定されている と き、 p4 sync を（引数を

付けずに） 実行する と、 ワー ク スペースはフ ァ イルを 新 リ ビ

ジ ョ ン ではな く こ のチ ェ ン ジ リ ス ト の リ ビ ジ ョ ンに更新 し ま

す。 StreamAtChange が設定されている場合は、 ワーク スペー

ス ・ ビ ューに現在のス ト リ ームの継承関係が反映されていない

ため、 チェ ンジ リ ス ト をサブ ミ ッ ト でき ません （p4 submit が

エラーを返し ます）。

同時に Stream フ ィ ール ド も有効なス ト リ ームに設定されてい

なければ、 このフ ィ ール ド は無視されます。

ServerID: 書 き 込 み 可

能、 任意入力

設定さ れている場合、 ワーク スペースは指定されたサーバに限

り 使用可能です。未設定の場合、 こ のワーク スペースはどのサー

バでも使用可能です。

View: 書 き 込 み 可

能、 複数行

デ ィ ポのフ ァ イル と ワーク スペースのフ ァ イル と の間のマ ッ ピ

ングを指定し ます。 詳し く は、 「ビ ュー」 のセ ク シ ョ ンをご覧 く

ださい。

フ ィ ールド名 タ イプ 説明

34 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 client

オプシ ョ ン

使用上の留意点

• スペース を含むフ ァ イルまたはデ ィ レ ク ト リ 名のデ ィ ポ ・ サイ ド またはク ラ イ アン ト ・ サイ

ド のマ ッ ピングは引用符で囲みます。

• ワーク スペース名に含まれる スペースはアンダーバー と解釈されます。 例えば、 p4 client

"my workspace" と い う コマン ド を入力する と、my_workspace と い う ワーク スペースが生成

されます。

• ［Options:］ （オプシ ョ ン ： ） フ ィ ール ド には、 6 つの設定項目がスペースで区切って表示さ

れます。 これらの設定項目には、 それぞれ 2 つの設定値があ り 、 その設定値と意味を次の表

に示し ます。

-d clientname 指定された ク ラ イ アン ト ・ ワーク スペースのロ ッ ク が解除されていれば、 ワーク

スペースがユーザによ って所有されているか否か と は無関係に、 それを削除し ま

す。 (-f オプシ ョ ンによ り 、 PERFORCE 管理者は他のユーザが所有し ている ロ ッ ク

されたワーク スペース を削除する こ と ができ ます。 )

-f 通常は読み取 り 専用になっている 終更新日を設定可能にし ます。管理者は -f オ

プシ ョ ンを使用し て他のユーザが所有し ている ロ ッ ク されたワーク スペース を削

除または修正する こ と ができ ます。

-i ク ラ イ アン ト ・ ワーク スペース仕様を標準入力から読み込みます。

-o ク ラ イ アン ト ・ ワーク スペース仕様を標準出力へ書き出し ます。

-o -c change -S stream と共に使用する と、 チェ ンジ リ ス ト change のサブ ミ ッ ト 時にス ト

リ ーム stream と関連付けて作成された と仮定し た場合のワーク スペース仕様が

表示されます。

-s ワーク スペース ・ ビ ューを切 り 替えます。 ワーク スペース ・ ビ ューを ス ト リ ーム

に切 り 替え るには、-S stream を指定し ます。別のワーク スペースに定義された

ビ ューに切 り 替え るには、 -t clientname を指定し ます。

-S stream ワー ク スペース を指定ス ト リ ームに関連付け ます。 そのス ト リ ームが ワー ク ス

ペース ・ ビ ューの生成に使用されます。

-t clientname ク ラ イ アン ト ・ ワーク スペースの ［View:］ フ ィ ール ド と ［Option:］ フ ィ ール

ド に、 別の ク ラ イ アン ト ・ ワーク スペース clientname のビ ューと オプシ ョ ンを

コ ピーし ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 35

p4 client

• デフ ォル ト では、 どのユーザも p4 client -c clientname ですべてのワーク スペース を編

集で き ます。 そ う し た事態を防ぐ には、 ［Options:］ フ ィ ール ド で locked を設定し、 p4

passwd でワーク スペース所有者のパス ワード を生成し ます。

設定値 意味 デフ ォル ト

[no]allwrite allwrite に設定する と、 ワー ク スペース内の作業状態でない

フ ァ イルは書き込み可能のま まにな り ます。

allwriteに設定する と、このオプシ ョ ンは noclobberの設定を

オーバーラ イ ド し ます。

allwrite に設定される と、 作業状態になっていないフ ァ イルは

現在のユーザが書 き込み可能な状態の ま ま にな り ます。 マルチ

ユーザ ・ システムのユーザが書き込み可能であ る よ う にフ ァ イル

システムのパー ミ ッ シ ョ ンを設定する こ と はあ り ません。

noallwrite

[no]clobber clobber に設定する と、 p4 sync 実行時にワーク スペースで新

たに同期し たフ ァ イル と 同じ名前を持つ、 書き込み可能だが作業

状態でないフ ァ イルが上書き （clobber） されます。

allwrite が設定される と、clobber オプシ ョ ンが暗黙的に想定

され、 noclobber オプシ ョ ンが設定されていて も無視されます。

noclobber

[no]compress compress に設定する と、 ユーザのワーク ステーシ ョ ン と

PERFORCE サービ スの間のデータ ・ ス ト リ ームが圧縮されます。 nocompress

[un]locked 他のユーザにワーク スペース仕様を編集または削除するパー ミ ッ

シ ョ ンを認めるか否かを設定し ます。 （locked のワーク スペース

を効果的に使用するには、 p4 passwdで該当ワーク スペースの所

有者のパス ワード も設定し てお く 必要があ り ます。）

lockedに設定されている場合は、所有者だけがワーク スペース仕

様を使用または編集でき ます。 PERFORCE 管理者は、 p4 client に -f （強制） オプシ ョ ンを付けてそのロ ッ ク をオーバーラ イ ド

する こ と ができ ます。

unlocked

[no]modtime フ ァ イルタ イプ修飾子 +m (modtime) の付いていないフ ァ イル :

･ バージ ョ ン 99.2 以前の PERFORCE では、modtime に設定されて

いる場合、 新たに同期し たフ ァ イルの （ローカルのフ ァ イルシ

ステムにおけ る） 更新日は、 そのフ ァ イルがデ ィ ポへサブ ミ ッ

ト された時点における、PERFORCE サービ スのホス ト ・ マシン上

の日付 と時刻にな り ます。

･ バージ ョ ンが 2000.1 以降の PERFORCE では、modtime に設定さ

れている場合、 新たに同期し たフ ァ イルの （ローカルのフ ァ イ

ルシス テムにおけ る） 更新日は、 そのフ ァ イルが 後に更新さ

れた と きのそのフ ァ イルにおける日付ス タ ンプにな り ます。

･ nomodtime に設定されていれば、 バージ ョ ンに関係な く 、 更

新日は同期化の日付 と時刻にな り ます。

フ ァ イルタ イプ修飾子 +m (modtime) の付いている フ ァ イル :

･ バージ ョ ンが 99.2 以前の PERFORCE の場合、+m 修飾子は無視さ

れ、modtime 設定時と nomodtime 設定時の動作は上記のよ う

にな り ます。

･ バージ ョ ンが 2000.1 以降の PERFORCE の場合、 新たに同期し た

フ ァ イルの （ローカルのフ ァ イルシステムにおける） 更新日は、

ク ラ イ アン ト における modtime/nomodtime の設定に関係な

く 、 フ ァ イルがデ ィ ポへサブ ミ ッ ト された と きのフ ァ イルにお

ける日付ス タ ンプにな り ます。

nomodtime （大 半 の フ ァ

イ ルでは同期

の 日 付 と 時

刻）

フ ァ イ ル タ イ

プ修飾子+mが

付 い て い る

フ ァ イ ルでは

無視。

[no]rmdir rmdirに設定し て p4 sync を実行する と、ワーク スペースにあ る

空のデ ィ レ ク ト リ が削除されます。

normdir

36 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 client

• compress オプシ ョ ンは、 伝送するデータ量を減ら し て、 低速 リ ン ク を介し た通信を高速化

し ます。 高速 リ ン ク の場合には、 圧縮プロセスそのものに、 節約される伝送時間よ り 多 く の

時間がかかる こ と があ り ます。 一般に、compress は T1 以下の伝送速度の と きに設定すべき

で、 それ以外の場合は設定し ない方がよいでし ょ う 。 距離によ る違いは様々です。

• ［LineEnd:］ （行末 ： ） フ ィ ール ド は、 ク ラ イ アン ト ・ ワーク スペースのテキ ス ト ・ フ ァ イ

ルに使用される行末文字を制御し ます。

［LineEnd:］ フ ィ ール ド は、 次の 5 種類の設定値のいずれかを受け付けます。

PERFORCE によ る行末設定の使用方法に関し て詳し く は、 PERFORCE ナレ ッ ジベースの "CR/LF

Issues and Text Line-endings" を参照し て く だ さい。

http://kb.perforce.com/article/63

• デフ ォル ト では、 ク ラ イ アン ト ・ ワーク スペースに空のデ ィ レ ク ト リ があって も （例えば、

そのデ ィ レ ク ト リ にマ ッ ピ ング さ れるすべてのフ ァ イルが 後の同期以後に削除さ れてい

る よ う な場合） 、 p4 sync はそのデ ィ レ ク ト リ をそのま ま残し ます。 ただし、 ［Options:］

フ ィ ール ド で rmdir が設定されていれば、p4 sync はワーク スペースの空のデ ィ レ ク ト リ を

削除し ます。

ÅmOptions:Ånフ ィ ール ド でrmdirが設定されている と、p4 syncで現在の作業デ ィ レ ク ト リ

が削除される こ と があ り ます。 その場合には、 作業を続行する前に既存のデ ィ レ ク ト リ に切

り 換えて く だ さい。

• フ ァ イルタ イプ修飾子 modtime (+m) が付いている フ ァ イルは主に、 フ ァ イルのオ リ ジナル ・

タ イ ム ス タ ンプを保存する必要のあ る開発者用です。 +m を使用する と、 ［Options:］ フ ィ ー

ル ド の modtime または nomodtime の設定がオーバーラ イ ド されます。+m 修飾子について詳

し く は、 「フ ァ イルタ イプ」 のセ ク シ ョ ンをご覧 く だ さい。

• 別名のワーク スペース ・ ルー ト （［AltRoots:］ フ ィ ール ド を使用し ている場合は、 p4 info で表示される Client root: によ って、どのルー ト が有効になっているかをいつで も知る こ

と ができ ます。

注 ［LineEnd:］ フ ィ ール ド は、 PERFORCE 2001.1 で導入 さ れ た も の で、

［Options:］ フ ィ ール ド で crlf または nocrlf を指定し ていた古い方

式に代わる ものです。

LineEnd: winおよびOptions: crlf と い う 互いに矛盾し た設定が

行われている場合の動作は未定義です。

設定値 意味

local ク ラ イ アン ト のネイ テ ィ ブ ・ モード （デフ ォル ト ） を使用し ます。

unix UNIX 形式 （および MAC OS X） の行末識別を LF で行います。

mac OS X よ り 前のバージ ョ ンの Mac の行末識別を CR で行います。

win CR、 LF で Windows 形式の行末識別を行います。

share share オプシ ョ ンは、混在し た行末コード を UNIX の行末形式に標準化し ます。shareオプシ ョ ンはワーク スペースに既に同期されている フ ァ イルには影響し ません。 し か

し、 フ ァ イルがデ ィ ポにサブ ミ ッ ト される際、 share オプシ ョ ンによ り Windows 形式の

行末であ る CR/LF および Mac 形式の行末であ る CR はすべて UNIX 形式の LF に変換

され、 LF のみがそのま まの状態で残されます。

ワーク スペースの同期の際、行末は LF に設定されます。 フ ァ イルを Windows マシンで

編集する場合、エデ ィ タによ り 各 LF の前に CR が挿入されて も、追加された CR はアー

カ イブ ・ フ ァ イル内には現れません。

一般に share の設定を利用するのに適し ているのは、 UNIX のホーム ・ デ ィ レ ク ト リ

をネ ッ ト ワーク ・ ド ラ イブ と し てマウ ン ト し た Windows ワーク ステーシ ョ ンのユーザ

が、フ ァ イルの同期は UNIX から行い、編集は Windows マシン上で行 う よ う な場合です。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 37

p4 client

• 複数ド ラ イブにまたがる Windows 上のワーク スペース を指定するには、 ワーク スペース ・

ビ ューで ［Root:］ フ ィ ール ド を null に設定し、 個々の ド ラ イブを指定し ます。 例えば、 下

のよ う にルー ト を null にし てワーク スペース仕様を指定する と、 //depot/main/... から

C ド ラ イブの領域へ、 他の release から D ド ラ イブへマ ッ ピング されます。

複数ド ラ イブにまたがる ワーク スペースの個々の ド ラ イブは小文字で指定し ます。

使用例

関連コ マン ド

Client: eds_winOwner: edkDescription: Ed’s Windows WorkspaceRoot: nullOptions: nomodtime noclobberSubmitOptions: submitunchangedView: //depot/main/... "//eds_win/c:/Current Release/..." //depot/rel1.0/... //eds_win/d:/old/rel1.0/... //depot/rel2.0/... //eds_win/d:/old/rel2.0/...

p4 client P4CLIENT または同等の方法によ って指定された名前のワーク スペー

スの仕様を編集または生成し ます。

p4 client -t sue joe デフ ォル ト と し て ワーク スペース sue の設定値 と オプシ ョ ン を含む

フ ォームを表示し て、 ワーク スペース joe の生成または編集を行いま

す。

p4 client -d release1 ワーク スペース release1 を削除し ます。

システムが認識し ている全てのワーク スペースの リ ス ト を表示する。 p4 clients

デ ィ ポから ワーク スペースへフ ァ イルを読み込む。 p4 sync

ワーク スペースでデ ィ ポに追加する新しいフ ァ イルを作業状態にする p4 add

ワーク スペースで編集する フ ァ イルを作業状態にする。 p4 edit

ワーク スペースで削除する フ ァ イルを作業状態にする。 p4 delete

ワーク スペースのフ ァ イルに対する変更をデ ィ ポに書き込む。 p4 submit

38 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 clients

p4 clients

概要

現在システムが認識し ているすべての ク ラ イ アン ト ・ ワーク スペースの リ ス ト を表示し ます。

構文

p4 [g-opts] clients [-t] [ -u user ] [ [-e|-E] filter -m max ] -S streamP4 [g-opts] clients -U

解説

p4 clients は、 PERFORCE バージ ョ ン ・ サービ スが認識し ているすべての ク ラ イ アン ト ・ ワー

ク スペースの リ ス ト を表示し ます。ワーク スペースは1行に1つずつ、次の形式で表示されます。

Client clientname moddate root clientroot description

例えば、

Client paris 2009/02/19 root /usr/src 'Joe’s client'

は、 2009 年 2 月 19 日に 後に更新され、 /usr/src をルー ト ・ デ ィ レ ク ト リ とする、 paris

と い う 名前の ク ラ イ アン ト ・ ワー ク スペース を表し ます。 ワー ク スペースに関する コ メ ン ト

（description） は、 p4 client のフ ォームで入力された も のがそのま ま表示され、 こ の例では

Joe’s client です。

ク ラ イ アン ト ･ワーク スペースの出力を max 個までに限定するには、-m max オプシ ョ ンを使用

し ます。

filter と い う パターンに一致する名前を持つラベルに出力を限定する には、 -e ま たは -E

filter オプシ ョ ンを使用し ます。-e オプシ ョ ンでは大文字 と小文字が区別され、-E ではそれ

らが区別されません。

指定されたユーザが所有し ている ワーク スペースに出力を限定するには、 -u user オプシ ョ

ンを使用し ます。

p4 workspaces は p4 clients と 同等に機能し ます。

オプシ ョ ン

-t ワーク スペースの 終更新日付に時刻も表示し ます。

-m max max 個までのク ラ イ アン ト ･ワーク スペースのみを一覧表示し ます。

-e filter filter に一致する ク ラ イ アン ト ･ワーク スペースのみを一覧表示し ます （大文字と小

文字を区別）。

-E filter filter に一致する ク ラ イ アン ト ･ワーク スペースのみを一覧表示し ます （大文字と小

文字を区別し ない）。

-S stream 指定された ス ト リ ームに関連付け られた ク ラ イ アン ト ･ワーク スペース を一覧表示し

ます。

-u user user が所有し ている ク ラ イ アン ト ･ワーク スペースのみを一覧表示し ます。

-U p4 unload によ り アン ロード された ク ラ イ アン ト ･ワーク スペースのみを一覧表示し

ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 39

p4 clients

使用上の留意点

関連コ マン ド

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

ク ラ イ アン ト ・ ワーク スペース仕様を編集または参照する。 p4 client

カレ ン ト ・ ク ラ イ アン ト ・ ワーク スペース名その他の有用なデータ を見る。 p4 info

PERFORCE ユーザの リ ス ト を参照する。 p4 users

40 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 configure

p4 configure

概要

サーバ構成変数を管理し ます。

構文

p4 [g-opts] configure set [P4NAME#]variable=valuep4 [g-opts] configure unset [P4NAME#]variablep4 [g-opts] configure show [ allservers | P4NAME | variable ]

解説

p4 configure を使用し て、 稼動中のサーバの構成を変更し ます。 構成変数の説明は p4 help

configurables によ り 示されます。

p4 configure show を使用する と、現在のサーバ、指定サーバ、 あ るいは構成可能変数の構成

状態が表示されます。 構成可能変数 と と もに、 その構成可能変数の設定がコマン ド ラ イ ン ・ オ

プシ ョ ン、 環境変数、 または p4 configure コマン ド のどれによ って決定されるかが示されま

す。

ほ と んどの構成可能変数の変更はただちに反映され、変更を有効にする ためにサーバを再起動

する必要はあ り ません。

PERFORCE を イ ン ス ト ールし た後、 monitor を 1 または 2 に設定し てプロセスの監視を有効に

し、 security を 3 に設定し てチケ ッ ト ベースの認証を必須にし て、 dm.user.noautocreate

を 1 ま た は 2 に設定 し て新 し い ユーザの自動作成 を 防止す る と 良い で し ょ う 。 ま た、

dm.user.resetpassword を 1 に設定する こ と も推奨されます。 こ う する と、作成し た （そ し て

初期パス ワード を割 り 当てた） 新規ユーザは、 コマン ド を実行する前に自分のパス ワード を リ

セ ッ ト する こ と を強制されます。

構成可能変数がバイ ト 数を示し ている場合、 略語 "K" および "M" は適切な 2 のべき乗と し て

解釈されます。 他の構成可能変数については、 "K" および "M" はそれぞれ 1000 と 100 万を示

し ます。

以下の構成可能変数がサポー ト されます。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

dbjournal.bufsize サーバ 16K ジ ャーナル と チ ェ ッ ク ポ イ ン ト の読み

取 り / 書き込み操作のためのバッ フ ァ ・

サイ ズ

dbopen.nofsync サーバ 0 サーバが db.* データベース ・ フ ァ イル

を閉じ た と きに fsync() 呼び出し を無

効にし、変更されたデータ を書き込む時

期を OS が決定でき る よ う にするには、

1 に設定し ます。

db.replication サーバ 未設定 PERFORCE サーバ上の メ タデータ (db.*フ ァ イル ) にア ク セスする コマン ド の動

作を制御し ます。

readonly: メ タデータ を読み取る ユー

ザ ・ コマン ド を受け入れ、 メ タデータ を

変更する コマン ド を拒否し ます。

p4d -M readonly オプシ ョ ン を用い

てレプ リ カを開始するの と同等です。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 41

p4 configure

defaultChangeType サーバ な し 新し いチェ ンジ リ ス ト のデフ ォル ト ･タ

イプ。 public または restricted の

値を取 り ます。 未設定の場合、 新 し い

チェ ンジ リ ス ト は public にな り ます。

dm.annotate.maxsize サーバ 10M p4 annotate での 大 リ ビジ ョ ン ・ サ

イ ズ

dm.domain.accessupdate サーバ 300 指定し た秒数を経過し ない と、ア ク セス

時刻更新のための書 き込み ロ ッ ク を要

求し ません。

dm.domain.accessforce サーバ 3600 サーバが ロ ッ ク を待機 し なければな ら

ない場合でも、指定し た秒数を経過し て

いた ら ア ク セ ス時刻を強制的に更新 し

ます。

dm.grep.maxrevs サーバ 10K p4 grep によ って検索可能な 大 リ ビ

ジ ョ ン数。

dm.integ.engine サーバ 2 3に設定すると、 p4 integrateに新し

い反映エンジンが使用されます。（p4merge コマンドでは、この設定とは無

関係に v3 反映エンジンが常に使用され

ます。）

dm.keys.hide サーバ 0 1 に設定されると、p4 keys には

admin 権限が必要になります。

dm.password.minlength サーバ 8 security がゼロ以外の値に設定され

たサーバで要求される、パスワードの最

小文字数のデフォルト値。

dm.protects.allow.admin サーバ 0 PERFORCE 管理者が p4 protectsコマン

ドに -a、-g、-uオプションを使用する

ことを許可します。デフォルトでは、

スーパーユーザのみがこれらのオプ

ションを使用できます。

dm.resolve.attribs サーバ 1 p4 attribute によ って設定される属

性の衝突解決を有効にし ます。

dm.shelve.maxfiles サーバ 10M p4 shelve に よ っ て保留可能な 大

フ ァ イル数。

dm.shelve.maxsize サーバ 0 保留可能なフ ァ イルの 大サイ ズ。 0 の

場合は無制限。

dm.user.accessupdate サーバ 300 指定し た秒数を経過し ない と、ア ク セス

時刻更新のための書 き込み ロ ッ ク を要

求し ません。

dm.user.accessforce サーバ 3600 サーバが ロ ッ ク を待機 し なければな ら

ない場合でも、指定し た秒数を経過し て

いた ら ア ク セ ス時刻を強制的に更新 し

ます。

dm.user.loginattempts サーバ 3 遅延を発生 さ せ る ま でのパス ワー ド 試

行回数。 ロ グ イ ン に 3 回失敗す る と、

ユーザは 10 秒間待機し なければな り ま

せん。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

42 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 configure

dm.user.noautocreate サーバ 0 ユーザ自動作成の動作を制御し ます。

0: 存在し ないユーザが PERFORCE コマン

ド を実行し た と き、常にユーザを作成し

ます。

1: 新しいユーザは、 p4 user の実行に

よ ってのみ作成可能です。

2: 新しいユーザはスーパーユーザが p4user を実行し た と きにのみ作成可能で

す。

dm.user.resetpassword サーバ 0 設定されている と、パス ワード が与え ら

れて作成された新規ユーザは、 コマン ド

を実行す る前にパス ワー ド を リ セ ッ ト

する よ う 強制されます。

filesys.binaryscan ク ラ イ アン ト 64K p4 add の実行時、 バイナ リ ・ データの

初の filesys.binaryscan バイ ト

を スキ ャ ン し ます。

filesys.bufsize ク ラ イ アン ト 、

サーバ

4K ク ラ イ アン ト 側の読み取 り /書き込み操

作のためのバッ フ ァ ・ サイ ズ。

filesys.extendlowmark ク ラ イ アン ト 32K フ ァ イ ルサ イ ズが こ の値を超え る と 事

前割 り 当てが実行されます (Windows)。

filesys.P4ROOT.min サーバ 10M サーバのルー ト ・ フ ァ イルシステムに必

要な 少デ ィ ス ク空き容量。 これよ り 少

な く なる と、サーバはコマン ド を拒否し

ます。

filesys.P4JOURNAL.min サーバ 10M サーバのジャーナル・ フ ァ イルシステム

に必要な 少デ ィ ス ク空き容量。 これよ

り 少な く なる と、サーバはコマン ド を拒

否し ます。

filesys.P4LOG.min サーバ 10M サーバのロ グ ・ フ ァ イルシステムに必要

な 少デ ィ ス ク空き容量。 これよ り 少な

く なる と、サーバはコマン ド を拒否し ま

す。

filesys.TEMP.min サーバ 10M 一時的な処理に必要な 少デ ィ ス ク 空

き容量。 これよ り 少な く なる と、 サーバ

はコマン ド を拒否し ます。

filesys.depot.min サーバ 10M デ ィ ポに必要な 少デ ィ ス ク空き容量。

これよ り 少な く なる と、サーバはコマン

ド を拒否し ます。 （1 つのデ ィ ポで使用可能な空き容量が

filesys.depot.min よ り も少ない場

合、すべてのデ ィ ポにかかわる ト ラ ンザ

ク シ ョ ンについて コ マン ド が拒否 さ れ

ます。）

filetype.maxtextsize ク ラ イ アン ト 10M テ キ ス ト タ イ プ検出対象 と す る 大

フ ァ イルサイ ズ。

journalPrefix サーバ 未設定 ジ ャーナルの接頭語ま たはデ ィ レ ク ト

リ の位置

lbr.bufsize サーバ、

プロ キシ

4K バージ ョ ン化フ ァ イルのサーバ・ アーカ

イブに対する読み取 り /書き込み操作の

ためのバッ フ ァ ・ サイ ズ

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 43

p4 configure

lbr.proxy.case プロ キシ 1 1: フ ァ イル・パスでは常に大文字 と小文

字を区別し ません。

2: サーバで大文字 と 小文字が区別 さ れ

ない場合、 フ ァ イル ・ パスでは大文字 と

小文字を区別し ません。

3: フ ァ イル・パスでは常に大文字 と小文

字を区別し ます。

lbr.replication サーバ 未設定 PERFORCE サーバ上のバージ ョ ン化フ ァ

イルにア ク セスするユーザ・ コマン ド の

動作を制御し ます。

readonly: デ ィ ポのフ ァ イルを読み取

るユーザ ・ コマン ド を受け入れ、 デ ィ ポ

のフ ァ イルを変更するユーザ・ コマン ド

を拒否し ます。

ondemand: レプ リ カ ・ サーバのユーザ

に よ っ て明示的に要求 さ れた場合に限

り 、 バージ ョ ン化フ ァ イ ルを複製 し ま

す。

none:バージ ョ ン化フ ァ イルへのア ク セ

スは許容されません。

p4d -D readonly 、-D ondemand ま

たは -D none オプシ ョ ンを用いてレプ

リ カを開始するの と同等です。

lbr.retry.max サーバ 50K 転 送 が 失 敗 し た 場 合、 レ プ リ カ は

lbr.retry.max の回数だけ フ ァ イ ル

の取得を試みます。

lbr.verify.in サーバ 1 内容について ク ラ イ ア ン ト か ら サーバ

への検証を行いますか ?

(1 は行 う 、 0 は行わない )

lbr.verify.out ク ラ イ アン ト 、

サーバ

1 内容についてサーバか ら ク ラ イ ア ン ト

への検証を行いますか ?

(1 は行 う 、 0 は行わない )

minClient サーバ な し こ のサーバへの接続が許可 さ れ る ク ラ

イ アン ト ・ ソ フ ト ウ ェアの も低いバー

ジ ョ ン。 p4 configure set minClient=version によ って設定さ

れます。

minClientMessage サーバ な し ク ラ イ アント ・ ソ フト ウ ェアが古すぎる

場合に発行する メ ッ セージ。 p4 configure set minClientMessage=message によ っ

て設定さ れます。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

44 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 configure

monitor サーバ 0 サーバ ・ プロセスの監視 :

0: サーバ・プロセスの監視を無効にし ま

す。 1: ア ク テ ィ ブなプ ロ セ スだけを監視し

ます。 2: ア ク テ ィ ブなプ ロ セ ス と 休止中のプ

ロセス を監視し ます。

詳し く は p4 monitor を参照し て く だ

さい。

net.backlog サーバ、

プロ キシ

10 待機中の接続に関す る待ち行列の 大

の長 さ。 極度に負荷が大 き いサーバに

ユーザが接続でき ない場合、 これを増や

すこ と を検討し て く ださい。

net.keepalive.disable サーバ 0 ゼロ以外の場合、 TCP キープア ラ イブ ・

パケ ッ ト の送信を無効にし ます。

net.keepalive.idle サーバ 0 キープア ラ イ ブの送信を開始す る ま で

のア イ ド ル時間 （単位 : 秒）

net.keepalive.interval サーバ 0 キープア ラ イ ブ ・ パケ ッ ト の送信間隔

（単位 : 秒）

net.keepalive.count サーバ 0 失敗す る ま でに通知 さ れなかっ た キー

プア ラ イブの数

net.maxfaultpub プロ キシ 100 プロ キシのキ ャ ッ シュ ・ フ ォール ト 動作

を制御する値 （単位は MB）。 単一の p4sync は net.maxfaultpub MB を超え

る フ ォール ト を pdb.lbr に発行し ませ

ん。

net.maxwait ク ラ イ アン ト 、

サーバ、

プロ キシ

な し ネ ッ ト ワー ク 接続が タ イ ム ア ウ ト す る

までの時間を示し た秒数。

サーバ全体には設定 し ない こ と が推奨

されます。 サーバに設定する と、 この制

限時間内にユーザが コ マ ン ド ラ イ ン ・

フ ォームの入力を完了 し なければな ら

な い か ら で す。 個 々 の ユ ー ザ の

P4CONFIG フ ァ イルに設定する と、その

ユーザの ワー ク ス テーシ ョ ンに対 し て

適用されます （割 り 当て られた制限時間

内にバージ ョ ン化サービ スがユーザ・ リ

ク エ ス ト に応答す る こ と のみが要求 さ

れます）。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 45

p4 configure

net.mimcheck サーバ、

プロ キシ

1 中間者攻撃に対す る ネ ッ ト ワー ク ・ セ

キ ュ リ テ ィ ー ・ レベル :

0:MitM チェ ッ ク を無効にし ます。

1: レガシー・ コ ンテキス ト でのプロ キシ

/ ブローカ接続をチェ ッ ク し ます。

2: ク ラ イ ア ン ト か ら の接続について、

TCP フ ォ ワー ド の実行がチェ ッ ク さ れ

ます。

3: ク ラ イ ア ン ト 、 プ ロ キシ、 およびブ

ローカか ら の接続について、 TCP フ ォ

ワード の実行がチェ ッ ク されます。

4: すべての接続がチェ ッ ク されます。

リ リ ース 2010.1 よ り 古いク ラ イ アン ト ・

ソ フ ト ウ ェアは接続でき ません。

5: すべての中間サービ スがチェ ッ ク さ

れます。 すべてのサービ ス ・ ユーザは有

効なチケ ッ ト を持っ ていなければな り

ません。2010.2 サーバ と中間サービ ス を

必要 と し ます。

net.reuseport サーバ 0 SO_REUSEPORT を リ ッ ス ン用ソ ケ ッ ト に設定し ます。

net.rfc3484 ク ラ イ ア ン ト 、

サーバ

0 1 であ る場合、ホス ト 名の解決に IPv4 ま

たは IPv6 のどち ら を使用するかはオペ

レーテ ィ ング ・ システムによ って決定さ

れます。

net.tcpsize ク ラ イ アン ト 、

サーバ、

プロ キシ

64K 接続時に設定される、TCP の送信および

受信のバ ッ フ ァ ・ サ イ ズ。 プ ロ キ シ な

ど、待ち時間の長い接続にはこれを増や

すこ と を検討し て く ださい。実際のバッ

フ ァ ・ サ イ ズは こ の値の大き さ であ り 、

OS で定義されます。

proxy.monitor.level プロ キシ 0 0: 監視機能は無効にされます ( デフ ォル

ト )。

1: フ ァ イル転送のみを監視し ます。

2: すべての処理を監視し ます。

3: すべての処理の全 ト ラ フ ィ ッ ク を監

視し ます。

proxy.monitor.interval プロ キシ 10 プロ キシ監視間隔を指定し ます。デフ ォ

ル ト 値は 10 秒間です。

rcs.nofsync サーバ 0 サーバがバージ ョ ン化フ ァ イ ルを RCS

フ ォ ー マ ッ ト で 書 き 込 ん だ と き に

fsync()呼び出し を無効にし、変更され

たデータ を書き込む時期を OS が決定で

き る よ う にするには、 1 に設定し ます。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

46 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 configure

rpl.compress サーバ 0 レプ リ カ / マス ターのネ ッ ト ワーク圧縮

を有効にし ます。

0: デー タ ・ ス ト リ ームは圧縮 さ れませ

ん。

1: レ プ リ カ への ア ー カ イ ブ転送 (p4 pull -u) に使用 さ れ る デー タ ・ ス ト

リ ームが圧縮されます。

2: p4 pull -u および p4 pull に使

用されるデータ ・ ス ト リ ームが圧縮され

ます。

3: すべて のデー タ ・ ス ト リ ー ム (p4 pull -u、 p4 pull、およびレプ リ カ に送られる コマン ド のデータ ・ ス トリ ーム ) が圧縮されます。

rpl.forward.all サーバ 0 データ を更新する コマン ド について、 レ

プ リ カへの転送を有効にし ます。

forwarding-replica サービ ス を提供

す る レ プ リ カ ・ サーバに必要な設定で

す。

run.users.authorize サーバ 0 設定さ れる と、 ユーザは p4 users を

実行す る前に認証を受け る必要があ り

ます。

security サーバ 0 サーバ ・ セキ ュ リ テ ィ ー ・ レベル :

0: レガシー ・ サポー ト : パス ワード は不

要で、 強度の要件は設定されません。

1: 強力なパス ワード が必要であ り 、既存

のパ ス ワ ー ド は リ セ ッ ト さ れ ま せん。

2003.2 よ り 前の ク ラ イ ア ン ト ・ ソ フ ト

ウ ェアに適合し ます。

2: 強力なパス ワード が必要であ り 、既存

の パ ス ワ ー ド は リ セ ッ ト さ れ ま す。

2003.2 以降のク ラ イ アン ト ・ ソ フ ト ウ ェ

アが必要です。

3: パス ワード は強力であ る必要があ り 、

チケ ッ ト ・ ベースの認証 (p4 login) が

必要です。

server.locks.dir サーバ server.locks

P4ROOT と相対的に指定される、サーバ・

ロ ッ ク用のデ ィ レ ク ト リ 。サーバのロ ッ

ク機能を無効にするには、 この構成変数

を disabled に設定し ます。

server.maxcommands サーバ 0 監視機能が有効であ り 、 この構成可能変

数がゼ ロ 以外の値に設定 さ れてい る場

合、 これを超え る数の同時コマン ド要求

はサービ スによ って拒否されます。

serverlog.file.N サーバ な し 構造化ロ グ ・ フ ァ イルに関連付け られた

サーバ ・ ロ グ ・ フ ァ イルの名前。 有効な

フ ァ イ ル名の リ ス ト につい て は、 p4 logparse をご覧 く ださ い。

serverlog.maxmb.N サーバ な し 構造化ロ グ ・ フ ァ イルについて、 関連す

る ロ グ ・ フ ァ イルを ローテー ト するサイ

ズ （MB）。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 47

p4 configure

オプシ ョ ン

serverlog.retain.N サーバ な し 構造化ロ グ ・ フ ァ イルについて、 あ る一

時点においてサーバ上に保持す る ロ ー

テー ト された ロ グ ・ フ ァ イルの数。

serviceUser サーバ な し あ るサーバ ( またはプロ キシ ) が複製 /

プロ キシ構成におけるマス ター・サーバ

に対し て、 または リ モー ト ・ デ ィ ポのコ

ンテキス ト において リ モー ト ・サーバに

対し て認証するサービ ス ・ ユーザ。

spec.hashbuckets サーバ 0 スペ ッ ク ・ デ ィ ポ内の フ ァ イ ルがハ ッ

シュ されるバケ ッ ト ( サブデ ィ レ ク ト リ

) の数。 デフ ォル ト では、 ハッ シュ を行

いません。パフ ォーマン スがデ ィ レ ク ト

リ ご と のフ ァ イ ル数に関係す る旧式の

フ ァ イ ルシ ス テ ムでパフ ォーマン ス が

向上する こ と があ り ます。

ssl.secondary.suite サーバ 0 デフ ォル ト では、PERFORCE の SSL サポー

ト はAES256-SHA暗号ス イー ト に基づい

ています。CAMELLIA256-SHA を使用す

るには、 このチューナブルを 1 に設定し

て く ださい。

startup.n サーバ な し PERFORCE サーバ起動時に、 startup.1からstartup.nまでのp4 pullス レ ッ

ド が生成される よ う 、 レプ リ カ ・ サーバ

用の設定を行います。

startup.n 構成変数は順番に処理 されます。 初に欠番があった箇所で処理が停止し、 欠番以降のコマンド は無視されます。

statefile サーバ state レプ リ カ ・ サーバで、 現在のジャーナル

位置 を追跡する ためにサーバに よ って

使用される フ ァ イル。

submit.unlocklocked サーバ 0 こ れを設定する と、 （ p4 lock コ マン

ド によ り ） ユーザがロ ッ ク し た作業状態

のフ ァ イルを、 p4 submit が失敗し た

後に自動的にロ ッ ク解除し ます。

zerosyncPrefix サーバ な し こ れを設定する と、 p4 sync のデフ ォ

ル ト の動作 を変更 し、 ク ラ イ ア ン ト ・

ワー ク スペース が こ の接頭語で始ま る

場合に、影響を受ける ワーク スペースへ

のすべての同期操作に p4 sync -k を

使用する もの と し、 ワーク スペースの内

容を変更し ないよ う にし ます。

set variable=value 指定された変数に、 提供された値を設定し ます。

unset variable 指定された変数の設定を解除し ます。

show P4PORT に現在指定されているサーバの現在の構成内容を示し ます。

show allservers システムに知られているすべてのサーバの構成変数を示し ます。

show variable 特定の構成変数の設定を表示し ます。

構成可能変数 ク ラ イアン ト か

サーバか

デフ ォ

ル ト 値

意味

48 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 configure

使用上の留意点

• ク ラ イ アン ト 側の動作に影響する構成可能変数は、 P4CONFIG フ ァ イルで設定する こ と も可

能です。

環境変数の代わ り に使用する場合、 一部のサーバ関連の構成可能変数は読み取 り 専用です。

p4 configure を使用し て P4ROOT または P4JOURNAL を変更する こ と はでき ません。

• 以前p4 counterによ って設定されていた多 く の設定は、p4 configure コマン ド に置き換え

られま し た。

• ほ と んどの構成可能変数への変更は、 ただちに有効にな り ます。 例えば、 monitor( p4

monitor コマン ド を有効 / 無効にする ) や security ( サーバ・セキ ュ リ テ ィ ・レベルを設定す

る ) などの構成可能変数への変更を有効にする ためにサービ ス を再起動する必要はあ り ませ

ん。

P4AUTH、P4PORT、複製環境において使用される startup.n 構成可能変数、net.tcpsize、お

よび net.backlog を変更し た場合は、 再起動が必要です。

リ リ ース 2011.1 では、 p4 admin restart によ ってサーバの再起動が可能にな り ま し た。

サーバを再起動するには、 p4 admin restart を使用し ます。

• サーバは名前によ る識別が可能です。 マルチサーバの複製環境において、 サーバ名を構成可

能変数の一部 と し て指定する こ と によ って、マス ターが複数のレプ リ カの設定を制御する こ

と が可能です。 詳し く は 『システム管理者ガイ ド』 を参照し て く だ さい。

関連コ マン ド

show P4NAME -In P4NAME を使用するか P4NAME 環境変数をサーバ名に設定し て

PERFORCE サーバが起動された場合、指定されたサーバの設定を表示し

ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

すべてのカ ウ ン タ と その値の リ ス ト を表示する。 p4 counters

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 49

p4 copy

p4 copy

概要

フ ァ イルをデ ィ ポ内のあ る場所から別の場所にコ ピーし ます。

構文

p4 [g-opts] copy [options] fromFile[rev] toFilep4 [g-opts] copy [options] -b branch [-r] [toFile[rev]] ...p4 [g-opts] copy [options] -b branch -s fromFile[rev] [toFile ...]p4 [g-opts] copy [options] -S stream [-P parent] [-r][-F] [toFile[rev]...]

options: -c change -n -v -m max -q

解説

p4 copy コマン ド は、 フ ァ イルのブラ ンチまたは置き換えまたは削除によ って、 反映元フ ァ イ

ルの完全な コ ピーを指定さ れた反映先に伝播し ます。 手動で衝突解決を行 う 必要はあ り ませ

ん。以前に反映元フ ァ イルにマージ されていなかった反映先フ ァ イル内の変更は上書き されま

す。 反映先を更新するには、 フ ァ イルをサブ ミ ッ ト し ます。

オプシ ョ ン

-c change チェ ンジ リ ス ト 番号が提供される と、フ ァ イルは default チェ ンジ リ ス ト

の代わ り に番号付きの作業中チェ ンジ リ ス ト で作業状態にされます。

-n 操作をプレ ビ ューし ます。

-v 反映先フ ァ イルを同期し ません。デフ ォル ト では、p4 copy は反映先フ ァ

イルを同期し ます。 多数のフ ァ イルを処理する際に、 それらのフ ァ イル

がワーク スペース内に存在する必要がない場合、-v を指定すれば負荷 と

ネ ッ ト ワーク ・ ト ラ フ ィ ッ ク を 少にする こ と ができ ます。

-m max コ ピー対象フ ァ イルの 大数を指定し て、 処理サイ ズを制限し ます。

-b branch 反映元フ ァ イル と 反映先フ ァ イルを決定する ために使用 さ れる ブ ラ ン

チ ・ ビ ューを指定し ます。

-r [toFile[rev] ...] ブラ ンチ ・ ビ ューのマ ッ ピングを逆にし て、 反映先フ ァ イルから反映元

フ ァ イルへの反映を行います。 -b オプシ ョ ンが必要です。

-s fromFile[rev] [toFile ...]

fromFile を反映元と し て扱い、 ブラ ンチ ・ ビ ューの両側を反映先 と し

て扱います。 反映先の範囲を さ らに限定するには、 toFile パラ メ ータ

を追加指定し ます。 -r オプシ ョ ンが指定されている場合、 それを無視し

ます。 -b オプシ ョ ンが必要です。

-S stream 反映元ス ト リ ーム を指定し ます。 変更は親ス ト リ ームに コ ピー さ れま

す。

-P parent 反映元ス ト リ ームの親以外の反映先ス ト リ ームを指定し ます。-S が必要

です。

-F 反映先ストリームが反映元のコピーを受け入れるように構成されてい

ない場合、強制的にコピー操作を実行します。ストリームにおいて期待

される変更フローを決定するには、p4 istat を使用してください。

-q ク ワ イエ ッ ト ・ モード。 反映、 コ ピー、 マージの対象 と なる フ ァ イルの

リ ス ト に関する、 通常の出力 メ ッ セージを抑止し ます。 エラーまたは例

外的状態に関する メ ッ セージは表示されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

50 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 copy

使用上の留意点

使用例

関連コ マン ド

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

fromFile: 使用可 toFile: 使用不可

使用不可 fromFile には read ア ク セス

toFile には open ア ク セス

p4 copy -S //projectX/dev/... 開発ス ト リ ームの作業を メ イ ン ラ イ ンに昇格させる。

子ス ト リ ームを、 よ り 安定性の高い親ス ト リ ームの内容で更新する。 p4 merge

変更を伝播する p4 integrate

フ ァ イルの衝突を解決する。 p4 resolve

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 51

p4 counter

p4 counter

概要

持続的に使用する変数のア ク セス、 イ ン ク リ メ ン ト 、 設定、 削除を行います。

構文

p4 [g-opts] counter counternamep4 [g-opts] counter [-f] countername valuep4 [g-opts] counter [-f] -d counternamep4 [g-opts] counter [-f] -i countername

解説

カ ウ ン タは、 PERFORCE にア ク セスする ス ク リ プ ト のために継続的に使用する変数を保存し ま

す。 例えば、 PERFORCE レ ビ ュー ・ デーモンは、 後に処理されたチェ ンジ リ ス ト の番号を保

存する 1 つのカ ウ ン タ （review） を利用し ます。

p4 counter countername の形式で使用される と、 変数 countername の値が返されます。 p4

counter countername value の形式で使用される と、変数 countername の値が value に設定

されます。 変数 countername が存在し ない場合、 作成されます。

PERFORCE は、 正規の動作において change、 job、 journal の 3 つのカ ウ ン タ を使用し ます。

スーパー ・ ユーザは、 -f オプシ ョ ンを用いて これら のカ ウ ン タ を強制的に変更でき ます。 こ

れらのカ ウ ン タの変更は、 リ ス ク を伴います。 これらのカ ウ ン タの手動 リ セ ッ ト を行 う のに適

し た状況については、 『 リ リ ース ・ ノ ー ト 』 をご覧 く だ さい。

オプシ ョ ン

使用上の留意点

• カ ウ ン タが存在し なければ、 その値はゼロ と し て返されます。 カ ウ ン タ名は、 ゼロ以外の値

がセ ッ ト される まではデータベースに保存されません。

• PERFORCE が認識し ている 後のチェ ンジ リ ス ト 番号（p4 counter change の出力）は、ユー

ザに よ って生成さ れたがまだデ ィ ポにはサブ ミ ッ ト さ れていない作業中チェ ンジ リ ス ト も

含めての番号です。 チェ ンジ ・ レ ビ ュー ・ デーモンのス ク リ プ ト を作成する上で、 後にサブ ミ ッ ト さ れ た チ ェ ン ジ リ ス ト の番号 を 確認 し た い と き は、 p4 changes -m 1 -s

submitted コマン ド を実行し て く ださ い。 このコマン ド の出力の第 2 フ ィ ール ド で、番号を

確認する こ と ができ ます。

-d countername 変数 countername を PERFORCE サーバから削除し ます。

-i countername 変数 countername を 1 ずつイ ン ク リ メ ン ト し て新しい値を返し ま

す。 こ のオプシ ョ ンは必ず数値のカ ウ ン タ と共に使用し ます。

-f PERFORCE での使用のために予約されている （p4 help counters で一覧表示される） カ ウ ン タ を設定または削除し ます。

change カ ウ ン タは、 現在の値よ り も低い値に設定し てはな り ませ

ん。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list ： カ ウ ン タの値を表示する場合

review ： 新しい値を設定する場合

super ：-f オプシ ョ ンを使用する場合

52 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 counter

• リ リ ース 2010.2 よ り 前は、 セキ ュ リ テ ィ ・ レベル と モニ ター ・ レベルについて も、 それぞれ

security カ ウ ン タ と monitor カ ウ ン タによ る設定が可能でし た。 よ り 適し た方法は、 p4

configure を使用する こ と です。古いコマン ド も互換性を保つために残されていますが、 リ

リ ース 2010.2 からはバージ ョ ン ・ サービ ス を再起動し な く て も変更が反映されます。

使用例

関連コ マン ド

p4 counter mycounter 123 カ ウ ン タ mycounter の値を 123 に設定し ます。 Mycounter が

存在し ない場合は作成されます。

実行には Review 権限が必要です。

p4 counters mycounter カ ウ ン タ mycounter の値を表示し ます。Mycounter が存在し な

い場合、 値は 0 と表示されます。

実行には List 権限が必要です。

バージ ョ ン ・ サービ ス を構成する。 p4 configure

すべての構成可能変数と その値を表示する。 p4 configure show

すべてのカ ウ ン タ と その値の リ ス ト を表示する。 p4 counters

チェ ンジ リ ス ト を リ ス ト 表示し、 追跡する。 p4 review

あ る フ ァ イルを レ ビ ューでき る よ う に登録し ているすべてのユーザの一覧

を表示する。

p4 reviews

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 53

p4 counters

54 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 counters

概要

PERFORCE および関連ス ク リ プ ト によ って継続的に使用される変数の リ ス ト を表示し ます。

構文

p4 [g-opts] counters [-e nameFilter -m max]

解説

PERFORCE は、 後にサブ ミ ッ ト されたチェ ンジ リ ス ト の番号や次のジ ョ ブの番号を保存する

変数と し て、 カ ウ ン タ を使用し ます。 ユーザは、 カ ウ ン タ を使用する独自のス ク リ プ ト を生成

する こ と ができ ます。p4 counters は、現在のカ ウ ン タの リ ス ト をその値 と と もに表示し ます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

-e nameFilter nameFilter パターンに一致する カ ウ ン タの名前を一覧表示し ます。

例 ： p4 counters -e 'mycounter-*'

-m max max 個までのカ ウ ン タのみを一覧表示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

カ ウ ン タの値を参照または変更する。 p4 counter

p4 cstat

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 55

p4 cstat

概要

現在の ク ラ イ アン ト ・ ワーク スペースの変更 / 同期ステータ ス をダンプし ます。

構文

p4 [g-opts] cstat [ files ... ]

解説

p4 cstat コマン ド は必要であ るか、 既に現在の ク ラ イ アン ト ・ ワーク スペースに同期されて

いるか、 一部のみ同期されている変更を一覧表示し ます。

出力は p4 fstat コマン ド で使用される タ グ付きの形式で返されます。

... change changenum

... status have|need|partial

ク ラ イ アン ト ・ ワーク スペースにチェ ンジ 222 （つま り チェ ンジ リ ス ト 222 に同期されている）

があ る と仮定し た と き、 同期後に他のユーザが実行し た操作によ っては、 チェ ンジ 223 が必要

と な るか （チェ ンジ リ ス ト 223 にあ る どのフ ァ イルも まだ同期されていない場合）、 チェ ンジ

リ ス ト 223 の一部を同期する（チェ ンジ リ ス ト 223 の リ ビジ ョ ンの一部が同期されている場合）

必要があ る可能性があ り ます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

ス ト リ ームに必要な反映があ るかど う かチェ ッ クする p4 istat

p4 dbschema

56 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 dbschema

概要

PERFORCE データベース内の メ タデータに関する情報を レポー ト し ます。

構文

p4 [g-opts] dbschema [ tablename [ :tableversion ] ]

解説

p4 dbschema コマン ド は、PERFORCE バージ ョ ン・サービ スが メ タデータ を格納するデータベー

ス構造に関する情報を レポー ト し ます。

デフ ォル ト では、 現在のテーブルがすべてレポー ト されます。 出力を特定のテーブルに制限す

るには、PERFORCE サーバ ・ ルー ト 内の該当する db.tablename フ ァ イルの名前を使用し ます。

結果はタ グ付き出力 と し て返されます。

こ のコマン ド はシステム ・ イ ンテグレータによ る使用を想定し ています。

オプシ ョ ン

使用上の留意点

使用例

tablename 出力を指定されたテーブル名に制限し ます。

tableversion 出力を指定されたテーブル ・ バージ ョ ンに制限し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 dbschema db.protect db.protectデータベース・テーブルに関する情報を表示します。

p4 dbstat

p4 dbstat

概要

データベース ・ テーブルのサイ ズや単純な統計値を表示し ます。

構文

p4 [g-opts] dbstat [ -h ] { -a | dbtable... }p4 [g-opts] dbstat -s

解説

p4 dbstat コマン ド は PERFORCE サーバのデータベースの内部状態に関する統計情報を表示し

ます。dbtable はお使いのサーバのルー ト ・ デ ィ レ ク ト リ にあ る db.* フ ァ イルに対応し ます。

こ のコマン ド は通常、 PERFORCE テ ク ニカル ・ サポー ト と共同でデータベースの順次スキ ャ ン

によ るデ ィ ス ク シーク を測定する目的で使用されます。

サイ ズの情報を取得するには、 p4 dbstat -s を使用し ます。

オプシ ョ ン

使用上の留意点

• p4 dbstat を実行する と テーブルのスキ ャ ン中にデータベースへの書き込みア ク セス をブ

ロ ッ クする ため、 このコマン ド の使用には注意が必要です。 ほ と んどの場合、 このコマン ド

は PERFORCE テ ク ニカル ・ サポー ト と共に作業する際に使用し ます。

-a すべてのテーブルの統計情報を表示し ます。

-h リ ーフ ・ ページ間の距離を示す ヒ ス ト グ ラ ムを表示し ます。

dbtable 特定のテーブル （db.have、 db.user など） の統計値だけを表示し ます。

-s データベース ・ テーブルのフ ァ イルサイ ズを報告し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 57

p4 dbstat

58 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 dbverify

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 59

p4 dbverify

概要

データベース ・ テーブルについて、 低レベルの検証を行います。

構文

p4 [g-opts] dbverify [ -t db.tablename ] [-U]

解説

p4 dbverify コマン ド は、PERFORCE のデータベース ・ テーブルの構造上の整合性について、一

連の低レベルでのチェ ッ ク を行います。 こ のコマン ド を定期的に実行し て、 テーブルが破損し

ていないか診断し て く だ さい。

デフ ォル ト では、 現在あ るすべてのテーブルが検証されます。 コ ンピ ュータに負荷のかかる処

理と な る可能性があ る ため、大規模なシステムではユーザの操作休止時間を設ける必要があ る

かも しれません。 検証対象を特定のテーブルに限定するには、 PERFORCE サーバ ・ ルー ト 内の

該当する db.tablename フ ァ イルの名前を使用し て く だ さい。

整合性チェ ッ ク を高速化するには、 -U オプシ ョ ン を使用すればアン ロ ッ ク件数がゼロでない

テーブルが検索されます。各データベース ・テーブルにはアン ロ ッ ク件数が設定されています。

データ をテーブルに書き込む準備ができ る と、テーブルのアン ロ ッ ク件数がイ ン ク リ メ ン ト さ

れ、 テーブルがロ ッ ク されます。 書き込みが完了する と、 テーブルのロ ッ クが解除され、 アン

ロ ッ ク件数がデク リ メ ン ト されます。データ を書き込むプロセスがテーブルのロ ッ ク を解除し

ない限 り （あ るいは、 書き込み完了前にシステムが停止する など し て解除でき ない場合） 、 ア

ン ロ ッ ク件数はイ ン ク リ メ ン ト されたま まにな り ます。

ゼ ロ でないアン ロ ッ ク件数が存在する こ と が必ずし もデータ の破壊を示すわけではあ り ませ

んが （また、 アン ロ ッ ク件数がゼロであ る こ と がデータの整合性を保証するわけではない） 、

p4 dbverify -U を用いる と パフ ォーマン スへの影響が 小に抑え られます。

オプシ ョ ン

使用上の留意点

• p4 dbverify は p4d -xv と同様に機能し ます。

-t tablename 検証対象を、 指定された名前のテーブルに限定し ます。

-U 詳細レベルを低 く し て検証を行います。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 delete

p4 delete

概要

ク ラ イ アン ト ・ ワーク スペースのフ ァ イルをデ ィ ポから削除する目的で作業状態にし ます。

構文

p4 [g-opts] delete [-c changelist] [-n -k -v] file...

解説

p4 delete コマン ド は、 ク ラ イ アン ト ・ ワーク スペースのフ ァ イルをデ ィ ポから削除する目的

で作業状態にし ます。 フ ァ イルは、直ちに ク ラ イ アン ト ・ ワーク スペースから削除されますが、

対応するチェ ンジ リ ス ト が p4 submit でコ ミ ッ ト される まで、デ ィ ポからは削除されません。

削除されたフ ァ イルは、 デ ィ ポから も削除された よ う に見えますが、 同じ フ ァ イルの古い リ ビ

ジ ョ ンへのア ク セスはいつで も可能ですので、 決し て完全に削除されたわけではあ り ません。

実際には、 該当フ ァ イルの削除を示す 新 リ ビジ ョ ンが新たに生成される こ と にな り ます。p4

syncを使って該当フ ァ イルの 新 リ ビジ ョ ンを別のワーク スペースに呼び出す と、そのワーク

スペースからは該当フ ァ イルが削除されます。

削除目的で作業状態に されたフ ァ イルは、該当ワーク スペースの所有 リ ス ト には表示されませ

ん。

オプシ ョ ン

使用上の留意点

• p4 delete で ク ラ イ アン ト ・ ワーク スペースから削除されたフ ァ イルも、 p4 revert で も う

一度その ク ラ イ アン ト ・ ワーク スペースに戻し、 作業中チェ ンジ リ ス ト から除外する こ と が

でき ます。 ただし、 p4 revert は、 チェ ンジ リ ス ト がサブ ミ ッ ト される前に実行する必要が

あ り ます。

-c changelist 指定されたチェ ンジ リ ス ト に対し て、 フ ァ イルを削除目的で作業状態にし ます。

こ のオプシ ョ ンが付いていない場合、 フ ァ イルはデフ ォル ト ・ チェ ンジ リ ス ト に

リ ン ク されます。

-n フ ァ イルや メ タデータ を実際に変更せずに、 削除目的で作業状態にする フ ァ イル

をプレ ビ ューし ます。

-k 共有バージ ョ ン ・ サービ ス上のフ ァ イルを削除し ますが、 削除されたフ ァ イルの

コ ピーを ワーク スペース内に保存し ます。

-v ク ラ イ アン ト ・ ワーク スペースに同期されていないフ ァ イルを削除し ます。

こ のオプシ ョ ン を使用するには、 これら のフ ァ イルをデ ィ ポ ・ シン タ ッ ク スで指

定し ます。 そのよ う なフ ァ イルは同期されないため、 ク ラ イ アン ト ･シン タ ッ ク ス

やローカル ・ シン タ ッ ク スでは削除対象フ ァ イルの リ ス ト が不明確にな る こ と が

あ り ます。 （フ ァ イルが同期される と、 p4 delete -v file によ ってフ ァ イル

が削除目的で作業状態にな り 、 フ ァ イルがワーク スペースから削除されます。）

フ ァ イ ル集合を ワー ク ス テーシ ョ ンに転送せずに削除す る には、 p4 sync -k file を使用し た後、 p4 delete -k file を使用し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 open

60 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 delete

• PERFORCEでは、すでに作業状態になっている フ ァ イルを別のユーザも作業状態にする こ と が

でき ます。 デフ ォル ト のスキームでは、 複数のユーザが同じ フ ァ イルを同時に作業状態にし

て、 後で p4 resolve を用いてフ ァ イル衝突を解消する こ と ができ ます。 あ るユーザが作業

状態にし ている フ ァ イルを別のユーザが同時に作業状態にする こ と を防ぐには、p4 lock を

使います。 特定のフ ァ イルをすでに別のユーザが作業状態に し ている かど う かを調べる に

は、 p4 opened -a file を使います。

使用例

関連コ マン ド

p4 delete //depot/README デ ィ ポの 上位デ ィ レ ク ト リ にあ る README と い う フ ァ イルを削

除目的で作業状態にし ます。 ワーク スペースにあ る対応のフ ァ イ

ルは直ちに削除 さ れますが、 デ ィ ポの フ ァ イ ルはデフ ォ ル ト の

チェ ンジ リ ス ト がサブ ミ ッ ト される まで削除されません。

p4 delete -c 40 file カレ ン ト ・ ワーク スペースの file を削除目的で作業状態にし ま

す。 フ ァ イルは、 直ちに ク ラ イ アン ト ・ ワーク スペースか ら削除

されますが、 対応するチェ ンジ リ ス ト が p4 submit でコ ミ ッ ト

される まで、 デ ィ ポからは削除されません。

デ ィ ポに追加する フ ァ イルを作業状態にする。 p4 add

編集目的でフ ァ イルを作業状態にする。 p4 edit

すべての作業状態のフ ァ イルをデ ィ ポにコ ピーする。 p4 submit

デ ィ ポから ク ラ イ アン ト ・ ワーク スペースへフ ァ イルを読み出す。 p4 sync

新しいチェ ンジ リ ス ト を生成または編集する。 p4 change

作業状態にあ るすべてのフ ァ イルを リ ス ト 表示する。 p4 opened

フ ァ イルを非作業状態に戻す。 p4 revert

作業状態のフ ァ イルを別のチェ ンジ リ ス ト に移す。 p4 reopen

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 61

p4 depot

p4 depot

概要

デ ィ ポ仕様を生成または編集し ます。

構文

p4 [g-opts] depot depotnamep4 [g-opts] depot -d [-f] depotname p4 [g-opts] depot -o depotnamep4 [g-opts] depot -i

解説

PERFORCE バージ ョ ン化サービ スでは、 フ ァ イルをデ ィ ポ と 呼ばれる共有レポジ ト リ に格納し

ます。デフ ォル ト では、各 PERFORCE イ ン ス ト ールに 1 つずつデ ィ ポがあ り 、その名前は depot

です。

デ ィ ポを生成ま たは編集する には、 p4 depot depotname コ マン ド を使用し てフ ォーム内の

フ ィ ール ド を編集し ます。 デ ィ ポのタ イ プは local、 stream、 remote、 archive、 spec の う

ちいずれかにな り ます。

別に生成し た local のデ ィ ポはデフ ォル ト のデ ィ ポ depot と全 く 同様に使用でき ます。 例え

ば、 デ ィ ポ new のデ ィ レ ク ト リ rel2 にあ る README と い う 名前のフ ァ イルを同期するには、

ク ラ イ ア ン ト ・ ワ ー ク ス ペー ス マ ッ ピ ン グ の左側に //new/rel2/... を追加 し、 p4 sync

//new/rel2/README を実行し ます。

リ モー ト ・ デ ィ ポをお使いの場合、 PERFORCE サービ ス をホ ステ ィ ングするマシン （すなわち、

P4PORT で指定されたマシン） の設定によ り 、PERFORCE アプ リ ケーシ ョ ンが別の PERFORCE サー

ビ スから フ ァ イルを読み取る権限が与え られています。 リ モー ト ・ デ ィ ポの使用は読み取 り 専

用ア ク セスに限られます。 つま り 、 PERFORCE アプ リ ケーシ ョ ンは、 他のサーバ上のデ ィ ポに

あ る フ ァ イルを add、 edit、 delete、 または integrate する こ と はでき ません。 リ モー ト ・

デ ィ ポについて詳し く は、 『システム管理者ガイ ド』 をご覧 く だ さい。

スペッ ク ・ デ ィ ポが存在する場合、 ク ラ イ アン ト ・ ワーク スペース仕様、 ジ ョ ブ、 ブラ ンチ ・

マ ッ ピングなどのユーザ編集フ ォームに対する変更を追跡し ます。 スペッ ク ・ デ ィ ポは一つの

サーバに対 し て一つ し か作成で き ま せん。 ス ペ ッ ク ・ デ ィ ポに あ る フ ァ イ ルは自動的に

PERFORCE によ って生成され、 PERFORCE 構文は次のよ う に表記されます。

//specdepotname/formtype/objectname[suffix]

例えば、 名前が spec であ り 、 拡張子が .p4s であ る スペッ ク ・ デ ィ ポが存在する場合、 以下の

よ う にし て job000123 に対する変更履歴を取得する こ と ができ ます。

p4 filelog //spec/job/job000123.p4s

スペッ ク ・ デ ィ ポを作成し た ら、 p4 admin updatespecdepot を使用し て、 現在の ク ラ イ アン

ト 、 デ ィ ポ、 ブラ ンチ、 ラベル、 タ イプマ ッ プ、 グループ、 ユーザ、 ジ ョ ブの各フ ォーム集合

からデータ を読み込みます。 スペッ ク ・ デ ィ ポの設定について詳し く は、 『システム管理者ガ

イ ド』 をご覧 く だ さい。

アン ロード ・ デ ィ ポが存在する場合、 それは p4 unload コマン ドおよび p4 reload コマン ド

と 共に使用 さ れます。 こ れ ら の コ マン ド は、 古い、 あ ま り 使用 さ れていない ク ラ イ ア ン ト ・

ワーク スペースおよびラベルに関する メ タデータ をニア ラ イ ンの格納領域に転送する こ と に

よ ってパフ ォーマン ス を向上させる ために使用されます。 アン ロード ・ デ ィ ポの設定に関し て

詳し く は、 『システム管理者ガイ ド』 を参照し て く だ さい。

62 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 depot

アーカ イブ ・デ ィ ポは p4 archive コマン ド および p4 restore コマン ド と共に使用し、 あ ま り

頻繁にア ク セス し ない リ ビジ ョ ン （大きいバイナ リ ・ フ ァ イルなど） をオフ ラ イ ン （あ るいは

ニア ラ イ ン） で格納するのに役立ちます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Depot: 読み取 り 専用 p4 depot depotname で指定されたデ ィ ポの名前。

Owner: 書き込み可能 そのデ ィ ポを所有するユーザの名前。 デフ ォル ト では、 その

デ ィ ポを生成し たユーザの名前です。

Description: 書き込み可能 デ ィ ポの目的に関する短いコ メ ン ト 。 書き込み必須ではあ り

ません。

Type: 書き込み可能 local、 remote、 spec、 stream、 unload または archiveです。

ローカル ・ デ ィ ポは書き込み可能であ り 、 デフ ォル ト のデ ィ

ポ ・ タ イプです。

ス ト リ ーム ・ デ ィ ポ も書き込み可能ですが、 階層 と 方策が組

み込まれたブ ラ ンチ ・ タ イ プであ る ス ト リ ームが格納されま

す。

リ モー ト ・ デ ィ ポは他のサーバ上にあ るデ ィ ポを指示し てい

るので、 書き込みはでき ません。

スペ ッ ク ・ デ ィ ポが存在する場合、 それは編集されたフ ォー

ムをアーカ イブし ます。

アン ロード ・ デ ィ ポが存在する場合、 それは p4 unload コ

マン ド によ ってアン ロー ド された、 使用頻度の低い （古い ク

ラ イ アン ト ・ ワーク スペースおよびラベルに関する） メ タデー

タ を保持し ます。

アーカ イ ブ ・ デ ィ ポは使用頻度の低いコ ンテン ツ をオフ ラ イ

ンで格納する ために使用し ます。

Address: 書き込み可能 ［Type:］ が local の場合は、 subdir と入力し ます。

［Type:］ が remote の場合は、 リ モー ト ・ サーバの P4PORTア ド レ ス を入力し ます。

Suffix: 書き込み可能 ［Type:］ が spec の場合、 このフ ィ ール ド には spec デ ィ ポ

内のオブジ ェ ク ト の生成パスに付加する拡張子を設定でき ま

す .

デフ ォル ト の拡張子は .p4s です。 spec デ ィ ポ使用の際、

拡張子は必須ではあ り ませんが、 フ ァ イル拡張子を PERFORCE

サーバのバージ ョ ン化仕様に対し て設定すれば GUI ク ラ イ ア

ン ト ソ フ ト ウ ェ アのユーザが PERFORCE 仕様 と 任意のテキ ス

ト ・ エデ ィ タ と を関連付け る こ と が可能です。

［Type:］ が local または remote の場合、 このフ ィ ール ド

の設定は無視されます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 63

p4 depot

オプシ ョ ン

使用上の留意点

• p4 depot でデ ィ ポを生成し て も、 そのデ ィ ポは、 p4 add でフ ァ イルが追加される までは

デ ィ ス ク上に物理的に生成される こ と はあ り ません。

• ユーザは、p4 depot で新たに生成されたデ ィ ポがあって も、p4 protect でア ク セスのパー

ミ ッ シ ョ ンが認められる までは、 そのデ ィ ポにア ク セスする こ と はでき ません。

• リ モー ト ・デ ィ ポは remote と い う 仮想ユーザによ って ( または、リ ク エス ト の送信元と なっ

たサービ スに対し てサービ ス ・ ユーザが設定されていればそのユーザによ って） ア ク セス さ

れます。 また、 デフ ォル ト では、 どの PERFORCE イ ン ス ト ール上のどのフ ァ イルも リ モー ト

から ア ク セスでき る よ う になっています。 特定のサーバへの リ モー ト ・ ア ク セス を制限も し

く は排除するには、 p4 protect を用いて、 そのサーバのユーザ remote （またはア ク セス対

象サイ ト のサービ ス ・ ユーザ） に与え るパー ミ ッ シ ョ ンを設定し ます。

例えば、 あ る特定のサーバ上のすべてのデ ィ ポに保存さ れたすべてのフ ァ イルに対する リ

モー ト ・ ア ク セス を排除するには、 そのサーバに関するパー ミ ッ シ ョ ンを次のよ う に設定し

ます。

read user remote * -//...

リ モー ト ・ デ ィ ポはも と も と read ア ク セス専用なので、 write または super のア ク セス権

限を解除する必要はあ り ません。

Map: 書き込み可能 ［Type:］が local、spec またはarchiveの場合は、PERFORCE

サーバの P4ROOT に対するデ ィ ポ ・ サブデ ィ レ ク ト リ の相対

位置をマ ッ ピング し ます。 ワ イル ド カード 「...」 を含んでい

なければな り ません。例えば、ローカル・デ ィ ポ new の［Map:］

は new/... のよ う に記述し ます。

［Type:］ が remote の場合は、 リ モー ト ・ デ ィ ポの物理的

ネーム スペースの位置を、 例えば //depot/new/rel2/...のよ う にマ ッ ピ ング し ます。 こ のデ ィ レ ク ト リ がローカルで

見えている リ モー ト ・ デ ィ ポのルー ト と な り ます。

SpecMap: 書き込み可能 スペ ッ ク ・ デ ィ ポについて、 どのスペッ ク を保存すべき であ

るかを示す任意指定の記述であ り 、 ビ ュー形式で表現し ます。

-d depotname デ ィ ポ depotname を削除し ます。削除するデ ィ ポは、 フ ァ イルを含んでいてはな

り ません。 PERFORCE スーパー ・ ユーザは p4 obliterate でフ ァ イルを削除でき

ます。

削除するデ ィ ポが remote であって も、 やは り p4 obliterate を実行する必要

があ り ます。 フ ァ イルは削除されませんが、 削除するデ ィ ポに関し て残っている

ク ラ イ アン ト またはラベルのレ コード が除去されます。

-f デフ ォル ト では、 デ ィ ポを削除する場合は、 Map: フ ィ ール ド で指定されたデ ィ レ

ク ト リ ( 通常は P4ROOT の下にあ る ) が空であ る必要があ り ます。このデ ィ レ ク ト

リ が空でない場合でもすべてのフ ァ イルを削除するには、-f オプシ ョ ンを使用し

ます。

-i デ ィ ポ仕様を標準入力から読み込みます。

-o depotname デ ィ ポ仕様を標準出力へ書き出し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

フ ィ ールド名 タ イプ 説明

64 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 depot

サービ ス ・ ユーザも仮想ユーザ remote も PERFORCE のラ イセン ス を必要と し ません。

• お使いのサーバでサービ ス ・ ユーザによ って リ モー ト ・ デ ィ ポにア ク セスする場合は、 サー

ビ ス ・ ユーザに リ モー ト ・ デ ィ ポ提供元のサーバに対する有効なチケ ッ ト が与え られている

必要があ り ます。

• デフ ォル ト では、 ローカル ・ デ ィ ポの [Map:] フ ィ ール ド は、 使用し ているサーバのサーバ ・

ルー ト (P4ROOT) の設定値からの相対位置を示す、 デ ィ ポ名と一致するデ ィ ポ ・ デ ィ レ ク ト

リ を指し ます。デ ィ ポのバージ ョ ン管理されたフ ァ イルを別のボ リ ュームやド ラ イブに保存

するには、[Map:] フ ィ ール ド に絶対パス を指定し て く だ さい。指定するパスは、P4ROOT の

下にあ る必要はあ り ません。

• スペッ ク ・ デ ィ ポの場合、 SpecMap: フ ィ ール ド を使用し て、 どのスペッ ク をバージ ョ ン化

するかを制御でき ます。 デフ ォル ト では、 すべてのスペッ ク （//spec/...） がバージ ョ ン

化されます。プロ テ ク シ ョ ン･テーブルをバージ ョ ン化の対象から外すには、 スペッ ク ・デ ィ

ポの SpecMap: を以下のよ う に設定し ます。

スペッ ク ・ マ ッ ピングの追加または変更は、 スペッ ク ・ デ ィ ポの今後の更新に対し てのみ影

響し ます。 スペッ ク ・ デ ィ ポに既に格納済みのフ ァ イルには影響し ません。

関連コ マン ド

SpecMap: //spec/... -//spec/protect

PERFORCE サーバが認識し ているすべてのデ ィ ポの リ ス ト を参照する。 p4 depots

新しいデ ィ ポにフ ァ イルを入れる。 p4 add

既存の ク ラ イ アン ト ・ ワーク スペースか ら新しいデ ィ ポへのマ ッ ピ ングを

デ ィ ポに追加する。

p4 client

デ ィ ポから 1 つのフ ァ イルのあ ら ゆる痕跡を除去する。 p4 obliterate

デ ィ ポへの リ モー ト ・ ア ク セス を制限する。 p4 protect

フ ァ イルをアーカ イブ ・ デ ィ ポにアーカ イブし ます。 p4 archive

フ ァ イルをアーカ イブ ・ デ ィ ポから リ ス ト ア し ます。 p4 restore

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 65

p4 depots

66 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 depots

概要

PERFORCE バージ ョ ン ・ サービ スが認識し ている全デ ィ ポの リ ス ト を表示し ます。

構文

p4 [g-opts] depots

解説

PERFORCE サービ スが認識し ている全 リ モー ト およびローカル ・ デ ィ ポが、 次のフ ォーマ ッ ト

で表示されます。

Depot name date type address map description

ただし、 name、 date、 type、 address、 map、 description の定義は、 p4 depot のフ ォーム

の定義 と同じです。

オプシ ョ ン

使用上の留意点

関連コ マン ド

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

リ モー ト ・ デ ィ ポまたは新しいローカル ・ デ ィ ポを生成する。 p4 depot

あ る フ ァ イルの痕跡をすべてデ ィ ポから取 り 除 く 。 p4 obliterate

p4 describe

p4 describe

概要

チェ ンジ リ ス ト およびそのチェ ンジ リ ス ト に含まれる フ ァ イルに関する情報を表示し ます。

構文

p4 [g-opts] describe [ -dflags -s -S -f -O ] changelist...

解説

p4 describe は、 チェ ンジ リ ス ト の詳細を表示し ます。 出力には、 チェ ンジ リ ス ト 番号、 チェ

ンジ リ ス ト 作成者、 ク ラ イ アン ト ・ ワーク スペース名、 チェ ンジ リ ス ト 作成日、 チェ ンジ リ ス

ト のコ メ ン ト が含まれます。

チェ ンジ リ ス ト が submitted （サブ ミ ッ ト 済） であれば、 デフ ォル ト の出力には影響を受けた

フ ァ イルの リ ス ト と それらのフ ァ イルを前の リ ビジ ョ ン と比較し た差分が含まれます。

チェ ンジ リ ス ト が pending （作業中） の場合は、 出力にその旨を示すフ ラ グが付き、 作業中

フ ァ イルの リ ス ト が表示されます。（フ ァ イルはまだデ ィ ポにサブ ミ ッ ト されていないため、作

業中チェ ンジ リ ス ト に対する差分は表示されません。）

p4 describeコマン ド はチェ ンジ リ ス ト がpublicであ るかrestrictedであ るかに従って出力

内容を制限し ます。 restricted タ イ プのサブ ミ ッ ト 済または保留状態のチェ ンジ リ ス ト は、

そのチェ ンジ リ ス ト を所有し ているか、 チェ ンジ リ ス ト 内の 1 つ以上のフ ァ イルに list 権限

を持っていない限 り 、 出力されません。 restricted タ イプの作業中 ( ただし保留解除された )

チェ ンジ リ ス ト は、 その所有者にのみ表示されます。 制限付きチェ ンジ リ ス ト の表示権限がな

い場合は、 チェ ンジ リ ス ト の説明の代わ り に "no permission" と い う メ ッ セージが表示されま

す。 PERFORCE 管理者は -f オプシ ョ ンを使用する こ と によ り 、 こ の動作をオーバーラ イ ド し て

制限付きチェ ンジ リ ス ト を表示する こ と ができ ます。

デフ ォル ト のチェ ンジ リ ス ト に対し ては p4 describe を実行でき ません。

p4 describe コマン ド は、p4 に組み込まれた比較サブルーチンを使用し ます。環境変数 P4DIFF

はこ のコマン ド に全 く 影響し ません。

オプシ ョ ン

-f 制限付きチェ ンジ リ ス ト の説明を強制的に表示し ます。 こ のオプシ ョ ンの使用に

は admin 権限が必要です。

-O チェ ンジ リ ス ト の番号がサブ ミ ッ ト 時に変更されていて、 元のチェ ンジ リ ス ト 番

号しか知ら ない場合には、 -O および元のチェ ンジ リ ス ト 番号を使用すれば、 その

チェ ンジ リ ス ト の情報を示すこ と ができ ます。

-s フ ァ イルの差分を含まない短縮された出力を表示し ます。

-S 指定されたチェ ンジ リ ス ト に関する保留されたフ ァ イルを、前のデ ィ ポ・ リ ビジ ョ

ン と の差分も含めて表示し ます。

-dflags 標準的な UNIX の差分オプシ ョ ンの 1 つで差分ルーチンを実行し ます。使用可能な

オプシ ョ ンについては、 次の 「使用上の留意点」 のセ ク シ ョ ンをご覧 く ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 67

p4 describe

使用上の留意点

p4 describe がサポー ト し ている差分オプシ ョ ン

関連コ マン ド

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 read

ただ し、 p4 describe -s には

list

オプシ ョ ン 意味

-dn RCS 形式。 フ ァ イルに対し て行われた追加および削除 と、 関連し た行範囲を表示し

ます。

-dc[num] context 形式。 変更された行番号の範囲と、 その周辺 num 行分を表示し ます。

-ds 要約 （summary） 。 追加、 削除および変更されたかたま り （チャ ン ク） と行の数を表

示し ます。

-du[num] unified 形式。 追加および削除された行を、 patch(1) ユーテ ィ リ テ ィ に適し た内容

で num 行分表示し ます。

-dl 差分を発見し た と きに行末識別 （CR/LF） を無視し ます。

-db 空白文字の変更を無視し ます。 このオプシ ョ ンは -dl を含みます。

-dw 空白文字を完全に無視し ます。 このオプシ ョ ンは -dl を含みます。

チェ ンジ リ ス ト の リ ス ト を参照する。 p4 changes

作業状態にあ る全フ ァ イルの リ ス ト を参照する。 p4 opened

デ ィ ポに保存されている 2 つのフ ァ イルの リ ビジ ョ ンを比較する。 p4 diff2

ク ラ イ アン ト 内で変更されたフ ァ イルを、 デ ィ ポに保存されている フ ァ イ

ルの リ ビジ ョ ン と比較する。

p4 diff

68 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 diff

p4 diff

概要

ク ラ イ アン ト ・ ワーク スペースのフ ァ イルをデ ィ ポ内の リ ビジ ョ ン と比較し ます。

構文

p4 [g-opts] diff [-dflags -f -m max -sa -sb -sd -se -sr -sl -t] [file[rev#]...]

解説

p4 diff は、 ユーザのワーク ステーシ ョ ン上で差分プロ グ ラ ムを実行し、 ワーク スペース内の

フ ァ イルをデ ィ ポに保存されている リ ビジ ョ ン と比較し ます。

こ のコマン ド はフ ァ イル引数を付ける こ と ができ ます。引数には リ ビジ ョ ン指定子を含める こ

と がで き ます。 引数に リ ビジ ョ ン指定子が含まれている と、 ク ラ イ アン ト と 指定さ れた リ ビ

ジ ョ ン と の差分を調べる こ と ができ ます。 引数に リ ビジ ョ ン指定子が含まれていない場合、 ク

ラ イ アン ト ・ ワーク スペースのフ ァ イルは、 現在の編集元の リ ビジ ョ ン （通常は 新 リ ビジ ョ

ン） と比較されます。 いずれの場合で も、 ク ラ イ アン ト のフ ァ イルはコマン ド edit で作業状

態に さ れていなければな り ません。 ま たは、 ク ラ イ アン ト のフ ァ イルが 後に同期し た リ ビ

ジ ョ ン以外の リ ビジ ョ ンに対し て、 こ の比較が行われなければな り ません。

フ ァ イル引数にワ イル ド カード が含まれている場合は、 そのフ ァ イル ・ パターンに適合するす

べての作業状態のフ ァ イルについて差分を調べられます。 フ ァ イル引数が与え られていない場

合には、すべての作業状態のフ ァ イルについてデ ィ ポの対応する フ ァ イル と の差分を調べられ

ます。

デフ ォル ト では、 p4 コマン ド ラ イ ン ・ アプ リ ケーシ ョ ンに組み込まれた差分プロ グ ラ ムが使

用されます。 この差分プロ グ ラ ムを外部の差分プロ グ ラ ムに切 り 替え るには、 その新しいプロ

グ ラ ムを指すよ う に P4DIFF 環境変数を設定し ます

オプシ ョ ン

-f ク ラ イ アン ト ・ フ ァ イルがコマン ド edit で作業状態にされていない場合でも、差

分比較を強制し ます。

-dflags オプシ ョ ンを基本差分ルーチンに渡し ます。 （詳し く は後の 「使用上の留意点」 の

セ ク シ ョ ンをご覧 く ださい。）

-m max max 個までの差分 （またはステータ ス） のみを一覧表示し ます。 ただし、 -s オプ

シ ョ ンが使用されている場合は -m オプシ ョ ンは無視されます。

-sa デ ィ ポに保存されている リ ビジ ョ ン と 異な る作業状態のフ ァ イルまたは行方不明

の作業状態のフ ァ イルの名前だけを表示し ます。

-sb 衝突解決済みであ り 、 反映目的で作業状態に されているが、 衝突解決後に変更さ

れている フ ァ イルの名前だけを表示し ます。

-sd ク ラ イ アン ト ・ ワーク スペース内にはないがデ ィ ポ内にはあ る、 作業状態にない

フ ァ イルの名前だけを表示し ます。

-se デ ィ ポに保存されている リ ビジ ョ ン と 異な る、 ク ラ イ アン ト ・ ワーク スペース内

の作業状態にないフ ァ イルの名前だけを表示し ます。

-sr デ ィ ポに保存されている リ ビジ ョ ン と 一致する、 ク ラ イ アン ト ・ ワーク スペース

内の作業状態にあ る フ ァ イルの名前だけを表示し ます。

-sl file... 作業状態で な いすべ て の file がデ ィ ポ と 比較 さ れ、 same、 diff、 ま た は

missing のステータ ス と共に一覧表示されます。

-f と -sl の両方を使用する と、 編集目的で作業状態にされたフ ァ イルも比較さ

れ、 そのステータ スが一覧表示されます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 69

p4 diff

使用上の留意点

• p4 diff がサポー ト し ている差分オプシ ョ ン

• 差分プロ グ ラ ムに複数のオプシ ョ ンを渡す場合は、次の例のよ う にそれらのオプシ ョ ンを ま

と めます。

p4 diff -dub file

こ の例では、 空白文字の変更を無視する unified 形式の差分が指定されます。

• patch(1) で使用する ために -du オプシ ョ ンで生成される UNIFIED 形式の差分のヘッ ダ行に

は、 ローカル・ シン タ ッ ク スではな く PERFORCE シン タ ッ ク スでフ ァ イル名が表示されます。

• リ ビジ ョ ンがフ ァ イル指定に含まれている場合は、フ ァ イルがチェ ンジ リ ス ト で作業状態で

あ るかど う か、またはワーク スペースが指定された リ ビジ ョ ンに同期されているかど う かに

かかわらず、 -s オプシ ョ ンによ ってフ ァ イルが比較されます。

使用例

-t フ ァ イルが text タ イプでない場合でも リ ビジ ョ ンの差分比較を行います。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧し て く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用不可 read

オプシ ョ ン 意味

-dn RCS 形式。 フ ァ イルに対し て行われた追加および削除 と、 関連し た行範囲を表示し

ます。

-dc[num] context 形式。 変更された行番号の範囲と、 その周辺 num 行分を表示し ます。

-ds 要約 （summary） 。 追加、 削除および変更されたかたま り （チャ ン ク） と行の数を表

示し ます。

-du[num] unified 形式。 追加および削除された行を、 patch(1) ユーテ ィ リ テ ィ に適し た内容

で num 行分表示し ます。

-dl 差分を発見し た と きに行末識別 （CR/LF） を無視し ます。

-db 空白文字の変更を無視し ます。 このオプシ ョ ンは -dl を含みます。

-dw 空白文字を完全に無視し ます。 このオプシ ョ ンは -dl を含みます。

p4 diff file#5 フ ァ イル file の ク ラ イ アン ト ・ ワーク スペースの リ ビジ ョ

ン とデ ィ ポに保存されている リ ビジ ョ ン 5 を比較し ます。

p4 diff @1999/05/22 ク ラ イ アン ト ・ ワーク スペースのすべての作業状態のフ ァ イ

ルを、1999 年 5 月 22 日午前 0 時の時点でデ ィ ポに保存されて

いた リ ビジ ョ ン と比較し ます。

p4 diff -du file フ ァ イル file に関する比較を実行し、 patch(1) ユーテ ィ

リ テ ィ に適し た形式で出力し ます。

70 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 diff

関連コ マン ド

p4 diff -sr | p4 -x - revert 作業状態にあって変更されていないフ ァ イルをすべて取 り 消

し ます。

こ の例では、p4 revert -a と は異な り 、ク ラ イ アン ト ・ ワー

ク スペースのフ ァ イルの内容が、 デ ィ ポのフ ァ イルの内容 と

一致し ていれば元に戻 り ます。 し たがって、 衝突解決済みで

あって も、 デ ィ ポの内容と一致し ている場合を含みます。

初のコマン ド が作業状態にあって変更されていないフ ァ イ

ルをすべて表示し、 第 2 のコマン ド が （p4 -x を実行し、 “-”

と し て省略されている引数を標準入力から 1 行につき 1 つず

つ受け取 り ） リ ス ト ア ッ プされた各フ ァ イルを取 り 消し ます。

（これは UNIX の場合のコマン ド で、 パイプを使用し ます。 ほ

と んどのオペレーテ ィ ング ・ シス テムは、 上記の動作を連続

し て実行する同等の仕組みを備えています。）

p4 に付ける -x オプシ ョ ンについて さ らに詳し く は、「グ ロー

バル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

デ ィ ポのフ ァ イルの 2 つの リ ビジ ョ ンを比較する。 p4 diff2

1 つのフ ァ イルの全内容を参照する。 p4 print

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 71

p4 diff2

p4 diff2

概要

デ ィ ポのフ ァ イルの 2 つの リ ビジ ョ ンを比較し ます。

構文

p4 [g-opts] diff2 [-dflags -q -t -u] file1[rev] file2[rev] p4 [g-opts] diff2 [-dflags -q -t -u] -b branch [[fromfile[rev]] tofile[rev]]

p4 [g-opts] diff2 -S stream [-P parent] [[fromFile[rev]] toFile[rev]]

解説

p4 diff2 は、 PERFORCE サービ スに組み込まれた差分ルーチンを使用し て、 デ ィ ポ内のフ ァ イ

ルの 2 つの リ ビジ ョ ンを比較し ます。 これらの リ ビジ ョ ンは、 通常は同じ フ ァ イルの 2 つの

バージ ョ ンですが、 全 く 別々のフ ァ イルの リ ビジ ョ ンであ る こ と も可能です。 フ ァ イル ・ リ ビ

ジ ョ ンがフ ァ イル引数と し て明示されていない場合は、 新 リ ビジ ョ ンが使用されます。

p4 diff2は環境変数P4DIFFによ って指定された差分プロ グ ラ ムを使用し ません。p4 diff2が

使用する差分アルゴ リ ズムは、共有 PERFORCE サーバのホ ス ト ・マシン上で実行され、常にサー

ビ スに組み込まれた差分ルーチンを使用し ます。

フ ァ イルを特定する代わ り に、 フ ァ イル ・ パターンを引数に指定する こ と ができ、 リ ビジ ョ ン

指定子も使えます。 こ のため、 PERFORCE は与え られたパターンに適合する個々のフ ァ イルの

組について、 何度も差分比較を実行でき ます。 p4 diff2 にフ ァ イル ・ パターンを付けて実行

する場合は、 ク ォーテーシ ョ ン ・ マーク またはバッ ク ス ラ ッ シ ュ を用いてフ ァ イル ・ パターン

を OS シェルからエス ケープし、 2 つのフ ァ イル ・ パターンの中のワ イル ド カード を一致させ

て く ださ い。

PERFORCE は、 次のよ う な形式のヘッ ダが前に付加された UNIX の差分フ ォーマ ッ ト で差分を提

示し ます。

==== file1 (filetype1) - file2 (filetype2) ==== summary

summary の取 り 得る値 と その位置は次の とお り です。

• content: フ ァ イル ・ リ ビジ ョ ンの内容が異な り ます。

• types: リ ビジ ョ ンの内容は同じですが、 フ ァ イルタ イプが異な り ます。

• identical: リ ビジ ョ ンの内容も フ ァ イルタ イプも同じです。

file1またはfile2のいずれかが指定の リ ビジ ョ ンに存在し ない場合は、ヘッ ダのsummaryの位

置に <none> と表示されます。

オプシ ョ ン

-q 差分比較の出力を 低限に抑え ます。 ヘッ ダのみを表示

し ます。file1 と file2 が同一であ る場合には、出力に

「file1 - no differing files」 と しか表示し ませ

ん。

-dflags 差分ルーチンを標準UNIX差分オプシ ョ ンのいずれかで実

行し ます。 標準差分オプシ ョ ンの種類については、 後の

「使用上の留意点」 のセ ク シ ョ ンをご覧 く ださい。

-b branch from[rev] to[rev] ブラ ンチ・マ ッ ピングを用いて 2 つのブラ ンチされたコー

ド ラ イ ン の フ ァ イ ルの差分比較を行い ます。 比較す る

フ ァ イルは、 from または to のフ ァ イル指定によ る フ ァ

イル ・ パターンで制限する こ と ができ ます。

72 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 diff2

使用上の留意点

• p4 diff2 がサポー ト し ている差分オプシ ョ ン

• 差分プロ グ ラ ムに複数のオプシ ョ ンを渡す場合は、次の例のよ う にそれらのオプシ ョ ンを ま

と めます。

p4 diff2 -dub file1 file2

こ の例では、 空白文字の変更を無視する unified 形式の差分が指定されます。

• patch(1) を使用する ために -du オプシ ョ ンで生成される unified 形式のヘッ ダ行では、差分

フ ァ イルを PERFORCE シン タ ッ ク スで表示し ます。 ローカル・ シン タ ッ ク スではあ り ません。

• p4 diff2 を binary フ ァ イルの差分比較に使用し た と きは、 一致し なければ、

... files differ ...

と い う 行が表示されます。

• オプシ ョ ン -b branch [fromfile[rev] [tofile[rev]] ] は、一見する と不適切のよ う に

見えます。 ブラ ンチ ・ マ ッ ピングは fromfiles から tofiles までマ ッ ピング し ているので、

fromfile と tofile の両方のフ ァ イル ・ パターンを指定する必要はあ り ません。 しかし、 こ

の構文を使 う と、fromfile のフ ァ イル・パターン と tofile の リ ビジ ョ ン、または fromfile

の リ ビジ ョ ン と tofile のフ ァ イル ・ パターンを指定する こ と が可能にな り ます。

• フ ァ イル内の RCS キーワード は p4 diff2 によ って拡張されません。

-S stream [-P parent] ス ト リ ーム をその親 と 比較し ます。 設定された親以外の

ス ト リ ーム と比較する場合は、 -p を指定し ます。

-t フ ァ イルが text タ イプでない場合も、 リ ビジ ョ ンの差

分比較を行います。

-u 追加行 と 削除行を表示し て統一出力フ ォーマ ッ ト を生成

し、 データ内容を patch(1) ユーテ ィ リ テ ィ に対応させ

ます。 相違箇所のあ る フ ァ イルのみが含まれます。 フ ァ

イル名および日付は PERFORCE 構文のま まで示されます。

g_opts 「グ ローバル・オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用不可 比較する双方のフ ァ イルに対し て

read ア ク セス権限が必要

オプシ ョ ン 意味

-dn RCS 形式。 フ ァ イルに対し て行われた追加および削除 と、 関連し た行範囲を表示し

ます。

-dc[num] context 形式。 変更された行番号の範囲と、 その周辺 num 行分を表示し ます。

-ds 要約 （summary） 。 追加、 削除および変更されたかたま り （チャ ン ク） と行の数を表

示し ます。

-du[num] unified 形式。 追加および削除された行を、 patch(1) ユーテ ィ リ テ ィ に適し た内容

で num 行分表示し ます。

-dl 差分を発見し た と きに行末識別 （CR/LF） を無視し ます。

-db 空白文字の変更を無視し ます。 このオプシ ョ ンは -dl を含みます。

-dw 空白文字を完全に無視し ます。 このオプシ ョ ンは -dl を含みます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 73

p4 diff2

使用例

関連コ マン ド

p4 diff2 -ds file#1 file フ ァ イル file の 初の リ ビジ ョ ン と その 新 リ

ビジ ョ ン を比較し、 どのかた ま り （チャ ン ク） が

追加さ れ、 削除さ れ、 変更されたかのサマ リ を表

示し ます。

p4 diff2 file@34 file@1998/12/04

チェ ンジ リ ス ト 34 のサブ ミ ッ ト 後にデ ィ ポにあっ

た file の リ ビジ ョ ン と、 1998 年 12 月 4 日午前 0

時時点のデ ィ ポの リ ビジ ョ ンの差分比較を行いま

す。

p4 diff2 //depot/rel1/... //depot/rel2/...#4

//depot/rel1 のすべてのフ ァ イ ルの 新 リ ビ

ジ ョ ン と //depot/rel2のすべてのフ ァ イルの リ

ビジ ョ ン 4 を比較し ます。

p4 diff2 //depot/rel1/* //depot/rel2/...

認め られていません。 両方のフ ァ イル ・ パターン

のワ イル ド カード が一致する必要があ り ます。

p4 diff2 -b branch2 //depot/rel2/...#2 @50

//depot/rel2/... のフ ァ イルの リ ビジ ョ ン 2

と、 そ こ か ら ブ ラ ンチ ・ マ ッ ピ ング branch2 に

よ ってブ ラ ンチ されたフ ァ イルのチェ ンジ リ ス ト

50 における リ ビジ ョ ン と を比較し ます。

ク ラ イ アン ト ・ ワーク スペースのフ ァ イル と デ ィ ポに保存されたフ ァ イル

の リ ビジ ョ ンを比較する。

p4 diff

フ ァ イルの全内容を参照する。 p4 print

74 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 dirs

p4 dirs

概要

指定されたデ ィ ポ ・ デ ィ レ ク ト リ 直下のサブデ ィ レ ク ト リ を リ ス ト 表示し ます。

構文

p4 [g-opts] dirs [-C -D -H] [-S stream] depot_directory[revRange]...

解説

p4 dirs は、 引数と し て指定された、 デ ィ ポ ・ デ ィ レ ク ト リ 直下のサブデ ィ レ ク ト リ を検索す

る ために使用し ます。 デ ィ レ ク ト リ の引数はデ ィ ポ ・ シン タ ッ ク ス またはローカル ・ シン タ ッ

ク スで指定し ます。 また、 末尾を ワ イル ド カー ド 「*」 にし ます。

p4 dirs は、 引数で指定されたデ ィ レ ク ト リ 直下のサブデ ィ レ ク ト リ だけを表示し ます。 1 つ

のデ ィ レ ク ト リ のサブデ ィ レ ク ト リ を再帰的にすべて表示するには、p4 dirs を繰 り 返し実行

し ます。

デフ ォル ト では、削除されていないフ ァ イルを少な く と も 1 つ含むサブデ ィ レ ク ト リ だけが返

信されます。 削除されたフ ァ イルしか含まないサブデ ィ レ ク ト リ を含めるには、 -D オプシ ョ

ンを使用し ます。

こ のコマン ド はス ク リ プ ト の中で使用される こ と を意図し た ものであ り 、 コマン ド ラ イ ンでの

使用される こ と はほ と んどあ り ません。

オプシ ョ ン

使用上の留意点

• デ ィ レ ク ト リ 引数に リ ビジ ョ ン指定子ま たは リ ビジ ョ ン範囲を含め る と、 返信さ れる サブ

デ ィ レ ク ト リ は、 与え られた指定子に合致する フ ァ イル ・ リ ビジ ョ ンを少な く と も 1 つ含む

ものだけにな り ます。

• PERFORCE はデータベースの中でデ ィ レ ク ト リ を追跡し ません。つま り 、サブデ ィ レ ク ト リ の

値は検索されるのではな く 、 計算されます。 ワ イル ド カー ド 「...」 がサポー ト されていな

いこ と など、 p4 dirs の実装に変わった と こ ろがあ るのはそのためです。

-C 現在の ク ラ イ アン ト ・ ビ ューを通し てマ ッ ピ ン グ さ れるデ ィ レ ク ト リ だけを表示し ま

す。

-D 削除済フ ァ イルしか含まないサブデ ィ レ ク ト リ も含めます。 デフ ォル ト では、 これらの

サブデ ィ レ ク ト リ は表示されません。

-H 現在のク ラ イ アン ト ・ ワーク スペースの p4 have リ ス ト に表示される フ ァ イルを含む

デ ィ レ ク ト リ だけを表示し ます。

-S stream 指定されたス ト リ ームにマ ッ ピング されたデ ィ レ ク ト リ を一覧表示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 75

p4 dirs

使用例

関連コ マン ド

p4 dirs //depot/projects/* //depot/projects の直下のサブデ ィ レ ク ト リ すべての

リ ス ト を返信し ます。

p4 dirs //depot/a/* //depot/b/*

//depot/a と //depot/bの直下のサブデ ィ レ ク ト リ すべ

ての リ ス ト を返し ます。

p4 dirs //depot/... ワ イル ド カード 「...」 は p4 dirs によ ってサポー ト され

ていません。

特定の基準に適合するすべてのフ ァ イルを リ ス ト 表示する。 p4 files

PERFORCE バージ ョ ン化サービ スが認識し ているすべてのデ ィ ポを リ ス ト 表

示する。

p4 depots

76 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 diskspace

p4 diskspace

概要

サーバのデ ィ ス ク容量に関する情報を表示し ます。

構文

p4 [g-opts] diskspace [P4ROOT|P4JOURNAL|P4LOG|TEMP|journalPrefix|depot]

解説

サーバの現在のデ ィ ス ク空き容量に関する概要情報を表示し ます。

p4 diskspace の出力形式は以下の とお り です。

name (type type) : xxxGB free, yyyGB used, zzzGB total (ff% full)

name には、P4ROOT、P4JOURNAL、P4LOG、TEMP、 デフ ォル ト 設定以外の PERFORCE ジ ャーナル ・

フ ァ イルの場所、 または PERFORCE デ ィ ポ名のいずれかを指定でき ます。 フ ァ イルシステムの

type は、 オペレーテ ィ ング ・ システムによ って報告される タ イプです。

引数が指定されていない場合、すべてのオブジェ ク ト についてデ ィ ス ク空き容量の情報が表示

されます。

オプシ ョ ン

使用上の留意点

• デフ ォル ト では、PERFORCE は P4ROOT、P4JOURNAL、P4LOG、または TEMP を保持する フ ァ イル

システムの空き容量が 10MB を下回る と コマン ド を拒否し ます。 この動作を変更するには、

filesys.P4ROOT.min （および関連するその他の） 構成可能変数に希望の限度を設定し て く

ださい。

PERFORCE バージ ョ ン ・ サービ ス を動作させるユーザ ・ アカ ウ ン ト にデ ィ ス ク ・ ク オータが

適用される場合、 当該フ ァ イルシ ス テムに実際に残っている物理的な空き容量にかかわ ら

ず、 filesys.*.min 構成可能変数にはそれらの ク オータが反映されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

P4ROOT P4ROOT を保持する フ ァ イルシステムに使用可能なデ ィ ス ク空き容量を報告し ま

す。

P4JOURNAL P4JOURNALを保持する フ ァ イルシステムに使用可能なデ ィ ス ク空き容量を報告し

ます。

P4LOG P4LOG （サーバ ・ ロ グ） を保持する フ ァ イルシス テムに使用可能なデ ィ ス ク空き

容量を報告し ます。

TEMP 一時フ ァ イルを保持する フ ァ イルシス テムに使用可能なデ ィ ス ク空き容量を報告

し ます。 定義されていない場合は、 Windows では P4ROOT、 UNIX では /tmp を使

用し ます。

journalPrefix 非標準的なジ ャーナル格納場所を保持する フ ァ イルシス テムに使用可能なデ ィ ス

ク空き容量を報告し ます。

depot 指定し たデ ィ ポ depot を保持する フ ァ イルシステムに使用可能なデ ィ ス ク空き容

量を報告し ます。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 super

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 77

p4 diskspace

• p4 df は p4 diskspace と同様に機能し ます。

関連コ マン ド

デ ィ ス ク空き容量が少ない と きの PERFORCE の動作を構成する。 p4 configure

78 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 edit

p4 edit

概要

ク ラ イ アン ト ・ ワーク スペース内で、 編集を目的 と し てフ ァ イルを作業状態にし ます。

構文

p4 [g-opts] edit [-c changelist] [-k] [-n] [-t type] file...

解説

p4 edit は、 ク ラ イ アン ト ・ ワーク スペース内で、 編集を目的 と し てフ ァ イルを作業状態にし

ます。 指定さ れた フ ァ イルはチェ ンジ リ ス ト に リ ン ク さ れます。 デ ィ ポのフ ァ イルは、 その

チェ ンジ リ ス ト が p4 submit にコ ミ ッ ト される までは変更されません。

PERFORCE は、 ローカル OS のパー ミ ッ シ ョ ンを制御し ます。 p4 edit が実行される と、 指定さ

れたフ ァ イルについて OS の write パー ミ ッ シ ョ ンが付加されます。

p4 edit によ って編集用に作業状態に されたフ ァ イルがデ ィ ポにサブ ミ ッ ト されて も、デ ィ ポ

に存在する そのフ ァ イルの リ ビジ ョ ンは置き換え られません。 その代わ り 、 それまでの リ ビ

ジ ョ ンをア ク セス可能な状態で残しつつ、 新しい リ ビジ ョ ンが生成され、 連番で次の リ ビジ ョ

ン番号が割 り 当て られます。 デフ ォル ト では、 フ ァ イルを参照する コマン ド はすべて こ の も

新しい リ ビジ ョ ン （ 新 リ ビジ ョ ン） を対象と し ます。

デフ ォル ト では、 指定さ れたフ ァ イルはデフ ォル ト のチェ ンジ リ ス ト に追加さ れます。 別の

チェ ンジ リ ス ト を指定するには、 -c オプシ ョ ンを使用し ます。 （あ るいは、 デフ ォル ト のチェ

ンジ リ ス ト から番号付チェ ンジ リ ス ト にフ ァ イルを移動するには、 p4 change コマン ド を使用

し ます。）

すでに編集目的で作業状態に さ れている フ ァ イルをあ るチェ ンジ リ ス ト か ら別のチェ ンジ リ

ス ト に移動するには、 p4 reopen を使用し て く だ さい。

オプシ ョ ン

使用上の留意点

-c changelist 指定されたチェ ンジ リ ス ト に対し てフ ァ イルを編集目的で作業状態にし ます。 こ

のオプシ ョ ンが付いていない と、 デフ ォル ト のチェ ンジ リ ス ト に対し てフ ァ イル

が作業状態にな り ます。

-t type 新しいフ ァ イル ・ リ ビジ ョ ン を、 同じ フ ァ イルのそれまでの リ ビジ ョ ンのタ イ プ

をオーバーラ イ ド し て、 指定のタ イ プで保存し ます。 フ ァ イル編集時に、 フ ァ イ

ルタ イ プを強制的に再検出する （つま り 、 フ ァ イルが新規追加されている と き と

同様にフ ァ イルタ イプを割 り 当てる） には、 p4 edit -t auto を使用し ます。

フ ァ イルタ イプについては 「フ ァ イル ・ タ イプ」 の項を参照し て く ださい。

-k 既存のワーク スペース ・ フ ァ イルを保存し ます。 当該フ ァ イルが ク ラ イ アン ト ・

ビ ューの中にない場合でも、 編集目的の作業状態であ る もの と し てマーク し ます。

共有バージ ョ ン化サービ ス に接続 し ない状態で行っ た作業を照合する場合にの

み、 p4 edit -k を使用し ます。

-n フ ァ イルや メ タデータ を実際に変更せずに、 編集目的で作業状態にする フ ァ イル

をプレ ビ ューし ます。

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

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 open

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 79

p4 edit

指定のフ ァ イルに関する ローカル OS の write パー ミ ッ シ ョ ンは p4 edit によ って付加される

ため、 実際にフ ァ イルを編集するのはこ のコマン ド が発行されてからにな り ます。 フ ァ イル編

集のプロセスは次のよ う にな り ます。

1. p4 edit を用いて、 ク ラ イ アン ト ・ ワーク スペース内でフ ァ イルを作業状態にし ます。

2. エデ ィ タでフ ァ イルを編集し ます。

3. p4 submit でデ ィ ポへフ ァ イルをサブ ミ ッ ト し ます。

フ ァ イルの古い リ ビジ ョ ン を編集するには、 p4 sync を用いて過去に保存されていたフ ァ イ

ル ・ リ ビジ ョ ンを ク ラ イ アン ト ・ ワーク スペースに呼び出し、 p4 edit でそのフ ァ イルを編集

し ます。 こ のフ ァ イル ・ リ ビジ ョ ンは 新 リ ビジ ョ ンではないので、 p4 resolve を実行し て

からでなければ、 p4 submit でデ ィ ポに保存する こ と はでき ません。

PERFORCE は、 すでに作業状態になっている フ ァ イルを作業状態にする操作を妨げません。 デ

フ ォル ト の構成では、複数のユーザが同じ フ ァ イルを同時に編集し、p4 resolve によ ってフ ァ

イル衝突を解決する こ と が認められています。他のユーザがすでに特定のフ ァ イルを作業状態

にし ているかど う かを調べるには、 p4 opened -a file を使用し ます。

自分が既に作業状態にし ている フ ァ イルを他のユーザが操作するのを防ぐ必要があ る場合は、

p4 lock コマン ド を使用する （自分が作業状態にし ている フ ァ イルを他のユーザが編集でき る

よ う にするが、 まず自分が変更をサブ ミ ッ ト する までは、 他のユーザがフ ァ イルをサブ ミ ッ ト

でき ないよ う にする） か、 +l( 排他オープン ) フ ァ イルタ イプを使用し て他のユーザが編集目

的でフ ァ イルを作業状態にする こ と自体を防ぐ こ と ができ ます。

PERFORCE の以前のバージ ョ ンでは、 p4 edit は p4 open と呼ばれていま し た。

使用例

関連コ マン ド

p4 edit -t text+k doc/*.txt カレン ト ・ デ ィ レ ク ト リ の doc サブデ ィ レ ク ト リ で、 フ ァ イ

ル名の 後が .txt になっているすべてのフ ァ イルを、 edit用に作業状態に し ます。 こ れ ら の フ ァ イ ルはデフ ォ ル ト の

チェ ンジ リ ス ト に リ ン ク され、キーワード拡張が有効の textタ イプ と し て保存されます。

p4 edit -t +l //depotname/... デ ィ ポ内のすべてのフ ァ イルに対し、悲観的ロ ッ ク （排他オー

プン） を実施し ます。 このチェ ンジ リ ス ト のサブ ミ ッ ト 後は、

depotname と い う デ ィ ポにあ る フ ァ イルを編集で き る のは

一度に 1 ユーザのみと な り ます。

p4 edit -c 14 ... 現在の作業デ ィ レ ク ト リ のフ ァ イル・ ツ リ ーで、すべてのフ ァ

イルをedit用に作業状態にし ます。これらのフ ァ イルはtextか binary かを調べられ、 フ ァ イルの変更はチェ ンジ リ ス ト

14 に リ ン ク されます。

p4 edit status%40jan1.txt status@jan1.txt と い う 名前のフ ァ イ ルを編集のための

作業状態にし ます。

PERFORCE ワ イ ル ド カー ド と し て使用する ために予約 さ れて

いるその他の文字の指定方法の詳細については、320 ページの

「フ ァ イル名およびエンテ ィ テ ィ に関する文字の制限」 をご覧

く ださい。

追加を目的と し てフ ァ イルを作業状態にする。 p4 add

削除を目的と し てフ ァ イルを作業状態にする。 p4 delete

作業状態のフ ァ イルをすべてデ ィ ポにコ ピーする。 p4 submit

デ ィ ポのフ ァ イルを ク ラ イ アン ト ・ ワーク スペースにコ ピーする。 p4 sync

80 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 edit

新しいチェ ンジ リ ス ト を生成または編集する。 p4 change

作業状態にあ る全フ ァ イルの リ ス ト を表示する。 p4 opened

フ ァ イルを非作業状態に戻す。 p4 revert

作業状態のフ ァ イルを別のチェ ンジ リ ス ト へ移動、 またはフ ァ イルタ イプの変

更を行 う 。

p4 reopen

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 81

p4 export

p4 export

概要

ジ ャーナルまたはチェ ッ ク ポイ ン ト のレ コード を抽出し ます。

構文

p4 export -c token [-J prefix] [-f] [-l lines] [-F filter] [-T tableexcludelist] [-P filterpattern]p4 export -j token [-J prefix] [-f] [-l lines] [-F filter] [-T tableexcludelist] [-P filterpattern]p4 export -j token [-J prefix] -r [-F filter] [-T tableexcludelist] [-P

filterpattern]

解説

こ のコマン ド は、 チェ ッ ク ポイ ン ト およびジ ャーナルの メ タデータ を PERFORCE サーバから出

力し ます。 オプシ ョ ンを指定し ない場合、 レ コード はタ グ付き形式でレポー ト されます。

タ グ付き出力には ト ラ ンザク シ ョ ンの整合性を示すため、 またはジ ャーナルの終端を示すため

に、 い く つかのフ ィ ール ド が追加されます。

特定のデータベース ・ テーブルをデータのエ ク スポー ト 対象から外すには、 -T オプシ ョ ン を

使用し てデータ を除外し たいテーブルの リ ス ト を指定し ます。複数のテーブルのデータ を除外

するには、 テーブル名を スペース またはカンマで区切 り ます。 テーブル名は頭に "db." を付

け、 サーバ ・ ルー ト ・ デ ィ レ ク ト リ のデータベース ・ フ ァ イルに使用される命名規則に従わな

ければな り ません。 テーブルの除外 リ ス ト を スペースで区切った場合は、 リ ス ト を引用符で囲

む必要があ り ます。

オプシ ョ ン

-c チェ ッ ク ポイ ン ト 番号または位置 ト ーク ンを、 以下の形式で指定し ます。

checkpointnum#byteoffset

-j ジ ャーナル番号または位置 ト ーク ンを、 以下の形式で指定し ます。

journalnum/byteoffset

-f 非テキス ト のデータ タ イプが適切にフ ォーマ ッ ト される よ う に、 出力をフ ォーマ ッ ト

し ます。

-r 未加工のジ ャーナル出力を表示し ます。 こ の引数はジ ャーナルにのみ適用されます。

-J prefix ジ ャーナルのフ ァ イル名に付ける接頭語を、p4d -jc prefix と同様に指定し ます。

-l lines 出力する ジ ャーナル ・ レ コード の行数を、 指定し た lines に制限し ます。

-F filter 出力を、 指定し た filter のパターンに一致する レ コード に制限し ます。 例 : -F "table = db.configure"

-T tableexcludelist

エ ク スポー ト 対象から除外するデータベース ・ テーブル （db.have や db.client な

ど） の リ ス ト を供給し ます。 出力を指定し た filter のパターンに一致する レ コー

ド のみに制限し ます。例 ： -T db.have、db.client、-T "db.have db.client"

82 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 export

使用上の留意点

• 圧縮されたジ ャーナルまたはチェ ッ ク ポ イ ン ト はサポー ト されていません。

使用例

関連コ マン ド

-P filterpattern

出力を指定し たフ ィ ルタ ・ パターンに一致する レ コード のみに制限し ます。 複数の - P オプシ ョ ンによ り 複数のフ ィ ルタ ・ パターンを指定でき ます。

各 filterpattern は 2 つの文字と 1 つのコ ロ ンから始め、 ク ラ イ アン ト ・ フ ィ ルタ また

はデ ィ ポ ・ フ ィ ルタ を指定し て、 パターンを含めるか除外するかを以下の構文によ り

指定し ます。

･ -Pic://client/pattern - 含める ク ラ イ アン ト ・ レ コード

･ -Pxc://client/pattern - 除外する ク ラ イ アン ト ・ レ コード

･ -Pif://depot/pattern - 含めるデ ィ ポ ・ レ コード

･ -Pxf://depot/pattern - 除外するデ ィ ポ ・ レ コード

初の文字ではレ コード を含めるか除外するか ( 「i」 または 「x」 ), を指定し、 2 番

目の文字ではレ コード がク ラ イ アン ト ・ ワーク スペース関連であ るかデ ィ ポ ・ フ ァ イ

ル関連であ るか ( 「c」 または 「f」 ) を指定し ます。 コ ロ ンは区切 り 文字で、 残 り の

filterpattern は ク ラ イ ア ン ト ・ ワー ク スペース ・ ビ ューま たはデ ィ ポ ・ フ ァ イ

ル ・ パス を示し ます。

こ の フ ィ ル タ の実装 メ カ ニ ズ ム は、 p4 server フ ォ ー ム の ClientDataFilter: フ ィ ール ド および RevisionDataFilter: フ ィ ール ド に よ っ て使用 さ れる も の と

同様です。

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

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 export -T "db.have db.working" p4 export を実行し ますが、 db.have テーブル と db.working テーブルのレ コード は無視し ます。

あ るサーバから別のサーバに メ タデータ を複製する。 p4 replicate

ジ ャーナル ・ レ コー ド （およびフ ァ イルの内容） をマス ター ・ サーバか ら

レプ リ カ ・ サーバへと プルする。

p4 pull

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 83

p4 filelog

p4 filelog

概要

フ ァ イルの リ ビジ ョ ンに関する詳細情報を表示し ます。

構文

p4 [g-opts] filelog [-c change -h -i -l -L -t -m max -p -s] file[revRange]

解説

p4 filelog は、 引数と し て指定されたフ ァ イルの各 リ ビジ ョ ンの詳細を出力し ます。 少な く

と も 1つのフ ァ イルまたはフ ァ イル・パターンが引数 と し て指定されなければな り ません。フ ァ

イル指定に リ ビジ ョ ン範囲が含まれている場合、 指定された リ ビジ ョ ンのみが表示されます。

デフ ォル ト では、出力は日付の逆順で 1 リ ビジ ョ ンにつき 1 行で構成されます。各行のフ ォー

マ ッ ト は次のよ う にな り ます。

... #rev change chnum action on date by user@client (type) 'description'

ただし、

• rev は リ ビジ ョ ン番号、

• chnum はサブ ミ ッ ト されたチェ ンジ リ ス ト の番号、

• action はフ ァ イルが作業状態に された目的、すなわち add、edit、delete、branch、import、

または integrate であ り 、

ア ク シ ョ ンが import （ リ モー ト ・ デ ィ ポから の反映操作） または integrate の場合、 次

のよ う なフ ォーマ ッ ト で 2 行目の記述が表示されます。

... #integration-action partner-file

反映操作の詳細については、 p4 integrated をご覧 く ださ い。

• date はサブ ミ ッ ト の日付 （デフ ォル ト ） か、 日時 （-t オプシ ョ ン指定時）、

• user はその リ ビジ ョ ンをサブ ミ ッ ト し たユーザの名前、

• client はその リ ビジ ョ ンをサブ ミ ッ ト し た ク ラ イ アン ト ・ ワーク スペースの名前、

• type は与え られた リ ビジ ョ ンにおける フ ァ イルのタ イプ、

• description は対応するチェ ンジ リ ス ト のコ メ ン ト の 初の 30 字です。

-l オプシ ョ ンを使用し た場合、 description は、 チェ ンジ リ ス ト をサブ ミ ッ ト し た と きに

入力し た完全なチェ ンジ リ ス ト のコ メ ン ト です。 -L オプシ ョ ン を使用し た場合、 チェ ンジ

リ ス ト のコ メ ン ト は 250 文字に切 り 捨て られます。

オプシ ョ ン

-c change 指定されたチェ ンジ リ ス ト 番号でサブ ミ ッ ト されたフ ァ イルのみを表示し ます。

-h フ ァ イル名の履歴の代わ り に、 フ ァ イル内容の履歴を表示し ます。 リ ス ト 表示さ

れる リ ビジ ョ ンには、特定の リ ビジ ョ ンへ と（p4 integrate およびp4 resolve -at を使用し て） ブラ ンチまたはコ ピーされた、他のフ ァ イルの リ ビジ ョ ンが含ま

れます。 コ ピーまたはブ ラ ンチによ り 置き換え られた リ ビジ ョ ンは、 た と えそれ

らが指定された リ ビジ ョ ンの履歴にあ る場合でも表示されません。

-p -h オプシ ョ ン と共に使用する と、 昇格された タ ス ク ・ ス ト リ ームの内容は追跡さ

れません。 こ のオプシ ョ ンは、指定し た file 引数からブラ ンチされた子タ ス ク ・

ス ト リ ームが多数存在する場合に便利です。

84 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 filelog

使用上の留意点

• p4 filelog の出力は、 指定範囲の広いフ ァ イル引数で呼び出される と、 かな り 大量にな る

こ と があ る ため （例えば、p4 filelog //depot/... ではデ ィ ポのすべてのフ ァ イルの リ ビ

ジ ョ ン履歴が リ ス ト される）、p4 filelog コマン ド の出力は p4 group によ って設定される

maxresults の制限を受ける こ と があ り ます。

• -iオプシ ョ ン と -m maxrevオプシ ョ ンの両方が付いていて、フ ァ イルの 新 リ ビジ ョ ンから

maxrev の数の リ ビジ ョ ンの範囲内でブラ ンチ生成が行われている場合は、そのブラ ンチ・ポ

イ ン ト から さ らに maxrev の数だけ リ ビジ ョ ンを逆上 り 、 その間の リ ビジ ョ ン も表示されま

す。 p4 filelog -i は、 新の リ ビジ ョ ンから 50 階層の深さ までブラ ンチを追跡し ます。

どんなサイ ト で も これだけ追跡すれば十分でし ょ う 。

• 一時オブジェ ク ト ・ フ ァ イル （フ ァ イルタ イプが +Sn） の古い リ ビジ ョ ンは、 動作の部分に

purge と表示されます。

使用例

関連コ マン ド

-i ブ ラ ン チ に ま た が る フ ァ イ ル の 履 歴 を た ど り ま す。 反 映 に よ っ て （p4integrate） 生成されたフ ァ イルであれば、 PERFORCE はそのフ ァ イルの リ ビジ ョ

ンの説明を表示し、 そのブ ラ ンチ元フ ァ イルの リ ビジ ョ ン を （元フ ァ イルのブ ラ

ンチ ・ ポ イ ン ト まで） 表示し ます。 リ ネーム (p4 move) によ って継承された フ ァ イル履歴は、 -i オプシ ョ ンが使用されているか否かにかかわらず、 常に表

示されます。

-l 各 リ ビジ ョ ンの完全な説明を リ ス ト 表示し ます。

-L 各チェ ンジ リ ス ト のコ メ ン ト を 250 文字に切 り 捨て、 長い出力形式で リ ス ト 表示

し ます。

-t 日付 と同様に時刻も表示し ます。

-m max 各フ ァ イルの 新の リ ビジ ョ ンから max 数の リ ビジ ョ ンの変更のみを リ ス ト 表示

し ます。

-s 重要性の低い反映を無視し、 簡略化し た形式で表示し ます （例えば、 別の場所に

「ブラ ンチ」 または 「コ ピー」 する操作は表示されません）。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用不可 list

p4 filelog //depot/proj1/... デ ィ ポの proj1デ ィ レ ク ト リ 内の全フ ァ イルの リ ビジ ョ ン

履歴を表示し ます。

p4 filelog file1.c@100,@120 チェ ンジ リ ス ト 100 から 120 までの file1.cの リ ビジ ョ ン

履歴を表示し ます。

p4 filelog file1.c#have,#head file1.c の 新 リ ビジ ョ ンに同期し ていない場合、 後に

同期された後の リ ビジ ョ ン履歴を表示し ます。

p4 filelog file1.c file1.h ロ ー カ ル の 現在 の 作 業 デ ィ レ ク ト リ に あ る フ ァ イ ル

file1.cおよびfile1.hの リ ビジ ョ ン履歴を表示し ます。

各フ ァ イルに関する追加の情報を読み取る。 p4 files

ス ク リ プ ト に適し たフ ォーマ ッ ト でフ ァ イル情報を表示する。 p4 fstat

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 85

p4 filelog

作業状態のフ ァ イルの リ ス ト を参照する。 p4 opened

使用中の ク ラ イ アン ト ・ ワーク スペースに同期し たフ ァ イルの リ ス ト を参

照する。

p4 have

86 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 files

p4 files

概要

デ ィ ポ内のフ ァ イルに関する情報を、 フ ァ イルの内容にア ク セスする こ と な く 提供し ます。

構文

p4 [g-opts] files [-a] [-A] [-e] [-m max] file[revRange]...p4 [g-opts] files -U unloadfile...

解説

p4 files は、 引数 と し て指定されたフ ァ イル ・ パターンに適合する フ ァ イルを リ ス ト ア ッ プ

し ます。 リ ビジ ョ ン指定子が与え られていれば、 フ ァ イルのその与え られた リ ビジ ョ ンについ

ての説明が表示されます。 出力は 1 行に 1 フ ァ イルずつ、 次のフ ォーマ ッ ト で表示されます。

depot-file-location#rev - action change changelist (filetype)

ただし、

• depot-file-location はデ ィ ポのルー ト ・ デ ィ レ ク ト リ に対する フ ァ イルの相対的位置、

• rev はフ ァ イルの 新 リ ビジ ョ ンの リ ビジ ョ ン番号、

• action は 新 リ ビジ ョ ンにおいて実行されたア ク シ ョ ン、 つま り 、 add、 edit、 delete、

branch、 move/add、 move/delete、 integrate、 import、 purge、 または archive、

• changelist はその リ ビジ ョ ンがサブ ミ ッ ト されたチェ ンジ リ ス ト の番号、

• filetype は 新 リ ビジ ョ ンにおける フ ァ イルの PERFORCE フ ァ イルタ イプです。

通常の PERFORCE コマン ド と異な り 、p4 files はデ ィ ポの任意のフ ァ イルについてレポー ト し

ます。 その範囲は、 ク ラ イ アン ト ・ ビ ューを通し て見る こ と のでき る フ ァ イルだけに限られま

せん。 コマン ド ラ イ ンにフ ァ イル ・ パターンが ク ラ イ アン ト ・ シン タ ッ ク スで与え られていれ

ば、 ク ラ イ アン ト ・ ワーク スペースにあ る フ ァ イルだけが表示されます。

オプシ ョ ン

使用上の留意点

• リ ビジ ョ ンは リ ビジ ョ ン範囲で指定する こ と もでき ます。 この場合、 指定された範囲内の リ

ビジ ョ ンを持つフ ァ イルだけが リ ス ト され、デフ ォル ト ではその中の 高位の リ ビジ ョ ンが

-a 指定されたフ ァ イルに対し て、 リ ビジ ョ ン範囲におけ る 高位 リ ビジ ョ ンだけを

表示するのではな く 、 範囲内のすべての リ ビジ ョ ンを リ ス ト し ます。

-A 出力をアーカ イブ ・ デ ィ ポ内のフ ァ イルに限定し ます。

-e 削除されたか、 完全消去されたか、 アーカ イ ブ されたフ ァ イルを除外し、 同期ま

たは反映を実行でき る フ ァ イルだけを残し ます。

-m max 出力を 初から max 個までのフ ァ イルに限定し ます。

-U unloadfile アン ロード ・ デ ィ ポにあ る フ ァ イルのみを リ ス ト し ます。 詳し く は、 p4 unload を

ご覧 く ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 87

p4 files

新 リ ビジ ョ ン と し て表示されます。 （ リ ビジ ョ ン範囲における全フ ァ イルの情報を表示す

るには、 p4 files -a を使用し ます。）

• p4 files の出力は、 指定範囲の広いフ ァ イル引数で呼び出される と、 かな り 大量にな る こ

と があ る ため （例えば、 p4 files //depot/... では、 デ ィ ポの全フ ァ イルに関する情報が

表示される）、 p4 group によ って設定される maxresults の制限を受ける こ と があ り ます。

使用例

関連コ マン ド

p4 files //depot/... デ ィ ポの全フ ァ イルに関する情報を提供し

ます。

p4 files //clientname/... 指定された ク ラ イ アン ト のビ ューを通し て

見る こ と のでき る全デ ィ ポ ・ フ ァ イルに関

する情報を提供し ます。

p4 files @2011/03/10 2011 年 3 月 10 日に存在し た全デ ィ ポ・フ ァ

イルの リ ビジ ョ ンに関する情報を提供し ま

す。

p4 files @2011/03/31:08:00,@2011/03/31:17:00

2011 年 3 月 31 日の営業時間内に変更された

全フ ァ イルおよび リ ビジ ョ ン を リ ス ト 表示

し ます。

p4 files //depot/proj2/...@p2lab ラベルp2labにタ グ付け されるデ ィ レ ク ト

リ //depot/proj2/...のフ ァ イルおよび

リ ビジ ョ ンを リ ス ト 表示し ます。

p4 files //depot/file.c //depot/file.c の 新 リ ビ ジ ョ ンの情

報を表示し ます。 （これは、 暗黙的な範囲で

あ る #1,#head における 高位の リ ビジ ョ

ンです。）

p4 files -a //depot/file.c //depot/file.c の全 リ ビ ジ ョ ンの情報

を表示し ます。 （これは、 暗黙的な範囲であ

る #1,#head におけるすべての リ ビジ ョ ン

です。）

p4 files -A //arch/depot/proj/... 管理者が p4 archive を 使用 し て、

//depot/proj/... を arch と い う 名前

のアーカ イブ・デ ィ ポに転送し た場合、アー

カ イ ブ されたプ ロ ジ ェ ク ト 内のフ ァ イルに

関する情報を表示し ます。

フ ァ イルの リ ビジ ョ ン履歴を リ ス ト 表示する。 p4 filelog

現在作業状態にあ る全フ ァ イルの リ ス ト を見る。 p4 opened

使用中の ク ラ イ アン ト ・ ワーク スペースに同期し たフ ァ イル ・ リ ビジ ョ ン

の リ ス ト を見る。

p4 have

デ ィ ポ ・ フ ァ イルの内容を参照する。 p4 print

88 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 fix

p4 fix

概要

ジ ョ ブを、 その修正を行 う チェ ンジ リ ス ト に リ ン ク し ます。

構文

p4 [g-opts] fix [ -d ] [ -s status ] -c changelist jobName ...

解説

p4 fix コマン ド は、 ジ ョ ブ （実行されるべき作業の記述） を、 チェ ンジ リ ス ト （フ ァ イルに対

する変更の集合。 ジ ョ ブに記述された作業を行 う ） に リ ン ク し ます。

チェ ンジ リ ス ト がまだサブ ミ ッ ト されていない場合、 ジ ョ ブは、 リ ン ク先チェ ンジ リ ス ト につ

いて p4 submit または p4 change を実行する と きに開 く フ ォーム内に表示されます。 通常の

状況では、チェ ンジ リ ス ト がサブ ミ ッ ト された時点で、 ジ ョ ブの状態が closed に変わ り ます。

p4 fixを実行する前にすでにチェ ンジ リ ス ト がサブ ミ ッ ト 済みであ る場合も、ジ ョ ブの状態は

やは り デフ ォル ト の状態 （通常は closed） に設定されます。

チェ ンジ リ ス ト をサブ ミ ッ ト する際に、 ジ ョ ブの状態をデフ ォル ト の状態 （通常は closed） 以

外に変更するには、 p4 fix、 p4 submit、 または p4 change で -s オプシ ョ ンを使用し ます。

記述された作業を、 複数のチェ ンジ リ ス ト で修正完了 とする こ と も でき ます。 すなわち、 1 つ

のジ ョ ブを、 複数のチェ ンジ リ ス ト に リ ン クする こ と ができ ます。 また、 1 つのチェ ンジ リ ス

ト で 10 のバグを修正完了にする こ と も可能です。 この場合は、 複数のジ ョ ブを同一のチェ ン

ジ リ ス ト に リ ン ク し ます。 これは、p4 fix に複数のジ ョ ブを引数と し て与え る こ と によ り 、 コ

マン ド を 1 回実行するだけで達成でき ます。

オプシ ョ ン

使用上の留意点

• ジ ョ ブのフ ォーマ ッ ト はサイ ト ご と に変更される こ と があ るので、使用し ている システム上

のジ ョ ブには ［Status:］ （状態 ： ） フ ィ ール ド がない場合があ り ます。 その場合には、 ジ ョ

ブは p4 fix でチェ ンジ リ ス ト に リ ン クする こ と ができ ますが、PERFORCE は、チェ ンジ リ ス

ト がサブ ミ ッ ト されて も、 そのジ ョ ブのフ ィ ール ド の値はいっ さい変えません。

-d 指定されたチェ ンジ リ ス ト におけ る指定されたジ ョ ブに関する修正完了の記録を

削除し ます。 ジ ョ ブの状態は変わ り ません。

-s status チェ ンジ リ ス ト のサブ ミ ッ ト 時に、 ジ ョ ブの状態をデフ ォル ト 値であ る closedではな く status（またはp4 jobspec フ ォームのフ ィ ール ド 102のPresets: に定義されたその他の値） に変更し ます。

サブ ミ ッ ト 済チェ ンジ リ ス ト にジ ョ ブを リ ン クする場合、 こ の状態の値はすぐに

ジ ョ ブの状態に反映されます。

作業中チェ ンジ リ ス ト の場合、 p4 submit を -s オプシ ョ ンを指定し て実行する

と、 ジ ョ ブの状態はチェ ンジ リ ス ト のサブ ミ ッ ト 時に変更されます。 そ し て、 p4submit を -s オプシ ョ ンを指定し て実行する と、フ ォームの ［Jobs:］ フ ィ ール ド

には、 ジ ョ ブ名に続いてジ ョ ブの状態が表示されます。

ジ ョ ブを未変更のま まにし てお く には、 特殊な状態であ る same を使用し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 89

p4 fix

• 修正完了または未了のジ ョ ブの状態は、 p4 job でジ ョ ブを編集する こ と によ り 、 いつで も

変え る こ と ができ ます。

• ジ ョ ブを修正完了 （または未了） にするには、 サブ ミ ッ ト されていないチェ ンジ リ ス ト につ

いて p4 submit または p4 change のフ ォームを表示させ、その ［Jobs:］ （ジ ョ ブ ：） フ ィ ー

ル ド に該当のジ ョ ブを追加する （あ る いは、 ［Jobs:］ フ ィ ール ド か ら削除する） と い う 方

法も あ り ます。

• デフ ォル ト のチェ ンジ リ ス ト に p4 fix でジ ョ ブを リ ン クする こ と はでき ません。 リ ン ク し

たい と き は、 デフ ォ ル ト のチ ェ ン ジ リ ス ト をデ ィ ポにサブ ミ ッ ト す る と き、 p4 submit

フ ォームの ［Jobs:］ フ ィ ール ド にそのジ ョ ブを追加し て く だ さい。

• p4 fix -s status をジ ョ ブに対し て使用し、p4 submit または p4 changeに対し て -sオプ

シ ョ ンを使用し た場合、 チェ ンジ リ ス ト ・ フ ォームの ［Jobs:］ フ ィ ール ド にはジ ョ ブの状

態値が必要にな り ます。 このデフ ォル ト は、 p4 fix -s status で指定された値です。 チェ

ンジ リ ス ト のサブ ミ ッ ト が成功し た場合、 ジ ョ ブには指定の status が割 り 当て られます。

フ ォーム中に状態値が指定されていない場合は、 次のエラー ・ メ ッ セージが表示されます。

Wrong number of words for field 'Jobs'.

p4 fix -s status、 p4 submit -s、 および p4 change -s は、 欠陥追跡システム と連携し

て使用する こ と を目的と し たオプシ ョ ンです。

通常、 ユーザが これらのコマン ド を使用する こ と はな く 、 p4 submit と p4 change を -s オ

プシ ョ ンな し で使用し ます。 こ の場合、 ［Jobs:］ フ ィ ール ド に必要なのはジ ョ ブ番号のみ

で、各ジ ョ ブの状態はサブ ミ ッ ト 完了時にデフ ォル ト 値 （通常は closedÅj に設定されます。

使用例

関連コ マン ド

p4 fix -c 201 job000141 job002034 2 つのジ ョ ブをチェ ンジ リ ス ト 201 によ って修正完

了 と し ます。

チェ ンジ リ ス ト 201 がまだ pending の場合には、

ジ ョ ブの状態はチェ ンジ リ ス ト がサブ ミ ッ ト さ れ

た段階で closed に変わ り ます。

p4 fix -c 201 -s suspended job002433 チェ ンジ リ ス ト 201 がサブ ミ ッ ト さ れた と きに、

job002433をclosedではな く suspendedと し ま

す。

p4 submitを-sオプシ ョ ン付きで実行する必要が

あ り ます。

作業中チェ ンジ リ ス ト に対し てジ ョ ブを追加または削除する。 p4 change

デフ ォル ト のチェ ンジ リ ス ト に対し てジ ョ ブを追加または削除する。 p4 submit

ジ ョ ブ と チェ ンジ リ ス ト の関係を リ ス ト 表示する。 p4 fixes

ジ ョ ブを生成または編集する。 p4 job

ジ ョ ブのすべて、 または一部を リ ス ト 表示する。 p4 jobs

サイ ト で使用する ジ ョ ブのフ ォーマ ッ ト を変更する。 （スーパー ・ ユーザ専

用）

p4 jobspec

サイ ト で使用し ている ジ ョ ブのフ ォーマ ッ ト に関する情報を読み出す。 p4 jobspec -o

90 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 fixes

p4 fixes

概要

ジ ョ ブおよびそれを修正するチェ ンジ リ ス ト を リ ス ト 表示し ます。

構文

p4 [g-opts] fixes [-i -m max -j job -c changelist] [file[revRange]...]

解説

あ る ジ ョ ブが p4 fix、 p4 change、 または p4 submit によ って特定の番号付チェ ンジ リ ス ト

に リ ン ク さ れた後は、 そのジ ョ ブはそのチ ェ ン ジ リ ス ト に よ っ て修正完了にな っ てい ます

（チェ ンジ リ ス ト がまだ作業中であって も）。 p4 fixes コマン ド は、 チェ ンジ リ ス ト と、 それ

らが修正する ジ ョ ブを リ ス ト 表示し ます。

引数を指定せずに実行する と、 p4 fixes はすべての修正完了記録を次の形式で表示し ます。

jobname fixed by change changelist on date by user (status)

p4 fixes を下記オプシ ョ ン と組み合わせて実行する こ と によ り 、 リ ス ト 表示される修正完了

記録を制限する こ と ができ ます。

• -c changelist オプシ ョ ンを使用する と、その作業中またはサブ ミ ッ ト 済みのチェ ンジ リ ス

ト によ って修正されたジ ョ ブだけが リ ス ト 表示されます。

• -j job オプシ ョ ンを使用する と、 そのジ ョ ブを修正完了にする作業中またはサブ ミ ッ ト 済

みのチェ ンジ リ ス ト だけが リ ス ト 表示されます。

• 引数に 1 つまたは複数のフ ァ イル ・ パターンを指定する こ と も でき ます。 フ ァ イル引数を指

定する と、 そのフ ァ イル ・ パターンに合致する フ ァ イルに影響するサブ ミ ッ ト 済チェ ンジ リ

ス ト だけが リ ス ト 表示され、 作業中チェ ンジ リ ス ト は含まれません。 リ ビジ ョ ン指定子また

は リ ビジ ョ ン範囲が含まれていれば、指定された リ ビジ ョ ンのフ ァ イルに影響し たサブ ミ ッ

ト 済チェ ンジ リ ス ト だけが リ ス ト 表示されます。 -i オプシ ョ ンを フ ァ イル ・ パターン引数

と共に使用する と、特定のフ ァ イルへ反映されたチェ ンジ リ ス ト によ って行われた修正を含

める こ と ができ ます。

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

オプシ ョ ン

使用上の留意点

-c changelist 表示される修正完了記録を、 指定のチェ ンジ リ ス ト を含むものだけに制限し ます。

-j jobname 表示される修正完了記録を、 指定のジ ョ ブを含むものだけに制限し ます。

-i files... 指定フ ァ イルの反映元のフ ァ イルに関連するチェ ンジ リ ス ト によ る修正完了の記

録を含めます。

-m max max 個までの修正のみを一覧表示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 91

p4 fixes

使用例

関連コ マン ド

p4 fixes //depot/proj1/... //depot/proj1のフ ァ イルを1つでも含むサブ ミ ッ ト 済チェ ン

ジ リ ス ト によ って行われたすべての修正完了の記録を表示し ま

す。

p4 fixes file.c file.c のすべての リ ビジ ョ ンを含むサブ ミ ッ ト 済チェ ンジに

よ って行われたすべての修正完了の記録を表示し ます。

p4 fixes file.c#5 file.cの リ ビジ ョ ン 1 から 5 までを含むサブ ミ ッ ト 済チェ ンジ

によ って行われたすべての修正完了の記録を表示し ます。

p4 fixes file.c#5,5 file.c#5 がサブ ミ ッ ト されたチェ ンジ リ ス ト に関連する修正

完了の記録のみを表示し ます。

p4 fixes -c 414 作業中またはサブ ミ ッ ト 済みのチェ ンジ リ ス ト 414 によ って修

正完了にされたすべてのジ ョ ブを表示し ます。

ジ ョ ブの生成または既存のジ ョ ブの編集を行 う 。 p4 job

システムが認識し ているすべてのジ ョ ブを リ ス ト 表示する。 p4 jobs

ジ ョ ブをチェ ンジ リ ス ト に リ ン クする。 そのジ ョ ブは リ ン ク先チェ ンジ リ

ス ト によ って修正完了にされる。

p4 fix

サイ ト で使用する ジ ョ ブのフ ォーマ ッ ト を変更する。 （スーパー ・ ユーザ専

用）

p4 jobspec

サイ ト で使用し ている ジ ョ ブのフ ォーマ ッ ト に関する情報を読み出す。 p4 jobspec -o

92 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 flush

p4 flush

概要

ク ラ イ アン ト ・ ワーク スペースの所有 リ ス ト を、 フ ァ イルを実際にコ ピーする こ と な く 更新し

ます。

構文

p4 [g-opts] flush [-f] [-L] [-n] [-q] [file[revRange]...]

警告

p4 flush は、 使用方法を誤る と 重大な結果を も た らす危険性があ り ます。

p4 flush を不適切に使用する と、 バージ ョ ン化サービ スの メ タデータが ク ラ イ アン ト ・ ワー

ク スペースの実際の状態を反映し な く な り 、 以後、 実行する PERFORCE コマン ド が、 意図し た

フ ァ イルに対し て働かな く な り ます ! 　 p4 flush は、その目的を十分に理解する まで使用し な

いで く だ さい。

なお、 p4 flush はほ と んど使用する必要のないコマン ド です。

解説

p4 flush コマン ド は、p4 sync の機能を半分だけ実行し ます。例えば、p4 sync filespec を

実行する と、 次の 2 つの処理が行われます。

• filespec にあ る フ ァ イル ・ リ ビジ ョ ンを、 デ ィ ポから ク ラ イ アン ト ・ ワーク スペースにコ

ピーし ます。

• ワーク スペースの所有 リ ス ト （have list） （PERFORCE サービ スによ って管理されている情報

で、 どのフ ァ イル ・ リ ビジ ョ ンが同期されているかを追跡する リ ス ト ） を、 新しい ク ラ イ ア

ン ト ・ ワーク スペースの内容を反映する よ う に更新し ます。

p4 flush は、 この う ち第 2 の処理だけを実行し ます。通常、 この動作は望ま しいものではあ り

ません。 その理由は、 ク ラ イ アン ト ・ ワーク スペースの所有 リ ス ト は、 常にワーク スペースの

実際の内容を反映すべきだからです。 しかし、 所有 リ ス ト がもはやワーク スペースの内容 と同

期し ていない と きに、 p4 flush を使用し て、 所有 リ ス ト を実際の内容に同期させる こ と がで

き る場合があ り ます。 p4 flush は実際にフ ァ イルを転送するわけではないので、 p4 sync の

実行よ り もずっ と速 く 処理が済みます。

p4 flush は、 所有 リ ス ト を ク ラ イ アン ト ・ ワーク スペースの実際の状態に合わせて更新する

必要があ る場合にのみ、 使用し て く だ さい。 後掲の 「使用例」 のセ ク シ ョ ンに、 そのよ う な場

合の例を 2 つ示し てあ り ます。

オプシ ョ ン

-f flush を強制実行し ます。 PERFORCE は ク ラ イ アン ト ・ ワーク スペースに指定 リ ビ

ジ ョ ンのフ ァ イルがあ る場合でも flush を実行し ます。 フ ァ イルが書き込み可能で

あ る場合には上書き されます。

このオプシ ョ ンは作業状態のフ ァ イルには影響し ませんが、noclobber ク ラ イ ア

ン ト ・ オプシ ョ ンをオーバーラ イ ド し ます。

-L ス ク リ プ ト 作成目的で、 完全なデ ィ ポ ・ シン タ ッ ク スに有効な リ ビジ ョ ン番号を

伴って示されたフ ァ イル引数 リ ス ト に対し、 flush を実行し ます。

-n flush を実行する こ と な く flush の結果を表示し ます。 これによ り 、 flush を実行する

前に、 期待どお り の結果が得られるかど う かを確認する こ と ができ ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 93

p4 flush

使用上の留意点

• p4 flush は、 フ ァ イルを コ ピーする こ と な く ク ラ イ アン ト ・ ワーク スペースの所有 リ ス ト

を更新し ます。 一方、 p4 sync -f は、 ク ラ イ アン ト ・ ワーク スペースの内容をその所有 リ

ス ト に一致させます。 し たがって、 p4 flush files に続いて p4 sync -f files を実行す

れば、 p4 sync files を実行し たの と ほぼ同じ こ と にな り ます。 これは、 不適切な flush が

行われて も、 後でその flush が行われたフ ァ イル ・ リ ビジ ョ ンに対し て p4 sync -f を実行

すれば、 ほぼ完全に修正ができ る こ と を意味し ています。

しかし、 残念ながら、 これで も完全には不適切な flush を防げません。 p4 flush によ って所

有 リ ス ト から削除されたフ ァ イル・ リ ビジ ョ ンは、p4 sync -f 実行後も ク ラ イ アン ト ・ ワー

ク スペースに残 り ます。 こ の場合には、 削除されたフ ァ イル ・ リ ビジ ョ ンを、 手動操作で ク

ラ イ アン ト ・ ワーク スペースから削除する しかあ り ません。

• p4 flush は p4 sync -k と同等に機能し ます。

使用例

• 同じサイ ト で作業をする 10 人のユーザが、遠隔地にあ る同一のデ ィ ポから、低速 リ ン ク を介

し て、 新たに同じ ク ラ イ アン ト ・ ワーク スペース をセ ッ ト ア ッ プする必要があ る と し ます。

通常は、 各ユーザが、 p4 sync コマン ド を同じ構文で実行する方法を と り ますが、 帯域幅に

制限があ る場合は、 次のよ う にする と、 処理を速 く 済ませる こ と ができ ます。

• 1人のユーザ（例えばユーザA）が、自分の ク ラ イ アン ト ・ワーク スペース firstworkspace

から p4 sync files を実行し ます。

• 他のユーザは、 ローカル OS のフ ァ イルコ ピー・ コマン ド を使用し て、ユーザ A の ク ラ イ

アン ト ・ ワーク スペースから各自の ク ラ イ アン ト ・ ワーク スペースへ、 新たに同期され

たフ ァ イルを コ ピーし ます。

• さ らに、各ユーザが p4 flush files @firstworkspace を実行する と、上記のステ ッ プ

で各自の ク ラ イ アン ト ・ ワーク スペースへコ ピーし たフ ァ イル と同期し た、 ク ラ イ アン

ト ・ ワーク スペースの所有 リ ス ト が得られます。

p4 flush は低速 リ ン ク を介し たフ ァ イル転送を し ないので、この処理は、p4 sync コマン ド

を異な る タ イ ミ ングで 10 回実行する よ り はるかに高速にな り ます。

• ジ ョ ーは joe と い う ク ラ イ アン ト ・ ワーク スペース を使用し ていて、 その ［Root:］ は

/usr/joe/project1/subproj

であ り 、 ［View:］ は

//depot/joe/proj1/subproj/... //joe/...

であ る と し ます。 ジ ョ ーは今、 /usr/joe/project1 のすべてのフ ァ イルを自分のワーク ス

ペースに含める必要があ る と判断し、 ［Root:］ を

/usr/joe/project1

［View:］ を

//depot/joe/proj1/... //joe/...

-q サイ レ ン ト モード : 通常の出力 メ ッ セージを抑止し ます。エラーや例外条件に関す

る メ ッ セージは抑止されません。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 read

94 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 flush

に指定し て p4 client を実行し ま し た。 その結果、 カレ ン ト ・ ク ラ イ アン ト ・ ワーク スペー

スのフ ァ イルは同じ場所に と ど ま り 、ワーク スペースの範囲は他のフ ァ イルも含むよ う に拡

張されま し た。 と こ ろが、 ジ ョ ーは次に p4 sync を実行し た と き、 PERFORCE が ク ラ イ アン

ト ・ ワーク スペースの非作業状態のフ ァ イルを残らず削除し、 も う 一度同じ フ ァ イルを同じ

場所にコ ピーし ている こ と を知って驚き ます !

PERFORCE では、 所有 リ ス ト が各フ ァ イルの ク ラ イ アン ト ・ ルー ト に対する相対的な位置を

記述し、 各フ ァ イルの物理的位置は PERFORCE コマン ド が実行される たびに計算されるだけ

なので、 このよ う な こ と が起こ り ます。 つま り 、 PERFORCE は各フ ァ イルが再配置された と

考え、 p4 sync が実行される と、 フ ァ イルをそれまでの位置から削除し て、 新しい位置へコ

ピーするのです。

ジ ョ ーが PERFORCE の働き を理解し ていれば、p4 flush #have を実行し ていたでし ょ う 。そ

う すれば、 実際にはどのフ ァ イルも コ ピーされる こ と な く 、 ク ラ イ アン ト ・ ワーク スペース

の所有 リ ス ト は、 フ ァ イルの “新しい” 位置を反映する よ う に更新されたはずです。

関連コ マン ド

p4 flush は p4 sync -k と同等に機能し ます。 p4 sync -k

デ ィ ポのフ ァ イルを ク ラ イ アン ト ・ ワーク スペースにコ ピーする。 p4 sync

不適切に p4 flush が実行された後の所有 リ ス ト を ク ラ イ アン ト ・ ワーク

スペースに同期させる。

p4 sync -f

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 95

p4 fstat

p4 fstat

概要

フ ァ イル情報を ス ク リ プ ト によ る構文解析に適し たフ ォーマ ッ ト にダンプし ます。

構文

p4 [g-opts] fstat [-F filter -L -T fields -m max -r] [-c|-e change] [-Ox -Rx -Sx] [-U] file[rev]...

解説

p4 fstat コマン ド は、 個々のフ ァ イルに関する情報を項目ご と に別々の行に分けてダンプし

ます。

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

出力のソー ト 基準と な る フ ィ ール ド を変更するには -Sx オプシ ョ ンの う ち 1 つを使用し、ソー

ト 順序を逆にするには -r オプシ ョ ンを使用し ます。

フ ォーム ・ フ ィ ール ド の一部の機能に基づいて出力を絞 り 込むには （例えば、 一定の大き さ を

超え、 固有のフ ァ イルタ イプを持つすべてのフ ァ イルなど） -F filter オプシ ョ ンを使用し ま

す。

fields 引数に指定されたフ ィ ール ド の集合に出力を限定するには、 -T fields オプシ ョ ンを

使用し ます。 フ ィ ール ド名の リ ス ト はスペース またはカンマで区切る こ と ができ ます。

こ の出力は、 各項目が変数 と し てア ク セス可能な PERFORCE API アプ リ ケーシ ョ ンでの使用に

適ですが、 ス ク リ プ ト によ る構文解析に も適し ています。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 説明 例

attr-name 名前に関する属性値 attr-name

attrProp-name attr-name が伝播 さ れた属性

であ る場合に設定。

attrProp-name

clientFile フ ァ イルのローカル ・ パス。 （デ

フ ォル ト はローカル ・ シン タ ッ

ク ス。 -Op オプシ ョ ンを付ける

と PERFORCE シン タ ッ ク ス。）

/staff/userid/src/file.c

（ま たは、 PERFORCE シン タ ッ ク スでは

//workspace/src/file.c）

depotFile フ ァ イルのデ ィ ポ ・ パス。 //depot/src/file.c

movedFile 移動元、 移動先フ ァ イルのデ ィ

ポ内での名前

//depot/src/file.c

path フ ァ イルのローカル ・ パス //workspace/src/file.c

isMapped マ ッ プ さ れ た ク ラ イ ア ン ト ・

フ ァ イルが同期さ れている場合

に設定。

設定 (... isMapped) または表示さ れない

shelved フ ァ イルが保留さ れている場合

に設定。

headAction （デ ィ ポ内の） 新 リ ビジ ョ ンで

実行されたア ク シ ョ ン。

add、 edit、 delete、 branch、

m o v e / a d d 、 m o v e / d e l e t e 、

integrate、 import、purge、 または

archive のいずれか

headChange （デ ィ ポ内の） 新 リ ビジ ョ ンを

含むチェ ンジ リ ス ト の番号。

1、 2、 3 …… n

96 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 fstat

headRev （デ ィ ポ内の） 新 リ ビジ ョ ンの

番号。

1、 2、 3 …… n

headType （デ ィ ポ内の） 新 リ ビジ ョ ンの

タ イプ。

text 、 binary、 text+k など （「フ ァ

イルタ イプ」 のセ ク シ ョ ン参照）

headTime （デ ィ ポ内の） 新 リ ビジ ョ ンの

チ ェ ン ジ リ ス ト 日付。 時刻は

1970 年 1 月 1 日の 00:00:00 UTC

からの秒数で測定。

919283152 は 1999 年前半の日付

headModTime （デ ィ ポ内の） 新 リ ビジ ョ ンの

更新時刻 （ク ラ イ アン ト におい

てサブ ミ ッ ト 前にフ ァ イルが

後に更新された時刻）。

919280483 1999 年前半の日付

movedRev 移動さ れたフ ァ イルの 新 リ ビ

ジ ョ ン

1、 2、 3 …… n

haveRev 後にワーク スペースに同期し

た （ワ ー ク ス ペー ス 上に あ る）

リ ビジ ョ ン。

1、 2、 3 …… n

desc チェ ンジ リ ス ト のコ メ ン ト （-echangelist が使用され、 フ ァ

イルがchangelistに含まれて

いた場合）

PERFORCE のチェ ンジ リ ス ト

digest フ ァ イ ルの MD5 ダ イ ジ ェ ス ト

（-Ol オプシ ョ ンが必要）

32 桁の 16 進数

filesize フ ァ イルのバイ ト 数 （-Ol オプ

シ ョ ンが必要）

63488

action （ク ラ イ アン ト 上で） フ ァ イルを

作業状態にし たア ク シ ョ ン。

add、 edit、 delete、 branch、

m o v e / a d d 、 m o v e / d e l e t e 、

integrate、 import、purge、 または

archive のいずれか

type ( ワーク スペース上で ) 作業状態

に な っ て い る フ ァ イ ルの タ イ

プ。

PERFORCE フ ァ イル ・ タ イプ

actionOwner フ ァ イルを作業状態に し たユー

ザ ( フ ァ イルが作業状態になっ

ている場合 )。

PERFORCE ユーザ名

change （ワーク スペース上で） 作業状態

になっているチェ ンジ リ ス ト の

番号。

1、 2、 3 …… n

resolved ( も し あれば ) 衝突解決済みの反

映記録の数。

1、 2、 3 …… n

unresolved （も し あれば） 衝突未解決の反映

記録の数。

1、 2、 3 …… n

reresolvable ( も し あれば ) 再度衝突解決が可

能な反映記録の数。

1、 2、 3 …… n

フ ィ ールド名 説明 例

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 97

p4 fstat

otherOpen 同じ フ ァ イルを作業状態にし て

いる他のユーザの数。 該当する

ユーザがいない場合は空白。

1、 2、 3 …… n の前にその n 人のユー

ザ (0 ～ n-1) の リ ス ト 。 otherOpenn、

otherActionn、otherLockn フ ィ ー

ル ド を適宜使用。 例 ：

...otherOpen 3

......otherOpen0 user1@cws1

......otherOpen1 user2@cws2

......otherOpen2 user3@cws3

otherOpenn 同じ フ ァ イルを作業状態にし て

いる個々のユーザに対し、 その

フ ァ イルを作業状態に し ている

ワ ー ク ス ペー ス と ユーザ を 表

示。

user123@workstation9

otherLock 他のユーザがフ ァ イルを ロ ッ ク

し ている場合に表示されて空文

字に設定さ れ、 それ以外の場合

は非表示。

未設定 (... otherLock) ま たは表示 さ れ

ない

otherLockn ロ ッ ク さ れたフ ァ イルを作業状

態に し ている個々のユーザに対

し、 そのロ ッ ク を保持し ている

ク ラ イ アン ト と ユーザを表示。

user123@workstation9

一度に 1 ユーザのみフ ァ イルのロ ッ ク

が可能であ る ため、 n が設定 さ れてい

れば n は常に 0 と な る

otherActionn 同じ フ ァ イルを作業状態にし て

いる個々のユーザに対し、 行わ

れたア ク シ ョ ンを表示。

add、 edit、 delete、 branch、

m o v e / a d d 、 m o v e / d e l e t e 、

integrate、 import、purge、 または

archive のいずれか

otherChangen フ ァ イルを作業状態に し ている

すべ て のチ ェ ン ジ リ ス ト に対

し、 そのチェ ンジ リ ス ト を表示

チェ ンジ リ ス ト 番号

openattr-name フ ァ イルが作業状態に されてい

るすべてのチェ ンジ リ ス ト につ

いて、 名前に関する属性値。

attr-name

openattrProp-name attr-name が伝播 さ れた属性

であ る場合に設定。

attrProp-name

ourLock 現在のユーザがフ ァ イルを ロ ッ

ク し ている場合に表示されて空

文字に設定さ れ、 それ以外の場

合は非表示。

未設定 (... ourLock) ま たは表示 さ れな

い

resolveActionnresolveBaseFilenresolveBaseRevnresolveFromFilenresolveStartFromRevnresolveEndFromRevn

それぞれ、 作業中の反映操作、

ベース ・ フ ァ イ ル、 ベース ・ リ

ビジ ョ ン番号、反映元フ ァ イル、

開始 リ ビジ ョ ン、 終了 リ ビジ ョ

ン。

作業中の反映記録情報の場合は -Or オ

プシ ョ ンを使用

totalFileCount 調べたフ ァ イルの数 -m max オプシ ョ ンを ソー ト ・ オプ シ ョ ンの -Sx または -r の う ち 1 つ と共に使用し た場合に、 初のフ ァイルの出力に表示される

フ ィ ールド名 説明 例

98 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 fstat

オプシ ョ ン

-A pattern 表示される属性を、 指定されたパターンに一致する ものに限定し ます。

-F filter filter によ り 指定された基準に合致する フ ァ イルのみを リ ス ト し ます。 フ ィ ルタに

関する説明は、 後述の 「使用上の留意点」 を参照し て く ださい。

-L ス ク リ プ ト 作成目的で、 完全なデ ィ ポ ・ シン タ ッ ク スに有効な リ ビジ ョ ン番号を伴っ

て示されたフ ァ イル引数 リ ス ト に対し、 フ ァ イル情報を出力し ます。

-T fields fields に よ り 指定 さ れた フ ィ ール ド 名に合致する フ ァ イ ルのみを リ ス ト し ま

す。フ ィ ール ド名の リ ス ト はスペース またはカンマで区切る こ と ができ ます。

-c change 指定番号以降のチェ ンジ リ ス ト に関連する フ ァ イルのみを表示し ます。 リ ビジ ョ ン範

囲を用いる よ り 速 く 、 影響を受けたフ ァ イルを表示でき ます。

-e change 指定の番号のチェ ンジ リ ス ト の影響を受けたフ ァ イルのみを表示し ます。 リ ビジ ョ ン

範囲を用いる よ り 速 く 、 影響を受けたフ ァ イルを表示でき ます。

-m max fstat の出力を max フ ァ イルまでに限定し ます。

-r 出力を逆の順序でソー ト し ます。

-Oa p4 attribute によ って設定された属性を出力し ます。

-Od 属性の要約を出力し ます。

-Oe 16 進数でエン コード された属性値を出力し ます。

-Of 指定 さ れた フ ァ イ ルのすべ て の リ ビ ジ ョ ン につい て、 other[...] お よ び

resolve[...] フ ィ ール ド を除外し て出力し ます。

-Ol fileSize フ ィ ール ド と し て、 フ ァ イルの長さ と リ ビジ ョ ンご と の要約フ ィ ール ド を

表示し ます。

リ リ ース 2005.1 よ り 前のサーバにおいて、 特に多数の リ ビジ ョ ンがあ る テキ ス ト ・

フ ァ イルの場合、 このフ ィ ール ド を含めた表示には多 く の時間を要する可能性があ り

ます。 ご注意 く ださい。

-Op clientFile を、ローカル・シン タ ッ ク スではな く 、PERFORCE シン タ ッ ク スで表示し ます。

-Or 現在ワーク スペースで作業状態になっている フ ァ イルの作業中の反映記録データ を

表示し ます。

-Os ク ラ イ アン ト ・ ワーク スペース ・ データ （すなわち clientFile フ ィ ール ド） を除

外する こ と によ り 、 出力を短縮し ます。

-Rc コマン ド の出力を、 現在のワーク スペース上でマ ッ ピング されている フ ァ イルに制限

し ます。

-Rh コマン ド の出力を、 have リ ス ト （現在のワーク スペースに同期されている フ ァ イル）

に制限し ます。

-Rn コマン ド の出力を、 新 リ ビジ ョ ンではない リ ビジ ョ ンで作業状態になっている フ ァ

イルに制限し ます。

-Ro コマン ド の出力を、 現在のワーク スペースで作業状態のフ ァ イルに制限し ます。

-Rr コマン ド の出力を、 衝突解決済みの作業状態のフ ァ イルに制限し ます。

-Rs コマン ド の出力を、 保留中のフ ァ イルに制限し ます。 -e changelist オプシ ョ ンが

必要です。

-Ru コマン ド の出力を、 衝突未解決の作業状態のフ ァ イルに制限し ます。

-St フ ァ イルタ イプによ り ソー ト し ます。

-Sd 日付によ り ソー ト し ます。

-Sr 新 リ ビジ ョ ンによ り ソー ト し ます。

-Sh 現在の リ ビジ ョ ンによ り ソー ト し ます。

-Ss フ ァ イルサイ ズによ り ソー ト し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 99

p4 fstat

使用上の留意点

フ ィ ルタ

フ ァ イルの リ ス ト を、 特定の基準に合致する フ ァ イルに限定するには、 p4 fstat -F filter

を使用し ます。 p4 fstat によ り 表示される どのフ ォーム ・ フ ィ ール ド で も、 論理演算子の使

用が可能です。

fstat に使用される フ ィ ルタは大文字と小文字が区別されます。 空白によ り 区切られた、 英数

字によ るすべての文字列 （句読記号が埋め込まれた単語を含む） は単語と し て索引付け されま

す。

フ ィ ルタ内で検索語の間にスペースがあ る と、 ブールの AND 演算子 と し て扱われます。 任意

のキー と値のペアを含むフ ァ イルを検索するには （ブールの OR）、 それぞれの語を "|" 文字で

区切 り ます。

アンパーサン ド (&) 文字もブールの AND と し て使用可能です。ブール演算子は （高優先度 から

低優先度の順に） &、 |、 スペースの順で値を結合し ます。 グループ化の優先順位を変更するに

は、 括弧を使用し ます。

検索結果は、 特定フ ィ ール ド 内の値をフ ィ ルタ構文 “fieldname=value” によ り マ ッ チングす

る こ と で絞 り 込みが可能です。value は英数字および句読記号を含む単一の字句でなければな

り ません。

ワ イル ド カード の"*"によ り 、語の部分マ ッ チングが可能です。フ ィ ルタ “fieldname=string*”は “string”、 “stringy”、 “stringlike” などに合致し ます。

日付フ ィ ール ド はフ ィ ルタ日付を yyyy/mm/dd または yyyy/mm/dd:hh:mm:ss の形式で表すこ

と によ り マ ッ チングが可能です。 特定の時刻が指定されていない場合、 等価演算子 (=) はその

日の全時刻に合致し ます。

通常の比較演算子 (=、 >、 <、 >=、 <=) も使用可能です。

さ らに、 NOT 演算子 (^) を使用し て、 一部の比較の意味を打ち消すこ と ができ ます。

正規表現マ ッ チングは、 正規表現マ ッチング演算子 (~=) によ り サポー ト されています。

フ ィ ルタ式演算子であ る文字を含むテキス ト を検索するには、当該文字をバッ ク ス ラ ッ シュ (\)文字でエス ケープし ます。 バ ッ ク ス ラ ッ シ ュ文字を照合するには、 も う 1 つのバ ッ ク ス ラ ッ

シ ュでエスケープし ます (\\)。 バッ ク ス ラ ッ シュ を使用し て検索テキス ト をエスケープする特

殊な文字は 2 種類あ り ます。 PERFORCE の "..." ワ イル ド カード は \... によ り エスケープが可能

であ り 、 空のフ ィ ール ド は \0 を用いて検索でき ます。

-U データ を表示する際にアン ロー ド ・ デ ィ ポ内のフ ァ イルを含みます。 詳し く は、 p4

unload をご覧 く ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

-s グ ローバル ・ オプシ ョ ン （出力のタ イプを error、 warning、 info、 text、 また

は exit と し て記述する タ グを、 出力の各行の前に付ける） は、 p4 fstat では特に

有用です。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 list

100 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 fstat

これらの演算子によ る動作は、 比較対象 と な る フ ィ ール ド のタ イプによ り 異な り ます。

その他の使用上の留意点

• -Ro オプシ ョ ンを指定し て -e changelist を使用する と、 作業中の変更のみが考慮される

ため、 追加のための作業状態になっている フ ァ イルが出力に含められます。

• p4 fstat の構文は、 リ リ ース 2004.2 で変更されま し た。 従来のオプシ ョ ンであ る -C、 -H、

-W、 -P、 -l、 および -s は、 互換性のためにサポー ト されています。

• 特殊文字 @、 #、 *、 および % を含んでいる フ ァ イルの場合、 clientFile では特殊文字が表

示され、 depotFile ではその文字の 16 進値の ASCII 表現が含まれたフ ァ イル名が表示され

ます。

• size フ ィ ール ド と digest フ ィ ール ド は正規化 （UNIX の改行規則） された圧縮されていな

いバージ ョ ンのデ ィ ポ ・ フ ァ イルに基づいてお り 、 ク ラ イ アン ト ・ ワーク スペース と同期さ

せた際のフ ァ イルの表現には関係し ません。

• -L オプシ ョ ンは、 ス ク リ プ ト または自動レポー ト 処理で使用する こ と が意図されています。

フ ァ イル引数は完全なデ ィ ポ ・ シン タ ッ ク スで記述し、 有効な リ ビジ ョ ン番号を伴っていな

ければな り ません。 これらの必要条件を満た さ ないフ ァ イル指定は警告な く 無視されます。

使用例

フ ィ ールド ・ タ

イプ

フ ィ ルタにおける比較演算子の使用法

word 等価演算子(=) または大文字小文字区別な し等価演算子(~=) は単語フ ィ ール ド内の値

に正確に一致する必要があ り ます。

関係演算子は ASCII 順で比較を実行し ます。

text 等価演算子 (=) または大文字小文字区別な し等価演算子 (~=) は、値と し て指定さ

れた語が指定フ ィ ール ド内に見つかった場合に、 そのフ ァ イルにマ ッチし ます。

こ のタ イプでは関係演算子の用途は限定的で、 指定フ ィ ール ド内のいずれかの語が、

供給された値と合致する場合にフ ァ イル と マ ッチし ます。関係演算子は常に大文字と

小文字を区別し ます。

例えば、 チェ ンジ リ ス ト にあ る text フ ィ ール ド の desc に bug not fixed と い

う 語句が含まれていて、 フ ィ ルタが “desc<fixed” であ る場合、bug<fixed であ る

こ と から こ のフ ァ イルはフ ィ ルタにマ ッチし ます。

line 上記の text フ ィ ール ド ・ タ イプ と同様。

select 等価演算子 (=) または大文字小文字区別な し等価演算子 (~=) は、指定フ ィ ール ド

の値が指定し た語であ る場合に、 そのフ ァ イルにマ ッチし ます。 関係演算子は ASCII

順で比較を実行し ます。

date 日付は時間の経過順にマ ッ チし ます。 特定の時間が指定されていない場合、 =、 <=、

>= の各演算子はその日の全時刻に合致し ます。

p4 fstat file.c file.c に関する情報を表示し ます。

p4 fstat -Rc 20 *.c チェ ンジ リ ス ト 20 でのフ ァ イルのチェ ッ

ク イ ン後に影響を受け た、 すべての .cフ ァ イルに関する情報を表示し ます。

p4 fstat -Os file.c ク ラ イ ア ン ト ・ ワ ー ク ス ペー ス 情報行

（clientFile） は表示し ません。

p4 fstat -Osl file.c ク ラ イ アン ト ・ ワーク スペース情報行は表

示し ませんが、fileSize および digest の行は表示し ます。

p4 fstat -Os -Ol file.c p4 fstat -Osl と同義。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 101

p4 fstat

関連コ マン ド

p4 fstat -F "clientFile=c:\\ws\\file.c" //depot/main/...

パス にバ ッ ク ス ラ ッ シ ュ が含まれてい る

場合は、それら をバッ ク ス ラ ッ シュでエス

ケープし ます。

p4 fstat -F "clientFile~=c:\\ws\\[Ff]ile.c" //depot/main/...

正規表現修飾子 ~= を使用し て、File.c および file.c に一致する正規表現を指定し ます。

p4 fstat -Ol -F "fileSize < 1024 & headType=text" //depot/main/...

長 さ が 1024 バ イ ト に満た な い、

//depot/main/...配下にあ るすべての

テキス ト ・フ ァ イルに関する情報を表示し

ます。

p4 fstat -T 'depotFile, headRev' file.c file.c の depotFile フ ィ ール ド と

headRev フ ィ ール ド のみを表示し ます。

各フ ァ イルに関する付加的情報を読み出す。 p4 files

チェ ンジの説明を含むフ ァ イル情報を表示する。 p4 filelog

102 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 grep

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 103

p4 grep

概要

パターンに一致する フ ァ イル ( またはフ ァ イルの リ ビジ ョ ン ) 内の行を出力し ます。

構文

p4 [g-opts] grep [ options ] -e pattern file[revRange]...

オプション : -a -i -n -v -Anum -Bnum -Cnum -l -L -T -s -F -G

解説

p4 grep コマン ド は指定された正規表現に一致する行を探し ます。

デフ ォル ト では、 p4 grep は 新 リ ビジ ョ ンに対し て動作し ます。 フ ァ イル引数で リ ビジ ョ ン

が指定されている場合、 その リ ビジ ョ ン番号のすべてのフ ァ イルが検索されます。 フ ァ イル引

数で リ ビジ ョ ン範囲が指定されている場合、その リ ビジ ョ ン範囲によ って選択されたフ ァ イル

だけが検索され、 その範囲内で も上位にあ る リ ビジ ョ ンが各フ ァ イルに使用されます。

オプシ ョ ン

使用上の留意点

• デフ ォル ト では、p4 grep は リ ビジ ョ ンを 10000 個まで検索し ます。 この制限は構成可能変

数 dm.grep.maxrevs によ って制御されます。

-e pattern p4 grepによ って使用されるpatternは、UNIXで使用される正規表現に相当し ます。

その構文は p4 help grep の出力に詳細に明記されます。

-a 指定された範囲で も上位の リ ビジ ョ ンだけでな く 、 範囲内のすべての リ ビジ ョ ンを

検索し ます。

-i 大文字 / 小文字を区別し ないパターン ・ マ ッチングを実行し ます。 ( デフ ォル ト では、

大文字 と小文字を区別し てマ ッチング し ます。 )

-n フ ァ イル ・ リ ビジ ョ ン番号の後に、 一致する行番号を表示し ます。

-v 指定された正規表現に一致し ない行を表示し ます。

-F パターンを固定文字列 と し て解釈し ます。

-G パターンを正規表現 と し て解釈し ます。

-L 指定された正規表現に一致する行を含まないフ ァ イルを検索し、 そのフ ァ イル名のみ

を表示し ます。

-l 指定された正規表現に一致する行を含むフ ァ イルを検索し、 そのフ ァ イル名のみを表

示し ます。

-s 1 行に 4096 文字以上が含まれる フ ァ イルからのエラー・ メ ッ セージを抑止し ます。(p4grep はデフ ォル ト で、 これらのフ ァ イルへの処理を停止し てエラーを報告し ます )

-t バイナ リ ・ フ ァ イルをテキス ト と し て扱います。( デフ ォル ト では、text タ イプのフ ァ

イルだけがパターン ・ マ ッチング対象 と し て選択されます。 )

-A num 一致する行に後続する num 行を表示し ます。

-B num 一致する行に先行する num 行を表示し ます。

-C num 一致する行の前後の num 行を表示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 read

p4 group

p4 group

概要

ユーザを グループに追加、 ま たはグループか ら 削除 し ます。 グループの メ ンバーに対す る

maxresults、 maxscanrows、 maxlocktime および timeout の各制限を設定し ます。

構文

p4 [g-opts] group [ -a | -A ] groupnamep4 [g-opts] group -d [ -a ] groupnamep4 [g-opts] group -o groupnamep4 [g-opts] group -i [ -a | -A ]

解説

グループは、 PERFORCE ユーザの リ ス ト です。 グループを使用し て、 p4 protect フ ォームでの

ア ク セス ・ レベルの設定、 特定のユーザが 1 つのコマン ド でサーバから ア ク セスでき るデータ

の 大件数の制限、 p4 login チケ ッ ト のタ イ ムア ウ ト 期間の設定を行います。

グループを削除するには、 p4 group -d groupname を実行するか、 p4 group groupname を

起動し て、 表示されたフ ォームからユーザ全員を消去し ます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Group: 読み取 り 専用 コマン ド ラ イ ン上で入力されたグループ名です。

MaxResults: 書き込み可能 グループの メ ンバーが 1 つのコマン ド でサービ スから ア ク セ

スでき るデータの 大件数です。 デフ ォル ト 値は unset で

す。 詳し く は下記 「使用上の留意点」 を参照し て く ださい。

MaxScanRows: 書き込み可能 グループの メ ンバーが 1 つのコ マン ド か ら サービ スか ら ス

キ ャ ンでき る 大の列数です。 デフ ォル ト 値は unset です。

詳し く は下記 「使用上の留意点」 を参照し て く ださ い。

MaxLockTime: 書き込み可能 データ ・ スキ ャ ンの際、 あ る 1 つの操作で任意のデータベー

ス ・ テーブルを ロ ッ クする こ と のでき る 長時間 （ ミ リ 秒単

位）。 デフ ォル ト 値は unset です。 詳し く は下記 「使用上の

留意点」 を参照し て く ださ い。

Timeout: 書き込み可能 p4 login によ って作成されるセ ッ シ ョ ン ・チケ ッ ト の有効

期間 ( 秒単位 ) です。 デフ ォル ト 値は 43200 秒 (12 時間 ) で

す。 無期限のチ ケ ッ ト を 作成す る には、 [Timeout:] を

unlimited に設定し ます。

PasswordTimeout: 書き込み可能 こ のグループに属するユーザのパス ワード が有効であ る期間

( 秒単位 )。 パス ワード の有効期限設定を無効にするには、 値

に unset を使用し ます。

Users: 書き込み可能、

複数行

グループの メ ンバーの PERFORCE ユーザ名です。1 行に 1 ユー

ザずつを記述し、 イ ンデン ト されていなければな り ません。

104 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 group

オプシ ョ ン

使用上の留意点

• グループ定義の中で （存在し ない） ユーザを記述し て も、 ユーザは作成されず、 ラ イセン ス

も消費されません。 ユーザの作成には p4 user を使用し て く ださい。

• 複数のグループに属するユーザのチケ ッ ト の Timeout 値は、maxresults 値と同様の方法で

計算されます。 つま り 、 そのユーザが属するすべてのグループの timeout 値の う ち

（unlimited は含めるが unset は無視し て） 大の値が設定されます。 どのグループに も

属さ ないユーザには、 デフ ォル ト のチケ ッ ト の Timeout 値に 43200 が設定され、

PasswordTimeout に unset が設定されます。 無期限のチケ ッ ト を作成するには、

[Timeout:] を unlimited に設定し ます。

Subgroups: 書き込み可能、

複数行

他の PERFORCE グループの名前です。

あ らかじめ定義されている グループのユーザ全員を現在自分

が属し ている グループに追加するには、 p4 group のフ ォー

ムの ［Subgroups:］ フ ィ ール ド にそのグループの名前を入

力し ます。 ユーザ名 と グループ名は別々のネーム スペース を

占有し ます。 こ のため、 グループ と ユーザは同じ名前を と る

こ と ができ ます。

［Subgroups:］ フ ィ ール ド に入力される、 あ らかじめ定義さ

れたグループの メ ンバーが、 全員、 これから定義し よ う と し

ている グループの メ ンバーにな り ます。

Owners: 書き込み可能、

複数行

他の PERFORCE ユーザの名前です。

super 権限のないグループ所有者であって も、-aオプシ ョ ン

を使用すればこ のグループの管理が許可されます。

グループの所有者がグループの メ ンバーでない場合も あ り ま

す。 グループの所有者を グループの メ ンバーにする場合は、

ユーザ ID を Users: フ ィ ール ド に追加し なければな り ませ

ん。

-a （スーパーユーザではない） グループ所有者に よ る グループの管理を可能に し ま

す。 そのユーザは、 グループの Owner: フ ィ ール ド に リ ス ト されていなければな

り ません。

-A admin 権限のあ るユーザに、 新しいグループの追加を許可し ます。 このオプシ ョ

ンが使用されている場合、 既存のグループは変更でき ません。

-d groupname グループ groupname を削除し ます。 グループの メ ンバーは、 このグループ削除の

結果 と し てア ク セス ・ レベルまたは maxresults 値が変化する場合にのみ影響を

受けます。

-i ユーザのエデ ィ タ を立ち上げずに標準入力か ら フ ォーム を読み込みます。 新しい

グループ仕様がそれまでの仕様に置き換わ り ます。

-o ユーザのエデ ィ タ を立ち上げずに標準出力へフ ォームを書き出し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

（p4 group -A を使 う には admin）

（p4 group -o または -a の リ ス

ト ）

フ ィ ールド名 タ イプ 説明

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 105

p4 group

• PasswordTimeout: フ ィ ール ド を使用し てパス ワー ド有効期限を設定する場合、30 日間での

タ イ ムア ウ ト は 2592000 秒です。

• デ ィ ポに保存されている フ ァ イルの数が増えて く る と、あ る種のコマン ド をパラ メ ータ な し

で、 あ るいは制限のない引数を付けて実行し た と きに、 サービ スの動作が大幅に遅 く な る こ

と があ り ます。 例えば、 p4 print //depot/... は、 デ ィ ポに保存されている あ ら ゆる フ ァ

イルの内容をユーザの画面上に表示し、p4 filelog //depot/... は、デ ィ ポに保存されて

いる あ ら ゆる フ ァ イルのあ らゆる リ ビジ ョ ンにおいて、 データ を取 り 込も う と し ます。

PERFORCE スーパー ・ ユーザは、 ユーザのグループについて MaxResults 値を設定する こ と

に よ り 、 PERFORCE が ユーザに返すデー タ の量 を 制限す る こ と が で き ま す。 同様に、

MaxScanRows 値を設定する こ と によ り 、 ス キ ャ ン されるデータの量 （ユーザに返されるか

返されないかにかかわらず） を制限する こ と ができ ます。 また、 MaxLockTime 値によ り 、 あ

る 1 つの操作で任意のデータベース ・テーブルを ロ ッ クする こ と ができ る時間の長さ を設定

する こ と ができ ます。

こ の MaxResults 値、 MaxScanRows 値または MaxLockTime 値を超えた場合、 サーバへの要

求は拒否され、 ユーザは問合せを制限する よ う に求められます。

ユーザが複数のグループに属し ている場合、 サーバは、 ユーザが属し ているすべてのグルー

プに対する MaxResults 値の 大値をそのユーザの MaxResults 値 と し て計算し ます （設定

値 unlimited に遭遇する と制限は削除されますが、 デフ ォル ト 値 unset のま まであ る設定

は無視されます）。どのグループにも属さ ないユーザがいれば、その MaxResults 値は unset

にな り ます。 （ユーザの MaxScanRows 値および MaxLockTime 値の制限も同様の方法で計算

されます。）

通常のハード ウ ェ アの処理速度では、MaxResults を 10,000 以下に設定し た り 、MaxScanRows

を 50,000 以下に設定し た り 、MaxLockTime を 1000 以下に設定し た り する必要はあ り ません。

• ワーク スペース またはラベルのアン ロー ド を行 う には、ユーザがワーク スペースの have リ ス

ト にあ るすべてのフ ァ イルおよび/ またはラベルによ って タ グ付け されている フ ァ イルを ス

キ ャ ンする こ と が可能でなければな り ません。 管理者は MaxScanRows および MaxResults

を十分な大き さの値に設定し て、 ユーザが p4 unload または p4 reload の操作にサポー ト

を要求せずに済むよ う にするべきです。

• あ る グループについて maxresults、 maxscanrows、 maxlocktime、 および timeout の制限

を表示するには、 p4 groups -v groupname を使用し ます。

• p4 help maxresults を使用する と、3 つの制限値のどれかに影響を受ける コマン ド の リ ス

ト を取得する こ と ができ ます。

関連コ マン ド

ユーザのア ク セス ・ レベルを変更する。 p4 protect

既存グループの リ ス ト を参照する。 p4 groups

106 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 groups

p4 groups

概要

ユーザのグループを リ ス ト 表示し ます。

構文

p4 [g-opts] groups [ -m max ] [-v] [ group ]p4 [g-opts] groups [ -m max ] [-i [-v]] user | groupp4 [g-opts] groups [ -m max ] [-g | -u | -o] name

解説

p4 groups は、p4 group によ って生成された現時点のすべてのユーザ・グループを リ ス ト 表示

し ます。 表示されるのはグループ名だけです。

オプシ ョ ンの引数 user が与え られていれば、 そのユーザを含むグループだけが リ ス ト 表示さ

れます。 オプシ ョ ンの引数 group が与え られていれば、 そのグループを含むグループだけが

リ ス ト 表示されます。

-i オプシ ョ ンを使用する と、 ユーザ （またはグループ） がサブグループの メ ンバ と し て属し て

いる グループを含める こ と ができ ます。 グループ引数が指定された場合、 指定されたグループ

を含むグループのみが表示されます。

-v オプシ ョ ンを使用する と、指定されたグループ （グループが未指定の場合はすべてのグルー

プ） の MaxResults、 MaxScanRows、 MaxLockTime、 Timeout の値が表示されます。

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

オプシ ョ ン

使用上の留意点

• 1 つのグループの メ ンバー全員を見るには、p4 group -o groupname を使います。 こ のオプ

シ ョ ンが付いた p4 group コマン ド は、 list のア ク セス権限さ えあれば使えます。

使用例

-m max max 個までのグループのみを一覧表示し ます。

-i [ user | group ]

user または group が間接的な メ ンバー と なっている（つま り サブグループに含ま

れている） グループを表示し ます。

-v [ group ] 詳細な出力を表示し、 MaxResults、 MaxScanRows、 MaxLockTime、 Timeoutの値を含めます。

-g name 指定された名前のグループを一覧表示し ます。

-u name 指定されたユーザが メ ンバーになっている グループを一覧表示し ます。

-o name 指定されたユーザが所有し ている グループを一覧表示し ます。

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

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

p4 groups bob ユーザ bob を含むすべてのグループの名前を表示し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 107

p4 groups

関連コ マン ド

ユーザ ・ グループの生成、 または既存ユーザ ・ グループの編集を行 う 。 p4 group

特定グループのすべての メ ンバーおよび仕様の リ ス ト を参照する。 p4 group -o groupname

特定グループの メ ンバーについて PERFORCE ア ク セス ・ レベルを設定する。 p4 protect

108 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 have

p4 have

概要

ク ラ イ アン ト ・ ワーク スペースに同期し ている フ ァ イルおよび リ ビジ ョ ン を リ ス ト 表示し ま

す。

構文

p4 [g-opts] have [file...]

解説

p4 have は、 p4 sync で ク ラ イ アン ト ・ ワーク スペースにコ ピーされている フ ァ イルおよび リ

ビジ ョ ンを リ ス ト 表示し ます。 フ ァ イル ・ パターンが与え られていれば、 表示されるのは、 そ

のパターンに合致する フ ァ イル、 また、 ク ラ イ アン ト ・ ビ ューに対し てマ ッ ピング されている

フ ァ イルに限られます。

p4 have はフ ァ イルを 1 行に 1 つずつ、 次のフ ォーマ ッ ト で リ ス ト 表示し ます。

depot-file#revision-number - local-path

• depot-file は、 デ ィ ポ ・ シン タ ッ ク スで記述されたフ ァ イルへのパスです。

• revision-number は、 所有 リ ビジ ョ ン、 すなわち現在カレ ン ト ・ ク ラ イ アン ト ・ ワーク ス

ペースにあ る リ ビジ ョ ンです。

• local-path は、 ローカル ・ フ ァ イルシステムの記述 （すなわち、 ローカル ・ シン タ ッ ク ス）

で表現されたパスです。

オプシ ョ ン

使用上の留意点

• PERFORCE 関連ド キ ュ メ ン ト には、ク ラ イ アン ト ・ワーク スペースの have リ ス ト に触れている

ものがい く つかあ り ます。 所有 リ ス ト は、p4 have によ ってレポー ト される フ ァ イルの リ ス

ト であ り 、 現在、 デ ィ ポか ら同期し ている フ ァ イル ・ リ ビジ ョ ンの リ ス ト です。 have リ ス

ト にはク ラ イ アン ト ・ ワーク スペースに存在し て もデ ィ ポには存在し ないフ ァ イルは含まれ

ません ( また、 削除された リ ビジ ョ ンにあ る フ ァ イルも含まれません )。

例えば、 p4 add を使って追加する フ ァ イルを新たに ク ラ イ アン ト ・ ワーク スペースで生成

し た り 、 p4 integrate を使って ク ラ イ アン ト ・ ワーク スペースで 1 つのフ ァ イルのグルー

プを生成し た り し て も、 まだそれをサブ ミ ッ ト し ていなければ、 それらの新しいフ ァ イルは

p4 have の出力には表示されません。

ク ラ イ アン ト ・ ワーク スペースに存在するすべてのフ ァ イルの集合 （フ ァ イル ・ セ ッ ト ） は、

p4 have によ って リ ス ト される フ ァ イル・セ ッ ト と p4 opened によ って リ ス ト される フ ァ イ

ル ・ セ ッ ト を組み合わせた ものに相当し ます。

• 特殊文字 @、 #、 *、 および % を含んでいる フ ァ イルの場合、 次の例のよ う に、 depot-file

フ ィ ール ド にその文字の 16 進値の ASCII 表現が表示され、 local-path フ ィ ール ド に特殊

文字が表示されます。

//depot/status/100%25.txt#1 - /staff/status/100%.txt

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 109

p4 have

使用例

関連コ マン ド

p4 sync //depot/name...p4 have //depot/name

p4 sync //depot/name/...#4p4 have //depot/name

左に示す 2 組のコマン ド の場合、 第 1 の組の p4 have は、 ク

ラ イ アン ト ・ ワーク スペースにコ ピーされている フ ァ イルの

新 リ ビジ ョ ンを表示し ます。

第 2 の組の p4 have は、 現在ク ラ イ アン ト ・ ワーク スペース

にあ るのが リ ビジ ョ ン 4 であ る こ と を示し ます。

デ ィ ポか ら ク ラ イ アン ト ・ ワーク スペースへ、 フ ァ イル ・ リ ビジ ョ ン を コ

ピーする。

p4 sync

110 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 help

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 111

p4 help

概要

PERFORCE のオン ラ イ ン ・ ヘルプ情報を表示し ます。

構文

p4 [g-opts] help p4 [g-opts] help keyword p4 [g-opts] help command

解説

p4 help は、 名前を指定し た コマン ド またはキーワード を説明するヘルプ画面を表示し ます。

説明内容はこのマニュ アル と よ く 似ていますが、 テキス ト は開発者が書いています。

引数の付いていない p4 help は、利用可能な p4 help オプシ ョ ンをすべて リ ス ト 表示し ます。

p4 help command は、 名前を指定し た コ マン ド に関するヘルプ情報を表示し ます。 p4 help

keyword は次のキーワード を引数 と し て と り ます。

使用上の留意点

関連コ マン ド

コマン ド とキーワー ド 意味 このマニュアル中の

関連箇所

p4 help simple も基本的な 8 つの PERFORCE コマン ド

に関する短い説明を表示し ます。

（特にな し）

p4 help commands すべてのPERFORCE コマン ド を リ ス ト 表

示し ます。

「目次」

p4 help charset Unicode 変換の制御方法を説明し ます。 P4CHARSET の 「解説」 の項

p4 help environment PERFORCE環境変数 と その意味を リ ス ト

表示し ます。

「環境変数と レジス ト リ 変数」

p4 help filetypes PERFORCE のフ ァ イルタ イプ と その意味

を リ ス ト 表示し ます。

「フ ァ イルタ イプ」

p4 help jobview PERFORCE ジ ョ ブ・ビ ューを説明し ます。 p4 jobs の 「解説」 の項

p4 help revisions PERFORCE リ ビジ ョ ン指定子を説明し ま

す。

「フ ァ イル指定」

p4 help usage すべてのPERFORCE コマン ド で利用でき

る 6 つのオプシ ョ ンを リ ス ト 表示し ま

す。

「グ ローバル ・ オプシ ョ ン」

p4 help views PERFORCE のビ ュ ーの意味を説明 し ま

す。

「ビ ュー」

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 な し

PERFORCE の現在の構成に関する情報を参照する。 p4 info

p4 info

112 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 info

概要

現在の PERFORCE アプ リ ケーシ ョ ンおよび共有バージ ョ ン化サービ スに関する情報を表示し ま

す。

構文

p4 [g-opts] info [-s]

解説

p4 info コマン ド は、PERFORCE アプ リ ケーシ ョ ンおよび共有バージ ョ ン化サービ スに関する情

報を表示し ます。

p4 info によ る出力の例を次に示し ます。

PERFORCE アプ リ ケーシ ョ ン （p4） のバージ ョ ンを確認するには、 p4 -V を使用し ます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

User name: joeClient name: joes_clientClient host: joes_workstationClient root: /usr/joe/projectsCurrent directory: /usr/joe/projects/sourceClient address: 192.168.0.123Server address: p4server:1666Server root: /usr/depot/p4dServer date: 2012/01/28 12:11:47 -0700 PDTServer uptime: 752:41:33Server version: P4D/FREEBSD/2012.1/406375 (2012/01/25)Server license: P4Admin <p4adm> 20 users (expires 2013/01/01Server license-ip: 10.0.0.2Case handling: sensitive

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

-s 出力の短縮。 データベース ・ ル ッ ク ア ッ プを必要 と する情報 （ワー ク スペース ・

ルー ト など） を除外し ます。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 な し

PERFORCE のヘルプ情報を表示する。 p4 help

PERFORCE プロ キシの接続情報を表示する。 p4 proxy

現在使用し ている PERFORCE アプ リ ケーシ ョ ンのバージ ョ ン情報を参照する。 p4 -V

p4 integrate

p4 integrate

概要

ブラ ンチまたはマージする フ ァ イルを作業状態にし ます。

構文

p4 [g-opts] integrate [options] fromFile[revRange] toFilep4 [g-opts] integrate [options] -b branch [-r] [toFile[RevRange]...]p4 [g-opts] integrate [options] -b branch -s fromFile[revRange] [toFile...]p4 [g-opts] integrate [options] -S stream [-r] [-P parent] fromFile[revRange]

options: -c changelist -Dflags -f -h -Oflags -n -m max -q -v

解説

1 つの フ ァ イ ルに対 し て行っ た変更を他の フ ァ イ ルに も 伝達す る 必要があ る 場合には、 p4

integrate でそのプ ロ セス を開始し ます。 こ の コ マン ド の も単純な形式は p4 integrate

fromFile toFile と い う 形式で、これはバージ ョ ン化サービ スにfromFileの変更を toFileに

伝達する必要があ る こ と を知らせ、 次のよ う な動作を行います。

• toFile がまだ存在し ていなければ、fromFile を toFile にコ ピーし た上で、ク ラ イ アン ト ・

ワーク スペースで toFile をブラ ンチのための作業状態にし ます。

• toFile が存在し、 上記のよ う に fromfile と共通の祖先を持つ場合、 toFile を反映のため

の作業状態にし ます。 こ の場合には、 p4 resolve を用いて fromFile の変更のすべて、 ま

たは一部を toFile に伝達するか、 あ るいは伝達し ないかの選択を し ます。 p4 resolve コ

マン ド は、 theirs と し て fromFile を、 yours と し て toFile を、 base と し て fromFile

の共通の祖先をそれぞれ使用し ます。

p4 resolve コマン ド は、theirs と し て fromFile を、 yours と し て toFile を使用し、base

と し て （衝突解決が p4 integrate によ ってスケジ ュールされていた場合） fromFile の

も近い共通の祖先または （衝突解決が p4 merge によ ってス ケジ ュールされていた場合） 共

通の編集が も多いフ ァ イルを使用し ます。

• toFile と fromFileの両方が存在するが、toFile が fromFile と共通の祖先を持たない場合

は、 反映操作は拒否されます。 -i オプシ ョ ン を使用する と、 ベース レ ス ・ マージが強制さ

れます。

• fromFile が 新 リ ビジ ョ ンで削除されている場合、（そ し て fromFile と toFile 間の前回

までの変更がすべて反映されていれば）、toFile を ク ラ イ アン ト ・ ワーク スペースで削除の

ための作業状態にし ます。

（利用可能なオプシ ョ ンの中には、 こ の動作を変更する も の も あ り ます。 詳し く は、 次のセ ク

シ ョ ン 「オプシ ョ ン」 をご覧 く だ さい。）

こ のプロセスは、 デ ィ ポに対し て p4 submit toFile を実行し た時点で完了し ます。

複数のフ ァ イルを指定するには、 fromFile の場合も toFile の場合も ワ イル ド カー ド を使用

し ます。 fromFile で使用する ワ イル ド カー ド と toFile で使用する ワ イル ド カード は一致し

ていなければな り ません。 PERFORCE は fromFile のパターン と toFile のパターンを比較し、

fromFile/toFile のペアの リ ス ト を生成し、 各ペアご と に反映操作を実行し ます。

p4 integrate fromFiles toFilesの形式では、fromFilesの変更を toFilesに伝達する 必要

が生じ る たびに、 fromFiles と toFiles の間のマッ ピングを指定する 必要があり ま す。 こ れに

代わる 方法は、 p4 branch で fromFiles と toFiles の間のマッ ピングを ブラ ンチ ・ ビ ューに

保存し 、 fromFiles と toFiles の間で変更を伝達する 必要が生じ る たびに p4 integrate -b

branchview を使用する 、 と いう も のです。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 113

p4 integrate

ほ と んどの場合、 変更を ス ト リ ーム間 （またはブラ ンチ間） で伝播するには、 コマン ド と し て

p4 merge および p4 copy を使用し ます。 p4 integrate によ ってフ ァ イルの衝突解決がスケ

ジ ュールされる場合は、 も近い共通の祖先が base と し て選択されます。 p4 merge の場合は、

反映元フ ァ イルおよび反映先フ ァ イルで共通の編集が も多い リ ビジ ョ ンが （base と し て） 選

択されます。

オプシ ョ ン

比較的新しい反映オプシ ョ ンの中には、 反映プロセス を よ り 複雑にする ものがあ るので、 反映

用オプシ ョ ンは基本オプシ ョ ン と応用オプシ ョ ンに分けています。

反映用基本オプシ ョ ン

反映用応用オプシ ョ ン

-b branchname [toFiles...]

branchname のブラ ンチ・ ビ ューにあ る sourceFile/targetFileのマ ッ ピ ング を利用し てフ ァ イルの反映操作を行います。 toFilesの引数が与え られていれば、 toFiles によ って指定されたパターン

に合致するブラ ンチ ・ ビ ューの反映先フ ァ イルだけが含まれます。

toFiles で リ ビジ ョ ン範囲が指定されている場合、 その範囲は反映

先 リ ビジ ョ ンではな く 反映元 リ ビジ ョ ンの範囲を示し ます。

-n 実際の反映操作は行わずに、 このコマン ド が実行する こ と になる反映

操作を表示し ます。

-v toFilesを ク ラ イ アン ト ・ワーク スペースにコ ピーせずにフ ァ イルを

ブラ ンチのための作業状態にし ます。

このオプシ ョ ンが付いていなければ、 p4 integrate は新たにブラ

ンチされた toFiles を fromFilesから ク ラ イ アン ト ・ワーク スペー

ス に コ ピー し ます。 こ の -v (virtual ) オプシ ョ ンが付いてい る と、

toFilesが ク ラ イ アン ト ・ワーク スペースにコ ピーされないため時間

を節約でき ます。 ただし、 それが必要な と きには、 p4 sync で取 り

出すこ と ができ ます。

-c changelist 指定し た作業中チェ ンジ リ ス ト 内の toFiles を、 ブラ ンチ作成、 反

映、 または削除のための作業状態にし ます。

このオプシ ョ ンが付いていなければ、フ ァ イルはデフ ォル ト のチェ ン

ジ リ ス ト 内で作業状態にされます。

-q ク ワ イエ ッ ト ・ モード。 反映、 コ ピー、 マージの対象と なる フ ァ イル

の リ ス ト に関する、 通常の出力 メ ッ セージを抑止し ます。 エラーまた

は例外的状態に関する メ ッ セージは表示されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

-b branchname -sfromFile[RevRange][ToFiles...]

も単純な形式 p4 integrate -b branchname -s fromFile で

は、 branchname のブラ ンチ ・ ビ ューに含まれる反映元 / 反映先の

マ ッ ピ ングを用いてフ ァ イルの反映を行 う こ と ができ ます。 ただし、

反映元フ ァ イルはfromFileで指定されたパターンに合致する ものに

限られます。

も っ と複雑な形式で fromFile も toFile も指定する と、反映は両方

向に実行されます。 まず、 反映は fromFile から toFile へ行われ、

次に toFile から fromFile へ行われます。

p4 integrate のこのバ リ エーシ ョ ンは、PERFORCE のグ ラ フ ィ ッ ク ・

アプ リ ケーシ ョ ンに必要な機能を与え る ために作成 さ れた も のです

が、 形式が複雑なので使用する こ と はまれです。

-b branchname -r [toFiles...]

ブラ ンチ ・ ビ ューのマ ッ ピングを逆にし、 反映先フ ァ イルから反映元

フ ァ イルへの反映を行います。

114 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 integrate

使用上の留意点

• p4 integrate は p4 integ と略記する こ と ができ ます

• FromFiles は通常、 反映元フ ァ イル、 toFiles は通常、 反映先フ ァ イル と呼びます。

• p4 integrateの動作対象と な るtoFilesは、必ずp4 clientのビ ューに含まれていなければ

な り ません。

• デフ ォル ト では、 p4 integrate でブラ ンチまたは反映のための作業状態に されたフ ァ イル

は、 ク ラ イ アン ト ・ ワーク スペースでは読み取 り 専用です。 これらのフ ァ イルは、 サブ ミ ッ

ト 前に、 p4 edit であ ら ためて編集のための作業状態にする こ と ができ ます。

• PERFORCE は、fromFile から toFile への反映が行われる たびに、その反映の結果を記述する

反映記録をデータベースに生成し ます。 この反映記録には、 fromFile および toFile の名

前、 toFile に反映された fromFile の リ ビジ ョ ン、 toFile の新しい リ ビジ ョ ン番号、 反映

時 に と ら れ た ア ク シ ョ ン （操 作） が 含 ま れ ま す。 反 映 操 作 に つ い て 詳 し く は、 「p4

integrated」 のセ ク シ ョ ンをご覧 く だ さい。

• ほ と んどの場合、 p4 integrate は遅延コ ピーを行います。 フ ァ イルの内容はサーバには複

製されません。 それは、 反映レ コード にフ ァ イルの再生のために十分な情報が含まれている

からです。 反映操作は一時オブジェ ク ト ・ フ ァ イルに対し て行われ （+S および +Sn）、 遅延

コ ピーは作成されません。反映された tempobj フ ァ イルはサーバ上で追加のデ ィ ス ク スペー

ス を消費し ます。

• リ リ ース 2012.2 では 2 つの反映エンジンがサポー ト されています。

新しい反映エンジン （v3） は リ リ ース 2011.1 で導入され、 ベース選択時の意味規則が改善

され、 衝突解決機能が拡張されています。 デフ ォル ト の反映エンジンは依然と し て v2 です。

これは 2006 年の 初の リ リ ース時から提供されています。

-Dt-Ds-Di

-Dtオプシ ョ ンは削除された反映先フ ァ イルに関する反映を可能にし

ます。 すなわち、 反映先フ ァ イルが削除されている場合、 ブラ ンチさ

れた反映元フ ァ イルから リ ス ト ア されます。

-Dsオプシ ョ ンは削除された反映元フ ァ イルに関する反映を可能にし

ます。 すなわち、 反映元フ ァ イルが削除されている場合、 更新された

反映先フ ァ イルもすべて削除されます。

-Di オプシ ョ ンは、 反映操作のベースの検索時に、 反映元フ ァ イルが

削除され再追加された と い う 事実を無視し ます。

-f fromFileおよびtoFileのすべての リ ビジ ョ ンに対し て、た と えその

一部の リ ビジ ョ ンが過去に反映操作を されていて も、 反映を強制し ま

す。 リ ビジ ョ ン範囲 と共に使用する こ と が 適です。

-h 反映操作の前に、 反映先フ ァ イ ルを 新 リ ビ ジ ョ ンに同期する処理

を、 自動的には行いません。 代わ り に現在のワーク スペースにあ る リ

ビジ ョ ンを使用し ます。

-m max コマン ド で反映を実行する フ ァ イルを初めの max 個に制限し ます。

-Ob -Ob オプシ ョ ンは、（も し あれば）マージ用の base リ ビジ ョ ンを出力し

ます。

-Or -Or オプシ ョ ンは、 スケジュールされている衝突解決を出力し ます。

-S stream [-P parent] ス ト リ ームをその親に反映し ます。 設定された親を無視し て別のス ト

リ ームに反映するには、 -P を指定し ます。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 open

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 115

p4 integrate

新しい PERFORCE イ ン ス ト ールでは、 新しい反映エンジンをデフ ォル ト で選択する こ と が推

奨されています。 既存のイ ン ス ト ールでは、 個々のコードベースに対する p4 merge および

p4 integrate の動作を比較し、 準備ができ た らサイ ト 全体で新しいエンジンに切 り 替え る

こ と によ り 、 2 つのエンジンを比較でき ます。 （p4 merge コマン ド では常に新しい v3 エン

ジンを使用する こ と によ り 、 反映操作が単純化されています。 ス ト リ ーム ・ ベースのブラ ン

チ戦略を採るユーザは既に新しいエンジンを使用し ています。）

新しい反映エンジンをサイ ト 全体で有効にするには、 構成可能変数 dm.integ.engine をデ

フ ォル ト 値 2 の代わ り に 3 に設定し ます。

p4 configure set dm.integ.engine=3

詳し く は、 PERFORCE ナレ ッ ジベース を参照し て く だ さい。

http://kb.perforce.com/article/1631/generation-3-integration-engine

使用例

関連コ マン ド

p4 integ //depot/dev/... //depot/rel2/... //depot/dev/... のすべてのフ ァ イル

を //depot/rel2/... の対応する フ ァ

イルにブラ ンチまたはマージ し ます。

//depot/rel2/... 内に対応する フ ァ

イルが存在し ない場合は、 こ のコ マン ド

で生成されます。

p4 integ -b rel2br ブラ ンチ ・ ビ ュー rel2br に含まれるす

べ て の fromFiles を そ のブ ラ ン チ ・

ビ ュ ーのマ ッ ピ ン グ に従い、 対応す る

toFiles にブ ラ ンチま たはマージ し ま

す。

p4 integ -b rel2br //depot/rel2/headers/... ブラ ンチ・ ビ ューrel2br の fromFilesを //depot/rel2/headers/... に

マ ッ ピング し、toFiles にブラ ンチまた

はマージ し ます。

p4 integ -b rel2br -r //depot/rel2/README ブラ ンチ ・ ビ ュー rel2br のマ ッ ピング

に従 っ て //depot/rel2/README を

toFile から fromFile へブラ ンチまた

はマージ し ます。

ブラ ンチ ・ マ ッ ピングを生成または編集する。 p4 branch

既存のブラ ンチ ・ マ ッ ピングの リ ス ト を参照する。 p4 branches

すでに実行されサブ ミ ッ ト された反映の リ ス ト を参照する。 p4 integrated

p4 integrateでフ ァ イルを作業状態にし た後、1つのフ ァ イルから別

のフ ァ イルへ変更を伝達する。

p4 resolve

特定のフ ァ イルに対し て実行されたあ ら ゆる反映の履歴を参照する。 p4 filelog

116 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 integrated

p4 integrated

概要

サブ ミ ッ ト 済みの反映を表示し ます。

構文

p4 [g-opts] integrated [ -r ] [ -b branch ] file...

解説

p4 integrated コマン ド は、 選択されたフ ァ イル反映履歴を次の形式で表示し ます。

file#revision-range - integrate-action partner-file#revision-range

こ こ で

• file は、 p4 integrated に与え られたフ ァ イル引数です。

• partner-file は、 前記フ ァ イルの反映元または反映先と なったフ ァ イルです。

• integrate-action は、p4 resolve のプロセス中にユーザが行ったア ク シ ョ ンの記述で、次

のいずれかにな り ます。

反映操作 p4 Resolve のプロセス中にユーザが行ったアクシ ョ ン

branch from file が事前に存在せず、 partner-file のコ ピー と し て生成された。

branch into partner-file が事前に存在せず、 file のコ ピー と し て生成された。

merge from file が partner-file から反映され、 merge が受け入れられた。

merge into file が partner-file に反映され、 merge が受け入れられた。

moved from fileが partner-fileから反映され、theirsが受け入れられて元のフ ァ イルが

削除された。

moved into fileがpartner-fileに反映され、theirsが受け入れられてpartner-fileが

作成された （既に存在し ていなかった場合）。

copy from file が partner-file から反映され、 theirs が受け入れられた。

copy into file が partner-file に反映され、 theirs が受け入れられた。

ignored file が partner-file から反映され、 yours が受け入れられた。

ignored by file が partner-file に反映され、 yours が受け入れられた。

delete from file が partner-file から反映された。partner-file は事前に削除されてい

た。

delete into file が partner-file に反映された。 file は事前に削除されていた。

edit from fileが partner-fileから反映され、fileは p4 resolveのプロセス中に編集

された。 これによ ってユーザは、 こ の変更を反映し直すべきか判断でき る。 例え

ば、 自動的な変更 （merge from） は反映し直す必要はないが、 resolve 中に行

われたユーザの編集 （edit from） は反映させる必要があ る、 と いった判断が可

能になる。

edit into fileがpartner-fileに反映され、partner-fileはサブ ミ ッ ト 前に編集のため

に再度作業状態にされた。

add from file は削除された partner-file から反映され、partner-file は追加のため

に再度作業状態に された （つま り 、 誰かが削除前の リ ビジ ョ ンに同期し てフ ァ イ

ルを追加する こ と によ り 、 削除フ ァ イルを復元し た）。

add into fileが事前に存在し なかったpartner-fileに反映され、partner-fileはサブ

ミ ッ ト 前に追加のために再度作業状態にされた。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 117

p4 integrated

フ ァ イ ル toFile がフ ァ イ ル fromFile か ら 反映 さ れ、 toFile と fromFile が と も に p4

integrated の filepattern 引数に合致し ていれば、個々の反映操作は p4 integrated の出力

中に 2 回 リ ス ト されます。 すなわち、 前記の from フ ォーム内、 および into フ ォーム内にそ

れぞれ 1 回ずつ リ ス ト されます。

任意指定の -b branch オプシ ョ ンが使用される と、 ブラ ンチ･ビ ューにおいて反映元から反映

先に反映されたフ ァ イルのみが表示されます。

任意指定の -r オプシ ョ ンが指定される と、 ブラ ンチ ・ ビ ューのマ ッ ピ ングが逆に されます。

こ のオプシ ョ ンは -b branch オプシ ョ ン と一緒に使用する必要があ り ます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 list

フ ァ イル衝突未解決の反映の リ ス ト を見る。 p4 resolve -n

フ ァ イル衝突は解決されたが、 まだサブ ミ ッ ト されていない反映の リ

ス ト を見る。

p4 resolved

反映を実行する。 p4 integrate

特定フ ァ イ ルのすべての リ ビ ジ ョ ン （その特定フ ァ イ ルの反映元 と

なったすべてのフ ァ イルを含む） について と られたア ク シ ョ ンを参照

する。

p4 filelog [-i] file

118 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 interchanges

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 119

p4 interchanges

概要

まだ反映されていない変更を報告し ます。

構文

p4 [g-opts] interchanges [options] fromFile[revRange] toFilep4 [g-opts] interchanges [options] -b branchname [toFile[RevRange]...]p4 [g-opts] interchanges [options] -b branchname -s fromFile[revRange] [toFile...]p4 [g-opts] interchanges [options] -S stream -P parent [file[RevRange]] [toFile...]

options: -f -l -r -t

解説

p4 interchanges コマン ド は、反映元フ ァ イル集合から反映先フ ァ イル集合にまだ反映されて

いない変更を一覧表示し ます。

オプシ ョ ン

使用上の留意点

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

-b branchname 指定されたブ ラ ンチ仕様によ って定義された と お り に反映元 と 反映先

を使用し ます。

-b branchname -sfromFile[RevRange][ToFiles...]

双方向の反映をプレ ビ ューし ます（PERFORCE ク ラ イ アン ト ・アプ リ ケー

シ ョ ンによ り 使用。 詳し く は p4 integrate をご覧 く ださい。）

-S stream [-P parent] ス ト リ ーム と その親 と の間で保留中の反映を表示し ます。

-f 反映が必要なフ ァ イルを一覧表示し ます。一部のみ反映されたチェ ンジ

リ ス ト は、 個別に反映済みであ る場合にも表示される こ と があ り ます。

-l 長い形式 : チェ ンジ リ ス ト 説明の完全なテキス ト を含めます。

-r 反映元 と反映先を逆にし ます （つま り 、 反映の方向を逆にし ます）。

-t チェ ンジ リ ス ト がサブ ミ ッ ト された日付 と時刻を表示し ます。デフ ォル

ト では、 日付のみが表示されます。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 list

p4 istat

120 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 istat

概要

ス ト リ ームに必要な反映があ るかど う かチェ ッ ク し ます。

構文

p4 [g-opts] istat [ -a -c -r -s ] stream

解説

親ス ト リ ームの観点か ら必要 と される反映があ るかど う かをチェ ッ ク し ます。 （主に、 ステー

タ ス を人間が読み取 り 可能な形式にレ ンダ リ ングする ための、 PERFORCE アプ リ ケーシ ョ ンに

よ る ステータ スのチェ ッ クに用いられます。）

オプシ ョ ン

使用上の留意点

• -c オプシ ョ ンは、P4V （PERFORCE ビジ ュ アル ・ ク ラ イ アン ト ） に関連する診断およびキ ャ ッ

シ ュ整合性のチェ ッ ク に使用する ためのものです。

関連コ マン ド

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

-a 親ス ト リ ームを反映元または反映先 とするすべての反映をチェ ッ ク し ます。

-c 反映履歴をチェ ッ クする前に、 キ ャ ッ シ ュ情報を ク リ ア し ます。 診断に使用する

ためのオプシ ョ ンです。

-r 親ス ト リ ームから必要 と される反映をチェ ッ ク し ます。

-s ス ト リ ームの ス テー タ ス を表示 し、 デー タ ベース ・ ク エ リ を実行せずにキ ャ ッ

シュ ・ データ を生成し ます。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

現在のワーク スペースの変更 / 同期ステータ ス を表示する p4 cstat

p4 job

p4 job

概要

欠陥、 改善要求、 またはその他のジ ョ ブ仕様の生成または編集を行います。

構文

p4 [g-opts] job [ -f ] [ jobName ]p4 [g-opts] job -d jobNamep4 [g-opts] job -o [ jobName ]p4 [g-opts] job -i [ -f ]

解説

ジ ョ ブ と は、 デ ィ ポのフ ァ イルに対し て実行する必要のあ る作業を記述し た も のです。 場合

によ っては、 バグの記述 （例えば、 「ス ク ロール機構が正常に動作し ていない」）、 あ るいは改

善要求 （例えば、 「……の動作の発生を強制するオプシ ョ ンの追加を望む」） などにな る こ と も

あ り ます。

ジ ョ ブは、システムに対する変更を任意のテキス ト と し て記述する と い う 点でチェ ンジ リ ス ト

の記述 と似ていますが、 チェ ンジ リ ス ト は完了し た作業を記述するのに対し、 ジ ョ ブは行 う 必

要のあ る作業を開発者に伝え る ものです。

ジ ョ ブは、 p4 job によ って表示される フ ォームで生成 ・ 編集し ます。 ユーザはそのフ ォーム

に、 ジ ョ ブを記述する テキ ス ト を、 バグの重要度やバグ修正を担当する開発者と いった情報と

と もに入力し ます。 PERFORCE スーパー ・ ユーザは、 p4 jobspec でジ ョ ブ ・ フ ォームのフ ィ ー

ル ド を変更でき るので、 1 つのジ ョ ブを構成する フ ィ ール ド は個々の PERFORCE イ ン ス ト ール

によ って異なって き ます。

p4 jobが引数な しで実行される と、jobNNNNNN と い う 新しいジ ョ ブが生成されます。NNNNNNは

6 桁の連番です。 このジ ョ ブの名前は、 エデ ィ タ を終了する前にフ ォーム上で変更する こ と が

でき ます。 p4 job を jobname の引数付きで実行する と、 その名前のジ ョ ブが生成され、 すで

に同じ名前のジ ョ ブが存在し ている場合には、 そのジ ョ ブの編集を行 う こ と ができ ます。

ジ ョ ブが生成された ら、そのジ ョ ブを p4 fix、p4 change、または p4 submit で修正するチェ

ンジ リ ス ト に リ ン ク させる こ と ができ ます。ジ ョ ブがチェ ンジ リ ス ト に リ ン ク されている場合

には、 通常、 ジ ョ ブの状態は closed にな り ます。 （詳し く は下記 「使用上の留意点」 をご覧 く

ださい）

フ ォーム ・ フ ィ ールド

以下に紹介するのは、 デフ ォル ト のジ ョ ブ ・ フ ォームに表示される フ ィ ール ド です。 ジ ョ ブを

記述する フ ィ ール ド は、 PERFORCE スーパー ・ ユーザによ って変更される こ と があ るので、 実

際に表示される フ ォームのフ ィ ール ド は、 これ と は異な る可能性があ り ます。

フ ィ ールド名 タ イプ 説明

Job: 書き込み可能 ジ ョ ブの名前です。 新しいジ ョ ブの場合、 こ のフ ィ ール ド の

値は new です。 フ ォームを閉じ る と、 new がジ ョ ブ発番シー

ケン スの次の 6 桁の連番 NNNNNN を含む jobNNNNNN と い う

名前に置き換わ り ます。

こ のフ ィ ール ド の文字を入力し直すこ と によ り 、 ジ ョ ブに任

意の名前を付ける こ と もでき ます。

Status: 書き込み可能、 既

定値

こ のフ ィ ール ド の値は open、 closed、 または suspendedでなければな り ません。 ジ ョ ブがチェ ンジ リ ス ト に リ ン ク さ

れていれば、 こ のフ ィ ール ド の値は、 チェ ンジ リ ス ト がサブ

ミ ッ ト された と きに closed に設定されます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 121

p4 job

オプシ ョ ン

使用上の留意点

• PERFORCE スーパー ・ ユーザが p4 jobspec でフ ィ ール ド ID# 102 （［Status:］ フ ィ ール ド）

を削除し た場合、 PERFORCE は、 ジ ョ ブが リ ン ク されているチェ ンジ リ ス ト がサブ ミ ッ ト さ

れて も そのジ ョ ブを closed にする こ と ができ な く な り ます。 詳し く は、 p4 jobspec の項

および 『システム管理者ガイ ド』 をご覧 く だ さい。

• ジ ョ ブが生成または変更される と、 PERFORCE はジ ョ ブにイ ンデッ ク ス を付け、 p4 jobs -e が速やかにそのジ ョ ブ を見つけ ら れ る よ う に し ま す。 イ ンデ ッ ク ス ・ キーは word、

fieldname です。word は大文字 / 小文字を区別せず、句読法 （区切 り 文字やスペース） も使

用でき ます。日付のフ ィ ール ド の値は1970年1月1日00:00:00からの秒数 と し て保存されます。

使用例

関連コ マン ド

User: 書き込み可能 ジ ョ ブを生成し たユーザの名前です。

Date: 書き込み可能 ジ ョ ブが生成された日付です。

Description: 書き込み可能 ジ ョ ブに関する コ メ ン ト を記述する こ と ができ ます。

-d jobname 関連する作業中またはサブ ミ ッ ト 済みの修正がない場合に限 り 、 ジ ョ ブ jobnameを削除し ます。

-f 強制オプシ ョ ンです。 PERFORCE 管理者に読み取 り 専用フ ィ ール ド の編集を認めま

す。

-i エデ ィ タ を立ち上げずに標準入力から ジ ョ ブ ・ フ ォームを読み込みます。

-o エデ ィ タ を立ち上げずに標準出力へジ ョ ブ ・ フ ォームを書き出し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open

p4 job 新 し い ジ ョ ブ を 生成 し ま す。 デ フ ォ ル ト で は、 そ の ジ ョ ブ の 名前 は

jobNNNNNN にな り ます。

p4 job job000135 ジ ョ ブ job000135 を編集し ます。

ジ ョ ブのすべて、 または一部を リ ス ト 表示する。 p4 jobs

ジ ョ ブを既存のチェ ンジ リ ス ト に リ ン クする。 p4 fix

ジ ョ ブ と それを修正するチェ ンジ リ ス ト の リ ス ト を参照する。 p4 fixes

作業中チェ ンジ リ ス ト に対する ジ ョ ブの追加または削除を行 う 。 p4 change

サイ ト における ジ ョ ブの形式を変更する （スーパー・ユーザのみ使用可能）。 p4 jobspec

サイ ト における ジ ョ ブの形式に関する情報を読み出す。 p4 jobspec -o

フ ィ ールド名 タ イプ 説明

122 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 jobs

p4 jobs

概要

PERFORCE バージ ョ ン化サービ スに既知のジ ョ ブを リ ス ト 表示し ます。

構文

p4 [g-opts] jobs [-e jobview] [-i] [-l] [-r] [-m max] [file[rev] ...]p4 jobs -R

解説

p4 jobs は、引数な しで実行される と、PERFORCE に保存されているすべてのジ ョ ブを リ ス ト 表

示し ます。 こ のコマン ド の出力は、 オプシ ョ ンや引数で様々な基準を指定する こ と によ り 、 制

限する こ と ができ ます。 フ ァ イル ・ パターンを指定すれば、 リ ス ト 表示される ジ ョ ブは特定の

フ ァ イルに影響を及ぼすチェ ンジ リ ス ト に リ ン ク された ものだけに制限されます。-eオプシ ョ

ンを使用すれば、 リ ス ト 表示されたジ ョ ブを さ らに特定の語を含むものだけに制限する こ と が

でき ます。

ジ ョ ブは、 その名前をキーと し て、 英数字の昇順 （あ るいは、 -r オプシ ョ ンを使えば、 降順）

に、 1 行に 1 つずつ表示されます。 各行の形式は次の とお り です。

jobname on date by user *status* description

description は、-l (long) オプシ ョ ンが使用されていない限 り 、先頭から 31 字までに制限され

ます。

date、 user、 status、 または description のフ ィ ール ド のいずれかが、 PERFORCE スーパー ・

ユーザによ り p4 jobspec で削除されている場合、 そのフ ィ ール ド の値は各ジ ョ ブの出力に表

示されません。

ジ ョ ブの リ ス ト を、特定フ ァ イルに関連するチェ ンジ リ ス ト によ って修正された ものだけに制

限するには、 p4 jobs filespec を使用し ます。 フ ァ イルまたはフ ァ イル ・ パターンの指定に

は、 リ ビジ ョ ン指定子または リ ビジ ョ ン範囲を含める こ と ができ ます。

オプシ ョ ン

-e jobview jobview によ って指定された基準に合致する ジ ョ ブだけを リ ス ト 表示し ます。

ジ ョ ブ ・ ビ ューについては、 下記 「使用上の留意点」 をご覧 く ださい。

-i files... 指定フ ァ イルに反映されたフ ァ イルに関連するチェ ンジ リ ス ト によ って修正さ

れたジ ョ ブも含めます。

-l 各ジ ョ ブの完全な記述を出力し ます。

-m max 英数字の昇順にソー ト し、 先頭から max の数だけのジ ョ ブを表示し ます。-r オ

プシ ョ ンを付ければ、 英数字の降順にソー ト し、 先頭から max の数だけのジ ョ

ブが表示されます。

-r ジ ョ ブを、 その名前をキーと し て、 英数字の降順で表示し ます。

-R ジ ョ ブ ・ テーブルを再構築し、 各ジ ョ ブにあ ら ためて イ ンデッ ク ス を付けます。

この操作は、バージ ョ ン 98.2 よ り 前のバージ ョ ンからのア ッ プグレード、およ

び 99.1 から 2001.1 よ り 新しいバージ ョ ンへのア ッ プグレード を行 う 際に必

要 と な り ます。 また、 既存のジ ョ ブを検索する際に、 句読法 （区切 り 文字やス

ペース） を使用し たい と きにも必要と な り ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 123

p4 jobs

使用上の留意点

ジ ョ ブ ・ ビ ュー

p4 jobs -e jobview を使用すれば、 リ ス ト 表示する ジ ョ ブを特定の語を含むジ ョ ブだけに制

限する こ と ができ ます。 検索する語は特定のフ ィ ール ド について指定する こ と も でき ますし、

ジ ョ ブのテキス ト について指定する こ と も でき ます。 また、 テキ ス ト に検索語を指定する場合

ほど多 く のオプシ ョ ンは使えませんが、日付のフ ィ ール ド の値を検索語に指定する こ と も でき

ます。 bulk タ イプのジ ョ ブ ・ フ ィ ール ド には検索用のイ ンデッ ク スは付け られません。

検索語の適合は大文字 / 小文字の区別な く 調べられます。 スペースによ って区切られた文字列

は、 （句読法が埋め込まれていて も） すべて単語と し て イ ンデッ ク ス されます。

ジ ョ ブ ・ ビ ューを ‘word1 word2 ... wordN’ と記述すれば、 word1 から wordN までのすべて

をいずれかのフ ィ ール ド に含んでいる ジ ョ ブが検索されます。

ジ ョ ブ ・ ビ ューの検索語の間のスペースは、 論理演算子 AND と し て機能し ます。 前記の検索語

のいずれかを含むジ ョ ブを検索するには、 検索語を “|” で区切 り ます。

アンパーサン ド （&） も論理演算子 AND と し て使えます。論理演算子は （優先権の高い順に） &、

|、 スペースの順に結合し ます。 結合の優先度を変えたい場合には、 （ ） を使用し ます。

検索結果は、 ジ ョ ブ ・ ビ ュー ・ シン タ ッ ク ス “fieldname=value” を用いて特定のフ ィ ール ド

の値を指定する こ と によ り 、 絞 り 込むこ と ができ ます。 value は英数字 （および日本語文字）

および句読法を含んだ ト ーク ンでなければな り ません。

ワ イル ド カード 「*」 を使えば、 特定の文字列を含む単語を指定する こ と も でき ます。 ジ ョ ブ ・

ビ ューに “fieldname=string*” と記述すれば、指定し たフ ィ ール ド に “string”、“stringy”、

“stringlike” などの文字列を含むジ ョ ブを検索する こ と ができ ます。

日付のフ ィ ール ド は、 yyyy/mm/dd あ るいは yyyy/mm/dd:hh:mm:ss の形式で記述する こ と が

でき ます。 特定の時刻が与え られていない場合には、 同値演算子 （=） で日付の適合する ジ ョ

ブが検索されます。

通常の比較演算子 （=、 >、 <、 >=、 <=） も利用でき ます。

さ らに、 NOT 演算子 （^） も否定の比較演算に利用でき ます。 （詳し く は、 下記 「制約」 をご覧

く だ さい。）

正規表現マ ッ チングは、 正規表現マ ッチング演算子 (~=) によ り サポー ト されています。

検索で使用する演算子を文字 と し て含む単語を検索する と きは、 バ ッ ク ス ラ ッ シ ュ （\） でそ

の文字をエス ケープし て く だ さい。 バッ ク ス ラ ッ シ ュ文字を照合するには、 も う 1 つのバッ ク

ス ラ ッ シ ュでエスケープし ます (\\)。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 list

124 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 jobs

これらの演算子の働きは、 比較する ジ ョ ブ ・ フ ィ ール ド のタ イプによ って異な り ます。

フ ィ ール ド タ イ プが よ く わか ら ない場合は、 サ イ ト で使用中のジ ョ ブ仕様を出力す る p4

jobspec -o を実行し ます。 p4 jobspec の ［Fields:］ フ ィ ール ド には、 ジ ョ ブ ・ フ ィ ール ド

の名前 とデータ タ イプが含まれています。 個々のタ イプについては、 「p4 jobspec」 の項をご

覧 く ださ い。

その他の使用上の留意点

• p4 user のフ ォームには ［JobView:］ フ ィ ール ド があ り 、 ジ ョ ブ ・ ビ ューを特定のユーザに

リ ン ク させる こ と ができ ます。 ユーザがこ のフ ィ ール ド にジ ョ ブ ・ ビ ューを入力する と、 そ

のユーザが生成するチェ ンジ リ ス ト において、 こ のフ ィ ール ド のジ ョ ブ ・ ビ ュー と適合する

ジ ョ ブが自動的に表示されます。そのチェ ンジ リ ス ト によ って修正する ジ ョ ブを こ のフ ォー

ムに残し ておき、 そ う でないジ ョ ブは削除する必要があ り ます。

• p4 jobs は、 その出力をジ ョ ブ名で英数字の昇順に並べ替え、 その結果、 ジ ョ ブの並び順は

入力された日付の順序 と一致し ます。 ただし、 PERFORCE で使用される標準的なジ ョ ブ名と

異な る ジ ョ ブ名を使用し ている場合には、 こ の限 り ではあ り ません。

• -m max -r は、英数字の昇順で 後から max の数のジ ョ ブを表示するのであって、新しいも

のから max の数のジ ョ ブを表示するわけではあ り ません。 しかし、 （例えば、 job001394 の

よ う な名前が付 く ） PERFORCE におけるデフ ォル ト のジ ョ ブ命名法を使用し ていれば、 英数

字の昇順と入力日付の古い順が同じにな り ます。

• テキ ス ト タ イプのフ ィ ール ド が値を含んでいるかど う かは、 ワ イル ド カー ド 「*」 を使って

ジ ョ ブ・ ビ ューを “field=*” と記述する こ と によ って確認でき ます。field が空でないジ ョ

ブがすべて検索されます。

• -e jobview オプシ ョ ンを用いてジ ョ ブを検索する場合、 特にワ イル ド カード、 論理演算子、

（） を使用する場合には、 オペレーシ ョ ン ・ シ ス テムおよびコ マン ド ・ シ ェルの構文解析、

引用、 特殊文字のエスケープの動作に注意し て く だ さい。

制約

• ジ ョ ブ ・ ビ ューは、 空のフ ィ ール ド を含むジ ョ ブの検索には利用で き ません。 言い換えれ

ば、 既存のジ ョ ブから あ る フ ィ ール ド が削除された とする と、 該当フ ィ ール ド はイ ンデッ ク

ス されていないこ と にな り 、 その “削除済フ ィ ール ド” の値に適合する ジ ョ ブ ・ ビ ューは存

在し ません。

フ ィ ールド タ イ

プ

比較演算子の働き

word 等号 （=） は、 word フ ィ ール ド の値が厳密に一致する こ と を求めます。

比較演算子は ASCII コード表に従って比較を行います。

text 等号 （=） は、 与え られた値が指定フ ィ ール ド のど こ かに見つかる こ と を求めます。

比較演算子は、 指定フ ィ ール ド のいずれかの 語が与え られた条件に適合すればよい

ので、 こ こ ではあま り 役に立ちません。

例えば、あ る ジ ョ ブに gui bug と い う フ レーズだけを含む ShortDescription と

い う text フ ィ ール ド があ り 、 ジ ョ ブ ・ ビ ューを “ShortDesc<filter” と し た と

する と、 bug<filter なので、 このジ ョ ブも指定に適合する こ と にな り ます。

line 上記のフ ィ ール ド タ イプ text の場合と同じです。

select 等号 （=） は、 指定フ ィ ール ド の値が指定の語の と きに適合と見な し ます。 比較演算

子は ASCII コード表に従って比較を行います。

date 日付は年代順に比較 さ れます。 特定の時刻が与え ら れていない場合は、 演算子 =、

<=、 >= で日付単位の比較が行われます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 125

p4 jobs

• ジ ョ ブ・ ビ ュー内では、NOT 演算子 （^） は AND 演算子の後にしか使えません。つま り 、“gui

^name=joe”、 “gui&^name=joe” と い う ジ ョ ブ ・ ビ ューは有効ですが、 “gui|^name=joe”、

“^name=joe” と い う ジ ョ ブ ・ ビ ューは有効ではあ り ません。

• 上記の制約を回避するには、 ワ イル ド カード 「* 」 が有効です。

例えば、 文字列 “unwanted” を含まないすべてのジ ョ ブを検索するには、 ジ ョ ブ ・ ビ ュー

を “job=* ^unwanted” と 記述し ます。 スペース よ り 前の部分ですべてのジ ョ ブが選択さ

れ、 文字列 “unwanted” を含まないすべてのジ ョ ブ と の論理積 AND が と られます。

同様に、 ジ ョ ブ ・ ビ ュー “field=*” は、 field, が空でない （つま り 、 job フ ィ ール ド は空

ではない と 考え られる） あ ら ゆ る ジ ョ ブ と 適合する ので、 空のフ ィ ール ド を持つジ ョ ブは

“job=* ^field=*” で検索する こ と ができ ます。

• 現時点では、 スペースで区切られたフ ィ ール ド の条件検索は実行で き ません。 例えば、 p4

jobs -e "field=word1 word2"の代わ り にp4 jobs -e "field=word1 field=word2"を使

用し なければな り ません。

使用例

p4 jobs //depot/proj/file#1 //depot/proj/file の リ ビジ ョ ン 1 を含むチェ ン

ジ リ ス ト に添付されたすべてのジ ョ ブを リ ス ト 表示

し ます。

p4 jobs -i //depot/proj/file //depot/proj/file の リ ビ ジ ョ ン、 あ る いは

//depot/proj/fileに反映されたフ ァ イルの リ ビ

ジ ョ ンを含むチェ ンジ リ ス ト に添付されたすべての

ジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e gui いずれかのフ ィ ール ド に単語 gui を含むすべての

ジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e "gui Submitted-By=joe" いずれかのフ ィ ール ド に単語 gui を含み、

［Submitted-By:］ フ ィ ール ド に単語 joe を含むす

べてのジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e "gui ^Submitted-By=joe" いずれかのフ ィ ール ド に単語 gui を含み、

［Submitted-By:］ フ ィ ール ド が joe 以外の値を

と っているすべてのジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e "window*" い ず れ か の フ ィ ー ル ド に 単 語 “window” 、

“window.c”、 “windows” を含むすべてのジ ョ ブを

リ ス ト 表示し ます。 引用符はローカル ・ シ ェルがコ

マン ド ラ イ ン上で “*” を拡張するのを防ぐために使

用し ます。

p4 jobs -e window.c いずれかのフ ィ ール ド で window.c を参照し ている

すべてのジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e "job=* ^unwanted" どのフ ィ ール ド にも単語 unwanted を含まないすべ

てのジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e "(fast|quick)&date>1998/03/14"

いずれかのフ ィ ール ド に単語 fast または quick を

含み、 ［date:］ フ ィ ール ド の値が 3/14/98 以降を

示し ているすべてのジ ョ ブを リ ス ト 表示し ます。

p4 jobs -e "fast|quick" //depot/proj/...

いずれかのフ ィ ール ド に単語 fast または quick を

含み、 //depot/proj のフ ァ イルに影響を及ぼし た

チェ ンジ リ ス ト に リ ン ク されているすべてのジ ョ ブ

を リ ス ト 表示し ます。

126 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 jobs

関連コ マン ド

ジ ョ ブの生成、 または既存のジ ョ ブの編集を行 う 。 p4 job

ジ ョ ブを特定のチェ ンジ リ ス ト に リ ン ク し、 ジ ョ ブがそのチェ ンジ リ ス ト によ っ

て修正される こ と を指示する。

p4 fix

すべてのジ ョ ブ と それが リ ン ク されているチェ ンジ リ ス ト を リ ス ト 表示する。 p4 fixes

特定のチェ ンジ リ ス ト について、 それに リ ン ク されている ジ ョ ブ も含め、 すべて

の情報を参照する。

p4 describe

サーバで使用されている ジ ョ ブの形式を変更する （スーパー ・ ユーザのみ）。 p4 jobspec

サイ ト で使用されている ジ ョ ブの形式に関する情報を読み出す （全ユーザ）。 p4 jobspec -o

デフ ォル ト のジ ョ ブ ・ ビ ューを設定する こ と によ り 、 そのジ ョ ブ ・ ビ ューに適合

する ジ ョ ブがすべての新しいチェ ンジ リ ス ト に含まれる よ う にする。

p4 user

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 127

p4 jobspec

p4 jobspec

概要

ジ ョ ブ ・ テンプレー ト を編集し ます。

構文

p4 [g-opts] jobspecp4 [g-opts] jobspec [-i]p4 [g-opts] jobspec -o

解説

p4 jobspec コマン ド によ り フ ォームが呈示され、 PERFORCE 管理者はジ ョ ブ ・ フ ィ ール ド の編

集、 生成、 削除、 改良を実行でき ます。

p4 jobspec フ ォームのフ ィ ール ド 名 と ジ ョ ブのフ ィ ール ド 名を混同し ないで く だ さ い。 p4

jobspec フ ォームのフ ィ ール ド は、p4 jobs フ ォームのフ ィ ール ド に関する情報の保存に利用

されます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 説明

Fields: サイ ト のジ ョ ブにおける各フ ィ ール ド の定義の リ ス ト で、1 行に 1 フ ィ ール

ド ずつ定義が表示されます。 各行は、 code、 name、 datatype、 length、

fieldtype と い う 形式で表示されます。

･ code: PERFORCE 内部でフ ィ ール ド を識別する固有の整数です。 106 ～

199の整数でなければな り ません。101～105のコード はPERFORCE専用で

す。 詳し く は下記の 「使用上の留意点」 をご覧 く ださい。

･ name: フ ィ ール ド名です。フ ィ ール ド名はいつでも変更でき ますが、いっ

たんジ ョ ブが生成された ら、 コード は変更し ないで く ださい。

フ ィ ール ド名にスペース を含める こ と はでき ません。

･ datatype: フ ィ ール ド のデータ タ イプです。 設定値は次の とお り です。

･ word: 任意の単語 （スペース を含まない文字列）

･ date: 日付 / 時刻

･ select: 決められた単語の組の 1 つ

･ line: テキス ト の 1 行

･ text: フ ィ ール ド名の下の行から始ま る テキス ト ブロ ッ ク

･ bulk:text と同様ですが、 p4 jobs -e で検索用のイ ンデッ ク スが

付け られません。

･ length: このフ ィ ール ド にア ク セス し た GUI ク ラ イ アン ト における

表示ボ ッ ク スの推奨の長さ です。PERFORCE アプ リ ケーシ ョ ンが自由に

値を選択でき る よ う にするためには 0 に設定し ます。

128 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 jobspec

オプシ ョ ン

Fields:（続き）

･ fieldtype : 記述し ている フ ィ ール ド にデフ ォル ト 値があ るか、 入力

必須か、 読み取 り 専用か、 などを設定し ます。 設定値は次の とお り です。

･ optional: 任意の値を取る こ と ができ、 消去も可能です。

･ default: デフ ォル ト 値が与え られてお り 、 変更または消去が可能で

す。

･ required: デフ ォル ト 値が与え られてお り 、変更可能ですが、 ユーザ

が値を入力し なければな り ません。

･ once: 読み取 り 専用です。 こ のフ ィ ール ド の値は、 一度デフ ォル ト 値

に設定される と変更される こ と はあ り ません。

･ always: 読み取 り 専用です。 こ のフ ィ ール ド の値は、 ジ ョ ブが編集さ

れた と きに新しいデフ ォル ト 値に設定されます。 変数 $now、 $userを用いた場合にのみ有効で、 ジ ョ ブが更新された日付 と更新し たユー

ザの名前を変更する こ と ができ ます。

Values: フ ィ ール ド名およびフ ィ ール ド ［selectÅn の有効値の リ ス ト で構成され

ます。

データ タ イプが select に設定されたフ ィ ール ド をそれぞれ 1 行で表示し

ます。 各行には、 フ ィ ール ド 名の後にスペース をは さ んで （例えば下記の

よ う に）、 ス ラ ッ シュで区切った有効値の リ ス ト が表示されます。

JobType bug/request/problem

Presets: フ ィ ール ド名および default、required、once、または always のフ ィ ー

ル ド タ イプを持つ各フ ィ ール ド のデフ ォル ト 値の リ ス ト で構成されます。

各行には、 例えば下記のよ う に、 フ ィ ール ド 名 と デフ ォル ト 値がスペース

で区切られて表示されていなければな り ません。

JobType bug

任意の 1 行の文字列または次の 3 つの組込変数のいずれかを使用する こ と

ができ ます。

･ $user: ジ ョ ブを生成し たユーザです。

･ $now: 現在の日付です。

･ $blank: フ レーズ <enter description here> です。

ジ ョ ブを登録する と き、 そのジ ョ ブがシステムに追加される前にユーザ

は $blank をデフ ォル ト 値 とする ジ ョ ブ仕様のフ ィ ール ド を、 入力し て

おかなければな り ません。

フ ィ ール ド 102 に関し て特に考慮すべき点については、 下記の 「使用上の

留意点」 をご覧 く ださい。

Comments: p4 job フ ォームの先頭に表示されるテキス ト のコ メ ン ト です。すべての行

がコ メ ン ト ・ キ ャ ラ ク タ # で始ま っていなければな り ません。

ユーザが PERFORCE ビジュ アル・ ク ラ イ アン ト P4V でジ ョ ブを入力する必要

があ る場合には、 こ のコ メ ン ト に関し て特に考慮すべき点があ り ます。 下

記の 「使用上の留意点」 をご覧 く ださい。

-o ジ ョ ブ仕様のフ ォームを標準出力へ書き出し ます。

-i ジ ョ ブ仕様のフ ォームを標準入力から読み取 り ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ィ ールド名 説明

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 129

p4 jobspec

使用上の留意点

• 101 ～ 105 のフ ィ ール ド は、 変更、 リ ネーム、 再定義し よ う と し ないで く だ さい。 これらの

フ ィ ール ド は PERFORCE によ って使用され、削除も変更も し てはいけません。p4 jobspec は

ジ ョ ブに新しいフ ィ ール ド （すなわち、106 以上） を追加する目的のみに使用し て く だ さい。

フ ィ ール ド 101 は PERFORCE に必要で、 リ ネームする こ と も削除する こ と もでき ません。

フ ィ ール ド 102 ～ 105 は、 PERFORCE のアプ リ ケーシ ョ ン専用です。 これらのフ ィ ール ド を リ

ネーム または削除する こ と は可能ですが、 望ま し く あ り ません。 PERFORCE アプ リ ケーシ ョ ン

は、 チェ ンジ リ ス ト がサブ ミ ッ ト される たびに、 必ずフ ィ ール ド 102 （Status: フ ィ ール ド）

の値を closed （またはフ ィ ール ド 102 の Presets: に定義されたその他の値） に設定し ます。

これは、 システム管理者がフ ィ ール ド 102 を、 closed を許容値と し て含まないフ ィ ール ド と

し て使用する よ う に再定義し て も変わ り ません。 むし ろ、 このよ う な再定義は予測不可能な混

乱を生じ る危険性があ り ます。

• ［Comments:］ フ ィ ール ド の情報は、 ユーザに と ってジ ョ ブ ・ フ ォームの記入方法を説明する

唯一の参考にでき る情報であ り 、 また P4V （PERFORCE ビジュ アル・ ク ラ イ アン ト によ り ツー

ルチッ プの表示に使用される情報です。 コ メ ン ト は、 必ず完全かつ理解可能な ものにし て く

ださい。

• ジ ョ ブ状態のフ ィ ール ド （フ ィ ール ド 102） の Presets: には、 p4 fix、 p4 change -s、 p4

submit -s の各コマン ド に対し てデフ ォル ト の修正ス テータ ス を示すための特殊な構文が

あ り ます。

デフ ォル ト では、 p4 fix、 p4 change、 または p4 submit を使用する と、 ジ ョ ブの状態は

closedに設定されます。デフ ォル ト の修正ステータ ス を closedから他の fixStatusに変更

するには（Values: フ ィ ール ド に有効な select 設定値 と し て fixStatus を定義済みであ る

と 想定 し て） 、 フ ィ ール ド 102 （ジ ョ ブ の状態） の Presets: フ ィ ール ド で

jobStatus,fix/fixStatus と い う 構文を使用し ます。 p4 fix、 p4 change、 p4 submit の

動作を変更し、 ジ ョ ブの状態を未変更のま まにするには、 特殊な fixStatus であ る same を

使用し ます。

• 『システム管理者ガ イ ド』 の 「ジ ョ ブ仕様」 の章には、 ジ ョ ブ仕様のサンプルが紹介されて

います。

関連コ マン ド

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 admin、あ るいは -o オプシ ョ ンを

使 う ためには list

ジ ョ ブの生成、 編集、 またはビ ューを行 う 。 p4 job

ジ ョ ブをチェ ンジ リ ス ト に添付する。 p4 fix

ジ ョ ブを リ ス ト 表示する。 p4 jobs

特定のチェ ンジ リ ス ト に添付されたジ ョ ブ、 または特定のジ ョ ブに添付されたチェ

ンジ リ ス ト を リ ス ト 表示する。

p4 fixes

130 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 journaldbchecksums

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 131

p4 journaldbchecksums

概要

ジ ャーナル ・ ノ ー ト をテーブルのチェ ッ ク サム と と もに書き出し ます。

構文

p4 [g-opts] journaldbchecksums [ -t table ]

解説

p4 journaldbchecksums コマン ド はレプ リ カ環境で使用されます。 こ のコマン ド は、 指定さ

れたテーブル （テーブルが指定されていない場合はすべてのテーブル） のチェ ッ ク サムを含む

レ コード をジ ャーナルに書き込むよ う に PERFORCE サービ スに指示し ます。 レプ リ カ ・ サーバ

はこれらのレ コード を受け取る と、 これらのチェ ッ ク サムを自身のデータベース ・ テーブルに

対し て算出し た値 と比較し ます。 これは p4 dbstat コマン ド での処理 と同様です。 比較結果

はサービ スのロ グに記録されます。

オプシ ョ ン

使用上の留意点

• PERFORCE の管理について さ らに詳し く は、『PERFORCE システム管理者ガイ ド 』 を参照し て く

ださい。

-t tables チェ ッ クサムを算出する テーブルを指定し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 operatorsuper

p4 key

132 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 key

概要

キーと値のペアを表示、 設定、 または削除し ます。

構文

p4 [g-opts] key namep4 [g-opts] key name valuep4 [g-opts] key [-d] namep4 [g-opts] key [-i] name

解説

PERFORCE バージ ョ ン化サービ スは、 ユーザがア ク セス可能な場所に、 キー と 値のペアを保存

し ています。 これらのユーザ管理のキーは、 db.nameval と い う テーブルに格納されます。

p4 key name の形式で使用される と、name キーの値が返されます。p4 key name value の形

式で使用される と、 name と い う キーに value の値が設定され、 name キーが存在し ない場合、

それが作成されます。

キーを削除するには、 p4 key -d name を使用し ます。 数値のキーを イ ン ク リ メ ン ト するには、

p4 key -i name を使用し ます。

オプシ ョ ン

使用上の留意点

• キーが存在し ない場合、 値にはゼロが返されます。 ゼロでない値が設定されない限 り 、 キー

の名前は保存されません。

関連コ マン ド

-d name PERFORCE サービ スから name キーを削除し ます。

-i name name キーを 1 だけ イ ン ク リ メ ン ト し、新しい値を返し ます。このオプシ ョ ンは

数値のキーにのみ使用でき ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 キーの値を表示するには list、 新し

い値を設定するには review

すべてのキーおよびそれらの値を一覧表示する。 p4 keys

p4 keys

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 133

p4 keys

概要

既知のキーと値のペアを一覧表示し ます。

構文

p4 [g-opts] keys [-e nameFilter -m max]

解説

PERFORCE バージ ョ ン化サービ スは、 ユーザがア ク セス可能な場所に、 キー と 値のペアを保存

し ています。 これらのユーザ管理のキーは、 db.nameval と い う テーブルに格納されます。

構成可能変数 dm.keys.hide が設定されている場合は、 admin 権限が必要です。

p4 keys コマン ド は、 現在のキーの リ ス ト をそれらの値 と共に表示し ます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

-e nameFilter nameFilter パターンに一致する キーの名前を一覧表示し ます。

例 ： p4 keys -e 'mycounter-*'

-m max max 個までのキーのみを一覧表示し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

（dm.keys.hide が設定 さ れてい る

場合、 admin）

キーの値を表示または変更する。 p4 key

p4 label

p4 label

概要

ラベル仕様およびそのビ ューの生成または編集を行います。

構文

p4 [g-opts] label [ -f -t template ] labelname p4 [g-opts] label -o [ -t template ] labelname p4 [g-opts] label -d [ -f ] labelname p4 [g-opts] label -i [ -f ]

解説

p4 label を使用し て新しいラベル仕様の生成または既存のラベル仕様の編集を行います。 ラ

ベル名が必要です。

p4 label を実行する と、 ラベルに含め る こ と が認め ら れてい る一連のフ ァ イルを管理する

マ ッ ピ ングを構成する こ と ができ ます。 ラベルを構成し た後、 p4 labelsync または p4 tag

を使用し て、 そのラベルでフ ァ イルにタ グ付け し ます。

ラベルは自動または静的に設定する こ と ができ ます。 自動ラベルは、 [View:] フ ィ ール ドおよ

び [Revision:] フ ィ ール ド で指定 さ れ た リ ビ ジ ョ ン を 参照 し ま す。 静的 ラ ベルは、 p4

labelsync または p4 tag によ り ラベルにタ グ付け された特定の リ ビジ ョ ンのみを参照し ま

す。

unlocked のラベルの Owner: だけが、p4 labelsync または p4 tag を使用し て、 そのラベル

でフ ァ イルにタ グ付けする こ と ができ ます。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Label: 読み取 り 専用 コマン ド で指定された ラベル名です。

Owner: 書き込み可能、 任

意選択

ラベルの所有者です。デフ ォル ト では、ラベルを生成し たユー

ザです。 ラベルの所有者だけが、 どのフ ァ イルにその ラベル

でタ グ付けするかを変更する こ と ができ ます。

Update: 読み取 り 専用 ラベル仕様が 後に更新された日付です。

Access: 読み取 り 専用 ラベル上の p4 labelsync の実行によ って、またはラベルの

リ ビジ ョ ン指定子 @label を持つフ ァ イルに対し てその他の

参照を行 う こ と によ って、 ラベルが 後にア ク セス された日

付と時刻です。 ( 注 :p4 reload によ る ラベルの リ ロード は、

ア ク セス時刻には反映されません。）

Description: 書き込み可能、 任

意選択

ラベルの目的を記述し ます。 任意入力です。

Options: 書き込み可能 ラベルの動作と保存場所を制御するオプシ ョ ンです。

･ locked または unlocked です。ラベルが locked の場合、

そ の ラ ベルで タ グ 付け さ れ た フ ァ イ ルの リ ス ト を p4labelsync で変更する こ と ができ ません。

･ autoreload または noautoreload です。 静的な ラベル

の場合、 noautoreload が設定 さ れ る と ラ ベルは

db.label に保存され、 autoreload が設定される と アン

ロー ド ・ デ ィ ポに保存されます。 自動ラベルの場合、 こ の

オプシ ョ ンは無視されます。 アン ロー ド ・ デ ィ ポにラベル

を保存す る と、 ラ ベルの使用が非常に多いサ イ ト でのパ

フ ォーマン ス を改善する こ と ができ ます。

134 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 label

オプシ ョ ン

使用上の留意点

• 自動ラベルを作成するには、p4 label フ ォームの Revision: フ ィ ール ド に リ ビジ ョ ン指定

を入力し ます。 ワーク スペース を自動ラベルに同期する と、 View: フ ィ ール ド にあ るすべて

のフ ァ イルに Revision: フ ィ ール ド の内容が適用されます。

使用例

関連コ マン ド

Revision: 書き込み可能 自動ラベル用の、 任意指定の リ ビジ ョ ン仕様。

リ ビジ ョ ン番号の指定に # 文字を使用する場合、 その文字を

引用符で囲み、 # がフ ォーム内のコ メ ン ト ･フ ィ ール ド ではな

く リ ビジ ョ ン指定子 と し て解析される よ う にし なければな り

ません。

View: 書き込み可能 ラベルでタ グ付けする こ と ができ るデ ィ ポ ・ フ ァ イルの リ ス

ト です。 p4 labelsync が実行される までは、 実際にはどの

フ ァ イルも タ グ付け されません。

1 つのフ ァ イルの集合を別のフ ァ イルの集合にマ ッ ピ ングす

る ク ラ イ アン ト ・ ビ ューやブ ラ ンチ ・ ビ ュー と は異な り 、 ラ

ベル ・ ビ ューは単な るデ ィ ポ ・ フ ァ イルの リ ス ト です。 詳し

く は、 「ビ ュー」 のセ ク シ ョ ンをご覧 く ださ い。

-d [-f] 名前の付いた unlocked のラベルを削除し ます。-f オプシ ョ ンは locked のラベ

ルも強制的に削除し ます。 （ロ ッ ク された ラベルを削除するには、 admin も し くは super の権限が必要です。）

-i エデ ィ タ を起動し ないで、 標準入力から ラベル定義を読み込みます。

-o エデ ィ タ を起動し ないで、 標準出力へラベル定義を書き出し ます。

-f フ ィ ール ド ［Update:］ （更新） の日付の設定を可能にし ます。 -i オプシ ョ ン ま

たは -t オプシ ョ ンを付けて同じ目的に使用する こ と も でき ます。

-t template ラベルtemplateのビ ューおよびオプシ ョ ンを、そのラベルのフ ィ ール ド［View:］

（ビ ュー） および ［Option:］ （オプシ ョ ン） にコ ピーし ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open

p4 files @labelname labelnameによりタグ付けされたファイル・リビジョンを一覧表

示します。

ク ラ イ アン ト ・ ワーク スペースの リ ビジ ョ ンにラベルでタ グ付けする。 p4 labelsync

システムが認知し ている ラベルをすべて リ ス ト 表示する。 p4 labels

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

フ ィ ールド名 タ イプ 説明

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 135

p4 labels

p4 labels

概要

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

構文

p4 [g-opts] labels [-t] [-u user] [[-e|-E] filter -m max] [file[revrange]]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 オプシ ョ ンを使用し

ます。

オプシ ョ ン

使用上の留意点

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

を使用し ます。

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

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

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

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

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

-U アン ロード ・ デ ィ ポにあ る ラベルを リ ス ト し ます。 詳し く は、 p4 unload をご覧 く

ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

136 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 labels

使用例

関連コ マン ド

システムの全ラベルを リ ス ト 表示し ます。 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

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 137

p4 labelsync

p4 labelsync

概要

ラベルを現在の ク ラ イ アン ト ・ ワーク スペースの内容 と同期させます。

構文

p4 [g-opts] labelsync [-a] [-d] [-n] [-q] -l labelname [file[revRange]...]

解説

p4 labelsync は、 ク ラ イ アン ト に 後に同期し た各フ ァ イルの リ ビジ ョ ンをそのラベル名で

タ グ付けする こ と によ って、 指定し た ラベルに ク ラ イ アン ト ・ ワーク スペースの現在の内容を

反映させます。 その結果、 ラベル名を @label と し て リ ビジ ョ ン指定内で使用し、 ラベルでタ

グ付け されたフ ァ イルの リ ビジ ョ ンを参照する こ と ができ ます。

フ ァ イル引数を付けない場合、 p4 labelsync によ って ラベルに ク ラ イ アン ト ・ ワーク スペー

スの内容が反映され、 ラベルでタ グ付け されたフ ァ イルの集合が追加、 削除、 更新されます。

フ ァ イルが指定されている場合、 p4 labelsync は指定されたフ ァ イルに対し てのみタ グを更

新し ます。 フ ァ イル引数に リ ビジ ョ ン指定子が含まれていれば、 ク ラ イ アン ト ・ ビ ューは無視

され、指定された リ ビジ ョ ンがワーク スペース内に存在する リ ビジ ョ ンの代わ り に使用されま

す。 フ ァ イル引数に リ ビジ ョ ン範囲が含まれていれば、 その範囲内の 新 リ ビジ ョ ンだけが使

用されます。

unlocked のラベルの Owner: だけが、p4 labelsync を使用し て、そのラベルでフ ァ イルにタ

グ付けする こ と ができ ます。

フ ィ ール ド ［Options:］ （オプシ ョ ン ：） が locked に設定されている ラベルを、p4 labelsync

で更新する こ と はでき ません。

オプシ ョ ン

使用上の留意点

• デフ ォル ト では、 p4 labelsync は、 ク ラ イ アン ト ・ ワーク スペースに 後に同期された

フ ァ イルの リ ビジ ョ ンに対し て動作し ます。 フ ァ イルの 新 リ ビジ ョ ン ( または指定し た範

囲で も大きい番号の リ ビジ ョ ン ) にタ グ付けするには、 p4 tag を使用し ます。

• どのフ ァ イルがラベルによ って タ グ付け されているかを調べるには、p4 files @labelname

を使用し ます。

-a フ ァ イル ・ パターン引数に適合する フ ァ イルに ラベルを追加し ます。 フ ァ イルが

ラベルから削除される こ と はあ り ません。

-d 指定されたフ ァ イルから ラベルによ る タ グを削除し ます。

-l labelname フ ァ イル ・ リ ビジ ョ ンに適用される ラベルを指定し ます。

-n p4 labelsync が実行する予定の動作を、 実際にその動作を実行する こ と な く 表

示し ます。

-q ク ワ イエ ッ ト ・ モード : 通常の出力 メ ッ セージを抑止し ます。エラーまたは例外的

な状態に関する メ ッ セージは抑止されません。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 open

138 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 labelsync

関連コ マン ド

ラベルの生成または編集を行 う 。 p4 label

システムが認知し ている ラベルをすべて リ ス ト 表示する。 p4 labels

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

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 139

p4 list

140 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 list

概要

一時的なフ ァ イルの リ ス ト を作成し、 ラベル と し て使用でき る よ う にし ます。

構文

p4 [g-opts] list [ -l labelname ] [ -M ] file[revRange]...

解説

こ のコマン ド はシステム ・ イ ンテグレータおよびサー ド パーテ ィ の開発者が使用する ための も

のです。

p4 list は メ モ リ 内に一時的なフ ァ イル リ ス ト を作成し、それを作成し た単一の p4 コマン ド ・

セ ッ シ ョ ンの間にラベル と し て使用でき る よ う にし ます。 この リ ス ト は接続セ ッ シ ョ ンの間し

か存在し ません。 コマン ド ラ イ ンから p4 list を実行する こ と によ り 作成された一時 リ ス ト

は、 それ以降の p4 コマン ド では使用でき ません。

オプシ ョ ン

使用上の留意点

-l labelname フ ァ イル ・ リ ビジ ョ ンに割 り 当て られる ラベルを指定し ます。 その名前の ラベル

が存在する場合、 メ モ リ 内での名前が保存されている ラベルの名前よ り も優先さ

れます。

-M 転送レプ リ カに対し て実行する と、 p4 list コマン ド をマス ター ・ サーバに転送

し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 open

p4 license

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 141

p4 license

概要

ラ イセン ス ・ フ ァ イルを更新または表示し ます。

構文

p4 [g-opts] license -op4 [g-opts] license -ip4 [g-opts] license -u

解説

p4 license コマン ド によ り 、PERFORCE 管理者は PERFORCE ラ イセン ス・フ ァ イルを更新または

表示する こ と ができ ます。 こ のコマン ド を実行するには、 PERFORCE サービ スのルー ト ・ デ ィ

レ ク ト リ 内に既に有効な ラ イセン ス ・ フ ァ イルが存在する必要があ り ます。

p4 license を使用する と ラ イセン ス許可ユーザは PERFORCE サービ スに追加する こ と ができ、

サービ ス を停止し て ラ イセン ス ・ フ ァ イルを手動でサーバ ・ ルー ト にコ ピーする必要はあ り ま

せん。

PERFORCE から取得し た新しいラ イセン ス ・ フ ァ イルのほ と んどは、 サービ スの IP ア ド レ ス ま

たはポー ト が変更されていない限 り 、p4 license を使用し て （または既存のラ イセン ス ・ フ ァ

イルを コ ピーし て） イ ン ス ト ールが可能です。 サーバの IP ア ド レ ス またはポー ト 番号が変更

されている場合は、 p4 admin restart によ り サービ ス を再起動する必要があ り ます。

有効な ラ イセン スがない場合、 PERFORCE バージ ョ ン化サービ スの利用は 20 ユーザ と 20 ク ラ

イ アン ト ・ ワーク スペース ( および無制限のフ ァ イル )、または無制限のユーザ と ワーク スペー

ス ( ただし フ ァ イルは 1000 個まで ) に制限されます。

オプシ ョ ン

使用上の留意点

使用例

-o 現在のラ イセン ス ・ フ ァ イルを標準出力に表示し ます。

-i 新しいラ イセン ス ・ フ ァ イルを標準入力から読み込みます。

-u ラ イセン ス制限を報告し、 これらの制限に対し てい く つのエンテ ィ テ ィ （ユーザまたはフ ァ

イル） が使用中であ るかを示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 super(-u オプションの場合はadmin)

p4 license -o 現在のラ イセン ス ・ フ ァ イルを標準出力に表示し ます。

p4 license -i 新しいラ イセン ス ・ フ ァ イルを標準入力から読み込みます。

p4 lock

142 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 lock

概要

作業状態のフ ァ イルを ロ ッ ク し て、 チェ ンジ リ ス ト がサブ ミ ッ ト されないよ う にし ます。

構文

p4 [g-opts] lock [-c changelist] [file ...]

解説

フ ァ イルを ロ ッ クする と、 他のユーザがそのフ ァ イルへの変更をサブ ミ ッ ト する のを防げま

す。 フ ァ イルがすでに他のユーザによ って ロ ッ ク されている と、 p4 lock は失敗し ます。 フ ァ

イルを ロ ッ ク し たユーザがそのフ ァ イルをサブ ミ ッ ト すれば、 ロ ッ クは解除されます。

こ のコマン ド は、 通常特定のフ ァ イル引数を付けて実行されます。 フ ァ イル引数が与え られて

いない場合は、 デフ ォル ト ・ チェ ンジ リ ス ト 内で作業状態になっている フ ァ イルがすべて ロ ッ

ク されます。-c changelist オプシ ョ ンが付いている と、 チェ ンジ リ ス ト changelist で作業

状態になっている フ ァ イルの う ち、 指定さ れたフ ァ イル ・ パターンに適合する も のがすべて

ロ ッ ク されます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

-c changelist チェ ンジ リ ス ト changelist に含まれる フ ァ イルだけを ロ ッ ク し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 write

ロ ッ ク されている フ ァ イルをアン ロ ッ クする。 p4 unlock

作業状態でロ ッ ク中のフ ァ イルを表示する。 （UNIX） p4 opened | grep "*locked*"

p4 lockstat

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 143

p4 lockstat

概要

データベース ・ テーブルのロ ッ ク状態を報告し ます。

構文

p4 [g-opts] lockstat [-c client | -C]

解説

デフ ォル ト では、 p4 admin lockstat コマン ド では、 現在読み取 り または書き込みの処理の

ためにロ ッ ク されているデータベース ・ テーブルが報告されます。

オプシ ョ ン

使用上の留意点

-c client 指定された ク ラ イ アン ト ・ ワーク スペースが読み取 り または書き込みの処理のた

めにロ ッ ク されているかど う かを報告し ます。

-C 読み取 り ま たは書き込みの処理のために ロ ッ ク さ れてい るすべての ク ラ イ ア ン

ト ・ ワーク スペース を報告し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 logappend

144 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 logappend

概要

任意のユーザ ・ ロ グ ・ フ ァ イルに 1 行追加し ます。

構文

p4 [g-opts] logappend [ -a args... ]

解説

p4 admin logappend コマン ド は、ユーザ・ ロ グ ・ イベン ト を含む構造化ロ グ ・ フ ァ イルに 1 行

追加し ます。 1 行につき引数を 25 個まで指定でき ます。

オプシ ョ ン

使用上の留意点

• 現時点では、ユーザ・ ロ グ ・ イベン ト を含むロ グ ・ フ ァ イルは user.csv および all.csv の 2

つだけです。

-a args... ユーザ ・ ロ グに追加される 25 個までの引数

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

} リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

p4 logger

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 145

p4 logger

概要

変更されたジ ョ ブおよびチェ ンジ リ ス ト を レポー ト し ます。

構文

p4 [g-opts] logger [-c sequence#] [-t countername]

解説

p4 logger コマン ド は PERFORCE を呼び出す外部プロ グ ラ ムで使用する ものです。

オプシ ョ ン

使用上の留意点

• p4 logger コマン ド はエン ド ユーザ用ではあ り ません。外部の欠陥追跡システムへの情報伝

達をサポー ト する ための ものです。

関連コ マン ド

-c sequence# 指定のシーケン ス番号以後に生じ たすべてのイベン ト を

一覧表示し ます。

-t countername 指定のカ ウ ン タ番号以後のすべてのイベン ト を一覧表示

し ます。

-c sequence# -t countername 指定のカ ウ ン タ を指定のシーケン ス番号で更新し、 ロ グ

を ク リ ア し ます。 こ のオプシ ョ ンは、 カ ウ ン タ名の指定

に関係な く ロ グを ク リ アするので、 1 人のユーザしか使

用でき ません。

g_opts 「グ ローバル・オプシ ョ ン」のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 review

特定のフ ァ イルを レ ビ ューする ためにサブス ク ラ イブし ているユーザを一

覧表示する。

p4 reviews

PERFORCE カ ウ ン タの値を設定する、 または読み取る。 p4 counter

特定のチェ ンジ リ ス ト に関する全情報を表示する。 p4 describe

特定の条件に適合するすべてのチェ ンジ リ ス ト を一覧表示する。 p4 changes

p4 login

p4 login

概要

チケ ッ ト を取得し て、 PERFORCE サービ スにロ グ イ ン し ます。

構文

p4 [g-opts] login [ -a -p ] [ -h host user ] p4 [g-opts] login [ -s ]

解説

p4 login コマン ド は、 ユーザを認証し、 PERFORCE と のセ ッ シ ョ ンを表すチケ ッ ト を作成し ま

す。 認証されたユーザは、 チケ ッ ト が期限切れにな るか、 そのユーザが p4 logout コマン ド

を発行する まで、 共有バージ ョ ン化サービ スにア ク セスする こ と ができ ます。

デフ ォル ト では、 チケ ッ ト は 12 時間の間有効です。

すべての IP ア ド レ ス に対し て有効なチケ ッ ト を取得する (PERFORCE を複数の ワー ク ス テー

シ ョ ン上で同時に使用する場合など ) には、 p4 login -a を使用し ます。 ユーザは、 すべての

IP ア ド レ スに対し て有効なチケ ッ ト を持っていて も、 1 つの PERFORCE ラ イセン ス しか消費し

ません。

オプシ ョ ン

使用上の留意点

• グループご と に、 デフ ォル ト のタ イ ムア ウ ト 値であ る 43200 秒 (12 時間 ) が p4 group

フ ォームで定義されます。

• 無期限のチケ ッ ト を作成するには、p4 group のフ ォームにおいて [Timeout:] を unlimited

に設定し ます。

• デフ ォル ト では、 ユーザは 3 回ロ グ イ ンに失敗する と再度ロ グ イ ンする まで 10 秒間待たな

ければな り ません。 PERFORCE スーパーユーザは構成可能変数 dm.user.loginattempts の

設定によ り 、 ロ グ イ ンの試行回数を制御でき ます。

• チケ ッ ト の有効期間を延長するには、 ロ グ イ ン し ている間に p4 login を使用し ます。 チ

ケ ッ ト の有効期間は、初期タ イ ムア ウ ト 設定値の 1/3 だけ延長されます ( 大でチケ ッ ト の

初期タ イ ムア ウ ト 設定値まで )。

• PERFORCE スーパー ・ ユーザは、パス ワード を入力し な く て も自分以外のユーザのロ グ イ ン ・

チケ ッ ト を取得でき ます。 スーパー ・ ユーザ以外のユーザが他のユーザ と し て ロ グ イ ンする

場合は、p4 -u username login の形式でコマン ド を使用し、 そのユーザのパス ワード を正

確に入力し なければな り ません。

-a すべての IP ア ド レ スに対し て有効なチケ ッ ト を取得し ます。

-h host 指定し たホス ト IP ア ド レ スに対し て有効なチケ ッ ト を要求し ます。

-p ローカル ・ チケ ッ ト ・ フ ァ イルにチケ ッ ト を保存し ないで、 チケ ッ ト を表示し ます。

-s 現在のチケ ッ ト のステータ ス を表示し ます ( ステータ スがあ る場合 )。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 list

146 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 login

• チケ ッ ト は環境変数P4TICKETSで指定し たフ ァ イルに保存されます。環境変数が設定されて

いない場合、 チケ ッ ト は Windows では %USERPROFILE%\p4tickets.txt、 その他の OS では

$HOME/.p4tickets に保存されます。

• -h オプシ ョ ンを使用する と、 指定されたホ ス ト IP ア ド レ スにおいてのみ有効なチケ ッ ト が

サービ スによ って発行されます。 このオプシ ョ ンは通常 -p と共に使用され、 以降別のマシ

ン上で使用でき るチケ ッ ト を表示し ます。

• 複製環境では、 マス ター ・ サーバにロ グ イ ンする と、 レプ リ カ ・ サーバにはロ グ イ ンでき ま

せん。

使用例

関連コ マン ド

p4 login ユーザにパス ワー ド の入力を求め、 パス ワー ド が正し く 入力

される と、 そのユーザのマシンで有効なチケ ッ ト を発行し ま

す。

p4 -u builder login -a ユーザ builder と し て ロ グ イ ン し ます。パス ワード が正し く

入力される と、 すべてのマシンで有効なチケ ッ ト を発行し ま

す。

ロ グ イ ン ・ セ ッ シ ョ ンを終了する。 p4 logout

チケ ッ ト を表示する。 p4 tickets

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 147

p4 logout

148 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 logout

概要

チケ ッ ト を削除または無効にし て、 PERFORCE から ロ グア ウ ト し ます。

構文

p4 [g-opts] logout [ -a ]

解説

ユーザのワーク ス テーシ ョ ン上のチケ ッ ト を削除する か、 サービ ス上のチケ ッ ト を無効に し

て、 PERFORCE からユーザを ロ グア ウ ト させます。

p4 logout -a を使用する と、 チケ ッ ト はチケ ッ ト ・ フ ァ イルに残 り ますが、 サービ ス上では

無効にされます。 チケ ッ ト のすべてのユーザが同時にロ グア ウ ト されます。

オプシ ョ ン

使用上の留意点

• チケ ッ ト は環境変数P4TICKETSで指定し たフ ァ イルに保存されます。環境変数が設定されて

いない場合、 チケ ッ ト は Windows では %USERPROFILE%\p4tickets.txt、 その他の OS では

$HOME/.p4tickets に保存されます。

• 複製環境では、p4 logout -a によ ってマス ター・ サーバから ロ グア ウ ト する と、 レプ リ カ ・

サーバから も ロ グア ウ ト し ます。

使用例

関連コ マン ド

-a サービ ス上のチケ ッ ト を無効にし て、 チケ ッ ト のすべて

のユーザを ロ グア ウ ト し ます。

g-opts 「グ ローバル・オプシ ョ ン」のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用不可 使用不可 list

p4 logout ローカル ・ セ ッ シ ョ ン ・ チケ ッ ト を削除し て、 PERFORCE から

ロ グア ウ ト し ます。

p4 logout -a ローカル ・ セ ッ シ ョ ン ・ チケ ッ ト を削除し て、 ユーザがロ グ

イ ン し ている その他すべてのワーク ス テーシ ョ ンのチケ ッ ト

を無効にする よ う PERFORCE サービ スに指示し、 PERFORCE か

ら ロ グア ウ ト し ます。

ロ グ イ ン ・ セ ッ シ ョ ンを開始する ( チケ ッ ト を取得する ため )。 p4 login

チケ ッ ト を表示する。 p4 tickets

p4 logparse

p4 logparse

概要

構造化ロ グ ・ フ ァ イルを解析し、 データ を返し ます。

構文

p4 [g-opts] [-e] [-T fields...] [-F filter] [-s offset] [-m max] logfile

解説

p4 admin logparse コマン ド は、指定された構造化ロ グ ・ フ ァ イル logfile を解析し、 ロ グ ・

データ を タ グ付き フ ォーマ ッ ト で返し ます。 構造化ロ グ ・ フ ァ イルの有効な名前は、 以下の と

お り です。

構造化ロ グ記録を有効にするには、構成可能変数 serverlog.file.N にフ ァ イルの名前を設定

し ます。 7 つのロ グ ・ タ イプのすべてについて記録を有効にするには、 以下の とお り 構成可能

変数を設定し ます。

p4 configure set serverlog.file.1=all.csvp4 configure set serverlog.file.2=commands.csvp4 configure set serverlog.file.3=errors.csvp4 configure set serverlog.file.4=audit.csvp4 configure set serverlog.file.5=track.csvp4 configure set serverlog.file.6=user.csvp4 configure set serverlog.file.7=events.csv

構造化ロ グ ・ フ ァ イルはチェ ッ ク ポ イ ン ト 作成時、 ジ ャーナル作成時、（設定されていれば） 関

連する serverlog.maxmb.N の制限超過時、p4 logrotate コマン ド実行時に自動的にローテー

ト されます。

all.csv すべてのロ グ記録可能な イベン ト （コマン ド、 エラー、 監査など）

commands.csv コマン ド ・ イベン ト （コマン ド の開始、 コマン ド の処理、 コマン ド の終了）

errors.csv エラー ・ イベン ト （エラー - 失敗、 エラー - 重大）

audit.csv 監査イベン ト （監査、 完全消去）

track.csv コマン ド の追跡 （追跡 - 使用状況、 追跡 -rpc、 追跡 -db）

user.csv ユーザ ・ イベン ト 。 ユーザが p4 logappend を実行するたびに 1 レ コード。

events.csv サーバ ・ イベン ト （起動、 停止、 チェ ッ ク ポイ ン ト 、 ジャーナル ・ ローテーシ ョ

ンなど）

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 149

p4 logparse

オプシ ョ ン

使用上の留意点

• 構造化ロ グは基本エ ラー ・ ロ グ （P4LOG および監査ロ グ （P4AUDIT） と は異な り ます。 基本

エラー ・ ロ グを読み取るには、 p4 logtail コマン ド を使用し て く ださ い。

-e 特殊文字を 16 進エン コード で表示し ます。

-T field,field リ ス ト されたフ ィ ール ド のみを表示し ます。

-F filter フ ィ ルタのパターンに一致する レ コード のみを出力し ます。

-s f_offset f_offset フ ィ ール ド によ って返されたフ ァ イル・オフセ ッ ト から解析を開始

し ます。

-m max 返される行の数を制限し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

150 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 logrotate

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 151

p4 logrotate

概要

1 つ以上の構造化ロ グ ・ フ ァ イルを ローテー ト し ます。

構文

p4 [g-opts] logrotate [-l logname]

解説

p4 admin logrotate コ マン ド は指定された ロ グ ・ フ ァ イルを ローテー ト し ます。 あ るいは、

-l logname オプシ ョ ンが指定されていない場合はすべての構造化ロ グを ローテー ト し ます。

関 連 す る 構 成 可 能 変 数 が 設 定 さ れ て い る 場 合、 構 造 化 ロ グ ・ フ ァ イ ル は 長 さ が

serverlog.maxmb.N メ ガバイ ト を超え る と自動的にローテー ト され、serverlog.retain.N個

の古いロ グ ・ フ ァ イルが保存されます。

デフ ォ ル ト では、 構造化 ロ グの 大サ イ ズに制限はあ り ません。 チ ェ ッ ク ポ イ ン ト お よ び

ジ ャーナルの取得時にのみ自動的にローテー ト されます。

オプシ ョ ン

使用上の留意点

-l logname logname と い う 名前のロ グを ローテー ト し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 logschema

152 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 logschema

概要

ロ グ記録タ イプの概要を記述し ます。

構文

p4 [g-opts] logschema [ -a | recordtype ]

解説

p4 admin logschema コマン ド は、指定された構造化ロ グ記録タ イプの説明を タ グ付き フ ォー

マ ッ ト で返し ます。

オプシ ョ ン

使用上の留意点

-a 既知のすべてのロ グ記録タ イプについて、 仕様を表示し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 logstat

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 153

p4 logstat

概要

ジ ャーナル、 エラー ・ ロ グ、 および / または監査ロ グのフ ァ イルサイ ズを報告し ます。

構文

p4 [g-opts] logstat [-l logname]

解説

p4 logstat コマン ド は、 ジ ャーナル、 エラー ・ ロ グ （存在する場合）、 監査ロ グ （存在する場

合） のサイ ズを報告し ます。

デフ ォル ト では、 p4 logstat は構造化ロ グ ・ フ ァ イルのサイ ズを含めません。 構造化ロ グ ・

フ ァ イルのサイ ズを報告させるには、 -l オプシ ョ ンを使用し て、 明示的にロ グ･フ ァ イルの名

前 （対応する構成可能変数 serverlog.file.N に定義された とお り ） を指定する必要があ り ます。

オプシ ョ ン

使用上の留意点

-l logname logname のフ ァ イルサイ ズを表示し ます。

logname に対し て有効な値は、journal、errorLog、 auditLog、 または構造化

ロ グに関連付け られた serverlog.file.N のフ ァ イル名です。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 logtail

154 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 logtail

概要

エラー ・ ロ グの 後のブロ ッ ク を表示し ます。

構文

p4 [g-opts] logtail [ -b blocksize ] [ -s start_offset [ -m maxBlocks ]] [-l log]

解説

p4 logtail コマン ド は、 エ ラー ・ ロ グの 後のブロ ッ ク を表示し、 次のブロ ッ ク が書き込ま

れる場合にはそのオフセ ッ ト 位置も表示し ます。

出力はタ グ付き書式の一連の行から構成されます。 初の行は “... file LOG” であ り 、 その

後ロ グ ・ データの複数のブロ ッ クが続き ます。 デフ ォル ト では start_offset からのすべての

ブロ ッ ク がフ ァ イルの終わ り まで出力されます。 データは blocksize の大き さ を持つブロ ッ

ク と し て返 さ れ、 各ブ ロ ッ ク に “... data” と い う タ グが付け ら れます。 後の行は “... offset next_offset” であ り 、next_offset はロ グ ・ フ ァ イル内のオフセ ッ ト 位置を示し、 こ

の位置から次のデータ ・ ブロ ッ クが取得される こ と にな り ます。

オプシ ョ ン

使用上の留意点

• PERFORCE の管理に関し て詳し く は、 『システム管理者ガ イ ド』 をご覧 く だ さい。

使用例

-s start バイ ト 単位で示し た （フ ァ イルの始めからの） オフセ ッ ト 値。

-b blocksize バイ ト 単位で示し たブロ ッ ク ・ サイ ズ。 デフ ォル ト は 8192 バイ ト です。

-m maxBlocks 出力すべきブロ ッ ク の 大数。同時に-s も指定されていない場合は無視されます。

-l log 指定された場合、 表示する ロ グの名前。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

p4 logtail -b 1024 -m 2 ロ グ ・ フ ァ イルの 後の 2 キ ロバイ ト を、 それぞれ 1024 バイ

ト を持つ別々のブロ ッ ク と し て表示し ます。

p4 merge

p4 merge

概要

あ る フ ァ イル集合を別のフ ァ イル集合にマージ し ます。

構文

p4 [g-opts] merge [options] fromFile[revRange] toFilep4 [g-opts] merge [options] -b branch [-r] [toFile[revRange] ...]p4 [g-opts] merge [options] -b branch -s fromFile[revRange] [toFile ...]p4 [g-opts] merge [options] -S stream [-P parent] [-F] [-r] [toFile[revRange]...]

options: -c change -n -Oflags -m max -q

解説

p4 merge コマン ド は p4 integrate コマン ド の簡易版であ り 、 変更の集合を反映元から反映

先のフ ァ イル群にマージ し ます。 こ のコ マン ド はス ト リ ームでの使用が意図されていますが、

従来の PERFORCE ブラ ンチにも問題な く 使用でき ます。

ス ト リ ームに p4 merge を使用する と、 よ り 安定性の高い親ス ト リ ームの 新状態が子ス ト

リ ームに反映される ため、 安定性のあ る親へ と変更を昇格させて戻す際に、 親にチェ ッ ク イ ン

さ れていた他の変更が誤って上書き さ れない よ う にする こ と がで き ます。 フ ァ イルは作業中

チェ ンジ リ ス ト で作業状態に さ れ、 必要に応じ て衝突解決がス ケジ ュール さ れます。 親ス ト

リ ームを更新するには、 衝突解決後にサブ ミ ッ ト し ます。

ほ と んどの場合、 変更を ス ト リ ーム間 （またはブラ ンチ間） で伝播するには、 コマン ド と し て

p4 merge および p4 copy を使用し ます。 p4 integrate のデフ ォル ト の動作では、 も近い

共通の祖先を base と し て選択し てフ ァ イルの衝突解決がスケジ ュールされます。 p4 merge で

は、 反映元フ ァ イルおよび反映先フ ァ イルで共通の編集が も多い リ ビジ ョ ンが （base と し

て） 選択されます。

オプシ ョ ン

-c change フ ァ イルが作業状態にされる既存の作業中チェ ンジ リ ス ト を指定し ます。

-n マージ結果をプレ ビ ューし ます。

-m max マージ される フ ァ イルの数を制限し ます。このオプシ ョ ンは多数のフ ァ イ

ルを反映する ス ク リ プ ト に有用です。 反映のバッチ処理が可能 と な り 、 共

有バージ ョ ン化サービ スの他のユーザに対する ロ ッ ク関連の影響を 小

にする こ と ができ ます。

-b branch 反映元 と反映先のフ ァ イルを決定するために使用されるブラ ンチ・ ビ ュー

を指定し ます。

-r [toFile[revRange] ...]

ブ ラ ンチ ・ ビ ューのマ ッ ピ ン グを逆に し て、 反映先フ ァ イルか ら反映元

フ ァ イルへ と反映し ます。 -b オプシ ョ ンが必要です。

-s fromFile[revRange] [toFile ...]

fromFile を反映元と し、 ブラ ンチ ・ ビ ューの両側を反映先と し て扱いま

す。 反映先の範囲を さ らに限定するには、 toFile パラ メ ータ を追加指定

し ます。 こ のオプシ ョ ンを指定する と -r オプシ ョ ンが無効にな り ます。

-b オプシ ョ ンが必要です。

-S stream 反映元ス ト リ ームを指定し ます。フ ァ イルは親ス ト リ ームにマージ されま

す。 親から子へ と マージするには、 -r オプシ ョ ンを使用し てマージ方向

を逆にし ます。

-P parent 指定された親ス ト リ ームへ と マージ し ます。反映元ス ト リ ームの指定で定

義された親が無効にな り ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 155

p4 merge

使用上の留意点

使用例

関連コ マン ド

-F 反映先ス ト リ ームが反映元のマージを受け入れる よ う に構成さ れていな

い場合、 強制的にマージ操作を実行し ます。 ス ト リ ームにおいて期待され

る変更フ ローを決定するには、 p4 istat を使用し て く ださ い。

-Ob -Obオプシ ョ ンは、（も し あれば）マージ用の base リ ビジ ョ ンを出力し ます

-Or -Or オプシ ョ ンは、 スケジュールされている衝突解決を出力し ます。

-q ク ワ イエ ッ ト ・ モード。 反映、 コ ピー、 マージの対象と な る フ ァ イルの リ

ス ト に関する、 通常の出力 メ ッ セージを抑止し ます。 エラーまたは例外的

状態に関する メ ッ セージは表示されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open

p4 merge -r -S //projectX/bruno_devp4 resolvep4 submit -d "Update dev w latest changes"

新の変更を メ イ ン （親） か らブルー ノ の

開発ス ト リ ーム （子） へ と組み込みます。

よ り 安定性の高い隣接ス ト リ ームへと変更を昇格させる。 p4 copy

変更を伝播する。 p4 integrate

フ ァ イルの衝突を解決する。 p4 resolve

156 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 monitor

p4 monitor

概要

PERFORCE のプロセス情報を表示し ます。

構文

p4 [g-opts] monitor show [ -a ] [ -e ] [ -l ] [-s R|T|P|I ]p4 [g-opts] monitor terminate id p4 [g-opts] monitor clear idp4 [g-opts] monitor clear allp4 [g-opts] monitor pause idp4 [g-opts] monitor resume id

解説

p4 monitor によ ってシステム管理者は、PERFORCE サーバ・マシン上でどのよ う な PERFORCE 関

連プロセスが実行中かを監視する こ と ができ ます。出力行には、次のフ ィ ール ド が含まれます。

pid status owner hh:mm:ss command [args]

こ こ で、pid は UNIX 環境におけるプロセス ID （または Windows 環境における ス レ ッ ド ID） で

あ り 、status はそのプロセスが実行中か終了のためにマーク されているかによ って、R または

T を示し ます。owner は、そのコマン ド を実行し たユーザの PERFORCE ユーザ名です。hh:mm:ss

はコマン ド を実行し てから経過し た時間を示し、 command と args は PERFORCE サービ スが受

信し た コマン ド と引数です。

現在のプロセス情報を表示するには、 p4 monitor show を使用し ます。 デフ ォル ト ではすべ

てのプロ セスが リ ス ト されますが、 引数な し でコ マン ド （例えば、 sync、 edit、 submit） だ

けが表示されます。 こ の形式で p4 monitor を実行するには、list 権限が必要です。 指定され

た状態の プ ロ セ ス のみ を 表示す る には、 -s status を 使用 し ま す （status は Running、

Terminated、 Paused、 または Idle の状態のプロセス を表し ます）。

それぞれのコ マン ド に関連する引数の リ ス ト を表示するには、 -a （arguments） オプシ ョ ン ま

たは -l （long） オプシ ョ ン を使用 し ます。 ユーザ環境か ら の追加情報が必要な場合は、 -e

(environment) オプシ ョ ンを使用し ます。 これらのオプシ ョ ンを指定するには、 admin 権限が必

要です。

プロセス を終了させる ためにマークするには、 p4 monitor terminate id を使用し ます。 こ

のコマン ド の実行には、 super 権限が必要です。

監視テーブルからエン ト リ を消去するには、p4 monitor clear id を使用し ます。p4 monitor

clear all を実行すれば、 テーブル全体を消去する こ と ができ ます。 これらのコマン ド の実行

には、 super 権限が必要です。

p4 verify や p4 pull な ど の長時間実行 さ れ る タ ス ク を、 p4 monitor pause お よ び p4

monitor resume によ って制御する こ と ができ ます。

p4 monitorを使用するには、p4 configureで構成可能変数monitorを設定する こ と によ って、

PERFORCE サービ ス上で監視ができ る よ う にする必要があ り ます。 プロセスの監視を制御する

には、 構成可能変数 monitor を 0 （監視を無効にする）、 1 （ア ク テ ィ ブなプロセスの監視を有

効にする）、 または 2 （ア ク テ ィ ブなプロセス と休止プロセスの監視を有効にする） に設定し ま

す。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 157

p4 monitor

オプシ ョ ン

使用上の留意点

• 実行中 と示されたプロセスは、た と え p4 monitor clear で監視テーブルから消去された と

し て も、 終了する まで実行し続けます。

• サーバにおいて早いタ イ ミ ングでコマン ド が終了する と、誤って実行中と リ ス ト される場合

があ り ます。 このよ う なプロセスは、 スーパーユーザが p4 monitor clear で消去する こ と

ができ ます。

• プロセスが少な く と も 10 秒間実行中でない限 り 、p4 monitor terminate コマン ド はプロセ

スに終了のためのマーク を付けません。

• 複数のプロセス を実行する コマン ド ( 例えば、 p4 submit など ) があ り ます。 例えば、

dm_CommitSubmit ま たは dm_SubmitChange が、 p4 submit コ マ ン ド の 2 つの独立 し た

フ ェーズ と し て p4 monitor の出力に表示される こ と があ り ます。

• p4 obliterate などの一部のコマン ド は終了する こ と ができ ません。

• 休止プロセスの監視を有効にし ている場合（構成可能変数 monitor を 2 に設定）、休止プロセ

スは status が R、 command が IDLE で表示されます。

使用例

関連コ マン ド

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

-a プ ロ セ ス に指定 さ れたすべ て の引数 （例 えば、 edit file.c や sync -f //depot/src/... など） を表示し ます。

PERFORCE ユーザ名は 10 文字に切 り 捨て られ、 出力行の文字数は全部で 80 文字に

制限されます。

-e 起動し ている PERFORCE アプ リ ケーシ ョ ン ( 既知の場合 )、 ホス ト IP ア ド レ ス、 お

よびワーク スペース名を含む環境情報を表示し ます。

-l 長い形式で、 すべての引数が表示されます。 ユーザ名やコ マン ド ラ イ ン引数の リ

ス ト は、 切 り 捨て られません。

-s status ステータ スが Running、 Terminated、 Paused、 または Idle であ るプロセスのみを表示し ます。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 list, super

p4 monitor show PERFORCE のプロセス情報（コマン ド のみ）を表示し ます。list権限のみが必要です。

p4 monitor show -l 出力行の長 さ を制限せずに、 コ マン ド と 引数を表示し ます。

super 権限が必要です。

p4 monitor show -a 出力行ご と に 80 文字に制限し、コマン ド と引数を表示し ます。

super 権限が必要です。

p4 monitor terminate 123 プロセス 123 を終了のためにマークする よ う 、 PERFORCE サー

ビ スに通知し ます。 super 権限が必要です。

p4 monitor clear all 監視テーブルのすべてのエン ト リ を消去し ます。 super 権限

が必要です。

監視を行 う よ う 設定する。 p4 configure set monitor=1

監視を行わないよ う 設定する。 p4 configure set monitor=0

158 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 move

p4 move

概要

フ ァ イルをあ る場所から別の場所に移動 （ リ ネーム） し ます。

構文

p4 [g-opts] move [-c change] [-f] [-k] [-n] [-t filetype] fromFile toFile

解説

p4 move コ マン ド は、 既に編集または追加目的で作業状態になっている フ ァ イルを処理対象

と し、 指定された位置に移動し ます。

作業状態のフ ァ イルは、 サブ ミ ッ ト 前に何回も移動させる こ と ができ ます。 フ ァ イルを元の場

所に戻すと、 保留中の移動操作を取 り 消し、 編集目的の作業状態のま まにし ます。 移動させた

フ ァ イルに p4 revert を実行する と、 移動を取 り 消す と共に、 サブ ミ ッ ト されていない内容

を元に戻し ます。

オプシ ョ ン

使用上の留意点

• フ ァ イルを移動させるには、それが編集目的または追加目的で作業状態になっていなければ

な り ません。

• 編集目的で作業状態に されている が 新 リ ビジ ョ ンで リ ネーム されたフ ァ イルを移動し て

衝突解決するには、 -f オプシ ョ ンを使用し て強制的に移動を実行し ます。

-c change チェ ンジ リ ス ト 番号が指定される と、 フ ァ イルは番号付きの作業中チェ ンジ リ ス

ト で作業状態にな り ます。

-t filetype フ ァ イルタ イ プが指定される と、 フ ァ イルは新しいフ ァ イルタ イ プで再度作業状

態にされます。

-f 強制的に既存の移動先フ ァ イルへの移動を行います。 フ ァ イルは同期されている

必要があ り ますが、 作業状態にし てはいけません。 移動元のフ ァ イルはワーク ス

ペース と は同期されていない状態にな り ます。

p4 move -f を使用する と、 チェ ンジ リ ス ト をサブ ミ ッ ト する前に移動の衝突解

決が必要にな り ます。

-k ク ラ イ アン ト ・ ワーク スペースでの リ ネームを行わずに、 既存のワーク スペース ・

フ ァ イルを保存し ます。 PERFORCE サービ スに接続し ない状態で行った作業を照合

する場合にのみ、 p4 move -k を使用し ます。

-n 実際にフ ァ イルを移動せずに、 実行される移動操作をプレ ビ ューし ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

fromFile: 使用可

toFile: 使用不可

使用不可 fromFile には read ア ク セス

toFile には write ア ク セス

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 159

p4 move

使用例

p4 move file1.c file2.c file1.c が追加ま たは編集目的で作業状態であ る と 想定し

て、 file1.c を file2.c に移動する。

p4 move //depot/d1/... //depot/d2/...

作業状態のフ ァ イルを d1 デ ィ レ ク ト リ から d2 デ ィ レ ク ト リ

へと移動する。

160 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 obliterate

p4 obliterate

概要

フ ァ イルおよびその履歴をデ ィ ポから消去し ます。

構文

p4 [g-opts] obliterate [ -y -A -b -a -h ] file[revRange] ...

警告

p4 obliterate は慎重に使って く だ さい。 これは PERFORCE の中で実際にフ ァ イル ・ データ を

消去する 2 つのコマン ド の う ちの 1 つです。 （フ ァ イルのデータ を消去する も う 1 つのコマン

ド は、 p4 archive のアーカ イブ - パージ ・ オプシ ョ ンです。）

p4 obliterate はフ ァ イル・データのサーバ内のコ ピーを現実に削除し、 リ カバ リ の可能性を

完全に排除し ます。 ( これに対し、 p4 delete コマン ド は 新 リ ビジ ョ ンを削除扱いにするだ

けで、 以前の リ ビジ ョ ンはデ ィ ポにそのま ま残し ます。 )

解説

p4 obliterate は、PERFORCE 管理者が使用し、フ ァ イルをデ ィ ポから完全に消去し ます。フ ァ

イルはラベルによ る フ ァ イル参照や have リ ス ト など を含む、 すべての関連 メ タデータ と と も

に PERFORCE サービ スから消去されます。 p4 obliterate が正常終了する と、 その影響を受け

たフ ァ イルは、 サービ スに と って 初か ら存在し ていなかった よ う な状態にな り ます。 ユー

ザ ・ ワーク スペース内のフ ァ イルはそのま まですが、 もはや PERFORCE によ る ソース管理下の

フ ァ イル と は認識されません。

p4 obliterateは少な く と も 1つのフ ァ イル・パターンを引数と し て必要 と し ます。実際にフ ァ

イ ルの完全消去を実行する には、 -y オプシ ョ ンが必要です。 こ れが付いていなければ、 p4

obliterate は実際にフ ァ イルの完全消去は実行せずに、 単にそれを実行し た ら ど う な るかを

知らせるだけです。

特定の リ ビジ ョ ンを指定すれば （例えば p4 obliterate file#3）、 その リ ビジ ョ ンのフ ァ イ

ルだ け が完全消去 さ れ ま す。 リ ビ ジ ョ ン 範囲 を 指定すれば （例 え ば p4 obliterate

file#3,5）、 その範囲の リ ビジ ョ ンだけが完全消去されます。

オプシ ョ ン

-y filespec フ ァ イ ルの完全消去を実行 し ま す。 こ のオプシ ョ ン が付い てい な ければ、 p4obliterate は単に、 実行し た ら ど う なるかを知らせるだけです。

-A アーカ イブ対象 と し てマーキング された リ ビジ ョ ン を完全消去し ます。 デフ ォル

ト では、 アーカ イブ された リ ビジ ョ ンはスキ ッ プされます。

-b 引数の範囲にあ る フ ァ イルを、 ブ ラ ンチ されたフ ァ イル、 および 初の リ ビジ ョ

ンかつ 新 リ ビジ ョ ンであ る フ ァ イルに限定し ます。 こ のオプシ ョ ンは、 古いブ

ラ ンチ （1 つの リ ビジ ョ ンのみ存在） を削除する一方で、 ブラ ンチ操作後に変更さ

れたフ ァ イルを保存し てお く のに便利です。 -a オプシ ョ ン と -b オプシ ョ ンを併

用する こ と によ り 、 obliterate -b のパフ ォーマン ス を大幅に改善する こ と が

でき ます。

-a （ リ ソース を消費しがちな） db.archmap の検索を スキ ッ プし、 フ ァ イルをサーバ

か ら消去せず、 メ タデータのみを消去し ます。 フ ァ イルはデ ィ ス ク か ら消去され

ませんが、 -a と -b を併用する こ と によ り 、 遅延コ ピーと し てのみ存在し ている

こ と が既知であ る ブ ラ ンチ済みフ ァ イ ルの完全消去を高速化する こ と がで き ま

す。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 161

p4 obliterate

使用上の留意点

• p4 obliterate は、 必要な く なったフ ァ イルを消去し て デ ィ ス ク容量を再生する ため、 ま

たは間違った場所にフ ァ イル階層を生成する と いったユーザに よ る ミ ス を帳消し にする た

めの 1 つの方法です。 OS のコマン ド （erase、 rm またはそれら と同等のコマン ド ） を使用

し て PERFORCE サーバ ・ ルー ト から手動でフ ァ イルを削除し ないで く だ さい。

• よ り 良いデ ィ ス ク ・ スペースの節約方法は、 ア ク セス頻度の低いフ ァ イルを低パフ ォーマン

スの （または取 り 外し可能な） 記憶領域に移動させる こ と です。 フ ァ イルを完全消去する代

わ り に、 p4 archive と p4 restore をアーカ イブ ・ デ ィ ポ と共に使用する こ と を検討し て

く だ さい。 アーカ イブ ・ デ ィ ポにはフ ァ イルの履歴が保存され、 すべてのユーザが利用でき

ます。 また、 フ ァ イルの中身をオフ ラ イ ンかニア ラ イ ンの記憶領域に移動させる こ と ができ

ます。 ( この機能は PERFORCE2010.2 で導入されま し た。 )

• フ ァ イルを完全消去する と、 ユーザ ・ コマン ド の動作が変わって く る こ と があ り ます。 完全

消去されたフ ァ イルに同期し て も、 フ ァ イルはも う ク ラ イ アン ト ・ ワーク スペースには組み

込まれていないため、 ク ラ イ アン ト ・ ワーク スペースからは削除されません。 完全消去され

たフ ァ イル ・ リ ビジ ョ ンに同期する と、 フ ァ イルが存在し ない と報告されるか （すべての リ

ビジ ョ ンが完全消去されていた場合） 、 ま たはそのフ ァ イルの完全消去されていない リ ビ

ジ ョ ンの う ちの 新 リ ビジ ョ ンが呼び出されます。

• フ ァ イルを リ ビジ ョ ン範囲で完全消去する と、 完全消去された範囲の リ ビジ ョ ン番号が “ス

キ ッ プ” され、 ス ク リ プ ト の動作が変わって く る こ と があ り ます。 例えば、 リ ビジ ョ ン #2

および #3 を完全消去し た後の p4 filelog の出力が次のよ う にな る と し ます。

... #4 change 1276 edit on 2001/04/18 by user1@dev1 (binary) ’Fixed’

... #1 change 1231 add on 2001/04/12 by user1@dev1 (binary) ’First try’

こ の場合には、出力の 1 行目にあ る #4 を元に、 p4 filelog の出力には 4 つのチェ ンジの記

述があ る と推量する よ う なス ク リ プ ト では問題が発生し ます。

使用例

-h 削除対象の一致レ コード を探す際に、 db.have の検索を スキ ッ プし ます。 これら

のフ ァ イルを示すク ラ イ アン ト ･ワーク スペースが次回同期された と きに、 ワーク

スペース内にあ るそのよ う なフ ァ イルも、 ワーク スペースから消去されます。 （ビ

ル ド ・ マシン上のク ラ イ アン ト ･ワーク スペースなどにおいては、 多 く の場合、 こ

のよ う な動作が求められます。）

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 admin

p4 obliterate dir/... フ ァ イルの完全消去は行わず、 -y オプシ ョ ンを付けた と きに完全

消去される フ ァ イルを リ ス ト 表示し ます。

この場合には、 dir 以下のデ ィ レ ク ト リ のすべてのフ ァ イルが -yオプシ ョ ンを付けた と きの消去の対象にな り ます。

p4 obliterate -y file fileをデ ィ ポから完全消去し ます。fileのあ ら ゆる リ ビジ ョ ンに

関する履歴および メ タデータのすべてが消去されます。

162 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 obliterate

関連コ マン ド

p4 obliterate -y file#3 file の リ ビジ ョ ン #3 だけを完全消去し ます。

#3 が 新 リ ビジ ョ ンであれば、 新 リ ビジ ョ ンは #2 に変わ り 、次

に生成される リ ビジ ョ ンは #3 にな り ます。

#3 が 新 リ ビジ ョ ンでなければ、 新の リ ビジ ョ ン番号は変わ り

ません。

p4 obliterate -y file#3,5 file の リ ビジ ョ ン #3、 4、 5 を完全消去し ます。

#5 が 新 リ ビジ ョ ンであれば、 新 リ ビジ ョ ンは #2 に変わ り 、次

に生成される リ ビジ ョ ンは #3 にな り ます。

#5 が 新 リ ビジ ョ ンでなければ、 新の リ ビジ ョ ン番号は変わ り

ません。

新 リ ビジ ョ ンのフ ァ イルを削除扱いにするが、 そのま まデ ィ ポに残す。

（通常のフ ァ イル削除の形態）

p4 delete

フ ァ イルを完全消去する代わ り に、 一部の リ ビジ ョ ンをアーカ イブ ・ デ ィ ポ

にアーカ イブする こ と によ り ローカル ・ デ ィ ポの空き容量を節約でき る。 こ

れらのフ ァ イルの変更履歴が保存される。

p4 archive

アーカ イブされた リ ビジ ョ ンをアーカ イブ ・ デ ィ ポから リ ス ト アする。 （完全

消去されたフ ァ イルは リ ス ト アでき ないが、 アーカ イ ブ されたフ ァ イルは リ

ス ト ア可能。）

p4 restore

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 163

p4 opened

p4 opened

概要

作業中のチェ ンジ リ ス ト 内にあ る作業状態のフ ァ イルを リ ス ト 表示し ます。

構文

p4 [g-opts] opened [-a -c change -C workspace -u user -m max -s][file ...]

解説

p4 opened は、p4 add、p4 edit、p4 delete、 または p4 integrate によ って現在作業状態に

なってい る フ ァ イルを リ ス ト 表示する ために使います。 デフ ォル ト では、 現在の ク ラ イ アン

ト ・ ワーク スペースにあ る作業状態のフ ァ イルがすべて リ ス ト 表示されます。 コマン ド ラ イ ン

引数を使えば、 特定の作業中チェ ンジ リ ス ト に含まれる フ ァ イルのみを リ ス ト 表示し た り 、 す

べての作業中チェ ンジ リ ス ト にあ る作業状態のフ ァ イルを表示し た り 、表示される フ ァ イルの

数を制限する こ と ができ ます。

p4 opened に引数と し てフ ァ イル指定が与え られていれば、 リ ス ト にはそのフ ァ イル指定に適

合する フ ァ イルだけが含まれます。

作業状態の各フ ァ イルについて表示される情報には、フ ァ イル名、デ ィ ポ内での保存場所、フ ァ

イルが 後に同期し た リ ビジ ョ ンの番号、 フ ァ イルが作業状態に さ れたチェ ンジ リ ス ト の番

号、 フ ァ イルを作業状態にし た目的の操作 （add、 edit、 delete、 integrate）、 フ ァ イルタ イ

プが含まれます。 各フ ァ イルの出力は次のフ ォーマ ッ ト で表示されます。

depot-file#rev - action chnum change (type) [lock-status]

ただし、

• depot-file はデ ィ ポ ・ シン タ ッ ク スで記述されたパスです。

• rev は リ ビジ ョ ン番号です。

• action はフ ァ イルが作業状態に された目的の操作、 すなわち add、edit、delete、branch、

または integrate です。

• chnum はサブ ミ ッ ト されるチェ ンジ リ ス ト の番号です。

• type は与え られた リ ビジ ョ ンのフ ァ イルのタ イプです。

• フ ァ イルがロ ッ ク されている場合は （p4 lock 参照）、行末に *locked* の警告が表示されま

す。

• +l 修飾子を使用する フ ァ イルタ イプを持つフ ァ イルには排他的ロ ッ ク（ p4 typemap の例を 参照） が適用され、 *exclusive* と い う ロ ッ ク ・ ステータ スで表示されます。

-s オプシ ョ ンを使用する と、 フ ァ イルの リ ビジ ョ ン番号 （#rev） と タ イプ （type） が省略さ

れた簡易出力が得られます。このコマン ド 形式は通常、デフ ォル ト 状態よ り も速 く 動作し ます。

オプシ ョ ン

-a すべての ク ラ イ アン ト ・ ワーク スペース内にあ る作業状態のフ ァ イルを リ ス

ト 表示し ます。

-c change 作業中チェ ンジ リ ス ト change のフ ァ イルを リ ス ト 表示し ます。デフ ォル ト ・

チェ ンジ リ ス ト のフ ァ イルを リ ス ト 表示するには、p4 opened -c default を使用し ます。

-C workspace 指定された ク ラ イ アン ト ・ ワーク スペース内で作業状態にあ る フ ァ イルのみ

を リ ス ト 表示し ます。

164 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 opened

使用上の留意点

• PERFORCEは、ユーザがすでに作業状態になっている フ ァ イルを作業状態にする こ と を妨げま

せん。 デフ ォル ト の構成では、 複数のユーザが同じ フ ァ イルを同時に編集し、 p4 resolve

でフ ァ イル衝突を解決する こ と が認められています。あ る フ ァ イルを別のユーザがすでに作

業状態にし ているかど う かを調べるには、 p4 opened -a file を使います。

• ロ ッ ク されたフ ァ イルは、p4 opened の出力において *locked* と表示されます。UNIX では、

次のコマン ド を実行する こ と によ って、作業状態でかつロ ッ ク されている フ ァ イルをすべて

検索する こ と ができ ます。

p4 opened | grep "*locked*"

これによ り 、 p4 lock でロ ッ ク された ロ ッ ク された作業状態のフ ァ イルを リ ス ト し ます。

p4 opened -a は大規模なサイ ト ではパフ ォーマン スに影響を与え る可能性があ り ます。 作

業状態のフ ァ イルの正確な リ ビジ ョ ン番号ま たはフ ァ イルタ イ プの情報が必要な場合以外

は、 p4 opened -as を使用し た方がよいでし ょ う 。

使用例

関連コ マン ド

-u user user によ って作業状態にされている フ ァ イルのみを一覧表示し ます。

-m max max 個までの作業状態のフ ァ イルのみを一覧表示し ます。

-s -s 簡易出力。 リ ビジ ョ ン番号およびフ ァ イルタ イプを出力し ません。 このオ

プシ ョ ンは、 大規模なサイ ト で -a （すべてのワーク スペース） オプシ ョ ン

を使用する場合に特に効率的です。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 list

p4 opened -c 35 //depot/main/... デ ィ ポのサブデ ィ レ ク ト リ main にあ る作業中チェ ン

ジ リ ス ト 35 のフ ァ イルをすべて リ ス ト 表示し ます。

p4 opened -a -c default 全ク ラ イ アン ト ・ ワーク スペースのデフ ォル ト ・ チェ

ンジ リ ス ト について、 作業状態のフ ァ イルをすべて リ

ス ト 表示し ます。

フ ァ イルを ク ラ イ アン ト ・ ワーク スペース内で作業状態にし、 チェ ンジ リ ス ト に

リ ス ト ア ッ プする。

p4 add

p4 edit

p4 delete

p4 integrate

1 つのチェ ンジ リ ス ト から別のチェ ンジ リ ス ト へフ ァ イルを移動する。 p4 reopen

すべてのチェ ンジ リ ス ト から特定のフ ァ イルを削除し、 以前の状態に戻す。 p4 revert

新しい番号付チェ ンジ リ ス ト を生成する。 p4 change

特定の基準に適合するチェ ンジ リ ス ト の リ ス ト を参照する。 p4 changes

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 165

p4 passwd

p4 passwd

概要

サーバ上でユーザの PERFORCE パス ワード を変更し ます。

構文

p4 [g-opts] passwd [-O oldpassword] [-P newpassword] [user]

解説

デフ ォル ト では、 ユーザ ・ レ コード はパス ワー ド な しに生成され、 いかなる PERFORCE ユーザ

も P4USER を設定するか、 またはグ ローバルに利用可能な -u オプシ ョ ンを用いる こ と によ っ

て他のユーザにな り 代わる こ と ができ ます。 他のユーザにな り 代わられる こ と を防ぐには p4

passwd を用いてパス ワード を設定し ます。

パス ワー ド を設定し た後は、 次の 3 つの方法のいずれかによ ってそのパス ワード を提示し て、

パス ワード によ る認証を受ける こ と ができ ます。

• 環境変数またはレジス ト リ 変数 P4PASSWD をパス ワード の値に設定する。

• P4CONFIG フ ァ イル内で P4PASSWD 用の設定を生成する。

• 例えば下記のよ う に、PERFORCE ク ラ イ アン ト ・コマン ド ラ イ ン上で -P password オプシ ョ ン

を使用する。

p4 -u ida -P idaspassword sync

上記の 3 つの方法の優先度は、 下に書かれた ものほど高 く な り ます。 お使いのイ ン ス ト ールに

対し て設定されたセキ ュ リ テ ィ ・ レベルによ っては、 これらの方法の う ちのいずれかが許され

ないこ と があ り ます。

セキ ュ リ テ ィ ・ レベル 0 および 1 の PERFORCE サービ スに接続する Windows および OS X の

PERFORCE アプ リ ケーシ ョ ンでは、p4 passwd は p4 set を使用し てパス ワード の MD5 ハッ シ ュ

を レ ジ ス ト リ 設定ま たはシ ス テム設定に保持する こ と に よ り 、 パス ワー ド を保存し ます。 セ

キ ュ リ テ ィ ・ レベル 2 および 3 の PERFORCE サービ スに接続する場合は、 パス ワー ド のハ ッ

シ ュがそれらの場所に保存される こ と も、 それらの場所から読み取られる こ と も あ り ません。

パス ワード ・ ベースの認証の代わ り にチケ ッ ト ・ ベースの認証を使用し て、 セキ ュ リ テ ィ を強

化する こ と がで き ます。 パス ワー ド の代わ り にチケ ッ ト で認証するには、 初に p4 passwd

でパス ワード を設定し、 次に p4 login コマン ド と p4 logout コマン ド を使用し て認証を管

理し ます。

ユーザをグループに割 り 当てて p4 group のフ ォームで PasswordTimeout: フ ィ ール ド を設定

する こ と によ り 、 さ らにセキ ュ リ テ ィ を強化する こ と ができ ます。 ユーザが複数のグループに

属し ている場合、 大の PasswordTimeout の値が適用されます。

PERFORCE スーパーユーザは、個々のユーザ （またはサイ ト 全体のすべてのユーザ） のパス ワー

ド を p4 admin resetpassword コマン ド によ って リ セ ッ ト する こ と ができ ます。 また、 構成

可能変数 dm.user.resetpassword を （ p4 configure によ り ） 設定し て、 新規に作成された

ユーザが、アカ ウ ン ト 作成時に割 り 当て られたパス ワード を リ セ ッ ト する よ う 強制する こ と も

可能です。

ユーザ認証のし く みについて詳し く は、 『システム管理者ガ イ ド』 をご覧 く だ さい。

セキ ュ リ テ ィ ・ レベル と PERFORCE アプ リ ケーシ ョ ン ・ リ リ ースの特定の組み合わせでは、ユー

ザ は 「強 い」 パ ス ワ ー ド を 設 定 す る こ と を 求 め ら れ ま す。 パ ス ワ ー ド が

dm.password.minlength に定義された文字数 （デフ ォル ト では 8 文字） 以上の長さ で、 以下

の記述の う ちの少な く と も 2 つが真であ る場合に、 そのパス ワード は強い と見な されます。

166 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 passwd

• パス ワード に大文字が含まれている

• パス ワード に小文字が含まれている

• パス ワード にアルフ ァベッ ト 以外の文字が含まれている

例えば、 a1b2c3d4、 A1B2C3D4、 aBcDeFgH などのパス ワード は ( デフ ォル ト では ) 強い と見な

されます。 チケ ッ ト ・ ベースの認証のし く みについては、 『システム管理者ガ イ ド』 をご覧 く

ださい。

オプシ ョ ン

使用上の留意点

• パス ワード には 1024 文字まで設定可能です。 リ リ ース 2013.1 からは構成可能変数

dm.password.minlength を設定する こ と によ り パス ワード の長さ を設定でき ます。16 文字

以上の長さ のパス ワード を必須とするには、 スーパーユーザが次の とお り 実行し ます。

p4 configure set dm.password.minlength=16

デフ ォル ト のパス ワード 小文字数は 8 文字です。

• p4 passwd コマン ド は、プレーンテキス ト のパス ワード をネ ッ ト ワーク を介し て送る こ と は

あ り ません。 暗号化されたパス ワード をサービ スに送るには、 チャ レ ンジ / レ スポン スの メ

カニズムが利用されます。

• パス ワード はスペース を含んで もかまいません。コマン ド ラ イ ンでそのよ う なパス ワード を

使用する と きには、 引用符を付ける必要があ り ます。 例えば、 my passw と い う パス ワード

を PERFORCE に渡すには、 p4 -P "my passw" command と実行し ます。

• ユーザが自分のパス ワード を忘れた場合には、PERFORCE スーパー・ユーザはコマン ド ラ イ ン

上で p4 passwd username と ユーザ名を指定し て、 それを リ セ ッ ト する こ と ができ ます。

• パス ワード を削除するには、 パス ワード の値と し て空文字列を設定し ます。 サーバのセキ ュ

リ テ ィ ・ レベルによ っては、 空文字列のパス ワード の設定が許可されない こ と も あ り ます。

• チケ ッ ト ・ ベースの認証を使用し ている場合、 ユーザがパス ワード を変更する と、 自動的に

そのユーザのすべてのチケ ッ ト が無効に され、 ユーザはロ グア ウ ト されます。 つま り 、 パス

ワード を変更する こ と は、 p4 logout -a を実行する こ と と同じです。

関連コ マン ド

-O oldpassword コ マン ド ラ イ ン上で古いパス ワー ド を指定する こ と によ り 、 プロ ンプ ト 入力

を避けます。 セキ ュ リ テ ィ ・ レベル 2 または 3 を使用する よ う にサイ ト が構

成されている場合は、 こ のオプシ ョ ンはサポー ト されません。

-P newpassword コ マン ド ラ イ ン上で新しいパス ワー ド を指定する こ と によ り 、 プロ ンプ ト 入

力を避けます。 セキ ュ リ テ ィ ・ レベル 2 または 3 を使用する よ う にサイ ト が

構成されている場合は、 こ のオプシ ョ ンはサポー ト されません。

user スーパー ・ ユーザはこ の引数を付けて他のユーザのパス ワー ド を変更する こ

と ができ ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

他のユーザの仕様を変更する。 p4 user

ユーザのア ク セス ・ レベルを変更する。 p4 protect

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 167

p4 passwd

パス ワード の代わ り にチケ ッ ト を使用し て ロ グ イ ンする。 p4 login

パス ワード の リ セ ッ ト を強制する。 p4 admin resetpassword

168 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 ping

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 169

p4 ping

概要

ネ ッ ト ワーク のパフ ォーマン ス をテス ト し ます。

構文

p4 [g-opts] ping [-f][-p pausetime][-c count][-t transmittime][-i iterations][-s sendsize][-r receivesize]

解説

p4 ping は PERFORCE のネ ッ ト ワーク・ ト ラ フ ィ ッ ク をシ ミ ュ レー ト し て、バージ ョ ン化サービ

スから PERFORCE アプ リ ケーシ ョ ンに メ ッ セージを送信し、 それが戻って く る までの往復時間

を計測し ます。 往復時間は ミ リ 秒単位で報告されます。 往復時間は通常、 1 つの メ ッ セージで

は速すぎて測定でき ないので、 テス ト 1 回あた り の メ ッ セージ数を count で指定でき ます。

オプシ ョ ン

使用上の留意点

• オペレーテ ィ ング ・ システムの該当コマン ド と同様に、p4 ping によ ってネ ッ ト ワーク の ト

ラ フ ィ ッ ク量が増大する こ と があ り ます。

-c count テス ト 1 回あた り の メ ッ セージ数

-t transmittime データ を transmittime( 大 6000) 秒間送信し ます。

-i iterations テス ト を iterations で指定された回数だけ繰 り 返し ます。

-f 大量送信モード : サービ スから連続的に送信を行い、PERFORCE アプ リ ケーシ ョ

ンに よ る前の メ ッ セージの受信確認を待たずに、 次の メ ッ セージを送信し ま

す。

-p pausetime 次のテス ト まで pausetime 秒間、 大 120 秒間処理を停止し ます。 停止し な

いよ う にするには、 pausetime を 0 に指定し ます。

-s sendsize サーバからユーザへの メ ッ セージのサイ ズ。 大値は 10,000,000 バイ ト 。

-r receivesize ユーザからサーバへの メ ッ セージのサイ ズ。 大値は 100,000 バイ ト 。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 admin

p4 populate

170 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 populate

概要

あ る フ ァ イル集合のブラ ンチ処理を 1 回の操作で行います。

構文

p4 [g-opts] populate [options] fromFile[rev] toFilep4 [g-opts] populate [options] -b branch [-r] [toFile[o] ...]p4 [g-opts] populate [options] -b branch -s fromFile[rev] [toFile ...]p4 [g-opts] populate [options] -S stream [-P parent] [-r] [toFile[rev]...]オプシ ョ ン : -d description -f -m max -n

解説

p4 populate コマン ド は、 あ る フ ァ イル集合 （反映元） をデ ィ ポ内の別の場所 （反映先） へと

1 回の操作でブラ ンチし ます。 新しいフ ァ イルがただちに作成され、 p4 submit コマン ドやク

ラ イ アン ト ・ ワーク スペース を必要と し ません。

オプシ ョ ン

使用上の留意点

-S stream ス ト リ ームのビ ューを使用し ます。反映元はス ト リ ーム自体であ り 、反映先は

ス ト リ ームの親です。

-P parent -S stream と と も に使用さ れる と、 ス ト リ ームの実際の親ではない親ス ト

リ ームを指定し ます。

-b branch ユーザ定義のブラ ンチ仕様のビ ューを使用し ます。反映元がブラ ンチ ・ ビ ュー

の左側、 反映先がブラ ンチ ・ ビ ューの右側にな り ます。

-r 反映処理の方向を逆にし ます （反映元から反映先へではな く 、反映先から反映

元へ）

-s -b branch と と もに使用される と、 fromFile を反映元と し て扱い、 ユーザ

定義のブラ ンチ ・ ビ ューの両側を反映先と し て扱います。

（任意指定の toFile 引数を供給する と、 反映先フ ァ イル集合の範囲がさ らに

限定されます。） -s オプシ ョ ンの使用時は、 -r 引数は無視されます。

-d description 自動的にサブ ミ ッ ト されるチェ ンジ リ ス ト に対する コ メ ン ト を指定し ます。

-f 削除されたフ ァ イルを強制的に反映先にブ ラ ンチし ます。 （デフ ォル ト では、

削除されたフ ァ イルは存在し ないもの と し て扱われ、 スキ ッ プされます。）

-n 実際には何も行わずに、 操作の結果をプレ ビ ューし ます。

-o p4 populate コマン ド によ って作成されたフ ァ イルの リ ス ト を表示し ます。

-m max 操作対象のフ ァ イルを max 個に制限し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 open

p4 print

p4 print

概要

デ ィ ポ ・ フ ァ イルの リ ビジ ョ ンの内容を表示し ます。

構文

p4 [g-opts] print [-a -A -k -o outfile -q -m max] file[revRange] ...

解説

p4 print は、 デ ィ ポ ・ フ ァ イルの内容を標準出力へ書き出し ます。 リ ビジ ョ ン範囲を指定し

た場合、指定された範囲内の リ ビジ ョ ンを持つフ ァ イルだけを書き出し ます。デフ ォル ト では、

範囲内の 高位 リ ビジ ョ ンだけを書き出し ます。 （指定された リ ビジ ョ ン範囲における全フ ァ

イルを出力するには、 p4 print -a を使用し ます。）

デ ィ ポのどのフ ァ イルで も、 p4 protect によ って認められたア ク セス権限に従って表示させ

る こ と ができ ます。 フ ァ イル引数が ク ラ イ アン ト ・ ビ ューによ ってマ ッ ピング されていない場

合は、 デ ィ ポ ・ シン タ ッ ク スで指定し なければな り ません。

デフ ォル ト では、 フ ァ イルの内容 と と も に、 そのフ ァ イルのデ ィ ポにおけ る位置を記述する

ヘッ ダ、 表示されたフ ァ イルの リ ビジ ョ ン番号、 その リ ビジ ョ ンがサブ ミ ッ ト されるチェ ンジ

リ ス ト の番号も表示されます。 ヘッ ダを抑制するには、 -q (quiet) オプシ ョ ンを使用し ます。

デ フ ォ ル ト では、 RCS キー ワ ー ド は拡張 さ れ ま す。 キー ワ ー ド 拡張を 抑制す る には、 -k

（keyword） オプシ ョ ンを使用し て く だ さい。

複数のフ ァ イル ・ パターン を含め る こ と も で き ます。 その場合には、 それ ら のフ ァ イル ・ パ

ターンのいずれかに適合するすべてのフ ァ イルが表示されます。

オプシ ョ ン

使用上の留意点

• ほ と んどの端末では UTF16 のコ ンテンツを表示でき ないこ と から、p4 print コマン ド のデ

フ ォル ト の動作では UTF8 のコ ンテン ツ を返し ます。 端末か ら の出力全体を抑止し、 出力

フ ァ イルを指定する こ と もでき ます。 例 ：

p4 print -q -o outputfile //depot/file

-a すべてのフ ァ イルに対し て、 指定された リ ビジ ョ ン範囲内の 新 リ ビジ ョ ンだけ

でな く 、 全 リ ビジ ョ ンを書き出し ます。

-A アーカ イブ ・ デ ィ ポに格納されたフ ァ イルの書き出し を試みます。

-k RCS キーワード拡張を抑制し ます。

-o outfile デ ィ ポのオ リ ジナル ・ フ ァ イル と 同じ フ ァ イルタ イ プ、 属性、 パー ミ ッ シ ョ ン設

定を保持し て、 出力を ローカル ・ デ ィ ス ク上の指定された出力フ ァ イルに リ ダ イ

レ ク ト し ます。

-q 通常はPERFORCE によ って追加される 1行のフ ァ イル・ヘッ ダの表示を抑制し ます。

-m max max 個までのフ ァ イルのみを出力し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 read

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 171

p4 print

お使いの端末で UTF16 形式の出力がサポー ト されている場合は、 標準出力を出力フ ァ イル

と し て次のよ う に指定し ます。

p4 print -q -o - //depot/file

• p4 print のフ ァ イル引数 と し て リ ビジ ョ ン範囲を指定する こ と ができ ます。 適合する フ ァ

イルの 新の リ ビジ ョ ンだけが表示されます。 （これは、 指定されない と きの暗黙の範囲が

#1,#head であ り 、 その 高位が #head であ る こ と を意味し ています。） 指定された （も し く

は暗黙の） 反映内の全フ ァ イルを書き出すには、 -a オプシ ョ ンを指定し ます。

• ファ イ ル引数を詳細に定義せずに p4 print を実行する と 、結果が大量に出力さ れる があり ま

す。 （例えば、 p4 print //depot/... と指定する と、 デ ィ ポのすべてのフ ァ イルの内容が

表示されます。） 出力は、 p4 group で設定された maxresults の制限に準拠し ます。

• 多 く の場合、p4 print の出力は OS のシェルを介し てフ ァ イルに リ ダ イ レ ク ト すれば十分で

す。

-oオプシ ョ ンは、ユーザがフ ァ イルタ イプやパー ミ ッ シ ョ ンの自動設定を必要とする状況に

対処する ために使用し ます。 これはシンボ リ ッ ク ・ リ ン ク （タ イプ symlink と し て保存） の

よ う なフ ァ イル、 タ イプ apple のフ ァ イル、 またはタ イプ text+x など と し て保存されてい

る UNIX シェル ・ ス ク リ プ ト の実行ビ ッ ト の自動設定には便利です。

関連コ マン ド

デ ィ ポ ・ フ ァ イルの 2 つの リ ビジ ョ ンの内容を比較する。 p4 diff2

ク ラ イ アン ト ・ ワーク スペースで作業状態になっている フ ァ イルの内容を、

デ ィ ポ ・ フ ァ イルの リ ビジ ョ ン と比較する。

p4 diff

172 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 protect

p4 protect

概要

ユーザによ る フ ァ イル、 デ ィ レ ク ト リ 、 コマン ドへのア ク セス を管理し ます。

構文

p4 [g-opts] protectp4 [g-opts] protect -op4 [g-opts] protect -i

解説

p4 protect は、 PERFORCE パー ミ ッ シ ョ ンを制御し ます。 以下のよ う に使用でき ます。

• どのユーザがどのフ ァ イルにア ク セスでき るかを制御し ます。

• どのユーザがどのコマン ド を使用でき るかを制御し ます。

• 上記の 2 点を組み合わせる と、 あ るユーザに対し て、 あ る フ ァ イル ・ セ ッ ト へは書き込み可

能で他のフ ァ イルは読み取 り のみ、 と い う 制御ができ ます。

• ユーザに対し て特定のア ク セ ス権限を付与ま たは拒否する には、 =read、 =open、 =write、

=branch の各権限を使用し ます。 それよ り 下位の権限を再度付与する必要はあ り ません。

• p4 group で定義し たユーザ ・ グループにパー ミ ッ シ ョ ンを与えます。

• 特定のIPア ド レ ス上のユーザのみがPERFORCEを実行でき る よ う 、ア ク セス を このIPア ド レ ス

に限定し ます。

一般的に、 ユーザまたはグループご と にア ク セス ・ レベルが 1 つ与え られ、 さ らによ り 細かい

制御が必要であれば、 1 つ以上の特定の権限を選択的に拒否する こ と ができ ます。

以下に、 PERFORCE のパー ミ ッ シ ョ ン ・ レベル と ア ク セス権限を示し ます。

パー ミ ッ シ ョ ン ・

レベル / 権限

ユーザが実行できる こ と

list すべての PERFORCE メ タデータにア ク セスでき ますが、 フ ァ イルの内容にはア ク

セスでき ません。 p4 files、 p4 client、 p4 job、 p4 describe、 p4 branch などの PERFORCE オブジェ ク ト を記述する コマン ド をすべて実行でき ます。

read list 権限で許可されている こ と をすべて実行でき ます。 さ らに、 フ ァ イルのデー

タ の読み取 り を伴 う コ マン ド もすべて実行で き ます （p4 print、 p4 diff、 p4 sync など）。

=read この権限が拒否される と、 ユーザはフ ァ イルに対し て p4 print、 p4 diff、 p4 sync を実行でき ません。

open read 権限で実行で き る こ と をすべて許可 し ます。 ま た、 フ ァ イ ルを追加 （p4add）、 編集 （p4 edit）、削除 （ p4 delete）、反映 （p4 integrateÅj するパー

ミ ッ シ ョ ン を与え ます。 ただし、 フ ァ イルのロ ッ クやデ ィ ポへのサブ ミ ッ ト は許

可されていません。

=open こ の権限が拒否 さ れ る と、 ユーザは p4 add、 p4 edit、 p4 delete、 p4 integrate によ ってフ ァ イルを作業状態にする こ と ができ ません。

write 上記のすべてを実行でき ます。さ らに、 p4 submit によ る フ ァ イルへの書き込み、

p4 lock によ る フ ァ イルのロ ッ ク を実行でき ます。

=write この権限が拒否される と、 ユーザは作業状態のフ ァ イルをサブ ミ ッ ト でき ません。

=branch この権限が拒否される と、ユーザはフ ァ イルを p4 integrate の反映元と し て使

用でき ません。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 173

p4 protect

フ ォーム内のフ ィ ールド

p4 protect を実行する と、PERFORCE はフ ィ ール ド ［Protections:］ だけの フ ォームを表示し

ます。 各パー ミ ッ シ ョ ンは、 ［Protections:］ の見出しに対し て イ ンデン ト された、 専用の行

に指定されます。 各行には次の 5 つの設定値があ り ます。

除外マ ッ ピングが設定されていない場合、 各ユーザにはユーザ、 ユーザの IP ア ド レ ス、 およ

びユーザがア ク セス し よ う と し ている フ ァ イル と 適合するすべてのマ ッ ピ ングに リ ス ト さ れ

たパー ミ ッ シ ョ ン ・ レベルの中で 高のレベルが与え られます。 この場合、 マ ッ ピングの順序

は関係あ り ません。

除外マ ッ ピ ングが設定されている場合、 マ ッ ピ ングの順序が関係し ます。 除外マ ッ ピ ングは、

それよ り 上の行に リ ス ト さ れている プ ロ テ ク シ ョ ンの う ち適合する も のはすべて無効に し ま

す。 除外プロ テ ク シ ョ ンでどのア ク セス ・ レベルが拒否されていて も、 適合するユーザ、 フ ァ

イル、 IP ア ド レ スに対するすべてのア ク セス ・ レベルが拒否されます。

review PERFORCE にア ク セスする外部プロ グ ラ ム専用のパー ミ ッ シ ョ ンです。 list 権限

とread権限で実行でき る こ とすべてのパー ミ ッ シ ョ ンを外部プロ グ ラ ムに与えま

す。 また、p4 review と p4 counter を実行するパー ミ ッ シ ョ ンを与えます。た

だし、 open および write 権限は含まれません。

admin 上記のすべてに加え、 メ タデータへの変更をオーバラ イ ド する ための管理者用コ

マン ド を実行するパー ミ ッ シ ョ ンを与え ます。 ただし、 サーバの動作に影響する

コマン ド を実行するパー ミ ッ シ ョ ンは与えません。

これに該当するのは、 p4 branch -f、 p4 change -f、 p4 client -f、 p4 job -f、 p4 jobspec、 p4 label -f、 p4 obliterate、 p4 shelve -f - d、 p4 typemap、 p4 unlock -f および p4 verify です。

super 上記のすべ て に加 え、 さ ら に p4 admin、 p4 counter、 p4 triggers、 p4 protect、 および p4 user -f によ るユーザ作成機能などのスーパー ・ ユーザ ・

コマン ド にも ア ク セスでき ます。

列 説明

ア ク セス ・ レベル 前項で定義された、list、read、open、write、review、super または =read、=open、 =write、 =branch の各権限の う ちの 1 つ。

ユーザま たはグルー

プ

プロ テ ク シ ョ ンが適用されるのは、 ユーザかグループかの指定。

グ ル ー プ 名 ま た は

ユーザ名

ユーザ名または p4 group で定義し たグループ名。

すべてのユーザにこのパー ミ ッ シ ョ ンを与え る と きは、 ワ イル ド カード 「*」 を

使用し ます。

ホス ト IP ア ド レ ス。IPv6 ア ド レ スおよび IPv6 ア ド レ スがサポー ト されています。また、

CIDR 表記を使用し ていない場合にのみ、すべての IP ア ド レ ス を参照する ために

ワ イル ド カード 「*」 を使用でき ます。

IPv6 ア ド レ スに * ワ イル ド カード を使用する場合は、 IPv6 ア ド レ ス全体を角括

弧で囲む必要が あ り ま す。 例え ば、 [2001:db8:1:2:*] は

[2001:db8:1:2::]/64 に相当し ます。 CIDR 表記を使用し、 IPv6 ア ド レ ス を

角括弧で囲み、 * ワ イル ド カード の使用を避けるのが も良い方法です。

デ ィ ポ ・ フ ァ イ ルの

パス

PERFORCE のデ ィ ポ・シン タ ッ ク スで、このパー ミ ッ シ ョ ンが与え られているデ ィ

ポ ・ フ ァ イルのパス。 フ ァ イルの指定は、 PERFORCE のワ イル ド カード を含むこ

と ができ ます。

このマ ッ ピングをパー ミ ッ シ ョ ン ・セ ッ ト から除外するには、設定値の頭にダ ッ

シュ （-） を付けます。

パー ミ ッ シ ョ ン ・

レベル / 権限

ユーザが実行できる こ と

174 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 protect

除外マ ッ ピ ングを使用し て、 group1 の メ ンバーに対し てデ ィ ポのあ る領域へのア ク セス を拒

否し、 group2 の メ ンバーに対し てはデ ィ ポの同じ領域へのア ク セス を許可し た場合、 group1

と group2 の両方の メ ンバーであ るユーザは、 プロ テ ク シ ョ ン ・ テーブル内でどち らの行が後

に記述されているかによ ってア ク セスの可否が決ま り ます。

オプシ ョ ン

使用上の留意点

• 下図のよ う に、 各パー ミ ッ シ ョ ンのレベルはその下にあ るすべてのア ク セス ・ レベルを含み

ます。

• 特殊な権限であ る =read、 =open、 =write、 =branch を使用し て、 下位のア ク セス ・ レベル

を自動的に包含し ないよ う にする こ と ができ ます。 これによ り 、 個々の権限を無効にする こ

と ができ、 後で下位の権限を再度付与する必要はあ り ません。

例えば、 管理者に管理コマン ド の実行権限を与えたいが、 デ ィ ポの一部を変更する権限を拒

否し たい と い う 場合、 パー ミ ッ シ ョ ン ・ テーブルを次のよ う に設定する と よいでし ょ う 。

こ の例では、 ユーザ joe は管理機能を実行でき、 こ のパー ミ ッ シ ョ ンはシ ス テム内のすべ

てのデ ィ ポに適用されます。admin パー ミ ッ シ ョ ン ・ レベルでは暗黙的にそれよ り 下位にあ

るすべてのア ク セス ・ レベルが認め られる ため、 joe は //depot/build/ を含むシス テム

内のどのフ ァ イルに も、 書き込み、 オープン、 読み取 り 、 一覧表示が可能です。 build デ ィ

レ ク ト リ 配下を保護する には、 =write お よ び =open の排他行を テーブルに追加 し ます。

ユーザ joe は build デ ィ レ ク ト リ 配下にあ る フ ァ イルを編集目的で作業状態にする こ と はで

き ません。 また、 すでに作業状態にし ている可能性のあ る、 こ のデ ィ レ ク ト リ 配下での変更

-i エデ ィ タ を起動せずに、 標準出力から フ ォームを読み取 り ます

-o エデ ィ タ を起動せずに、 フ ォームを標準出力に書き出し ます

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル変数はリ ビジ ョ ン指定

子を使用できるか

フ ァ イル変数はリ ビジ ョ ン範囲

を使用できるか

要求される最低アクセス ・ レベル

使用不可 使用不可 super

admin user joe * //...=write user joe * -//depot/build/...=open user joe * -//depot/build/...

read

reviewopen

write

list

admin

super

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 175

p4 protect

をサブ ミ ッ ト する こ と もでき ません。 フ ァ イルの作成および変更は引き続き可能ですが、 保

護された領域 //depot/build/... の外にそれらのフ ァ イルがあ る場合に限られます。

• 使用でき る コマン ド は、 ア ク セス ・ レベルによ って決ま り ます。 下表は、 各コマン ド で 低

限必要なア ク セス ・ レベルを示し ています。 例えば、 p4 add では少な く と も open ア ク セ

ス権限が必要なので、 ユーザは open、 write、 admin、 または super のア ク セス権限を持っ

ている場合に p4 add を実行でき ます。

コマン ド アクセス ・

レベル

備考

add open

admin super

annotate read

archive admin

attribute write サブ ミ ッ ト さ れた フ ァ イ ルに属性を設定する ための -f オプ

シ ョ ンには、 admin 権限が必要です。

branch open 既存の メ タデータや他のユーザのデータ をオーバラ イ ド する た

めの -f オプシ ョ ンには、 admin 権限が必要です。

branches list

browse none

change open -oオプシ ョ ン (変更を標準出力に表示) にはlist権限さ えあれ

ば十分です。 既存の メ タデータや他のユーザのデータ をオーバ

ラ イ ドするための -f オプシ ョ ンには、admin 権限が必要です。

changes list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

client list 既存の メ タデータや他のユーザのデータ をオーバラ イ ド する た

めの -f オプシ ョ ンには、 admin 権限が必要です。

clients list

configure super

copy list コ ピー元フ ァ イルには list 権限、コ ピー先フ ァ イルには open権限が必要です。

counter review 既存のカ ウ ン タの値を参照するには、list 権限が必要です。 カ

ウ ン タの値を変更し た り 、 新しいカ ウ ン タ を生成し た り するに

は、 review 権限が必要です。

counters list

cstat list

dbschema super

dbstat super

dbverify super

delete open

depot super こ のコマン ド の -o オプシ ョ ンは、フ ォームの編集ではな く 読み

取 り を可能にする もので、 list 権限さ えあれば十分です。

depots list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

describe read こ のコマン ド に -s オプシ ョ ンを付ける と フ ァ イルの内容は表

示されないため、 list 権限さ えあれば十分です。

diff read

176 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 protect

diff2 read

dirs list

diskspace super

edit open

export super

filelog list

files list

fix open

fixes list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

flush list

fstat list

grep read

group super こ のコマン ド の -o オプシ ョ ンは、フ ォームの編集ではな く 読み

取 り を可能にする もので、 list 権限さ えあれば十分です。

こ のコマン ド の -a オプシ ョ ンには、 ユーザがグループ所有者

と し て も リ ス ト されている場合に限 り 、list 権限のみが必要で

す。

-A オプシ ョ ンには、 admin 権限が必要です。

groups list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

have list

help none

info none

integrate open ユーザは反映先フ ァ イルに対する open 権限と反映元フ ァ イル

に対する read 権限が必要です。

integrated list

interchanges list

istat list

job open こ のコマン ド の -o オプシ ョ ンは、フ ォームの編集ではな く 読み

取 り を可能にする もので、 list 権限さ えあれば十分です。

既存の メ タデータや他のユーザのデータ をオーバラ イ ド する た

めの -f オプシ ョ ンには、 admin 権限が必要です。

jobs list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

journaldbchecksums super

key review 既存のキーの値を表示するには、 デ ィ ポ内の 1 つ以上のフ ァ イ

ルに対する list 権限が必要です。 キーの値を変更するか新し

いキーを作成するには、 review 権限が必要です。

keys list 構成可能変数 dm.keys.hide が設定さ れている場合、 admin 権限が必要です。

コマン ド アクセス ・

レベル

備考

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 177

p4 protect

label open こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

既存の メ タデータや他のユーザのデータ をオーバラ イ ド する た

めの -f オプシ ョ ンには、 admin 権限が必要です。

labels list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

labelsync open

license super ラ イセン ス使用量を表示する -u オプシ ョ ンには admin 権限が

必要です。

list open

lock write

lockstat super

logappend list

logger review

login list

logout list

logparse super

logrotate super

logschema super

logstat super

logtail super

merge open

monitor list プロセス を終了または消去するには super 権限が必要です。引

数を参照するには admin 権限が必要です。

move open

obliterate admin

opened list

passwd list

ping admin

populate open

print read

protect super

protects list -a、-g、-u オプシ ョ ンを使用するには、super 権限が必要です。

property list 読み取 り には list 権限、 新しいプロパテ ィ の追加 / 削除とす

べて のユーザお よ びグ ループのプ ロ パテ ィ 設定の表示には

admin 権限が必要です。

proxy none PERFORCE プロ キシに接続し ている必要があ り ます。

pull super

reconcile open

reload open p4 reload -fを使用し て他のユーザのワーク スペース と ラベ

ルを リ ロードするには、 admin 権限が必要です。

コマン ド アクセス ・

レベル

備考

178 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 protect

reopen open

replicate super

resolve open

resolved open

revert open

review review こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

reviews list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

server super

serverid list サーバ ID を設定するには、 super 権限が必要です。

set none

shelve open p4 shelve -f -d によ り 保留中のフ ァ イルを強制的に削除す

るには、 admin 権限が必要です。

sizes list

stream open

streams list

submit write

sync read

tag list

tickets none

triggers super

typemap admin こ のコマン ド の -o オプシ ョ ンは、フ ォームの編集ではな く 読み

取 り を可能にする もので、 list 権限さ えあれば十分です。

unload open p4 unload -fを使用し て他のユーザのワーク スペース と ラベ

ルをアン ロードするには、 admin 権限が必要です。

unlock open 既存の メ タデータや他のユーザのデータ をオーバラ イ ド する た

めの -f オプシ ョ ンには、 admin 権限が必要です。

unshelve open

update list

user list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

（ユーザの作成ま たは編集に使用さ れる） -f オプシ ョ ンには、

super 権限が必要です。

users list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

構成可能変数 run.users.authorize が 1 に設定されている

場合、 p4 users を実行する ためにはユーザ自身がサーバか ら認

証を受け る必要があ り ます。

コマン ド アクセス ・

レベル

備考

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 179

p4 protect

• 新しい PERFORCE を イ ン ス ト ールし た と きは、PERFORCE を使用し たい人すべてがサービ スに

接続でき、 すべての PERFORCE ユーザがスーパー ・ ユーザ と な り ます。 初めて p4 protect

が実行される と、 その実行者がスーパー ・ ユーザ と な り 、 他のユーザにすべてのフ ァ イルに

対する write パー ミ ッ シ ョ ンが与え られます。イ ン ス ト ール後すぐに p4 protect を実行し

て く ださ い。

• 通常の操作で与え られる ア ク セス ・ レベルは、 主に list、 read、 write および super です。

open と review はあま り 使用されません。

• p4 describeのよ う なフ ァ イルを一覧表示する コマン ド は、ユーザが 低list権限を持って

いる フ ァ イルのみを一覧表示し ます。

• -f オプシ ョ ンを指定でき る コマン ド （例えば、以前にサブ ミ ッ ト されたチェ ンジ リ ス ト を編

集する p4 change） があ り ますが、 これには admin も し く は super 権限が必要です。

• ア ク セス・レベル open で、フ ァ イルを変更する こ と はでき ますがデ ィ ポにサブ ミ ッ ト する こ

と はでき ません。一時的にコー ド ラ イ ンを凍結させたいが開発者の作業を止めた く ない場合

や、 試験担当者に対し、 個人使用のためのコード変更は認めるがコード ラ イ ンに永久的な変

更を加え る こ と は認めないよ う な場合などに、 open 権限を使用し て く だ さい。

• ア ク セス ・ レベル review は、 カ ウ ン タ値にア ク セスする必要のあ る レ ビ ュー ・ デーモンを

意図し ています。

• review権限と write権限の両方を必要 とするがsuper権限は必要と し ないレ ビ ュー・デーモ

ンを記述する場合、 プロ テ ク シ ョ ン ・ テーブルには、 別々の行で review 権限と write 権限

の両方をデーモンに与えて く だ さい。

• あ るサーバ上のフ ァ イルを別のサーバからの リ モー ト ・ デ ィ ポ と し て使用する （p4 depot

で定義） のを制限し た り 排除するには、 remote ユーザ （または別のサーバが認証に用いる

サービ ス ・ ユーザ） に対する プ ロ テ ク シ ョ ン を作成 し て く だ さ い。 リ モー ト ・ デ ィ ポは、

ユーザの PERFORCE サービ スに関連付け られたサービ ス ・ ユーザか remote と い う 名前の仮

想ユーザによ ってア ク セス されます。

• 詳細情報については、 『システム管理者ガイ ド』 の 「プロ テ ク シ ョ ン」 章をご覧 く だ さい。

使用例

ユーザ joe が p4 group によ って devgroup グループ と buggroup グループの メ ンバーに設定

されてお り 、 こ の組織が IPv4 接続のみを使用し ている と 仮定する と、 プロ テ ク シ ョ ン ・ テー

ブルは次の よ う にな り ます。

verify admin

where list こ の コ マン ド は特定のフ ァ イ ルに作用す る も のではあ り ませ

ん。 つま り 、 ユーザがデ ィ ポの少な く と も 1 つのフ ァ イルに対

し て権限を指定されていれば、 コマン ド 実行のパー ミ ッ シ ョ ン

は認められています。

super user bill * //...write group devgroup * //depot/...write group buggroup * -//depot/proj/...write user joe 192.168.100.0/24 //...

コマン ド アクセス ・

レベル

備考

180 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 protect

joe はい く つかの操作を試みます。 各操作が成功するか失敗するかは次の とお り です。

関連コ マン ド

操作元 IP ア ド レス 試みる操作 結果

10.14.10.1 p4 print //depot/misc/... 成功し ます。2 行目で、 これらのフ ァ イ

ルへの write 権限が joe に与え られ

ています。 write 権限は read 権限を

含み、 以降のどの行で も こ のプ ロ テ ク

シ ョ ンは除外されていません。

10.14.10.1 p4 print //depot/proj/README 失敗し ます。3 行目で、 このデ ィ レ ク ト

リ 中のあ ら ゆる フ ァ イルに対する joeのすべてのパー ミ ッ シ ョ ンが除去され

ています。 （2 番目と 3 番目のプロ テ ク

シ ョ ンが入れ替わっていた場合、 以降

のプ ロ テ ク シ ョ ンが除去を無効にする

ので、 joe はこ の操作に成功し ます。）

192.168.100.123 p4 print //depot/proj/README 成功し ます。Joe のワーク ステーシ ョ ン

は、 4 行目で操作元 と し て こ のパー

ミ ッ シ ョ ン を与え ら れた IP ア ド レ ス

に位置し ています。

192.168.100.123 p4 verify //depot/misc/... 失敗し ます。 p4 verify は super 権

限を必要と し、 どの IP ア ド レ スから ア

ク セス し て も joe はこのア ク セス ・ レ

ベルを持っていません。

ユーザ ・ グループを作成または編集する。 p4 group

すべてのユーザ ・ グループを一覧表示する。 p4 groups

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 181

p4 protects

182 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 protects

概要

指定されたユーザ、 グループまたはパスに設定された プロ テ ク シ ョ ンを表示し ます。

構文

p4 [g-opts] protects [ -a | -u user | -g group | -h host ] [-m] [ file... ]

解説

ユーザ、 グループまたはフ ァ イル ・ セ ッ ト に対し て適用されるプロ テ ク シ ョ ン ・ テーブルの行

を表示するには、 p4 protects コマン ド を使用し て く だ さい。

オプシ ョ ン を指定し ない場合、 p4 protects は現在のユーザに適用されるプ ロ テ ク シ ョ ン ・

テーブルの行を表示し ます。 file 引数を指定する と、 指定されたフ ァ イルに適用されるプロ

テ ク シ ョ ン ・ テーブルの行のみを表示し ます。

-a オプシ ョ ン を使用する と すべてのユーザに適用される行が表示され、 -u user、 -g group、

または -h host を使用する と特定のユーザ、 グループ、 またはホ ス ト IP ア ド レ スに適用され

る行が表示されます。

-m オプシ ョ ンを使用する と、適用可能な 大ア ク セス ・ レベルについて一語で要約を表示し ま

す。

オプシ ョ ン

使用上の留意点

• 構成可能変数dm.protects.allow.adminが1に設定されている場合、PERFORCEスーパーユー

ザに加え PERFORCE 管理者も、 p4 protects -a、 -g、 -u を使用でき ます。

関連コ マン ド

-a すべてのユーザに適用されるプロ テ ク シ ョ ン行を表示し ます。 こ のオプシ ョ ンに

は super ア ク セスが必要です。

-g group 指定されたグループに適用されるプロ テ ク シ ョ ン行を表示し ます。 こ のオプシ ョ

ンには super ア ク セスが必要です。

-h host 指定されたホ ス ト IP ア ド レ スに適用されるプロ テ ク シ ョ ン行を表示し ます。 こ

のオプシ ョ ンには super ア ク セスが必要です。

-u user 指定されたユーザに適用されるプロ テ ク シ ョ ン行を表示し ます。 こ のオプシ ョ ン

には super ア ク セスが必要です。

-m 適用可能な 大ア ク セス ・ レベルについて一語で要約を表示し ます。 ( 注 : こ こ で

は排他的なマ ッ ピングや指定されたフ ァ イル ・ パスは考慮されません。）

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 list,

-a ,-h,-g,-u オプシ ョ ン には

super

プロ テ ク シ ョ ン ・ テーブルを編集する。 p4 protect

p4 property

p4 property

概要

プロパテ ィ の値を追加、 削除、 または一覧表示し ます。

構文

p4 [g-opts] property -a -n name -v value [-s sequence] [-u user | -g group]p4 [g-opts] property -d -n name [-s sequence] [-u user | -g group]p4 [g-opts] property -l [-A] [-n name [-s sequence] [-u user | -g group]] [-F filter -T taglist -m max]

解説

p4 property コ マン ド を使用する と、 管理者は PERFORCE サービ スに保存さ れてい る プ ロパ

テ ィ 定義を表示および更新する こ と ができ ます。サービ スではプロパテ ィ 定義は使用されませ

んが、 別の PERFORCE アプ リ ケーシ ョ ン （P4V など） のために こ の機能が提供されています。

Perforce サービ スでは メ タデータの保存方法と し て、 カ ウ ン タ / キー、 属性、 プロパテ ィ の 3

つが提供されています。

アプ リ ケーシ ョ ンが単純なキーと値のペアによ る簡易的な保存形式しか必要 とせず、セキ ュ リ

テ ィ ・ モデルを実装し ない場合は、 p4 counters コマン ド と p4 keys コマン ド を使用し て く

ださい。

ア プ リ ケ ー シ ョ ン の メ タ デー タ が 特定 の フ ァ イ ル に 関連付 け ら れ て い る 場合 は、 p4

attribute を使用し ます。

アプ リ ケーシ ョ ンの メ タデータがフ ァ イルに関連付け られていない場合に、その可視性をユー

ザやグループによ って制限する こ とや、シーケン ス番号によ って複数の値の優先順位を制御す

る こ と が要求されている場合は、 p4 property を使用し ます。 （注 : 排他マ ッ ピングまたは指

定されたフ ァ イル ・ パスは考慮されません。）

オプシ ョ ン

-a ... プ ロ パテ ィ の値を更新す る か、 存在 し ない場合はプ ロ パテ ィ の値を追加 し ます。

admin 権限が必要です。

-d ... プロパテ ィ の値を削除し ます。 admin 権限が必要です。

-l ... 1 つ以上のプロパテ ィ の値を一覧表示し ます。 -n name 引数を指定する と パフ ォー

マン スが大幅に改善し ます。

-n name プロパテ ィ の名前を指定し ます。

-v value プロパテ ィ の値を指定し ます。

-s sequence プロパテ ィ のシーケン ス番号を指定し ます。 未指定の場合のデフ ォル ト 値は 1 です。

-u user こ のプロパテ ィ が適用されるユーザを指定し ます。

-g group こ のプロパテ ィ が適用されるユーザ ・ グループを指定し ます。

-m max 出力対象を max 件までの一致プロパテ ィ に制限し ます。

-T taglist 表示される フ ィ ール ド を、taglist に示されたフ ィ ール ド に制限し ます。p4 fstat の構文を使用し ます。

-F filter filter のパターンに一致するプロパテ ィ のみを表示し ます。 p4 fstat の構文を

使用し ます。

-A すべてのユーザおよびグループのプロパテ ィ を一覧表示し ます。 admin 権限が必要

です。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 183

p4 property

使用上の留意点

• PERFORCE 管理者は p4 property を使用し て P4V のパフ ォーマン ス設定を集中管理し、 機

能の有効 / 無効を選択的に切 り 替え る こ と ができ ます。

詳し く は、 『システム管理者ガイ ド』 を参照し て く だ さい。

フ ァ イル引数に リ ビジ ョ ン

指定子を使えるか ?

フ ァ イル引数に リ ビジ ョ ン

範囲を使えるか ?

最低限必要なアクセス ・

レベル

使用不可 使用不可 list, admin

184 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 proxy

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 185

p4 proxy

概要

プロ キシの接続情報を表示し ます。

構文

p4 [g-opts] proxy

解説

PERFORCE プロ キシ経由で接続し ている場合、p4 proxy コマン ド はプロ キシ接続に関する情報

を表示し ます。

オプシ ョ ン

使用上の留意点

• こ のコマン ド は、 ユーザが PERFORCE プロ キシに接続し ている場合にのみ機能し ます。

関連コ マン ド

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 な し

PERFORCE サーバへの接続情報を表示する。 p4 info

p4 pull

p4 pull

概要

サーバ ・ メ タデータ またはバージ ョ ン化フ ァ イルを、 あ る PERFORCE サーバから別の PERFORCE

サーバへと 複製し ます。

構文

p4 [g-opts] pull [-J prefix][-i n][-b n][-T tableexcludelist][-P filterpattern]p4 [g-opts] pull -u [ -i n ]p4 [g-opts] pull -l [ -s | -j [ -J prefix ]]p4 [g-opts] pull -d -f file -r revision

解説

p4 pull コマン ド は、P4TARGET によ り 指定された ターゲ ッ ト ・サーバから ジ ャーナル・ レ コー

ド またはフ ァ イル内容のどち らかを取得する よ う 、 現在のサーバ ( レプ リ カ ・ サーバでな く て

はな ら ない ) に指示し ます。

レプ リ カ ・ サーバは同じマス ター ・ サーバに対し て複数の p4 pull コマン ド を実行する こ と

ができ ます。 メ タデータ と フ ァ イル内容の両方を複製するには、 2 つの p4 pull コマン ド を同

時に実行する必要があ り ます。 こ の場合、 p4 pull を （-u オプシ ョ ンを付けずに） 1 回実行し

てマス ター ・ サーバの メ タデータ を複製し、 さ らに p4 pull を （-u オプシ ョ ンを付けて） 1 回

以上実行し てサーバのバージ ョ ン化フ ァ イルを複製し ます。

-iオプシ ョ ンは次の更新までのポー リ ング間隔(単位は秒) を指定し ます。-iが指定されない場

合、 p4 pull はポー リ ング間隔を 1 と し て実行し た後に終了し ます。

-b オプシ ョ ンは、 pull 実行の失敗後に待機する時間を指定し ます。 -b が指定されていない場

合、 p4 pull は 60 秒ご と に再試行されます。

ジ ャーナル ・ レ コード の代わ り にフ ァ イル内容を取得するには、 -u オプシ ョ ンを使用し ます。

待ち状態のフ ァ イル内容転送の リ ス ト を表示するには、 -l オプシ ョ ンを使用し ます。 -l と と

もに -s が指定される と、 待ち状態のフ ァ イル転送の概要が表示されます。

File transfers: n active/m total, bytes: nnn active/mmmmm total.

-l と と もに -j が指定される と、 現在のレプ リ カ と そのマス ターに関する現在のジ ャーナルの

状態、 ステー ト ・ フ ァ イルの 終更新時刻、 およびサーバのローカル時刻と タ イ ムゾーンが報

告されます。 例を示し ます。

Current replica journal state is: Journal jjj, Sequence: sssss.Current master journal state is: Journal jjj, Sequence: sssss.The statefile was last modified at: 2012/01/10 14:23:23.The Server time is currently: 2012/01/10 14:23:23 -0800 PST

お使いのマス ター ・ サーバにおいてデフ ォル ト 以外のジ ャーナルの場所を使用し ている場合

は、 -J prefix オプシ ョ ン または journalPrefix 構成可能変数を使用し て、 マス ター ・ サー

バ上のジ ャーナル ・ フ ァ イルの場所を指定し ます。

待ち状態のフ ァ イル転送処理を削除するには、 p4 pull -d -f file -r rev を使用し ます。

こ のコマン ド は、マス ターに回復不可能なエラーがあ る ために待ち状態のフ ァ イル転送が繰 り

返し失敗する場合に有効です。

マ ス ター ・ サーバま たはレプ リ カ ・ サーバのど ち ら かを停止する と、 レプ リ カ ・ サーバはステー ト ･フ ァ イル と い う 小さ いテキ ス ト ・ フ ァ イルの中に 新のジ ャーナルの位置を記録し ます。 デフ ォル ト では、 ステー ト ・ フ ァ イルは state と い う 名前でレプ リ カ･サーバの root デ ィ

186 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 pull

レ ク ト リ に格納されます。p4 configure によ って構成可能変数 statefile を設定する こ と によ り 、 別のフ ァ イル名を指定でき ます。

オプシ ョ ン

使用上の注意点

• ほ と んどの場合、 サーバの複製には p4 replicate よ り も p4 pull の方が適切です。

-u ジャーナル ・ レ コード の代わ り にアーカ イブ ・ フ ァ イルを転送し ます。

-l 待ち状態のフ ァ イル内容転送の リ ス ト を表示し ます。

-l -s 待ち状態のフ ァ イル内容転送の概要を表示し ます。

-l -j レプ リ カ と マス ターにおける現在のジャーナルの状態を表示し ます。

-d -f file -r rev

待ち状態のフ ァ イル内容転送を中止し ます。 ただし、 file と rev は p4 pull-l コマン ド によ って取得されたデ ィ ポ・フ ァ イルおよび特定 リ ビジ ョ ンを示し ま

す。

-i interval フ ァ イル内容を取得するポー リ ング間隔を指定し ます。

-b interval 取得失敗後の再試行について、 ポー リ ング間隔を指定し ます。

-J prefix ジ ャーナル ・ フ ァ イルの接頭語を指定し ます。 journalPrefix 構成可能変数がオーバーラ イ ド されます。

-T tableexcludelist

レ プ リ カのジ ャ ーナル･レ コ ー ド か ら 除外す る デー タ ベー ス ・ テーブル （例 :

db.have および db.client） の リ ス ト を提供し ます。

複数のテーブルを指定するには、リ ス ト を二重引用符で囲み、テーブル名を スペー

スで区切 り ます。 テーブル名は、 サーバ ・ ルー ト ・ デ ィ レ ク ト リ のデータベース ・

フ ァ イルに使用される命名規則に従って "db." で始ま る必要があ り ます。 テーブ

ル名を カ ン マで区切 る こ と も 可能です。 例 : -T db.have,db.client or -T"db.have db.client"

-P filterpattern

指定 さ れた フ ィ ル タ のパ ターン (filterpattern) に一致する レ コー ド のみを

ポー リ ング し ます。 複数の -P オプシ ョ ンによ り 複数のフ ィ ルタ ・ パターンを指

定で き ま す。 こ の フ ィ ル タ の実装 メ カ ニ ズ ム は、 p4 server フ ォ ー ム の

ClientDataFilter: フ ィ ール ド および RevisionDataFilter: フ ィ ール ド

によ って使用される もの と同様です。

注 : p4 server フ ォームにあ る フ ィ ール ド の使用が強 く 推奨されます。整合性が

ない状態で複数の p4 pull コマン ド を -P filterpattern 引数 と と もに使用し

た場合、 レプ リ カは未定義の動作を引き起こ し ます。

各 filterpattern は 2 つの文字と 1 つのコ ロ ンから始め、ク ラ イ アン ト ・フ ィ

ルタ またはデ ィ ポ ・ フ ィ ルタ を指定し て、 パターンを含めるか除外するかを以下

の構文によ り 指定し ます。

･ -Pic://client/pattern - 含める ク ラ イ アン ト ・ レ コード

･ -Pxc://client/pattern - 除外する ク ラ イ アン ト ・ レ コード

･ -Pif://depot/pattern - 含めるデ ィ ポ ・ レ コード

･ -Pxf://depot/pattern - 除外するデ ィ ポ ・ レ コード

最初の文字ではレ コード を含めるか除外するか ( 「i」 または 「x」 ), を指定し、 2

番目の文字ではレ コー ド が ク ラ イ アン ト ・ ワーク スペース関連であ るかデ ィ ポ ・

フ ァ イル関連であ るか ( 「c」 または 「f」 ) を指定し ます。 コ ロ ンは区切 り 文字で、

残 り の filterpattern は ク ラ イ アン ト ・ ワー ク スペース ・ ビ ューま たはデ ィ

ポ ・ フ ァ イル ・ パス を示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

ファイル変数はリビジ ョ ン指定

子を使用できるか

ファイル変数はリビジ ョ ン範囲

を使用できるか

要求される最低アクセス ・ レベル

適用外 適用外 super

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 187

p4 pull

• テス ト 目的以外で p4 pull がコマン ド ラ イ ンから実行される こ と はほ と んどあ り ません。代

わ り に p4 configure コマン ド を使用し て、 レプ リ カ ・サーバが起動する たびに p4 pull プ

ロセス を起動する よ う にサーバを構成し て く だ さい。

• マス ターにおける ジ ャーナル・ ローテーシ ョ ンの処理中、p4 pull -l -j の出力には 3 行が

書き出される可能性があ り ます。 それらは、 レプ リ カ ・ ジ ャーナルの現在の状態を表す行、

対応するマス ター上のジ ャーナルの状態を表す行、そし てマス ター上の新しいジ ャーナルを

表す行 （こ こ からのデータはレプ リ カにはまだ到達し ていない） です。

• 複製環境で動作させる ための PERFORCE の構成に関し て詳し く は、 『システム管理者ガ イ ド』

をご覧 く だ さい。

関連コ マン ド

起動時に一連の p4 pull コマン ド を実行する よ う に PERFORCE サーバを構成

する

p4 configure

あ るサーバから別のサーバへと メ タデータ を複製する p4 replicate

ジ ャーナルまたはチェ ッ ク ポ イ ン ト のレ コー ド を未加工のフ ォームに表示す

る

p4 export

188 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 reconcile

p4 reconcile

概要

フ ァ イルを追加、 削除、 および / または編集目的で作業状態にし、 PERFORCE 外部での変更内

容と ワーク スペース と を一致させます。

構文

p4 [g-opts] reconcile [-c changelist] [-e -a -d -f -I -l -n] [file ...]

解説

p4 reconcile コマン ド は、 ユーザのワーク スペース内にあ る作業状態でないフ ァ イルを検索

し、 ワーク スペース とデ ィ ポ と の間で以下の 3 種類の不整合を検出し ます。

1. デ ィ ポ内に存在し、 ユーザの have リ ス ト に存在するが、 ワーク スペースには存在し ない

フ ァ イル。 デフ ォル ト では、 これらのフ ァ イルは削除目的で作業状態に されます。

2. ワーク スペースに存在するが、 デ ィ ポには存在し ないフ ァ イル。 デフ ォル ト では、 これら

のフ ァ イルは追加目的で作業状態に されます。

3. ワーク スペース内では変更されているが、 編集目的で作業状態に されていないフ ァ イル。

デフ ォル ト では、 これらのフ ァ イルは編集目的で作業状態に されます。

p4 reconcile の処理範囲を追加、 編集、 または削除に限定するには、 それぞれ -a、 -e、 -d オ

プシ ョ ンを使用し ます。

ワーク スペースに一致するかど う かを検査する一連の操作をプレ ビ ューするには、-nオプシ ョ

ンを使用し ます。

デフ ォル ト では、 p4 reconcile は P4IGNORE フ ァ イルに記述されたフ ァ イルおよび / または

パス をチェ ッ ク し ません。 この動作をオーバーラ イ ド し、 P4IGNORE フ ァ イルを無視するには、

-I オプシ ョ ンを使用し ます。

オプシ ョ ン

-c changelist 指定された作業中チェ ンジ リ ス ト 内でフ ァ イルを作業状態にし ます。

-e フ ァ イルの編集 ： PERFORCE 外部で変更されたフ ァ イルを ワーク スペース内で検索

し、 それら を編集目的で作業状態にし ます。

-a フ ァ イルの追加： PERFORCE の制御下にないフ ァ イルを ワーク スペース内で検索し、

それら を追加目的で作業状態にし ます。

-d フ ァ イルの削除 ： ワーク スペースには存在し ないがデ ィ ポに存在する フ ァ イルを

検索し、 これらのフ ァ イルがユーザの have リ ス ト にあ る場合に限 り 、 それら を削

除目的で作業状態にし ます。

-n 処理を行わずに、 操作の結果をプレ ビ ューし ます。

-f 特殊文字 （ワ イル ド カー ド） を含むフ ァ イル名を追加し ます。 特殊文字の @、 #、

%、 * を含むフ ァ イルは、 それらの文字を 16 進表記によ り エン コード し て再フ ォー

マ ッ ト されます。

これら のフ ァ イルが追加さ れた後は、 フ ァ イルを示す際に再フ ォーマ ッ ト された

フ ァ イル名を使用する必要があ り ます。

-I 無視するかど う かのチェ ッ ク を行いません。 P4IGNORE によ って指定されたすべ

ての設定を無視し ます。

-l 相対パスによ る ローカル ・ フ ァ イル ・ シン タ ッ ク スで出力を表示し ます。 こ れは

ワーク スペースの観点で実行する p4 status と同様です。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 189

p4 reconcile

使用上の留意点

• p4 reconcile コマン ド は出力をデ ィ ポ ・ シン タ ッ ク スで生成し ます。 フ ァ イル名およびパ

ス を ローカル ・ シン タ ッ ク スで見るには、 p4 reconcile に -l オプシ ョ ンを使用するか、 p4

status コマン ド を使用する必要があ り ます。

• 引数を付けずに実行する と、 p4 reconcile はフ ァ イルをチェ ンジ リ ス ト 内で作業状態にし

ます。 操作のプレ ビ ューを行 う には、 p4 reconcile に -n オプシ ョ ン を使用する か、 p4

status コマン ド を使用し て く だ さい。

関連コ マン ド

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 open

p4 reconcile -n のシ ョ ー ト カ ッ ト p4 status

p4 reconcile -ead のシ ョ ー ト カ ッ ト p4 status -A

190 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 rename

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 191

p4 rename

概要

PERFORCE にあ る フ ァ イルの名前を変更し ます。

構文

p4 [g-opts] rename [-c change][-f][-k][-n][-t filetype] fromFile toFile

解説

p4 rename コマン ド は p4 move コマン ド と同様に機能し ます。

fromFile と toFile の名前に適合する ワ イル ド カード を使 う と、複数フ ァ イルの名前を変更す

る こ と ができ ます。

使用上の留意点

• フ ァ イルを移動する前に、 編集目的で作業状態にする必要があ り ます。

• リ リ ース 2009.1 よ り 前は、p4 integrateを使用し てfromFileを新しいtoFileにコ ピー

し、 p4 delete を使用し て fromFile を削除し、 次に p4 submit を使用し て これらの

フ ァ イル変更をデ ィ ポに格納する こ と によ り 、 フ ァ イルの移動が完了し ていま し た。

使用例

関連コ マン ド

フ ァ イル変数はリ ビジ ョ ン指定

子を使用できるか

フ ァ イル変数はリ ビジ ョ ン範囲

を使用できるか

要求される最低アクセス ・ レベル

fromFile: 使用可

toFile: 使用不可

使用不可 fromFile には read ア ク セス

toFile には write ア ク セス

p4 edit //depot/d1/...

p4 move //depot/d1/... //depot/d2/...

d1 から d2 にフ ァ イルを移動し ます。

p4 integ //depot/d1/... //depot/d2/...

p4 delete //depot/d1/...

p4 submit

2009.1 よ り 前のバージ ョ ンでフ ァ イル ・ セ ッ ト

を移動し ます。

･ p4 integrate によ り 、 d1 デ ィ レ ク ト リ の

全フ ァ イルをd2デ ィ レ ク ト リ にコ ピーし ます

･ p4 deleteによ り 、d1デ ィ レ ク ト リ の全フ ァ

イルを削除し ます。

･ p4 submit によ り 、 これらの変更が 1 つの

チェ ンジ リ ス ト でデ ィ ポに送られます。

フ ァ イルを移動する p4 move

フ ァ イルを コ ピーし、 それを PERFORCE の管理下に置き続ける。 p4 integrate

デ ィ ポから フ ァ イルを削除する。 p4 delete

チェ ンジをデ ィ ポにサブ ミ ッ ト する。 p4 submit

p4 reload

192 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 reload

概要

指定された ワーク スペース、 ラベル、 またはタ ス ク･ス ト リ ーム を、 アン ロー ド ・ デ ィ ポか ら

リ ロード し ます。

構文

p4 [g-opts] reload [-f] [-c workspace | -l label | -s stream]

解説

p4 reload コマン ド は、 アン ロード されたワーク スペース （またはアン ロード された ラベルに

よ っ て タ グ付け さ れた フ ァ イ ル、 ま たはア ン ロー ド さ れた タ ス ク･ス ト リ ームに格納 さ れた

フ ァ イ ル） の状態を、 ア ン ロ ー ド ・ デ ィ ポか ら バージ ョ ン化サービ ス の db.have （ま たは

db.label） テーブルへ と リ ロード し ます。

アン ロード されたワーク スペース を リ ロードするには -c workspace を使用し、 アン ロード さ

れた ラベルを リ ロード するには -l label を使用し ます。 PERFORCE 管理者は -f オプシ ョ ンを

使用し て、 他のユーザが所有する ワーク スペースおよび / またはラベルを リ ロー ド でき ます。

オプシ ョ ン

使用上の留意点

• ワーク スペース またはラベルの リ ロード を行 う には、ユーザがワーク スペースのhave リ ス ト

にあ るすべてのフ ァ イルおよび / またはラベルによ って タ グ付け されている フ ァ イルを ス

キ ャ ンする こ と が可能でなければな り ません。 管理者は （ p4 group フ ォームにおいて）

MaxScanRowsおよびMaxResults を十分な大き さの値に設定し て、ユーザが p4 unload また

は p4 reload の操作にサポー ト を要求せずに済むよ う にするべきです。

関連コ マン ド

-c workspace 指定された ク ラ イ アン ト ・ ワーク スペース を、 アン ロード ・ デ ィ ポから リ ロー

ド し ます。

-l label 指定された ラベルを、 アン ロード ・ デ ィ ポから リ ロード し ます。

-s stream 指定 さ れた タ ス ク･ス ト リ ームを、 アン ロード ・ デ ィ ポから リ ロード し ます。

-f 管理者強制オプシ ョ ン。 他のユーザが所有する ラベルおよびワーク スペース

の リ ロード を可能にし ます。 admin 権限が必要です。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 write

ク ラ イ アン ト ･ワーク スペース またはラベルをアン ロードする。 p4 unload

p4 reopen

p4 reopen

概要

作業状態のフ ァ イルをチェ ンジ リ ス ト 間で移動するか、 フ ァ イルタ イプを変更し ます。

構文

p4 [g-opts] reopen [-c changelist] [-t filetype] file...

解説

p4 reopen には、 内容は異な り ますが関連する 2 つの用途があ り ます。

• p4 reopen -c changelist file を使用し て、作業状態のフ ァ イルを現在の作業中チェ ンジ

リ ス ト から別の作業中チェ ンジ リ ス ト changelist に移動し ます。

• p4 reopen -c defaultを使用し て、フ ァ イルをデフ ォル ト のチェ ンジ リ ス ト に移動し ます。

• p4 reopen -t filetype を使用し て、 フ ァ イルのタ イプを変更し ます。

フ ァ イル ・ パターンが指定されている場合、 そのパターンに適合するすべての作業中フ ァ イル

は、 移動させられるかタ イプを再設定されます。 フ ァ イル移動 と タ イプ変更を 1 回の操作で行

う には、 2 つのオプシ ョ ンを組み合わせます。

オプシ ョ ン

使用上の注意点

使用例

-c changelist file フ ァ イル ・ パターン file に適合するすべての作業中フ ァ イルを、 作業

中チェ ンジ リ ス ト changelist に移動し ます。 デフ ォル ト ・ チェ ンジ リ

ス ト にフ ァ イルを移動するには、チェ ンジ リ ス ト 番号 と し て default を

使用し ます。

-t filetype file サブ ミ ッ ト された と きに、 フ ァ イルを指定し た タ イプ （filetype） で格

納し ます。 再度タ イ プが変更されない限 り 、 以降のすべての リ ビジ ョ ン

はこのフ ァ イルタ イプ と な り ます。

フ ァ イルタ イプの一覧については、 「フ ァ イルタ イプ」 のセ ク シ ョ ンをご

覧 く ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル変数はリ ビジ ョ ン指定

子を使用できるか

フ ァ イル変数はリ ビジ ョ ン範囲

を使用できるか

要求される最低アクセス ・ レベル

使用不可 使用不可 open

p4 reopen -t text+k //... すべての作業中フ ァ イルを、 キーワー ド 拡

張を使用でき る、 テキ ス ト ・ フ ァ イル と し

て再度作業状態にし ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 193

p4 reopen

関連コ マン ド

p4 reopen -c 410 //depot/proj1/... //.../README

//depot/proj1 デ ィ レ ク ト リ にあ るすべ

ての作業中フ ァ イル、 および 「README」 と

名前を付け られたすべての作業中フ ァ イル

を作業中チェ ンジ リ ス ト 410 に移動し ま

す。

p4 reopen -c default -t binary+S //....exe すべての作業中 .exe フ ァ イルを、 デフ ォ

ル ト のチェ ンジ リ ス ト に移動し ます。 その

際、 デ ィ ポ内の対応する フ ァ イルの古い リ

ビジ ョ ンを上書き し ます。

チェ ンジ リ ス ト をデ ィ ポにサブ ミ ッ ト する。 p4 submit

新しいチェ ンジ リ ス ト を作成する。 p4 change

すべての作業中チェ ンジ リ ス ト から、 フ ァ イルを除去する。 p4 revert

作業中フ ァ イルを一覧表示する。 p4 opened

あ るチェ ンジ リ ス ト に含まれるすべてのフ ァ イルを一覧表

示する。

p4 opened -c changelist

すべての作業中チェ ンジ リ ス ト を一覧表示する。 p4 changes -s pending

編集を目的 と し て、 あ るチェ ンジ リ ス ト 内のフ ァ イルを任

意のタ イプで作業状態にし ます

p4 edit -c changelist -t type

追加を目的 と し て、 あ るチェ ンジ リ ス ト 内のフ ァ イルを任

意のタ イプで作業状態にし ます。

p4 add -c changelist -t type

デ ィ ポ内のすべてのフ ァ イルに対し、 悲観的ロ ッ ク （排他

オープン） を実施し ます。 こ のチェ ンジ リ ス ト のサブ ミ ッ

ト 後は、depotname と い う デ ィ ポにあ る フ ァ イルを編集で

き るのは一度に 1 ユーザのみと な り ます。

p4 edit -t +l //depotname/...

194 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 replicate

p4 replicate

概要

あ る PERFORCE サーバにおける ジ ャーナルの変更をポー リ ング し、 別の PERFORCE サーバに伝

達でき る よ う にし ます。

構文

p4 replicate [-j token] [-s statefile] [-i interval] [-k -x -R] [-J prefix] [-T tables] [-o output] [command]

解説

こ のコマン ド は新しいジ ャーナル ・ エン ト リ を PERFORCE サーバにポー リ ング し、 それら を標

準出力に出力するか、 コマン ド が command で指定されている場合にはジ ャーナル ・ レ コード

を command にパイプし、 そ こ からサブプロセス を生成させます。

オプシ ョ ン

使用上の注意点

• メ タデータ ( アーカ イブ・フ ァ イルは含まない ) を複製する必要があ る場合、または メ タデー

タ をフ ィ ルタ リ ングする必要があ る場合に、 p4 replicate を使用し て く だ さい。 ほ と んど

の状況において、 p4 pull によ る複製の方が p4 replicate よ り も適切です。

-j token メ タ デ ー タ の 複 製 を 開 始 す る ジ ャ ー ナ ル 番 号 ま た は 位 置 ト ー ク ン を

journalnum/byteoffset の形式で指定し ます。 このオプシ ョ ンが指定されて

いる と、 ステー ト ・ フ ァ イルによ る指定はすべてオーバーラ イ ド されます。

-s statefile 新のジャーナル位置を記録する ステー ト ・ フ ァ イルを指定し ます。statefile構成可能変数を使用し てステー ト ・ フ ァ イルを指定する こ と もでき ます。

-i interval ポー リ ング間隔を秒数で指定し ます。 デフ ォル ト は 2 秒です。 ポー リ ングを無効

にする （つま り 更新されたジャーナル ・ エン ト リ を 1 回だけチェ ッ ク し て終了す

る） には、 interval に 0 を指定し ます。

-J prefix ジ ャーナルのフ ァ イル名に付ける接頭語を、 p4d -jc prefix と同様に指定し

ます。

-T tables エク スポー ト 対象から除外するデータベース ・ テーブル (db.have など ) の リ ス

ト を提供し ます。

-k 次回のポー リ ングまでの間、command サブプロセスへのパイプを開いたま まにし

ます。

-x ジャーナル ・ ローテーシ ョ ンが検出された と き、p4 replicate コマン ド を終了

し ます。

-R -Rオプシ ョ ンを付ける と、p4 replicateは接続が失われた場合または重大なエ

ラ ーが発生 し た場合にサーバへの再接続 を 試み ま す。 ポー リ ン グ間隔 を -iinterval によ り 指定する必要があ り ます。

-o savefile 出力する フ ァ イルを指定し ます。 command サブプロセスが指定されている場合、

サブプロセスおよび指定された savefile の両方が出力に提供されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル変数はリ ビジ ョ ン指定

子を使用できるか

フ ァ イル変数はリ ビジ ョ ン範囲

を使用できるか

要求される最低アクセス ・ レベル

適用外 適用外 super

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 195

p4 replicate

• さ らに詳し く は、 『システム管理者ガ イ ド』 および以下のサイ ト にあ るナレ ッ ジベースの記

事をご覧 く だ さい。

http://kb.perforce.com/article/1099

関連コ マン ド

フ ァ イル ・ コ ンテンツおよびジ ャーナル ・ レ コード を更新する。 p4 pull

ジ ャーナル ・ レ コー ド またはチェ ッ ク ポ イ ン ト ・ レ コー ド を未加工のフ ォー

ムに表示する。

p4 export

196 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 resolve

p4 resolve

概要

フ ァ イル ・ リ ビジ ョ ン間の衝突を解決し ます。

構文

p4 [g-opts] resolve [-Aflags -dflags -aflags -f -n -N -o -t -v -cchange] [file...]

解説

p4 resolve は、 2 つのフ ァ イルまたはフ ァ イル ・ リ ビジ ョ ンの内容を、 ワーク スペース内の 1

つのフ ァ イ ル ・ リ ビ ジ ョ ンに ま と め る のに使用し ます。 フ ァ イ ルをサブ ミ ッ ト する前に p4

resolve を使用し なければな ら ない状況は、 以下の 2 つです。

• 単純な衝突が存在し ている と き。 すなわち、 ク ラ イ アン ト ・ ワーク スペースに対し て 後に

同期させたフ ァ イルの リ ビジ ョ ンが、 サブ ミ ッ ト 時の 新 リ ビジ ョ ンではない と きです。

例えば、 ア リ スが p4 sync を行い、その後にフ ァ イル file.c の p4 edit を実行し ます。ボ

ブも同じ こ と を し ます。ア リ スが p4 submit で file.c をサブ ミ ッ ト し、次にボブが file.c

をサブ ミ ッ ト し よ う と し て も失敗し ます。 と い う のは、 ボブの file.c がデ ィ ポに受け入れ

られる と ア リ スが file.c に加えた変更が もはや参照でき な く なって し ま う ためです。

• p4 integrate を使用し て、1 つのフ ァ イル （またはブラ ンチ） から他のフ ァ イルへの変更の

反映を スケジュールし ている と き。

こ の 2 つの状況の主な違いは、単純なフ ァ イル衝突を解決するには 1 つのフ ァ イルの複数 リ ビ

ジ ョ ンを必要 と し ますが、 変更の反映のために衝突を解決するには、 異な る 2 つのフ ァ イルを

組み合わせる必要があ る と い う こ と です。 いずれの場合も下記のよ う にな り ます。

• フ ァ イル ・ タ イプが text であ る場合、p4 resolve を使用する と、デ ィ ポ内のフ ァ イルの代

わ り に ク ラ イ アン ト ・ ワーク スペース内のフ ァ イルを使用するか、 ク ラ イ アン ト ・ ワーク ス

ペース内のフ ァ イルをデ ィ ポ内のフ ァ イルで上書きするか、またはデ ィ ポの リ ビジ ョ ン と ク

ラ イ アン ト ・ ワーク スペースの リ ビジ ョ ン両方からの変更を 1 つのフ ァ イルにマージする こ

と ができ ます。

• フ ァ イル ・ タ イプが binary であ る場合、 通常は 初の 2 つの選択肢 （ワーク スペース内の

フ ァ イルを使用するか、 ワーク スペース内のフ ァ イルをデ ィ ポ内のフ ァ イルで上書きする）

しか利用でき ません。 と い う のは、 一般的にマージはバイナ リ ・ フ ァ イルに対し て機能し な

いからです。

p4 resolve の出力は主と し て、 本質的に診断内容を表し ます。 フ ァ イルは別のフ ァ イルに対

し て ("vs") 衝突解決されるか、 他のフ ァ イルにコ ピー、 マージ、 編集、 ブラ ンチ、 追加、 削除、

移動または無視されます。 p4 resolve で実行される実際の作業には、 それがワーク スペース

内のフ ァ イルに対し て行った変更が反映されます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 197

p4 resolve

衝突の検出に使用される リ ビジ ョ ン

p4 resolve ダ イ ア ロ グは 4 つのフ ァ イル・ リ ビジ ョ ンを参照し ますが、単純に解決でき る フ ァ

イル衝突を修正するのか、 変更の反映のために使 う のかによ って、 リ ビジ ョ ンの意味が次のよ

う に変わ り ます。

解決オプシ ョ ン と その詳細

対話式の p4 resolve ダ イ ア ロ グでは以下のオプシ ョ ンが表示されます。 ダ イ ア ロ グ ・ オプ

シ ョ ンはコマン ド ラ イ ン ・ フ ラ グ と同じではないこ と に注意し て く だ さい。

用語 単純に衝突を解決する場合 反映のために衝突を解決する場合

yours ク ラ イ ア ン ト ・ ワ ー ク ス ペー ス 内の

フ ァ イルの リ ビジ ョ ン

変更が伝達 さ れ よ う と し てい る先のフ ァ イ ル。

（反映の用語では、 これを反映先フ ァ イル と言い

ます。） 変更はク ラ イ アン ト ・ ワーク スペース内

の こ の フ ァ イ ルのバージ ョ ン に対 し て加え ら

れ、 こ のフ ァ イルは後でデ ィ ポにサブ ミ ッ ト さ

れます。

theirs デ ィ ポ内の フ ァ イ ルの 新 リ ビ ジ ョ

ン。

変更が伝達される元であ る、 デ ィ ポ内のフ ァ イ

ル ・ リ ビジ ョ ン。 （反映の用語では、 これを反映

元フ ァ イル と言います。） こ のフ ァ イルは、 デ ィ

ポやク ラ イ アン ト ・ ワーク スペースでは変更さ

れません。

base 編集目的で作業状態にな る前に ク ラ イ

アン ト ・ ワーク スペースに対し て同期

し たフ ァ イル ・ リ ビジ ョ ン。

theirs の過去の反映済 リ ビジ ョ ン。 yours と

theirs の 新の共通の祖先。

merge yours、 theirs、 お よ び base か ら

PERFORCE が生成 し た フ ァ イ ル ・ リ ビ

ジ ョ ン。 フ ァ イルがテキ ス ト ・ フ ァ イ

ルであ る場合、 解決プ ロ セス中に こ の

リ ビジ ョ ンを編集でき ます。

左の意味と同じです。

ダイアロ

グオプ

シ ョ ン

簡潔な意

味

内容 デフ ォル ト でバイナ

リ ・ フ ァ イルに利用

できるか

e edit merged

PERFORCE が生成し たマージ済フ ァ イルを編集し ます。 利用できない

ey edit yours

現在ワーク スペース内にあ る フ ァ イルの リ ビジ ョ ン を編

集し ます。

利用でき る

et edit theirs

ワーク スペースの リ ビジ ョ ン と 衝突し ているデ ィ ポ内の

リ ビジ ョ ン （通常、 新 リ ビジ ョ ン） を編集し ます。 こ

の編集は読み取 り 専用です。

利用でき る

dy diff yours

yours と base 間の差分を表示し ます。 利用できない

dt diff theirs

theirs と base 間の差分を表示し ます。 利用できない

dm diff merge

merge と base 間の差分を表示し ます。 利用できない

d diff merge と yours 間の差分を表示し ます。 利用でき る

198 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 resolve

フ ァ イルの衝突解決は、 accept ダ イ ア ロ グ ・ オプシ ョ ンのいずれかが選択された と き、 また

は skip オプシ ョ ンを選択し てフ ァ イルを ス キ ッ プし た と きに完了し ます。

p4 resolve によ り 、フ ァ イル・ リ ビジ ョ ンに対し て加え られた 4 種類の変更のカ ウ ン ト が表示

される ため、 どのオプシ ョ ンを選択するかを決めるのに役立ちます。

Diff Chunks: 2 yours + 3 theirs + 5 both + 7 conflicting

これらの値の意味は次の とお り です。

m merge 次のコマン ド を起動し ます。

P4MERGE base theirs yours merge

このオプシ ョ ンを使用するには、 初の 3 つのフ ァ イル

をマージ し、 その結果を 4 番目に書き込むサード ・ パー

テ ィ 製のプロ グ ラ ムの名前に、環境変数 P4MERGE を設定

する必要があ り ます。P4MERGEが設定されていない場合、

このコマン ド は無効です。

利用できない

? help p4 resolve のヘルプを表示し ます 利用でき る

s skip すぐに解決を実行し ません。 利用でき る

ay accept yours

theirs で加え ら れた可能性の あ る 変更 を 無視 し て、

yours を受け入れます。

利用でき る

at accept theirs

theirs を解決済の リ ビジ ョ ン と し て ク ラ イ アン ト ・ワー

ク スペースに受け入れます。ク ラ イ アン ト ・ ワーク スペー

スにあった リ ビジ ョ ン （yours） は、 上書き されます。

単純な衝突を解決し ている場合、 こ のオプシ ョ ンは、 ク

ラ イ ア ン ト ・ ワ ー ク ス ペー ス の フ ァ イ ルに対 し て p4revert を実行するの と同じです。反映のために衝突を解

決し ている場合、 こ のオプシ ョ ンは反映元フ ァ イルを反

映先フ ァ イルにコ ピーし ます。

利用でき る

am accept merge

merged を解決済の リ ビジ ョ ン と し て ク ラ イ アン ト ・ワー

ク スペースに受け入れます。ク ラ イ アン ト ・ ワーク スペー

スにあった リ ビジ ョ ン （yours） は、 上書き されます。

利用できない

ae accept edit

フ ァ イル編集 （P4 resolve ダ イ ア ロ グで “e” を選択し

て） し た場合に、 ク ラ イ アン ト ・ ワーク スペースにその

編集済のバージ ョ ン を採用し ます。 ク ラ イ アン ト の元々

の リ ビジ ョ ン （yours） は上書き されます。

利用できない

a accept PERFORCE が推奨する結果を保持し ます

･ theirsが base と等しい場合、yours を受け入れます

･ yoursが base と等しい場合、theirs を受け入れます

･ yours と theirsがbase と異な り 、yours と theirsの間に衝突がない場合、 merge を受け入れます

･ 上記以外の場合、yours と theirs の間に衝突があ る

ため、 このフ ァ イルを スキ ッ プし ます

利用できない

カウン ト 意味

n yours yours の n 個の非衝突セグ メ ン ト が base と異なっています。

n theirs theirs の n 個の非衝突セグ メ ン ト が base と異なっています。

n both theirs と yours の双方に n 個の等しい非衝突セグ メ ン ト があ り ますが、

base と は異なっています。

n conflicting theirs と yours の n セグ メ ン ト が互いに異な り 、base と も異な り ます。

ダイアロ

グオプ

シ ョ ン

簡潔な意

味

内容 デフ ォル ト でバイナ

リ ・ フ ァ イルに利用

できるか

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 199

p4 resolve

衝突し ているチャ ン ク がない場合、 PERFORCE が生成し たマージ ・ フ ァ イルを受け入れて も ほ

ぼ安全です。 PERFORCE が、 yours と theirs からのすべての変更を base に代入するからです。

衝突 し てい る チ ャ ン ク があ る場合、 merge フ ァ イ ルを編集する必要があ り ます。 こ の場合、

PERFORCE は衝突し ている yours、 theirs、 および base テキス ト を merge フ ァ イルに含めます。

どのバージ ョ ンのチャ ン ク を保持するかは、 任意に選択し て く だ さい。

異な る テキス ト は、 フ ァ イル ・ マーカによ り 明示されています。

保持し たいテキ ス ト を選択し、衝突し ているチャ ン ク とすべての識別マーカを削除し て く だ さ

い。

内容に関係し ない衝突解決

フ ァ イル内容の相違以外に、 関連する フ ァ イル間におけ る別の種類の相違 （フ ァ イルタ イプ、

削除、 ブラ ンチ、 移動および リ ネーム） を解決する こ と も でき ます。 詳し く は、 『P4 ユーザーズ ・ ガ イ ド』 を参照し て く だ さい。 処理を 1 種類の衝突解決に制限するには、 -A オプシ ョ ン

を以下のよ う に使用し ます。

各解決タ イプは別々に処理されます。例えば 1 つのフ ァ イルにフ ァ イルタ イプの衝突と内容の

衝突があ る場合、 個別に処理方法の指定を要求されます。 すべての解決について同じ結果を望

む場合にフ ァ イル単位での入力を要求されないよ う にするには、 -A オプシ ョ ンの後に -at ま

たは -ay を指定し ます。 以下の例は、 異なる衝突解決に対する入力要求の動作を示し ます。

>>>> ORIGINAL VERSION file#n<text>==== THEIR VERSION file#m<text>==== YOUR VERSION file<text><<<<

オプシ ョ ン 解決される内容

-Aa p4 attribute によ って設定された属性を解決する

-Ab 反映元が編集され、 反映先が削除される反映

-Ac フ ァ イル内容の変更と と もに操作内容も解決する

-Ad 反映元が削除され、 反映先が編集される反映

-At フ ァ イルタ イプの変更

-Am リ ネーム と移動

Merging //depot/rel/fileb#1Diff chunks: 1 yours + 0 theirs + 0 both + 0 conflictingAccept(a) Edit(e) Diff(d) Merge (m) Skip(s) Help(?) ay: m///depot/main/filez - resolve skipped.Resolving move to //depot/main/filebFilename resolve:at: //depot/main/filebay: //depot/main/filez

200 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 resolve

オプシ ョ ン

-aflags-am-af-as-at-ay

解決ダ イ ア ロ グを ス キ ッ プし ます。 次のよ う にし て自動的にフ ァ イル衝突を解決し ま

す。

･ -am: 自動モード。 PERFORCE 推奨のフ ァ イル ・ リ ビジ ョ ンを自動的に受け入れます。

theirs が base と等しい場合、yours を受け入れます。yours が base と等しい場合、theirs

を受け入れます。 yours と theirs が base と異な り 、 yours と theirs の間に衝突がない

場合、 merge を受け入れます。 上記以外の場合、 yours と theirs の間に衝突があ る た

め、 こ のフ ァ イルを スキ ッ プし ます。

･ -ay: Yours を受け入れ、 theirs を無視し ます。

･ -at: Theirs を受け入れます。 ク ラ イ アン ト ・ ワーク スペース内のフ ァ イルが上書き

されますので、 こ のオプシ ョ ンは注意し て使用し て く ださい！

･ -as: 安全受け入れ。 yours と theirs の片方が base と異なる場合 （そし て変更が共通

であ る場合）、 その リ ビジ ョ ンを受け入れます。両方が base と異な る場合、 このフ ァ

イルを スキ ッ プし ます。

･ -af: 強制受け入れ。 どんなフ ァ イルであれ merge フ ァ イルを受け入れます。 merge

フ ァ イルに衝突マーカがあ る場合、 マーカはフ ァ イルに残される ため、 フ ァ イルを

編集し てマーカを削除する必要があ り ます。

-Aflags-Aa-Ab-Ac-Ad-At-Am

操作の ( 内容に関係し ない ) 衝突解決。 解決タ イプを、 ブラ ンチ、 削除、 フ ァ イルタ イ

プ変更、 または移動 / リ ネームに制限し ます。

･ -Aa: p4 attribute によ って設定された属性を解決し ます。

･ -Ab: フ ァ イルのブラ ンチ操作、 つま り 反映元が編集され反映先が削除される反映を

解決し ます。

･ -Ac: フ ァ イル内容の変更を衝突解決し ます。

･ -Ad: 反映元が削除され反映先が編集される反映を解決し ます。

･ -At: フ ァ イルタ イプの変更

･ -Am: 移動と リ ネーム

詳し く は、 『P4 ユーザーズ ・ ガイ ド』 および 200 ページの 「内容に関係し ない衝突解

決」 を参照し て く ださい。

-dflag フ ァ イルをマージする際、 空白文字または行末規則に関し て指定された差分を無視し

ま す。 （こ れ ら の オプ シ ョ ン を 指定 し、 かつ差分が空白文字だ け だ っ た場合、 p4resolve はワーク スペースのフ ァ イル内にあ る テキス ト を使用し ます。）

･ -db: 空白文字のみの変更を無視し ます。 （例えば、 タブを 8 個の空白文字に置換し

た場合。）

･ -dw: 空白文字を完全に無視し ます。 （例えば、 タブやその他の空白文字を削除し た

場合。）

･ -dl: 行末規則の相違を無視し ます。

-f すでに衝突解決済みであ るがまだサブ ミ ッ ト されていないフ ァ イルの衝突再解決を可

能にし ます。

-n 衝突解決が必要なフ ァ イルを、 実際に衝突解決を実行せずに一覧表示し ます。

-N ス ケジ ュールされている、 内容に関係し ない衝突解決処理に関する補足情報 と と も に

処理をプレ ビ ューし ます。

-o 衝突解決時に使用されるベース ・ フ ァ イルの名前と リ ビジ ョ ンを出力し ます。

-t バイナ リ （非テキス ト ） フ ァ イルに対し て も、 3 ウ ェ イマージを強制し ます。 これによ

り 、 あ ら ゆる タ イプのフ ァ イル間の差分を検査でき ます。 P4MERGE が、 非テキ ス ト ・

フ ァ イルをマージでき るユーテ ィ リ テ ィ に設定されている場合、 ユーザに非テキス ト ・

フ ァ イルをマージ させます。

-v yours と base 間、 および theirs と base 間のすべての変更を示す衝突マーカを、 フ ァ イ

ルに含めます。 通常、 yours と thires が衝突し ている場合にのみ、 衝突マーカが含まれ

ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 201

p4 resolve

使用上の留意点

• p4 resolve は、すでに衝突解決を ス ケジ ュールされている フ ァ イルにのみ作用し ます。フ ァ

イルの衝突解決を ス ケジ ュールする操作は 3 つあ り ます。

• p4 integrate または p4 merge によ り フ ァ イルの反映を行います。

フ ァ イルの衝突解決を ス ケジ ュールする際、 p4 integrate では も近い共通の祖先が

base と し て選択されます。 p4 merge コマン ド では、 反映元フ ァ イルおよび反映先フ ァ

イルで共通の編集が も多い リ ビジ ョ ンが選択されます。

• 現在の 新 リ ビ ジ ョ ン以外の リ ビ ジ ョ ン と 同期し た作業中フ ァ イ ルをサブ ミ ッ ト し ま

す。 サブ ミ ッ ト は失敗し、 フ ァ イルの衝突解決がス ケジ ュールされます。

• 作業中フ ァ イルに対し てp4 submitを実行する代わ り に、 p4 syncを実行し ます。ク ラ イ

ア ン ト ・ ワー ク スペースには何 も コ ピー さ れず、 代わ り にフ ァ イ ルの衝突解決が ス ケ

ジュールされます。（p4 sync 経由でス ケジ ュールする こ と の利点は、サブ ミ ッ ト が失敗

し ないこ と です。）

p4 resolve をフ ァ イル引数な しで実行する と、 すでに衝突解決がスケジ ュールされている

ク ラ イ アン ト ・ ワーク スペース内のすべてのフ ァ イルに対し て作用し ます。

• textフ ァ イル と unicodeフ ァ イル と の反映処理中に変換エラーが発生する場合、その原因と

し て も考え られるのは、 text フ ァ イル内に非 ASCII 文字が存在する こ と です。 反映の実

行前にフ ァ イルから非ASCII文字を削除するか、 P4CHARSETを utf8に設定し てから再度マー

ジを実行し てみて く だ さい。

関連コ マン ド

-c change 衝突解決処理の範囲を、 特定のチェ ンジ リ ス ト 番号で作業状態に されている フ ァ イル

に限定し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか

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

使用不可 使用不可 open

衝突解決済みであ る がサブ ミ ッ ト さ れていないフ ァ イ ルの一覧を表示す

る。

p4 resolved

2 つの異な る フ ァ イル間の変更の伝達を スケジュールする。 p4 integrate

変更済フ ァ イル ・ セ ッ ト をデ ィ ポにサブ ミ ッ ト する。 p4 submit

ク ラ イ アン ト ・ ワーク スペースにフ ァ イルを コ ピーするか、 作業中フ ァ イ

ルの衝突解決を ス ケジュールする。

p4 sync

202 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 resolved

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 203

p4 resolved

概要

フ ァ イルの衝突を解決済みでまだサブ ミ ッ ト されていないフ ァ イルの一覧を表示し ます。

構文

p4 [g-opts] resolved [-o][file...]

解説

p4 resolved は、 フ ァ イルの衝突については解決済みであ るが、 まだサブ ミ ッ ト されていない

フ ァ イルの一覧を表示し ます。 フ ァ イルは、 次の形式で 1 行に 1 つずつ表示されます。

localFilePath - action from depotFilePath#revisionRange

localFilePath は、ローカル・ホ ス ト 上の解決済フ ァ イルの完全なパス名です。depotFilePath

は、 デ ィ ポの 上階層を基準と し たデ ィ ポ ・ フ ァ イルの相対パスです。revisionRange は反映

された リ ビジ ョ ン範囲で、 action は merge、 branch、 delete のいずれかです。

フ ァ イル ・ パターンを引数に指定し た場合、 そのフ ァ イル ・ パターンに適合し、 フ ァ イルの衝

突を解決済みの、 サブ ミ ッ ト されていないフ ァ イルのみが リ ス ト に入 り ます。

p4 resolved と い う 名前から、 p4 resolve プロセス を経由し たフ ァ イルのみが表示されるか

のよ う ですが、 そ う と は限 り ません。 ブラ ンチ作成や削除を目的 と し て p4 integrate で作業

状態にし たフ ァ イルも、 p4 resolveÇÝ 衝突を解決し たフ ァ イルも、 「衝突が解決された」 とみ

な されます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

-o 衝突解決時に使用されたベース ・ フ ァ イルの名前と リ ビジ ョ ンを出力し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか

フ ァ イル引数にリ ビジ ョ ン範囲

を使えるか

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

適用外 適用外 open

サブ ミ ッ ト された反映の一覧を参照する。 p4 integrated

衝突解決されていない反映の一覧を参照する。 p4 resolve -n

あ る フ ァ イルから別のフ ァ イルへのチェ ンジの伝達を ス ケジュールする。 p4 integrate

フ ァ イル衝突を解決するか、p4 integrate でス ケジュールし た とお り に

チェ ンジを伝達する。

p4 resolve

p4 restore

204 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 restore

概要

アーカ イブ された古い リ ビジ ョ ンをアーカ イブ ・ デ ィ ポから リ ス ト ア し ます。

構文

p4 [g-opts] restore [ -n ] -D depot file[revRange]...

解説

p4 restoreコマン ド は、アーカ イブをdepot と い う 名前のarchiveタ イプのデ ィ ポから ローカ

ル ・ デ ィ ポ内の元の場所に戻し ます。 リ ス ト ア後は、 リ ビジ ョ ンの操作はアーカ イブ前の状態

に復元されます。

オプシ ョ ン

使用上の留意点

• -n オプシ ョ ンを使用し ない場合、アーカ イブ・デ ィ ポの記憶領域をマウ ン ト し てお く 必要が

あ り ます。

関連コ マン ド

-n フ ァ イルを リ ス ト アせずに、 リ ス ト ア される リ ビジ ョ ンを報告し ます。

-D depot こ こ から フ ァ イルを リ ス ト アすべき アーカ イブ ・ デ ィ ポを指定し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 admin

デ ィ ポを作成する。 p4 depot

フ ァ イルをアーカ イブ ・ デ ィ ポにアーカ イブする p4 archive

フ ァ イルをアーカ イブせずに完全消去する。 p4 obliterate

p4 revert

p4 revert

摘要

作業中のフ ァ イルに加え られた変更を廃棄し ます。

構文

p4 [g-opts] revert [ -a -n -k -c changelist ] file...

解説

p4 revert は、 作業中のフ ァ イルに加え られた変更を廃棄し、 p4 sync でデ ィ ポから 後に同

期させた リ ビジ ョ ンに戻し ます。 また、 変更済フ ァ イルを関連する作業中チェ ンジ リ ス ト から

削除し ます。

p4 delete によ り 作業状態にし たフ ァ イルを元に戻すと、 そのフ ァ イルはク ラ イ アン ト ・ ワー

ク スペース内に復元されます。p4 add によ り 作業状態にし たフ ァ イルを元に戻すと、PERFORCE

はク ラ イ アン ト ・ ワーク スペースのフ ァ イルには手を付けません。 p4 integrate によ り 作業

状態にし たフ ァ イルを元に戻す と、 PERFORCE はク ラ イ アン ト ・ ワーク スペースから そのフ ァ

イルを削除し ます。 p4 move によ り 作業状態にし たフ ァ イルを元に戻すと、 移動 / 追加目的で

作業状態にし たフ ァ イルのみが元に戻されます。

オプシ ョ ン

使用上の留意点

• p4 revertは、一般的にフ ァ イル引数を必要 とする と い う 点で他のほ と んどのPERFORCE コマ

ン ド と異な り ます。 コマン ド ・ ラ イ ンのフ ァ イル引数 と ク ラ イ アン ト ・ ビ ューの共通部分に

あ る フ ァ イルが元に戻されます。

-a オプシ ョ ンを使用し ている場合、 フ ァ イル引数を指定する必要はあ り ません。

-a 作業状態になってか ら （内容またはフ ァ イルタ イ プが） 変更されていないフ ァ イ

ルのみ元に戻し ます。

元に戻されるのは、 次の ク ラ イ アン ト ・ リ ビジ ョ ン を持っている フ ァ イルのみで

す。

･ 編集目的の作業状態にあ るが、 内容が未変更でフ ァ イルタ イプが未変更であ る

フ ァ イル。

･ p4 integrateによ り 反映の目的で作業状態になったが、 p4 resolve によ る

衝突解決がまだ行われていない。

-n 実際に元に戻す操作は実行せず、 元に戻し た結果を リ ス ト し ます。

このオプシ ョ ンによ り 、 事前に元に戻し た と きの結果を確認でき ます。

-k ワーク スペース ・ フ ァ イルを保存し ます。 フ ァ イルはチェ ンジ リ ス ト か ら削除さ

れ、 も はや作業状態でない こ と が PERFORCE に記録さ れますが、 ク ラ イ アン ト ・

ワーク スペース内では変更されません。

-c changelist 指定されたチェ ンジ リ ス ト 内のフ ァ イルのみ元に戻し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル変数に リ ビジ ョ ン範囲

を使えるか？

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

使用不可 使用不可 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 205

p4 revert

• 編集目的で作業状態にし たフ ァ イルを元に戻す と、フ ァ イルが作業状態に されてからユーザ

が加えたすべてのチェ ンジが上書き されます。 p4 revert を実行する前に、 p4 revert -n によ って結果を確認する方が安全だ と言えます。

使用例

関連コ マン ド

p4 revert //... 自分の作業中チェ ンジ リ ス ト にあ るすべての作業中フ ァ イル

を、 作業前の状態に戻し ます。

p4 revert -c default //... デフ ォル ト ・チェ ンジ リ ス ト 内にあ る作業中のフ ァ イルを、す

べて作業前の状態に戻し ます。

p4 revert -n *.txt 現在のデ ィ レ ク ト リ にあ るすべての作業状態の .txt フ ァ イ

ルを元に戻し た結果をプレ ビ ューし ます。 実際には元に戻す

操作は実行されません。

p4 revert -c 31 *.txt 現在のデ ィ レ ク ト リ でチェ ンジ リ ス ト 31 内にあ り 、 拡張子

.txt を持つフ ァ イルを、 すべて作業前の状態に戻し ます。

p4 revert -a 変更されていないすべてのフ ァ イルを元に戻し ます。 こ のコ

マン ド は多 く の場合チェ ンジ リ ス ト のサブ ミ ッ ト 前に使用さ

れます。

追加を目的と し てフ ァ イルを作業状態にする。 p4 add

削除を目的と し てフ ァ イルを作業状態にする。 p4 delete

作業中フ ァ イルをすべてデ ィ ポにコ ピーする。 p4 submit

デ ィ ポから ク ラ イ アン ト ・ ワーク スペースへフ ァ イルを読み込む。 p4 sync

すべての作業中フ ァ イルを一覧表示する。 p4 opened

PERFORCE がユーザのフ ァ イルであ る と判断し たフ ァ イルを、 強制的にク ラ

イ アン ト ・ ワーク スペース と 同期させる。 その際、 作業状態にない書き込

み可能なフ ァ イルはすべて上書き される。

p4 sync -f

206 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 review

p4 review

概要

指定さ れたチェ ンジ リ ス ト 番号よ り 大き い番号を持つサブ ミ ッ ト 済チェ ンジ リ ス ト を一覧表

示し ます。

構文

p4 [g-opts] review [-c changelist] [-t countername]

解説

p4 review -c changelist は、changelist と、それよ り 大きい番号を持つサブ ミ ッ ト 済チェ

ンジ リ ス ト を、 大番号のサブ ミ ッ ト 済チェ ンジ リ ス ト まですべて一覧表示し ます。 リ ス ト の

各行は次のよ う な形式と な り ます。

Change changelist username <email-addr> (realname)

username、email-addr、および realname は、p4 review が実行される と き、必ず username に

対する p4 user フ ォームから取 り 込まれます。

p4 review -t countername と し て使用し た場合、PERFORCEのカ ウ ン タ変数counternameの値

よ り 大 き い値のサブ ミ ッ ト 済チ ェ ン ジ リ ス ト がすべて一覧表示 さ れ ます。 （カ ウ ン タ は p4

counter で設定し ます。）引数な しで使用し た場合、p4 review はすべてのサブ ミ ッ ト 済チェ ン

ジ リ ス ト を一覧表示し ます。

p4 review コマン ド は、PERFORCE のチェ ンジ ・ レ ビ ュー・デーモンなど、PERFORCE にア ク セス

する外部プロ グ ラ ムで使用し ます。 チェ ンジ ・ レ ビ ュー ・ デーモンは PERFORCE パブ リ ッ ク ・

デ ィ ポ

http://public.perforce.com/wiki/P4Review

から入手する こ と ができ、 『システム管理者ガイ ド』 に解説されています。

オプシ ョ ン

使用上の留意点

• p4 review、 p4 reviews、および p4 counter コマン ド は、すべて、PERFORCE にア ク セスす

る外部プロ グ ラ ムで使用される こ と を想定し ています。

• p4 counter と同じ警告が適用されます。

-c changelist changelist と それよ り 大きい番号のサブ ミ ッ ト 済チェ

ンジ リ ス ト をすべて一覧表示し ます。

-t countername PERFORCE のカ ウ ン タ countername よ り 大きい値のサブ

ミ ッ ト 済チェ ンジ リ ス ト をすべて一覧表示し ます。

-c changelist -t countername カ ウ ン タ変数 counternameの値を changelistに設定

し ます。このコマン ド は p4 counterに変わ り ま し たが、

下位互換性を保つために維持されています。

g_opts 「グ ローバル・オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 review

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 207

p4 review

関連コ マン ド

あ る フ ァ イルを参照する ために登録し たユーザを一覧表示する。 p4 reviews

PERFORCE カ ウ ン タの設定や読み取 り を行 う 。 p4 counter

あ るチェ ンジ リ ス ト に関する完全な情報を参照する。 p4 describe

あ る基準で制限し たすべてのチェ ンジ リ ス ト の一覧を参照する。 p4 changes

208 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 reviews

p4 reviews

摘要

あ る フ ァ イルを レ ビ ューでき る よ う に登録し ているすべてのユーザを一覧表示し ます。

構文

p4 [g-opts] reviews [-c changelist] [file...]

解説

p4 reviews は、 PERFORCE にア ク セスする外部プロ グ ラ ムでの使用を想定し ています。

フ ァ イルを レ ビ ューでき る よ う に登録するには、 レ ビ ューし たいユーザの p4 user フ ォーム

のフ ィ ール ド ［Reviews:Ån （レ ビ ュー） にフ ァ イル ・ パターンを入力し ます。

p4 reviews -c changelist は、サブ ミ ッ ト 済のチェ ンジ リ ス ト changelist に含まれている

任意のフ ァ イルを レ ビ ューでき る よ う に登録し ているユーザを リ ス ト し ます。 こ のコマン ド の

代わ り に p4 reviews file... のフ ォームを使 う と、引数 と し て指定し たフ ァ イル・ パターン

に適合する任意のフ ァ イルを レ ビ ューでき る よ う に登録し ているユーザが リ ス ト されます。p4

reviews に引数を指定し ない場合、フ ァ イルを レ ビ ューでき る よ う に登録し ているユーザがす

べて リ ス ト されます。

オプシ ョ ン

使用上の留意点

• 構文 p4 reviews -c changelist file... は、 フ ァ イル引数を完全に無視し ます。

• p4 reviews は変わった コマン ド です。外部デーモンをサポー ト する よ う 作成されま し たが、

きわめて特別な意味を持つ、 p4 users フ ォームのフ ィ ール ド ［Reviews:］ な しでは何も行

いません。

も っ と一般化されたデーモンを作成する ため、PERFORCE が本来意図し ていない値を、フ ィ ー

ル ド ［Reviews:］ に入力する こ と ができ ます。 例えば、 PERFORCE では、 新しいジ ョ ブがサ

ブ ミ ッ ト された と きに、ジ ョ ブを レ ビ ューでき る よ う 登録し ている全ユーザに電子 メ ールを

送る ジ ョ ブ ・ デーモンを実行し ています。 しかし、 ユーザがジ ョ ブを レ ビ ューでき る よ う 登

録する手段が PERFORCE には何も組み込まれていないため、 フ ィ ール ド ［Reviews:］ の 1 行

をむ り や り 利用し ます。 PERFORCE は、 実在し ていないパス //depot/jobs/ を レ ビ ューする

べ く 登録し た全ユーザにジ ョ ブ電子 メ ールを送 り ます。

-c changelist サブ ミ ッ ト 済のチェ ンジ リ ス ト changelist に含まれている任意のフ ァ イル

をレ ビ ューでき る よ う に登録し ているユーザをすべて一覧表示し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用不可 使用不可 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 209

p4 reviews

関連コ マン ド

フ ァ イルをレ ビ ューでき る よ う 登録する。 p4 user

指定されたチェ ンジ リ ス ト 番号よ り 大きい番号のサブ ミ ッ ト 済チェ ンジ リ

ス ト をすべて リ ス ト する。

p4 review

PERFORCE のカ ウ ン タ値の設定や読み取 り を行 う 。 p4 counter

特定のチェ ンジ リ ス ト に関する完全な情報を読み取る。 p4 describe

210 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 set

p4 set

概要

PERFORCE の変数を、 Windows のレジス ト リ または OS X のシステム設定に設定し ます。

構文

p4 [g-opts] set [ -s ] [ -S svcname ] [ var=[value] ]

解説

PERFORCE アプ リ ケーシ ョ ンおよび共有バージ ョ ン化サービ スは、 あ る一定のシステム変数を

使用し ます。

Windows （または OS X） 環境では、 これらの変数の値を p4 set によ り レジス ト リ （またはユー

ザ･プ リ フ ァ レ ン ス またはシステム ・ プ リ フ ァ レ ン ス） に設定でき ます。 同様の こ と を他の OS

で実行する場合、 PERFORCE は環境変数を使用し ます。

現在のユーザに適用される変数設定を変更するには、 p4 set var=value を使用し ます。

管理者は、 p4 set -s var=value を使用し て、 マシン上のすべてのユーザに対し て変数のデ

フ ォル ト 値を設定でき ます。

PERFORCE サーバを サービ ス と し て実行 し てい る Windows 管理者は、 p4 set -S svcname

var=value によ り サービ スが使用し ている変数 （例えば、 P4JOURNAL など） を設定でき ます。

あ る変数に対し て値を未設定にする と きは、 value を空白のま まにし ます。

すべてのPERFORCE変数の値の一覧を参照するには、p4 setを引数な しで使用し ます。P4CONFIG

フ ァ イルを使用し て変数が設定された場合は、 その位置が表示されます。 UNIX では、 関連の

あ る環境変数の値が表示されます。 Windows OS X では、 環境変数 （設定されている場合） ま

たはレジス ト リ （またはシステム設定） の値が表示され、 さ らに p4 set （現在のユーザ用） と

p4 set -s （ローカル ・ マシン用） のどち ら を使用し て定義されたかが表示されます。

Linux UNIX では、 p4 set を使用し て変数の値を参照でき ますが、 それらの OS 上で p4 set

を使用し て変数を設定し よ う とする と、 PERFORCE はエラー ・ メ ッ セージを表示し ます。

オプシ ョ ン

-s ローカル ・ マシンのレジス ト リ 変数 （またはシステム設定） の値を設定し ます。

Windows 環境では、 このオプシ ョ ンがない場合、 p4 set は HKEY_CURRENT_USER ハイブに変数を設定し ます。 -s オプシ ョ ンを使用する と （そし て Windows の管理者 権限を持っている と）、 変数は HKEY_LOCAL_MACHINE ハイブに設定されます。

OS X 環境では、 こ のオプシ ョ ンがない場合、 p4 set は ~/Library/Preferences フ ォルダにあ る com.perforce.environment プロパテ ィ ・ リ ス ト に変数を設定します。 -s オプシ ョ ンを使用する と （そし て管理者権限を持っている と）、 変数はシステムの /Library/Preferences フ ォルダに設定されます。

これらの場所は、Windows 環境および OS X 環境での p4 set の出力に反映されます。

-S svcname svcname と い う 名前のサービ スが使用する レジス ト リ 変数の値を設定し ます。 これを

実行するには、 Windows の管理者権限を持っている必要があ り ます。

-S オプシ ョ ンは、 OS X 環境では無視されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 211

p4 set

使用上の留意点

• 本書の 「環境変数」 のセ ク シ ョ ンに、 PERFORCE の変数の一覧と説明があ り ます。

• Windows でレジス ト リ の設定を変更し て も、 影響を受けるのはローカル ・ マシンだけです。

し たがって、 PERFORCE の Windows サービ スに対する P4JOURNAL の設定は、 サービ スが起動

されているマシン上で行 う 必要があ り ます。

• Windows または OS X における変数の優先順位は以下の とお り です。

• 同じ名前の環境変数の優先順位が高い

• P4CONFIG フ ァ イル内の値の方が さ らに優先される

• PERFORCE サービ スについては、p4 set -S で設定されたレジス ト リ ・ エン ト リ を含むす

べての環境変数が、 p4 configure で設定された構成可能変数にオーバーラ イ ド される

• コマン ド ラ イ ンで指定される グ ローバル ・ オプシ ョ ンのオプシ ョ ンが も優先される

• も し、Windows マシンにおいて UNIX 系の環境をご利用の場合（例えば Cygwin）、p4 set では

な く 環境変数をお使い く だ さい。 （こ の場合、 PERFORCE コマン ド ラ イ ン ・ ク ラ イ アン ト は、

単純にそれが UNIX 環境であ るかのよ う に振舞います。）

使用例

フ ァ イル引数に リ ビジ ョ ン指定

子を使用できるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使用できるか？

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

適用外 適用外 な し

p4 set すべてのプ ラ ッ ト フ ォームにおいて、 PERFORCE 変

数の一覧を、 値を変更し ないで表示し ます。

p4 set P4MERGE= Windows または OS X において、P4MERGE の値を未

設定にし ます。

p4 set P4PORT=ssl:tea:1666 Windows または OS X において変数を設定し、 ホス

ト tea のポー ト 1666 に SSL で PERFORCE サービ ス

に接続する よ う PERFORCE アプ リ ケーシ ョ ンに指示

し ます。

この変数は、 現在のローカル ・ ユーザに対し てのみ

設定されます。

p4 set -s P4PORT=ssl:tea:1666 上 と同じ よ う に P4PORT を設定し ますが、あ るユー

ザに対 し てではな く 、 そのシ ス テ ム上のすべての

ユーザに対し て設定し ます。

p4 set -S p4svc P4PORT=1666 Windows サービ スの p4svc に対し て、 PERFORCE ア

プ リ ケーシ ョ ンからの接続要求をポー ト 番号 1666で接続待ちする よ う p4s.exe に指示し ます。

この操作には、 管理者権限が必要です。

p4 set P4EDITOR=”C:\File Editor\editor.exe”

Windows 上で、 現在のローカル ・ ユーザに対し て、

デフ ォル ト のエデ ィ タへのパス を設定し ます。

エデ ィ タへのパスが空白を含んでいる場合は、 パス

を引用符で囲む必要があ り ます。

212 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 server

p4 server

概要

PERFORCE サーバの仕様を作成、 変更、 または削除し ます。

構文

p4 [g-opts] server serverIDp4 [g-opts] server -gp4 [g-opts] server -d serverIDp4 [g-opts] server -o serverIDp4 [g-opts] server -i

解説

サーバ仕様は、 PERFORCE サーバの高レベルの構成および使用目的を表し ます。 PERFORCE サー

バが 1 つしかないイ ン ス ト ールでは、 サーバ仕様の設定は任意です。

ClientDataFilter: フ ィ ール ド および RevisionDataFilter: フ ィ ール ド は、 複製さ れた環

境で不要なデータ を除外 し たい と き に使用する こ と が意図 さ れています。 （例えば、 ビル ド

フ ァーム ・ レプ リ カは have リ ス ト を含む、 マス ター ・ サーバにあ る作業状態の全ク ラ イ アン

ト ・ ワーク スペースの状態を複製するのにはほ と んど役立ちません。） 複製環境における フ ィ

ルタ リ ングに関し て詳し く は、 『システム管理者ガイ ド』 を参照し て く だ さい。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

ServerID: 読み取 り 専用 こ のサーバに関する一意の識別子。p4 serverid コマン ド によ

り 定義された、サーバの server.id フ ァ イルの内容と一致し て

いなければな り ません。

Type: 書き込み可能 サーバの実行タ イプ。 以下の う ちのどれかにな り ます。

• server

• proxy

• broker

Services: 書き込み可能 こ のサーバに よ って提供されるサービ ス。 以下の う ちのどれか

にな り ます。

･ standard （標準の PERFORCE サーバ）

･ replica ( 読み取 り 専用のレプ リ カ ・ サーバ )

･ broker (p4broker プロセス )

･ proxy (p4p キ ャ ッ シング ・ プロ キシ )

･ forwarding-replica ( データベース書き込みを伴 う コマ

ン ド をマ ス ター･サーバへ と 転送する よ う に構成 さ れた レプ

リ カ )

･ build-server ( ビル ド フ ァームへの反映をサポー ト する レ

プ リ カ )

･ P4AUTH ( 認証を提供するサーバ )

･ P4CHANGE ( チェ ンジ リ ス ト の番号付け替えを提供するサー

バ）

Name: 書き込み可能 こ のサーバに関連付け られた P4NAME。

Address: 書き込み可能 こ のサーバに使用される P4PORT。

Description: 書き込み可能 こ のサーバに関する任意入力の説明。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 213

p4 server

オプシ ョ ン

使用上の留意点

関連コ マン ド

ClientDataFilter:

書き込み可能 レプ リ カ ・ サーバの場合、 こ の任意指定フ ィ ール ド には、 ア ク

テ ィ ブな ク ラ イ アン ト ・ ワーク スペースのデータ を絞 り 込む方

法を表す 1 つ以上のパ タ ーン を含め る こ と がで き ます。 ア ク

テ ィ ブな ク ラ イ アン ト ・ ワーク スペースのデータには、 have リ

ス ト 、 作業レ コード、 未実行の衝突解決が含まれます。

ク ラ イ アン ト ・ データ を含めるには次の構文を使用し ます。

//client-pattern/...

ク ラ イ アン ト ・ データ を除外するには次の構文を使用し ます。

-//client-pattern/...

すべてのパターンは ク ラ イ アン ト ・ シン タ ッ ク スで指定さ れま

す。

RevisionDataFilter: 書き込み可能 レプ リ カ ・ サーバの場合、 こ の任意指定フ ィ ール ド には、 サブ

ミ ッ ト 済 リ ビジ ョ ンのデータ を絞 り 込む方法を表す 1 つ以上の

パターン を含める こ と ができ ます。 サブ ミ ッ ト 済 リ ビジ ョ ンの

データ には、 リ ビジ ョ ン ・ レ コー ド、 反映レ コー ド、 ラベルの

内容、 およびサブ ミ ッ ト 済チェ ンジ リ ス ト に リ ス ト さ れたフ ァ

イルが含まれます。

デ ィ ポ ・ データ を含めるには次の構文を使用し ます。

//depot/pattern/...

デ ィ ポ ・ データ を除外するには次の構文を使用し ます。

-//depot/pattern/...

すべてのパターンはデ ィ ポ ・ シン タ ッ ク スで指定されます。

-g フ ォームの一部と し て、 サーバ ID を生成し ます。

-d serverID 指定されたサーバ仕様を削除し ます。

-o 指定されたサーバ仕様を標準出力に書き出し ます。

-i サーバ仕様を標準入力から読み込みます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 super

作成後にサーバ ID を変更する。 p4 serverid

既知のサーバをすべて一覧表示する。 p4 servers

フ ィ ールド名 タ イプ 説明

214 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 serverid

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 215

p4 serverid

概要

PERFORCE サーバに関連付け られた一意の ID を取得または設定し ます。

構文

p4 [g-opts] serverid [ serverID ]

解説

p4 serverid は、サーバのルー ト ・デ ィ レ ク ト リ にあ る server.id フ ァ イルに対し て読み取 り

または書き込みを行い、 PERFORCE サーバの一意の ID を取得または設定し ます。

まず p4 server コマン ド によ ってサーバに一意の ID を生成し た後に、 このコマン ド を使用し

て server.id フ ァ イルを作成または更新し ます。

オプシ ョ ン

使用上の留意点

server.id フ ァ イルはサーバのルー ト ・ デ ィ レ ク ト リ に存在し、 バッ ク ア ッ プを取る必要があ

り ます。 サーバの構成のために p4 server コマン ド を使用し ている場合に、 サーバの 1 つで

壊滅的なデータ喪失が起き た場合、 リ ス ト ア さ れたサーバでは こ のフ ァ イルが存在し ない と

（または再作成されない と） 再起動時に正し く サーバを構成でき な く な り ます。

関連コ マン ド

serverID 指定された場合、 server.id をサーバの一意の ID で更新し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list、 またはサーバ ID の設定には

super

サーバの仕様を編集または表示する。 p4 server

既知のサーバをすべて一覧表示する。 p4 servers

p4 servers

216 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 servers

概要

すべてのサーバ仕様の リ ス ト を表示し ます。

構文

p4 [g-opts] servers

解説

マス ターの PERFORCE サーバに保存されている、 すべてのサーバ仕様を一覧表示し ます。

オプシ ョ ン

使用上の留意点

• p4 servers の出力は、 タ グ付き フ ォームで取得する と解析が容易にな る場合があ り ます。

p4 -ztag servers

関連コ マン ド

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

サーバの仕様を編集または表示する。 p4 server

サーバの一意の ID を設定する。 p4 serverid

p4 shelve

p4 shelve

概要

フ ァ イルをサブ ミ ッ ト する こ と な く 、 作業中チェ ンジ リ ス ト からデ ィ ポに保存し ます。

構文

p4 [g-opts] shelve [files ...]p4 [g-opts] shelve -i [-f | -r ]p4 [g-opts] shelve -r -c changelistp4 [g-opts] shelve -c changelist [-f] [file ...]p4 [g-opts] shelve -d -c changelist [-f] [file ...]

解説

保留と は、 チェ ンジ リ ス ト をサブ ミ ッ ト せずに、 進行中の作業を一時的に PERFORCE バージ ョ

ン化サービ スに格納する処理の こ と です。 保留処理は、 複数の開発タ ス ク （よ り 優先度の高い

作業の割 り 込みや複数プラ ッ ト フ ォームでのテス ト など） を同じ フ ァ イル集合に対し て行 う 必

要があ る と き、 あ るいは作業をデ ィ ポに登録する前にコード ・ レ ビ ュー用にフ ァ イルを共有す

る場合に有効です。

p4 shelve コマン ド によ り 、 保留状態のフ ァ イルを作業中チェ ンジ リ ス ト 内で作成、 変更、 ま

たは破棄する こ と ができ ます。 保留状態のフ ァ イルは、 それらが破棄 （p4 shelve -d を使用）

されるか、 以降の p4 shelve コマン ド によ って置き換え られる までデ ィ ポに保持されます。

フ ァ イルを保留し た後は、 ク ラ イ アン ト ・ ワーク スペース内でそれら を元に戻すか変更する こ

と ができ、 保留されたバージ ョ ンのフ ァ イルを p4 unshelve コマン ド によ ってワーク スペー

スに復元する こ と ができ ます。

フ ァ イルが保留されている と き、他のユーザは保留状態のフ ァ イルを自分のワーク スペース ま

たは他の ク ラ イ アン ト ・ ワーク スペースで保留解除する こ と ができ ます。

保留されたフ ァ イルには、 p4 diff、 p4 diff2、 p4 files、 p4 print の各コマン ド によ り 、

リ ビジ ョ ン指定子 @=change を使用し てア ク セスする こ と も可能です。 この と き、change には

作業中チェ ンジ リ ス ト の番号を指定し ます。

引数が指定されていない場合、p4 shelve は新しいチェ ンジ リ ス ト を作成し、 ユーザのデフ ォ

ル ト ・ チェ ンジ リ ス ト から フ ァ イルを追加し た後 （ユーザが p4 submit で使用される もの と

同様のフ ォームに入力し た後）、指定されたフ ァ イルをデ ィ ポに保留し ます。 フ ァ イル・パター

ンが指定されている場合、 p4 shelve はそのパターンに一致する フ ァ イルのみを保留し ます。

オプシ ョ ン

-f 作業中チェ ンジ リ ス ト にあ る既存の保留状態のフ ァ イルを、 ク ラ イ アン ト ・ ワー

ク スペース内にコ ピーされた内容へと強制的に上書き し ます。

PERFORCE 管理者はこのオプシ ョ ンを -d と共に使用し て、 指定されたチェ ンジ

リ ス ト にあ る保留状態のフ ァ イルを強制的に破棄する こ と ができ ます。

-i チェ ンジ リ ス ト のコ メ ン ト を標準入力から読み取 り ます。p4 shelve のフ ォー

ム と同じ フ ォーマ ッ ト で入力し なければな り ません。 （保留状態のフ ァ イルを含

む既存のチェ ンジ リ ス ト を変更する場合、 こ のオプシ ョ ンは -c も含意し ます。）

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 217

p4 shelve

使用上の留意点

• まだ存在し ない保留領域にフ ァ イルを追加するには、 初にそのフ ァ イルを保留領域のチェ

ンジ リ ス ト 内で作業状態にする必要があ り ます。p4 reopen を使用し て、作業状態のフ ァ イ

ルをあ るチェ ンジ リ ス ト から別のチェ ンジ リ ス ト に移動させて く だ さい。

関連コ マン ド

-c changelist 保留状態のフ ァ イルを作成、 破棄、 ま たは変更する作業中チェ ンジ リ ス ト を指

定し ます。

作業中チ ェ ン ジ リ ス ト を所有 し てい る ユーザお よ び ク ラ イ ア ン ト ・ ワー ク ス

ペースのみが、 保留されたフ ァ イルを追加または変更でき ます。 ( 管理者は -fを使用し てフ ァ イルを破棄する こ と が可能です。 )

フ ァ イル･パターンによ って指定されたフ ァ イルは、 指定されたチェ ンジ リ ス ト

内で既に作業状態にされている必要があ り ます。 p4 reopen を使用し て、 作業

状態のフ ァ イルをあ るチェ ンジ リ ス ト か ら別のチェ ンジ リ ス ト に移動させて く

ださい。

-d 指定されたチェ ンジ リ ス ト にあ る保留状態のフ ァ イルを破棄し、 それら に対し

て p4 unshelve の操作を行えないよ う にし ます。

作業中チ ェ ン ジ リ ス ト を所有 し てい る ユーザお よ び ク ラ イ ア ン ト ・ ワー ク ス

ペースのみが、 保留されたフ ァ イルを破棄でき ます。 ( 管理者は -f を使用し て

フ ァ イルを破棄する こ と が可能です。 )

-r チェ ンジ リ ス ト 内の保留状態のフ ァ イルをすべて、 ワーク スペースで作業状態

にされている フ ァ イルに置き換えます。 （チェ ンジ リ ス ト 内のフ ァ イルを、 特定

のチェ ンジ番号で作業状態に さ れてい る フ ァ イルに置き換え る には、 -c オプ

シ ョ ン または -i オプシ ョ ンを使用し ます。） 作業中チェ ンジ リ ス ト に関連付け

られているユーザおよびワーク スペースのみが、 保留状態のフ ァ イルを置き換

え る こ と ができ ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用可 使用可 write

保留されたフ ァ イルを ワーク スペースに復元する p4 unshelve

218 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 sizes

p4 sizes

概要

デ ィ ポ内にあ る フ ァ イルの大き さの情報を表示し ます。

構文

p4 [g-opts] sizes [-a] [-S] [-s|-z] [-b blocksize] [-m max] file[revRange] ...p4 [g-opts] sizes -U unloadfile...

解説

p4 sizes コマン ド は、 デ ィ ポ内に格納されている フ ァ イルの 大き さ を表示し ます。 オプシ ョ

ンを付けずに実行する と、単一または複数のフ ァ イルの 新 リ ビジ ョ ンの大き さ だけが表示さ

れます。 1 フ ァ イルにつき 1 行ずつ出力されます。

-a オプシ ョ ンを使用する と、指定し た リ ビジ ョ ン範囲にあ る 新 リ ビジ ョ ンのみでな く 、その

範囲の各 リ ビジ ョ ンによ ってどれだけのスペースが占有されているかが確認でき ます。 1 フ ァ

イル、 1 リ ビジ ョ ンにつき 1 行ずつ出力されます。

-s オプシ ョ ンを使用する と、指定されたすべてのフ ァ イルの合計が表示されます。出力は 1 行

のみで、 フ ァ イル指定、 総フ ァ イル数、 必要 と される総バイ ト 数、 および （-b オプシ ョ ンが指

定されている場合） 必要と される総ブロ ッ ク数が表示されます。

-z オプシ ョ ンは -s と同様に作用し ますが、遅延コ ピー （反映処理のために存在する フ ァ イル）

によ って占有される スペースが除外されます。 PERFORCE イ ン ス ト ール上のフ ァ イルに占有さ

れている スペース を概算するには -z を使用し、 フ ァ イルが ク ラ イ アン ト ・ スペースに同期さ

れている場合にローカルのデ ィ ス ク ・ スペースの必要量を見積も るには -s を使用し ます。

オプシ ョ ン

使用上の留意点

• p4 sizes コマン ド の機能は、 UNIX の du コマン ド に類似し ています。

• リ ビジ ョ ン範囲が指定されていない場合、暗黙的な リ ビジ ョ ン範囲の#1から #headが想定さ

れます。

-a 範囲内の 新 リ ビジ ョ ンのみではな く 、 範囲内のすべての リ ビジ ョ

ンを含めます。

-b blocksize 結果を blocksize バ イ ト のブ ロ ッ ク 単位で表示 し ます。 合計の

フ ァ イル・サイ ズは直近の blocksize バイ ト に切 り 上げられます。

-m max 出力内容を max 行に制限し ます。

-s 指定されたフ ァ イル引数のフ ァ イル ・ サイ ズの合計を計算し ます。

-S 保留されたフ ァ イルのサイ ズ情報のみを表示し ます。 こ のオプシ ョ

ンを使用する場合、 リ ビジ ョ ンの指定は行えません。

-z 怠惰な コ ピーを除いて、 サイ ズ情報を計算し ます。

-U unloadfile アン ロード ・デ ィ ポにあ る フ ァ イルのサイ ズのみを リ ス ト し ます。詳

し く は、 p4 unload をご覧 く ださい。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 219

p4 sizes

• フ ァ イル ・ サイ ズはク ラ イ アン ト ・ ワーク スペースに同期された と きのフ ァ イルの状態に関

係な く 、 標準 （UNIX の行送 り 規則） かつ圧縮されていないバージ ョ ンのデ ィ ポ ・ フ ァ イル

に基づき ます。

使用例

p4 sizes file.c デ ィ ポ内の file.c の 新 リ ビジ ョ ンの大き さ を示し

ます。

p4 sizes -a file.c デ ィ ポに格納されている file.c の各 リ ビジ ョ ンの大

き さ を示し ます。

p4 sizes -s -a file.c デ ィ ポに格納されている file.c のすべての リ ビジ ョ

ンの合計サイ ズを示し ます。

p4 sizes -s -a -b 512 //depot/... //depot/... で稼動し ている PERFORCE イ ン ス ト ール

が現在使用し ている フ ァ イル数およびデ ィ ス ク容量の

合計(バイ ト 単位で512バイ ト のブロ ッ ク ) を示し ます。

p4 sizes -s //workspace/... フ ァ イル数および workspace と い う ク ラ イ アン ト ・

ワ ー ク スペー ス にマ ッ プ さ れた フ ァ イ ルの 新 リ ビ

ジ ョ ン を同期する ために必要な ローカルのデ ィ ス ク容

量の合計 （バイ ト 単位）

220 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 status

p4 status

概要

フ ァ イルを追加、 削除、 および / または編集目的で作業状態にし、 PERFORCE 外部での変更内

容と ワーク スペース と を一致させます。

構文

p4 [g-opts] status [ -e -a -d -f -I ]p4 [g-opts] status -A [ -e -a -d -f -I ]

解説

p4 status コマン ド は、ク ラ イ アン ト のワーク スペース内にあ る作業状態でないフ ァ イルを検

索し、 ワーク スペース とデ ィ ポ と の間で以下の 3 種類の不整合を検出し ます。

1. デ ィ ポ内に存在し、 ユーザの have リ ス ト に存在するが、 ワーク スペースには存在し ない

フ ァ イル。 デフ ォル ト では、 これらのフ ァ イルは削除目的で作業状態に されます。

2. ワーク スペースに存在するが、 デ ィ ポには存在し ないフ ァ イル。 デフ ォル ト では、 これら

のフ ァ イルは追加目的で作業状態に されます。

3. ワーク スペース内では変更されているが、 編集目的で作業状態に されていないフ ァ イル。

デフ ォル ト では、 これらのフ ァ イルは編集目的で作業状態に されます。

p4 status の処理範囲を追加、 編集、 または削除に限定するには、 それぞれ -a、 -e、 -d オプ

シ ョ ンを使用し ます。

デフ ォル ト では、 p4 status は P4IGNORE フ ァ イルに記述されたフ ァ イルおよび / またはパス

をチェ ッ ク し ません。 こ の動作をオーバーラ イ ド し、 P4IGNORE フ ァ イルを無視するには、 -I

オプシ ョ ンを使用し ます。

オプシ ョ ン

使用上の留意点

• p4 status コマン ド は出力を ローカル・ シン タ ッ ク スで生成し ます。 フ ァ イル名およびパス

をデ ィ ポ ・ シン タ ッ ク スで見るには、 p4 reconcile を使用し ます。

-A フ ァ イルの追加、 編集、 および削除を行います。 PERFORCE の制御下にない、 ク ラ

イ アン ト ・ ワーク スペース内のフ ァ イルが追加目的で作業状態にされます。変更さ

れたフ ァ イルは編集目的で作業状態にされます。ユーザのhave リ ス ト にあ るがワー

ク スペースから削除されている フ ァ イルは、 削除目的で作業状態にされます。

p4 status -A は p4 reconcile -ead と同様に機能し ます。

-f 特殊文字 （ワ イル ド カー ド） を含むフ ァ イル名を追加し ます。 特殊文字の @、 #、

%、 * を含むフ ァ イルは、 それらの文字を 16 進表記によ り エン コード し て再フ ォー

マ ッ ト さ れます。 こ れ ら の フ ァ イ ルが追加 さ れた後は、 フ ァ イ ルを示す際に再

フ ォーマ ッ ト されたフ ァ イル名を使用する必要があ り ます。

-I 無視するかど う かのチェ ッ ク を行いません。 P4IGNORE によ って指定されたすべ

ての設定を無視し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 open

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 221

p4 status

• 引数を付けずに実行する と、p4 status はワーク スペース照合の結果のみをプレ ビ ューし ま

す。 実際にフ ァ イルをチェ ンジ リ ス ト 内で作業状態にするには、 p4 status -A （または -

e、 -a、 -d オプシ ョ ンの組み合わせ） を使用する必要があ り ます。

関連コ マン ド

PERFORCE 外部での変更内容を ワーク スペース と一致させます。 p4 reconcile

222 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 stream

p4 stream

概要

ス ト リ ーム仕様を作成、 編集または削除し ます。

構文

p4 [g-opts] stream [-P parent] -t type namep4 [g-opts] stream [-f] [-d] [-o [-v]] [-P parent] -t type namep4 [g-opts] stream -i [-f]

解説

p4 stream コマン ド によ って、PERFORCE ス ト リ ームを管理する こ と ができ ます。ス ト リ ーム と

は変更の構造 と フ ローを制御する ための戦略を持つ、 階層構造か ら な る ブ ラ ンチです。 ス ト

リ ームの階層は、ユーザがス ト リ ームに割 り 当て る タ イプによ って指定される ス ト リ ームの安

定性に基づき ます。 開発 （development） ス ト リ ームは も安定性が低 く （ も変化しやすい）、

メ イ ン ラ イ ン （mainline） ・ ス ト リ ームは比較的安定性が高 く 、 リ リ ース （release） ・ ス ト リ ー

ムは非常に安定し ています。 仮想 （virtual） ス ト リ ームを使用する と、 ローカル ・ データ を保

存せずに親ス ト リ ーム と子ス ト リ ームの間でコ ピーおよびマージを行 う こ と ができ ます。 タ ス

ク （task） ス ト リ ームは軽量の短期的なブラ ンチであ り 、 バグ修正や、 ブラ ンチ ・ データのほ

んの一部しか修正し ない新機能への使用に役立ちます。

ス ト リ ームの内容はユーザがマ ッ ピングするパスによ って定義されます。 デフ ォル ト では、 ス

ト リ ームはその親 （ブ ラ ンチ元 と なった ス ト リ ーム） と 同じ構造を持ち ますが、 その構造を

オーバーラ イ ド し て、例えば特定のフ ァ イルから他のス ト リ ームへのサブ ミ ッ ト または反映を

実行でき ないよ う にする こ と ができ ます。

ス ト リ ームに関する詳しい説明は、 『P4 ユーザーズ ・ ガイ ド』 を参照し て く だ さい。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Stream: 書き込み可能、

必須

ス ト リ ームの名前 （永続的な識別子） およびス ト リ ーム ・ デ ィ ポ

でのパス を、//depotname/streamname の形式で指定し ます。

Update: 読み取 り 専用 ス ト リ ーム仕様が 後に変更された日付。

Access: 読み取 り 専用 ス ト リ ーム仕様が 後に PERFORCE コマン ド によ ってア ク セス さ

れた日時。

Owner: 書き込み可能、

必須

ス ト リ ームを所有し ている PERFORCE ユーザまたはグループ。 デ

フ ォル ト は、 ス ト リ ームを作成し たユーザです。

Name: 書き込み可能 ス ト リ ームの名前を表示し ます。 Stream: フ ィ ール ド と は異な

り 、 こ のフ ィ ール ド は変更可能です。 デフ ォル ト 値はス ト リ ー

ム ・ パスの streamname 部分です。

Parent: 書き込み可能 このス ト リ ームの親。 ス ト リ ームの Type: が mainline の場合

は空白にし、 それ以外の場合は //depotname/streamname の

形式で既存のス ト リ ーム識別子に設定し なければな り ません。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 223

p4 stream

Type: 書き込み可能、

必須

ス ト リ ームのタ イプによ って、想定される変更フ ローが決定され

ま す。 有効 な ス ト リ ー ム ・ タ イ プは、 mainline、 virtual、

development、 および release です。

･ mainline

メ イ ン ラ イ ン ・ ス ト リ ームはス ト リ ーム ・ デ ィ ポ内のすべて

のス ト リ ームの親です。 あ ら ゆ る ス ト リ ーム ・ デ ィ ポには少

な く と も 1 つの メ イ ン ラ イ ン ・ ス ト リ ームが存在し なければ

な り ません。

• virtual

仮想ス ト リ ーム を使用する と、 ローカル ・ データ を保存せず

に親ス ト リ ーム と 子ス ト リ ームの間でマージおよびコ ピーを

行 う こ と ができ ます。 データは仮想ス ト リ ームのビ ューに定

義さ れている フ ァ イル範囲に関する制約を適用し た後に、 コ

ピー / マージ先 （仮想ス ト リ ーム以外） に送られます。

･ release

メ イ ン ラ イ ン よ り も安定性の高いス ト リ ームです。 リ リ ース ・

ス ト リ ームは親から コ ピーされ、 親へ と マージ されます。

･ development

メ イ ン ラ イ ン よ り も安定性の低いス ト リ ームです。 開発ス ト

リ ームは、 親か ら マージ さ れ、 親へ と コ ピーさ れる こ と が想

定されます。

･ task

タ ス ク ・ ス ト リ ームは軽量の短期的なブ ラ ンチであ り 、 バグ

修正や、 ブ ラ ンチ ・ データ のほんの一部し か修正し ない新機

能への使用に役立ち ます。 こ のタ イ プのス ト リ ーム を使用す

る と、 ブ ラ ンチ （コ ピー） さ れたフ ァ イルは後に消去さ れる

一連のシ ャ ド ウ ・ テーブルに記録さ れる ため、 レポジ ト リ に

は 小限の メ タデータのみが保持されます。 タ ス ク ・ ス ト リ ー

ムに関連付け られた ワーク スペースではすべてのブ ラ ンチ済

データ を参照でき ますが、 ス ト リ ームの名前空間へのア ク セ

ス権があ る ユーザには、 変更さ れたか昇格し たデータ のみが

可視 と な り ます。

デフ ォル ト のス ト リ ーム ・ タ イプは development です。

Description: 書き込み可能、

任意

ス ト リ ームに関する説明。

フ ィ ールド名 タ イプ 説明

224 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 stream

Options: 書き込み可能 以下に示す、 ス ト リ ームの動作を構成する設定 ：

･ [un]locked

他のユーザによ る ス ト リ ームの編集または削除を有効 / 無効

に し ます。 ロ ッ ク さ れている場合、 ス ト リ ーム仕様は削除で

きず、所有者だけが変更可能です。デフ ォル ト 値は unlockedです。

･ [all|owner]submit

ス ト リ ームの変更のサブ ミ ッ ト を、 すべてのユーザに許可す

る か、 所有者にのみ許可する かを指定し ます。 デフ ォル ト 値

は allsubmit です。ownersubmit がマーク されたス ト リ ー

ム の Owner: がグループであ る 場合、 そのグループの メ ン

バーであ るすべてのユーザが変更を ス ト リ ームにサブ ミ ッ ト

でき ます。

･ [no]toparent

当該ス ト リ ームか ら その親への反映が想定さ れるかど う かを

指定し ます。 デフ ォル ト 値は toparent です。

･ [no]fromparent

親か ら当該ス ト リ ームへの反映が想定さ れるかど う かを指定

し ます。 デフ ォル ト 値は メ イ ン ラ イ ンおよび開発ス ト リ ーム

は fromparent、 リ リ ース ・ ス ト リ ームは nofromparent で

す。

virtual タ イプのス ト リ ームには、 フ ロー ・ オプシ ョ ン と

し て notoparent および nofromparent を設定する必要が

あ り ます。

mainline タ イプのス ト リ ームでは、フ ロー・オプシ ョ ンは

無視されます。

フ ィ ールド名 タ イプ 説明

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 225

p4 stream

Paths: 書き込み可能 フ ァ イルがどのよ う にス ト リ ーム構造に組み込まれるかを定義

し ます。 以下の形式を使用し て、 パス を指定し ます。

path_type view_path [depot_path]

ただし、 path_type は単一のキーワード、 view_path は頭に

ス ラ ッ シュが付かないフ ァ イル ・ パスです。 任意指定の

depot_path は // で始ま る フ ァ イル ・ パスです。

デフ ォル ト のパスは share ... です。

有効なパス ・ タ イプを以下に示し ます。

･ share view_path

指定されたフ ァ イルは、 親ス ト リ ームからのまたは親ス ト

リ ームへの同期、 サブ ミ ッ ト 、 反映が可能です。

･ isolate view_path

指定されたフ ァ イルは、 親ス ト リ ームからのまたは親ス ト

リ ームへの同期およびサブ ミ ッ ト が可能ですが、 反映は実行

でき ません。

･ import view_path [depot_path]

指定されたフ ァ イルは、 親ス ト リ ームからのまたは親ス ト

リ ームへの同期が可能ですが、 サブ ミ ッ ト または反映は実行

でき ません。 view_path は親ス ト リ ームのビ ューにマ ッ ピ

ング されるか、 （任意指定の） depot_path にマ ッ ピング さ

れます。

･ exclude view_path

指定されたフ ァ イルは、 親ス ト リ ームからのまたは親ス ト

リ ームへの同期、 サブ ミ ッ ト または反映を実行でき ません。

デフ ォル ト では、 ス ト リ ームは親ス ト リ ームの構造を引き継ぎ

ます （ メ イ ン ラ イ ンは親がないため除外）。

パスは子ス ト リ ームのビ ューから引き継がれます。 子ス ト リ ー

ムのパスでは引き継がれたビ ューのダウ ングレー ド は可能です

が、 ア ッ プグレードする こ と はでき ません。 （例えば、 子ス ト

リ ームでは shared パス を isolated パスにダウ ングレード で

き ますが、 親ス ト リ ームでパスが isolated と し て定義されて

いる場合、 子ス ト リ ームでパス を shared に指定し てフルア ク

セスに戻すこ と はでき ません。）

depot_pathはpath_typeがimportであ る場合にのみ機能す

る こ と に注意し て く ださい。

フ ィ ールド名 タ イプ 説明

226 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 stream

オプシ ョ ン

使用上の留意点

その名前が示すとお り 、 タ ス ク ・ ス ト リ ームは短期的な使用が意図されています。 変更を親ス

ト リ ームに昇格させて タ ス ク ・ ス ト リ ームの使用を終了し た ら、 タ ス ク ・ ス ト リ ームを削除し

て く ださ い。

Remapped: 書き込み可能、

任意

ワーク スペース ・ フ ァ イルの位置を再割 り 当て し ます。 反映元パ

ス と ワーク スペース内での位置を指定するには、以下の構文を使

用し ます。

view_path_1 view_path_2

た だ し、 view_path_1 お よ び view_path_2 は PERFORCE

ビ ュー ・ パスです （ 初のス ラ ッ シ ュおよび 初または途中にあ

る ワ イル ド カード は省略し、 後のワ イル ド カード は許容されま

す）。 例えば、 フ ァ イルがローカルの ProjectX フ ォルダに同期さ

れる よ う にするには、 以下のよ う にマ ッ ピング し直し ます。

... projectX/...

Remapped: フ ィ ール ド では行の順序に意味があ り ます。 複数行

が同じ フ ァ イルに再割 り 当て されている場合、後の行が優先され

ます。再割 り 当ては子ス ト リ ームおよび関連付け られたワーク ス

ペースに継承されます。

Ignored: 書き込み可能、

任意

ク ラ イ アン ト ・ ビ ューで無視されるべき フ ァ イル名またはデ ィ レ

ク ト リ 名の リ ス ト 。 例 :

/tmp # ignores files named “tmp”/tmp/... # ignores directories named “tmp”.tmp # ignores file names ending in .tmp

Ignored: フ ィ ール ド 内の行は順不同です。 無視される フ ァ イ

ルおよびデ ィ レ ク ト リ は、 子ス ト リ ームのク ラ イ アン ト ・ ビ ュー

に継承されます。

-d streamname ス ト リ ーム仕様を削除し ます。ス ト リ ーム仕様は、子ス ト リ ーム またはス ト リ ー

ムの ク ラ イ アン ト ・ ワーク スペースによ って参照されている場合には削除でき

ません。 ス ト リ ームを削除し て も、 その中のフ ァ イルは削除されませんが、 変

更をそのス ト リ ームにサブ ミ ッ ト でき な く な り ます。

-f 管理者は -f オプシ ョ ンを使用し て、他のユーザが所有し ている ロ ッ ク されたス

ト リ ームを削除または変更する こ と が可能です。

-i ス ト リ ーム仕様を標準入力から読み取 り ます。

-o ス ト リ ーム仕様を標準出力に書き出し ます。

-o -v 冗長オプシ ョ ン。 こ のス ト リ ーム用に自動生成された ク ラ イ アン ト ・ ビ ューを

含めます。

-P parent 新しいス ト リ ーム仕様を作成する際にス ト リ ームの親を指定し ます。( このオプ

シ ョ ンは既存のス ト リ ーム仕様には効果があ り ません。 )

-t type 新 し い ス ト リ ーム仕様を作成す る 際に、 ス ト リ ーム の タ イ プ を mainline、

development、 release、 task、virtual のどれかに指定し なければな り

ません。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 open

フ ィ ールド名 タ イプ 説明

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 227

p4 stream

使用例

関連コ マン ド

p4 stream -t development -P main //projectX/bruno-dev

メ イ ン ラ イ ンをブラ ンチする こ と によ り 、 プロ ジェ ク ト

X 用の開発ス ト リ ームを作成し ます。

ス ト リ ームを一覧表示する。 p4 streams

ス ト リ ーム ・ デ ィ ポを作成する。 p4 depot

228 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 streams

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 229

p4 streams

概要

ス ト リ ームの リ ス ト を表示し ます。

構文

p4 [g-opts] streams [-U -F filter -T fields -m max] [streamPath ...]

解説

現在接続中のサービ スに定義さ れている ス ト リ ーム を一覧表示し ます。 特定のデ ィ ポのス ト

リ ームを表示する など、 リ ス ト を フ ィ ルタ リ ングするには、 streamPath を指定し ます。

オプシ ョ ン

使用上の留意点

使用例

関連コ マン ド

-F filter 指定されたフ ィ ール ド の内容に基づいて、 出力をフ ィ ルタ リ ング し ます。

-T fields タ グ付き出力に対し て使用する と、 出力フ ィ ール ド を fields の リ ス ト で指定

されている フ ィ ール ド に限定し ます。 フ ィ ール ド 名はスペース またはカンマで

区切る こ と ができ ます。 ス ク リ プ ト 作成時に使用するオプシ ョ ンです。

-U p4 unload によ り アン ロード された タ ス ク ・ ス ト リ ームを表示し ます。

-m max 一覧表示する ス ト リ ームの 大数。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 list

jam デ ィ ポ内のス ト リ ームを一覧表示し ます。 p4 streams //jam/...

ブルーノ が所有し ている リ リ ース ・ ス ト リ ーム

を一覧表示し ます。

p4 streams -F “Owner=bruno Type=release”

ス ト リ ームを作成、 編集、 または削除する。 p4 stream

p4 submit

p4 submit

概要

作業状態のフ ァ イルに加え られた変更をデ ィ ポに送 り ます。

構文

p4 [g-opts] submit [-r] [-s] [-f submitoption]p4 [g-opts] submit [-r] [-s] [-f submitoption] filesp4 [g-opts] submit [-r] [-f submitoption] -d descriptionp4 [g-opts] submit [-r] [-f submitoption] -d description filep4 [g-opts] submit [-r] [-f submitoption] -c changelist

p4 [g-opts] submit e shelvedchange p4 [g-opts] submit -i [-r] [-s] [-f submitoption]

解説

p4 add、 p4 edit、 p4 delete、 および p4 integrate を使用し てフ ァ イルを作業状態にする

と、 そのフ ァ イルはチェ ンジ リ ス ト に入 り ます。p4 submit を使用し てチェ ンジ リ ス ト をデ ィ

ポに送ら ない限 り 、 ユーザがフ ァ イルに加え る変更は、 ク ラ イ アン ト ・ ワー ク スペース ・ コ

ピー内だけで実行されます。

デフ ォル ト では、 デフ ォル ト ・ チェ ンジ リ ス ト 内でフ ァ イルが作業状態にな り ますが、 新しい

番号付チェ ンジ リ ス ト を p4 change で作成でき ます。デフ ォル ト ・チェ ンジ リ ス ト をサブ ミ ッ

ト するには p4 submit を使用し、 番号付チェ ンジ リ ス ト をサブ ミ ッ ト するには p4 submit -

c changelist を使用し ます。

デフ ォル ト では、 チェ ンジ リ ス ト 内のすべてのフ ァ イルがデ ィ ポにサブ ミ ッ ト され、 編集、 追

加、 およびブラ ンチを目的と し たフ ァ イルの作業状態は、 フ ァ イルへの変更の有無にかかわら

ず、 サブ ミ ッ ト によ って解除されます。 こ のデフ ォル ト 動作を変更するには、 自分のワーク ス

ペースの p4 client フ ォームで [SubmitOptions:] フ ィ ール ド を設定し ます。 自分のワーク

スペースの [SubmitOptions:] の設定を コマン ド ラ イ ンから上書きするには、 p4 submit -f

submitoption を使用し ます。

p4 submit をデフ ォル ト ・チェ ンジ リ ス ト と と もに使用する と、EDITOR （または P4EDITOR） の

環境変数ま たはレ ジ ス ト リ 変数で定義し たエデ ィ タ内に編集用のフ ォームが表示 さ れます。

フ ォームか ら フ ァ イルを削除する こ と によ り チェ ンジ リ ス ト か ら フ ァ イルを削除でき ますが、

これらのフ ァ イルは次のデフ ォル ト ・ チェ ンジ リ ス ト 内で作業状態のま ま と な り ます。 フ ァ イ

ルを作業状態から解除し、 すべてのチェ ンジ リ ス ト から除去するには、 p4 revert を使用し ま

す。

すべてのチェ ンジ リ ス ト にはフ ィ ール ド ［Status:］ （ス テータ ス ： ） があ り 、 こ のフ ィ ール

ド の値は ［pending］ （作業中） または ［submitted］ （サブ ミ ッ ト 済） です。 サブ ミ ッ ト 済チェ

ンジ リ ス ト は、p4 submit で正常にサブ ミ ッ ト された もので、 作業中チェ ンジ リ ス ト はユーザ

が作成し たがまだ正常にサブ ミ ッ ト されていないものです。

p4 submit はチェ ンジ リ ス ト 単位で機能し ます。 こ のコマン ド によ り 、 チェ ンジ リ ス ト 内のす

べてのフ ァ イルがデ ィ ポ内に保存されるか、 1 つも保存されないかのいずれかにな り ます。 p4

submitは、中断された り 、チェ ンジ リ ス ト 内のフ ァ イルが 1 つで も ク ラ イ アン ト ・ワーク スペー

ス （p4 lock） 内に見つから ない場合、 フ ァ イルが 1 つで も他の ク ラ イ アン ト ・ ワーク スペー

ス内でロ ッ ク されている場合、 衝突解決が必要でまだ解決されていない状態の場合、 失敗し ま

す。

チェ ンジ リ ス ト を コ ミ ッ ト する前に、p4 submit は少しの間、 サブ ミ ッ ト されるすべてのフ ァ

イルを ロ ッ ク し ます。 いずれかのフ ァ イルがロ ッ ク でき ないかサブ ミ ッ ト でき ない場合、 それ

ら は番号付き の作業中チェ ンジ リ ス ト で作業状態のま まにな り ます。 デフ ォル ト では、 サブ

230 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 submit

ミ ッ ト 操作に失敗し たフ ァ イルは構成可能変数 submit.unlocklocked が設定されていない限

り 、 ロ ッ ク されたま まにな り ます。 submit.unlocklocked が設定されている場合にサブ ミ ッ

ト に失敗する と、サブ ミ ッ ト 実行前に手動でロ ッ ク し たフ ァ イルであって も アン ロ ッ ク されま

す。

デフ ォル ト ･チェ ンジ リ ス ト の処理中に p4 submit が失敗する と、 チェ ンジ リ ス ト にはチェ ン

ジ リ ス ト の次の続き番号が割 り 当て られ、 デフ ォル ト ・ チェ ンジ リ ス ト は空にな り ます。

サブ ミ ッ ト に失敗し たチェ ンジ リ ス ト は、 問題を解決し た後、 割 り 当て られた番号で再度サブ

ミ ッ ト する必要があ り ます。

デフ ォル ト ・ チェ ンジ リ ス ト の処理中に p4 submit が失敗する と、 デフ ォル ト ・ チェ ンジ リ

ス ト にはチェ ンジ リ ス ト の次の続き番号が割 り 当て られ、 デフ ォル ト ・ チェ ンジ リ ス ト は空に

な り ます。 サブ ミ ッ ト に失敗し たチェ ンジ リ ス ト は、 問題を解決し た後、 割 り 当て られた番号

で再度サブ ミ ッ ト する必要があ り ます。

チェ ンジ リ ス ト の説明を コマン ド ラ イ ンか ら指定するには、 -d オプシ ョ ン を使用し ます。 説

明変更ダ イ ア ロ グは表示されません。 -d オプシ ョ ンはデフ ォル ト ・ チェ ンジ リ ス ト にのみ作

用し、 番号付チェ ンジ リ ス ト では機能し ません。

フ ォーム ・ フ ィ ールド

フ ィ ールド名 タ イプ 説明

Change: 読み取 り 専用 チェ ンジ番号またはデフ ォル ト ・ チェ ンジをサブ ミ ッ ト す

る場合は new。

Client: 読み取 り 専用 現在のク ラ イ アン ト ・ ワーク スペースの名前。

User: 読み取 り 専用 現在の PERFORCE ユーザの名前。

Status: 読み取 り 専用、

値

pending、submitted、 または new のいずれか。 ユーザは

編集でき ません。

チェ ンジ リ ス ト を作成し た と きは new、 チェ ンジ リ ス ト を

作成し たがまだ p4 submit でデ ィ ポにサブ ミ ッ ト し てい

ない と きは pending、 p4 submit でデ ィ ポ内にチェ ンジ

リ ス ト の内容を保存し た と きは submitted です。

Description: 書き込み可能 チェ ンジ リ ス ト のテキ ス ト によ る説明。 こ の値は変更され

なければな り ません。

Jobs: リ ス ト このチェ ンジ リ ス ト で修正されたジ ョ ブの一覧。

デフ ォル ト では、 p4 user フ ォームで指定 し たジ ョ ブ ・

ビ ュー基準に適合する ジ ョ ブが一覧表示されますが、 一覧

から削除する こ と も でき ます。適切なジ ョ ブがない場合、こ

のフ ィ ール ド は表示されません。

Type: 書き込み可能、

値

チェ ンジ リ ス ト のタ イプ ： restricted または public。

restricted タ イプの保留状態または確定済みのチェ ンジ リ ス

ト には、 チェ ンジ リ ス ト を所有し ていないユーザ、 または

チェ ン ジ リ ス ト 内の 1 つ以上のフ ァ イ ルに リ ス ト 権限を

持っ ていないユーザが ア ク セ ス す る こ と はで き ま せん。

restricted タ イプの作業中 ( 保留解除された ) チェ ンジ リ ス

ト には、 チェ ンジ リ ス ト の所有者でないユーザがア ク セス

する こ と はでき ません。public タ イプの変更にはこれらの制

限はな く 、 すべて表示されます。

Files: リ ス ト こ のチェ ンジ リ ス ト にサブ ミ ッ ト し よ う と し ている フ ァ イ

ルの一覧。 こ の一覧か ら フ ァ イルを削除し て も かまいませ

んが、 フ ァ イルの変更や追加はでき ません。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 231

p4 submit

オプシ ョ ン

-c changelist 番号が changelist であ るチェ ンジ リ ス ト をサブ ミ ッ ト し ます。

チェ ンジ リ ス ト への番号の割 り 当ては、p4 change によ り ユーザが手動で行

う か、 デフ ォル ト ・ チェ ンジ リ ス ト のサブ ミ ッ ト に失敗し た と きに PERFORCE

が自動で行 う かのいずれかです。

-e shelvedchange チェ ンジ リ ス ト 番号が shelvedchange であ る保留状態のチェ ンジ リ ス ト を

サブ ミ ッ ト し ます。

-e オプシ ョ ンを付ける と、 フ ァ イルの転送やワーク スペースの変更が行われ

ずに保留状態のチェ ンジ リ ス ト がサブ ミ ッ ト されます。 保留状態のチェ ンジ

リ ス ト はサブ ミ ッ ト 実行ユーザが所有し ている必要があ り ますが、 ワーク ス

ペースが異なっていて も構いません。 ス ト リ ーム ・ ターゲ ッ ト に保留された

フ ァ イルは、 ターゲ ッ ト ・ ス ト リ ームにマ ッ ピ ング された ス ト リ ーム ・ ワー

ク スペースによ ってのみサブ ミ ッ ト 可能です。 また、 ス ト リ ーム ・ ターゲ ッ

ト 以外に保留 さ れた フ ァ イ ルはス ト リ ーム ・ ワー ク スペース に よ っ てサブ

ミ ッ ト でき ません。

保留状態のチェ ンジリ ス ト をサブミ ッ ト する には、 そのチェ ンジリ ス ト 内にあ

る すべてのファ イ ルが 新であり 、 衝突解決さ れている 必要があり ま す。 どの

ワ ーク ス ペース においても 、 こ のファ イ ルは同じ 番号のチェ ンジリ ス ト 配下で

作業状態になっていないはずです。p4 client フォ ームの SubmitOptions: 設定（ revertunchanged など ) は無視さ れます。 サブミ ッ ト が成功する と 、

保留を解除し たり 、 改めてサブミ ッ ト する こ と はでき ません。

-d description コマン ド ラ イ ンから description を指定し てデフ ォル ト ・ チェ ンジ リ ス ト

をただちにサブ ミ ッ ト し、対話式のフ ォームを表示させません。 このオプシ ョ

ンはス ク リ プ ト 実行時に有用ですが、 ジ ョ ブの追加やデフ ォル ト ・ チェ ンジ

リ ス ト の修正はでき ません。

-f submitoption p4 client フ ォームでの [SubmitOptions:] の設定を上書き し ます。

有効な submitoption の値は以下の とお り です。

･ submitunchanged

すべての作業状態のフ ァ イル （変更の有無にかかわらず） がデ ィ ポにサブ

ミ ッ ト されます。 これは PERFORCE のデフ ォル ト の動作です。

･ submitunchanged+reopen

すべての作業状態のフ ァ イル （変更の有無にかかわらず） がデ ィ ポにサブ

ミ ッ ト され、 すべてのフ ァ イルが自動的にデフ ォル ト ・ チェ ンジ リ ス ト で

再度作業状態にされます。

･ revertunchanged

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ ポにサブ ミ ッ

ト されます。 未変更のフ ァ イルは元に戻し ます。

･ revertunchanged+reopen

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ ポにサブ ミ ッ

ト され、 デフ ォル ト ・ チェ ンジ リ ス ト で再度作業状態に されます。 未変更

のフ ァ イルは元に戻し ますが、 デフ ォル ト ・ チェ ンジ リ ス ト では作業状態

にされません。

･ leaveunchanged

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ ポにサブ ミ ッ

ト されます。 未変更のフ ァ イルはデフ ォル ト ・ チェ ンジ リ ス ト に移動され

ます。

･ leaveunchanged+reopen

内容またはフ ァ イルタ イプが変更されたフ ァ イルのみがデ ィ ポにサブ ミ ッ

ト されます。 未変更のフ ァ イルはデフ ォル ト ・ チェ ンジ リ ス ト に移動され、

変更済みのフ ァ イルはデフ ォル ト ・ チェ ンジ リ ス ト で再度作業状態に され

ます。 こ のオプシ ョ ンは submitunchanged+reopen と 似ていますが、

未変更のフ ァ イルはデ ィ ポにサブ ミ ッ ト されません。

232 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 submit

使用上の留意点

• デ ィ ポ内でのフ ァ イルの位置は、 p4 client フ ォーム内で設定される ク ラ イ アン ト ・ ビ ュー

に応じ て、 ワーク スペース内のフ ァ イル位置と の共通部分によ り 決ま り ます。

• p4 submit はチェ ンジ リ ス ト 単位で実行される ため、フ ァ イルを目的別にチェ ンジ リ ス ト に

グループ化する こ と ができ ます。 例えば、 1 つのチェ ンジ リ ス ト に、 1 つのバグを修正する

3 つのフ ァ イルへの変更を含ませる こ と ができ ます。

• 番号付きチェ ンジ リ ス ト と と もに p4 submit を使用する と、フ ォームが表示されません。番

号付 き チ ェ ン ジ リ ス ト に関す る コ メ ン ト の情報 を 変更す る には、 p4 change -c

changelist を使用し ます。

• デフ ォル ト ・ チェ ンジ リ ス ト の p4 submit に対するパラ メ ータ と し て、単一のフ ァ イル ・ パ

ターンを指定でき ます。 こ のフ ァ イル ・ パターンによ り 、 デフ ォル ト ・ チェ ンジ リ ス ト 内の

どのフ ァ イルをサブ ミ ッ ト に含めるかを限定し ます。 こ のフ ァ イル ・ パターンに適合し ない

フ ァ イルは、 次のデフ ォル ト ・ チェ ンジ リ ス ト に移されます。

p4 submit に対する フ ァ イル ・ パターンのパラ メ ータは、 デフ ォル ト ・ チェ ンジ リ ス ト をサ

ブ ミ ッ ト する と きのみ使用でき ます。

• p4 -I submit と し て実行する と、p4 submit コマン ド に進捗イ ンジケータが提供されます。

使用例

-i 標準入力からチェ ンジ リ ス ト 仕様を読み取 り ます。入力は、p4 submitフ ォー

ムで使用されている もの と同じ形式でなければな り ません。

-r 編集目的または追加目的の作業状態が、 サブ ミ ッ ト 後もデフ ォル ト ・ チェ ン

ジ リ ス ト において、 引き続き作業状態にな り ます。

-s こ のチェ ンジ リ ス ト のサブ ミ ッ ト 時に、 ジ ョ ブにデフ ォル ト の状態 closedではな く 、 任意の状態を割 り 当てます。 ジ ョ ブを未変更のま まにし てお く に

は、 特殊な状態であ る same を使用し ます。

新規のチェ ンジ リ ス ト では、 修正完了の状態 と し て ignore と い う 特殊な状

態が表示されます （状態が変更されなければ、 ジ ョ ブはチェ ンジ リ ス ト をサ

ブ ミ ッ ト し て も修正完了にな り ません）。

こ のオプシ ョ ンは、 p4 fix -s と合わせて動作し ます。 これは欠陥追跡シス

テム と連携し て使用する こ と を目的と し たオプシ ョ ンです。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださ い。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用不可 使用不可 write

p4 submit デフ ォル ト ・ チェ ンジ リ ス ト をサブ ミ ッ ト し ます。 こ のチェ ンジ リ ス ト 内の

フ ァ イルのユーザ ・ リ ビジ ョ ンは、 デ ィ ポ内に保存されます。

p4 submit -c 41 チェ ンジ リ ス ト 41 をサブ ミ ッ ト し ます。

p4 submit *.txt デフ ォル ト ・チェ ンジ リ ス ト 内で拡張子 .txt を持つフ ァ イルのみをサブ ミ ッ

ト し ます。 デフ ォル ト ・ チェ ンジ リ ス ト 内の他のフ ァ イルをすべて、 次のデ

フ ォル ト ・ チェ ンジ リ ス ト に移し ます。

p4 submit -d "header files" *.h

デフ ォル ト ・ チェ ンジ リ ス ト 内で拡張子 .h を持つフ ァ イルのみを "headerfiles" と い う コ メ ン ト を付けてサブ ミ ッ ト し ます。チェ ンジ リ ス ト ・ フ ォー

ムは表示されません。 デフ ォル ト ・ チェ ンジ リ ス ト 内の他のフ ァ イルをすべ

て、 次のデフ ォル ト ・ チェ ンジ リ ス ト に移し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 233

p4 submit

関連コ マン ド

新しい番号付きチェ ンジ リ ス ト を作成する。 p4 change

ク ラ イ アン ト ・ ワーク スペース内のフ ァ イルを作業状態にし、 それをチェ

ンジ リ ス ト に リ ス ト する。

p4 add

p4 edit

p4 delete

p4 integrate

フ ァ イルをあ るチェ ンジ リ ス ト から別のチェ ンジ リ ス ト に移す。 p4 reopen

あ る フ ァ イルをすべてのチェ ンジ リ ス ト か ら除去し、 そのフ ァ イルを以前

の状態に戻す。

p4 revert

あ る基準に適合するチェ ンジ リ ス ト の一覧を参照する。 p4 changes

あ るチェ ンジ リ ス ト の完全な記述を読み込む。 p4 describe

デ ィ ポ内のフ ァ イルを ク ラ イ アン ト ・ ワーク スペースに読み込む。 p4 sync

ク ラ イ アン ト ・ ワーク スペース内のフ ァ イル と、 デ ィ ポ内のフ ァ イル間の

マ ッ ピングを編集する。

p4 client

234 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 sync

p4 sync

概要

フ ァ イルをデ ィ ポから ワーク スペースにコ ピーし ます。

構文

p4 [g-opts] sync [-f][-L][-k][-n][-N][-q][-m max] [file[revRange]...] p4 [g-opts] sync [-L][-n][-N][-q][-s][-m max] [file[revRange]...] p4 [g-opts] sync [-L][-n][-N][-p][-q][-m max] [file[revRange]...]

解説

p4 sync は、 フ ァ イル ・ パターン引数に適合する フ ァ イルを、 デ ィ ポから ク ラ イ アン ト ・ ワー

ク スペースにコ ピーする こ と によ り 、ク ラ イ アン ト ・ ワーク スペース をデ ィ ポ と同期させます。

コマン ド ラ イ ンにフ ァ イル ・ パターンを指定し ない場合、 次の基準のすべてを満た し ている特

定のデ ィ ポ ・ フ ァ イルを コ ピーし ます。

• ク ラ イ アン ト ・ ビ ューを通し て見え る フ ァ イル

• p4 edit、 p4 delete、 p4 add、 または p4 integrate によ り 作業状態になっていないフ ァ

イル

• すでに ク ラ イ アン ト ・ ワーク スペース内に 後の リ ビジ ョ ン （ 新 リ ビジ ョ ン） と し て存在

し ていないフ ァ イル

新しい空のワーク スペースでは、すべてのデ ィ ポ・フ ァ イルが後の 2 つの基準に適合する ため、

ユーザのビ ューを通し て見る こ と のでき るすべてのフ ァ イルが、 ワーク スペースにコ ピーされ

ます。

コマン ド ラ イ ンでフ ァ イル ・ パターンを指定する と、 そのフ ァ イル ・ パターンに適合し、 かつ

上記の基準に適合する フ ァ イルのみがコ ピーされます。

フ ァ イル ・ パターンに リ ビジ ョ ン指定子が含まれている場合、 指定し た リ ビジ ョ ンが ク ラ イ ア

ン ト ・ ワーク スペースにコ ピーされます。

フ ァ イル引数に リ ビジ ョ ン範囲が含まれている場合、その リ ビジ ョ ン範囲によ って選択された

フ ァ イルのみが更新され、 範囲中で も大きい番号の リ ビジ ョ ンが使用されます。 フ ァ イル引

数に リ ビジ ョ ン範囲が含まれている場合、 も う ワーク スペース ・ ビ ュー内に存在し ないフ ァ イ

ルには影響し ません。

新し く 同期し たフ ァ イルは、 p4 edit か p4 delete によ り 作業状態にし ない限 り 、 編集目的

に使用でき ません。 新し く 同期し たフ ァ イルは読み取 り 専用で、 p4 edit か p4 delete によ

り フ ァ イルが書き込み可能にな り ます。フ ァ イルを書き込み可能にする と きは、通常 PERFORCE

の機能を使用し、 OS のコマン ド を使用し ないで く だ さい。

オプシ ョ ン

-f 同期を強制実行し ます。 すでに ク ラ イ アン ト ・ ワーク スペースに特定の リ ビジ ョ

ンのフ ァ イルがあった と し て も、 PERFORCE は同期を実行し ます。 フ ァ イルが書き

込み可能であって も、 そのフ ァ イルは上書き されます。

こ のオプシ ョ ンは、 作業状態のフ ァ イルには作用し ませんが、 ク ラ イ アン ト ・ オ

プシ ョ ン noclobber をオーバーラ イ ド し ます。

-k 既存のワーク スペース ・ フ ァ イルを保存し ます。 ク ラ イ アン ト ・ ワーク スペース

を更新せずに所有 リ ス ト を更新し ます。所有 リ ス ト を更新し て ク ラ イ アン ト ・ ワー

ク スペースの実状に一致させる必要があ る場合にのみ p4 sync -k を使用し て く

ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 235

p4 sync

使用上の留意点

• ワーク スペース ・ ビ ューが 後の同期から変更されている場合は、 次の同期の と きに、 ワー

ク スペース ・ ビ ューを通し て見えな く なっている （ リ ビジ ョ ン範囲が使用されていない場

合） フ ァ イルが ク ラ イ アン ト ・ ワーク スペースから削除され、 以前は見えなかったデ ィ ポ ・

フ ァ イルが ク ラ イ アン ト ・ ワーク スペースにコ ピーされます。

デフ ォル ト では、ワーク スペース内のデ ィ レ ク ト リ からからすべてのフ ァ イルが削除されて

もデ ィ レ ク ト リ 自体は削除されません。 同期する と きに空のデ ィ レ ク ト リ を削除するには、

p4 client フ ォーム内の rmdir オプシ ョ ンを有効にし ます。

• ユーザが、 PERFORCE の管理外で、 OS のコマン ド によ り いずれかのフ ァ イルを書き込み可能

にする と、通常 p4 sync はこれらのフ ァ イルを上書き し ません。ただし、 p4 client フ ォー

ムの clobber オプシ ョ ンが有効になっている場合は、 これらのフ ァ イルも上書き されます。

（パフ ォーマン スの負荷を 小にし て） この動作を避けるには、-s （「安全な同期」） オプシ ョ

ンを使用し ます。clobber オプシ ョ ンが設定されている場合で も、p4 sync -s は PERFORCE

の管理外で変更されたフ ァ イルを上書き し ません。

• p4 flush は p4 sync -k と同義です。p4 flush に適用されるすべての警告が p4 sync -k

に も当てはま り ます。

• 管理者が構成可能変数 zerosyncPrefix を設定し ている と、名前の始めに指定された接頭語

がつ く すべてのワーク スペースで、 sync -k が想定されます。

• -m maxオプシ ョ ンを-nオプシ ョ ン と組み合わせる と、効果的にス ク リ プ ト を作成するのに役

立ちます。 例えば、 p4 sync -n -m 1 のよ う なコマン ド はフ ァ イルの同期を行いませんが、

同期するべき フ ァ イルがあ る場合には出力に 1 行だけ表示され、 そ う でなければワーク ス

-L ス ク リ プ ト 作成時に用い られ、 完全なデ ィ ポ ・ シン タ ッ ク スで有効な リ ビジ ョ ン

番号 と と もに指定された有効なフ ァ イル引数 リ ス ト に対し て同期を実行し ます。

-m max 指定された max 個までのフ ァ イルのみを同期し ます。

-n 実際に同期を実行せずに、 同期の結果を表示し ます。

このオプシ ョ ンによ り 、 同期を実行する前に同期の結果を確認でき ます。

-N 同期に関係する想定ネ ッ ト ワーク ・ ト ラ フ ィ ッ ク の概要を、 同期を実行せずに表

示し ます。

これによ り 、 追加または更新される フ ァ イルの数、 多数の大きいフ ァ イルの処理

にはどち らが有用であ るか、 および / または帯域幅やデ ィ ス ク容量に制限があ る

かがわか り ます。

-p ク ラ イ アン ト ・ ワーク スペースにデータ を書き込みますが、 所有 リ ス ト を更新し

ません。 既に同期または作業状態にされたフ ァ イルは警告 メ ッ セージを出力し、処

理し ません。

こ のオプシ ョ ンは通常、 初回の同期後にワーク スペースの状態を追跡する必要の

ない （ビル ド 環境や公開用環境などの） プ ロ セスで使用される ワーク スペースに

使用されます。

-q ク ワ イエ ッ ト ・ モード : 通常の出力 メ ッ セージを抑止し ます。 エラーまたは例外的

な状態に関する メ ッ セージは抑止されません。

-s 安全な同期 ： ク ラ イ アン ト ・ ワーク スペースの内容を、 後に同期された内容 と

比較し ます。 PERFORCE の管理外でフ ァ イルが変更されていた場合、 エラー ・ メ ッ

セージが表示され、 フ ァ イルは上書き されません。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用可 使用可 read

236 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 sync

ペースが 新であ る こ と を示す メ ッ セージが表示されます。 -m 1 オプシ ョ ンを付けない場

合、 出力が数千行に達し てすべての行を破棄する こ と にな る可能性があ り ます。

• -L オプシ ョ ンは、 ス ク リ プ ト または自動レポー ト 処理で使用する こ と が意図されています。

フ ァ イル引数は完全なデ ィ ポ ・ シン タ ッ ク スで記述し、 有効な リ ビジ ョ ン番号を伴っていな

ければな り ません。 これらの必要条件を満た さ ないフ ァ イル指定は警告な く 無視されます。

• ク ラ イ アン ト ・ワーク スペースの Stream: フ ィ ール ド が有効なス ト リ ームに設定されている

ために ク ラ イ アン ト ・ ワー ク スペースが動的に生成さ れてい る場合に、 StreamAtChange:

フ ィ ール ド が特定のチェ ンジ リ ス ト 番号を指すよ う に設定されている と、p4 sync を引数な

し で実行し た場合、 その時点におけ る ス ト リ ーム仕様に対応する ク ラ イ アン ト ・ ワーク ス

ペース を使用し て、ワーク スペースはそのチェ ンジ リ ス ト の時点で提供されていたフ ァ イル

の リ ビジ ョ ンに同期されます。

• 信頼されていないネ ッ ト ワーク では、 再試行の回数と、 ネ ッ ト ワーク がタ イ ムア ウ ト し た も

の と PERFORCE アプ リ ケーシ ョ ンが想定する までの時間の長さ を指定する こ と ができ ます。

ワーク スペースの P4CONFIG フ ァ イルによ り 、 またはコマン ド ラ イ ンから コマン ド を 1 つず

つ実行し て net.maxwait を設定し、 -rN に再試行の回数を指定し ます。 ただし、 N は再接続を

試みる回数を示し ます。 例えば、

p4 -r3 -vnet.maxwait=60 sync

と い う コマン ド では、 ユーザのワーク スペースの同期を、 中断が起き た場合に 3 回まで再試

行し ます。 3 回目に 60 秒間でタ イ ムア ウ ト する と、 コマン ド は失敗し ます。

タ イ ムア ウ ト または再試行される コマン ド の出力形式は保証されない （例えば、 ネ ッ ト ワー

ク接続が出力行の途中で失われた場合など） こ と か ら、 標準入力を読み込むコ マン ド に -r

を使用するのは避けて く だ さい。

• p4 sync -N オプシ ョ ンは、 同期を実行する前に同期操作のネ ッ ト ワークへの影響を予測す

るのに便利です。 ク ラ イ アン ト ・ ワーク スペース ・ ビ ューを 近更新し た場合、 新し く 構成

されたワーク スペースに同期する前に、 何ギガバイ ト もの資産を含むフ ォルダ ・ ツ リ ーを不

用意に含めていないかを確かめる と効果的です。

• p4 -I sync -q と し て実行する と、 p4 sync コマン ド に進捗イ ンジケータが提供されます。

使用例

p4 sync ク ラ イ ア ン ト ・ ビ ューを通し てマ ッ ピ ン グ さ れた と お り

に、 すべてのフ ァ イルの 新 リ ビジ ョ ンを、 デ ィ ポから ク

ラ イ アン ト ・ ワーク スペースにコ ピーし ます。 そのフ ァ イ

ルがすでに ク ラ イ ア ン ト ・ ワー ク スペース で作業状態に

なっている場合や、そのフ ァ イルの 新 リ ビジ ョ ンが ク ラ

イ アン ト ・ ワーク スペースにあ る場合は、 コ ピーされませ

ん。

p4 sync file.c#4 file.c の 4 番目の リ ビジ ョ ンを ク ラ イ アン ト ・ ワーク ス

ペースにコ ピーし ます。 例外は上記と同じです。

p4 sync //depot/proj1/...@21 ク ラ イ ア ン ト ・ ビ ューを通し てマ ッ ピ ン グ さ れた と お り

に、 //depot/proj1 デ ィ レ ク ト リ 内の全フ ァ イ ル を、

デ ィ ポか ら ク ラ イ ア ン ト ・ ワー ク スペース に コ ピーし ま

す。 新 リ ビジ ョ ンはコ ピーし ないで、チェ ンジ リ ス ト 21

がサブ ミ ッ ト さ れた後、 デ ィ ポ内にあ る フ ァ イ ルの リ ビ

ジ ョ ンを使用し て く ださい。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 237

p4 sync

関連コ マン ド

p4 sync @labelname labelnameがp4 labelによ って作成された ラベルで、さ

らに p4 labelsync によ ってフ ァ イルが割 り 当て られて

いる場合、 labelname によ って特定されたフ ァ イルおよ

びその リ ビジ ョ ンが、 ワーク スペースにコ ピーされます。

ただし、 labelname に リ ス ト されている フ ァ イルであっ

て も、 ク ラ イ アン ト ・ ビ ューで選択されていないフ ァ イル

はコ ピーされません。

また、labelname に リ ス ト されていないフ ァ イルは、ワー

ク ス ペー ス か ら 削除 さ れ ま す。 （@labelname は、

labelname で指定された リ ビジ ョ ンを含め、 それまでの

すべての リ ビジ ョ ンを指し ます。 これには、 リ ス ト にない

フ ァ イルの存在し ない リ ビジ ョ ン も含みます。）

p4 sync @labelname,@labelname p4 sync @labelname と同様にラベルの内容を ワーク ス

ペースにコ ピーし ますが、 labelname に リ ス ト されてい

ないフ ァ イルは現状のま まです。

（ リ ビジ ョ ン範囲 @labelname,@labelname は、 ラベル

名そのもので指定された リ ビジ ョ ンだけを適用し ます。 リ

ス ト にないフ ァ イルの存在し ない リ ビジ ョ ンは、含みませ

ん。）

p4 sync @2011/06/24 2011 年 6 月 24 日 0:00 現在のデ ィ ポの内容を、 ワーク ス

ペースにコ ピーし ます。 （6 月 23 日に実施されたすべての

変更を含みます。）

p4 sync status%40june1st.txt 文字の 16 進値の ASCII 表現を使用し て、PERFORCE ワ イル

ド カード が含まれたフ ァ イル名を同期させます。 この例で

は、 ク ラ イ ア ン ト ・ ワ ー ク ス ペ ー ス 内 の フ ァ イ ル は

status@june1st.txt です。

詳細については、320 ページの「フ ァ イル名およびエンテ ィ

テ ィ に関する文字の制限」 をご覧 く ださい。

p4 sync file.c#none file.c の存在し ない リ ビジ ョ ンに同期し ます。 フ ァ イル

はワーク スペースから削除されます。

p4 sync ...#none すべてのフ ァ イルの存在し ない リ ビジ ョ ンに同期し ます。

ワーク スペース内のすべてのフ ァ イル （PERFORCE が制御

し ている フ ァ イル） は削除されます。

ク ラ イ アン ト ・ ワーク スペースにあ る フ ァ イルを作業状態にし、 それをチェ

ンジ リ ス ト に リ ス ト する。

p4 add

p4 edit

p4 delete

p4 integrate

ク ラ イ アン ト ・ ワーク スペースにあ る フ ァ イルに対する変更を、 デ ィ ポにコ

ピーする。

p4 submit

ク ラ イ アン ト ・ ワーク スペースに同期し たフ ァ イル と リ ビジ ョ ンの一覧を参

照する。

p4 have

238 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 tag

p4 tag

概要

フ ァ イルにラベルでタ グ付け し ます。

構文

p4 [g-opts] tag [ -d -n -U ] -l labelname file[revRange]...

解説

p4 tag を使用し て、 指定し たフ ァ イル ・ リ ビジ ョ ンに ラベルで タ グ付け し ます。 labelname

が必要です。labelname と い う 名前のラベルがない場合は、 その名前のラベルが自動的に作成

されます。 こ のラベルがすでに存在する場合、 そのラベルでフ ァ イルのタ グ付けまたはタ グ解

除を行 う には、 ユーザはそのラベルの Owner: でなければな らず、 ラベルは unlocked でなけ

ればな り ません ( ラベルの所有者やロ ッ ク ・ ステータ ス を変更するには、 p4 label を使用し

ます )。

file 引数に リ ビジ ョ ン指定が含まれていない場合は、 新 リ ビジ ョ ンが ラベルでタ グ付け さ

れます。 file 引数に リ ビジ ョ ン範囲指定が含まれている場合は、 その範囲の リ ビジ ョ ンを持つ

フ ァ イルだけがタ グ付け されます ( 指定し た範囲に 1 つのフ ァ イルの複数の リ ビジ ョ ンが存在

する場合は、 指定し た範囲で も大きい番号の リ ビジ ョ ンがタ グ付け されます )。

オプシ ョ ン

使用上の留意点

• デフ ォル ト では、 p4 tag は、 デ ィ ポ内のフ ァ イルの 新 リ ビジ ョ ンに対し て動作し ます。

ク ラ イ アン ト ・ ワーク スペースの状態を保存するには、 p4 labelsync を使用し ます。 こ の

コマン ド はク ラ イ アン ト ・ ワーク スペースに 後に同期されたフ ァ イルの リ ビジ ョ ンに対し

て動作し ます。

使用例

-d 指定し たフ ァ イルから ラベル ・ タ グを削除し ます。

-n 実際の操作を実行せずに、 p4 tag の動作内容を表示し ます。

-l labelname フ ァ イル ・ リ ビジ ョ ンに適用される ラベルを指定し ます。

-U フ ァ イルに新しいラベルを タ グ付けする と き、新し く 作成される ラベルに unloadオプシ ョ ン を設定し ます。 こ のオプシ ョ ンを既存の ラベルに使用し て も何の効果

も あ り ません。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用可 使用可 list

p4 tag -l rel1 //depot/1.0/... //depot/1.0/... 内のフ ァ イルの 新 リ ビジ ョ ンにラ

ベル rel1 でタ グ付け し ます。

ラベル rel1 が存在し ない場合は、 それを作成し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 239

p4 tag

関連コ マン ド

p4 tag -l build //depot/1.0/...@1234

//depot/1.0/... 内の フ ァ イ ルでチ ェ ン ジ リ ス ト

1234 のサブ ミ ッ ト 時点で も新し い リ ビジ ョ ンに ラベル

build でタ グ付け し ます。

ラベル build が存在し ない場合は、 それを作成し ます。

p4 files @labelname labelname でタ グ付け されたフ ァ イル ・ リ ビジ ョ ンを リ

ス ト し ます。

ラベルを作成または編集する。 p4 label

システムに認識されているすべてのラベルを リ ス ト する。 p4 labels

ク ラ イ アン ト ・ ワーク スペースの リ ビジ ョ ンにラベルでタ グ付けする。 p4 labelsync

240 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 tickets

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 241

p4 tickets

概要

p4 login によ ってユーザに許可されたすべてのチケ ッ ト を表示し ます。

構文

p4 [g-opts] tickets

解説

p4 tickets コマン ド は、 ユーザのチケ ッ ト ・ フ ァ イルに保存されているすべてのチケ ッ ト を

リ ス ト し ます。

オプシ ョ ン

使用上の留意点

• チケ ッ ト は環境変数P4TICKETSで指定し たフ ァ イルに保存されます。環境変数が設定されて

いない場合、 チケ ッ ト は Windows では %USERPROFILE%\p4tickets.txt、 その他の OS では

$HOME/.p4tickets に保存されます。

使用例

関連コ マン ド

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 な し

p4 tickets ユーザのローカル ・ チケ ッ ト ・ フ ァ イルに保存されたすべ

てのチケ ッ ト を表示し ます。

ロ グ イ ン ・ セ ッ シ ョ ンを開始する ( チケ ッ ト を取得する ため ) p4 login

ロ グ イ ン ・ セ ッ シ ョ ンを終了する ( チケ ッ ト を削除する ため ) p4 logout

p4 triggers

p4 triggers

概要

p4 triggers は、チェ ンジ リ ス ト のサブ ミ ッ ト やフ ォーム更新の都度、または PERFORCE を外部

の認証 メ カニズム と 統合する と きに条件に応じ て実行さ れる ス ク リ プ ト の リ ス ト を編集し ま

す。

構文

p4 [g-opts] triggersp4 [g-opts] triggers -ip4 [g-opts] triggers -o

解説

PERFORCE ト リ ガは、 ユーザが記述する ス ク リ プ ト であ り 、 特定の操作 ( チェ ンジ リ ス ト のサ

ブ ミ ッ ト やフ ォームの変更など ) が実行される たびに PERFORCE サーバによ って呼び出されま

す。 ス ク リ プ ト が値 0 を返すと操作は続行し、 他の値を返すと操作は失敗し ます。 失敗し た と

き、 ス ク リ プ ト の標準出力 （エ ラー出力ではあ り ません） は、 失敗し た操作のエ ラー ・ メ ッ

セージのテキス ト と し て使用されます。

PERFORCE は広範な ト リ ガ ・ タ イプをサポー ト し てお り 、 それらは 6 つのカテゴ リ に分類され

ます。

• チェ ンジ リ ス ト ・ サブ ミ ッ ト ・ ト リ ガ （change-submit、change-content、 および change-

commit） はユーザがチェ ンジ リ ス ト をサブ ミ ッ ト し た と きに起動されます。

• 保留 ト リ ガ （shelve-submit、 shelve-commit、 および shelve-delete） はチェ ンジ リ ス

ト ・ サブ ミ ッ ト ・ ト リ ガに似ていますが、 ユーザがフ ァ イルを保留し た と き または保留中の

フ ァ イルを削除し た と きに起動されます。

• 修正 ト リ ガ （fix-add および fix-delete） は、 p4 fix、 p4 submit、 または p4 change

コマン ド によ り チェ ンジ リ ス ト に修正を追加または削除し た と きに起動されます。

• フ ォーム ・ ト リ ガ （form-save、form-out、form-in、 form-commit、form-delete） は、ユー

ザがフ ォーム仕様のデータ を生成または変更し た と きに起動されます。

• 認証 ト リ ガ （auth-check、auth-check-sso、auth-set および service-check） は管理者が

PERFORCE を LDAP や Active Directory などの外部認証 メ カニズム と統合し よ う とする と きに

起動されます。

• アーカ イブ ・ ト リ ガ （archive） は PERFORCE の管理下にあ る レポジ ト リ の外でアーカ イブさ

れた内容を処理する ために使用されます。

change-submit ト リ ガ ・ タ イ プを使用し て、 チェ ンジ リ ス ト 作成の後、 フ ァ イルがサーバに

転送される前に起動する ト リ ガを作成し ます。 change-submit ト リ ガは、 フ ァ イルがサーバ

に転送される前に起動されるので、 フ ァ イルの内容にア ク セスでき ません。 サブ ミ ッ ト ・ ト リ

ガは、 システムフ ァ イルの内容にア ク セスする必要のないレポー ト ・ ツールやシステムによ る

反映操作で役に立ちます。

change-content ト リ ガ ・ タ イプを使用し て、 チェ ンジ リ ス ト 作成 と フ ァ イル転送の後、 デー

タベースにサブ ミ ッ ト を コ ミ ッ ト する前に、 起動される ト リ ガを作成し ます。

change-commit ト リ ガ ・ タ イプを使用し て、 チェ ンジ リ ス ト 作成、 フ ァ イル転送、 およびデー

タベースへのチェ ンジ リ ス ト のコ ミ ッ ト の後に起動される ト リ ガを作成し ます。チェ ンジ リ ス

ト のサブ ミ ッ ト の成功を前提とする ( または必要とする ) プロセスの場合は、コ ミ ッ ト ･ ト リ ガ

を使用し ます。

242 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 triggers

change-submit ト リ ガ ・ ス ク リ プ ト や change-content ト リ ガ ・ ス ク リ プ ト が成功し た場合

で も、 後続の ト リ ガ の失敗な ど が原因 と な っ て サブ ミ ッ ト が失敗す る こ と が あ り ま す。

change-submit ト リ ガおよび change-content ト リ ガは検証目的でのみ使用し、 サブ ミ ッ ト

の正常完了を条件 と する処理には change-commit ト リ ガ ま たはデーモン を使用し て く だ さ

い。

ユーザがジ ョ ブを修正し た と きに ト リ ガ ・ ス ク リ プ ト を実行する よ う PERFORCE を設定するに

は、 修正 ト リ ガを使用し ます。 修正 ト リ ガのタ イプは fix-add および fix-delete です。 修

正 ト リ ガを使用し て、ユーザが修正をチェ ンジ リ ス ト に追加または削除し た と きにコマン ド を

実行する こ と ができ ます。

ユーザが仕様フ ォームを編集し た と きに ト リ ガ ・ ス ク リ プ ト を実行する よ う PERFORCE を設定

するには、 フ ォーム ・ ト リ ガを使用し ます。 フ ォーム ・ ト リ ガのタ イプは form-save、 form-

in、 form-out、 form-commit、 form-delete です。 フ ォーム ・ ト リ ガを使用し て、 ユーザ用

にカ ス タ マ イ ズ さ れた仕様の値の生成、 フ ォーム でサブ ミ ッ ト さ れたデー タ の検証、 仕様

フ ォームに格納された値が変更される際の他ユーザへの通知、プロセス制御および管理ツール

と のや り 取 り を行 う こ と ができ ます。

外部パス ワード 認証管理システム （LDAP や Active Directory など） を PERFORCE のユーザに使

用する には、 認証 ト リ ガ (auth-check、 auth-check-sso お よび auth-set) を使用 し ます。

%user% 変数を使ってユーザ名を ス ク リ プ ト のコマン ド に渡し ます。 認証プロセスの一部 と し

てユーザに入力されたパス ワード は、 コマン ド ラ イ ン上ではな く 標準入力と し て認証ス ク リ プ

ト に渡されます。 詳し く は、 『システム管理者ガイ ド』 を参照し て く だ さい。

service-check ト リ ガはauth-check ト リ ガ と全 く 同様に動作し ますが、Type:がserviceに設

定されているユーザにのみ適用されます。service-check ト リ ガタ イプは、複製された別のマ

ルチサーバ環境にあ る他の PERFORCE サーバの認証に LDAP を使用し たい場合に、PERFORCE 管

理者が使用し ます。

アーカ イブ ・ ト リ ガ (archive) は特殊なケースで、 PERFORCE レポジ ト リ の外でアーカ イブさ

れた内容の保存、 管理または生成のために確保されています。

ト リ ガはテーブルに リ ス ト された順序で起動し ます。 ト リ ガ ・ ス ク リ プ ト が特定のタ イプに対

し て失敗する と、 そのタ イプに関連し ている後続の ト リ ガ ・ ス ク リ プ ト も起動し ません。

同じ ト リ ガ ・ ス ク リ プ ト を複数のフ ァ イル ・ パターンで使用するには、 ト リ ガ ・ テーブルに同

じ ト リ ガ ・ タ イプを複数 リ ス ト し ます。 除外マ ッ ピングを使用し て、 フ ァ イルが ト リ ガ ・ ス ク

リ プ ト を有効にするのを防ぎます。 この場合も、 除外マ ッ ピングをビ ュー内で使用する と き と

同様に、 ト リ ガ ・ エン ト リ の順序は重要です。 特定の ト リ ガの名前 と タ イプが複数 リ ス ト され

ている場合、その ト リ ガの名前と タ イプが 初に使用されている ス ク リ プ ト だけがア ク テ ィ ブ

にな り ます。

フ ォーム ・ フ ィ ールド

p4 triggers のフ ォームには、 ［Triggers:］ （ ト リ ガ ： ） フ ィ ール ド だけがあ り ます。

フ ォ ー ム を 使用す る すべて の PERFORCE コ マ ン ド と 同様に、 フ ィ ール ド 名 （こ の場合は

［Triggers:］ ） は左に揃え （イ ンデン ト し ない） 、 コ ロ ンで終えな く てはな り ません。 また、

フ ィ ール ド値 （つま り 、 各 ト リ ガにつき 1 行ずつ追加する行セ ッ ト ） はフ ィ ール ド名の下の行

に、 スペース またはタブでイ ンデン ト し て記述し なければな り ません。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 243

p4 triggers

p4 triggersフ ォームのTriggers:フ ィ ール ド の各行には値が4つあ り 、それらはname、type、

path、 および command です。

フ ィ ールド 意味

name ユーザ定義の ト リ ガ名。

連続する行に同一の ト リ ガ名があ る処理は、 複数の path が指定でき る よ う に単一の ト

リ ガ と し て扱われます。 この場合、 そのよ う な ト リ ガ行の 初の command のみが使用

されます。

type ト リ ガ ・ タ イプは 6 つのサブタ イプ （チェ ンジ リ ス ト ・ サブ ミ ッ ト ・ ト リ ガ、 保留 ト リ

ガ、修正 ト リ ガ、 フ ォーム ・ ト リ ガ、認証 ト リ ガ、アーカ イブ ・ ト リ ガ） に分類されます。

チェ ンジ リ ス ト ・ サブ ミ ッ ト ・ ト リ ガ

･ change-submit ： チェ ンジ リ ス ト の作成後、 フ ァ イル転送の前にチェ ンジ リ ス ト ・

ト リ ガを実行し ます。 ト リ ガはフ ァ イルの内容にア ク セスでき ません。

･ change-content ： チェ ンジ リ ス ト の作成およびフ ァ イルの転送後、 フ ァ イルのコ

ミ ッ ト 前にチェ ンジ リ ス ト ・ ト リ ガを実行し ます。

フ ァ イ ルの内容 を 取得す る には、 リ ビ ジ ョ ン 指定子 @=change （change は、

%changelist% 変数でス ク リ プ ト に渡される作業中チェ ンジ リ ス ト のチェ ンジ リ ス

ト 番号） を p4diff2、 p4 files、 p4 fstat、 p4 print などのコマン ド と と も

に使用し ます。

･ change-commit ： チェ ンジ リ ス ト 作成、 フ ァ イル転送、 およびフ ァ イル ・ コ ミ ッ ト

の後に、 チェ ンジ リ ス ト ・ ト リ ガを実行し ます。

保留 ト リ ガ

･ shelve-submit: チェ ンジ リ ス ト が作成されてフ ァ イルがロ ッ ク された後、 フ ァ イ

ル転送の前に、 保留前 ト リ ガを実行し ます。

･ shelve-commit: フ ァ イルが保留された後、 保留後 ト リ ガを実行し ます。

･ shelve-delete: 保留されたフ ァ イルを破棄する前に保留 ト リ ガを実行し ます。

修正 ト リ ガ

特殊変数 %jobs% を使用し て拡張が可能です。この変数は p4 fix コマン ド ラ イ ン （あ

るいは p4 change フ ォームや p4 submit フ ォームの [Jobs:] フ ィ ール ド） に リ ス

ト 表示されるすべてのジ ョ ブに対し て 1 つずつ引数を拡張し ます。 そのため、 ト リ ガ ・

ス ク リ プ ト に指定される 後の引数でなければな り ません。

･ fix-add ： 修正を追加する前に修正 ト リ ガを実行し ます。

･ fix-delete ： 削除を追加する前に修正 ト リ ガを実行し ます。

244 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 triggers

フ ォーム ・ ト リ ガ

･ form-save： フ ォームの内容が解析された後、その内容が PERFORCE データベースに

保存される前に、 フ ォーム ・ ト リ ガを実行し ます。 ト リ ガは、 %formfile% 変数で

指定されたフ ォームを変更でき ません。

･ form-out: エン ド ・ ユーザへのフ ォームの生成時にフ ォーム ・ ト リ ガを実行し ます。

ト リ ガはフ ォームを変更でき ます。

･ form-in: PERFORCE サーバによ って内容が解析され、 検証される前に、 編集済み

フ ォームに対し てフ ォーム・ ト リ ガを実行し ます。ト リ ガはフ ォームを変更でき ます。

･ form-delete: フ ォームの内容が解析された後、その内容が PERFORCE データベース

から削除される前に、 フ ォーム ・ ト リ ガを実行し ます。 ト リ ガはフ ォームを変更でき

ません。

･ form-commit: フ ォーム ・ ト リ ガがコ ミ ッ ト された後それを実行し、 ジ ョ ブ名、 日

付などの自動生成フ ィ ール ド へのア ク セス を有効に し ます。 ジ ョ ブ ・ フ ォームの場

合、 この ト リ ガは p4 fix コマン ド と同様 p4 job コマン ド で も実行されます （ス

テータ ス更新後）。 form-commit ト リ ガは p4 job によ って作成された新しいジ ョ

ブ名へのア ク セス権を持っています。 form-in ト リ ガ と form-save ト リ ガはジ ョ

ブ名が作成される前に実行されます。

ジ ョ ブ ・ フ ォームの場合、 こ の ト リ ガは p4 change コマン ド （ジ ョ ブがチェ ンジ リ

ス ト の [Jobs:] フ ィ ール ド の編集によ って追加または削除されている場合）、 およ

び p4 submit コマン ド （チェ ンジ リ ス ト の [Jobs:] フ ィ ール ド に存在するすべて

のジ ョ ブに対 し て） に よ っ て も 実行 さ れます。 こ れ ら の場合は、 ジ ョ ブの form-commit ト リ ガ ・ コマン ド ラ イ ンで特殊変数 %action% を使用し た拡張が可能です。

この ト リ ガはフ ォームを変更する こ と はでき ません。

チェ ンジ ・ フ ォームの場合、 form-commit ト リ ガは、 チェ ンジ リ ス ト に 1 つ以上の

ジ ョ ブが付加された状態でチェ ンジ リ ス ト が保存、 サブ ミ ッ ト 、 または更新された と

きにのみ実行されます。チェ ンジ リ ス ト に付加されたジ ョ ブが 1 つも ない と きは実行

されません。

アーカ イブ ・ ト リ ガ

･ archive: +X フ ァ イルタ イプ修飾子を含むフ ァ イルタ イプを持つフ ァ イルにユーザ

がア ク セス し た と きに、 ス ク リ プ ト を実行し ます。

このス ク リ プ ト は要求される フ ァ イル 1 個について 1 回実行されます。

read 処理の と き、 ス ク リ プ ト はユーザに対し フ ァ イルを標準出力へと 送信するべきで

す。 write 処理の と き、 ス ク リ プ ト は標準入力でフ ァ イルを受信し ます。

フ ィ ールド 意味

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 245

p4 triggers

認証 ト リ ガ ：

･ auth-check ： 認証チェ ッ ク ・ ト リ ガを実行し、 ロ グ イ ン時または新規パス ワード の

設定時にパス ワー ド を外部パス ワー ド 管理機構に対し て検証し ます。 auth-checkト リ ガが存在する場合、 認証は ト リ ガ ・ ス ク リ プ ト によ り 制御される ため、 PERFORCE

security 構成可能変数 （および関連するパス ワー ド の長さについての必要条件） は

無視されます。

･ auth-check-sso ： シングル ・ サイ ンオンのユーザ認証を容易にし ます。

･ ユーザの ク ラ イ アン ト ・ ワーク ス テーシ ョ ンにおいて、 ス ク リ プ ト （格納場所は

P4LOGINSSO 環境変数によ って指定） が実行され、 ユーザの資格証明または PER-

FORCE サーバによ り 検証可能なその他の情報が取得されます。

･ サーバでは、 ク ラ イ アン ト 側のス ク リ プ ト か ら の出力がサーバ側ス ク リ プ ト に標

準入力 と し て渡されます。 ト リ ガ ・ テーブルで指定されているサーバ側ス ク リ プ

ト が実行され、 成功時にはサーバがイ グジ ッ ト ・ ステータ ス 0 を返し ます。

･ auth-set ： 認証セ ッ ト ・ ト リ ガを実行し、 新規パス ワード を外部パス ワード管理機

構に送信し ます。

･ service-check: ト リ ガを実行し て、 標準ユーザではな く サービ ス ・ ユーザ ( また

はオペレータ・ユーザ) のパス ワード を検証し ます。service-check ト リ ガはauth-check ト リ ガ と同様に動作し ます。

auth-check ト リ ガまたはservice-check ト リ ガを追加し た ら、PERFORCEサーバを再

起動し なければな り ません。

path チェ ンジ リ ス ト ・ ト リ ガおよびシェルブ・ ト リ ガ (change-submit、change-content、

change-commit、 shelve-submit、 shelve-commit、 および shelve-delete) の

場合は、 デ ィ ポ ・ シン タ ッ ク スのフ ァ イル ・ パターンです。 このフ ァ イル ・ パターン と

一致する フ ァ イルが含まれているチェ ンジ リ ス ト をユーザがサブ ミ ッ ト し た と きに、 こ

の ト リ ガに リ ン ク されたス ク リ プ ト が実行されます。 除外マ ッ ピングを使用する と、 指

定し たフ ァ イルに対し て ト リ ガが実行されるのを防ぐ こ と ができ ます。

修正 ト リ ガ (fix-add または fix-delete) の場合は、 修正をパスの値と し て使用し ま

す。

フ ォーム ・ ト リ ガ (form-save、 form-out、 form-in、 form-commit または form-delete) の場合は、 フ ォームの タ イ プの名前 (branch、 change、 client、 depot、

group、 job、 label、 protect、 spec、 triggers、 typemap、 または user の う ち

どれか ) です。

認証 ト リ ガ (auth-check、 auth-check-sso、 auth-set または service-check )

の場合は、 path の値に auth を指定し て く ださい。

フ ィ ールド 意味

246 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 triggers

オプシ ョ ン

使用上の留意点

command 一致する path が ト リ ガ ・ タ イプに適用された と きに、 PERFORCE サーバが実行する コ

マン ド です。PERFORCE サーバのアカ ウ ン ト がコマン ド を見つけて実行でき る よ う に、コ

マン ド を指定し ます。 command （通常はス ク リ プ ト の呼び出し） は引用符で囲む必要

が あ り ま す。 引数は、 適用可能 な PERFORCE ト リ ガ の %variables% を 含め て、

command が解析可能な引数であれば、 どれでも使用する こ と ができ ます。

change-submit ト リ ガ と change-content ト リ ガの場合、 ト リ ガ ・ ス ク リ プ ト が 0

で終了し た と きはチェ ンジ リ ス ト のサブ ミ ッ ト が続行され、 ス ク リ プ ト がゼロ以外の値

で終了し た と きはチェ ンジ リ ス ト のサブ ミ ッ ト は失敗し ます。change-commit ト リ ガ

の場合、 ト リ ガ ・ ス ク リ プ ト の終了コード に関係な く チェ ンジ リ ス ト のサブ ミ ッ ト は成

功 し ます。 し か し、 ス ク リ プ ト がゼ ロ以外の値で終了 し た と き は、 後続の change-commit ト リ ガは起動し ません。

form-in ト リ ガ、 form-out ト リ ガ、 form-save ト リ ガ、 form-delete ト リ ガの場

合、 ス ク リ プ ト が 0 で終了し た と きに仕様内のデータが PERFORCE データベースに組み

込まれます。 ゼロ以外の値で終了し た と きは、 データベースは更新されません。

form-commit ト リ ガ ・ タ イプは絶対に変更を拒否し ません。 これは 初から存在する

ため、 ジ ョ ブ作成処理中にス ク リ プ ト がジ ョ ブ番号に (%formname% 値から ) ア ク セス

でき ます。

fix-add ト リ ガ と fix-delete ト リ ガでは、ト リ ガ・ス ク リ プ ト が 0 で終了し た場合は

修正の追加や削除が続行し、 ス ク リ プ ト がゼロ以外の値で終了し た と きは失敗し ます。

auth-check ト リ ガ と service-check ト リ ガ （それぞれ、標準 / オペレータ ・ユーザ

またはサービ ス / オペレータ ・ ユーザが p4 login によ り 起動） の場合、 ユーザが入力

し たパス ワード は標準入力から ト リ ガ ・ コマン ド に渡されます。 ト リ ガの実行に成功す

る と、 PERFORCE チケ ッ ト が発行されます。 ユーザ名はコマン ド ラ イ ンに %user% を渡

すこ と によ り 入手でき ます。

auth-check-sso （すべてのユーザに対する p4 login によ って起動） の場合、 ク ラ

イ アン ト 側ス ク リ プ ト の出力 （P4LOGINSSO によ り 指定） がサーバ側ス ク リ プ ト にク リ

アテキス ト で送られます。

auth-set ト リ ガ （p4 passwd によ り auth-check ト リ ガによ る検証成功後に起動）

の場合、 ユーザの古いパス ワー ド と 新し いパス ワー ド は標準入力で ト リ ガに渡さ れま

す。 ユーザ名はコマン ド ラ イ ンに %user% を渡すこ と によ り 入手でき ます。

-i エデ ィ タ を起動せずに、 標準入力から ト リ ガ ・ テーブルを読み取 り ます。

-o エデ ィ タ を起動せずに、 ト リ ガ ・ テーブルを標準出力に記述し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 super

警告 out ト リ ガでは、同じ out ト リ ガを起動する PERFORCE コマン ド を使用し ないで く ださ

い。 そのよ う な コマン ド を使用する と、 無限に反復する こ と にな り ます。 例えば、 job仕様に対し て起動する out ト リ ガ ・ ス ク リ プ ト 内か ら p4 job -o を実行し ないで く

ださ い。

警告 ト リ ガ ・ フ ォームか ら起動する ト リ ガが作成 さ れてお り 、 その ト リ ガが失敗し て p4triggers コマン ド が動作し な く なった場合、 回復させるにはサーバ ・ ルー ト ・ デ ィ レ

ク ト リ から db.triggers フ ァ イルを削除する しかあ り ません。

フ ィ ールド 意味

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 247

p4 triggers

• ト リ ガ ・ ス ク リ プ ト に引数を渡すには、 以下の変数を使用し ます。

警告 Name: フ ィ ール ド が p4sandbox- で始ま る ク ラ イ アン ト ・ワーク スペース仕様には（名

前または内容に） いかなる変更も行ってはな り ません。 P4Sandbox が共有レポジ ト リ

で正し く 動作し な く な り ます。

フ ォーム ・ ト リ ガの作成および管理に際し ては以下のこ と に注意し て く ださい。

･ P4Sandbox ク ラ イ アン ト 仕様の変更が可能なフ ォーム ・ ト リ ガ ・ ス ク リ プ ト を作成

し ないで く ださい。

･ P4Sandbox ク ラ イ アン ト 仕様の変更が可能なフ ォーム ・ ト リ ガ ・ ス ク リ プ ト が既に

あ る場合は、 この動作を行わないよ う にス ク リ プ ト を変更し なければな り ません。例

えば、%client% 変数がス ク リ プ ト に渡されたかを調べる ス ク リ プ ト を保守する と し

ま す。 ユーザの ク ラ イ ア ン ト ・ ワ ー ク ス ペー ス 仕様の Name: フ ィ ール ド が

p4sandbox-で始ま る場合、ト リ ガは次の う ちどち らかの動作を行わなければな り ま

せん。

･ p4sandbox- ワーク スペースに対し ては無条件に失敗する。これによ り 、当該サー

バでは、いずれのユーザに対し て も p4sandbox- のワーク スペースに対する処理

を禁止でき ます。

･ いかな る場合も、 ク ラ イ アン ト ・ ワーク スペース仕様を変更する こ と な く 成功す

る。 組織内のすべてのユーザは当該サーバを P4Sandbox の リ モー ト ・ デ ィ ポ と

し て使用でき ます。

詳し く は、 『Perforce サン ド ボ ッ ク ス ・ ユーザーズ ・ ガ イ ド』 の 「P4 サン ド ボ ッ ク スの

管理」 を参照し て く ださい。

引数 解説 使用可能な タ イプ

%action% チェ ンジ リ ス ト ま たはジ ョ ブに実行 さ れる ア ク シ ョ

ンを反映し ている、 ヌルまたは文字列。

例え ば、 “pending change 123 added” や

“submitted change 124 deleted” は change フ ォ ー ム で想定 さ れ る %action% の値で あ り 、

“job000123 created” や “job000123 edited” は job フ ォームで想定される %action% の値です。

form-commit

%changelist% %change%

サブ ミ ッ ト す る チ ェ ン ジ リ ス ト の番号。 短縮形の

%change% は %changelist% と同等です。

change-submit ト リ ガは作業中チェ ンジ リ ス ト 番

号を渡し ます。change-commit ト リ ガはコ ミ ッ ト さ

れたチェ ンジ リ ス ト 番号を受け取 り ます。

shelve-commit ト リ ガまたは shelve-delete トリ ガは、当該保留フ ァ イルがあ るチェ ンジ リ ス ト 番号を受け取 り ます。

change-submit、

change-content、

change-commitfix-add,fix-delete,form-commit,shelve-commitshelve-delete

%changeroot% サブ ミ ッ ト されたフ ァ イルのルー ト ・ パス change-commit

%client% ト リ ガを行 う ユーザの ク ラ イ アン ト ･ワーク スペース

名

archive を除 く すべて

%clienthost% ク ラ イ アン ト のホス ト 名（プロ キシ / ブローカ / レプ

リ カ経由で接続する場合も含む）

archive を除 く すべて

%clientip% ク ラ イ アン ト の IP ア ド レ ス （プロ キシ / ブローカ /

レプ リ カ経由で接続する場合も含む）

archive を除 く すべて

%clientprog% ク ラ イ アン ト ・ アプ リ ケーシ ョ ン名 archive を除 く すべて

%clientversion% ク ラ イ アン ト ・ アプ リ ケーシ ョ ンのバージ ョ ン archive を除 く すべて

%jobs% p4 fix コ マン ド で指定 さ れたジ ョ ブ番号ご と に、

または p4 submit フ ォームか p4 change フ ォーム

の [Jobs:] フ ィ ール ド に追加 （削除） されたジ ョ ブ

番号ご と に、引数を 1 つずつ拡張し たジ ョ ブ番号の文

字列。

fix-add,fix-delete

248 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 triggers

• ト リ ガ ・ ス ク リ プ ト がチェ ンジ リ ス ト 内のサブ ミ ッ ト された ( サブ ミ ッ ト される ) フ ァ イル

を認識する必要があ る場合は、 p4 opened -ac changelist を使用し ます。

%oldchangelist% サブ ミ ッ ト 時にチェ ンジ リ ス ト の番号が付け替え ら

れた場合、こ の値に古いチェ ンジ リ ス ト 番号が収めら

れます。

change-commit

%peerhost% プロ キシ、ブローカ、 またはレプ リ カによ ってコマン

ド が送信された場合、 プロ キシ、 ブローカ、 またはレ

プ リ カのホス ト 名 （コマン ド が直接送信された場合、

%peerhost% は %clienthost% と一致し ます）。

すべて

%peerip% プロ キシ、ブローカ、 またはレプ リ カによ ってコマン

ド が送信された場合、 プロ キシ、 ブローカ、 またはレ

プ リ カの IP ア ド レ ス （コマン ド が直接送信された場

合、 %peerip% は %clientip% と一致し ます）。

すべて

%serverAddress% PERFORCE サーバの IP ア ド レ ス と ポー ト 番号。

P4LOGINSSO によ って指定される ク ラ イ アン ト 側ス

ク リ プ ト のコ ンテキ ス ト においてのみ渡すこ と がで

き ます。ク ラ イ アン ト 側の認証ス ク リ プ ト に渡すこ と

ができ る唯一の変数です。

auth-check-sso（ク ラ イ アン ト 側ス ク リ

プ ト のみ）

%serverhost% PERFORCE サーバのホス ト 名 archive を除 く すべて

%serverip% サーバの IP ア ド レ ス archive を除 く すべて

%serverport% PERFORCE サーバの IP ア ド レ ス と ポー ト 。 形式は

ip_address:portarchive を除 く すべて

%serverroot% PERFORCE サーバの P4ROOT デ ィ レ ク ト リ archive を除 く すべて

%quote% 二重引用符 すべて

%user% ト リ ガを実行するユーザの PERFORCE ユーザ名 archive を除 く すべて

%formfile% 一時フ ォーム仕様フ ァ イルのパス。 in ト リ ガまたは

out ト リ ガか ら フ ォーム を変更するには、 こ のフ ァ

イルを上書き し ます。タ イプ が save または delete の ト リ ガの場合、 こ のフ ァ イルは読み取 り 専用です。

form-commit,form-save,form-inform-out,form-delete

%formname% フ ォームの名前 ( ブ ラ ンチ名やチェ ンジ リ ス ト 番号

など )

form-commit,form-save,form-inform-out,form-delete

%formtype% フ ォームのタ イプ (branch や change など ) form-commit,form-save,form-inform-out,form-delete

%op% 処理 :read、 write または delete archive

%file% デ ィ ポの Map: フ ィ ール ド に基づいたアーカ イ ブ ・

フ ァ イルのパス。

Map: フ ィ ール ド が P4ROOTからの相対パスであ る場

合、 %file% はサーバ側の P4ROOT からの相対パス

です。

Map: フ ィ ール ド が絶対パスであ る場合、 %file% は

サーバ側の絶対パスです。

archive

%rev% アーカ イブ･フ ァ イルの リ ビジ ョ ン archive

引数 解説 使用可能な タ イプ

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 249

p4 triggers

• サブ ミ ッ ト 前 ト リ ガ ・ ス ク リ プ ト は、 サブ ミ ッ ト 対象のフ ァ イルの内容にサーバから ア ク セ

スする こ と はでき ません。 これは、 サブ ミ ッ ト 前 ト リ ガの実行の時点では、 フ ァ イルの内容

はまだサーバに転送されていないためです。

• ト リ ガ ・ ス ク リ プ ト 内の PERFORCE コマン ド は、 常に特定の PERFORCE ユーザが実行し ます。

ユーザが指定されていない と、 SYSTEM と い う 名前のユーザ ( または、 UNIX 環境では、 p4d

プロセス を所有するユーザ ) のための PERFORCE ラ イセン スが余分に使用されます。 これを

防ぐには以下の操作を行います。

• 各 PERFORCE コマン ド を呼び出すス ク リ プ ト に %user% 引数を渡し て、 各コマン ド がそ

のユーザに よ っ て呼び出 さ れ る よ う にす る。 例えば、 Joe が、 ト リ ガ ・ ス ク リ プ ト

trigger.pl を実行するチェ ンジ リ ス ト をサブ ミ ッ ト し、trigger.pl が p4 changes コ

マン ド を呼び出す場合、こ のス ク リ プ ト はコマン ド を p4 -u %user% changes と し て実

行でき ます。

• ト リ ガ ・ ス ク リ プ ト を実行する アカ ウ ン ト の P4USER を、 既存ユーザの名前に設定する

（PERFORCE サーバが Windows 上に サー ビ ス と し て イ ン ス ト ール さ れ て い る 場合、

Windows サービ スは P4USER 値を持つこ と ができ ないので、 Windows 上で前述のよ う に

ユーザ値を各コマン ド に渡す必要があ り ます）。

• ト リ ガ ・ タ イプの名前は リ リ ース 2005.2 において変更されま し た。 以下に示す従来の ト リ

ガ ・ タ イプ名も依然 と し て機能し ますが、 推奨されません。

• リ リ ース 2007.3 の時点では、 ト リ ガの標準出力は ト リ ガ・ ス ク リ プ ト の成功時と失敗時に ク

ラ イ アン ト ・ プロ グ ラ ムに送られます。 それ以前は、 標準出力が ト リ ガの失敗時にのみク ラ

イ アン ト ・ プロ グ ラ ムに送られていま し た。

• サーバが Unicode モード で稼働し ていて、ト リ ガ・ス ク リ プ ト への引数を UTF8 で渡し ている

場合で も、 ト リ ガ ・ ス ク リ プ ト または実行可能フ ァ イルの名前は ASCII で指定する必要があ

り ます。

• 次 の よ う な 極 端 な 事 例 に も 注意 し て く だ さ い。 ク ラ イ ア ン ト ・ ワ ー ク ス ペ ー ス に

revertunchangedオプシ ョ ンが設定されている場合に、変更されたフ ァ イルのないチェ ンジ

リ ス ト に p4 submit を実行する と、 チェ ンジ リ ス ト はフ ァ イル内容と共にサブ ミ ッ ト され

ますが、 実際に確定される変更はあ り ません。 （つま り 、change-submit ト リ ガが起動され、

change-content ト リ ガが起動されますが、 change-commit ト リ ガは起動されません。）

• チェ ンジ リ ス ト の削除と保留領域の削除は同じ処理ではな く 、起動される ト リ ガ も同じでは

あ り ません。 ユーザが保留領域を削除す る と、 チ ェ ン ジ リ ス ト 番号は %change% 変数で

shelve-delete ト リ ガに渡されます。ユーザがチェ ンジ リ ス ト を削除する と、チェ ンジ リ ス

ト 番号は form-delete ト リ ガの %formname% 変数で取得でき ます。

使用例

従来の ト リ ガ ・ タ イプ 新しい ト リ ガ･タ イプ （2005.2 時点）

submit change-submit

content change-content

commit change-commit

out form-out

in form-in

save form-save

delete form-delete

250 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 triggers

ト リ ガ ・ テーブルが、 以下のエン ト リ で構成されている と仮定し ます。

イ ンデン ト に注意し て く だ さい。 Triggers: フ ィ ール ド の名前はイ ンデン ト されていません。

各行は 1 つ以上のスペースかタブでイ ンデン ト されています。

1 行目 と 3 行目は、 両方 と も ス ク リ プ ト /bin/s1.pl %changelist% を呼び出し ます。 初に

出現し た特定の ト リ ガ名が、それ以降にその ト リ ガ名が使用された と きに実行される ス ク リ プ

ト を決定するからです。

フ ァ イル //depot/dir/zebra がサブ ミ ッ ト された場合、 どの ト リ ガ も ア ク テ ィ ブにな り ませ

ん。3 行目で こ のフ ァ イルが除外されているから です。//depot/dir/zed がサブ ミ ッ ト された

場合は、trig1 のス ク リ プ ト /usr/bin/s1.pl %changelist% が実行されます。4 行目は 3 行

目をオーバーラ イ ド し ますが、 名前 trig1 に関連付け られている 初のス ク リ プ ト だけが呼

び出されます。

よ り 詳細な例については、 『システム管理者ガイ ド』 をご覧 く だ さい。

関連コ マン ド

Triggers: trig1 change-submit //depot/dir/... "/usr/bin/s1.pl %changelist%" trig2 change-submit //depot/dir/file "/usr/bin/s2.pl %user%" trig1 change-submit -//depot/dir/z* "/usr/bin/s1.pl %user%" trig1 change-submit //depot/dir/zed "/usr/bin/s3.pl %client%"

サブ ミ ッ ト し よ う と し ているチェ ンジ リ ス ト の情報を取得する。 p4 describe

p4 opened

デーモンの作成を支援する。 p4 review

p4 reviews

p4 counter

p4 counters

p4 user

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 251

p4 trust

252 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 trust

概要

PERFORCE サービ スに対し て SSL 接続の信頼性を確立し ます。

構文

p4 [-p port] trust [ -l -y -n -d -f -r -i fingerprint ]

解説

p4 trust を使用し て P4TRUST フ ァ イル（デフ ォル ト ではホーム・デ ィ レ ク ト リ の .p4trust）を

管理する こ と によ り 、 SSL 接続の信頼性を確立 （または管理） し ます。

ト ラ ス ト ・ フ ァ イルには SSL 接続用に受領し たキーのフ ィ ンガープ リ ン ト が含まれます。 ユー

ザが 初に PERFORCE サービ スに接続する と き、 フ ィ ンガープ リ ン ト の指定を求められます。

フ ィ ンガープ リ ン ト が正しい場合は p4 trust を使用し てサービ スのフ ィ ンガープ リ ン ト を自

分の ト ラ ス ト ・ フ ァ イルに追加する こ と がで き ます。 フ ィ ンガープ リ ン ト が変更さ れてい る

（または期限切れになっている） 場合、 それ以降サービ スに接続し よ う と する と 警告またはエ

ラーの メ ッ セージが出力されます。

SSL が有効に された PERFORCE サービ ス を P4TRUST フ ァ イルに追加し た後に初めて、P4PORT を

ssl:hostname:port に設定し てそ こ に接続する こ と が可能 と な り ます。

オプシ ョ ン

使用上の留意点

• PERFORCEサービ スによ って提供されたフ ィ ンガープ リ ン ト （またはフ ィ ンガープ リ ン ト への

変更） が正し いかど う かを確認する際は、 シ ス テム管理者にサポー ト し て も ら う と よ いで

し ょ う 。

-l こ のク ラ イ アン ト ・ワーク ステーシ ョ ンにおけるすべての既知のフ ィ ンガープ

リ ン ト を一覧表示し ます。

-y すべてのプロ ンプ ト に対し て自動的に受け入れます。

-n すべてのプロ ンプ ト に対し て自動的に拒否し ます。

-d 既存の信頼されたフ ィ ンガープ リ ン ト を削除し ます。

-f 一致し ないフ ィ ンガープ リ ン ト を強制的に置き換えます。

-i fingerprint 指定されたフ ィ ンガープ リ ン ト を イ ン ス ト ールし ます。

-r 置換フ ィ ンガープ リ ン ト を一覧表示、 イ ン ス ト ール、 または削除し ます。 あ る

接続に対し て置換フ ィ ンガープ リ ン ト が存在する場合に、主要フ ィ ンガープ リ

ン ト が一致し ない （が置換フ ィ ンガープ リ ン ト は一致する） 場合、 主要フ ィ ン

ガープ リ ン ト は置換フ ィ ンガープ リ ン ト に置き換え られます。このオプシ ョ ン

は、 -l、 -i、 または -d オプシ ョ ン と併用可能です。

-p フ ィ ン ガ ープ リ ン ト を チ ェ ッ ク ま た は取得す る 対象 と な る サー ビ ス の

P4PORT 設定。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

適用外 適用外 none

p4 typemap

p4 typemap

概要

p4 typemap は、 フ ァ イル名を フ ァ イルタ イプにマ ッ ピング し ている テーブルを修正し ます。

構文

p4 [g-opts] typemapp4 [g-opts] typemap -ip4 [g-opts] typemap -o

解説

p4 typemap コマン ド によ り 、PERFORCE 管理者は、PERFORCE フ ァ イルタ イプを フ ァ イル指定に

リ ン クする テーブルを設定でき ます。 フ ァ イル名がタ イプマ ッ プ ・ テーブル中のエン ト リ に適

合する場合、 こ のコマン ド は、 フ ァ イル名に適合する フ ァ イルタ イプがない と きに PERFORCE

が割 り 当て る フ ァ イルタ イプをオーバーラ イ ド し ます。

デフ ォル ト では、 PERFORCE はフ ァ イルの先頭の 65536 バイ ト の分析に基づいて、 フ ァ イルの

タ イプがテキス ト なのかバイナ リ なのかを自動的に判別し ます。先頭の 65536 バイ ト の各バイ

ト で 上位ビ ッ ト が 0 の場合、 PERFORCE はこのフ ァ イルタ イプをテキ ス ト とみな し、 そ う で

なければバイナ リ とみな し ます。.zip 形式 (.jar フ ァ イルを含む ) で圧縮されたフ ァ イルも自

動的に検出され、 ubinary タ イプが割 り 当て られます。

こ のデフ ォル ト の動作は、 -t filetype オプシ ョ ンを使用すればオーバーラ イ ド でき ますが、

こ の事実はよ く 見落 と されます。 フ ァ イルタ イプが通常は （常にではあ り ません） 正確に検出

される場合において、特にそ う です。典型的な例は、PDF フ ァ イル （65536 バイ ト 以上の ASCII

コ メ ン ト で始ま る ものがあ り ます） や、 通常は書式コード が埋め込まれている RTF フ ァ イル

の場合に見られます。

p4 typemap コマン ド は、 よ り 完全な解決策を提供し ます。 このコマン ド で管理者は、 特定の

フ ァ イル （例えば名前が .pdf や .rtf で終わる フ ァ イル） がデ ィ ポに追加される と き、 デフ ォ

ル ト のタ イプ検出機構が働かないよ う にし、 常に希望する PERFORCE フ ァ イルタ イプが確実に

割 り 当て られる よ う にする こ と ができ ます。

ユーザは、 PERFORCE のコマン ド ラ イ ンでフ ァ イルタ イプを明確に指定する こ と によ り 、 タ イ

プマ ッ プ ・ テーブルで定義されたあ らゆる フ ァ イルタ イプ ・ マ ッ ピングをオーバーラ イ ド でき

ます。

フ ォーム ・ フ ィ ールド

p4 typemap のフ ォームには ［TypeMap:］ フ ィ ール ド だけがあ り 、 こ のフ ィ ール ド には、 デ ィ

ポ ・ シン タ ッ ク スで指定されたフ ァ イルにフ ァ イルタ イプを リ ン クする値が含まれます。

列 説明

filetype 有効な PERFORCE フ ァ イルタ イプ。

有効なフ ァ イルタ イプの リ ス ト については、 「フ ァ イルタ イプ」 のセ ク シ ョ ンをご覧

く ださ い。

pattern デ ィ ポ ・ シン タ ッ ク スのフ ァ イルパターン。 ユーザが こ のパターンに適合する フ ァ

イルを追加する と、 そのデフ ォル ト のフ ァ イルタ イ プはテーブルで指定されたフ ァ

イルタ イプ と な り ます。フ ァ イルを タ イプマ ッ プから除外するには、排他(-pattern)

マ ッ ピングを使用し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 253

p4 typemap

オプシ ョ ン

使用上の留意点

• 希望するサブデ ィ レ ク ト リ またはその配下にあって、特定の拡張子を持つすべてのフ ァ イル

を指定するには、 デ ィ レ ク ト リ 名に続けてピ リ オ ド を 4 個使用し、 その後に拡張子を付けま

す （例えば、 //path/....ext）。 初の 3 つのピ リ オ ド は 「こ のレベル以下にあ るすべての

フ ァ イル」 を指定し ます。 4 番目のピ リ オ ド と付属の拡張子は、 「これらの文字で終わる」 と

解析されます。

• タ イ プマ ッ プ ・ テーブルでは、 フ ァ イルタ イ プ修飾子を使用で き ます。 有効な用途 と し て

は、 デ ィ レ ク ト リ ・ ツ リ ー全体にわた る キーワード拡張を強制的にオン／オフする と か、 元

のフ ァ イルの更新時刻 （+m フ ァ イルタ イプ修飾子） をサード パーテ ィ 製 DLL のデ ィ レ ク ト

リ に強制的に保存する、 またはペシ ミ ステ ィ ッ ク ・ ロ ッ キングのポ リ シーを採用する場合、

などがあ り ます。

• 複数のフ ァ イルタ イプ修飾子は続けて指定し て く だ さい。例えば、binary+lFS10 とする と、

binary タ イプで排他的作業状態 (l) であ り 、圧縮されずに完全な形で格納され (F) 、 新の 10

リ ビジ ョ ンのみが保存されている (S10) フ ァ イルを意味し ます。 構文について さ らに詳し く

は、 「フ ァ イルタ イプ」 のセ ク シ ョ ンを参照し て く だ さい。

• -t オプシ ョ ン と フ ァ イルタ イプ修飾子を使用し てコマン ド ラ イ ンでフ ァ イルタ イプを指定

する場合、 参照し ている フ ァ イルが p4 typemap マ ッ ピングの対象になっていれば、 コマン

ド ラ イ ンで指定し たフ ァ イルタ イプは、 タ イプマ ッ プ ・ テーブルで指定し たフ ァ イルタ イプ

をオーバーラ イ ド し ます。

使用例

PERFORCE サービ スに、すべての PDF および RTF フ ァ イルをバイナ リ とみなすよ う 通知するに

は、 p4 typemap を実行し て タ イプマ ッ プ ・ テーブルを以下のよ う に変更し ます。

指定子中の 初の 3 個のピ リ オ ド （「...」） は、 ルー ト ・ デ ィ レ ク ト リ 配下のすべてのフ ァ イ

ルがマ ッ ピングの一部に含まれる こ と を規定する PERFORCE ワ イル ド カー ド です。 4 個目のピ

リ オ ド と フ ァ イルの拡張子は、 この指定子が “.pdf” （または “.rtf” ） で終わる フ ァ イルに

適用される こ と を規定し ています。

サイ ト によ っては、 よ り 複雑な状況が発生する こ と も あ り ます。 例えば、 デ ィ ポ内のあ るエ リ

アにいるユーザが、 文書を収録し ているプレーンな ASCII テキ ス ト ・ フ ァ イルに拡張子 .doc

を使用する一方で、 別のエ リ アで作業し ているユーザが、 人気ワープロ ・ ソ フ ト で使用されて

-i エデ ィ タ を起動せずに、 標準入力から タ イプマ ッ プ ・ テーブルを読み取 り ます。

-o エデ ィ タ を起動せずに、 標準出力にタ イプマ ッ プ ・ テーブルを記述し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 admin、も し く は -o オプシ ョ ンを

使用する場合は list

Typemap: binary //....pdf binary //....rtf

254 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 typemap

いるバイナ リ ・ フ ァ イル形式でフ ァ イルを参照する ために .doc を使用する、 と いった状況で

す。 このよ う な状況で有効な タ イプマ ッ プ ・ テーブルは、 次のよ う にな り ます。

すべての .c および .h フ ァ イルについてキーワード 拡張を有効にし、 一方、 自分の .txt フ ァ

イルについてはキーワード拡張を無効にするには、 次のよ う にし ます。

指定し たデ ィ レ ク ト リ 内のフ ァ イルに、 確実に元のフ ァ イルの修正時刻を （サブ ミ ッ ト の日付

に関係な く ） 保存させるには、 次のよ う にし ます。

bin デ ィ レ ク ト リ やその配下にあ るすべてのフ ァ イルに、タ イプ binary が割 り 当て られます。

後 の マ ッ ピ ン グ が 前 の マ ッ ピ ン グ を オ ー バ ー ラ イ ド す る の で、 サ ブ デ ィ レ ク ト リ

bin/thirdpartydll内のフ ァ イルには、タ イプbinaryではな く タ イプbinary+mが割 り 当て ら

れます。 +m （修正時刻） フ ァ イルタ イプ修飾子について詳し く は、 「フ ァ イルタ イプ」 のセ ク

シ ョ ンをご覧 く だ さい。

デフ ォル ト では、 PERFORCE は同時並行開発をサポー ト し ていますが、 フ ァ イルを編集のため

に作業状態にするのは一度に 1 人のユーザだけであ る こ と が想定される環境では、部分フ ァ イ

ルタ イプで修飾子 +l （排他的作業状態） を使用し てペシ ミ ステ ィ ッ ク ・ ロ ッ キングを実施す

る こ と ができ ます。次のよ う に [typemap:] を定義する と、+l 修飾子がデ ィ ポ内にあ るすべて

の新規追加されたフ ァ イルに対し自動的に適用されます。

関連コ マン ド

Typemap: text //depot/dev_projects/....doc binary //depot/corporate/annual_reports/....doc

Typemap: text+k //depot/dev_projects/main/src/....c text+k //depot/dev_projects/main/src/....h text //depot/dev_projects/main/src/....txt

Typemap: binary //depot/dev_projects/main/bin/... binary+m //depot/dev_projects/main/bin/thirdpartydll/...

Typemap: +l //depot/...

タ イプマ ッ プ ・ テーブルをオーバーラ イ ド し て、 新し いフ ァ イルを

特定のタ イプで追加する。

p4 add -t type file

タ イプマ ッ プ ・ テーブルのあ ら ゆ る設定をオーバーラ イ ド し て、 作

業状態にあ る フ ァ イルのフ ァ イルタ イプを変更する。

p4 reopen -t type file

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 255

p4 unload

p4 unload

概要

ワーク スペース、 ラベル、 またはタ ス ク ・ ス ト リ ームを、 アン ロード ・ デ ィ ポにアン ロード し

ます。

構文

p4 [g-opts] unload [-f -L -z] [-c workspace] | [-l label | -s stream] p4 [g-opts] unload [-f -L -z] [-a|-al|-ac] [-d date | -u user]

解説

p4 unloadコマン ド は、使用頻度の低い メ タデータ をバージ ョ ン化エンジンのdb.*フ ァ イルか

ら アン ロード ・ デ ィ ポ内のフ ラ ッ ト ・ フ ァ イル群に転送し ます。 メ タデータ をアン ロードする

と、 バージ ョ ン化エンジンに必要と される作業データのサイ ズが減少し、 過去何年分もの メ タ

データ を持つ大規模なサイ ト において大幅にパフ ォーマン ス を向上させる こ と ができ ます。

p4 clients、 p4 labels、 p4 files、 p4 sizes、 p4 fstat などの PERFORCE コマン ド は、 ア

ン ロー ド された メ タデータ を無視し ます。 （アン ロー ド された メ タデータ を見るには、 これら

のコマン ド に -U オプシ ョ ンを使用し て く だ さ い。） PERFORCE のレポー ト ・ コマン ド を使用す

るユーザのほ と んどは、目的のデータの上位集合を取得し た後に自動または手動での後処理を

使用し て、 出力内の不要な行を破棄する こ と を意図し ている で し ょ う 。 例えば、 p4 clients

コマン ド （引数な しで実行） は、 現在および過去に組織に属するすべての従業員 （10 年前に退

職し た と し て も） によ って これまでに作成された、 すべての ク ラ イ アン ト ・ ワーク スペースの

名前を返し ます。 使われな く なった メ タデータ をアン ロードする こ と は、 コマン ド ラ イ ン ・ ク

エ リ の出力だけではな く 、 P4V などのアプ リ ケーシ ョ ンに表示される情報量において も、 ユー

ザに高い S/N 比を も た らすために良い方法です。

-c オプシ ョ ンおよび -l オプシ ョ ンを使用する と、特定の ク ラ イ アン ト ・ワーク スペース または

ラベルをアン ロード でき ます。 デフ ォル ト では、 ユーザは自分が所有する ワーク スペース また

はラベルしかアン ロード でき ません。 管理者は -f オプシ ョ ンを使用し て、 他のユーザが所有

する ワーク スペースおよびラベルをアン ロード でき ます。

-a、-al、または -ac オプシ ョ ンを使用する と、すべての指定された ラベルおよび / またはク ラ

イ アン ト ・ ワーク スペースがアン ロード対象と な り ます。

-d dateおよび/ または-u userオプシ ョ ンを使用する と、アン ロー ド操作の対象は特定の日付

date よ り も古いか、 特定のユーザ user が所有し ているか、 またはその両条件に該当する ラベ

ルおよび / またはワーク スペースに限定されます。

-L オプシ ョ ンを使用する と、ロ ッ ク されたワーク スペースおよび / またはラベルがアン ロード

されます。 デフ ォル ト では、 ロ ッ ク が解除された ラベルまたはワーク スペースのみがアン ロー

ド されます。

ワーク スペースのア ク セス日付は、そのワーク スペース を直接参照する コマン ド によ ってワー

ク スペースが使用される たびに更新されます。 同様に、 ラベルのア ク セス日付は、 そのラベル

を直接参照する コ マン ド に よ って ラベルが使用さ れる たびに更新さ れます。 ま た、 ワー ク ス

ペースのア ク セス日付はそのワーク スペースが @workspace の形式で リ ビジ ョ ン指定子に使用

された と きに も更新され、 ラベルのア ク セス日付はその ラベルが @labelname の形式で リ ビ

ジ ョ ン指定子に使用された と きにも更新されます。

デフ ォル ト では、アン ロード ・デ ィ ポ内のデータは圧縮されません。圧縮形式で保存するには、

-z オプシ ョ ンを使用し て く だ さい。 アン ロード された メ タデータは多 く の場合、圧縮し た方が

はるかに効率的です。 その特性と し て、 1 回のビル ド に使用された後はほ と んどあ るいは全 く

256 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 unload

ア ク セス される こ と のない何百万個ものビル ド関連のワーク スペースやラベルが存在する、連

続稼動のビル ド 環境については特にそれが言えます。

オプシ ョ ン

使用上の留意点

• ワーク スペース またはラベルのアン ロー ド を行 う には、ユーザがワーク スペースの have リ ス

ト にあ るすべてのフ ァ イルおよび/ またはラベルによ って タ グ付け されている フ ァ イルを ス

キ ャ ンする こ と が可能でなければな り ません。 管理者は （ p4 group フ ォームにおいて）

MaxScanRowsおよびMaxResults を十分な大き さの値に設定し て、ユーザが p4 unload また

は p4 reload の操作にサポー ト を要求せずに済むよ う にするべきです。

関連コ マン ド

-c workspace 指定された ク ラ イ アン ト ・ ワーク スペースの メ タデータ を db.have （および関連

テーブル） から アン ロード し、 それをアン ロード ・ デ ィ ポに格納し ます。

-l label 指定された ラベルを db.label （および関連テーブル） か ら アン ロー ド し、 それ

をアン ロード ・ デ ィ ポに格納し ます。

-s stream 指定された タ ス ク ・ ス ト リ ームをアン ロード し ます。 （stream は task タ イプで

あ る必要があ り ます。）

-d date 指定された日付よ り も古い メ タデータ をアン ロード し ます。

-u user 指定されたユーザが所有する メ タデータ をアン ロード し ます。

-f 強制オプシ ョ ン。 管理者は他のユーザが所有する ワーク スペース、 ラベル、 または

タ ス ク ・ ス ト リ ームのアン ロード が可能です。

-L ロ ッ ク されたワーク スペース、 ラベル、 またはタ ス ク ・ ス ト リ ームをアン ロード し

ます。

-z アン ロード されたワーク スペース、 ラベル、 またはタ ス ク ・ ス ト リ ームを圧縮形式

で格納し ます。

-a 適用されるすべてのク ラ イ アン ト ・ワーク スペースおよびラベルをアン ロード し ま

す。 -d、 -u、 または -d と -u の両方のオプシ ョ ンを必要 と し ます。 このオプシ ョ

ンはタ ス ク ・ ス ト リ ームには影響し ません。

-ac ク ラ イ アン ト ・ ワーク スペース をアン ロード し ます。 -d、 -u、 または -d と -u の

両方のオプシ ョ ンを必要と し ます。

-al ラベルをアン ロード し ます。 -d、 -u、 または -d と -u の両方のオプシ ョ ンを必要

と し ます。

g-opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に

リ ビジ ョ ン指定子を使えるか ?

フ ァ イル引数に

リ ビジ ョ ン範囲を使えるか ?

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

使用不可 使用不可 writeadmin

アン ロード ・ デ ィ ポからデータ を リ ロード し ます。 p4 reload

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 257

p4 unlock

258 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 unlock

概要

p4 unlock は、 フ ァ イルのロ ッ ク を解除し ます。

構文

p4 [g-opts] unlock [-c changelist | -s shelvedchange ] [-f] file...

解説

p4 unlock コマン ド は、 p4 lock で生成し た ロ ッ ク を解除し ます。

フ ァ イルがデフ ォル ト ・チェ ンジ リ ス ト 以外の作業中チェ ンジ リ ス ト で作業状態になっている

場合、 その作業中チェ ンジ リ ス ト を指定するには -c オプシ ョ ンが必要です。 チェ ンジ リ ス ト

を指定し ない と、p4 unlock はデフ ォル ト ・ チェ ンジ リ ス ト にあ る フ ァ イルのロ ッ ク を解除し

ます。

管理者は、 -f オプシ ョ ンを使用する こ と によ って、 別のユーザが作業状態にし たフ ァ イルの

ロ ッ ク を強制的に解除する こ と ができ ます。

フ ァ イル名を入力し ない場合は、指定し たチェ ンジ リ ス ト 中のすべてのフ ァ イルのロ ッ ク が解

除されます。

オプシ ョ ン

使用上の留意点

関連コ マン ド

-c changelist 作業中チェ ンジ リ ス ト changelist にあ る フ ァ イルのロ ッ ク を解除し ま

す。 このオプシ ョ ンは、 p4 lock によ って ロ ッ ク されたか、 保留状態でな

いチ ェ ン ジ リ ス ト のサブ ミ ッ ト 処理の失敗に よ り ロ ッ ク さ れた、 作業中

チェ ンジ リ ス ト 内の作業状態のフ ァ イルに適用されます。

-s shelvedchange 保留状態の作業中チェ ンジ リ ス ト 内でフ ァ イルが ロ ッ ク さ れてい る場合、

ロ ッ ク を解除し てそれを shelvedchange に格納し ます。 通常、 こ のよ う

な こ と が起こ り 得るのは p4 submit -e コ マン ド が中止さ れた場合のみ

です。

-f スーパー ・ ユーザまたは管理者のみが使用でき る強制オプシ ョ ンで、 これ

によ り スーパー ・ ユーザは他のユーザによ って作業状態に されたフ ァ イル

のロ ッ ク を解除でき ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用不可 使用不可 write

他のユーザがサブ ミ ッ ト で き ない よ う にフ ァ イ ルを ロ ッ ク

する。

p4 lock

作業状態でロ ッ ク中のフ ァ イルを表示する。 （UNIX） p4 opened | grep "*locked*"

p4 unshelve

p4 unshelve

概要

保留されたフ ァ イルを作業中チェ ンジ リ ス ト から ワーク スペースに復元し ます。

構文

p4 [g-opts] unshelve -s changelist [-f] [-n] [-c changelist] [-b branch | -S stream] [file

...]

解説

p4 unshelve コマン ド は、作業中チェ ンジ リ ス ト に保留されている フ ァ イルを、実行ユーザの

ワーク スペースにあ る作業中チェ ンジ リ ス ト へ と取得し ます。保留されたフ ァ イルへの作業中

チェ ンジ リ ス ト からのア ク セスは、 フ ァ イルに対するユーザのパー ミ ッ シ ョ ンによ り 制御され

ます。

フ ァ イル ・ パターンを指定する こ と によ り 、 保留を解除する フ ァ イルを制限でき ます。

保留解除を実行する と、保留状態のフ ァ イルはそれらが保留された と きの状態でユーザのワー

ク スペースにコ ピーされます。 （例えば、 保留時に編集目的で作業状態に されていたフ ァ イル

は、保留解除を実行するユーザのワーク スペースにおいて も編集目的で作業状態にされます。）

オプシ ョ ン

使用上の留意点

• 既に作業状態に されている フ ァ イルに対する保留解除は、保留状態のフ ァ イル と作業状態の

フ ァ イルが両方 と も編集目的で作業状態に されている場合にのみ許可されます。 （保留解除

後、 ワーク スペースのフ ァ イルには衝突解決が未実行であ る こ と を示す印が付け られ、 サブ

ミ ッ ト する か再度保留する前に、 p4 resolve を実行し て保留状態のフ ァ イ ル と ワー ク ス

ペースのフ ァ イル と の相違を解決し なければな り ません。）

-s changelist 保留された元のフ ァ イルを含む作業中チェ ンジ リ ス ト の番号を指定し ます。

-c changelist 保留解除し たフ ァ イルの取得先 と な る、 実行ユーザのワーク スペースのチェ ン

ジ リ ス ト 番号を指定し ます。 デフ ォル ト では、 p4 unshelve はデフ ォル ト ・

チェ ンジ リ ス ト にフ ァ イルを取得し ます。

-b branch 保留解除の前に、 保留されたフ ァ イルがマ ッ ピ ング されるブ ラ ンチ仕様を指定

し ます。 こ のオプシ ョ ンによ って、 あ るブ ラ ンチではフ ァ イルを保留し、 別の

ブラ ンチでは保留解除する こ と が可能です。

-S stream ス ト リ ーム由来のブ ラ ンチ ・ ビ ューを使用し て、 指定されたス ト リ ーム と その

親ス ト リ ームの間で保留フ ァ イルをマ ッ ピ ングする こ と を指定し ます。 あ る ス

ト リ ームではフ ァ イルを保留し、 別の関連ス ト リ ームでは保留解除する こ と が

可能です。

-f 保留解除の実行中に、 書き込み可能な （ただし作業状態でない） フ ァ イルを強

制的に上書き し ます。

-n フ ァ イ ルを実際に ワー ク スペース に復元せずに、 保留解除の操作結果をプ レ

ビ ューし ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用可 使用可 open

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 259

p4 unshelve

関連コ マン ド

フ ァ イルをサブ ミ ッ ト する こ と な く 、 作業中チェ ンジ リ ス ト からデ ィ ポ

に復元する。

p4 shelve

260 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 update

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 261

p4 update

概要

前回の同期処理後に変更されたフ ァ イルを上書きせずに、 ク ラ イ アン ト ・ ワーク スペース を更

新し ます。

構文

p4 [g-opts] update [-L] [-n] [-q] [file[revRange]...]

解説

p4 update は p4 sync -s と同様に機能し ます。

オプシ ョ ン

使用上の留意点

• p4 update は p4 sync -s と同様に機能し ます。

関連コ マン ド

-L ス ク リ プ ト 作成時に用いられ、 完全なデ ィ ポ ・ シン タ ッ ク スで有効な リ ビジ ョ ン番

号と と もに指定された有効なフ ァ イル引数 リ ス ト に対し て更新を実行し ます。

-n 実際に更新を実行せずに、 更新の結果を表示し ます。 こ のオプシ ョ ンによ り 、 更新

を実行する前に更新処理によ って望みどお り の結果が得られるかを確認でき ます。

-q ク ワ イエ ッ ト ・ モード : 通常の出力 メ ッ セージを抑止し ます。 エラーまたは例外的

な状態に関する メ ッ セージは抑止されません。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用可 使用可 read

p4 update は p4 sync -s と同様に機能する。 p4 sync -s

フ ァ イルをデ ィ ポから ク ラ イ アン ト ・ ワーク スペースにコ ピーする。 p4 sync

p4 user

p4 user

概要

p4 user は、 PERFORCE ユーザの仕様および基本設定の作成または編集を行います。

構文

p4 [g-opts] user [-f] [username]p4 [g-opts] user -d [-f] usernamep4 [g-opts] user -o [username]p4 [g-opts] user -i [-f]

解説

p4 user コマン ド は、ユーザ設定の編集や新しいユーザ・ レ コード の作成に使用でき ます。( デ

フ ォ ル ト では、 新 し いユーザは自動的に作成 さ れ ます。 PERFORCE を イ ン ス ト ール し た後、

PERFORCE スーパー ・ ユーザが p4 configure コマン ド を使用し て この動作を制御でき ます。 )

PERFORCE ユーザには、 標準 (standard) ユーザ、 オペレータ (operator) ・ ユーザ、 およびサー

ビ ス (service) ・ ユーザの 3 種類があ り ます。 標準ユーザはデフ ォル ト のユーザであ り 、 標準

ユーザはそれぞれ 1 つずつ PERFORCE ラ イセン ス を消費し ます。 オペレータ ・ ユーザ ・ タ イプ

はシステム管理者が使用する ための ものです。それらは他のユーザ と同様のパー ミ ッ シ ョ ン制

限が課されますが、 PERFORCE コマン ド の一部しか実行する こ と ができ ない と い う 点で さ らに

制限されます。 サービ ス ・ ユーザは、 複製環境およびマルチサーバ環境におけるサーバ間通信

に使用される もので、 さ らに少数の PERFORCE コマン ド しか使用でき ません。オペレータ ・ユー

ザ と サービ ス ・ ユーザはどち ら も PERFORCE ラ イセン ス を消費し ません。

p4 user を username な しで実行する と、現在のユーザの仕様を編集し ます。username を指定

し て実行し た場合は、 ユーザ仕様は表示されますが変更はでき ません。 P4EDITOR 環境変数ま

たはレジス ト リ 変数で定義し たエデ ィ タにフ ォームが表示されます。

PERFORCE スーパー ・ ユーザであれば、 新規のユーザを作成し た り 、 -f （強制） オプシ ョ ンを使

用し て他のユーザの仕様を編集し た り する こ と ができ ます。 その場合の構文は p4 user -f username です。

PERFORCE コマン ド を発行するユーザ と、 コマン ド実行の名義者 と な るユーザ と は、 必ずし も

同じではあ り ません。 特定のコマン ド を実行するユーザは、 以下のよ う に決定されます。

• コマン ド を実行するユーザが PERFORCE スーパー ・ ユーザであ り 、 かつ構文 p4 user -f

username を使用する場合は、 ユーザ username が編集されます。

• コマン ド ラ イ ンで -u usernameオプシ ョ ンが使用される場合（例えば、p4 -u joe submit）、

コマン ド は該当ユーザ名で実行されます （パス ワード が必要にな る場合も あ り ます）。

• コマン ド ラ イ ンで -u usernameオプシ ョ ンが使用されない場合で も、環境変数またはレジス

ト リ 変数 P4CONFIG によ って指定される フ ァ イル中に P4USER の設定があれば、 コマン ド は

該当ユーザ名で実行されます。

• -u username オプシ ョ ン も使用されず、 フ ァ イルも指定されていない場合で も、 環境変数

P4USER が設定されていれば、 コマン ド は該当ユーザ名で実行し ます。

• 上記のどれも当てはま ら ない場合、ユーザ名はOS レベルの環境変数USERまたはUSERNAMEか

ら取 り 込まれます。

262 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 user

フ ォーム ・ フ ィ ールド

オプシ ョ ン

使用上の留意点

• スーパー・ ユーザ以外のユーザは、-d オプシ ョ ンを使用し て、p4 user コマン ド を起動し た

ユーザの仕様のみを削除する こ と がで き ます。 PERFORCE スーパー ・ ユーザは、 あ ら ゆ る

PERFORCE ユーザを削除でき ます。

• 指定し たユーザがフ ァ イルを作業状態にし ている場合、 そのユーザの削除は失敗し ます。 作

業状態にあ る フ ァ イルをサブ ミ ッ ト し てから、 または元に戻し てから、 ユーザを削除し て く

ださい。

• デフ ォル ト では、 ユーザ記録はパス ワード な しで作成されるので、 どの PERFORCE ユーザも

p4 user を設定するか、 グ ローバル ・ オプシ ョ ン -u を使用する こ と によ り 、 他のユーザ と

し て操作を行 う こ と がで き ます。 自分の名前を他のユーザが使用する のを防ぐ ために、 p4

passwd コマン ド を使用し てパス ワード を設定し ます。

パス ワード の作成、 編集、 および変更は、 p4 user フ ォームで行 う こ と も、 p4 passwd コマ

ン ド を使用し て行 う こ と もでき ます。p4 user フ ォームでのパス ワード の設定は、 セキ ュ リ

テ ィ ・ レベル 0 または 1 のみでサポー ト されます。 p4 passwd では任意のセキ ュ リ テ ィ ・

レベルでパス ワード を設定する こ と ができ ます。 よ り 高いセキ ュ リ テ ィ ・ レベルでパス ワー

フ ィ ールド名 タ イプ 説明

User: 読み取 り 専用 p4 user を起動し た PERFORCE ユーザ名。 デフ ォル ト は、 シス

テムで使用されているユーザ名です。

Type: 書き込み可能 ユーザのタ イプ ： standard、 operator または service。

Email: 書き込み可能 ユーザの電子 メ ールア ド レ ス。デフ ォル ト は user@client で

す。

Update: 読み取 り 専用 この仕様が 後に更新された日時。

Access: 読み取 り 専用 このユーザが 後に PERFORCE コマン ド を実行し た日時。

FullName: 書き込み可能 ユーザのフルネーム。

JobView: 書き込み可能 すべての新し いチェ ンジ リ ス ト に自動的に表示 さ れる ジ ョ ブ

の説明。 （詳し く は下記 「使用上の留意点」 をご覧 く ださい。）

Password: 書き込み可能 ユーザのパス ワー ド。 （詳し く は下記 「使用上の留意点」 をご

覧 く ださい。）

PasswordChange: 読み取 り 専用 ユーザが 後にパス ワード を変更し た日付と時刻。ユーザにパ

ス ワード がない場合、 このフ ィ ール ド は空白です。

Reviews: 書 き 込み可能

リ ス ト

ユーザが参照し たいフ ァ イルの リ ス ト 。 （詳し く は下記 「使用

上の留意点」 をご覧 く ださい。）

-d username 指定し たユーザを削除し ます。ユーザ username または PERFORCE スーパー・ ユー

ザのみが、 このコマン ド を実行でき ます。

-f スーパー ・ ユーザのみが使用でき る強制オプシ ョ ンで、 これによ り スーパー ・ ユー

ザは指定し たユーザの修正や削除、 または 終更新日の変更が行えます。

-i 標準入力からユーザ仕様を読み取 り ます。入力は p4 user フ ォームの形式に従っ

ている必要があ り ます。

-o ユーザ仕様を標準出力に記述し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 list

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 263

p4 user

ド を設定するには、p4 passwd を使用する必要があ り ます。 各種のセキ ュ リ テ ィ ・ レベルの

詳細については、 『システム管理者ガイ ド』 をご覧 く だ さい。

p4 user のフ ォームでパス ワード を編集する場合、パス ワー ド内にコ メ ン ト 文字 # を使用し

ないで く だ さい。 PERFORCE は、 同じ行にあ る、 この文字に続 く すべてを コ メ ン ト とみな し、

パス ワード の一部と し ては保存し ません。

• パス ワード は、その長さ に関係な く 、p4 user フ ォームに 6 つのアス タ リ ス ク と し て表示さ

れます。

• チケ ッ ト ・ ベースの認証 ( 詳細は 「p4 login」 を参照 ) を使用し ている場合は、 ユーザがパ

ス ワード を変更する と、そのユーザに対し て発行されているすべてのチケ ッ ト が自動的に無

効にな り ます。

• 各ユーザの ［Email:］ （電子 メ ール ： ） フ ィ ール ド の値は p4 users コマン ド で一覧表示で

き、 あ ら ゆる目的に使用でき ます。

• PERFORCE チェ ンジ・レ ビ ュー・デーモンで使用される p4 reviews コマン ド は、［ Reviews:］

（レ ビ ュー：） フ ィ ール ド の値を使用し ます。 このデーモンは、ユーザが ［ Reviews:］ フ ィ ー

ル ド で指定し たフ ァ イルが変更さ れる たびに、 該当ユーザに電子 メ ールを送 り ます。 こ の

フ ィ ール ド に リ ス ト する フ ァ イルは、 デ ィ ポ ・ シン タ ッ ク スで指定される必要があ り ます。

例えば、 ユーザであ る ジ ョ ーの ［Reviews:］ フ ィ ール ド の値が次のよ う になっている と し

ます。

//depot/main/...//depot/.../README

こ の場合、 チェ ンジ ・ レ ビ ュー ・ デーモンは、 README フ ァ イルがサブ ミ ッ ト される たびに、

また、 //depot/main 配下のフ ァ イルがサブ ミ ッ ト される たびに、 ジ ョ ーに電子 メ ールを送

り ます。

• PERFORCE チェ ンジ ・ レ ビ ュー ・ デーモンで使用される、 ジ ョ ブ ・ レ ビ ューの特別な設定があ

り ます。 ［Reviews:］ フ ィ ール ド の値が次のよ う になっている場合、 ジ ョ ブが変更される た

びに、 該当ユーザに電子 メ ールを送 り ます。

//depot/jobs

• ［Jobview:］ フ ィ ール ド に有効なジ ョ ブ ・ ビ ューを設定する と、 該当ユーザが作成する どの

チェ ンジ リ ス ト に も、 そのジ ョ ブ ・ ビ ューに適合する ジ ョ ブが表示されます。 そのチェ ンジ

リ ス ト で修正される ジ ョ ブは、p4 submit でチェ ンジ リ ス ト がサブ ミ ッ ト される と きにチェ

ンジ リ ス ト に残っていなければな らず、他のジ ョ ブはサブ ミ ッ ト の前にフ ォームから削除さ

れなければな り ません。

例えば、 サイ ト のジ ョ ブに ［Owned-By:］ （所有者 ： ） と い う フ ィ ール ド があ る と し ます。 こ

の場合、ユーザは p4 user の ［Jobview:］ フ ィ ール ド を Owned-By=yourname&status=open

と設定し ます。 これで、 該当ユーザが所有し ているすべての作業中ジ ョ ブが、 ユーザが作成

するすべてのチェ ンジ リ ス ト に表示される よ う にな り ます。 ジ ョ ブ ・ ビ ューの使用方法や構

文について、 詳し く は p4 jobs のセ ク シ ョ ンをご覧 く だ さい。

• オペレータは（super 権限または admin 権限を持っている場合で も）、ソ フ ト ウ ェ ア開発やバー

ジ ョ ン化されたサービ ス上のその他の資産ではな く 、 PERFORCE サービ スの保守に関し て責

任があ る システム管理者に設定されるユーザです。オペレータは以下のコマン ド しか実行す

る こ と ができ ません。

• p4 admin stop

• p4 admin restart

• p4 admin checkpoint

• p4 admin journal

• p4 counter

264 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 user

• p4 counters

• p4 dbstat

• p4 dbverify

• p4 diskspace

• p4 configure

• p4 counter (-f を含む )

• p4 counters

• p4 journaldbchecksums

• p4 jobs (-R を含む )

• p4 login

• p4 logout

• p4 logappend

• p4 logparse

• p4 logrotate

• p4 logschema

• p4 logstat

• p4 logtail

• p4 logstat

• p4 lockstat

• p4 monitor

• p4 passwd

• p4 ping

• p4 server

• p4 serverid

• p4 verify

• p4 user

• サービ ス ・ ユーザは複製環境で使用され、 以下のコマン ド しか実行する こ と ができ ません。

• p4 dbschema

• p4 export

• p4 login

• p4 logout

• p4 passwd

• p4 info

• p4 user

使用例

p4 user joe PERFORCE ユーザ joe のユーザ仕様を参照し ます。

p4 user 現在の PERFORCE ユーザのユーザ仕様を編集し ます。

p4 user -d sammy PERFORCE ユーザ sammy のユーザ仕様を削除し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 265

p4 user

関連コ マン ド

p4 -u joe -P hey submit heyと い う パス ワード を持つユーザ joeと し て、 p4 submitを実

行し ます。

このコマン ド は、 高いセキ ュ リ テ ィ ・ レベルでは機能し ません。

p4 user -f joe2 も し、 これが PERFORCE スーパー・ユーザによ る実行で、かつ joe2が PERFORCE ユーザ と し て存在し ていなければ、 joe2 と い う 名前

のユーザを新規に作成し ます。joe2 が存在し ていれば、スーパー・

ユーザはこのユーザの設定を変更する こ と ができ ます。

すべての PERFORCE ユーザの リ ス ト を参照する。 p4 users

ユーザのパス ワード を変更する。 p4 passwd

特定フ ァ イルのレ ビ ューを予約し ているユーザの リ ス ト を参照する。 p4 reviews

構成可能変数 dm.user.noautocreate の変更によ り 、 新しいユーザの作成方法を制御する。

p4 configure

266 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 users

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 267

p4 users

概要

p4 users は、 現在の PERFORCE サービ スが認識し ているすべてのユーザを一覧表示し ます。

構文

p4 [g-opts] users [-l] [-a] [-r | -c] [-m max ] [user...]

解説

p4 users は、現在の PERFORCE サービ スが認識し ているすべてのユーザを一覧表示し ます。各

ユーザについて表示される情報には、 ユーザの PERFORCE ユーザ名、 電子 メ ール ・ ア ド レ ス、

本名、 およびユーザが 後にサービ スにア ク セス し た日時が含まれています。

引数 user を指定し た場合は、 そのユーザのみが表示されます。 引数 user は、 ワ イル ド カー

ド 「*」 を含むこ と ができ ます。 こ の場合、 指定し たパターンに適合するすべてのユーザにつ

いてレポー ト されます。（ワ イル ド カード を使用する場合は、 ワ イル ド カード がカレ ン ト ・デ ィ

レ ク ト リ 内のフ ァ イル名に合致する よ う 、 OS がワ イル ド カー ド を展開し よ う と し ますので、

必ず引数 user に引用符を付けて く だ さい。）

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

オプシ ョ ン

使用上の留意点

• -c または -r を使用するにはレプ リ カ・サーバに接続し ている必要があ り 、-c オプシ ョ ン と -

r オプシ ョ ンを同時に使用する こ と はでき ません。

• 構成可能変数 run.users.authorize が 1 に設定されている場合、 p4 users コマン ド を実

行する ためにはユーザ自身が PERFORCE サービ スに対し て認証される必要があ り ます。

関連コ マン ド

-m max max 個までのユーザのみを一覧表示し ます。

-l ロ グ イ ン情報 : 該当情報があ る場合、 パス ワード の 終更新時刻と ロ グ イ ン ・ チケ ッ ト の

有効期限を表示し ます。 PERFORCE スーパーユーザでなければこ のオプシ ョ ンは使用でき

ません。

-a サービ ス ・ ユーザを リ ス ト に含めます。

-r レプ リ カ ・ サーバについて、 こ のレプ リ カ ・ サーバを使用し たユーザのみが報告されます。

-c レプ リ カ ・ サーバについて、 マス ター ・ サーバからのユーザ情報のみが報告されます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

適用外 適用外 list

特定ユーザに関する情報を追加または編集する。 p4 user

現在のク ラ イ アン ト ・ ワーク スペースに関する情報を編集する。 p4 client

p4 verify

p4 verify

概要

p4 verify は、 PERFORCE バージ ョ ン化サービ ス ・ アーカ イブの正当性を検証し ます。

構文

p4 [g-opts] verify [-m maxRevs] [-q] [-t|-u|-v|-z] [-X] [-b batch] file[revRange]...p4 [g-opts] verify -U unloadfile...

解説

p4 verify は、リ ビジ ョ ン指定情報および リ ビジ ョ ン内容のMD5ダ イ ジェ ス ト （指紋） を レポー

ト し ます。

デフ ォル ト では、 p4 verify は各 リ ビジ ョ ンの MD5 ダ イ ジ ェ ス ト を計算し て表示し ます。 あ

る リ ビジ ョ ンがアーカ イブから失われてお り 、 し たがって再現でき ない場合、 その リ ビジ ョ ン

の出力行は MISSING! で終わ り ます。 ま た、 ダ イ ジ ェ ス ト に差異があ る場合、 破損し ている

フ ァ イルの出力行は BAD! で終わ り ます。

複製環境では、 p4 verify -t によ り BAD! または MISSING! のフ ァ イルは行末に (transfer

scheduled) を付けて報告されます。

オプシ ョ ン

-q 出力を抑制し て実行し ます。 以前に生成された MD5 ダ イ ジェ ス ト に対し てフ ァ イ

ルの正当性を検証し、 エラーがあ る場合にのみ出力を表示し ます。

-t レプ リ カを動作させている と き、 p4 verify -t を実行する と、 レプ リ カは破損

または失われた リ ビジ ョ ンの内容の転送を スケジュールし ます。

-u 以前にフ ァ イ ルサ イ ズ と ダ イ ジ ェ ス ト が保存 さ れた こ と がない場合にのみ、 各

フ ァ イルのフ ァ イルサイ ズ と MD5 ダ イ ジェ ス ト を PERFORCE データベースに保存

し ます。 以後 p4 verify を使用する と、 p4 verify で計算し た値と保存済みの

値 と を比較し ます。

-v 各フ ァ イルの MD5 ダ イ ジェ ス ト を PERFORCE データベースに保存し ます。該当フ ァ

イルの保存済みダ イ ジ ェ ス ト があ る場合で も、 その既存ダ イ ジ ェ ス ト に上書き し

ます。 （-v オプシ ョ ンは、 PERFORCE システム管理者によ って PERFORCE の制御範

囲外で故意に変更されたアーカ イ ブ ・ フ ァ イルの保存済みダ イ ジ ェ ス ト を更新す

る目的でのみ使用されます。）

-z 現在のパスで既に計算済みであ る リ ビジ ョ ンを ス キ ッ プ し ます。 こ のオプシ ョ ン

によ り 、遅延コ ピー と し て存在する リ ビジ ョ ンに対する検証が高速化されます。 こ

のオプシ ョ ンは、 -v または -u と同時に使用でき ません。

-b batchsize デフ ォル ト では、p4 verifyは一度に 10000 個のフ ァ イルをバッチで処理し ます。

このバッチ ・ サイ ズは -b batchsize オプシ ョ ンで変更可能です。 バッチによ る

処理を無効にするには、 -b 0 を指定し ます。 -z オプシ ョ ンが指定されている と、

-b オプシ ョ ンは無視され、 すべてのオプシ ョ ンが 1 つのバッチで処理されます。

-X フ ァ イルタ イプが +X であ る フ ァ イル （サービ スが archive ト リ ガを実行） を ス

キ ッ プし ます。）

-U unloadfile アン ロード ・ デ ィ ポ内のフ ァ イルを検証し ます。 詳し く は、 p4 unload を参照し

て く ださい。

-m maxRevs p4 verify の対象 と なる リ ビジ ョ ン数を maxRevs に制限し ます。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

268 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 verify

使用上の留意点

• p4 verify がエラーを返し た と きは、 PERFORCE の技術サポー ト にご連絡 く だ さい。

• p4 verify -qz //... を実行し て定期的にデ ィ ポの正当性を検証する こ と は、 よい管理方

法です。

詳し く は、 『システム管理者ガイ ド』 をご覧 く だ さい。

• リ リ ース 2005.1 では PERFORCE はフ ァ イル長の メ タデータ を リ ビジ ョ ン毎に追跡し ます。新

規にフ ァ イルがサブ ミ ッ ト される と、フ ァ イル長の メ タデータが自動的にデータベースに追

加されます。 （2005.1 にア ッ プグレー ド後も、 少な く と も 1 度は p4 verify -u を実行し、

フ ァ イル長が保存されていない 2005.1 よ り 前のフ ァ イルについてフ ァ イル長の メ タデータ

を更新し なければな り ません。）

大規模なサイ ト （ リ ビジ ョ ン数が一千万を超え る規模） では、 2005.1 にア ッ プグレード し た

直後、管理者が一度にレポジ ト リ 全体のフ ァ イル長 メ タデータ を更新し よ う とする と メ モ リ

の制限をオーバーし て し ま う こ と があ り ます。このよ う な場合は -m maxRevs オプシ ョ ンを

使用し、一回のコマン ド で更新する リ ビジ ョ ンの数を制限し て く だ さい。例えば p4 verify

-u -m 1000000 //... とする と、 フ ァ イル長 メ タデータ を一度に再計算する フ ァ イルの数

を 100 万個に制限する こ と ができ、 管理者は p4 verify を何度かに分けて実行し てフ ァ イ

ル長の メ タデータの再計算を行 う こ と ができ ます。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用可 使用可 admin

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 269

p4 where

p4 where

概要

p4 where は、 ク ラ イ アン ト ・ ビ ューで決定された特定フ ァ イルの位置を表示し ます。

構文

p4 [g-opts] where [file...]

解説

p4 where はク ラ イ アン ト ・ ビ ュー と ルー ト （ p4 client で設定） を使用し て、 デ ィ ポの 上

層、 ク ラ イ アン ト ・ ワーク スペースの 上層、 およびローカル OS のデ ィ レ ク ト リ ・ ツ リ ーの

上層 と の相対関係における フ ァ イルの位置を表示し ます。 このコマン ド はフ ァ イルが存在す

るかど う かは確認し ません。 単に、 フ ァ イルが存在する と し た ら ど こにあ るかを レポー ト する

だけです。

パラ メ ータ と し て指定された各フ ァ イルについて、1 セ ッ ト のマ ッ ピ ングが出力されます。マ ッ

ピングの各セ ッ ト は、 3 つの部分から なる行で構成されています。 初の部分はデ ィ ポ ・ シン

タ ッ ク スで表されたフ ァ イル名、 2 番目の部分はク ラ イ アン ト ・ シン タ ッ ク スで表されたフ ァ

イル名、 3 番目の部分はローカル OS 上でのフ ァ イルのパスです。

オプシ ョ ン

使用上の留意点

• マ ッ ピ ングは ク ラ イ アン ト ・ ビ ューか ら導出さ れます。 デ ィ ポを ク ラ イ アン ト ・ ワー ク ス

ペース内の 1 つのデ ィ レ ク ト リ にマ ッ ピング し ている単純なビ ューの場合、出力は 1 行です。

よ り 複雑な ク ラ イ アン ト ・ ビ ューは複数行の出力を生成し ますが、 これには除外マ ッ ピング

が含まれている こ と があ り ます。例えば、次のよ う な ク ラ イ アン ト ・ ビ ューがあ る と し ます。

View: //a/... //client/a/... //a/b/... //client/b/...

こ の場合、 p4 where //a/b/file.txt を実行する と、 次のよ う な出力が生成されます。

-//a/b/file.txt //client/a/b/file.txt //home/user/root/a/b/file.txt//a/b/file.txt //client/b/file.txt /home/user/root/b/file.txt

こ の 出 力 は、 ク ラ イ ア ン ト ・ ビ ュ ー の 初 の マ ッ ピ ン グ に よ っ て フ ァ イ ル は

/home/user/root/a/b/file.txt と し て現れるはずの と こ ろ、 初のマ ッ ピングは 2 番目の

マ ッ ピングによ ってオーバーラ イ ド されている、 と解釈でき ます。 こ のオーバーラ イ ド を実

行す る ために除外マ ッ ピ ン グが使用 さ れ、 2 番目のマ ッ ピ ン グが適用 さ れて フ ァ イ ルは

/home/user/root/b/file.txt に送られます。

• も単純なケース （デ ィ ポ ・ シン タ ッ ク ス、 ク ラ イ アン ト ・ シン タ ッ ク ス、 およびローカ

ル ・ シン タ ッ ク スでの各フ ァ イル名を表示する、 フ ァ イル 1 つに付き 1 行の出力） の方が、

はるかに一般的です。

g_opts 「グ ローバル ・ オプシ ョ ン」 のセ ク シ ョ ンをご覧 く ださい。

フ ァ イル引数に リ ビジ ョ ン指定

子を使えるか？

フ ァ イル引数に リ ビジ ョ ン範囲

を使えるか？

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

使用不可 使用不可 list

270 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 where

使用例

関連コ マン ド

p4 where file.c file.c のデ ィ ポ、 ク ラ イ アン ト ･ワーク スペース、 およびローカ

ル ・ フ ァ イルシステムの位置 ( つま り 、file.c がデ ィ ポ内に存在

する場合に表示される場所 ) を示し ます。

p4 where 100%25.txt フ ァ イ ル 100%.txt の位置を示すために "%" 文字の ASCII 拡張

を使用し ます。

ASCII 拡張は、 @ (%40)、 # (%23)、 * (%2a)、 および % (%25) の 4 つ

の特殊文字に対し てサポー ト されています。

デ ィ ポから同期されたフ ァ イルの リ ビジ ョ ンを一覧表示する。 p4 have

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 271

p4 workspace

272 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 workspace

概要

ク ラ イ アン ト ・ ワーク スペース仕様およびそのビ ューの生成または編集を行います。

構文

p4 [g-opts] workspace [-f] [-t template] [workspacename]p4 [g-opts] workspace -o [-t template] [workspacename]p4 [g-opts] workspace -d [-f] workspacenamep4 [g-opts] workspace -s [-S stream | -t workspacename] workspacenamep4 [g-opts] workspace -S stream [[-c change -o] workspacenamep4 [g-opts] workspace -i [-f]

解説

p4 workspace は p4 client と同等に機能し ます。

p4 workspaces

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 273

p4 workspaces

概要

現在システムが認識し ているすべての ク ラ イ アン ト ・ ワーク スペースの リ ス ト を表示し ます。

構文

p4 [g-opts] workspaces [-t] [-u user] [ [-e|-E] filter -m max ] -S streamp4 [g-opts] workspaces -U

解説

p4 workspaces は p4 clients と 同等に機能し ます。

環境変数

274 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

環境変数

各オペレーテ ィ ング ・ シ ス テム （OS） と シ ェルは、 環境変数を設定する ための固有の構文を

持っています。 次の表に、 各システムでの環境変数 P4CLIENT の設定方法を示し ます。

PERFORCE の環境変数は、 次の 4 つのカテゴ リ に分類でき ます。

• 重要 ： こ のカテゴ リ に属する変数は、 ほ と んどの場合、 ク ラ イ アン ト 上で設定する必要があ

り 、 デフ ォル ト 値で済ませる ケースはまずあ り ません。 こ れ ら の変数を理解する こ と は、

ユーザに と って も管理者に と って も非常に重要です。

• 有用 ： こ のカ テ ゴ リ に属す る 変数は、 ユーザに追加的機能を提供 し ますが、 ほ と ん ど の

PERFORCE 操作には必要あ り ません。

• 高度 ： こ のカテゴ リ に属する変数は、 デフ ォル ト 値で使用すれば十分であ り 、 値を変更する

必要はほ と んどあ り ません。

• サーバ ： こ のカテゴ リ に属する変数は、 PERFORCE のシステム管理者が、 PERFORCE サービ ス

をホ ス ト させているマシン上で設定し ます。 変数のい く つかは PERFORCE アプ リ ケーシ ョ ン

も使用し ますが、 そのよ う な変数は 2 箇所に リ ス ト される こ と にな り ます。

OS またはシ ェル 環境変数の例

UNIX: ksh, sh, bash P4CLIENT=value ; export P4CLIENT

UNIX: csh setenv P4CLIENT value

VMS def/j P4CLIENT “value”

Mac OS X (bash) P4CLIENT=value ; export P4CLIENT

Max OS X ( 設定 ) p4 set P4CLIENT=value

OS X 環境では、 ~/Library/Preferences フ ォルダにあ る

com.perforce.environment プロパテ ィ ・ リ ス ト に変数を設定する こ と

も可能です。

管理者権限を持つユーザであれば、p4 set -s var=value を用いてシス

テムの /Library/Preferences フ ォルダに変数を設定でき ます。

これらの場所は、Windows 環境および OS X 環境での p4 set の出力に反映

されます。

Windows p4 set P4CLIENT=value

PERFORCE をサービ ス と し て実行し ている Windows の管理者は、 p4 set - S svcname var=value によ り 、特定のサービ スについて変数を設定し た

り 、 p4 set -s var=value によ り 、 ローカル ・ マシン上のすべてのユー

ザについて変数を設定し た り でき ます。

（Windows および OS X における PERFORCE 変数の設定について、詳し く は本

書の p4 set コマン ド をご覧 く ださい。）

重要な変数 有用な変数 高度な変数 サーバの変数

P4CLIENT

P4PORT

P4PASSWD

P4USER

P4CONFIG

P4DIFF

P4EDITOR

P4MERGE

P4CHARSET

P4TRUST

P4PAGER

PWD

TMP, TEMP

P4TICKETS

P4LANGUAGE

P4LOGINSSO

P4COMMANDCHARSET

P4DIFFUNICODE

P4MERGEUNICODE

P4CLIENTPATH

P4AUDIT

P4JOURNAL

P4LOG

P4PORT

P4ROOT

P4DEBUG

P4NAME

P4SSLDIR

P4AUDIT

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 275

P4AUDIT

解説

監査ロ グフ ァ イルの場所を示し ます。

使用上の留意点

明示的に設定されない場合の値

注

P4AUDIT によ り 、 監査ロ グフ ァ イルの場所が指定されます。

監査が有効にされている と、 共有バージ ョ ン化サービ スからすべてのユーザへフ ァ イル ・ コ ン

テンツが転送される たびに、 PERFORCE が監査用ロ グフ ァ イルに一行追加し ます。 ア ク テ ィ ブ

なサーバ上では、 監査用ロ グフ ァ イルは非常に急速に増大し ます。

監査用ロ グ内の行は次の形式で出力されます。

日付 　 時間 　 ユーザ @ ク ラ イ アン ト 　 ク ラ イ アン ト IP ア ド レ ス 　 コマン ド 　 フ ァ イル

# リ ビジ ョ ン

例 :

2011/05/09 09:52:45 karl@nail 192.168.0.12 diff //depot/src/x.c#1 2011/05/09 09:54:13 jim@stone 127.0.0.1 sync //depot/inc/file.h#1

コマン ド が PERFORCE サービ ス をホ ス ト し ている同一の物理的マシン上で実行される と、 ク ラ

イ アン ト IP ア ド レ ス は 127.0.0.1 と表示されます。

PERFORCE プロ キシ経由で到達する コマン ド については、 IP ア ド レ スは proxyIP/clientIP の

形式で報告され、 コマン ド は command-proxy と し て報告されます。

レプ リ カ ・ サーバ上でのユーザの操作 （と り わけ、 ビル ド フ ァーム ・ レプ リ カおよび / または

転送レ プ リ カ を伴 う 環境において） が追跡 さ れ る よ う にす る には、 各レ プ リ カ ・ サーバに

P4AUDIT が設定されている必要があ り ます。

詳細情報については、 『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4d -A auditlog 適用外

OS 値

すべて な し。 ロ グフ ァ イルが指定されていない場合、 監査は無効にされます。

P4AUTH

276 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4AUTH

解説

任意設定の PERFORCE 集中認証サーバ ( すなわち、 この PERFORCE サーバがプロ テ ク シ ョ ン ・

テーブルを導 く PERFORCE サーバ ) のホ ス ト 名 と ポー ト 番号です。

使用上の留意点

明示的に設定されない場合の値

使用例

注

P4AUTH の形式は host:port とするか、 PERFORCE サーバ と認証サーバの両方が同じ ホ ス ト 上

で稼働し ている場合は単独で port を指定し ます。 すべてのサーバは同一の リ リ ース ・ レベル

でなければな り ません。

ポー ト 番号は 1024 から 32767 までの範囲内でなければな り ません。

マルチサーバ環境の管理に関する詳細情報については、 『システム管理者ガ イ ド』 をご覧 く だ

さ い。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する 適用外 適用外

プログラム 値

PERFORCE サーバ null

Perforce サーバの例

perforce.example.com:1818

192.168.0.123:1818

P4BROKEROPTIONS

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 277

P4BROKEROPTIONS

解説

Windows サービ ス用の PERFORCE ブローカー ・ オプシ ョ ンを設定し ます。

使用上の留意点

明示的に設定されない場合の値

注

例えば、 通常は以下のコマン ド でブローカーを実行するのであれば、

p4broker p4broker -c c:\p4broker\broker.conf

Windows サービ スが以下のコマン ド で実行される よ う に P4BROKEROPTIONS 変数を設定でき

ます。

p4 set -S "Broker" P4BROKEROPTIONS="-c c:\p4broker\broker.conf"

"Broker" サービ スの下で P4Broker を実行する と、ブローカーは指定された broker.conf フ ァ

イルを使用し てブ ローカー自体を構成し ます。 対応する環境変数のないオプシ ョ ン を用いて

p4broker を呼び出す必要があ る場合、または Windows サービ スのコ ンテキス ト の中で呼び出す

場合には、 P4BROKEROPTIONS を使用し ます。

PERFORCE ブローカーに関する詳細情報については、『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4broker %P4BROKEROPTIONS% 適用外

OS 値

すべて null

P4CHARSET

278 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4CHARSET

解説

Unicode フ ァ イルのコード 変換に使用される文字セ ッ ト です。

使用上の留意点

明示的に設定されない場合の値

注

P4CHARSET の設定が有効と な るのは、Unicode および utf16 のフ ァ イルのみです。Unicode以外のタ イプのフ ァ イルは、 コード 変換されません。

PERFORCE サービ スの設定がデフ ォル ト （非 Unicode モード） の と きは、 P4 CHARSET を設定し

てはいけません （または none に設定し ます）。 P4 CHARSET が設定されているのに、 サービ ス

が国際語モード でない場合は、 サービ スが次のエラー ・ メ ッ セージを返し ます。

Unicode clients require a unicode enabled server.

一方、 PERFORCE サービ スの設定が Unicode モード の と きは、 P4 CHARSET を設定し なければな

り ません。P4 CHARSETが設定されていないのに、サービ スが Unicode モード の場合は、PERFORCE

アプ リ ケーシ ョ ンが次のエ ラー ・ メ ッ セージを返し ます。

Unicode server permits only unicode enabled clients.

Unicode モー ド に関する詳細情報、 およびバ イ ト ・ オーダー ・ マー ク を含むま たは含ま ない

UTF-8、 UTF-16、 UTF-32 の各種文字セ ッ ト に対する P4CHARSET の設定については、 以下の

PERFORCE 国際語モード に関する注意事項 （i18nnotes.txt） を参照し て く だ さい。

http://www.perforce.com/perforce/doc.current/user/i18nnotes.txt

有効な P4CHARSET の値の完全な リ ス ト を見るには、 p4 help charset コマン ド を実行し て く

ださい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -C charset cmd 設定でき る

OS 値

すべて な し。PERFORCEサービ スがunicodeモード で起動されていて も、P4 CHARSET が設定されていなければ、PERFORCE のアプ リ ケーシ ョ ンはエラー・ メ ッ セー

ジを返し ます。

P4CHANGE

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 279

P4CHANGE

解説

任意設定の PERFORCE チェ ンジ リ ス ト サーバ ( すなわち、この PERFORCE サーバが 新の未使用

のチェ ンジ リ ス ト を導 く PERFORCE サーバ ) のホ ス ト 名 と ポー ト 番号です。

使用上の留意点

明示的に設定されない場合の値

使用例

注

P4CHANGE の形式は host:port とするか、 PERFORCE サーバ と チェ ンジ リ ス ト ・ サーバの両方

が同じ ホ ス ト 上で稼働し ている場合は単独で port を指定し ます。 すべてのサーバは同一の リ

リ ース ・ レベルでなければな り ません。

ポー ト 番号は 1024 から 32767 までの範囲内でなければな り ません。

マルチサーバ環境の管理に関する詳細情報については、 『システム管理者ガ イ ド』 をご覧 く だ

さ い。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する 適用外 適用外

プログラム 値

PERFORCE サーバ null

Perforce サーバの例

perforce.example.com:1818

192.168.0.123:1818

P4COMMANDCHARSET

280 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4COMMANDCHARSET

解説

コマン ド ・ ラ イ ン ・ ク ラ イ アン ト からの UTF-16 および UTF-32 の文字セ ッ ト をサポー ト する

ために使用されます。

使用上の留意点

明示的に設定されない場合の値

注

P4CHARSET を UTF-16 または UTF-32 に設定し た場合、p4 コマン ド ・ ラ イ ン ・ ク ラ イ アン ト を

使用する ためには P4COMMANDCHARSET を UTF-16、 UFT-32 以外の値に設定する必要があ り ま

す。 詳し く は、 PERFORCE 国際語モード に関する注意事項 （i18nnotes.txt） を参照し て く だ さい。

http://www.perforce.com/perforce/doc.current/user/i18nnotes.txt

有効な P4COMMANDCHARSET の値の完全な リ ス ト を見るには、 p4 help charset コマン ド を実

行し て く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -Q commandcharset cmd 設定でき る

OS 値

すべて な し

P4CLIENT

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 281

P4CLIENT

解説

P4CLIENT は、 現在の ク ラ イ アン ト ・ ワーク スペースの名前です。

使用上の留意点

明示的に設定されない場合の値

使用例

ク ラ イアン ト が

使用するか？

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか？

使用する 使用し ない p4 -c clientname cmd 設定でき る

OS 値

Windows 環境変数 COMPUTERNAME の値

Windows 以外 ホス ト ・ マシン名

cinnamon

computer1

WORKSTATION

P4CLIENTPATH

282 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4CLIENTPATH

解説

PERFORCE アプ リ ケーシ ョ ンからの書き込みが可能なデ ィ レ ク ト リ の リ ス ト です。

PERFORCE アプ リ ケーシ ョ ンが、 フ ァ イルシステム上で これらの領域外にあ る フ ァ イルにア ク

セス または変更を試みる と、 エラー ・ メ ッ セージが出力されます。

複数のデ ィ レ ク ト リ を指定するには、 デ ィ レ ク ト リ をセ ミ コ ロ ンで区切って く だ さい。

使用上の留意点

明示的に設定されない場合の値

使用例

ク ラ イアン ト が

使用するか？

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか？

使用する 使用し ない 適用外 設定でき る

OS 値

すべて な し

"C:\Users\Joe Coder"

/usr/team/joe/workspace;/buildfarm/joe

P4CONFIG

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 283

P4CONFIG

解説

P4CONFIG は、 パスな しのフ ァ イル名です。 この変数が指示し ている フ ァ イル （構成フ ァ イル）

は、 P4CONFIG 以外の PERFORCE 環境変数およびレジス ト リ 変数を定義するのに使用し ます。

フ ァ イルの検索は、 現在の作業デ ィ レ ク ト リ （PWD によ り 返信） およびそれよ り 上位のデ ィ レ

ク ト リ 内で行われます。 フ ァ イルが存在し ていれば、 フ ァ イル内の変数設定が使用されます。

フ ァ イル内の変数設定は各行に単独で置かれ、 variable=value 形式を取る必要があ り ます。

使用上の留意点

明示的に設定されない場合の値

使用例

例えば、 P4CONFIG フ ァ イルには次のよ う な行が含まれます。

注

P4CONFIG の設定によ り 、プロ ジェ ク ト を切 り 換え る と きの PERFORCE 環境の切 り 換えがほ と ん

ど問題にな り ません。 各ク ラ イ アン ト ・ ワーク スペース内に構成フ ァ イルを配置し、 そのフ ァ

イルを指示する よ う に P4CONFIG を設定し ておけば、 あ る ワーク スペースか ら別のワーク ス

ペースのデ ィ レ ク ト リ に移動し た と き、 PERFORCE の設定は自動的に構成フ ァ イル内の設定に

変わ り ます。

P4CONFIG フ ァ イルで設定する主な変数を以下に示し ます。

• P4CHARSET

• P4CLIENT

• P4DIFF

• P4EDITOR

• P4HOST

• P4LANGUAGE

• P4MERGE

• P4PASSWD

• P4PORT

• P4TICKETS

• P4USER

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか？

使用する 使用し ない な し 適用外

OS 値

すべて 設定されない場合は使用されません。

P4CLIENT=joes_clientP4USER=joeP4PORT=ssl:ida:3548

P4DEBUG

284 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4DEBUG

解説

P4DEBUG は、 PERFORCE サーバまたはプロ キシの ト レース ・ オプシ ョ ンを設定し ます。

使用上の留意点

明示的に設定されない場合の値

使用例

注

ロ グへの記録を無効にするには、 P4DEBUG を server=0 に設定し ます。

PERFORCE サーバの ト レース ・ オプシ ョ ンがよ り 高い数値に設定される と、 PERFORCE の技術サ

ポー ト と と もに問題の診断や調査にあたっている管理者にのみ役立ちます。

PERFORCE サーバ （またはプロ キシ） に ト レース ・ オプシ ョ ンを設定する と きは、 p4d （または

p4p） コ マン ド ラ イ ン上に設定する方法が よ く 使われます。 技術的な理由か ら、 こ の方法は

Windows 上で PERFORCE サーバまたはプロ キシをサービ ス と し て実行し ているサイ ト には機能

し ません。こ のよ う なサイ ト の管理者は、p4 set を使用し て P4DEBUG 内で ト レース ・オプシ ョ

ンを設定する こ と ができ、 このオプシ ョ ンが有効になった状態でサービ ス を実行でき ます。

PERFORCE サーバ (p4d) でサーバ ・ デバッ グ ・ レベルを設定し て も、 PERFORCE プロ キシ （p4p）

プロセスのデバッ グ ・ レベルには何の影響も あ り ません。 この逆も同様です。

詳細情報については、 『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する な し 設定でき ない

OS 値

すべて リ リ ース 2011.1 から、 server=1 がデフ ォル ト の設定にな り ま し た。

server=0

server=1

server=2

server=3

P4DIFF

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 285

P4DIFF

解説

p4 resolve と p4 diff に使用する差分プロ グ ラ ムの名前 と パスです。

使用上の留意点

明示的に設定されない場合の値

使用例

注

diff -u のよ う に、実行するプロ グ ラ ムに対するオプシ ョ ンを、P4DIFF の値に含める こ と がで

き ます。

コマン ド p4 describe、 p4 diff2、 および p4 submit はすべて、 p4d に組み込まれている差

分プロ グ ラ ムを使用し ます。 これは変更でき ません。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない な し 設定でき る

OS 値

Windows 環境変数 DIFF が設定されている場合、 DIFF の値と な り ます。 それ以外で

環境変数 SHELL が任意の値に設定されている場合、 diff コマン ド が使用

されます。 それ以外では p4diff.exe と な り ます。

Windows 以外 環境変数 DIFF が設定されている場合、 DIFF の値と な り ます。 それ以外で

は、 PERFORCE の内部差分プロ グ ラ ムが使用されます。

diff

diff -b

windiff.exe

P4DIFFUNICODE

286 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4DIFFUNICODE

解説

コマン ド ・ ラ イ ン ・ ク ラ イ アン ト からの UTF-16 および UTF-32 の文字セ ッ ト をサポー ト する

ために使用されます。

使用上の留意点

明示的に設定されない場合の値

注

こ の環境変数は、 比較対象のフ ァ イルが unicode または utf16 タ イプであ る場合に P4DIFF

の代わ り に使用されます。 文字セ ッ ト はコマン ドへの 初の引数 と し て渡されます。 詳し く は

PERFORCE 国際語モード に関する注意事項 （i18nnotes.txt） を参照し て く だ さい。

http://www.perforce.com/perforce/doc.current/user/relnotes.txt

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ

イルで設定できる

か ?

使用する 使用し ない な し 設定でき る

OS 値

すべて な し

P4EDITOR

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 287

P4EDITOR

解説

P4EDITOR は、 フ ォームを使用する PERFORCE コマン ド によ り 起動されるエデ ィ タです。

使用上の留意点

明示的に設定されない場合の値

使用例

注

フ ォーム を使用する コ マン ド、 すなわちフ ォーム を使用する ために こ の変数にア ク セ スする

PERFORCE の標準 コ マ ン ド は、 p4 branch、 p4 change、 p4 client、 p4 job、 p4 label、 p4

submit、 および p4 user です。

フ ォームを使用する スーパー ・ ユーザ ・ コ マン ド は、 p4 depot、 p4 group、 p4 jobspec、 p4

protect、 p4 triggers および p4 typemap です。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない な し 設定でき る

OS 値

UNIX および OS X EDITOR が任意の値に設定されている場合は EDITOR の値。 それ以外の場

合は vi

Windows SHELL が任意の値に設定されている場合は vi

それ以外では notepad

VMS POSIX$SHELL が設定されている場合は vi

それ以外では edit

Mac EDITOR_SIGNATURE が設定されている場合は、その 4 文字の作成者名が付

いているプロ グ ラ ム

それ以外では SimpleText

/usr/bin/vi

emacs

SimpleText

P4HOST

288 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4HOST

解説

P4HOST は、別のホ ス ト ・ コ ン ピ ュータから ア ク セス し ているかのよ う に見せかける と きのホ ス

ト 名です。

使用上の留意点

明示的に設定されない場合の値

使用例

注

PERFORCE ユーザは、 p4 client フ ォームのフ ィ ール ド ［Host:］ （ホ ス ト ） を使用し て、 特定

のホ ス ト ・ マシンからのみ特定の ク ラ イ アン ト ・ ワーク スペース を使用でき る よ う 規定する こ

と ができ ます。 こ のフ ィ ール ド を設定する と、 現在どのマシンを使用し ていて も、 P4HOST 変

数を使用し てサービ スに通知し、 指定し たホ ス ト ・ マシン上にいる よ う に見せかける こ と がで

き ます。 これは非常に高度な要求なので、 通常はこ の変数を設定する理由はあ り ません。

ホ ス ト 名は、p4 info をそのホス ト から実行し た と きの出力に表示される とお り に入力する必

要があ り ます。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -H hostname command 設定でき る

OS 値

すべて p4 info で表示される ク ラ イ アン ト ・ ホス ト 名。

workstation123.perforce.com

P4IGNORE

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 289

P4IGNORE

解説

フ ァ イルをデ ィ ポに追加する際およびワーク スペース と サーバの整合性を と る際に無視するべき フ ァ イルの リ ス ト が含まれたフ ァ イルを指定し ます。

使用上の留意

明示的に設定されない場合の値

使用例

注

P4IGNORE フ ァ イルの内容の構文は、PERFORCE の構文 と同じではあ り ません。むし ろ、他のバー

ジ ョ ン化システムで使用される ものに似ています。 フ ァ イルはローカル ・ シン タ ッ ク スで指定

されます。 行頭の # 文字はコ メ ン ト を示し、 行頭の ! 文字はそのフ ァ イル指定を除外し、 ワ イ

ル ド カード * はサブ文字に一致し ます。 PERFORCE ワ イル ド カード の ... は使用でき ません。

例 :

ク ラ イアン ト が

使用するか ?

サーバが

使用するか

同様に機能する コ マン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない な し 設定でき る

OS 値

すべて な し

/users/edk/.p4ignore

# Ignore .p4ignore files.p4ignore

# Ignore object files, shared libraries, executables*.dll*.so*.exe*.o

# Ignore all HTML files except the readme file*.html!readme.html

P4JOURNAL

290 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4JOURNAL

解説

PERFORCE データベースのジ ャーナル ・ データ を保持する フ ァ イルです。

使用上の留意点

明示的に設定されない場合の値

使用例

注

相対パス を使 う と きは、 PERFORCE サーバのルー ト からの相対パス を指定し て く だ さい。

P4JOURNALをoffに設定する と ジ ャーナル・データ を保持し な く な り ますが、お勧めし ません。

詳細情報については、 『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4d -J file 適用外

OS 値

すべて P4ROOT/journal

journal

off

/disk2/perforce/journal

P4LANGUAGE

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 291

P4LANGUAGE

解説

こ の環境変数は、 システム管理者向けに用意されています。

使用上の留意点

明示的に設定されない場合の値

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -L language cmd 設定でき る

OS 値

すべて 設定されない場合は使用されません。

P4LOG

292 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4LOG

解説

P4LOG は、 PERFORCE のエラーが書き込まれる フ ァ イルの名前と パスです。

使用上の留意点

明示的に設定されない場合の値

使用例

注

相対パス を使用する場合は、 PERFORCE サーバのルー ト からの相対パス を指定し ます。

詳細情報については、 『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4d -L filep4p -L file

適用外

OS 値

すべて 標準エラー出力

log

/disk2/perforce/log

P4LOGINSSO

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 293

P4LOGINSSO

解説

ク ラ イ アン ト 側のシングル ・ サイ ンオン ・ ス ク リ プ ト です。

使用上の留意点

明示的に設定されない場合の値

使用例

注

auth-check-sso ト リ ガを使用する システムにおいて、 P4LOGINSSOはサーバ側の認証 ト リ ガに

よ って検証さ れるべき ユーザの資格証明書を取得する、 ク ラ イ アン ト 側ス ク リ プ ト を示し ま

す。

詳細情報については、 『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する 適用外 適用外

OS 値

すべて 適用外

/Users/joe/bin/runsso

P4MERGE

294 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4MERGE

解説

P4MERGE は、p4 resolve のマージ ・ オプシ ョ ンが使用する、 サード ・ パーテ ィ 製のマージ ・ プ

ロ グ ラ ムです。

使用上の留意点

明示的に設定されない場合の値

使用例

注

こ の変数内に設定されるプロ グ ラ ム名で表示されるプロ グ ラ ムは、 p4 resolve のマージ ・ オ

プシ ョ ンによ ってのみ使用されます。 p4 resolveによ り このプロ グ ラ ムにア ク セスする と、こ

のプロ グ ラ ムは 4 つの引数を獲得し ます。 引数は （順に） base、 theirs、 yours で、 4 つめの引

数でマージ結果の merge フ ァ イルを保持し ます。

使用する プ ロ グ ラ ムの引数が異な る順番にな る場合、 P4MERGE をシ ェル ・ ス ク リ プ ト かバ ッ

チ ・ フ ァ イルに設定し て引数を並べ替え、 正しい順番の引数を持つ適切なマージ ・ プロ グ ラ ム

にア ク セス し て く だ さい。

Windows で操作し ている場合は、 使用するサード ・ パーテ ィ 製のマージ ・ プロ グ ラ ムがすでに

PERFORCE の指定する順番で引数を受け入れている場合で も、 バッ チ ・ フ ァ イルにア ク セス し

て く ださ い。 これは、 Windows 内の制約によ る ものです。 例えば、 Windows で MERGE.EXE と い

う プロ グ ラ ムを使用し たい場合、 バッチ ・ フ ァ イルは次のよ う にな り ます。

SET base=%1SET theirs=%2SET yours=%3SET merge=%4C:\FULL\PATH\TO\MERGE.EXE %base% %theirs% %yours% %merge%

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同等に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない な し 設定でき る

OS 値

すべて 環境変数 MERGE （または p4 set で設定し た Windows 上でのレジス ト リ 変

数） が設定されている場合はその値にな り ます。 それ以外の場合は値な し。

c:\Perforce\p4merge.exe

c:\progra~1\Perforce\p4merge.exe

P4MERGEUNICODE

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 295

P4MERGEUNICODE

解説

コマン ド ・ ラ イ ン ・ ク ラ イ アン ト からの UTF-16 および UTF-32 の 文字セ ッ ト をサポー ト する

ために使用されます。

使用上の留意点

明示的に設定されない場合の値

注

こ の環境変数は、解決対象のフ ァ イルのタ イプが unicode またはutf16であ る場合に P4MERGE

の代わ り に使用されます。 文字セ ッ ト はコマン ドへの 初の引数 と し て渡されます。 詳し く は

PERFORCE 国際語モード に関する注意事項 （i18nnotes.txt） を参照し て く だ さい。

http://www.perforce.com/perforce/doc.current/user/relnotes.txt

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない な し 設定でき る

OS 値

すべて な し

P4NAME

296 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4NAME

解説

PERFORCE サーバを固有に識別する ための名前です。

P4NAME は p4 configure でのサーバの識別に使用されます。

使用上の留意点

明示的に設定されない場合の値

使用例

注

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コ マン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4d -In name 適用外

OS 値

すべて な し

masterserver

failoverserver

buildserver

P4PAGER

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 297

P4PAGER

解説

P4PAGERは、p4 resolveの差分オプシ ョ ンからの出力をページ表示する ために使用されるプロ

グ ラ ムです。

使用上の留意点

明示的に設定されない場合の値

使用例

注

こ の変数の値は、 p4 resolve の差分ルーチンの出力を表示する ためにのみ使用されます。 こ

の変数が設定されていない場合、 出力はページ表示されません。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない な し 設定でき ない

OS 値

すべて 変数 PAGER が設定されていれば PAGER の値にな り ます。 それ以外の場合

は値な し。

/bin/more (UNIX)

P4PASSWD

298 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4PASSWD

解説

P4PASSWDは、あ らゆる PERFORCE ク ラ イ アン ト ・コマン ド に、現在の PERFORCE ユーザのパス ワー

ド を与えます。

使用上の留意点

明示的に設定されない場合の値

注

PERFORCE のパス ワード は、 p4 passwd を介し て設定するか、 または p4 user によ って表示さ

れる フ ォーム内で設定し ます。 P4PASSWD の設定は、 ユーザが本人であ るか検証するのに使用

されます。 パス ワード が設定されていない場合、 P4PASSWD が設定されていて も その値は使用

されません。

環境変数 P4PASSWD は手動でプレーン ・ テキス ト のパス ワード に設定でき ますが、 よ り 安全な

方法は p4 passwd コマン ド を使用する こ と です。 UNIX の場合、 p4 passwd コマン ド は、 パス

ワード を安全確実に検証するチャ レ ンジ／レ スポン ス機構が起動し ます。 Windows の場合、 p4

passwd コマン ド は、MD5 ハッ シュによ って暗号化し たパス ワード を、環境変数 P4PASSWD に設

定し ます。

Windows プラ ッ ト フ ォームでは、 ユーザが P4V でパス ワード を設定し ている場合、 レジス ト リ

変数 P4PASSWD の値が該当ユーザのために設定されます。P4V でパス ワード を設定する こ と は、

MS-DOS コマン ド ラ イ ンから p4 passwd （または p4 set PASSWD） を使用し、 レジス ト リ 変

数に、MD5 ハッ シ ュによ って暗号化されたパス ワード を設定する こ と に似ています。暗号化さ

れていないパス ワード そのものがレジス ト リ に格納される こ と はあ り ません。

チケ ッ ト ・ ベースの認証を使用し ている場合に、 P4PASSWD の設定に依存する ス ク リ プ ト があ

る と きは、 p4 login -p を使用し て、 パス ワード と同じ よ う に PERFORCE コマン ド に渡すこ と

のでき る ( つま り 、 コマン ド ラ イ ンから渡すか、 または P4PASSWD を有効なチケ ッ ト の値に設

定し て渡すこ と のでき る ) チケ ッ ト の値を示し ます。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -P passwd command 設定でき る

OS 値

すべて な し

P4PCACHE

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 299

P4PCACHE

解説

PERFORCE プロキシが使用するディレクトリで、キャッシュするファイルやディレクトリを保

持します。

使用上の留意点

明示的に設定されない場合の値

注

こ のデ ィ レ ク ト リ を作成し てから、 PERFORCE プロ キシ （p4p） を起動し て く だ さい。

p4p を実行し ている アカ ウ ン ト だけが、 このデ ィ レ ク ト リ の読み取 り ／書き込みパー ミ ッ シ ョ

ンを持つ必要があ り ます。

PERFORCE プロ キシのセ ッ ト ア ッ プに関する詳細情報については、『 システム管理者ガイ ド』 を

ご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4p -r directory 適用外

OS 値

すべて p4p のデ ィ レ ク ト リ 。

PERFORCE プロ キシ ・ プロセス をサービ ス と し て実行し ている Windows の管

理者は、 指定し たサービ スの P4PCACHE の値を設定する場合、 p4 set -S svcname P4PCACHE=directory とする必要があ り ます。

P4PFSIZE

300 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4PFSIZE

解説

PERFORCE プ ロ キシにおいて、 キ ャ ッ シ ュ さ れる フ ァ イルの 少サ イ ズ （バイ ト 単位） です。

P4PFSIZE のバイ ト 数よ り もサイ ズが大きいフ ァ イルはすべてキ ャ ッ シ ュ されます。

使用上の留意点

明示的に設定されない場合の値

注

PERFORCE プロ キシのセ ッ ト ア ッ プに関する詳細情報については、『 システム管理者ガイ ド』 を

ご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4p -e size 適用外

OS 値

すべて 0、 すなわちすべてのフ ァ イルをキ ャ ッ シュする

P4POPTIONS

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 301

P4POPTIONS

解説

Windows サービ スに対し て PERFORCE プロ キシのオプシ ョ ンを設定し ます。

使用上の留意点

明示的に設定されない場合の値

注

例えば、 通常、 以下のコマン ド を使ってプロ キシを実行する と し ます。

p4p -p 1999 -t mainserver:1666

こ の場合、 Windows サービ スの proxysvc の起動オプシ ョ ンを P4POPTIONS 変数を使って以下

のよ う に設定する こ と ができ ます。

p4 set -S "Perforce Proxy" P4POPTIONS="-p 1999 -t mainserver:1666"

"PERFORCE プロ キシ " サービ ス のも と で P4P を実行する と、 プロ キシはポー ト 番号 1999 から

の要求を待機し、 mainserver:1666 において PERFORCE サービ ス と交信を行います。

ほ と んどのイ ン ス ト ールでは P4POPTIONS を使用する必要はあ り ません。 大部分の p4p オプ

シ ョ ンには、 それに関連付け られている環境変数があ る か ら です。 上記の例の場合、 P4PORT

と P4TARGET を使用する こ と ができ ます。該当する環境変数のないオプシ ョ ンを付けて p4p を

呼び出す必要があ る場合、または Windows サービ スのコ ンテキス ト 内で p4p を呼び出す必要が

あ る場合に P4POPTIONS を使用し て く ださ い。

PERFORCE プロ キシのセ ッ ト ア ッ プに関する詳細情報については、『 システム管理者ガイ ド』 を

ご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4p %P4POPTIONS% 適用外

OS 値

すべて Null

P4PORT

P4PORT

解説

PERFORCE サービ ス （サーバ、 ブローカ、 プロ キシ） が、 通信の接続待ちに使用するポー ト 番

号およびバイ ン ドするネ ッ ト ワーク ・ ト ラ ン スポー ト の値です。

PERFORCE アプ リ ケーシ ョ ンにおいては、 通信相手であ る Perforce サービ スのプロ ト コル、 ホ

ス ト およびポー ト 番号の値です。 最も一般的に使用されている通信プロ ト コルは tcp （TCP/IP

経由のプレーンテキス ト ） または ssl （TCP/IP 経由の SSL） です。

PERFORCE は IPv4 ネ ッ ト ワーク と と もに IPv6 ネ ッ ト ワーク経由の接続もサポー ト し ています。

ホ ス ト 名の解決の際に IPv4 と IPv6 のどち らのア ド レ ス を使用する必要があ るか （あ るいは単

に使用し たいか） を指定でき ます。 tcp4 および ssl4 のプロ ト コル設定には IPv4 ア ド レ スの

サポー ト が必要です。 同様に、 tcp6 と ssl6 には IPv6 のサポー ト が必要です。 tcp64 および

ssl64 を使用する と、 最初にホ ス ト の解決を IPv6 ア ド レ スで試み、 IPv6 が使用でき ない場合

に IPv4 ア ド レ ス を受け入れます。 tcp46 および ssl46 を使用する と、 その反対の動作を指定

でき ます。 すなわち、 可能であればデフ ォル ト で IPv4 の使用を試み、 IPv4 が使用でき ない場

合に IPv6 を使用し ます。 構成可能変数 net.rfc3484 をユーザのワー ク ス テーシ ョ ン ま たは

P4CONFIG フ ァ イルに設定する と、 オペレーテ ィ ング ・ システムによ って自動的にどち らの ト

ラ ン スポー ト を使用するかが決定されます。

ネ ッ ト ワーク ・ サービ スの動作およびパフ ォーマン スは、 単にサービ ス をホ ステ ィ ング し てい

るマシンのネ ッ ト ワーク能力や、 エン ド ユーザが使用するオペレーテ ィ ング ・ システムだけで

な く 、 ユーザ固有の LAN および WAN の イ ン フ ラ ス ト ラ ク チャ （および、 エン ド ・ ユーザ と

PERFORCE バージ ョ ン化サービ スの間にあ るすべてのルータでの IPv6 サポー ト 状況） によ って

異な り ます。

シナ リ オの 1 つ と し て、自宅から作業するユーザを例に と り ます。ユーザが IPv6 ベースのホー

ム ・ ネ ッ ト ワーク を配備し ている と し て も、 ISP または VPN のプロバイ ダが IPv6 を完全にサ

ポー ト し てい る と は限 り ません。 そのため弊社では P4PORT にい く つかの異な る設定を用意

し、 IPv4 から IPv6 への移行中の管理者 と ユーザが可能な限 り 柔軟に作業でき る よ う にし、 旧

バージ ョ ン と の互換性を持たせています。

P4PORT プロ ト コ

ルの値

IPv4/IPv6 または混合ネ ッ ト ワークでの動作

< 未設定 > tcp4: の動作を使用し ますが、 ア ド レ スが数値であ り 2 つ以上のコ ロ ンが含まれ

ている場合は tcp6: を想定し ます。構成可能変数 net.rfc3484 が設定されてい

る場合、 OS によ ってどち らの ト ラ ン スポー ト を使用するか決定されます。

tcp: tcp4: の動作を使用し ますが、 ア ド レ スが数値であ り 2 つ以上のコ ロ ンが含まれ

ている場合は tcp6: を想定し ます。構成可能変数 net.rfc3484 が設定されてい

る場合、 OS によ ってどち らの ト ラ ン スポー ト を使用するか決定されます。

tcp4: IPv4 のア ド レ ス / ポー ト にのみ接続待機および接続し ます。

tcp6: IPv6 のア ド レ ス / ポー ト にのみ接続待機および接続し ます。

tcp46: IPv4 ア ド レ スへの接続待機および接続を試みます。 失敗し た場合、 IPv6 で再試行

し ます。

tcp64: IPv6 ア ド レ スへの接続待機および接続を試みます。 失敗し た場合、 IPv4 で再試行

し ます。

ssl: ssl4: の動作を使用し ますが、 ア ド レ スが数値であ り 2 つ以上のコ ロ ンが含まれ

ている場合は ssl6: を想定し ます。 構成可能変数 net.rfc3484 が設定されて

いる場合、 OS によ ってどち らの ト ラ ン スポー ト を使用するか決定されます。

ssl4: IPv4 のア ド レ ス / ポー ト にのみ、 SSL 暗号化を使用し て接続待機および接続し ま

す。

302 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4PORT

混合環境では、 構成可能変数 net.rfc3484 を 1 に設定する こ と が推奨されます。

p4 configure set net.rfc3484=1

こ う する こ と によ って、プロ ト コルの値を明示的に指定し ていないユーザに も、RFC3484 に準

拠し た動作が保証されます。 つま り 、 ク ラ イ アン ト 側の構成可能変数 net.rfc3484 が 1 に設

定 さ れ、 P4PORT が example.com:1666、 ま た は tcp:example.com:1666、 ま た は

ssl:example.com:1666 に設定されている場合、 ユーザのオペレーテ ィ ング ・ システムはそれ

ぞれの接続に IPv4 と IPv6 のどち ら を使用するかを自動的に決定し ます。

SSL を使用し て PERFORCE に接続する場合は、 PERFORCE サーバの指紋が P4TRUST フ ァ イルに

保存されている もの と一致し なければな り ません。（新しい PERFORCE イ ン ス ト ールに 初に接

続し た と き、 サーバのフ ィ ンガープ リ ン ト が表示されます。 それが管理者によ って割 り 当て ら

れた も の と 一致すれば、 p4 trust コ マン ド を使用し てサーバを P4TRUST フ ァ イルに追加す

る こ と によ り 、 サーバに安全に接続でき ます。

使用上の留意点

明示的に設定されない場合の値

使用例

ssl6: IPv6 のア ド レ ス / ポー ト にのみ、 SSL 暗号化を使用し て接続待機および接続し ま

す。

ssl46: IPv4 のア ド レ ス / ポー ト に接続待機および接続し ます。 失敗し た場合、 IPv6 で再

試行し ます。 接続後は SSL によ る暗号化を必要 と し ます。

ssl64: IPv6 のア ド レ ス / ポー ト に接続待機および接続し ます。 失敗し た場合、 IPv4 で再

試行し ます。 接続後は SSL によ る暗号化を必要 と し ます。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コ マン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用する p4 -p host:port cmd 設定でき る

プログラム 値

PERFORCE サーバ 1666

PERFORCE プロ キシ 1666

PERFORCE ク ラ イ アン ト perforce:1666

PERFORCE ク ラ イアン ト での使用例 PERFORCE サーバでの使用例

1818 1818

ssl:squid:1234 ssl:1234

example.com:1234 1234

ssl:192.168.0.123:1818 ssl:1818

tcp6:[2001:db8::123]:1818 tcp6:[::]:1818

tcp6:example.com:1818 ssl6:[::]:1818

ssl64:[2001:db8::123]:1818 ssl64:[::]:1818ssl64:[::]:1818

P4PORT プロ ト コ

ルの値

IPv4/IPv6 または混合ネ ッ ト ワークでの動作

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 303

P4PORT

注

PERFORCE アプ リ ケーシ ョ ン上での P4PORT の形式は protocol:host:port です。 ま たは、

PERFORCE アプ リ ケーシ ョ ン と バージ ョ ン化サービ スの両方が同じ ホ ス ト 上で動作し ている場

合は、 単に port です。 ポー ト 番号は、 1024 から 32767 の範囲になければな り ません。

P4PORT に IP ア ド レ ス と ポー ト 番号の両方を指定する と、 PERFORCE バージ ョ ン化サービ スは

P4PORT に指定されている IP ア ド レ ス以外の IP ア ド レ スからの要求を無視し ます。

プロ ト コルを指定し ない場合、PERFORCE アプ リ ケーシ ョ ン と PERFORCE バージ ョ ン化サービ ス

の間での伝送はプレーンテキ ス ト で行われ、 IPv4 ア ド レ スが想定されます。

304 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4ROOT

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 305

P4ROOT

解説

PERFORCE サービ スが、 自身のフ ァ イル と サブデ ィ レ ク ト リ を格納するデ ィ レ ク ト リ です。

使用上の留意点

明示的に設定されない場合の値

注

こ のデ ィ レ ク ト リ を作成し てから、PERFORCEバージ ョ ン化サービ ス（p4d）を起動し て く だ さい。

p4d を実行し ている アカ ウ ン ト だけが、 このデ ィ レ ク ト リ の読み取 り ／書き込みパー ミ ッ シ ョ

ンを持つ必要があ り ます。

PERFORCE イ ン ス ト ールのセ ッ ト ア ッ プに関する詳細情報については、 『 シス テム管理者ガ イ

ド 』 をご覧 く だ さ い。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4d -r directory 適用外

OS 値

すべて p4d のデ ィ レ ク ト リ 。

PERFORCEのバッ ク エン ド・プロセス をサービ ス と し て実行し ている Windows

の管理者は、指定し たサービ スの P4ROOT の値を設定する場合、p4 set - S svcname P4ROOT=directory とする必要があ り ます。

P4SSLDIR

P4SSLDIR

解説

サーバの SSL キーおよび / または証明書を含むデ ィ レ ク ト リ です。

使用上の留意点

明示的に設定されない場合の値

使用例

注

SSL 接続を受け入れるすべての PERFORCE プロセス （p4d、 p4p、 p4broker） は、 起動時に （こ

のデ ィ レ ク ト リ に格納された） 証明書 と キーのペアを必要 と し ます。 これらのプロセス を開始

するには、 さ らに以下の条件を満たす必要があ り ます。

• P4SSLDIR が有効なデ ィ レ ク ト リ に設定されている必要があ り ます。

• P4SSLDIR デ ィ レ ク ト リ は当該 PERFORCE サーバ、プロ キシ、 またはブローカのプロセスの実

行者と同じユーザ ID を所有し ている必要があ り ます。P4SSLDIR デ ィ レ ク ト リ が他のユーザ

から読み取 り 可能であってはな り ません。 例えば、 UNIX 環境ではデ ィ レ ク ト リ のパー ミ ッ

シ ョ ンは 0700 (drwx------) または 0500 (dr-x------) に設定する必要があ り ます。

• privatekey.txt、certificate.txt と い う 2 つのフ ァ イルが P4SSLDIRに存在し ている必要

があ り ます。

これらのフ ァ イルは、 当該 SSL 接続に使用される、 PEM エン コード され暗号化されていな

いプラ イベー ト ・ キーおよび証明書に対応し ます。 それらは当該 PERFORCE サーバ、 プロ キ

シ、 またはブローカのプロセス を実行するユーザ ID が所有し、 他のユーザから読み取れな

いよ う にパー ミ ッ シ ョ ンが設定されている必要があ り ます。 例えば、 UNIX 環境ではフ ァ イ

ルのパー ミ ッ シ ョ ンを 0600 (-rw-------) または 0400 (-r--------) に設定する必要があ り

ます。

ユーザ独自のプラ イベー ト ・ キー と証明書を提供するか、 または p4d -Gc を使用し てキー

と証明書のペアを生成する こ と ができ ます。 詳し く は、 『システム管理者ガ イ ド』 をご覧 く

ださい。

• ご使用のサーバのプラ イベー ト ・キー と証明書から フ ィ ンガープ リ ン ト を生成するには、p4d

-Gf を実行し ます。（P4SSLDIR には適切なフ ァ イル名 と パー ミ ッ シ ョ ンを設定する必要があ

り 、 現在の日付が証明書に対し て有効でなければな り ません。）

こ のフ ィ ンガープ リ ン ト をエン ド ユーザに通知する と、 エン ド ユーザはサーバが提供する

フ ィ ンガープ リ ン ト と管理者が提供し たフ ィ ンガープ リ ン ト と を比較でき ます。両者のフ ィ

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する な し 設定できない

OS 値

すべて P4SSLDIR に何らかの値が設定されている場合、P4SSLDIR で指定された

デ ィ レ ク ト リ 。 こ の値が未設定の場合、 あ るいは P4SSLDIR のパー ミ ッ

シ ョ ン または内容が不適切であ る場合、サービ スは SSL モード で開始され

ません。

/path/to/dir

306 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4SSLDIR

ンガープ リ ン ト が一致すれば、 ユーザは p4 trust を使用し てそのフ ィ ンガープ リ ン ト を自

分の P4TRUST フ ァ イルに追加でき ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 307

P4TARGET

308 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4TARGET

解説

PERFORCE プロ キシ ・ サーバおよびレプ リ カ ・ サーバがターゲ ッ ト とする PERFORCE サーバのホ

ス ト 名およびポー ト 番号です （P4P の場合は、 プロ キシ と し て動作する対象 と な る PERFORCE

サーバを示し ます。 レプ リ カ ・ サーバの場合はレプ リ カがターゲ ッ ト の メ タデータ、 バージ ョ

ン化フ ァ イル、 またはその両方のコ ピーを取得する対象と な る上位のマス ター ・ サーバまたは

レプ リ カ ・ サーバを示し ます。）

使用上の留意点

明示的に設定されない場合の値

使用例

注

P4TARGET の形式は host:port です。 または、 PERFORCE サーバおよびプロ キシ （レプ リ カ） が

同じ ホ ス ト 上で動作し ている場合は、 単に port です。

ポー ト 番号は、 1024 から 32767 の範囲になければな り ません。

PERFORCE プロ キシまたは複製環境に関する詳細情報は、『 システム管理者ガイ ド』 をご覧 く だ

さ い。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コ マン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する p4p -t host:portp4d -t host:port

適用外

プログラム 値

PERFORCE プロ キシ perforce:1666

複製された環境 な し

PERFORCE サーバでの使用例

1818

master:11111

perforce.example.com:1234

192.168.0.123:1818

P4TICKETS

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 309

P4TICKETS

解説

p4 login で使用されるチケ ッ ト ・ フ ァ イルの場所を示し ます。

使用上の留意点

明示的に設定されない場合の値

使用例

注

P4TICKETS 環境変数は、 p4tickets.txt または .p4tickets が存在する と 思われるデ ィ レ ク

ト リ ではな く 、 チケ ッ ト ・ フ ァ イルその ものを表す必要があ り ます。 P4TICKETS にデ ィ レ ク ト

リ 名を指定する と、 ロ グ イ ンでき な く な り ます。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用する N/A 設定でき る

OS 値

Windows %USERPROFILE%\p4tickets.txt

その他すべて $HOME/.p4tickets

/staff/username/p4tickets.txt

P4TRUST

310 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

P4TRUST

解説

ト ラ ス ト ･フ ァ イルには SSL 接続のために受領し たキーのフ ィ ンガープ リ ン ト が含まれます。

これは p4 trust コマン ド によ って制御されます。

使用上の留意点

明示的に設定されない場合の値

注

PERFORCE サーバによ って提供されたフ ィ ンガープ リ ン ト （またはフ ィ ンガープ リ ン ト への変

更）が正しいかど う かを確認する際は、システム管理者にサポー ト し て も ら う と よいでし ょ う 。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用し ない 使用する な し 適用外

プログラム 値

すべて $HOME/.p4trust

P4USER

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 311

P4USER

解説

現在の PERFORCE ユーザ名です。

使用上の留意点

明示的に設定されない場合の値

使用例

注

デフ ォル ト では、 PERFORCE のユーザ名は OS のユーザ名 と同じです。

あ る PERFORCE ユーザがパス ワード を設定し ていない場合、 他の PERFORCE ユーザの誰もが、

PERFORCE のコマン ド を -u オプシ ョ ン付きで実行する こ と によ り 、 パス ワード 未設定のユーザ

の権限でコマン ド を実行する こ と ができ ます。 これを防ぐ ため、 ユーザは p4 user コマン ド

または p4 passwd コマン ド でパス ワー ド を設定する必要があ り ます。

あ るユーザが PERFORCE パス ワー ド を設定し ていて も、 （そのパス ワード を知っている） 他の

ユーザの誰もが、 p4 -u username -P password command を使用する こ と によ り 、 そのユー

ザ と し て コマン ド を実行でき ます。

PERFORCE スーパー ・ ユーザは、 あ るユーザのパス ワー ド を知ら な く て も、 そのユーザ と し て

コマン ド を実行する こ と ができ ます。 詳し く は、 『システム管理者ガイ ド』 をご覧 く だ さい。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -u username command 設定でき る

OS 値

Windows 環境変数 USERNAME の値。

Windows 以外 環境変数 USER の値。

edk

lisag

PWD

312 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

PWD

解説

PERFORCE のコマン ド を実行する際、 引数 と し て与え られたフ ァ イル名を相対パスで解決する

ためのデ ィ レ ク ト リ です。

使用上の留意点

明示的に設定されない場合の値

注

変数 PWD は、 シェル間で適切に継承されないこ と があ り ます。 例えば、 csh に加えて ksh また

は sh を実行し ている場合、 PWD は csh 環境から継承されますが、 適切に更新されないため、

以降の PERFORCE コマン ド で混乱を招 く 可能性があ り ます。

こ のよ う な問題に直面し た と きは、 .profile フ ァ イルまたは .kshrc フ ァ イルで PWD を設定

解除し たかど う かを確認し て く だ さい。 （sh または ksh を ロ グ イ ン ・ シェル と し て実行し てい

る場合、 ス ター ト ア ッ プ ・ フ ァ イルでどんな設定解除を し て も、 PWD はシェルによ って適切に

管理されます。 混乱は、 変数がサブシェルにエ ク スポー ト される と きにのみ起き ます。）

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用し ない p4 -d directory command 設定でき ない

OS 値

UNIX シ ェ ルで設定 さ れ た PWD の値。 シ ェ ルで設定 さ れ て い な い場合は、

getcwd() が使用されます。

UNIX 以外 現在の作業デ ィ レ ク ト リ 。

TMP, TEMP

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 313

TMP, TEMP

解説

PERFORCE アプ リ ケーシ ョ ン と PERFORCE サービ スが一時フ ァ イルを書き込むデ ィ レ ク ト リ で

す。

使用上の留意点

明示的に設定されない場合の値

注

TEMP が設定されていれば、 TEMP が使用されます。 そ う でない場合、 TMP が設定されていれば、

TMP が使用されます。TEMP と TMP のどち ら も設定されていなければ、一時フ ァ イルは上の表に

記述されているデ ィ レ ク ト リ に書き込まれます。

ク ラ イアン ト が

使用するか ?

サーバが

使用するか ?

同様に機能する コマン ド ラ イ ン P4CONFIG フ ァ イルで

設定できるか ?

使用する 使用する な し 設定でき ない

OS 値

UNIX /tmp

UNIX 以外 PERFORCE アプ リ ケーシ ョ ンでは 現在の作業デ ィ レ ク ト リ 。

PERFORCE サーバでは P4ROOT

追加情報

314 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

追加情報

こ のセ ク シ ョ ンは、 複数のコマン ド で使用する PERFORCE の機能を説明し ています。 以下の項

目に関する情報が記載されています。

• あ ら ゆる PERFORCE コマン ド で使用でき るオプシ ョ ン

• デ ィ ポ ・ シン タ ッ ク ス、 ク ラ イ アン ト ・ シン タ ッ ク ス、 およびローカル ・ シン タ ッ ク スでの

PERFORCE フ ァ イル指定の使用方法

• PERFORCE のフ ァ イルタ イプ

• ク ラ イ アン ト ・ ワーク スペース、 ブラ ンチ、 およびラベルを記述する ビ ューの作成方法 と使

用方法

上記や他 の 項目 の 基本的 な 考 え 方お よ び詳細 な 情報 に つ い て は、 弊社 ウ ェ ブ サ イ ト

http://www.perforce.com にあ る 『PERFORCE 概要』 をご覧 く だ さい。

グ ローバル ・ オプシ ョ ン

グローバル ・ オプシ ョ ン

概要

PERFORCE コマン ド のためのグ ローバル ・ オプシ ョ ンです。 これらのオプシ ョ ンは、 コマン ド

ラ イ ンで PERFORCE コマン ド に先行させて入力可能です。

構文

p4 [-bbatchsize -cclient -ddir -Hhost -pport -Ppass -uuser -xfile -Ccharset -Qcharset -Llanguage] [-I] [-G] [-s] [-z tag] cmd [args ...]p4 -Vp4 -h

オプシ ョ ン

-b batchsize -x argfile オプシ ョ ンによ り コマン ド をフ ァ イルから実行する際に使用する

バッチサイ ズ ( 引数の数 ) を指定し ます。 デフ ォル ト では、 バッチサイ ズは 128

です。

-c client P4CLIENT の設定を、 指定し た ク ラ イ アン ト 名でオーバーラ イ ド し ます。

-d dir PWD の設定 （現在の作業デ ィ レ ク ト リ ） をオーバーラ イ ド し、指定し たデ ィ レ ク

ト リ に置換し ます。

-I 進捗イ ンジケータ （利用可能であ る場合） を使用し たい旨を指定し ます。

このオプシ ョ ンは、 -S および -G と同時に使用でき ません。

-G すべての出力 （お よ び -i オプシ ョ ン付き コ マン ド のためのバ ッ チ入力） を

Python デ ィ レ ク ト リ ・ オブジェ ク ト と し てフ ォーマ ッ ト し ます。 これは、 ス ク

リ プ ト 作成時に も多 く 使用されます。

-H host P4HOST の設定をオーバーラ イ ド し、 指定し たホス ト 名に置換し ます。

-p port P4PORTの設定を、指定されたprotocol:host:portでオーバーラ イ ド し ます。

-P pass P4PASSWD の設定を、 指定し たパス ワード でオーバーラ イ ド し ます。

-r retries ネ ッ ト ワークがタ イ ムア ウ ト し た場合にコマン ド （特に p4 sync） を再試行す

る回数を指定し ます。

-s PERFORCE コマン ド が生成する出力の各行の先頭に、 解説フ ィ ール ド （例えば、

text:、 info:、 error:、 exit:） を付加し ます。 こ れは、 ス ク リ プ ト 作成時

に も多 く 使用されます。

-u user P4USER、USER、および USERNAME の設定を、指定し たユーザ名でオーバーラ イ

ド し ます。

-x argfile 指定し たフ ァ イルから 1 行につき 1 つの引数を読み取る よ う 、 PERFORCE に指示

し ます。 フ ァ イルが 1 つのハイ フン （-） であ る場合は、 標準入力から読み取 り

ます。

-C charset P4CHARSET の設定を、 指定し たキ ャ ラ ク タ ・ セ ッ ト でオーバーラ イ ド し ます。

-Q charset P4COMMANDCHARSET の設定を、 指定し たキ ャ ラ ク タ ・ セ ッ ト でオーバーラ イ

ド し ます。

-L language この機能は、 システム管理者向けに用意されています。

-z tag 多 く のレポー ト 作成コマン ド の出力を、 p4 fstat によ り 生成される タ グ付き

フ ォーマ ッ ト と同じ形式にし ます。

-q ク ワ イ エ ッ ト ・ モー ド。 すべての情報伝達 メ ッ セージを抑止し、 警告またはエ

ラーのみを報告し ます。

-V p4 アプ リ ケーシ ョ ンのバージ ョ ンを表示し、 コマン ド を終了し ます。

-h 基本的な使用方法を表示し、 コマン ド を終了し ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 315

グ ローバル ・ オプシ ョ ン

使用上の留意点

• グ ローバル・オプシ ョ ンは、コマン ド ラ イ ンで PERFORCE コマン ド に先行させて指定し なけれ

ばな ら ない こ と に注意し て く だ さい。 PERFORCE コマン ド の後に続けて指定し たオプシ ョ ン

は、 グ ローバル ・ オプシ ョ ン と はみな されず、 実行し よ う と し ている コマン ド のためのオプ

シ ョ ン とみな されます。 し たがって、 同じ コマン ド ラ イ ンで同じオプシ ョ ンを 2 回指定する

こ と が可能で、 それぞれ別々の もの とみな されます。

例えば、 コマン ド p4 -c anotherclient edit -c 140 file.c は、 ク ラ イ アン ト ・ ワーク

スペース anotherclient 内で、 作業中チェ ンジ リ ス ト 140 に含まれる フ ァ イル file.c を

編集のための作業状態にし ます。

• -x オプシ ョ ンは、何度も繰 り 返す必要のあ る単純な タ ス ク を自動化するのに便利です。例え

ば、 一度に数個のフ ァ イルを追加し たい場合、 こ れら のフ ァ イルの名前を記述し たテキ ス

ト ・ フ ァ イル textfile を作成し、 p4 -x textfile add を実行する と、 これらのフ ァ イル

を一度に追加でき ます。

-x オプシ ョ ンは、入力そのものを生成し て し ま う と言っていいほど、使い方によ ってはきわ

めて強力な ものにな り ます。 例えば、 UNIX の開発者が、 file.h を イ ン クルード し ているす

べてのフ ァ イルを編集し よ う と し ている と仮定し ます。 こ の場合は、 例えば

grep -l file.h *.c | cut -f1 -d: | p4 -x - edit

を使用する こ と ができ ます。

こ の例の場合、 grep コマン ド は、 すべての *.c フ ァ イルにおける file.h の出現を リ ス ト

し ます。 -l オプシ ョ ンは、 各フ ァ イルを 1 回だけ リ ス ト する よ う grep に指示し ます。 そ し

て cut コマン ド によ って、 grep の出力から フ ァ イル名を分離し、 その出力を p4 -x コマン

ド に渡し ます。

• -s オプシ ョ ンは、 自動化されたス ク リ プ ト において使用する と便利です。

例えば、 p4 -s コマン ド を実行し、 info: で始ま る あ らゆる出力行を廃棄し、 error: で始

ま る出力行があ る場合はユーザに警告する、 と いった内製のビル ド ・ プ ロ セスの一部 と し

て、 ス ク リ プ ト を記述する こ と ができ ます。

• Python の開発者がス ク リ プ ト を作成する際、-G オプシ ョ ンはたいへん有用です。例えば、ID

が分かっている ジ ョ ブのフ ィ ール ド についてデ ィ レ ク ト リ を得る場合、次のよ う に実行し ま

す。

job_dict = marshal.load(os.popen(’p4 -G job -o ’ + job_id, ’rb’))

ク ラ イ アン ト ・ プ ロ グ ラ ムがどのキーを使用する か、 すぐには分か ら ないケースがあ り ま

す。 p4 -G の出力をパイプで下記のス ク リ プ ト に渡し た場合、 各レ コード はキー / 値の組で

表示されます。

#!/usr/local/bin/python

import marshal, sys

try: num=0 while 1: num=num+1 print ’\n--%d--’ % num dict = marshal.load(sys.stdin, ’rb’) for key in dict.keys(): print "%s: %s" % (key,dict[key])

except EOFError: pass

316 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

グ ローバル ・ オプシ ョ ン

Windows 上で Python を使用する開発者は、潜在的な CR/LF 変換に注意する必要があ り ます。

上の例において、 バイナ リ （“rb”） モー ド でデータ を読む場合、 marshal.load() を呼び出

す必要があ り ます。

• 現時点では、 -I オプシ ョ ンの使用によ り リ ク エス ト される進捗イ ンジケータは p4 -I

submit および p4 -I sync -q によ ってのみ提供されます。

• グ ローバル ・ オプシ ョ ンは、 使い方によ っては無意味な もの と な り ます。 例えば、 p4 -c

workspace help の出力は、 p4 help の出力 と全 く 同じです。

使用例

p4 -p new_service:1234 sync 環境変数 P4PORT の設定に関わ り な く 、 new_service の

ポー ト 1234 に接続し た後、 同期を実行し ます。

p4 -c new_client submit -c 100 初の -c は、 ク ラ イ アン ト ・ ワーク スペース名を指定する

グ ローバル ・ オプシ ョ ンです。 2 番目の -c は、 チェ ンジ リ

ス ト 番号を指定し ます。

p4 -s -x filelist.txt edit filelist.txt がフ ァ イルの リ ス ト を含む場合、 このコマ

ン ド は リ ス ト にあ る 各フ ァ イ ルを編集目的で作業状態に

し、 ス ク リ プ ト によ る解析に適し た出力を生成し ます。

こ の場合、 error: で始ま る行があ るか出力を調べる こ と

によ り 、自動化された p4 edit コマン ド の結果と し てのエ

ラー （例えば、 filelist.txt の リ ス ト にあ る フ ァ イルが

見つから ない） を簡単に検出でき ます。

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 317

フ ァ イル指定

フ ァ イル指定

概要

ク ラ イ アン ト ・ シン タ ッ ク ス、 デ ィ ポ ・ シン タ ッ ク ス、 またはローカル ・ シン タ ッ ク ス中のあ

ら ゆる PERFORCE コマン ド において、 どんなフ ァ イルで も指定でき ます。 ワーク スペース名と

デ ィ ポ名は、 同じ ネーム スペース を共有し ている ため、 PERFORCE サービ スがワーク スペース

名とデ ィ ポ名を混同する こ と は決し てあ り ません。

シン タ ッ クス ・ フ ォーム

ローカル ・ シン タ ッ ク スは、 ローカル ・ シェルか OS で指定されたフ ァ イル名を参照し ます。

ローカル ・ シン タ ッ ク スで参照される フ ァ イル名は、 フ ァ イル名の絶対パス、 または現在の作

業デ ィ レ ク ト リ を起点 と する相対パスで指定可能です。 （相対パスの構成要素は、 フ ァ イル指

定子の 初の部分にしか現れません。）

PERFORCE には、 OS が異なって も変わる こ と のない独自のフ ァ イル指定方法があ り ます。 フ ァ

イルが ク ラ イ アン ト ・ ルー ト を起点とする相対パスで指定された場合、 フ ァ イルはク ラ イ アント ・ シン タ ッ ク スで示されている と い う こ と にな り ます。 また、 デ ィ ポの 上層を起点とする

相対パスで指定された場合は、 デ ィ ポ ・ シン タ ッ ク スで示されている と い う こ と にな り ます。

こ のどち らかで指定されたフ ァ イルは、 PERFORCE シン タ ッ ク スで指定された と言えます。

PERFORCE のフ ァ イル指定子は常に 2 つのス ラ ッ シ ュ （//） で始ま り 、 その後に ク ラ イ アン ト

かデ ィ ポの名前、 さ らにその後に ク ラ イ アン ト かデ ィ ポのルー ト ・ デ ィ レ ク ト リ を起点とする

フ ァ イルのフル ・ パス名が続き ます。

ク ラ イ アン ト ・ シン タ ッ ク スおよびデ ィ ポ ・ シン タ ッ ク スのパス構成要素は、 ローカルの OS

やシェルが使用する構成要素区切 り 文字に関わ り な く 、 常にス ラ ッ シュ （/） で区切られます。

各シン タ ッ ク スの例を以下に示し ます。

ワイルド カー ド

PERFORCE システムでは、 3 つのワ イル ド カード が使用でき ます。

使用例を以下に示し ます。

構文 例

ローカル ・ シン タ ッ ク ス /staff/user/myworkspace/file.c

デ ィ ポ ・ シン タ ッ ク ス //depot/source/module/file.c

ク ラ イ アン ト ・ シン タ ッ ク ス //myworkspace/file.c

ワイルド カー ド 意味

* 1 つのデ ィ レ ク ト リ 内で、 ス ラ ッ シュ を除 く すべての文字に合致し ます。

... 現在の作業デ ィ レ ク ト リ お よ びすべてのサブデ ィ レ ク ト リ 内で、 すべての

フ ァ イ ルに合致し ます。 （つま り 、 複数のサブデ ィ レ ク ト リ にわた っ て、 ス

ラ ッ シュ も含めてすべてに合致し ます。）

%%1 - %%9 ビ ューの中で使用される と き、 フ ァ イル名中の部分文字列を再配列する ため

の位置指定子です。

式 一致する フ ァ イル

J* 現在のデ ィ レ ク ト リ にあ る、 J で始ま る フ ァ イル

*/help 現在のサブデ ィ レ ク ト リ にあ る、 help と い う 名前のすべてのフ ァ イル

./... 現在のデ ィ レ ク ト リ およびそのサブデ ィ レ ク ト リ にあ るすべてのフ ァ イル

./....c 現在のデ ィ レ ク ト リ およびそのサブデ ィ レ ク ト リ にあ る、 後に .c が付 く す

べてのフ ァ イル

318 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

フ ァ イル指定

リ ビジ ョ ン指定子の使用

フ ァ イル指定子は、 # か @ を付加する こ と によ り 修正でき ます。 これらのフ ァ イル指定子は、

デ ィ ポに保存されたフ ァ イルの特定 リ ビジ ョ ンを参照する ために使用し ます。

リ ビジ ョ ン指定子は、 一度に多 く のフ ァ イルを操作する ために使用する こ と がで き ます。 p4

sync //myclient/...#4 は、作業状態にないすべてのフ ァ イルの 4 番目の リ ビジ ョ ンを、ク ラ

イ アン ト ・ ワーク スペースにコ ピーし ます。

フ ァ イルを日付と時刻で指定する場合 （つま り file@datespec と い う 形式の指定子を使用す

る場合） 、 ローカル ・ シェルによ って日付指定子が単一 ト ーク ン と し て解釈される必要があ り

ます。 日付だけではな く 時刻を指定する ために日付指定子を使用する場合は、 日付指定子の前

後に引用符を使用し なければな ら ないこ と があ り ます。

/usr/bruno/... /usr/bruno の下にあ るすべてのフ ァ イル

//bruno_ws/... bruno_ws と い う 名前のワーク スペース またはデ ィ ポの下にあ る、 すべての

フ ァ イル

//depot/... 当該デ ィ ポにあ るすべてのフ ァ イル

//... すべてのデ ィ ポにあ るすべてのフ ァ イル

修飾子 意味

file#n リ ビジ ョ ン指定子 ： file の n 番目の リ ビジ ョ ン。

file#none

file#0

存在し ない リ ビジ ョ ン ： file の リ ビジ ョ ンがデ ィ ポに存在する場合、 その リ

ビジ ョ ンは無視されます。

これは、 デ ィ ポ内にあ る フ ァ イルをそのま まデ ィ ポ内に残す一方、 ク ラ イ ア

ン ト ・ ワ ー ク ス ペー ス か ら は削除 し たい と き に便利で、 例えば p4 sync file#none のよ う に使います。

フ ァ イル指定子 #0 は、 #none と同様に使用する こ と ができ ます。 存在し な

い リ ビジ ョ ン と は、 1 番目の リ ビジ ョ ンがデ ィ ポにサブ ミ ッ ト される前に 「存

在し ていた」 リ ビジ ョ ン と考える こ と ができ ます。

file#head file の 新 リ ビジ ョ ン。これは、明確に言及されている場合を除き、リ ビジ ョ

ン指定子な しでフ ァ イルを参照する こ と と同じです。

file#have 現在のク ラ イ アン ト にあ る リ ビジ ョ ン：p4 sync で 後に ク ラ イ アン ト ・ワー

ク スペースに同期させたフ ァ イルの リ ビジ ョ ン。

file@n チェ ンジ番号：チェ ンジ リ ス ト n がサブ ミ ッ ト された直後の file の リ ビジ ョ

ン。

file@=n チェ ンジ番号 ： 作業中チェ ンジ リ ス ト 番号 n の file の リ ビジ ョ ン。

file@labelname ラベル名 ： ラベル labelname 内の file の リ ビジ ョ ン。

file@clientname ク ラ イ アン ト 名 ： ク ラ イ アン ト ・ ワーク スペース clientname に 後に取 り

込まれた file の リ ビジ ョ ン。

削除されたフ ァ イル （つま り 、 新 リ ビジ ョ ンで削除目的でマーキング され

たフ ァ イル） はワーク スペースの一部であ る と はみな されません。

file@datespec 日付 と時刻：指定し た日付 と時刻における file の リ ビジ ョ ン。時刻を指定し

ない場合、指定し た日の午前 00:00:00 における 新 リ ビジ ョ ンが返されます。

日付と時刻は、yyyy/mm/dd:hh:mm:ss または yyyy/mm/dd hh:mm:ss の

形式で指定し ます （日付 と 時刻の間にスペースかコ ロ ンのどち ら かを入れま

す）。

日付指定子 @now は、現在の日時を指定するの と同様に使用する こ と ができ ま

す。

式 一致する フ ァ イル

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 319

フ ァ イル指定

保留されたフ ァ イルには、 p4 diff、 p4 diff2、 p4 files、 および p4 print の各コマン ド で

リ ビジ ョ ン指定子 @=change を使用し てア ク セスする こ と も可能です。 ただし、 change は作業

中チェ ンジ リ ス ト 番号を示し ます。

PERFORCE のフ ァ イル指定文字は、 ローカル ・ シェルによ って途中で取得され解釈されて し ま

う こ と があ り ます。 そのよ う な文字は、 使用する前にエス ケープし てお く 必要があ り ます。 例

えば、 # はたいていの UNIX シェルでコ メ ン ト 文字 と し て使用され、 / は （PERFORCE 以外の）

DOS コマン ド によ ってオプシ ョ ン指定子 と し て解釈されます。スペースが入っている フ ァ イル

名は、 コマン ド ラ イ ンにおいて引用符で囲まなければな ら ないこ と があ り ます。

これらの問題、 およびプラ ッ ト フ ォームに特有な他の問題については、 プラ ッ ト フ ォーム別の

リ リ ース ・ ノ ー ト をご覧 く だ さい。

リ ビジ ョ ン範囲の使用

PERFORCE コマン ド のい く つかは、 リ ビジ ョ ン範囲を使用し てフ ァ イル引数を変更する こ と が

でき ます。 リ ビジ ョ ン範囲は 2 つの別個の リ ビジ ョ ン指定子で、カンマによ って区切られます。

例えば、 p4 changes file#3,5 は、 フ ァ イル file の 3 番目、 4 番目、 および 5 番目の リ ビ

ジ ョ ンをサブ ミ ッ ト し たチェ ンジ リ ス ト を リ ス ト し ます。

リ ビジ ョ ン範囲には、 使用する コマン ド によ り 、 次のよ う に異な る 2 つの意味があ り ます。

• 指定し た範囲内にあ るすべての リ ビジ ョ ンに対し て、 コ マン ド を実行し ます。 例えば、 p4

jobs //...#20,52 は、どのフ ァ イルかに関わ り な く 、フ ァ イルの 20 番目から 52 番目までの

リ ビジ ョ ンをサブ ミ ッ ト し たチェ ンジ リ ス ト によ って修正された、すべてのジ ョ ブを リ ス ト

し ます。

リ ビジ ョ ン範囲は暗黙的に #1 で始ま り ます。 例えば、 p4 fixes //depot/file.c#5 とする

と、 リ ビジ ョ ン 1 から リ ビジ ョ ン 5 までに修正されたすべてのジ ョ ブを指し ます。（ リ ビジ ョ

ン 5 で修正されたジ ョ ブだけを表示するには、 p4 fixes //depot/file.c#5,5 と指定する

必要があ り ます。）

リ ビジ ョ ン範囲は、 p4 changes、 p4 fixes、 p4 integrate、 p4 jobs、 および p4 verify

コマン ド と と もに使用される場合、 上記のよ う に解釈されます。

• 指定し た範囲内で 大番号の リ ビジ ョ ンのみに対し て、 コマン ド を実行し ます。 例えば、 コ

マン ド p4 print file@30,50 は、 チェ ンジ リ ス ト 30 ～ 50 でサブ ミ ッ ト されたフ ァ イル

file の、 大番号の リ ビジ ョ ンを出力し ます。 これは、p4 print file@50 と は次のよ う に

異な り ます。 例えば、 フ ァ イル file の リ ビジ ョ ン #1 がチェ ンジ リ ス ト 20 でサブ ミ ッ ト さ

れ、フ ァ イル file の リ ビジ ョ ン #2 がチェ ンジ リ ス ト 60 でサブ ミ ッ ト された場合、p4 print

file@30,50は何も出力し ません（チェ ンジ リ ス ト 30～50でサブ ミ ッ ト されたフ ァ イルfile

の リ ビジ ョ ンは存在し ないので）。 これに対し、 p4 print file@50 は、 フ ァ イル file の リ

ビジ ョ ン 1 を出力し ます （チェ ンジ リ ス ト 50 の時点までにサブ ミ ッ ト されたフ ァ イル file

の リ ビジ ョ ンは リ ビジ ョ ン #1 なので）。

コマン ド p4 files、 p4 print、 および p4 sync はすべて、 こ のよ う に リ ビジ ョ ン範囲を使

用し ます。

リ ビ ジ ョ ン 範囲は、 非常に強力 な も の と な り え ま す。 例 え ば、 p4 changes file#3,

@labelname は、フ ァ イルfileの3番目の リ ビジ ョ ンから、ラベルlabelnameに保存されている

リ ビジ ョ ン までをサブ ミ ッ ト し たすべてのチェ ンジ リ ス ト を リ ス ト し ます。

フ ァ イル名およびエンテ ィ テ ィ に関する文字の制限

国際語化のサポー ト によ り 、 PERFORCE では、 印刷可能な非 ASCII 文字を フ ァ イル名、 ラベル

名、 ク ラ イ アン ト ・ ワーク スペース名、 およびその他の識別子に使用する こ と ができ ます。

パス名構成要素区切 り 記号 (/) は、 フ ァ イル名、 デ ィ ポ名、 ク ラ イ アン ト ・ ワーク スペース名

に使用する こ と はでき ませんが、 ラベル名、ジ ョ ブ名、ユーザ名の中に含める こ と ができ ます。

320 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

フ ァ イル指定

再帰的サブデ ィ レ ク ト リ ・ ワ イル ド カード (...) は、 フ ァ イル名、 ラベル名、 およびその他の識

別子に使用する こ と はでき ません。

PERFORCE リ ビジ ョ ン指定子ワ イル ド カー ド (@ と #)、 フ ァ イル一致ワ イル ド カー ド (*)、 また

は位置置換ワ イル ド カー ド (%%) がフ ァ イル名または任意のデ ィ レ ク ト リ 構成要素に含まれた

フ ァ イルを参照するには、 文字の 16 進値の ASCII 表現を使用し ます。 ASCII 拡張は、 以下の

4 つの文字にのみ適用されます。

status@june.txt などのフ ァ イルを追加するには、 次のよ う な コ マン ド を使用し て、 特殊文

字の文字解釈を強制し ます。

p4 add -f //depot/path/status@june.txt

チェ ンジ リ ス ト をサブ ミ ッ ト する と、 文字が自動的に拡張され、 次のよ う に変更サブ ミ ッ ト ・

フ ォームに表示されます。

//depot/path/status%40june.txt

フ ァ イルが追加されたチェ ンジ リ ス ト をサブ ミ ッ ト し た後で、そのチェ ンジ リ ス ト を ワーク ス

ペースに同期させる場合や、 ワーク スペース内で編集する場合は、 ASCII 拡張を使用する必要

があ り ます。

p4 sync //depot/path/status%40june.txtp4 edit //depot/path/status%40june.txt

特殊文字の大半は、 ク ロ スプラ ッ ト フ ォームの環境では、 原則 と し てフ ァ イル名には使用でき

ません。 UNIX ではパスの構成要素を / で区切 り ますが、 多 く の DOS コマン ド は / を コマン ド

ラ イ ンのオプシ ョ ン と し て解釈し ます。 たいていの UNIX シェルは # を コ メ ン ト の始ま り と し

て解釈し ます。 DOS および UNIX のシェルは両方 と も * を拡張し て複数のフ ァ イルに合致さ

せ、 DOS コマン ド ラ イ ンは % を変数の参照に使用し ます。

同様に、 非 ASCII 文字を フ ァ イル名と PERFORCE 識別子に使用する こ と は可能ですが、 それら

の文字を コマン ド ラ イ ンから入力する と きに、プラ ッ ト フ ォーム特有の解決策が必要にな る こ

と があ り ます。 GUI ベースのフ ァ イル ・ マネージ ャのユーザは、 こ の よ う なフ ァ イルを、 ド

ラ ッ グ ・ アン ド ・ ド ロ ッ プ操作で取 り 扱 う こ と ができ ます。

文字 理由

... PERFORCE ワ イル ド カード ： すべてに合致し、 カレ ン ト ・ デ ィ レ ク ト リ のレベルで機能

し、カレン ト ・ レベル以下のすべてのデ ィ レ ク ト リ ・ レベルにあ る フ ァ イルを含みます。

/ パス名の構成要素を区切る PERFORCE の区切 り 記号。

文字 ASCII 拡張

@ %40

# %23

* %2A

% %25

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 321

ビ ュー

ビ ュー

概要

ビ ューにはク ラ イ アン ト ・ビ ュー、ブラ ンチ・ビ ュー、およびラベル・ビ ューの 3種類があ り ます。

• ク ラ イ アン ト ・ ビ ューは、 デ ィ ポ内のフ ァ イルを ク ラ イ アン ト ・ ワーク スペース内のフ ァ イ

ルにマ ッ ピング し ます。

• ブラ ンチ ・ ビ ューは、 デ ィ ポ内のフ ァ イルをデ ィ ポの他の部分にマ ッ ピング し ます。

• ラベル ・ ビ ューは、 デ ィ ポにあ る フ ァ イルのグループを単一のラベルに関連付けます。

各タ イプのビ ューを構成する行は、デ ィ ポからのフ ァ イルを適切なネーム スペースにマ ッ ピン

グ し ています。 ク ラ イ アン ト ・ ビ ューおよびブラ ンチ ・ ビ ューのマ ッ ピングは、 2 つのフ ァ イ

ルの指定です。 マ ッ ピングの左側は常にデ ィ ポのネーム スペース を参照し、 マ ッ ピングの右側

はク ラ イ アン ト ・ワーク スペース またはデ ィ ポのネーム スペース を参照し ます。ラベル・ビ ュー

では、 マ ッ ピングの左側 （デ ィ ポのネーム スペース） のみ入力する必要があ り ます。 フ ァ イル

は自動的に特定のラベルに関連付け られます。

すべてのビ ューは、 デ ィ ポ内のフ ァ イル と、 ク ラ イ アン ト ・ ワーク スペース、 ブラ ンチ、 また

はラベル内のフ ァ イル と の間で一対一のマ ッ ピ ングを作成し ています。マ ッ ピングの 1 つ以上

の行が同じ フ ァ イルを参照し ている場合、 前のマ ッ ピングがオーバーラ イ ド されます。 ハイ フ

ン （-） で始ま る マ ッ ピ ングは、 そのマ ッ ピ ングに適合する フ ァ イルをすべて除外し ます。 ク

ラ イ アン ト ・ ビ ューでは、 プラ ス記号 (+) で始ま るマ ッ ピングが以前のマ ッ ピングをオーバー

レ イ し ます ( オーバーレ イ ・ マ ッ ピングはブラ ンチ ・ ビ ューやラベル ・ ビ ューでは適用されま

せん )。

マ ッ ピ ング内のフ ァ イル指定は通常の PERFORCE シン タ ッ ク スで入力でき ます。 // で始ま り

デ ィ ポ名ま たはワーク スペース名が続き、 さ ら にデ ィ ポ ま たはワーク スペース内での実際の

フ ァ イル名が続き ます。 （ リ ビジ ョ ン指定子をビ ューの中で使用する こ と はでき ません。）

使用上の留意点

ビ ューは、 p4 client、 p4 branch、 または p4 label コマン ド で、 それぞれク ラ イ アン ト ・

ワーク スペース、 ブラ ンチ ・ ビ ュー、 またはラベル ・ ビ ューを作成するプロセスの一部と し て

設定し ます。

ク ラ イ アン ト ・ ビ ューまたはブ ラ ンチ ・ ビ ュー内でのマ ッ ピ ングの順序は重要です。 例えば、

以下の 2 つのマ ッ ピングで定義される ビ ューがあ り ます。

//depot/... //ws/...//depot/dir/... //ws/dir2/...

こ の ビ ュ ー内では、 デ ィ ポは ク ラ イ ア ン ト ・ ワ ー ク スペース にマ ッ ピ ン グ さ れ、 フ ァ イ ル

//depot/dir/file.c は //ws/dir2/file.c にマ ッ ピング されます。 しかし、 ビ ュー内の行の

順序が逆になった と し ます。

//depot/dir/... //ws/dir2/...//depot/... //ws/...

する と 初のマ ッ ピング （フ ァ イルを //ws/dir2 にマ ッ ピング） が 2 番目のマ ッ ピ ング （デ ィ

ポ全体を ク ラ イ アン ト ・ ワーク スペースにマ ッ ピ ング） にオーバーラ イ ド されるので、 フ ァ イ

ル //depot/dir/file.c は //ws/dir/file.c にマ ッ ピ ング されます。 ビ ュー内で後にあ る

ビ ューが常に、 前にあ るマ ッ ピングをオーバーラ イ ド し ます。

パスおよびフ ァ イルの名前に含まれる空白

ワーク スペース ・ ビ ュー、 ブラ ンチ ・ ビ ューまたはラベル ・ ビ ューにあ るパスやフ ァ イルの名

前に空白が含まれる場合、 必ずパスに引用符を付けて く だ さい。

322 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

ビ ュー

//depot/v1/... "//ws/version one/..."

パスおよびフ ァ イルの名前に含まれる特殊文字

@、#、*、 または % の文字が含まれたフ ァ イル名やデ ィ レ ク ト リ 名をマ ッ ピングするには ( つま

り 、 それらの文字を PERFORCE ワ イル ド カード と し てではな く パスやフ ァ イル名の構成要素と

し て解釈するには )、 次のよ う にそれらの文字を等価の ASCII 表現に拡張し ます。

ク ラ イアン ト ・ ビ ュー

ク ラ イ アン ト ・ ビ ューは、 デ ィ ポ内のフ ァ イルを ク ラ イ アン ト ・ ワーク スペース内のフ ァ イル

にマ ッ ピング し ます （またはその逆） 。 ク ラ イ アン ト ・ ワーク スペース と は、 ユーザが作業を

行 う 領域で、 フ ァ イルはク ラ イ アン ト ・ ワーク スペースに同期され、 編集のための作業状態に

な り 、 編集され、 デ ィ ポにチェ ッ ク イ ン されます。

フ ァ イルが同期される と き、 フ ァ イルはデ ィ ポから ク ラ イ アン ト ・ ワーク スペース内のフ ァ イ

ルがマ ッ ピング されている場所にコ ピーされます。 同様に、 フ ァ イルがデ ィ ポにサブ ミ ッ ト さ

れる と きは、 マ ッ ピングが逆にな り 、 フ ァ イルはク ラ イ アン ト ・ ワーク スペースからデ ィ ポ内

のフ ァ イルの適切な場所にコ ピーされます。

以下の表は、 ク ラ イ アン ト ・ ビ ューのい く つかの例を リ ス ト にし ています。

文字 ASCII 拡張

@ %40

# %23

* %2A

% %25

ク ラ イアン ト ・ ビ ュー マ ッ ピングの例

デ ィ ポ全体にマ ッ ピ ン グ さ れた ク

ラ イ アン ト ・ ワーク スペース全体

//depot/... //ws/...

デ ィ ポの一部にマ ッ ピ ン グ さ れた

ク ラ イ アン ト ・ ワーク スペース全体

//depot/dir/... //ws/...

デ ィ ポ内のい く つかのフ ァ イルが、

ク ラ イ アン ト ・ ワーク スペースの別

の部分にマ ッ ピング されています。

//depot/... //ws/...//depot/rel1/... //ws/release1/...

デ ィ ポ内のい く つかのフ ァ イルが、

ク ラ イ アン ト ・ ワーク スペースから

除外されています。

//depot/dir/... //ws/...-//depot/dir/exclude/... //ws/dir/exclude/...

ク ラ イ アン ト ・ ワーク スペース内の

フ ァ イルが、 自身のデ ィ ポ名と は異

なる名前にマ ッ ピング されます。

//depot/dir/old.* //ws/renamed/new.*

デ ィ ポ内でのフ ァ イル名の一部が、

ク ラ イ アン ト ・ ワーク スペース内で

並べ替え られます。

//depot/dir/%%1.%%2 //ws/dir/%%2.%%1

フ ァ イ ルは両方向で見た と き に同

じ場所にマ ッ ピ ン グ さ れません。 2

行目が優先され、 1 行目は無視され

ます。

//depot/dir1/... //ws/build/...//depot/dir2/... //ws/build/...

オーバーレ イ ・ マ ッ ピングを使用し

て、 複数のデ ィ ポ ・ デ ィ レ ク ト リ を

ワ ー ク ス ペー ス 内 の 同 じ 場所 に

マ ッ ピング し ます。

//depot/dir1/... //ws/build/...+//depot/dir2/... //ws/build/...

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 323

ビ ュー

ク ラ イ アン ト ・ ビ ューを作成するには、 p4 client を使用し て、 デ ィ ポ内のフ ァ イルを ク ラ イ

アン ト ・ ワーク スペース内のフ ァ イルにどのよ う にマ ッ ピングするかを指定でき る画面を表示

し ます。

ブ ラ ンチ ・ ビ ュー

ソース ・ ツ リ ーのブラ ンチを作成する こ と によ り 、 複数のフ ァ イル ・ セ ッ ト を別のパス上で変

更する こ と ができ ます。 ブラ ンチ ・ ビ ューを作成する こ と によ って、 PERFORCE はブラ ンチ作

成に関連する フ ァ イルのコ ピーや編集の伝達作業を自動管理でき ます。

ブラ ンチ ・ ビ ューは、 デ ィ ポの既存の領域 （反映元フ ァ イル） をデ ィ ポの新しい領域 （反映先

フ ァ イル） にマ ッ ピング し ます。 ブラ ンチ ・ ビ ューはク ラ イ アン ト ・ ビ ューの定義に使用され

る方法 と ほぼ同じ方法で定義さ れますが、 フ ァ イルを直接ク ラ イ アン ト ・ ワーク スペースに

マ ッ ピングする と い う よ り は、 デ ィ ポ内のマ ッ ピングをセ ッ ト ア ッ プするだけです。 反映はど

ち らの方向にも実行される可能性があ る ため、 ブラ ンチ ・ ビ ュー内の各行ではどち らかの方向

を明確に示さ なければな り ません。 し たがって、 ブラ ンチ ・ ビ ューではオーバーレ イ ・ マ ッ ピ

ングは使用でき ません。

ブラ ンチ ・ ビ ューを作成するには、 p4 branch newbranch を使用し ます。 こ のコマン ド によ

り 画面 （p4 client で表示する画面と同様） が表示され、 メ イ ンの ソース ツ リ ーからの反映元

フ ァ イルを新しいブラ ンチの反映先フ ァ イルにマ ッ ピ ングでき ます。

ブラ ンチ ・ ビ ューが 初に作成された と きは、 フ ァ イルは 1 つも コ ピーされません。 フ ァ イル

を コ ピーするには、 それらのフ ァ イルを使用する目的で、 新し く 作成し たフ ァ イルが ク ラ イ ア

ン ト ・ ビ ューの中に確実に記述されていなければな り ません。 新し く マ ッ ピング されたデ ィ ポ

のブラ ンチを現ク ラ イ アン ト ・ ビ ューに追加し、 p4 sync コマン ド を実行すれば、 コ ピーは完

了し ます。

ラベル ・ ビ ュー

ラ ベル ・ ビ ューは、 デ ィ ポ内のフ ァ イ ルのセ ッ ト に ラ ベルを割 り 当て ます。 ク ラ イ ア ン ト ・

ビ ューやブラ ンチ ・ ビ ューと異な り 、 ラベル ・ ビ ューはフ ァ イルを コ ピーし ません。 ラベル ・

ビ ューを使用し て、 ラベルによ り タ グ付け可能なフ ァ イルのセ ッ ト を限定し ます。

ラベルを作成するには p4 label labelname を使用し、 ビ ューのデ ィ ポ ・ サイ ド を入力し ま

す。 ラベルはフ ァ イル と リ ビジ ョ ン ・ レベルの単なる リ ス ト であ る ため、 指定する必要があ る

のはビ ューのデ ィ ポ・サイ ド （左側） だけであ り 、オーバーレ イ ・マ ッ ピングは使用でき ません。

ブ ラ ンチ ・ ビ ュー マ ッ ピングの例

メ イ ンのコー ド ラ イ ンか ら新しいコー

ド のブラ ンチを作成し ます。

//depot/main/... //depot/1.1dev/...

新しい リ リ ースでデ ィ レ ク ト リ を並べ

替えます。

//depot/main/... //depot/1.1dev/...//depot/main/*.c //depot/1.1dev/src/*.c//depot/main/*.txt //depot/1.1dev/doc/*.txt

ラベル ・ ビ ュー マ ッ ピングの例

新しい リ リ ース //depot/1.1final/

新しい リ リ ースのためのソース コード //depot/1.1final/src/...

ク ラ イ アン ト に適し た配置 //depot/1.1final/bin/...//depot/1.1final/doc/...//depot/1.1final/readme.txt

324 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

フ ァ イルタ イプ

フ ァ イルタ イプ

概要

PERFORCE は、 6 つの基本フ ァ イルタ イプをサポー ト し ています。

• text フ ァ イル

• 圧縮された binary フ ァ イル

• Mac 本来の apple フ ァ イル

• Mac の リ ソース ・ フ ォーク （resource）

• シンボ リ ッ ク ・ リ ン ク （symlink）

• unicode フ ァ イルおよび utf16 フ ァ イル

これらの基本タ イプには、 RCS キーワー ド拡張やフ ァ イル圧縮などをサポー ト する ため、 フ ァ

イルタ イプ修飾子が適用されます。

フ ァ イルを追加する と きには、 PERFORCE はまずタ イプマ ッ プ ・ テーブルを調べ、 追加し よ う

と し ている フ ァ イルのフ ァ イルタ イ プをシ ス テム管理者が定義し ている かど う かを確かめま

す。 合致する ものが見つかれば、 そのフ ァ イルタ イプがタ イプマ ッ プ ・ テーブルの定義に従っ

て設定 さ れ ま す。 合致す る も の が見つか ら な い場合、 PERFORCE は構成可能変数

filesys.binaryscanに従って該当フ ァ イルの先頭のバイ ト を調べ(デフ ォル ト では65536バイ

ト )、 それが text か binary かを判断し た上で、 フ ァ イルをデ ィ ポに保存し ます。 デフ ォル ト

ではテ キ ス ト ・ フ ァ イ ルの リ ビ ジ ョ ン は リ バー ス デル タ 形式で保存 さ れ、 構成可能変数

filetype.maxtextsizeによ る制限値(デフ ォル ト では10MB) を超え る、新規に追加されたテキ

ス ト ・ フ ァ イルには text+C フ ァ イルタ イプが割 り 当て られて完全な形で保存されます。 .zip

形式 (.jar フ ァ イルを含む ) で圧縮されたフ ァ イルも自動的に検出され、 ubinary タ イプが割

り 当て られます。 その他のバイナ リ ・ フ ァ イルの リ ビジ ョ ンは、 圧縮されてフ ァ イル全体が保

存されます。

（Unicode 環境のフ ァ イルでは検出方法が異な り ます。 詳細については、 「PERFORCE 国際語モード に

関する注意事項 （i18nnotes.txt）」 をご覧 く ださい。）

PERFORCE の管理者は、 タ イプマ ッ プ機能 （p4 typemap） を使用し て PERFORCE のデフ ォル ト

のフ ァ イルタ イプ検出機構をオーバーラ イ ドする こ と ができ ます。 こ の機能は、 binary フ ァ

イル形式 （例えば、 Adobe 社の PDF や リ ッ チ ・ テキス ト 形式） に対し て有効です。binary フ ァ

イルは大量の ASCII テキ ス ト から始ま っている場合があ る ため、この機能がなければtext フ ァ

イル と間違え られて し ま う 可能性があ るからです。

PERFORCE 管理者は構成可能変数 filesys.binaryscan および filetype.maxtextsize を使用

し て（p4 configure 参照）、テキ ス ト / バイナ リ の検出に対するデフ ォル ト の制限であ る 65536

バイ ト と、 RCS テキ ス ト ・ フ ァ イルのサイ ズ制限であ る 10MB をそれぞれ変更する こ と ができ

ます。

基本フ ァ イルタ イプ

PERFORCE の基本フ ァ イルタ イプは、 次の とお り です。

キーワー ド 解説 注釈 サーバ記憶

text テキス ト ・ フ ァ イル テ キ ス ト と し て ワー ク スペース に同期 さ れ

ます。 行末変換は自動的に実行されます。

RCS 形式のデルタ

binary 非テキス ト ・ フ ァ イル バイナ リ ・ フ ァ イル と し てワーク スペースに

同期されます。 デ ィ ポ内に圧縮し て格納され

ます。

フル ・ フ ァ イル

圧縮

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 325

フ ァ イルタ イプ

フ ァ イルタ イプ修飾子

フ ァ イルタ イプ修飾子は、 次のよ う になっています。

symlink シンボ リ ッ ク ・ リ ン ク UNIX、 OS X ま た は 近のバー ジ ョ ン の

Windows環境にあ る PERFORCEアプ リ ケーシ ョ

ンでは、 これらのフ ァ イルはシンボ リ ッ ク リ

ン ク と し て扱われます。 その他のプ ラ ッ ト

フ ォームでは、 これらのフ ァ イルは （小さい）

テキス ト ・ フ ァ イル と同様に示されます。

RCS 形式のデルタ

apple マルチ・ フ ォーク Mac

フ ァ イル

Mac のデータ ・ フ ォーク、 リ ソース ・ フ ォー

ク、 フ ァ イルタ イプ、 およびフ ァ イル ・ ク リ

エーターの AppleSingle 記憶。

詳細については、 Mac ク ラ イ アン ト の リ リ ー

ス ・ ノー ト をご覧 く ださい。

フル ・ フ ァ イル

圧縮、 AppleSingle

形式

resource Mac リ ソース ・ フ ォー

ク

PERFORCE 99.1 以前における Mac リ ソース ・

フ ォーク の唯一のフ ァ イルタ イプ。 サポー ト

は続けていますが、apple フ ァ イルタ イプの

使用がよ り 適切です。

詳細については、 Mac ク ラ イ アン ト の リ リ ー

ス ・ ノー ト をご覧 く ださい。

フル ・ フ ァ イル

圧縮

unicode Unicode フ ァ イル Unicode モード で動作する PERFORCE サービ ス

は、 unicode フ ァ イルタ イ プをサポー ト し

ます。 これらのフ ァ イルは、 P4CHARSET に

よ り 指定 さ れ た ロ ー カ ルの文字 セ ッ ト に

コード変換されます。

Unicode モード ではない PERFORCE サービ ス

は、 unicode フ ァ イルタ イ プをサポー ト し

ません。

詳細については、 「PERFORCE 国際語モード に

関する注意事項 （i18nnotes.txt）」 をご覧

く ださい。

UTF-8 形式の RCS

デルタ

utf16 Unicode フ ァ イル サービ スが Unicode モード で動作し ているか

否かにかかわらず、フ ァ イルは UTF-8 で転送

され、 UTF-16 （BOM 付き、 ユーザのマシン

に適切なバイ ト 順） にコード変換されます。

詳細については、 「PERFORCE 国際語モード に

関する注意事項 （i18nnotes.txt）」 をご覧

く ださい。

UTF-8 形式の RCS

デルタ

修飾子 解説 注釈

+w フ ァ イルは常に ク ラ イ アン ト で書き

込み可能です。

+x ク ラ イ ア ン ト で実行権 を付与 し ま

す。

実行フ ァ イルに使用し ます。

+ko 旧式のキーワード拡張 $Id$ と $Header$ キーワード のみを拡張し ます。

こ の修飾子は本来、 PERFORCE の 2000.1 よ り 前の

バージ ョ ン と の下位互換性を保つための も ので、

PERFORCEの旧バージ ョ ンの+k (ktext)修飾子に対

応し ています。

キーワー ド 解説 注釈 サーバ記憶

326 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

フ ァ イルタ イプ

フ ァ イルタ イプは通常 リ ビジ ョ ン間で保持されますが、 add、 edit、 または reopen 操作中に

-t オプシ ョ ンでオーバーラ イ ドや変更する こ と ができ ます。

• p4 add -t filetype filespec は、 指定し たフ ァ イルタ イプでフ ァ イルを追加し ます。

• p4 edit -t filetype filespec は、 指定し たフ ァ イルタ イプで、 フ ァ イルを編集のため

の作業状態にし ます。フ ァ イルタ イプは、デ ィ ポにサブ ミ ッ ト し た と きに指定し た filetype

に変わ り ます。

+k RCS キーワード拡張 RCS （Revision Control System ： リ ビジ ョ ン管理シス

テム） キーワード を拡張し ます。

RCS キーワード は、 大文字と小文字を区別し ます。

フ ァ イルの中でキーワード を使用する と きは、キー

ワード の後のコ ロ ン （例えば、 $Id:$） は省略可能

です。

サポー ト し ている キーワード は、 次の とお り です。

･ $Id$

･ $Header$

･ $Date$

･ $DateTime$

･ $Change$

･ $File$

･ $Revision$

･ $Author$

+l 排他的な作業状態にする （ロ ッ ク）。 設定する と、フ ァ イルを編集のための作業状態にで

き るのは、 同時に 1 人だけにな り ます。

複数の開発者に よ る変更をマージ し て も意味をな

さ ないバイナ リ ・ フ ァ イルタ イプ （例えば図表） に

対し て有効です。

+C PERFORCE は、 各フ ァ イル ・ リ ビジ ョ

ンの完全圧縮バージ ョ ンを格納し ま

す。

バイナ リ ・ フ ァ イル、および 10MB を超え る新規追

加のテキス ト ・フ ァ イルに対するデフ ォル ト の格納

機構。

+D PERFORCE は、 デルタ を RCS 形式で

格納し ます。

テキ ス ト ・ フ ァ イルに対するデフ ォル ト の格納機

構。

+F PERFORCE は、 リ ビ ジ ョ ン ご と にフ

ル ・ フ ァ イルを、 圧縮せずに格納し

ます。

サ イ ズが大きいバイナ リ ・ フ ァ イルや、 PostScript

フ ァ イルの よ う にユーザがテキ ス ト と 読み取れな

い長い ASCII フ ァ イルに対し て有効です。

+S 新 リ ビ ジ ョ ン だけが格納 さ れ ま

す。

新しい リ ビジ ョ ンがサブ ミ ッ ト される と、古い リ ビ

ジ ョ ンはデ ィ ポから消去されます。実行フ ァ イルま

たは .obj フ ァ イルに対し て有効です。

+Sn 新の n 個の リ ビジ ョ ンだけが格納

されます。 n は 1 から 10 まで、 また

は 16、 32、 64、 128、 256、 512 のい

ずれかの数値です。

新しい リ ビジ ョ ンを n 個を超えてサブ ミ ッ ト する

か、 既存の +Sn フ ァ イルの n を現在の リ ビジ ョ ン

数よ り 少ない値に変更する と、古い リ ビジ ョ ンは消

去されます。 古い リ ビジ ョ ンには反映されません。

詳し く は 「使用上の留意点」 をご覧 く ださい。

+m オ リ ジナルの修正時刻 を保存 し ま

す。

フ ァ イルのローカル・フ ァ イルシステム上のタ イ ム

ス タ ンプが、サブ ミ ッ ト の と きに保存、同期の と き

に リ ス ト ア さ れます。 Windows 環境におけ るサー

ド ・ パーテ ィ 製の DLL に対し て有効です。

+X アーカ イブ・ ト リ ガを必要と し ます。 PERFORCE サー ビ ス は フ ァ イ ルへの ア ク セ ス に

archive ト リ ガを実行し ます。 詳し く は 『システ

ム管理者ガイ ド』 をご覧 く ださい。

修飾子 解説 注釈

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 327

フ ァ イルタ イプ

• p4 reopen -t filetype filespec は、 すでに追加や編集のための作業状態になっている

フ ァ イルのタ イプを変更し ます。

引数 filetype は、 [basetype]+modifiers のよ う に指定し ます。 例えば、 script.sh のタ イ

プを実行フ ァ イル・テキス ト に変更し、RCS キーワード拡張を行 う には、p4 edit -t text+kx

script.sh を使用し ます。

部分フ ァ イルタ イプも使用する こ と ができ ます。例えば既存のテキス ト フ ァ イルを text+x に

変更し たい場合、 p4 reopen -t +x script.sh と し ます。 多 く の部分フ ァ イルタ イプ修飾子

は、 フ ァ イルタ イプに付加する も のですが、 格納修飾子 (+C、 +D、 +F) を使 う と フ ァ イルの格

納形式が変更されます。 修飾子を消去し たい場合はフル ・ フ ァ イルタ イプを指定し なければな

り ません。

一般的なフ ァ イル拡張子に対する PERFORCE のフ ァ イルタ イプ

以下の表に、 一般的なフ ァ イル拡張子と、 それに対する PERFORCE フ ァ イルタ イプおよび修飾

子を示し ます。

PERFORCE のフ ァ イルタ イプ と フ ァ イル名と のマ ッ ピングについての詳細は、 p4 typemap コマ

ン ド をご覧 く だ さい。

フ ァ イルタ イプ PERFORCE

フ ァ イルタ イプ

説明

.asp text ア ク テ ィ ブサーバページ ・ フ ァ イル

.avi binary+F Windows ビデオ ・ フ ァ イル

.bmp binary Windows ビ ッ ト マ ッ プ ・ フ ァ イル

.btr binary Btrieve データベース ・ フ ァ イル

.cnf text カンフ ァ レ ン ス ・ リ ン ク ・ フ ァ イル

.css text カスケード ・ ス タ イルシー ト ・ フ ァ イル

.doc binary Microsoft Word フ ァ イル

.dot binary Microsoft Word テンプレー ト

.exp binary+w エ ク スポー ト ・ フ ァ イル （Microsoft Visual C++）

.gif binary+F GIF 画像フ ァ イル

.gz binary+F GZIP 圧縮フ ァ イル

.htm text HTML フ ァ イル

.html text HTML フ ァ イル

.ico binary ア イ コ ン ・ フ ァ イル

.inc text ア ク テ ィ ブサーバ ・ イ ン クルード ・ フ ァ イル

.ini text+w アプ リ ケーシ ョ ン初期設定フ ァ イル

.jpg binary JPEG 画像フ ァ イル

.js text Java ス ク リ プ ト 言語ソース コード ・ フ ァ イル

.lib binary+w ラ イブラ リ フ ァ イル （複数のプロ グ ラ ミ ング言語）

.log text+w ロ グフ ァ イル

.mpg binary+F MPEG ビデオ ・ フ ァ イル

.pdf binary Adobe PDF フ ァ イル

.pdm text+w Sybase Power Designer フ ァ イル

.ppt binary Microsoft PowerPoint フ ァ イル

.xls binary Microsoft Excel フ ァ イル

328 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

フ ァ イルタ イプ

キーワー ド拡張

RCS キーワード は、 次のよ う に拡張されます。

使用上の留意点

• すでに存在する フ ァ イルのタ イプは、 p4 opened か p4 files で判断でき ます。

• デルタ記憶 （テキ ス ト ・ フ ァ イルのデフ ォル ト 方式） は、 フ ァ イルの リ ビジ ョ ン間の差分

（つま り 、 デルタ） だけを保存する方法です。 フル ・ フ ァ イル記憶 （バイナ リ ・ フ ァ イルで

のデフ ォル ト 方式） は、 フ ァ イル全体を保存し ます。 フ ァ イルタ イプによ り 、 フル ・ フ ァ イ

ル記憶 とデルタ記憶のどち ら を使用するかが決ま り ます。 PERFORCE は、 デルタ記憶に RCS

形式を使用し ます。

• フ ァ イルタ イプによ っては、デ ィ ポ内に保存する ために gzip 形式に圧縮されます。圧縮はサ

ブ ミ ッ ト のプロセス中に行われ、 解凍は同期中に行われます。 プロセスはユーザに対し て透

過的です。 ク ラ イ アン ト ・ ワーク スペースには常にサブ ミ ッ ト し た と きのフ ァ イルがあ り ま

す。

• 非 UNIX ク ラ イ アン ト ・ ワーク スペース上のシンボ リ ッ ク ・ リ ン クは、 リ ン ク先のフ ァ イル

への相対パス を含む小さ なテキス ト ・ フ ァ イル と し て表示されます。 非 UNIX ク ラ イ アン ト

で これらのフ ァ イルを編集する と きは注意し て く だ さい。これらのフ ァ イルをデ ィ ポにサブ

ミ ッ ト する と、 シンボ リ ッ ク ・ リ ン ク が UNIX ク ラ イ アン ト ・ ワーク スペース上に存在し な

いフ ァ イルを指示する こ と にな る場合があ るからです。

• フ ァ イルタ イプを変更し て も、 デ ィ ポに保存された以前の リ ビジ ョ ンには影響し ません。

例えば、 +Sn （一時オブジェ ク ト ） 修飾子を追加する こ と によ り フ ァ イルタ イプを変更する

こ と は、 デ ィ ポ内のフ ァ イルの 新 n 個の リ ビジ ョ ンのみを保存する よ う PERFORCE に通知

し た こ と にな り ます。 既存のフ ァ イルを一時オブジェ ク ト に変更し た場合、 それ以降 （n 番

目よ り 後） は古 く なった 新 リ ビジ ョ ンが消去される よ う にな り ますが、 +Sn 修飾子を追加

する前の リ ビジ ョ ンについては影響を受けません。 （+Sn 修飾子を追加し た後の 新でない

リ ビジ ョ ンを同期し よ う とする と、 そのフ ァ イルはク ラ イ アン ト ・ ワーク スペースから削除

されます。 このよ う な リ ビジ ョ ンは、 p4 filelog の出力において purge 操作と し て表示さ

れます。）

キーワー ド 拡張先 例

$Id$ デ ィ ポ ・ シン タ ッ ク ス内のフ ァ イ

ル名と リ ビジ ョ ン番号

$Id: //depot/path/file.txt#3 $

$Header$ $Id$ と同じ $Header: //depot/path/file.txt#3 $

$Date$ 後 の サ ブ ミ ッ ト の 日 付 を、

YYYY/MM/DD 形式で表し た もの

$Date: 2010/08/18 $

$DateTime$ 後のサブ ミ ッ ト の日付 と 時刻

を、YYYY/MM/DD hh:mm:ss 形式

で表し た もの

日付 と 時刻は、 サ ブ ミ ッ ト 時の

PERFORCE サービ スにおける ローカ

ル ・ タ イ ムで記録されます。

$DateTime: 2010/08/18 23:17:02 $

$Change$ フ ァ イ ル が サ ブ ミ ッ ト さ れ た

PERFORCE チェ ンジ リ ス ト 番号

$Change: 439 $

$File$ デ ィ ポ ・ シン タ ッ ク スで表記さ れ

たフ ァ イル名のみ （ リ ビジ ョ ン番

号な し）

$File: //depot/path/file.txt $

$Revision$ PERFORCE リ ビジ ョ ン番号 $Revision: #3 $

$Author$ フ ァ イ ル を サブ ミ ッ ト し て い る

PERFORCE ユーザ

$Author: edk $

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 329

フ ァ イルタ イプ

• 一時オブジェ ク ト ・ フ ァ イル （+S および +Sn） に対し て p4 integrate を実行する と、遅延コ

ピーは作成されません。 反映された tempobj フ ァ イルは共有バージ ョ ン化サービ ス上で追

加のデ ィ ス ク スペース を消費し ます。

• 修正時刻 （+m） 修飾子は特殊な事例であ り 、 フ ァ イルのオ リ ジナルの タ イ ム ス タ ンプを保

持し たい開発者が使用する ものです。

ク ラ イ アン ト ・ ワーク スペースで modtime オプシ ョ ンが使用される と、 フ ァ イル日付が リ

ビジ ョ ンご と に進むこ と は保証されません。 例えば、 フ ァ イルがコ ピーされて反映される と

( 「Theirs を承諾」 )、 フ ァ イルには反映元フ ァ イルのタ イ ム ス タ ンプが採用されます。 ユー

ザが古い日付のフ ァ イルをチェ ッ ク イ ンする と、 ク ラ イ アン ト ・ ワーク スペースのフ ァ イル

にはそれ と同じ古い日付が使われます。 通常、 PERFORCE はフ ァ イルを同期させる と きにタ

イ ム ス タ ンプを更新し ます。 modtime オプシ ョ ンによ り 、 p4 sync 後の ク ラ イ アン ト ・ ワー

ク スペースにあ る フ ァ イルのタ イ ム ス タ ンプを、確実にサブ ミ ッ ト 時のフ ァ イルにあ るオ リ

ジナルのタ イ ム ス タ ンプに戻すこ と ができ ます。 （つま り 、 サブ ミ ッ ト 時の PERFORCE バー

ジ ョ ン化サービ スでの時刻で も な く 、同期時のユーザのワーク ステーシ ョ ンでの時刻で も あり ません。）

こ の修飾子が有効にな る典型的な事例は、 Windows 環境によ く あ るサード ・ パーテ ィ 製 DLL

を含む開発です。 こ う し たフ ァ イルのタ イ ム ス タ ンプは、通常 （開発環境内や OS によ って）

バージ ョ ン情報の代わ り と し て使用される ため、 PERFORCE ユーザの ク ラ イ アン ト 設定にか

かわらず、 時々フ ァ イルのオ リ ジナルのタ イ ム ス タ ンプを保持する必要があ り ます。

フ ァ イルの +m修飾子は次のよ う な状況を引き起こ し ます。+m修飾子が設定されている場合、

PERFORCE はフ ァ イルを同期する と きに ク ラ イ アン ト ・ ワーク スペースの modtime （ “サブ

ミ ッ ト 時のフ ァ イルのタ イ ム ス タ ンプ”） または nomodtime （“同期時の ク ラ イ アン ト での日

付と時刻” ） オプシ ョ ン設定を無視し、 常にサブ ミ ッ ト 時のフ ァ イルのオ リ ジナルのタ イ ム

ス タ ンプを リ ス ト ア し ます。

• PERFORCEの99.1 よ り 前バージ ョ ンでは、一連のキーワード を使用し てフ ァ イルタ イプを指定

し ていま し た。 以下の表は、 旧キーワード と それに対応する現在の基本フ ァ イルタ イプおよ

び修飾子と を リ ス ト にし た ものです。

旧キーワー ド 解説 基本フ ァ イルタ イプ 修飾子

text テキス ト ・ フ ァ イル text な し

xtext 実行可能なテキス ト ・ フ ァ イル text +x

ktext RCS キーワード拡張を行ったテキス ト ・ フ ァ イル text +k

kxtext RCS キーワー ド 拡張を行っ た実行可能なテキ ス

ト ・ フ ァ イル

text +kx

binary 非テキス ト ・ フ ァ イル binary な し

xbinary 実行可能なバイナ リ ・ フ ァ イル binary +x

ctext 圧縮されたテキス ト ・ フ ァ イル text +C

cxtext 圧縮された実行可能なテキス ト ・ フ ァ イル text +Cx

symlink シンボ リ ッ ク ・ リ ン ク symlink な し

resource Mac リ ソース ・ フ ォーク resource な し

uresource 圧縮されていない Mac リ ソース ・ フ ォーク resource +F

ltext 長いテキス ト ・ フ ァ イル text +F

xltext 実行可能な長いテキス ト ・ フ ァ イル text +Fx

ubinary 圧縮されていないバイナ リ ・ フ ァ イル binary +F

uxbinary 圧縮されていない実行可能なバイナ リ ・ フ ァ イル binary +Fx

tempobj 一時オブジェ ク ト binary +FSｗ

ctempobj 圧縮された一時オブジェ ク ト binary +Sw

xtempobj 実行可能な一時オブジェ ク ト binary +FSwx

330 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

フ ァ イルタ イプ

xunicode 実行可能な Unicode フ ァ イル unicode +x

xutf16 実行可能な UTF-16 フ ァ イル utf16 +x

旧キーワー ド 解説 基本フ ァ イルタ イプ 修飾子

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 331

索 　 引

記号#

コ メ ン ト ･キ ャ ラ ク タ 129パス ワード には使用不可 264フ ァ イル名内の 9, 101, 109, 271, 321, 323リ ビジ ョ ン指定子 319

%フ ァ イル名内の 9, 101, 109, 271, 321, 323

%%nワ イル ド カード 318

&ブール値と し ての AND 100論理演算子 AND 124

*fstat フ ィ ルタにおける ワ イル ド カード と し て

100p4 users で使用する ワ イル ド カード 267p4 user フ ォーム中でパス ワード を隠す 264ジ ョ ブ検索のワ イル ド カード 124フ ァ イル名内の 9, 101, 109, 271, 321, 323プ ロ テ ク シ ョ ン･テーブル中の ワ イ ル ド カー

ド 174ワ イル ド カード 318

fstat* ワ イル ド カード 100

+m更新時刻の保持 254

...p4 add で使用禁止のワ イル ド カード 10ワ イル ド カード 318ワ イル ド カード 、 p4 depot で必要 64

/ジ ョ ブ･テ ン プ レ ー ト での値の区切 り 記号

129/tmp

および TEMP 313=, >, , >=,

比較演算子 124比較演算子と し て 100

@リ ビジ ョ ン指定子 319

@フ ァ イル名内の 9, 101, 109, 271, 321, 323

^論理演算子 NOT 100, 124

|ブール値と し ての OR 100論理演算子 OR 124

Aadmin ア ク セス ・ レベル 174allwrite 36API

PERFORCE、 p4 fstat 96.asp フ ァ イル 328.avi フ ァ イル 328

B.bmp フ ァ イル 328.btr フ ァ イル 328

Cclobber 36, 236.cnf フ ァ イル 328compress 36COMPUTERNAME

Windows 上のデ フ ォ ル ト の ク ラ イ ア ン ト ・ワーク スペース 281

CR/LF の変換LineEnd の設定 37

.css フ ァ イル 328

D.doc フ ァ イル 328.dot フ ァ イル 328-d オプシ ョ ン

チェ ンジ リ ス ト の削除 24

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 332

EEDITOR_SIGNATURE

Mac 上での P4EDITOR 287emacs

デフ ォル ト ・ フ ォーム ・ エデ ィ タ と し て設定する 287

.exp フ ァ イル 328

F-f オプシ ョ ン

ク ラ イ ア ン ト ･ワー ク スペースの設定のオーバーラ イ ド 35

サブ ミ ッ ト 済チェ ンジ リ ス ト の編集 24ラベルの強制削除 135

Ggetcwd()

PWD の代わ り 312.gif フ ァ イル 328.gz フ ァ イル 328gzip 329-G オプシ ョ ン 315

H.htm フ ァ イル 328.html フ ァ イル 328

I.ico フ ァ イル 328.inc フ ァ イル 328.ini フ ァ イル 328integrate

フ ァ イルを作業状態にする 113IPv4 302IPv6 302

プロ テ ク シ ョ ン 174IPv6 ア ド レ ス 174IP ア ド レ ス

ア ク セス管理 173-i オプシ ョ ン

チェ ンジ リ ス ト と反映済フ ァ イル 30

JJobView フ ィ ール ド

p4 user 264チェ ンジ リ ス ト 24p4 user フ ォーム 125利用 125

.jpg フ ァ イル 328

.js フ ァ イル 328-J オプシ ョ ン

p4d 290, 291

Llabelsync

必要な所有権 134必要な ラベルの所有権 138

LDAP 242.lib フ ァ イル 328LineEnd 37

CR/LF 34list ア ク セス レベル 173locked 36, 225.log フ ァ イル 328-L オプシ ョ ン

p4d 292p4p 292チェ ンジのコ メ ン ト の長さ 85

-l オプシ ョ ンおよび長いチェ ンジ リ ス ト のコ メ ン ト 29ジ ョ ブのコ メ ン ト の長さ 123チェ ンジのコ メ ン ト の長さ 85

MMac

デフ ォル ト ・ フ ォーム ・ エデ ィ タ を変更 287フ ァ イルタ イプ 326リ ソース ・ フ ォーク ・ フ ァ イルタ イプ 326

maxlocktime影響を受ける コマン ド 106

maxresultsp4 filelog 85p4 files 88p4 group での設定 104影響を受ける コマン ド 106

maxscanrowsp4 group での設定 104影響を受ける コマン ド 106

MD5p4 verify 268パス ワード 298

modtime 362000.1 以降 36

.mpg フ ァ イル 328

Nnoallwrite 36noclobber 36, 236nocompress 36nomodtime 36

2000.1 以降 36normdir 36

Oopen ア ク セス レベル 173

Pp4

バージ ョ ン 315p4 add 9

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 333

p4 admin 12p4 annotate 15p4 archive 161p4 archive 18p4 attribute 17, 183p4 branch 20

p4 integrate 113p4 branches 22p4 change 23p4 changelists 28p4 changes 29p4 client 32

オプシ ョ ンおよび p4 sync 236p4 clients 39p4 configure 41p4 copy 50p4 counter 52p4 counters 183p4 counters 54p4 cstat 55p4 dbschema 56p4 dbstat 57p4 dbverify 59p4 delete 60p4 depot 62p4 depots 66p4 describe 67p4 diff 69

P4DIFF 285p4 diff2 72

ブラ ンチ ・ ビ ュー 21p4 dirs 75p4 diskspace 77p4 edit 79, 82p4 export 82p4 filelog 84p4 files 87p4 fix 89p4 flush 93p4 fstat 183p4 fstat 96p4 grep 103p4 group 104p4 groups 107p4 have 109

ワーク スペース内のフ ァ イル 109p4 help 111p4 info 112p4 integrate 113p4 integrated 117p4 interchanges 119p4 istat 120p4 job 121p4 jobs 123p4 jobspec 128p4 journaldbchecksums 131

p4 key 132p4 keys 183p4 keys 133p4 labels 136p4 labelsync 138p4 license 141p4 list 140p4 lock 142p4 lockstat 143p4 log 144p4 logger 145p4 login 146p4 logout 148p4 logparse 149p4 logrotate 151p4 logschema 152p4 logstat 153p4 logtail 154p4 merge 155p4 monitor 157p4 obliterate 18p4 obliterate 161

デ ィ ポの削除 64p4 open 80p4 opened 164p4 passwd 166

P4PASSWD 298パス ワード の設定 298

p4 ping 169p4 populate 170p4 print 171p4 property 183p4 protect 173

Protections フ ィ ール ド 174新 し いデ ィ ポ生成時に必要なプ ロ テ ク シ ョ

ン 64サーバのイ ン ス ト ール後に必要な こ と 180

p4 protects 182p4 proxy 185p4 pull 186p4 reconcile 189p4 reload 192p4 rename 191p4 reopen 186, 193, 195p4 replicate 195p4 resolve 197

P4DIFF 285P4MERGE 294P4PAGER 297

p4 resolved 203p4 restore 204p4 revert 205

p4 resolve -at 199p4 review 207p4 reviews 209p4 serverid 213, 215

334 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

p4 servers 216p4 set 211p4 shelve 217p4 sizes 219p4 status 221p4 stream 223p4 streams 229p4 submit 230p4 sync 235

ブラ ンチ ・ ビ ュー 324p4 tag 239p4 tickets 241p4 triggers 242p4 trust 303p4 trust 252p4 typemap 253, 325

および p4 add 9p4 unload 256p4 unlock 258p4 unshelve 259p4 update 261p4 user 262

JobView フ ィ ール ド 125Reviews フ ィ ール ド 209ジ ョ ブ ・ ビ ューと p4 submit 231パス ワード の設定 298

p4 users 267p4 verify 268p4 where 270p4 workspace 272p4 workspaces 273P4AUDIT 275P4AUTH 276P4BROKEROPTIONS 277P4CHANGE 279P4CHARSET 278P4CLIENT 281P4CLIENTPATH 282P4COMMANDCHARSET 280P4CONFIG 283p4d

ジ ャーナル ・ フ ァ イルの指定 290, 291フ ァ イルにエラーを記録 292

P4DEBUG 284P4DIFF 285

p4 describe を使用し ない 67p4 diff2 と は無関係 72および p4 diff 69

P4DIFFUNICODE 286P4EDITOR 287

影響を受ける コマン ド 287p4executable

バージ ョ ン 112p4 fixes

チェ ンジ リ ス ト 25P4HOST 288

P4IGNORE 289p4 jobspec

および P4V 130P4JOURNAL 290P4LANGUAGE 291P4LOG 292P4LOGINSSO 293P4MERGE 199, 294

Windows で必要なバッ チ ・ フ ァ イル 294P4MERGEUNICODE 295P4NAME 296p4 opened

チェ ンジ リ ス ト 25p4p

フ ァ イルにエラーを記録 292P4PAGER 297P4PASSWD 298

p4 passwd 298P4PCACHE 299P4PFSIZE 300P4POPTIONS 301P4PORT 302P4ROOT 305

Windows サーバ上の一時フ ァ イル 313およびデ ィ ポ ・ フ ァ イル 65

P4SSLDIR 306P4TARGET 308P4TICKETS 309P4TRUST 303P4TRUST 310P4USER 311

Windows 上のサブ ミ ッ ト 前 ト リ ガ 250P4V

ツールチッ プおよびジ ョ ブ仕様 130.pdf フ ァ イル 328.pdm フ ァ イル 328PERFORCEAPI

p4 fstat 96PERFORCE ク ラ イ アン ト

一時フ ァ イル 313PERFORCE ク ラ イ アン ト と PERFORCE サーバ

バージ ョ ン情報の表示 112PERFORCE サーバ

P4ROOT 305一時フ ァ イル 313および ト リ ガ 247管理 12正当性の検証 268チェ ッ ク ポ イ ン ト と ジ ャーナル 12停止 12

PERFORCE サービ スP4PORT 302

PERFORCE シン タ ッ ク ス 318PERFORCE の管理 12PERFORCE フ ァ イルタ イプ 328PERFORCE ブローカー

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 335

および P4BROKEROPTIONS 277PERFORCE プロ キシ

および P4PCACHE 299, 300, 301および P4PTARGET 308

POSIX$SHELLVMS 上での P4EDITOR の値 287

.ppt フ ァ イル 328Protections フ ィ ール ド 174PWD 312Python 315

RRCS キーワード

拡張 171RCS キーワード 拡張 327

例 329RCS フ ァ イル形式 329read ア ク セス レベル 173remote 64Reviews フ ィ ール ド

p4 user 209使用 264

review ア ク セス レベル 174RFC3484 準拠 303rmdir 36run.users.authorize 47

Sservers

listing all 216Status フ ィ ール ド

p4 submit 230superuser 174super ア ク セス ・ レベル 174-s オプシ ョ ン

p4 fstat 100ス ク リ プ ト 作成での出力のフ ォーマ ッ ト 315

TTMP,TEMP 313-t オプシ ョ ン

ク ラ イ ア ン ト ･ワー ク スペースのテンプレート 35

フ ァ イルタ イプ 327

Uunicode 280, 286, 295, 326UNIX

行末識別 37デフ ォル ト ・ フ ォーム ・ エデ ィ タ を変更する

287マウ ン ト された ド ラ イブの行末 37

unlocked 36, 225UTF-16 278, 280, 286, 295UTF-32 278, 280

UTF-8 278, 280, 286, 295

Vvi

デフ ォル ト ・ フ ォーム ・ エデ ィ タの変更 287VMS

デフ ォル ト ・ フ ォーム ・ エデ ィ タの変更 287

WWindows

P4MERGE に必要なバッ チ ・ フ ァ イル 294Windows サービ ス用の変数設定 274行末 37行末識別 37サード パーテ ィ の DLL 37, 330サービ ス と ト リ ガ 250デフ ォル ト の ク ラ イ アン ト ・ ワーク スペース

281デフ ォル ト の ク ラ イ アン ト ・ ワーク スペース

と し ての COMPUTERNAME 281デフ ォル ト ・ フ ォーム ・ エデ ィ タ 287パス ワード の設定 298

write ア ク セス レベル 173

X.xls フ ァ イル 328-x オプシ ョ ン

標準入力からの読み取 り 315p4 diff の使用例 71

あア ク セス

管理者 174スーパー ・ ユーザ 174IP ア ド レ スで制限 173レベル 173

ア ク セス レベルp4 group 104ア ク セス レベル と コマン ド の一覧表示 176

圧縮フ ァ イルの自動圧縮 329

ア ッ プグレード98.2 以前からのア ッ プグレード 123

ア ト ミ ッ ク ・ チェ ンジ 230

い位置指定子 318一時フ ァ イル

格納場所 313一覧表示

カ ウ ン タ 54ク ラ イ アン ト ・ ワーク スペース 273ク ラ イ アン ト ･ワークペース 39グループ 107作業状態のフ ァ イル 164

336 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

修正 91衝突解決がス ケジ ュールされたフ ァ イル 203ジ ョ ブ 123チェ ンジ リ ス ト 28, 29チェ ンジ リ ス ト に リ ン ク し たジ ョ ブ 91デ ィ ポ 66デ ィ ポ内フ ァ イル 87フ ァ イル内のラベル 136フ ァ イル反映 117ブラ ンチ 22ラベル 136

えエデ ィ タ

P4EDITOR でフ ォームを指定する 287フ ォームを使用する コマン ド 287

演算子比較演算子と ジ ョ ブ･ビ ュー 124比較、 およびフ ィ ルタ 100ブール、 およびフ ィ ルタ 100論理演算子と ジ ョ ブ･ビ ュー 124

おオーバーレ イ ・ マ ッ ピング 322オプシ ョ ン

ク ラ イ アン ト ・ ワーク スペース用 35グ ローバル ・ オプシ ョ ン 315ス ト リ ームに使用 225

オン ラ イ ンヘルプp4 の使用 111

か外部認証 242カ ウ ン タ

p4 review 207review ア ク セス権限 180継続的に使用される変数の一覧表示 54継続的に使用される変数の設定 52

空のデ ィ レ ク ト リsync 実行時の削除 36

カレ ン ト ・ デ ィ レ ク ト リ 312非 UNIX ク ラ イ アン ト における一時フ ァ イル

313環境変数

P4AUDIT 275P4AUTH 276P4BROKEROPTIONS 277P4CHANGE 279P4CHARSET 278P4CLIENT 281P4CLIENTPATH 282P4COMMANDCHARSET 280P4CONFIG 283P4CONFIG によ る自動変更 283P4DEBUG 284P4DIFF 285

P4DIFFUNICODE 286P4EDITOR 287P4HOST 288P4IGNORE 289P4JOURNAL 290P4LANGUAGE 291P4LOG 292P4LOGINSSO 293P4MERGE 294P4MERGEUNICODE 295P4NAME 296P4PAGER 297P4PASSWD 298P4PCACHE 299P4PFSIZE 300P4POPTIONS 301P4PORT 302P4ROOT 305P4SSLDIR 306P4TARGET 308P4TICKETS 309P4TRUST 310P4USER 311PWD 312TMP,TEMP 313Windows サービ ス用の設定 274設定方法 274ヘルプ 111

環境変数 MERGEP4MERGE 294

環境変数 PAGERP4PAGER 297

環境変数 SHELLWindows の場合の P4DIFF 285Windows の場合の P4EDITOR 287

環境変数の設定 274Windows サービ ス上 274Windows サービ ス用 211

管理パス ワード の リ セ ッ ト 167

きキーワード

RCS、 拡張 171, 327RCS、 例 329旧 PERFORCE フ ァ イルタ イプを指定する 330

基本フ ァ イルタ イプ 325行末 37

くク ラ イ アン ト

ク ラ イ アン ト と一時フ ァ イル 313ラベル 138

ク ラ イ アン ト ・ ワーク スペース別名のルー ト 33

ク ラ イ アン ト ・ シン タ ッ ク ス 318

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 337

p4 files 87変換 270

ク ラ イ アン ト ・ ビ ュー 323p4 client 32p4 print 171ク ラ イ アン ト ・ ビ ューと p4 sync 235定義 322

ク ラ イ アン ト ・ ワーク スペースp4 have で表示される同期フ ァ イル 109オプシ ョ ン 35削除 35すべてを一覧表示 273生成および編集 32, 272設定の自動変更 283全ク ラ イ アン ト ・ ワーク スペースの リ ス ト 39定義 32デ ィ ポ と フ ァ イルの比較 69デ ィ ポ ・ フ ァ イルを コ ピーし て取 り 込む 235名前 281フ ァ イルタ イプによ って ク ラ イ アン ト ・ ワー

ク スペース内のフ ァ イルのパー ミ ッシ ョ ンを設定する 326

ラベル と の同期 138ルー ト 33

ク ラ イ アン ト ･ワーク スペーステンプレー ト 35グループ

サブグループ 105ア ク セス管理 173削除 104生成 104ユーザの一覧表示 107

グ ローバル ・ オプシ ョ ン 315ヘルプ 111

ク ロ スプラ ッ ト ホーム開発行末文字制御 37

け警告

p4 counters 52p4 flush 93p4 revert 206カ ウ ン タ と p4 review 207サブ ミ ッ ト 前 ト リ ガ 242

検索空のジ ョ ブ･フ ィ ール ド 126ジ ョ ブ ・ ビ ューによ る ジ ョ ブの検索 123フ ァ イル、 fstat によ る 99

こ更新時刻の保持 254コード ラ イ ン

フ ァ イルの比較 72ブラ ンチ ・ ビ ュー 21

コマン ドア ク セス管理 173ア ク セス レベル別に一覧表示 176

ヘルプ 111コマン ド ラ イ ン ・ オプシ ョ ン

グ ローバルオプシ ョ ン 315

さサーバ

IP ア ド レ スの変更 141ア ッ プグレード 123一時フ ァ イル 313エラー ・ ロ グ ・ フ ァ イルを指定 292および ト リ ガ 247管理 12再起動 12ジ ャーナル ・ フ ァ イルを指定 290, 291仕様 213, 215正当性の検証 268チェ ッ ク ポ イ ン ト と ジ ャーナル 12停止 12デ ィ ス ク使用量 77ラ イセン ス 141

サーバ変数設定 52一覧表示 54

サーバ ・ ルー ト 305Windows サーバ上の一時フ ァ イル 313およびデ ィ ポ 65

サービ スP4PORT 302

新 リ ビジ ョ ンp4 delete 60p4 edit 79指定 319

作業状態のフ ァ イルp4 reopen によ る タ イプの変更 193

作業中チェ ンジ リ ス ト 23, 230一覧表示 28, 29フ ァ イルの一覧表示 164

サブグループグループ 105

サブデ ィ レ ク ト リ一覧表示 75

サブデ ィ レ ク ト リ の一覧表示 75サブ ミ ッ ト 済チェ ンジ リ ス ト 23, 230

一覧表示 28, 29サブ ミ ッ ト 前 ト リ ガ 242

ス ク リ プ ト 作成の ヒ ン ト 249差分チャ ン ク

フ ァ イル衝突 199差分プロ グ ラ ム

および p4 describe 67および p4 diff 69p4 diff2 72PERFORCE の内部ルーチン 285サード ・ パーテ ィ ー製、 指定 285

338 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

しシェル

フ ァ イル指定の解釈 267, 320指定

p4 resolve の出力を表示する プ ロ グ ラ ム 297

サード ・ パーテ ィ ー製差分プロ グ ラ ム 285新 リ ビジ ョ ン 319

チェ ンジ番号でフ ァ イルを指定 319デフ ォル ト ・フ ォーム・エデ ィ タ を P4EDITOR

で指定 287反映操作を行 う フ ァ イル 113日付と時刻で指定する 319フ ァ イルタ イプ 326リ ビジ ョ ンでフ ァ イルを指定 319リ ビジ ョ ン範囲 320

指定子位置指定子 318リ ビジ ョ ン指定子 319

ジ ャーナル 12ジ ャーナル ・ フ ァ イル

P4JOURNAL で指定する 290修飾子

フ ァ イルタ イプ、 +m 254修正

p4 fix -d によ る修正完了記録の削除 89一覧表示 91複数のチ ェ ン ジ リ ス ト に よ る ジ ョ ブの修正

89修正ステータ ス

デフ ォル ト 130集中認証サーバ 276出力

-s によ る ス ク リ プ ト のフ ォーマ ッ ト 315仕様

ジ ョ ブ仕様の表示 125状態

ジ ョ ブの状態を変更する 90仕様デ ィ ポ

書き込み 12衝突解決

フ ァ イルを ス ケジ ュールする 202衝突未解決のフ ァ イル

一覧表示 203仕様 ト リ ガ 244除外マ ッ ピング 322

p4 protect 174ト リ ガ 243

ジ ョ ブ* ワ イル ド カード 124p4 fix によ るチェ ンジ リ ス ト への リ ン ク 89p4 submit で作業状態を終了する 231一覧表示 123空フ ィ ール ド 126状態の変更 90ジ ョ ブ ・ ビ ューに関する制約の回避 126

チェ ンジ リ ス ト 24チェ ンジ リ ス ト への リ ン ク の一覧表示 91チェ ンジ リ ス ト への リ ン ク の表示 25複数のチェ ンジ リ ス ト によ る修正 89ワ イル ド カード 126

ジ ョ ブ仕様表示 125

ジ ョ ブの作業状態を終了するp4 submit を使用し て 231

ジ ョ ブ ・ ビ ューおよび比較演算子 101ジ ョ ブ検索 123制約 125比較演算子 125フ ィ ール ド タ イプ 125ヘルプ 111

ジ ョ ブ･テーブル再イ ンデッ ク ス付け 123

ジ ョ ブ ・ テンプレー ト編集 128

所有者ラベル所有者の変更 134

所有 リ ス トp4 delete 60p4 have によ る一覧表示 109定義 109ワーク スペース フ ァ イル と の関係 109

所有 リ ビジ ョ ン 109, 319シン タ ッ ク ス ・ フ ォーム

p4 where によ る フ ォーム間での変換 270シンボ リ ッ ク ・ リ ン ク 326

非 UNIX システム 329信頼されていないネ ッ ト ワーク上 237

すスーパー ・ ユーザ

ユーザの作成 262ス ク リ プ ト 作成

Python によ る 315および -s オプシ ョ ン 315および -x オプシ ョ ン 315p4 dirs 75p4 fstat 96-s と p4 fstat 100-x オプシ ョ ン、 例 71ト リ ガ 242ト リ ガ、 ス ク リ プ ト 作成の ヒ ン ト 249

ス ト リ ームオプシ ョ ン 225

スペースフ ァ イル名に含まれる 35

せ生成

デ ィ ポ仕様 62ブラ ンチ ・ ビ ュー 20

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 339

正当性の検証 268制約

ジ ョ ブ ・ ビ ュー 125セキ ュ リ テ ィ

パス ワード の 小文字数の設定 167セキ ュ リ テ ィ ・ レベル 263

そ操作の衝突解決 200

たターゲ ッ ト のサーバ

レプ リ カ と プロ キシ 308タ イプ

フ ァ イルタ イプの変更 193タ イプマ ッ ピング 253タ イプマ ッ プ 9タ イ ム ス タ ンプ

DLL 上に保持 330DLL 上での保存 37

タ グ 239

ちチェ ッ ク ポ イ ン ト 12チェ ンジ リ ス ト

p4 review で一覧表示する 207p4 fixesによ る関連フ ァ イルの一覧表示 25p4 opened によ る関連フ ァ イルの一覧表示

25一覧表示 28, 29意味 25再サブ ミ ッ ト 時に指定する 231作業中チ ェ ン ジ リ ス ト で 作業状態に あ る

フ ァ イルの一覧表示 164作業中チ ェ ン ジ リ ス ト と サブ ミ ッ ト 済チ ェ

ンジ リ ス ト 230削除 24サブ ミ ッ ト 230詳細な コ メ ン ト 、 表示 29ジ ョ ブ 24, 89ジ ョ ブ ・ ビ ューと ユーザ 125生成および編集 23チェ ンジ リ ス ト 間でフ ァ イルを移動する 193定義 23デフ ォル ト ・ チェ ンジ リ ス ト と p4 submit

230発番 23番号付き 230番号付 き チ ェ ン ジ リ ス ト の コ メ ン ト 情報を

変更する 233フ ァ イル削除時の指定 60フ ァ イル追加時の指定 9フ ァ イル編集時の指定 79明細表示 67目的 233リ ン ク されたジ ョ ブの一覧表示 91

チェ ンジ リ ス ト ・ サブ ミ ッ ト ・ ト リ ガ 244チェ ンジ リ ス ト 番号

作業中チ ェ ン ジ リ ス ト と サブ ミ ッ ト 済チ ェンジ リ ス ト 52

チェ ンジ リ ス ト をサブ ミ ッ ト する 230チェ ンジ・ レ ビ ュー・デーモン 174, 180, 207, 209, 264チケ ッ ト ・ フ ァ イル

場所 309

つツールチッ プ 130

てデ ィ ス ク使用量の監視 77デ ィ ス ク容量 219

サーバ 77再生 162

デ ィ ポ一覧表示 66およびサーバ ・ ルー ト 65空のフ ァ イル 10ク ラ イ アン ト ・ ワーク スペース と のフ ァ イル

の比較 69削除 64生成または編集 62正当性の検証 268フ ァ イルの一覧表示 87フ ァ イルの取得 235フ ァ イルの追加 10フ ァ イルの ２ つの リ ビジ ョ ンの比較 72フ ァ イルの保存方法 329変更をサブ ミ ッ ト する 230リ モー ト ・ デ ィ ポ 64リ モー ト ・ デ ィ ポ と プロ テ ク シ ョ ン 180

デ ィ ポからのフ ァ イル取得 235デ ィ ポ

リ モー ト 62デ ィ ポ ・ シン タ ッ ク ス 318

p4 branch 20p4 print 171所有 リ ス ト 109プロ テ ク シ ョ ン ・ テーブル 174変換 270

デ ィ レ ク ト リおよびスペース 35カレ ン ト ・ デ ィ レ ク ト リ 312

デ ィ レ ク ト リ 、 空sync によ る削除 36

デーモンreview ア ク セス権限 180作成の ヒ ン ト 249チェ ンジ リ ス ト 番号 52チェ ンジ ・ レ ビ ュー 180, 207, 209, 264チャ レ ンジ ・ レ ビ ュー 174

テキス ト ・ フ ァ イル 325

340 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

デフ ォル ト ･チェ ンジ リ ス ト作業状態のフ ァ イルの一覧表示 164

デフ ォル ト ・ チェ ンジ リ ス トp4 submit 230

デルタ記憶定義 329

テンプレー トク ラ イ アン ト ･ワーク スペース 35ジ ョ ブ ・ テンプレー ト の編集 128

と同期 235ト ラブルシ ューテ ィ ング

ローカル ・ シェル と フ ァ イル指定 320ト リ ガ 242

Windows サービ ス 250ス ク リ プ ト 、 引数の指定 247タ イプ 244引数を渡す 248命名 244

に認証 242

ねネ ッ ト ワーク

データ圧縮 36

はバージ ョ ン

p4 315PERFORCE ク ラ イ ア ン ト ･プ ロ グ ラ ムお よ び

PERFORCE サーバプ ロ グ ラ ム のバージ ョ ン 112

パー ミ ッ シ ョ ン新 し いデ ィ ポにア ク セ スす る ために必要な

パー ミ ッ シ ョ ン 64フ ァ イルタ イプによ って ク ラ イ アン ト ・ ワー

ク スペース内のフ ァ イルのパー ミ ッシ ョ ンを設定する 326

フ ァ イルのパー ミ ッ シ ョ ン と p4 edit 79付与と拒否 173

バイナ リ ・ フ ァ イル 325比較 73

パス ワードP4PASSWD 298およびユーザ 263コマン ド ラ イ ンでの指定 166削除 166設定 166特殊文字 264ユーザ 263リ セ ッ ト 167

パス ワード中のスペース引用符で囲む 167

パス ワード の再設定 167パス ワード の削除 166パス ワード有効期限の設定 104, 106, 166, 263バッ チ ・ フ ァ イル

P4MERGE 294反映

一覧表示 117スケジ ュール 197

番号付チェ ンジ リ ス ト 230

ひ比較

バイナ リ ・ フ ァ イル 73フ ァ イル 69, 72

比較演算子およびフ ィ ルタ 100ジ ョ ブ･ビ ュー 124

非存在 リ ビジ ョ ン指定 319

ビ ュー概要 322ク ラ イ アン ト ・ ビ ュー 323ク ラ イ アン ト ・ ビ ューと p4 sync 235ブラ ンチ , 生成または編集 20ブラ ンチ ・ ビ ュー 324ブラ ンチ ・ ビ ュー と p4 integrate 113ブラ ンチ ・ ビ ュー と p4 diff2 21ブラ ンチ ・ ビ ュー と p4 sync 324ヘルプ 111ラベル ・ ビ ュー 324

標準出力p4 print 171

標準入力読み取 り 元 315

ふフ ァ イル

別のデ ィ ポにア ク セス 62#none で除去する 319.asp 328.avi 328.bmp 328.btr 328.cnf 328.css 328.doc 328.dot 328.exp 328.gif 328.gz 328.htm 328.html 328.ico 328.inc 328.ini 328.jpg 328

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 341

.js 328

.lib 328

.log 328

.mpg 328p4 integrate で削除する ために作業状態

にする 113p4 integrate でブ ラ ンチする ために作業

状態にする 113.pdf 328.pdm 328PERFORCE フ ァ イルタ イ プを フ ァ イル名に適

合させる 253.ppt 328-t オプシ ョ ンによ る タ イプの変更 327.xls 328ア ク セス管理 173圧縮し て保存 329位置の表示 270一覧表示 87完全消去 161更新時刻の保持 254コード ラ イ ン間の比較 72コ ピーする 50

新 リ ビジ ョ ンの取得 319作業状態のフ ァ イル 164作業状態のフ ァ イルの一覧表示 164削除する ために作業状態にする 60サブ ミ ッ ト 230指定 318衝突解決 197衝突解決が ス ケ ジ ュ ール さ れてい る フ ァ イ

ルの一覧表示 203衝突解決時の yours、 theirs、 base、 merge の意

味 198衝突解決を ス ケジ ュールする 202衝突、 衝突解決 197衝突未解決フ ァ イルの一覧表示 203ス ク リ プ ト のための情報表示 96正当性の検証 268タ イプ 325タ イプの変更 193タ イプを指定する 326チェ ッ ク ポ イ ン ト と ジ ャーナル 12チェ ンジ番号で指定する 319チェ ンジ リ ス ト からの削除 205チェ ンジ リ ス ト 間の移動 193チ ェ ン ジ リ ス ト に含まれてい る フ ァ イ ルの

詳細情報 67チェ ンジ リ ス ト への リ ン クの一覧表示 25追加目的で作業状態にする 9デ ィ ポから コ ピーする 235デ ィ ポからの削除 60デ ィ ポからの取得 235デ ィ ポへの追加 9デフ ォル ト タ イプの追加、 指定 9デフ ォル ト ・ タ イプの追加、 指定 253, 325

デルタ記憶、 フル ・ フ ァ イル記憶 329同期 235特定 リ ビジ ョ ンの内容の一覧表示 171ト リ ガ 239名前の変更 191バイナ リ フ ァ イルの比較 73反映操作のために作業状態にする 113比較 69, 72日付 と時刻で指定する 319フ ァ イル間の変更の反映 197フ ァ イル反映履歴の表示 117フ ァ イルへの変更をデ ィ ポに送る 230フ ァ イルへの変更を廃棄する 205古い リ ビジ ョ ンの編集 80変更をデ ィ ポ保存する 230編集 79編集する ために作業状態にする 79編集前の状態に戻す 205他のユーザによ る編集を防止する 142マルチ ・ フ ォーク 326ラベルからの削除 138, 239ラ ベルに含まれてい る フ ァ イ ルの詳細情報

136ラベルへの追加 138リ ネームする 159リ ビジ ョ ンで指定する 319リ ビジ ョ ン履歴の表示 84ロ ッ ク 142ロ ッ ク解除 258

フ ァ イル ・ サイ ズ 219フ ァ イル指定

p4 revert 205p4 submit 233ヘルプ 111ローカル ・ シェルによ る解釈 320

フ ァ イル衝突の解決 197フ ァ イルタ イプ 328

apple 326binary 325p4 add 10p4 edit 79resource 326symlink 326text 325-t オプシ ョ ンで指定 327一覧表示 330解説 325キーワード 328旧キーワード 330ク ラ イ アン ト ・ ワーク スペースにおけるパー

ミ ッ シ ョ ン 326指定 326修飾子 330デ ィ ポへの保存 329表示 329フ ァ イル名へのマ ッ ピング 253

342 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

ヘルプ 111変更 193

フ ァ イルタ イプの変更-t オプシ ョ ンを使用する 327

フ ァ イルの移動 159フ ァ イルの完全消去 161フ ァ イルの削除 60フ ァ イルの差分比較 69, 72フ ァ イルの消去

完全消去 161フ ァ イルの追加 9

デフ ォル ト タ イプの指定 9デフ ォル ト ・ フ ァ イルタ イプの指定 253

フ ァ イルの保留 217, 259フ ァ イルのロ ッ ク 142フ ァ イルのロ ッ ク解除 258フ ァ イルの追加

デフ ォル ト ・ フ ァ イルタ イプの指定 325フ ァ イルへの変更を元に戻す 205フ ァ イル名

およびスペース 35特殊文字 9, 101, 109, 271, 321, 323コマン ド ラ イ ンでスペース を使用する 320妥当な文字 320フ ァ イルタ イプへのマ ッ ピング 253

フ ァ イル名中のスペース引用符で囲む 320

フ ァ イル名の変更 191フ ァ イルを コ ピーする 50フ ァ イルを作業状態にする

削除する目的で 60追加目的で 9編集する目的で 79

フ ァ イルをサブ ミ ッ ト する 230フ ァ イルを リ ネームする 159フ ィ ール ド

空のフ ィ ール ド を持つジ ョ ブ 126フ ィ ルタ

フ ァ イルを検索 99ブール演算子

およびフ ィ ルタ 100フ ォーム

P4EDITORでデフ ォル ト のエデ ィ タ を指定する 287

フ ォームを使用する コマン ド 287複製 186, 195ブラ ンチ 20

フ ァ イル比較 72ブラ ンチ ・ ビ ュー 324

p4 diff2 21p4 integrate 113および p4 branch 20コード ラ イ ン指定例 21定義 322ブラ ンチ ・ ビ ューと p4 sync 324

ブラ ンチ ・ マ ッ ピング 22

一覧表示 22生成および編集 20

フル ・ フ ァ イル記憶定義 329

ブローカーおよび P4BROKEROPTIONS 277

プロ キシ 185エラー ・ ロ グ ・ フ ァ イルを指定 292および P4PCACHE 299, 300, 301および P4TARGET 308

プロ テ ク シ ョ ン表示 182IP ア ド レ ス 173付与および拒否 173

プロ テ ク シ ョ ン ・ テーブル 173分散開発 186, 195

へヘルプ

p4 help の使用 111変更

小単位 230衝突、 衝突解決 197

変更の取消 205変更を廃棄する 205編集

デ ィ ポ仕様 62フ ァ イル 79ブラ ンチ ・ ビ ュー 20ユーザ仕様 262

変数環境変数の設定方法 274サーバ変数の一覧表示 54サーバ変数の設定 52

ほホ ス ト

別のホ ス ト か ら ア ク セ ス し てい る よ う に見せかける 288

保存デ ィ ポ内でのフ ァ イル保存 329

まマ ッ ピング

オーバーレ イ 322p4 client 32ク ラ イ ア ン ト ・ ビ ュ ーにおけ る マ ッ ピ ン グ

323除外マ ッ ピング 322除外マ ッ ピング と ト リ ガ 243除外マ ッ ピング と プロ テ ク シ ョ ン ・ テーブル

174スペース を含むデ ィ レ ク ト リ 35反映 と p4 branch 113ブラ ンチ･ビ ュー 20ブラ ンチ ・ ビ ュー 324

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 343

プロ テ ク シ ョ ン･テーブル 174ラベル･ビ ュー 135ラベル ・ ビ ュー 324ローカル･デ ィ ポ と リ モー ト ･デ ィ ポ 64

マ ッ ピングの順序ト リ ガ 243プロ テ ク シ ョ ンにおける 174

マルチ ・ フ ォーク ・ フ ァ イル 326

も文字

フ ァ イル名で使用可能 320

ゆユーザ

p4 reviews で一覧表示 209P4CONFIG や P4USER で変更する 262P4PASSWD 298ア ク セス管理 173一覧表示 267およびパス ワード 263仮想ユーザ 64グループ 104グループへのア ク セス許可 173グループ、 一覧表示 107サービ ス ・ ユーザ、 remote 180削除 263作成および編集 262パス ワード 166, 263パス ワード を忘れた と き 167フ ァ イルのロ ッ ク解除 258他のユーザによ る フ ァ イル編集の防止 142

ユーザ仕様の作成 262ユーザ設定

設定 262ユーザの一覧表示 267ユーザの削除 263

らラ イセン ス

仮想ユーザ 64サブ ミ ッ ト 前 ト リ ガ 250

ラベル 239一覧表示 136ク ラ イ アン ト と の同期 138所有者の変更 134フ ァ イルの一覧表示 136フ ァ イルの削除 138フ ァ イルの追加 138ラベルからの削除 239ロ ッ ク の解除 134

ラベルク ラ イ アン ト 138ラベル ・ ビ ュー 324

定義 322

りリ ス ト

サーバ 216リ ソース ・ フ ォーク 326リ ビジ ョ ン

カレ ン ト ・ ク ラ イ アン ト における フ ァ イル リビジ ョ ン 319

新 リ ビジ ョ ンを指定する 319指定子 319フ ァ イル リ ビジ ョ ンの表示 171ラベル 138

リ ビジ ョ ン指定子 319p4 changes 29p4 sync 235ヘルプ 111

リ ビジ ョ ン範囲p4 changes 29p4 files 87p4 fixes 91p4 integrate 113p4 print 171, 172p4 sync 235指定 320

リ ビジ ョ ン履歴完全消去 161表示 84

リ ビジ ョ ン範囲p4 resolved 203

リ モー ト ・ デ ィ ポ 62, 64プロ テ ク シ ョ ン 180

れ例

p4 typemap 254RCS キーワード拡張 329ク ラ イ アン ト ・ ワーク スペースへの同期 237作業状態のフ ァ イルの一覧表示 165作業中チ ェ ン ジ リ ス ト で作業状態に な る

フ ァ イルの一覧表示 165サブ ミ ッ ト 前 ト リ ガの使用 251さ まざまな基準によ る ジ ョ ブの一覧表示 126衝突解決のスケジュー リ ング 116ス ク リ プ ト に よ る 構文解析のための出力の

生成 101チェ ンジ リ ス ト 間でのフ ァ イル移動 194デ ィ ポからのフ ァ イル取得 237パイプ と -x 71フ ァ イルタ イプの変更 193フ ァ イルの反映 116フ ァ イルの リ ネーム 191フ ァ イルを作業前の状態に戻す 206フ ァ イ ルをチ ェ ン ジ リ ス ト でサブ ミ ッ ト す

る 233ブラ ンチ作成と コード ラ イ ン 21ブラ ンチを介し たフ ァ イルの比較 74変更の伝達 116

344 PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス

他のユーザ と し て作業する 265ユーザ情報の参照 265ユーザ情報の編集 265ユーザの削除 265

レジス ト リプレーン ・ テキス ト のパス ワード を保存し な

い 298

ろローカル ・ シン タ ッ ク ス 318

所有 リ ス ト 109変換 270

論理演算子ジ ョ ブ･ビ ュー 124

わワーク スペース

ク ラ イ アン ト 、 一覧表示 273ク ラ イ アン ト 、 生成および編集 272ク ラ イ アン ト 、 別名のルー ト 33ク ラ イ アン ト ･ワーク スペース、 一覧表示 39ク ラ イ アン ト ･ワーク スペース、生成および編

集 32ワ ー ク スペース内の フ ァ イ ル と 所有 リ ス ト

109ワ イル ド カード

フ ィ ルタで 100p4 add 10p4 integrate 113ジ ョ ブ･ビ ュー 124フ ァ イルを指定 318ユーザの一覧表示 267

PERFORCE 2013.1 コマン ド ・ リ フ ァ レ ン ス 345