P4 ユーザーズ ・ ガ イ ド
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 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 2005-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 の ソ フ ト ウ ェ アには、 カ リ フ ォ ルニ ア大学バー ク レ イ 校お よ びその協力者に よ っ て開発 さ れた ソ フ ト ウ ェ アが含まれてい ます。
は じ めに
こ のマニ ュ アルについて ...11
コ マ ン ド ラ イ ン と GUI ... 11 PERFORCE入門... 11 PERFORCE ド キ ュ メ ン ト ... 12 ご意見 ・ ご感想をお待ち し てい ます ... 12第 1 章
P4 の イ ン ス ト ール...13
UNIX お よ び OS X への P4 の イ ン ス ト ール ... 13 Windows への P4 の イ ン ス ト ール... 13 イ ン ス ト ールの確認 ... 14第 2 章
P4 の構成 ...15
構成の概要 ... 15 ク ラ イ ア ン ト ・ ワー ク スペース と は... 15 PERFORCE に よ る ワー ク スペース の管理方法... 16 PERFORCE の設定 ... 17 コ マ ン ド ラ イ ンの使用... 17 構成フ ァ イ ルの使用... 17 環境変数の使用... 19 Windows の レ ジ ス ト リ ま たは OS X のシ ス テ ム設定を使用す る... 19 ク ラ イ ア ン ト ・ ワー ク スペース の定義 ... 19 接続の確認 ... 21 IPv6 ネ ッ ト ワー ク での接続... 21 ワ ー ク スペース ・ ビ ュ ーの限定... 22 マ ッ ピ ン グの指定... 22 ワー ク スペース ・ ビ ュ ーでの ワ イ ル ド カー ド の使用... 23 デ ィ ポの一部を マ ッ ピ ン グす る... 23Windows の ワー ク スペース を複数の ド ラ イ ブにマ ッ ピ ン グす る... 26 同一の ワー ク スペース を異な る マシ ンで使用す る... 26 自動的に ワー ク スペース か ら 空のデ ィ レ ク ト リ を削除す る... 27 ワ ー ク スペース の場所を変更す る ... 27 ワ ー ク スペース ・ オプシ ョ ン の構成 ... 28 サブ ミ ッ ト ・ オプシ ョ ン の設定... 29 行末 コ ー ド の設定 ... 30 ク ラ イ ア ン ト ・ ワー ク スペース仕様を削除す る ... 30 セキ ュ リ テ ィ ... 31 SSL 暗号化接続 ... 31 パ ス ワー ド... 32 接続時間の制限... 34 Unicode で作業す る ... 34
第 3 章
P4 コ マ ン ド の発行...37
コ マ ン ド ラ イ ン の構文 ... 37 コ マ ン ド ラ イ ン で フ ァ イ ル名を指定す る... 39 PERFORCE の ワ イ ル ド カー ド ... 39 フ ァ イ ル名 と 識別子におけ る 制限... 40 フ ァ イ ル ・ リ ビ ジ ョ ン を指定す る... 41 レ ポー ト ・ コ マ ン ド... 44 PERFORCEフ ォ ームの使用 ... 44第 4 章
フ ァ イ ル と チ ェ ン ジ リ ス ト の管理...47
フ ァ イ ルの管理... 47 フ ァ イ ルの同期 (取得)... 48 フ ァ イ ルの追加... 49 追加時に フ ァ イ ルのグループを無視す る... 50 フ ァ イ ルの変更... 51 変更の破棄 (元に戻す)... 51 フ ァ イ ルの削除... 52 チ ェ ン ジ リ ス ト の管理 ... 52 番号付チ ェ ン ジ リ ス ト の作成... 53 チ ェ ン ジ リ ス ト のサブ ミ ッ ト ... 54 チ ェ ン ジ リ ス ト の削除... 54 フ ァ イ ルの リ ネーム と 移動... 55 進行中の作業を保留す る... 55 チ ェ ン ジ リ ス ト に関す る情報の表示... 57 フ ァ イ ル内容の比較 ... 57 オ フ ラ イ ン で作業す る ... 59第 5 章
衝突の解決...61
衝突が発生す る 状況 ... 61 衝突解決の方法... 62衝突解決のオプシ ョ ン... 63
yours、 theirs、 ま たは merge の承諾... 64
merge フ ァ イ ルの編集... 64 衝突解決のためのマージ... 65 解決オプシ ョ ンの全 リ ス ト... 65 ブ ラ ンチ さ れた フ ァ イ ル、 削除、 移動、 フ ァ イ ル タ イ プ変更を 解決す る... 67 衝突解決のための コ マ ン ド ラ イ ン ・ オプシ ョ ン... 68 衝突解決の レ ポー ト ・ コ マ ン ド... 69 フ ァ イ ルの ロ ッ ク ... 69 フ ァ イ ルを ロ ッ ク し て、 多重衝突解決を防止す る... 69 多重チ ェ ッ ク ア ウ ト を防止す る... 70
第 6 章
コ ー ド ラ イ ン、 ブ ラ ンチ、 お よ びス ト リ ーム ...71
基本用語... 71 デ ィ ポの編成 ... 72 コ ー ド ラ イ ンにデー タ を読み込む ... 72 簡易的な方法 : p4 populate... 73 コ ー ド ラ イ ン を ブ ラ ンチす る ... 73 ブ ラ ンチを作成す る タ イ ミ ン グ... 73 ブ ラ ンチの作成... 74 変更の反映 ... 76 ブ ラ ンチ ・ マ ッ ピ ン グに よ る 反映... 77 関連性のない フ ァ イ ル間での反映... 77 特定のフ ァ イ ル ・ リ ビ ジ ョ ン を反映 さ せ る... 77 フ ァ イ ルを再反映 さ せ、 衝突を再解決す る... 78 反映に関す る レ ポー ト ・ コ マ ン ド... 78 ス ト リ ーム ... 78 ス ト リ ームの タ イ プ... 79 ス ト リ ーム ・ パ ス... 80 ス ト リ ーム ・ デ ィ ポの作成... 81 ス ト リ ームの作成... 81 メ イ ン ラ イ ンにデー タ を取 り 込む... 82 子ス ト リ ームにデー タ を取 り 込む... 83 変更を伝播す る... 84 変更を別の ス ト リ ーム階層に伝播す る ... 84 ス パース (希薄 ) なブ ラ ンチ と し ての タ ス ク ・ ス ト リ ームの使用.... 84 ス ト リ ームの ワー ク スペース を管理す る... 85第 7 章
ラ ベル ...87
ラ ベルを削除す る... 89 今後のために ラ ベルを作成す る... 89 タ グ付け可能な フ ァ イ ルを制限す る... 89 静的 ラ ベルを使っ て ワー ク スペース の設定を記録す る ... 90 自動 ラ ベルをチ ェ ン ジ リ ス ト や他の リ ビ ジ ョ ンの別名 と し て 使用す る... 90 フ ァ イ ルへの誤っ た タ グ付けお よ び取 り 外 し を防ぐ... 92
第 8 章
欠陥追跡 ...93
ジ ョ ブの管理 ... 93 ジ ョ ブの検索 ... 94 ジ ョ ブ ・ テ キ ス ト を検索す る ... 94 特定のフ ィ ール ド の検索... 95 比較演算子の使用... 95 日付フ ィ ール ド の検索... 96 ジ ョ ブの修正 ... 96 自動的に リ ン ク す る... 96 手動で リ ン ク す る... 97 ジ ョ ブをチ ェ ン ジ リ ス ト に リ ン ク す る... 97第 9 章
ス ク リ プ ト と レ ポー ト に使用す る コ マ ン ド ...99
ス ク リ プ ト と レ ポー ト の共通オプシ ョ ン ... 99 PERFORCE フ ォ ームに よ る ス ク リ プ ト 記述 ... 99 フ ァ イ ルの レ ポー ト ...100 フ ァ イ ルの状態を表示す る...100 フ ァ イ ルの リ ビ ジ ョ ン履歴の表示...101 作業状態のフ ァ イ ルを一覧表示す る...101 フ ァ イ ルの場所を表示す る...102 フ ァ イ ルの内容を表示す る...102 注釈 (フ ァ イ ル内容への変更の詳細情報) を表示す る ...102 フ ァ イ ルへの変更を監視す る ...103 チ ェ ン ジ リ ス ト の レ ポー ト ...104 チ ェ ン ジ リ ス ト を一覧表示す る...104 チ ェ ン ジ リ ス ト に関連す る フ ァ イ ル と ジ ョ ブ を一覧表示す る...104 ラ ベルの レ ポー ト ...105 ブ ラ ンチ と 反映の レ ポー ト ...105 ジ ョ ブの レ ポー ト ...106 ジ ョ ブを一覧表示す る...106 チ ェ ン ジ リ ス ト に よ り 解決 し たジ ョ ブ を一覧表示す る...106 シ ス テ ム構成の レ ポー ト ...106 ユーザの表示...106 ワー ク スペース の表示...107 デ ィ ポ を一覧表示す る ...107 サン プル ・ ス ク リ プ ト ...108付録 A
用語集 ... 109
付録 B
P
ERFORCE
の フ ァ イ ル タ イ プ ... 117
PERFORCEの フ ァ イ ル タ イ プ ...117 フ ァ イ ル タ イ プ修飾子 ...118 PERFORCEでの フ ァ イ ルの保存形式を指定す る ...119 Unicode の フ ァ イ ルに フ ァ イ ル タ イ プ を割 り 当て る ...119 フ ァ イ ル タ イ プを選択す る...120 PERFORCEの フ ァ イ ル タ イ プ検出 と Unicode...121 フ ァ イ ル タ イ プのオーバー ラ イ ド ...121 タ イ ム ス タ ン プの保存 ...121 RCS キー ワー ド 拡張 ...122索引 ... 123
は じ めに
こ のマニ ュ アルについて ...11
第 1 章
P4 のイ ン ス ト ール...13
第 2 章
P4 の構成...15
構成フ ァ イ ルを使用 し て 2 つの ワー ク スペース を切 り 替え る ... 18 ワ ー ク スペース ・ ビ ュ ーの設定... 20 デ ィ ポの一部を ク ラ イ ア ン ト ・ ワー ク スペース にマ ッ ピ ン グす る ... 23 単一の ワ ー ク スペース ・ ビ ュ ーにおけ る 複数のマ ッ ピ ン グ ... 24 フ ァ イ ルをデ ィ ポ内 と ク ラ イ ア ン ト ・ ワー ク スペース内で異な る 名前にす る ... 24 位置指定子を使用 し て フ ァ イ ル名 と デ ィ レ ク ト リ を置 き 換え る ... 24 ビ ュ ーを使用 し て フ ァ イ ルを ク ラ イ ア ン ト ・ ワー ク スペース か ら 除外す る ... 24 衝突す る 誤っ たマ ッ ピ ン グ ... 25 複数のデ ィ レ ク ト リ を同 じ ワ ー ク スペース にオーバーレ イ す る ... 25 フ ァ イ ル名 と デ ィ レ ク ト リ 名の スペース に対応す る ... 25第 3 章
P4 コ マ ン ド の発行...37
同 じ フ ァ イ ルを異な る シ ン タ ッ ク ス に よ り 参照す る ... 39 リ ビ ジ ョ ン指定子を使っ て フ ァ イ ルを取得す る ... 43 ク ラ イ ア ン ト ・ ワー ク スペース か ら すべての フ ァ イ ルを削除す る ... 43 リ ビ ジ ョ ン範囲を指定 し てチ ェ ン ジ を一覧表示す る ... 44第 4 章
フ ァ イル と チ ェ ン ジ リ ス ト の管理 ...47
デ ィ ポか ら ク ラ イ ア ン ト ・ ワ ー ク スペースへの フ ァ イ ルの コ ピー ... 48チ ェ ン ジ リ ス ト を保留す る ... 55 コ ー ド ・ レ ビ ュ ーのためにチ ェ ン ジ リ ス ト の保留を解除 し ます。... 55 他のユーザに フ ァ イ ルを引 き 継 ぐ ... 56 変更を サブ ミ ッ ト す る 前に保留状態の フ ァ イ ルを破棄す る ... 56
第 5 章
衝突の解決...61
フ ァ イ ルの衝突を解決す る ... 66 衝突す る フ ァ イ ルの特定 リ ビ ジ ョ ン を自動的に受け入れ る ... 68第 6 章
コ ー ド ラ イ ン、 ブ ラ ン チ、 およびス ト リ ーム...71
フ ァ イ ル指定を使用 し てブ ラ ンチを作成す る ... 75 ブ ラ ンチ ・ フ ァ イ ル間で変更を伝達す る ... 76 ブ ラ ンチ内にあ る 単一の フ ァ イ ルに変更を反映す る ... 77 特定の フ ァ イ ル ・ リ ビ ジ ョ ン を反映 さ せ る ... 77第 7 章
ラ ベル ...87
ラ ベルに よ っ て タ グ付け さ れた フ ァ イ ルを ク ラ イ ア ン ト ・ ワ ー ク スペース に取得す る ... 88 ラ ベル ・ ビ ュ ーを使用 し て タ グ付け可能な フ ァ イ ルを制御す る ... 89 自動 ラ ベルをチ ェ ン ジ リ ス ト 番号の別名 と し て使用す る ... 90 あ る 1 つのチ ェ ン ジ リ ス ト でサブ ミ ッ ト さ れた一連の フ ァ イ ルを 限定的に参照す る ... 91 複数のチ ェ ン ジ リ ス ト にあ る 各フ ァ イ ルについて最初の リ ビ ジ ョ ン を 参照す る ... 91第 8 章
欠陥追跡 ...93
ジ ョ ブの作成 ... 93 指定の単語を含むジ ョ ブの検索... 94 いずれかの フ ィ ール ド に一連の単語の う ち どれか を含むジ ョ ブの検索 94 特定フ ィ ール ド 内に指定の単語を含むジ ョ ブの検索 ... 95 あ る フ ィ ール ド に特定の値が含まれてい る ジ ョ ブ を除外す る ... 95 式の中での日付の使用 ... 96 自動的にジ ョ ブ をチ ェ ン ジ リ ス ト に リ ン ク す る ... 97 手動でジ ョ ブ をチ ェ ン ジ リ ス ト に リ ン ク す る ... 97第 9 章
ス ク リ プ ト と レ ポー ト に使用する コ マ ン ド ...99
p4 annotate を使っ て、 フ ァ イ ルへの変更を表示...103 p4 fstat コ マ ン ド の出力の解析結果を示すサン プル ・ シ ェ ル ・ ス ク リ プ ト ...108付録 A
用語集 ... 109
付録 B
P
ERFORCE
のフ ァ イル タ イ プ ... 117
本書では、PERFORCE の コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト (p4) の使用方法を説明 し ます。バージ ョ ン管理シ ス テ ム を初めてお使いにな る 場合、 PERFORCE の基本概念を ご存知でない場合、 ま た は PERFORCE を一度 も 使用 し た こ と がない場合は、 本書をお読みにな る 前に 『PERFORCE 概要』 を ご覧 く だ さ い。 本書では バージ ョ ン管理 に関 し て十分な基礎知識があ る こ と を前提 と し て い ます。
コ マ ン ド ラ イ ン と GUI
PERFORCE には、 PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト 、 P4V な ど の GUI ツール、 プ ラ グ イ ン な ど、 フ ァ イ ル管理を行 う ための ア プ リ ケーシ ョ ン が数多 く 用意 さ れてい ま す。 PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト に よ り 、 PERFORCE GUI ではサポー ト さ れていない、 シ ス テ ム 管理作業の ス ク リ プ ト 化や実行を行 う こ と がで き ます。
P
ERFORCE
入門
PERFORCEを初めて操作す る 場合は、 次の手順に従っ て く だ さ い。 1. 『PERFORCE 概要』 を読み、 基礎を習得 し ます。 少な く と も 、チ ェ ン ジ リ ス ト、デ ィ ポ、 ク ラ イ ア ン ト ・ ワー ク スペース、 同期、 サブ ミ ッ トの概念について習得 し て く だ さ い。 簡潔な用語定義が、 本書の付録にあ る 用語集 に記述 さ れてい ます。 2. PERFORCE 管理者に PERFORCE サービ ス のホ ス ト お よ びポー ト の情報を問い合わせて く だ さ い。 実稼動のデ ィ ポ を破壊す る こ と な く PERFORCE の試験を行いたい場合は、 試験用の別の サービ ス を起動す る よ う PERFORCE管理者に依頼 し て く だ さ い。 PERFORCE サービ ス の イ ン ス ト ールに関す る 詳細は、『PERFORCEシ ス テ ム管理者ガ イ ド 』 を参照 し て く だ さ い。 3. シ ス テ ム管理者が既にマシ ン の構成を行っ ていない場合、 本書を参照 し て PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト の イ ン ス ト ールお よ び ク ラ イ ア ン ト ・ ワ ー ク スペース の構 成を行っ て く だ さ い。 詳 し く は、 第 2 章の 「P4 の構成」 を ご覧 く だ さ い。 4. 以下の作業の実行方法を習得 し て く だ さ い。こ れ ら について基本的な技術が あれば、 日常業務の多 く を こ なす こ と がで き ま す。 その他の コ ー ド ラ イ ンの保守 (ス ト リ ーム、 ブ ラ ンチ操作 と ラ ベル付け) や ワー ク フ ロ ー (ジ ョ ブ) に かかわ る 作業を実施す る 頻度はそれほ ど多 く あ り ません。 本書では p4 コ マン ド を使用し た こ れ ら の作業の実施方法について も 説明 し てい ます。
P
ERFORCE
ド キ ュ メ ン ト
本書、『PERFORCE コ マ ン ド ・ リ フ ァ レ ン ス』、 お よ び p4 help コ マン ド が PERFORCE コ マ ン ド
ラ イ ン ・ ク ラ イ ア ン ト に関す る 主要な ド キ ュ メ ン ト です。 本書では最新版の リ リ ース について 説明 し てい ます。以前の リ リ ース の ド キ ュ メ ン ト については PERFORCE 社の Web サ イ ト を参照 し て く だ さ い。 他の PERFORCEアプ リ ケーシ ョ ン に関す る ド キ ュ メ ン ト は、 PERFORCE 社の ウ ェ ブサ イ ト http://www.perforce.com の documentation のページか ら 入手で き ます。
ご意見 ・ ご感想を お待ち し ています
当社では、 本書に関す る ユーザのみな さ んか ら のご意見をお待ち し てい ます。 と り わけ、 初め て PERFORCE をお使いにな っ たユーザのみな さ んのご意見は、 ぜひお聞かせ願いたい と 思い ま す。 本書を読んで十分な情報は得 ら れ ま し たか ? ご感想をお聞かせ く だ さ い。 ご意見 ・ ご感 想の宛先は下記の と お り です。 manual@perforce.com 記述 さ れる詳細情報 記述 ド キ ュ メ ン ト PERFORCEの基礎 『PERFORCE概要』 プ ロ キ シ、 レ プ リ カ、 セ キ ュ リ テ ィ 設 定 を 含 む、 PERFORCEサービ ス の イ ン ス ト ールお よ び管理 『PERFORCE シ ス テ ム管理者ガ イ ド 』 p4 コ マン ド ラ イ ン・フ ラ グおよびオプシ ョ ン ( リ フ ァ レ ン ス ) 『PERFORCE コ マン ド ・ リ フ ァ レ ン ス』、 p4 help P4V -プ ラ ッ ト フ ォーム互換 PERFORCE ビ ジ ュ アル ・ ク ラ イ ア ン ト 『P4V 入門』、 P4V オン ラ イ ン ・ ヘルプ PERFORCE サン ド ボ ッ ク ス を使用 し てオ フ ラ イ ンで作 業す る 『PERFORCEサン ド ボ ッ ク ス ・ ユーザーズ ・ ガ イ ド 』PERFORCEプ ラ グ イ ンお よ び統合ツール IDE :『IDE プ ラ グ イ ン ・ ユーザーズ ・ ガ イ ド 』
障害追跡ツール : 『Defect Tracking Gateway Guide』
その他 : PERFORCE メ ニ ュ ーま たは Web サ イ ト か ら のオン ラ イ ンヘルプ
PERFORCE C/C++ API を利用 し た カ ス タ ム PERFORCEア
プ リ ケーシ ョ ンの開発
『C/C++ API ユーザ ・ ガ イ ド 』 Ruby、 Perl、 Python、 PHP に よ る PERFORCEサービ ス
の操作
『APIs for Scripting』
注 日本語版 PERFORCE は、 P4Web, C/C++ API を サポー ト し てお り ま せんので ご注意 く
こ の章では、 PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト (p4) を ワ ー ク ス テーシ ョ ン に イ ン ス
ト ールす る 方法を説明 し ます。 PERFORCE バージ ョ ン化サービ ス の イ ン ス ト ールに関 し て詳 し く は、『PERFORCEシ ス テ ム管理者ガ イ ド 』 を参照 し て く だ さ い。
UNIX および OS X への P4 のイ ン ス ト ール
PERFORCE コ マ ン ド ラ イ ン・ ク ラ イ ア ン ト を UNIX ま たは Mac OS X マシ ンに イ ン ス ト ールす る 手順を以下に示 し ます。 1. p4 実行可能フ ァ イ ルを以下の PERFORCE 社の Web サ イ ト か ら ダ ウ ン ロ ー ド し ます。 http://www.perforce.com/downloads/complete_list PERFORCEアプ リ ケーシ ョ ンは通常 /usr/local/bin に イ ン ス ト ール さ れます。 2. p4 フ ァ イ ルを実行可能に し ます (chmod +x p4)。 3. ポー ト の設定、ク ラ イ ア ン ト ・ ワ ー ク スペース名、お よ びユーザ名を構成 し ます。 P4PORT、 P4CLIENT、 P4USER の各環境変数に よ り 、 こ れ ら の設定を行 う こ と がで き ます。 (詳 し く は、 第 2 章の 「P4 の構成」 を参照 し て く だ さ い)。
Windows への P4 のイ ン ス ト ール
PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト (p4.exe) を Windows に イ ン ス ト ールする には、 以
下の PERFORCE 社の Web サ イ ト にあ る Downloads ページか ら 、 PERFORCE Windows イ ン ス ト ー ラ (perforce.exe) を ダ ウ ン ロー ド し て実行し ます。
http://www.perforce.com/downloads/complete_list
PERFORCE イ ン ス ト ー ラ に よ り 、 PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト お よ び そ の他の
PERFORCE Windows コ ン ポーネ ン ト の イ ン ス ト ール と ア ン イ ン ス ト ール を 行 う こ と がで き ま す。
イ ン ス ト ールの確認
PERFORCE コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト が正常に イ ン ス ト ール さ れたか ど う か確認す る には、
コ マ ン ド ラ イ ン で p4 info と 入力し て ENTER キーを押し ます。 PERFORCE サービ ス が特定の ホ ス ト お よ びポー ト で稼動 し ていれば、 次の よ う な メ ッ セージが表示 さ れ ます。
構成の設定が正 し く ない場合、 次の よ う なエ ラ ー メ ッ セージが表示 さ れ ます。
PERFORCEが SSL 接続を必要 と す る よ う に管理者が設定 し てい る 場合、 PERFORCEサービ ス に最
初に接続を試みた と き にサーバの フ ィ ン ガープ リ ン ト を検証す る 必要があ り ます。31 ページの 「SSL 暗号化接続」 を参照 し て く だ さ い。
User name: ona
Client name: ona-agave Client host: agave
Client root: /home/ona/p4-ona Current directory: /home/ona/p4-ona Client address: 10.0.0.196
Server address: perforce:1666 Server root: /usr/depot/p4d
Server date: 2012/03/28 12:11:47 -0700 PDT Server uptime: 752:41:33
Server version: P4D/FREEBSD/2012.1/406375 (2012/01/25)
Server license: P4Admin <p4adm> 20 users (expires 2013/01/01) Server license-ip: 10.0.0.2
Case handling: sensitive
PERFORCE client error:
Connect to server failed; check $P4PORT. TCP connect to <hostname> failed.
こ の章では、 接続の設定の構成方法について説明 し ます。
構成の概要
PERFORCEは企業向けバージ ョ ン管理シ ス テ ム であ り 、こ れに よ り ユーザは共有 さ れたバージ ョ ン化サービ ス に接続 し ます。 ユーザはデ ィ ポ と 呼ばれ る 共有レ ポジ ト リ か ら フ ァ イ ルを同期 さ せ、 それを自分の ワ ー ク ス テーシ ョ ン の ク ラ イ ア ン ト ・ ワ ー ク ス ペー ス において編集 し ます。 こ の章では、 シ ス テ ム管理者がお客様の組織の PERFORCEサービ ス を既に構成 し てい る こ と を 想定 し てい ます。 バージ ョ ン化サービ ス の設定に関 し て詳 し く は、 「PERFORCEシ ス テ ム管理者 ガ イ ド 」 を 参照 し て く だ さ い。 ワ ー ク スペース を設定 し て PERFORCE と のや り 取 り を可能にす る には、 次の手順に従っ て く だ さ い。 1. プ ロ ト コ ル、 ホ ス ト お よ びポー ト を設定 ( し て、 PERFORCEサービ ス に接続で き る よ う に) し ます。 17 ページの 「Perforce の設定」 を参照 し て く だ さ い。 2. ワ ー ク ス ペー ス を定義 し ま す (少な く と も 、 名前を指定 し 、 デ ィ ポ ・ フ ァ イ ルの ロ ーカ ル ・ コ ピーを格納 し たい ワー ク スペース のルー ト を指定 し て く だ さ い)。 19 ページの 「 ク ラ イ ア ン ト ・ ワ ー ク スペース の定義」 を参照 し て く だ さ い。 3. 接続を確認 し ます。 21 ページの 「接続の確認」 を参照 し て く だ さ い。 ワ ー ク スペース を構成 し た ら 、デ ィ ポに格納 さ れてい る フ ァ イ ル と 同期 さ せて ワー ク スペース に取 り 込む こ と がで き ます。詳 し く は、48 ページの 「フ ァ イ ルの同期 (取得)」 お よ び『PERFORCE コ マ ン ド ・ リ フ ァ レ ン ス』 の p4 sync コ マン ド に関する説明を参照し て く だ さ い。 PERFORCEの構成を始め る 前に、 PERFORCE 管理者にサーバ ・ ホ ス ト お よ びポー ト の設定につい て問い合わせて く だ さ い。 ま は、 ワ ー ク ス テーシ ョ ンに既に ワ ー ク スペース が構成 さ れてい る か確認 し て く だ さ い。ク ラ イ ア ン ト ・ ワー ク スペース と は
PERFORCE ク ラ イ ア ン ト ・ ワー ク スペースと は、 PERFORCE に よ っ て管理 さ れ る フ ァ イ ル ・ リ ビ ジ ョ ンの操作を行 う ワ ー ク ス テーシ ョ ン上にあ る 、 デ ィ レ ク ト リ の集合です。 各ワ ー ク スペー ス には、 PERFORCE サーバに対 し て ク ラ イ ア ン ト ・ ワ ー ク ス ペー ス を識別す る ための固有の名1 つのマシ ン上に複数の ワー ク スペース を構成す る 場合、 不用意に フ ァ イ ルが上書 き さ れ る こ と のない よ う 、 ワ ー ク ス ペー ス の場所 を分離 し て く だ さ い。 ク ラ イ ア ン ト ・ ルー ト が別々の フ ォ ルダに配置 さ れ る よ う に し 、 ワー ク スペース ・ ビ ュ ーをデ ィ ポ ・ フ ァ イ ルにマ ッ ピ ン グす る と き 、 ワー ク ス テーシ ョ ン上の位置が重な ら ない よ う に し て く だ さ い。 ワ ー ク スペース を構成 し た ら 、 フ ァ イ ルをデ ィ ポ と 同期 し て変更をサブ ミ ッ ト す る こ と がで き ます。 こ れ ら の操作について詳 し く は、 第 4 章の 「フ ァ イ ル と チ ェ ン ジ リ ス ト の管理」 を参照 し て く だ さ い。
P
ERFORCEによ るワー ク スペースの管理方法
PERFORCE は ク ラ イ ア ン ト ・ ワー ク スペース内の フ ァ イ ルを以下の よ う に管理 し ます。 • ユーザに よ る変更に応 じ て、 ワー ク スペース内の フ ァ イ ルの作成、更新、削除が行われます。 • 書き込み許可はユーザがフ ァ イ ルを編集する際に有効に さ れ、変更をサブ ミ ッ ト する際に無 効に さ れ ます。 ユーザの ワー ク スペース の状態は、 PERFORCE に よ り 追跡 さ れ、 管理 さ れ ます。 PERFORCE アプ リ ケーシ ョ ンに よ り 実行 さ れ る フ ァ イ ル管理 と の衝突を避け る ため、 フ ァ イ ルの読み取 り 専用 の許可設定を手動で変更 し ないで く だ さ い。 PERFORCEには、 あ る ク ラ イ ア ン ト ・ ワ ー ク スペー ス の状態が、 PERFORCE に記録 さ れてい る 状態 と 一致 し てい る か否か を判定で き る コ マ ン ド が あ り ます。 詳 し く は、 59 ページの 「オ フ ラ イ ン で作業す る 」 を ご覧 く だ さ い。 PERFORCE に よ り 制御 さ れ る よ う 指定 し ていない ワー ク スペース内の フ ァ イ ルは、 PERFORCE に は無視 さ れ ます。 例えば、 コ ンパ イ ル済みオブジ ェ ク ト 、 ラ イ ブ ラ リ 、 実行可能フ ァ イ ル、 お よ び ソ フ ト ウ ェ ア の開発中に作成 さ れたデ ィ ポに追加 さ れていない開発者用一時 フ ァ イ ルな どは、 PERFORCE コ マ ン ド の影響を受け ません。 ク ラ イ ア ン ト ・ ワ ー ク スペース を定義 し た ら 、 ワ ー ク スペース の定義を微調整す る こ と がで き ます。 おそ ら く 最 も 重要な こ と は、 デ ィ ポ内のユーザが見 る こ と ので き る 部分を制限 し て、 不 用意にデ ィ ポ全体を同期 さ せない よ う にす る こ と です。 詳 し く は、 22 ページの 「ワ ー ク スペー ス ・ ビ ュ ーの限定」 を参照 し て く だ さ い。P
ERFORCE
の設定
本書では、 環境変数を使用 し た PERFORCE の設定方法 ( 「set P4CLIENT」 な ど ) を説明し てい
ますが、 サーバ ・ ポー ト 、 ユーザ、 ワー ク スペース名な ど の PERFORCE の設定は以下の方法で 指定す る こ と がで き ます。 それ ら について優先順位の高い順に示 し ます。 1. コ マ ン ド ラ イ ン でオプシ ョ ン を使用す る 2. P4CONFIG が設定 さ れてい る場合、 構成フ ァ イ ルで指定する 3. ユーザ環境変数 (UNIX ま たは Windows において) を使用する 4. シ ス テ ム環境変数を使用す る (Windows ではシ ス テ ム全体の環境変数はユーザ環境変数 と 同 じ ではない こ と があ り ます) 5. Windows ま たは OS X において、 ユーザ ・ レ ジ ス ト リ ま たはユーザ設定を使用す る (p4 set コ マン ド を発行 し て設定する) 6. Windows ま たは OS X において、 シ ス テ ム ・ レ ジ ス ト リ ま たはシ ス テ ム設定を使用す る (p4 set -s コ マン ド を発行し て設定する) PERFORCE サービ ス に接続す る よ う ワ ー ク ス テーシ ョ ン を構成す る には、 サービ ス が稼働 し て い る ホ ス ト の名前お よ びサーバが接続を待機す る ポー ト を指定 し ます。デフ ォ ル ト のホ ス ト は PERFORCE、 デフ ォ ル ト のポー ト は 1666 です。 サービ ス がマシ ン上で起動 し てい る 場合、 ホ ス ト 名を localhost に指定し て く だ さ い。 サービ ス がポー ト 1666 で起動 し てい る場合、 ポー ト の指定を省略す る こ と がで き ます。 以降のセ ク シ ョ ン で説明す る と お り 、 こ れ ら の設定を指定す る こ と がで き ま す。 オ フ ラ イ ン (PERFORCE サービ ス に接続 し ない) での作業に関す る 詳細は、 59 ページの 「オ フ ラ イ ン で作業 す る 」 を参照 し て く だ さ い。
コ マ ン ド ラ イ ンの使用
こ れ ら の設定を コ マ ン ド ラ イ ン で指定す る には、 -p オプシ ョ ン を使用 し て く だ さ い。 例えば こ の よ う に し ます。p4 -p tcp:localhost:1776 sync //depot/dev/main/jam/Jambase 環境変数、 Windows レ ジ ス ト リ 、 ま たは OS X のシ ス テ ム設定。 コ マ ン ド ラ イ ン ・ オプシ ョ ン に関す る 詳細は、 「PERFORCEコ マ ン ド ・ リ フ ァ レ ン ス」 のグ ロ ーバル ・ オプシ ョ ンの説明を参 照 し て く だ さ い。
構成フ ァ イルの使用
構成フ ァ イ ルは、 その フ ァ イ ルのあ る デ ィ レ ク ト リ お よ びその配下のデ ィ レ ク ト リ にあ る フ ァ イ ルに影響す る PERFORCE の設定が記述 さ れてい る テ キ ス ト ・ フ ァ イ ルです。構成フ ァ イ ルは、 1 つのマシ ン上に複数の ク ラ イ ア ン ト ・ ワー ク スペース があ る 場合に有用です。 構成フ ァ イ ル で設定を指定すれば、異な る ワー ク スペース で作業す る たびにシ ス テ ム設定を変更す る と い う 面倒な作業は必要あ り ません。 構成フ ァ イ ルを使用す る には、 フ ァ イ ル名を指定 (.p4config な ど) し て、 P4CONFIG 環境 変数を定義 し ます。 コ マ ン ド の発行時、PERFORCE は現在の作業デ ィ レ ク ト リ お よ びその親デ ィ構成フ ァ イ ルで指定で き る 設定項目を以下に示 し ます。 こ れ ら の設定に関 し て詳 し く は、『PERFORCE コ マ ン ド ・ リ フ ァ レ ン ス』 を参照 し て く だ さ い。 例 : 構成フ ァ イ ルを使用 し て 2 つの ワー ク スペース を切 り 替え る オナは 1 つのマシ ン上にあ る 2 つの ワー ク スペース を切 り 替え ます。 1 番目の ワー ク ス ペース はona-ashです。 その ワー ク スペース ・ ルー ト は /tmp/user/onaであ り 、 SSL 接続を使用 し て PERFORCE サービ ス に ssl:ida:1818で接続 し ます。 2 番目の ワー ク ス ペース はona-agaveで、 その ワー ク スペース ・ ルー ト は/home/ona/p4-onaであ り 、 プ レーン テ キ ス ト 接続を使用 し て PERFORCEサービ ス に tcp:warhol:1666 で接続 し ま す。
オナは P4CONFIG 環境変数を .p4settings に設定 し ます。彼女は /tmp/user/ona に 以下のテ キ ス ト を含む .p4settings と い う フ ァ イ ルを作成 し ます。 P4PORT=ssl:ida:1818 P4CLIENT=ona-ash 彼女は /home/ona/p4-ona に 2 番目の .p4settings フ ァ イ ルを作成 し ます。そのフ ァ イ ルには次のテ キ ス ト が含まれます。 P4PORT=tcp:warhol:1666 P4CLIENT=ona-agave 彼女が /tmp/user/ona 配下の フ ァ イ ルに対 し て 行 う 作業は、ssl:ida:1818 に あ る PERFORCE サービ ス に よ り 管理 さ れ ます。/home/ona/p4-ona 配下のフ ァ イ ルに対 し て 行 う 作業は、tcp:warhol:1666 にあ る PERFORCEサービ ス に よ り 管理 さ れます。 設定 説明 P4CHARSET Unicode フ ァ イ ルの翻訳に使用 さ れ る 文字セ ッ ト
P4COMMANDCHARSET P4CHARSET が UTF-16 文字セ ッ ト ま たは UTF-32 文字セ ッ ト に設定 さ れてい る 場合に コ マ ン ド ラ イ ン ・ ク ラ イ ア ン ト で使用 さ れ る UTF-16 ま たは UTF-32 以外の文字セ ッ ト
P4CLIENT 現在の ク ラ イ ア ン ト ・ ワ ー ク スペース名
P4DIFF p4 resolve および p4 diff に よ り 使用 さ れる比較プ ロ グ ラ ムの名 前お よ び場所
P4EDITOR フ ォーム を使用す る PERFORCEコ マ ン ド に よ り 起動 さ れ る エデ ィ タ P4HOST ク ラ イ ア ン ト ・ ワー ク ス テーシ ョ ンのホ ス ト 名。現在の ク ラ イ ア ン ト ・
ワ ー ク スペース の Host: フ ィ ール ド が p4 client フ ォームに設定 さ れてい る 場合にのみ有用です。
P4IGNORE P4 ADDコ マ ン ド お よ び p4 reconcile コ マン ド の使用時に無視する
フ ァ イ ルの リ ス ト です。
P4LANGUAGE こ の環境変数はシ ス テ ムの統合用に予約 さ れてい ます。
P4MERGE p4 resolve のマージ ・ オプ シ ョ ン で使用す る サー ド ・ パーテ ィ の マージ ・ プ ロ グ ラ ムの名前お よ び場所
P4PASSWD PERFORCE ク ラ イ ア ン ト ・ コ マ ン ド に対 し 、 現在の PERFORCEユーザの パ ス ワ ー ド を指定 し ます。 P4PORT 接続先の PERFORCE サービ ス (プ ロ キ シ ま たはブ ロ ーカ を含む) のプ ロ ト コ ル、 ホ ス ト 、 お よ びポー ト 番号 P4TRUST 既知の (信頼 さ れた) PERFORCE サーバの フ ァ イ ルが あ る 場所。 こ の フ ァ イ ルの内容は、p4 trust コ マン ド を使用し て管理し ます。デフ ォ ル ト で は、 こ の フ ァ イ ル は ユ ー ザ の ホ ー ム ・ デ ィ レ ク ト リ 内 の .p4trust です。 P4USER 現在の PERFORCEユーザ名
環境変数の使用
環 境 変 数 を 使 用 し て サ ー バ 接 続 設 定 を 構 成 す る に は、 P4PORT を 以 下 の 例 の よ う に protocol:host:port の形式で設定 し て く だ さ い。 P4PORT の設定にプ ロ ト コ ルを指定 し ていない場合、 tcp: (TCP/IP 経由のプ レーン テキ ス ト での通信) が想定 さ れ ます。 PERFORCEサービ ス が SSL をサポー ト す る よ う に構成 さ れてい る 場合、 使用 し たいプ ロ ト コ ル と し て ssl: を設定する こ と に よ り PERFORCE接続を暗号化す る こ と がで き ます。 その他のプ ロ ト コ ル (例えば、 tcp4: はプ レーン テ キ ス ト の IPv4 接続を必要 と し 、 ssl64: は暗 号化接続を必要 と し ますが、IPv4 よ り も IPv6 に よ る 転送の使用が推奨 さ れ ます) も 、混合ネ ッ ト ワー ク 環境で使用可能です。 詳 し く は、 21 ページの 「IPv6 ネ ッ ト ワ ー ク での接続」 お よ び 『シ ス テ ム管理者ガ イ ド 』 を参 照 し て く だ さ い。Windows のレ ジ ス ト リ または OS X のシ ス テム設定を使用する
Windows お よ び OS X のマシ ン では、 p4 set コ マン ド を使用 し て、接続設定を レ ジ ス ト リ (ま たはシ ス テ ム設定) に保存す る こ と がで き ます。 例 : p4 set P4PORT=ssl:tea.example.com:1667 PERFORCE の設定を レ ジ ス ト リ に構成す る 方法には以下の 2 つがあ り ます。 • p4 set setting=value- 現在の ロ ーカル ・ ユーザ用。 • p4 set -s setting=value- ロ ーカル ・ マシ ン上のすべてのユーザ用。 ロ ーカル ・ ユーザ 用の レ ジ ス ト リ 設定に よ っ て上書 き さ れ る こ と が あ り ま す。 設定には管理者権限が必要で す。 ど ち ら の設定が適用 さ れてい る か を確認す る には、p4 set コ マン ド を引数な し で使用 し ます。 p4 set コ マン ド に関 し て詳 し く は、『PERFORCEコ マ ン ド ・ リ フ ァ レ ン ス』を参照 し て く だ さ い。ク ラ イ ア ン ト ・ ワー ク スペースの定義
ク ラ イ ア ン ト ・ ワー ク スペース を定義す る には、 1. P4CLIENT を設定 し て ワー ク スペース名を指定 し ます。 例えば UNIX シ ス テ ムの場合、 以 下の よ う に し ます。 サービ スが稼動 し ている 場所 接続を待機 し ている ポー ト 暗号化プ ロ ト コ ルの サポー ト P4PORT の設定 自身の コ ン ピ ュ ー タ 1666 な し (プ レーン テ キ ス ト ) localhost:1666 perforce 1666 SSL ssl:perforce:1666 houston 3435 な し (プ レーン テ キ ス ト ) tcp:houston:3435 deneb.com 1818 SSL ssl:example.com:1818ク ラ イ ア ン ト 仕様を作成す る と き 、 フ ァ イ ルは一切同期 さ れ ま せん。 フ ァ イ ル をデ ィ ポか ら ワ ー ク スペース に同期す る 方法を知 る には、 48 ページの 「フ ァ イ ルの同期 (取得)」 を参照 し て く だ さ い。 マシ ン上での フ ァ イ ルの移動に関 し て詳 し く は、 27 ページの 「ワ ー ク スペース の 場所を変更す る 」 を参照 し て く だ さ い。 ク ラ イ ア ン ト ・ ワー ク スペース の構成において最小限指定 し なければな ら ない設定は以下の通 り です。 • ワー ク スペース名 ワ ー ク スペース名はマシ ンのホ ス ト 名をデフ ォ ル ト と し ますが、 ワ ー ク ス テーシ ョ ン には複 数の ワ ー ク ス ペー ス を 含め る こ と がで き ま す。 効果的に ワ ー ク ス ペー ス を 指定す る には、 P4CLIENT を設定 し て く だ さ い。 • ワー ク スペース ・ ルー ト ク ラ イ ア ン ト ・ ワー ク スペース ・ ルー ト は ク ラ イ ア ン ト ・ ワ ー ク スペース の最上位のデ ィ レ ク ト リ で あ り 、 PERFORCE はそ こ にデ ィ ポ ・ フ ァ イ ルの作業用 コ ピーを保存 し ま す。 ワ ー ク スペース ・ ルー ト を必ず設定 し て く だ さ い。 そ う し ない と 、 フ ァ イ ルを不用意に自分の ワ ー ク ス テーシ ョ ン のルー ト ・ デ ィ レ ク ト リ に同期 さ せて し ま う 可能性が あ り ま す。 (Windows 環境で ワ ー ク スペース ・ ルー ト を指定す る 際は、 ド ラ イ ブ文字 も 含め る 必要があ り ます。) ワ ー ク スペース ・ ルー ト ・ デ ィ レ ク ト リ が存在 し ない場合は、 PERFORCEク ラ イ ア ン ト ・ ワ ー ク スペース ・ ビ ュ ーがそれを使用で き る よ う に事前に作成 し ておかなければな り ません。 文字 @、 #、 *、 % はそれぞれ、 PERFORCE では特別な意味があ り ます。 こ れ ら の文字を フ ァ イ ル名ま たは フ ォ ルダ名に使用 し てい る 場合は、 40 ページの 「フ ァ イ ル名 と 識別子におけ る 制限」 を参照 し て く だ さ い。 ク ラ イ ア ン ト ・ ワ ー ク スペース ・ ビ ュ ーに よ り 、 デ ィ ポ内の ど の フ ァ イ ルが ワ ー ク スペース に マ ッ ピ ン グ さ れ る かが決定 さ れ、 PERFORCE が個々のデ ィ ポ と ワ ー ク スペー ス ・ フ ァ イ ルの間 に 1 対 1 のマ ッ ピ ン グ を構成す る こ と がで き ます。デ ィ ポ内での名前や場所 と は異な る 名前お よ び ワー ク スペース内の場所に フ ァ イ ルを マ ッ ピ ン グす る こ と がで き ますが、 ワー ク スペース ま たはデ ィ ポ内の複数の場所に フ ァ イ ル を マ ッ ピ ン グす る こ と はで き ま せん。 デ フ ォ ル ト で は、 デ ィ ポ全体がユーザの ワ ー ク ス ペー ス にマ ッ ピ ン グ さ れ ま す。 ク ラ イ ア ン ト ・ ワ ー ク ス ペース ・ ビ ュ ーを定義 し 、 自分に関係す る フ ァ イ ルお よ びデ ィ レ ク ト リ のみを マ ッ ピ ン グす る こ と に よ り 、デ ィ ポ全体を不用意に自分の ワー ク スペース に同期 さ せない よ う にす る こ と がで き ます。 詳 し く は、 22 ページの 「 ワー ク スペース ・ ビ ュ ーの限定」 を参照 し て く だ さ い。 例 : ワー ク スペース ・ ビ ュ ーの設定 ブルー ノ は、 p4 client コ マ ン ド を 発行 し て、 以下のデ フ ォ ル ト の ワ ー ク ス ペー ス ・ ビ ュー定義を含むフ ォーム を参照 し ます。 彼は、 ビ ューを変更 し てデ ィ ポの開発部分のみを マ ッ ピ ン グす る よ う に し ます。 Client: bruno_ws Update: 2011/11/29 09:46:53 Access: 2011/03/02 10:28:40 Owner: bruno Root: c:\bruno_ws
Options: noallwrite noclobber nocompress unlocked nomodtime normdir SubmitOptions: submitunchanged LineEnd: local View: //depot/... //bruno_ws/... View: //depot/dev/... //bruno_ws/dev/...
彼は さ ら にビ ュ ーを変更 し て、フ ァ イ ルを複数のデ ィ ポか ら 自分の ワー ク スペース にマ ッ ピ ン グ し ます。
接続の確認
接続状態を確認す る には、 p4 info コ マ ン ド を発行 し ます。 P4PORT が正 し く 設定 さ れてい れば、 次の よ う な情報が表示 さ れ ます。
Server address: フ ィ ール ド には p4 が接続 し てい る ホ ス ト 、および PERFORCEサービ ス が接
続を待機 し てい る ホ ス ト 名 と ポー ト 番号が表示 さ れ ま す。 P4PORT の設定が正 し く ない場合、 次の よ う な メ ッ セージ を受け取 り ます。 エ ラ ー ・ メ ッ セージの 3 行目に表示 さ れ る 値が perforce:1666 (上記の と お り ) であ る 場 合、 P4PORT が設定 さ れてい ません。 それ以外の値であ る場合は、 P4PORT の設定が不正です。 P4PORT を設定 し て再接続 し て く だ さ い。 お使いの イ ン ス ト ールで SSL接続が必要 と さ れ る場合、P4PORT を確実に ssl:hostname:port の形式に し て く だ さ い。 サービ ス に最初に接続を試みた と き 、 サーバの フ ィ ン ガープ リ ン ト を検証す る こ と を要求 さ れ ます。 フ ィ ン ガープ リ ン ト が正 し ければ、 p4 trust コ マン ド を使用 し て、 フ ィ ンガープ リ ン ト を フ ァ イ ル (P4TRUST 環境変数で指定) に イ ン ス ト ール し ます。 こ のフ ァ イ ルには、 既知 / 信頼済みの PERFORCE サーバ と それぞれの フ ィ ン ガープ リ ン ト の リ ス ト が記録 さ れ ま す。 P4TRUST が未設定であ る場合、こ のフ ァ イ ルはユーザのホーム ・デ ィ レ ク ト リ 内の .p4trust です。 詳 し く は、 31 ページの 「SSL 暗号化接続」 を参照 し て く だ さ い。 View: //depot/dev/... //bruno_ws/depot/dev/... //testing/... //bruno_ws/testing/... //archive/... //bruno_ws/archive/...
User name: bruno Client name: bruno_ws Client host: workstation_12 Client root: c:\bruno_ws Current directory: c:\bruno_ws Client address: 10.0.0.196
Server address: ssl:example.com:1818 Server root: /usr/depot/p4d
Server date: 2012/03/28 15:03:05 -0700 PDT Server uptime: 752:41:33
Server version: P4D/FREEBSD/2012.1/406375 (2012/01/25) Server encryption: encrypted
Server license: P4Admin <p4adm> 20 users (expires 2013/01/01) Server license-ip: 10.0.0.2
Case handling: sensitive
PERFORCE client error:
Connect to server failed; check $P4PORT. TCP connect to perforce:1666 failed. perforce: host unknown.
ご使用中の LAN ま たは WAN の構成に よ っ て、 シ ス テ ム管理者が別のポー ト 設定を推奨す る 場合があ り ます。 ま た、 コ マ ン ド ラ イ ン ま たは P4CONFIG フ ァ イ ルを使用 し て、 構成可能変 数 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 の ど ち ら を使用 す る か を自動的に決定 し ます。 さ ら に詳 し い情報は、『シ ス テ ム管理者ガ イ ド 』 に記載 さ れてい ます。
ワー ク スペース ・ ビ ュ ーの限定
デフ ォ ル ト では、 ク ラ イ ア ン ト ・ ワー ク スペース を作成す る と 、 デ ィ ポ全体がマ ッ ピ ン グ さ れ ます。 こ のマ ッ ピ ン グ をデ ィ ポの一部のみを参照す る よ う に限定 し 、 デ ィ ポ と ワー ク スペース の場所 と の対応関係を変更す る こ と がで き ます。 ワ ー ク ス ペー ス ・ ビ ュ ー を 表示 ま た は変更す る には、 p4 client コ マ ン ド を 発行 し ま す。 PERFORCE に よ り ク ラ イ ア ン ト 仕様フ ォ ームの [View:] フ ィ ール ド にマ ッ ピ ン グの リ ス ト が表 示 さ れ ます。 以降のセ ク シ ョ ン において、 ク ラ イ ア ン ト ・ ワ ー ク スペース ・ ビ ュ ーの指定に関 し て詳 し く 説 明 し ます。 よ り 詳 し い情報は、『PERFORCE コ マ ン ド ・ リ フ ァ レ ン ス』 の p4 client コ マン ド の説明お よ びビ ュ ーの説明を参照 し て く だ さ い。マ ッ ピ ングの指定
ビ ュ ーは複数のマ ッ ピ ン グで構成 さ れ、 各マ ッ ピ ン グは 2 つの部分か ら 成 り ます。 • 左側には、 デ ィ ポ内の 1 つ以上のフ ァ イ ルが次の形式で指定 さ れます。 //depotname/file_specification • 右側には、 ク ラ イ ア ン ト ・ ワー ク スペース内の 1 つ以上のフ ァ イ ルが次の形式で指定 さ れま す。 //clientname/file_specification ク ラ イ ア ン ト ・ ワー ク スペース ・ ビ ュ ー ・ マ ッ ピ ン グの左側をデ ィ ポ ・ サ イ ド、 右側をク ラ イ ア ン ト ・ サ イ ドと 呼びます。 ワ ー ク スペース ・ フ ァ イ ルの ワ ー ク ス テーシ ョ ン上での場所を決定す る には、 ク ラ イ ア ン ト ・ ワ ー ク スペース ・ ルー ト を マ ッ ピ ン グの ク ラ イ ア ン ト ・ サ イ ド の ワー ク スペース名に置 き 換え て く だ さ い。 例 え ば、 ク ラ イ ア ン ト ・ ル ー ト が C:\bruno_ws で あ る 場 合、 //depot/dev/main/jam/Jamfile フ ァ イ ル C:\bruno_ws\dev\main\jam\Jamfile と し て格納 さ れ ます。 Client: bruno_ws Owner: bruno Description: Created by bruno. Root: C:\bruno_wsOptions: noallwrite noclobber nocompress unlocked nomodtime normdir SubmitOptions: submitunchanged
View:
後に記述 さ れ る マ ッ ピ ン グが、 それ よ り 前のマ ッ ピ ン グ よ り 優先 さ れ ます。 以下の例では、 2 行目が 1 行目 よ り 優先 さ れ、 //depot/dev/main/docs/manuals/ 内のフ ァ イ ルが 2 階層 上にマ ッ ピ ン グ さ れ ま す。 //depot/dev/main/docs/manuals/ 内の フ ァ イ ルが同期 さ れ る と 、 それ ら の フ ァ イ ルは c:\bruno_ws\docs\ に格納 さ れます。
ワー ク スペース ・ ビ ュ ーでのワ イル ド カ ー ド の使用
フ ァ イ ルの集合を ワ ー ク ス ペー ス ・ ビ ュ ーにマ ッ ピ ン グす る には、 PERFORCE ワ イ ル ド カー ド を使用 し ます。 マ ッ ピ ン グのデ ィ ポ ・ サ イ ド で使用 さ れ る ワ イ ル ド カー ド が、 ク ラ イ ア ン ト ・ サ イ ド の ワ イ ル ド カー ド と 一致す る 必要があ り ます。 ク ラ イ ア ン ト ・ ワ ー ク スペース でのマ ッ ピ ン グの指定には、 以下の ワ イ ル ド カー ド を使用で き ます。 単純な ク ラ イ ア ン ト ・ ビ ュ ー //depot/dev/... //bruno_ws/dev/... では、 デ ィ ポの dev ブ ラ ンチ内のすべての フ ァ イ ルが ク ラ イ ア ン ト ・ ワ ー ク スペース の対応す る 場所に マ ッ ピ ン グ さ れ ま す。 例えば、 フ ァ イ ル //depot/dev/main/jam/Makefile は ワ ー ク ス ペー ス ・ フ ァ イ ル C:\bruno_ws\dev\main\jam\Makefile にマ ッ ピ ン グ さ れ ま す。 ワ ー ク スペース ・ ビ ュ ー内のマ ッ ピ ン グは常に、 デ ィ ポ内の フ ァ イ ルお よ びデ ィ レ ク ト リ の場 所を示 し ます。 ワ ー ク スペース ・ ビ ュ ーにあ る フ ァ イ ルの特定 リ ビ ジ ョ ン を参照す る こ と はで き ません。デ ィ ポの一部を マ ッ ピ ングする
デ ィ ポ ・ フ ァ イ ルの一部分だけが必要で あ る 場合、 その部分を マ ッ ピ ン グ し ま す。 ワ ー ク ス ペース ・ ビ ュ ーの範囲を縮小す る こ と に よ り 、 コ マ ン ド が不用意に全体のデ ィ ポに影響す る こ と も 避け ら れ ます。 ワ ー ク スペース ・ ビ ュ ーを制限す る には、 [View:] フ ィ ール ド の左側を変 更 し 、 デ ィ ポの関連部分を指定 し ます。 例 : デ ィ ポの一部を ク ラ イ ア ン ト ・ ワー ク スペース にマ ッ ピ ン グす る View: //depot/dev/... //bruno_ws/dev/... //depot/dev/main/docs/... //bruno_ws/docs/... ワ イル ド カ ー ド 説明 * ス ラ ッ シ ュ を除 く すべての文字に一致 し ます。 単一のデ ィ レ ク ト リ 内のみ照合 し ま す。 お使いのプ ラ ッ ト フ ォームに よ っ ては大文字 と 小文字を区別 し ます。 ... ス ラ ッ シ ュ を含むすべての文字に一致 し ます。 再帰的に (指定 さ れたデ ィ レ ク ト リ お よ びその配下のデ ィ レ ク ト リ 内すべて を) 照合 し ます。 %%1 - %%9 フ ァ イ ル名のサブ文字列再配置に使用する位置指定子 注 フ ァ イ ルの不必要なマ ッ ピ ン グ を避け る ため、 「...」 ワ イ ル ド カー ド の前に必ず ス ラ ッ シ ュ を入れて く だ さ い。フ ァ イルを ワー ク スペースの別の場所にマ ッ ピ ングする
ビ ュ ーは複数のマ ッ ピ ン グに よ り 構成す る こ と がで き ます。 それを使用 し て、 デ ィ ポ ・ フ ァ イ ル ・ ツ リ ーの一部を ワ ー ク スペース ・ フ ァ イ ル ・ ツ リ ーの別の部分にマ ッ ピ ン グで き ます。マ ッ ピ ン グが衝突す る 場合、 後のマ ッ ピ ン グがそれ以前のマ ッ ピ ン グに優先 し ます。
例 : 単一の ワー ク スペース ・ ビ ュ ーにおけ る複数のマ ッ ピ ン グ
以下の ビ ュ ーに よ り 、 manuals フ ォ ルダ に あ る Microsoft Word の フ ァ イ ルが、 ワ ー ク ス ペース内で最上位にあ る wordfiles と い う フ ォ ルダに格納 さ れます。
フ ァ イルを別のフ ァ イル名にマ ッ ピ ングする
マ ッ ピ ン グに よ り 、 ク ラ イ ア ン ト ・ ワー ク スペース内の フ ァ イ ルをデ ィ ポ内の フ ァ イ ル と 異な る 名前にす る こ と も で き ます。 例 : フ ァ イ ルをデ ィ ポ内 と ク ラ イ ア ン ト ・ ワー ク スペース内で異な る名前にす る 以下の ビ ュ ーに よ り 、 デ ィ ポ ・ フ ァ イ ルの RELNOTES が ワ ー ク ス ペー ス ・ フ ァ イ ルの rnotes.txt にマ ッ ピ ン グ さ れます。フ ァ イル名の一部を再配置する
位置指定子の %%0 か ら %%9 を使用し て、 フ ァ イ ル名 と デ ィ レ ク ト リ の一部を置き換え る こ と がで き ます。 例 : 位置指定子を使用 し て フ ァ イ ル名 と デ ィ レ ク ト リ を置 き 換え る 以下の ビ ュ ーに よ り 、 デ ィ ポ ・ フ ァ イ ルの //depot/allfiles/readme.txt が ワ ー ク ス ペース ・ フ ァ イ ルの filesbytype/txt/readme にマ ッ ピ ン グ さ れます。フ ァ イルおよびデ ィ レ ク ト リ を除外する
除外マ ッ ピ ン グに よ り 、 フ ァ イ ルお よ びデ ィ レ ク ト リ を ク ラ イ ア ン ト ・ ワー ク スペース か ら 明 示的に除外す る こ と がで き ます。 フ ァ イ ルお よ びデ ィ レ ク ト リ を除外す る には、 マ ッ ピ ン グの 先頭にマ イ ナ ス 記号 (-) を付け ます。 マ イ ナ ス 記号 と マ ッ ピ ン グの間に ス ペー ス を入れない よ う に注意 し て く だ さ い。 例 : ビ ューを使用 し て フ ァ イ ルを ク ラ イ ア ン ト ・ ワー ク スペース か ら 除外す る Jam プ ロ ジ ェ ク ト に従事 し てい る アールは、自分の ワー ク スペース に HTML フ ァ イ ルを同 期 し た く あ り ません。 彼の ク ラ イ ア ン ト ・ ビ ュ ーは次の よ う にな り ます。 View: //depot/... //bruno_ws/... //depot/dev/main/docs/manuals/*.doc //bruno_ws/wordfiles/*.doc View: //depot/... //bruno_ws/... //depot/dev/main/jam/RELNOTES //bruno_ws/dev/main/jam/rnotes.txt View: //depot/allfiles/%%1.%%2 //bruno_ws/filesbytype/%%2/%%1 View: //depot/dev/main/jam/... //earl-dev-beech/jam/... -//depot/dev/main/jam/....html //earl-dev-beech/jam/....htmlマ ッ ピ ングの衝突を回避する
単一のビ ュ ーにおいて複数のマ ッ ピ ン グ を使用す る と き 、単一の フ ァ イ ルが不用意にデ ィ ポ ま たは ワー ク スペース の異な る 2 つの場所にマ ッ ピ ン グ さ れ る 場合があ り ます。 こ の よ う に し て 2 つのマ ッ ピ ン グが衝突す る 場合、 後のマ ッ ピ ン グがそれ以前のマ ッ ピ ン グ を無効に し ます。 例 : 衝突す る 誤っ たマ ッ ピ ン グ ジ ョ ーは次の よ う にビ ューを構成 し ま し た。 2 番目のマ ッ ピ ン グ //depot/proj2/... が //joe/project/... にマ ッ ピ ン グ さ れ、最 初の マ ッ ピ ン グ と 衝突 し ま す。 こ の 衝突に よ り 、 最初の マ ッ ピ ン グ は無視 さ れ ま す。 //depot/proj1 に含まれてい る フ ァ イ ルは ワー ク スペース に ま っ た く マ ッ ピ ン グ さ れま せん。 そのため //depot/proj2/file.c が存在し な く て も 、//depot/proj1/file.c はマ ッ ピ ン グ さ れません。異な るデ ィ ポの場所を 1 つのワー ク スペースにマ ッ ピ ングする
オーバ レ イ ・ マ ッ ピ ン グに よ り 、 2 つ以上のデ ィ ポ ・ デ ィ レ ク ト リ の フ ァ イ ルを ワ ー ク スペー ス の同 じ 場所にマ ッ ピ ン グ で き ま す。 2 番目のデ ィ レ ク ト リ の内容を ワ ー ク ス ペー ス にオー バーレ イ す る には、 マ ッ ピ ン グの先頭にプ ラ ス記号 (+) を付け ます。 例 : 複数のデ ィ レ ク ト リ を同 じ ワー ク スペース にオーバーレ イ す る ジ ョ ーは、 ワー ク スペース を同期す る と き にプ ロ ジ ェ ク ト の フ ァ イ ルを結合 し たいので、 次の よ う にビ ュ ーを構成 し ま し た。 オーバレ イ ・ マ ッ ピ ン グであ る +//depot/proj2/... は //joe/project にマ ッ ピ ン グ し 、 最初のマ ッ ピ ン グ を オーバレ イ し ます。 オーバレ イ ・ マ ッ ピ ン グは衝突 し ませ ん。 //depot/proj2 内の フ ァ イ ル (削除 さ れた フ ァ イ ル も 含む) が //depot/proj1 よ り も 優先 さ れます。 //depot/proj2/file.c が存在 し ない場合 (「存在す る 」 フ ァ イ ルに相対す る が、 「削除 さ れた フ ァ イ ル」 ではない)、 代わ り に //depot/proj1/file.c が ワー ク スペース にマ ッ ピ ン グ さ れます。 オーバーレ イ ・ マ ッ ピ ン グは、 ビル ド 環境において ス パース ・ パ ッ チを適用す る 際に役立ち ま す。フ ァ イル名およびデ ィ レ ク ト リ 名における スペースの取 り 扱い
スペース を含むフ ァ イ ル ま たはデ ィ レ ク ト リ は、 引用符を使用 し て囲みます。 例 : フ ァ イ ル名 と デ ィ レ ク ト リ 名の スペース に対応す る View: //depot/proj1/... //joe/project/... //depot/proj2/... //joe/project/... View: //depot/proj1/... //joe/project/... +//depot/proj2/... //joe/project/...マ ッ ピ ン グのサーバ側、 ク ラ イ ア ン ト 側、 ま たは両側で、 パ ス の構成要素の前後に引用符 を挿入す る こ と に よ り 、ジ ョ ーは スペース を含むフ ァ イ ル名やデ ィ レ ク ト リ 構成要素を指 定す る こ と がで き ます。
詳 し く は、40 ページの 「フ ァ イ ル名、パ ス名、識別子での スペース の使用」 を参照 し て く だ さ い。
Windows のワー ク スペース を複数の ド ラ イ ブにマ ッ ピ ングする
複数の Windows ド ラ イ ブにわた っ て PERFORCEワ ー ク スペース を指定す る には、 [Root:] を null
に設定 し 、 ワ ー ク スペース ・ ビ ュ ーで ド ラ イ ブ文字を (小文字で) 指定 し ます。 以下に例を示 し ます。
同一のワー ク スペース を異な る マシ ン で使用する
デフ ォ ル ト では、 [Host:] フ ィ ール ド で指定 さ れたマシ ン上の ワー ク スペース のみが使用で き ます。 同一の ワ ー ク ス ペー ス を異な る プ ラ ッ ト フ ォ ーム の複数のマ シ ン上で使用 し たい場合、 ク ラ イ ア ン ト ・ ワー ク スペース仕様の [Host:] 項目を削除し 、 [AltRoots:] フ ィ ール ド を設 定 し て く だ さ い。 ワー ク スペース ・ ルー ト は 2 つま で指定で き ます。 指定す る 場所は、 例えば NFS ま たは Samba マ ウ ン ト を介 し て、 使用す る すべてのマ シ ン か ら 参照可能で あ る 必要があ り ます。 PERFORCE は現在の作業デ ィ レ ク ト リ を最初に メ イ ン の [Root:] と 比較し、 次に (指定 さ れて いれば) 2 つの [AltRoots:] と 比較し ます。現在の作業デ ィ レ ク ト リ と 一致する ルー ト ・ デ ィ レ ク ト リ が使用 さ れ ます。 ルー ト が一致 し ない場合、 メ イ ン ・ ルー ト が使用 さ れ ます。 以下の例において、 ユーザ bruno の現在の作業デ ィ レ ク ト リ が /usr/bruno の下であ る 場 合、 PERFORCE は c:\bruno_ws ではな く UNIX のパス を ワー ク スペース ・ ルー ト と し て使用し ます。 こ の手法に よ り 、 bruno は UNIX と Windows の両開発環境において同一の ク ラ イ ア ン ト ・ ワー ク スペース仕様を使用す る こ と がで き ます。 ど ち ら の ワー ク スペース ・ ルー ト が適用 さ れてい る か確認す る には、 p4 info コ マン ド を発 行 し て [Client root:] フ ィ ール ド をチ ェ ッ ク し ます。 同一の ワ ー ク ス ペー ス に あ る テ キ ス ト ・ フ ァ イ ル を異な る プ ラ ッ ト フ ォ ーム か ら 編集す る 場 合、 使用す る エデ ィ タ お よ び設定で行末が保持 さ れ る こ と を確認 し て く だ さ い。 異な る プ ラ ッ Client: bruno_ws Update: 2011/11/29 09:46:53 Access: 2011/03/02 10:28:40 Owner: bruno Root: null
Options: noallwrite noclobber nocompress unlocked nomodtime normdir SubmitOptions: submitunchanged
LineEnd: local View:
//depot/dev/... "//bruno_ws/c:/Current Release/..." //depot/release/... "//bruno_ws/d:/Prior Releases/..." //depot/www/... //bruno_ws/d:/website/... 注 ワ ー ク ス ペー ス ・ ルー ト に Windows の デ ィ レ ク ト リ を 使用 し て い る 場合、 そ の Windows のデ ィ レ ク ト リ を メ イ ン の ク ラ イ ア ン ト [Root:] に指定 し、 他の ワー ク ス ペース ・ ルー ト ・ デ ィ レ ク ト リ を [AltRoots:] フ ィ ール ド に指定し て く だ さ い。 Client: bruno_ws Owner: bruno Description: Created by bruno. Root: c:\bruno_ws AltRoots: /usr/bruno/
ト フ ォ ーム間での行末 コ ー ド 設定について詳 し く は、『PERFORCE シ ス テ ム管理者ガ イ ド 』 を ご 覧 く だ さ い。