Perforceクライアントワークスペースとは、Perforceによって管理されるファイルリビジョンの操作を行うワークステーション上にあるディレクトリのセットです。各ワークスペースには、Perforceサービスに対してクライアントワークスペースを識別するための固有の名前が付いています。P4CLIENT環境変数の設定によりワークスペース名を指定しない場合、デフォルトのワークスペース名はワークステーションの名前になります。効果的なワークスペース名を指定するために、P4CLIENT環境変数を設定してください。1つのマシンに複数のワークスペースを含めることができます。

Perforceクライアントワークスペース内のすべてのファイルは、クライアントワークスペースルートと呼ばれるルートディレクトリを共有します。ワークスペースルートはワークスペースの最上位ディレクトリで、その配下に管理対象のソースファイルが格納されます。

同一マシン上に複数のワークスペースを構成する場合、不用意にファイルが上書きされることのないよう、ワークスペースの場所を離してください。クライアントルートが別々のフォルダに配置されるようにし、ワークスペースビューをディポファイルにマッピングするとき、ワークステーション上の位置が重ならないようにしてください。

ワークスペースを構成したら、ファイルをディポと同期して変更をサブミットできます。これらの操作について詳しくは、“ファイルとチェンジリストの管理”を参照してください。

Perforceはクライアントワークスペース内のファイルを以下のように管理します。

ユーザのワークスペースの状態はPerforceにより追跡され、管理されます。Perforceアプリケーションにより実行されるファイル管理との衝突を避けるため、ファイルの読み取り専用の許可設定を手動で変更しないでください。Perforceには、クライアントワークスペースの状態が、Perforceに記録されている状態と一致しているか否かを判断できるコマンドがあります。詳細については、オフラインで作業するを参照してください。

Perforceにより制御されるよう指定していないワークスペース内のファイルは、Perforceには無視されます。例えば、コンパイル済みオブジェクト、ライブラリ、実行可能ファイル、およびソフトウェア開発中に作成されたもののディポに追加されていない開発者用一時ファイルなどは、Perforceコマンドの影響を受けません。

クライアントワークスペースを定義したら、ワークスペースの定義を微調整することができます。おそらく最も重要なことは、ディポ内のユーザが見ることができる部分を制限して、不用意にディポ全体を同期させないようにすることです。詳細については、ワークスペースビューを限定するを参照してください。

これらの設定をコマンドラインで指定するには、-pオプションを使用してください。例:

p4 -p tcp:localhost:1776 sync //depot/dev/main/jam/Jambase

コマンドラインで指定した設定により、構成ファイル、環境変数、Windowsレジストリ、またはOS Xのシステム設定で指定された設定はすべて上書きされます。コマンドラインのオプションについての詳細は、『P4コマンドリファレンス』のグローバルオプションの説明を参照してください。

構成ファイルは、そのファイルのあるディレクトリおよびその配下のディレクトリにあるファイルに影響するPerforceの設定が記述されているテキストファイルです。構成ファイルは、同一マシン上に複数のクライアントワークスペースがある場合に役立ちます。構成ファイルで設定を指定すれば、異なるワークスペースで作業するたびにシステム設定を変更するという面倒な作業は必要ありません。

構成ファイルを使用するには、ファイル名(.p4configなど)を指定して、P4CONFIG環境変数を定義します。コマンドの発行時、Perforceは現在の作業ディレクトリおよびその親ディレクトリで指定されたファイルを探し、(設定がコマンドラインオプションにより上書きされない限り)そのファイルに含まれる設定を使用します。

ファイル内では、各設定につき1行ずつ以下の形式で指定する必要があります。

setting=value

構成ファイルを指定できる設定項目を以下に示します。

これらの設定についての詳細は、『P4コマンドリファレンス』を参照してください。

環境変数を使用して接続設定を構成するには、P4PORTを以下の例のようにprotocol:host:portの形式で設定してください。

P4PORTの設定にプロトコルを指定していない場合、tcp: (TCP/IP経由のプレーンテキストでの通信)が想定されます。PerforceサービスがSSLをサポートするように構成されている場合、使用するプロトコルとしてssl:を設定することによりPerforceへの接続を暗号化することができます。

その他のプロトコル(例えば、tcp4:はプレーンテキストのIPv4接続を必要とし、ssl64:は暗号化接続を必要としますが、IPv4よりもIPv6による転送の使用が推奨されます)も、混合ネットワーク環境で使用できます。

詳しくは、IPv6ネットワークで接続するおよび『Perforceサーバ管理者ガイド: 基本』を参照してください。

WindowsおよびOS Xのマシンでは、p4 setコマンドを使用して、接続設定をレジストリ(またはシステム設定)に保存することができます。例:

p4 set P4PORT=ssl:tea.example.com:1667

Perforceの設定をレジストリに構成する方法には以下の2つがあります。

どちらの設定が適用されているかを確認するには、p4 setコマンドを引数なしで使用します。p4 setコマンドについての詳細は、『P4コマンドリファレンス』を参照してください。

リリース2013.1以降、Perforceは、IPv4ネットワークと同様にIPv6ネットワークでの接続もサポートしています。

ご使用中の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のどちらを使用するかを自動的に決定します。

詳細については、『Perforceサーバ管理者ガイド: 基本』を参照してください。

ビューは複数のマッピングで構成され、各マッピングは2つの部分から成ります。

クライアントワークスペースビューマッピングの左側をディポサイド、右側をクライアントサイドと呼びます。

ワークスペースファイルのワークステーション上での場所を決定するには、クライアントワークスペースルートをマッピングのクライアントサイドのワークスペース名に置き換えてください。例えば、ワークスペースルートがC:\bruno_wsである場合、//depot/dev/main/jam/JamfileファイルはC:\bruno_ws\dev\main\jam\Jamfileとして格納されます。

後のマッピングがそれ以前のマッピングに優先されます。以下の例では、2行目が1行目より優先され、//depot/dev/main/docs/manuals/内のファイルが2階層上にマッピングされます。//depot/dev/main/docs/manuals/内のファイルが同期されると、それらのファイルはc:\bruno_ws\docs\に格納されます。

View:
    //depot/dev/...            //bruno_ws/dev/...
    //depot/dev/main/docs/...  //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/main/jam/...  //dai-beos-locust/jam/...
    //depot/www/live/...      //dai-beos-locust/www/live/...

ビューは複数のマッピングにより構成することができます。それを使用して、ディポファイルツリーの一部をワークスペースファイルツリーの別の部分にマッピングできます。マッピングが衝突する場合、後のマッピングがそれ以前のマッピングに優先します。

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

位置指定子の%%0から%%9を使用して、ファイル名とディレクトリの一部を再配置することができます。

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

クライアントワークスペース仕様の[ChangeView]フィールドにディポのパス名とチェンジリスト番号を入力して、ディポのパスへのアクセスを特定の時点に制限できます。[ChangeView]フィールドで指定されるファイルは読み取り専用です。すなわち、開くことはできますがサブミットはできません。例:

ChangeView:
      //depot/path/...@1000

この例では、//depot/path/...にあるファイルのリビジョンは、チェンジリスト1000の後にサブミットされた場合、表示されません。チェンジリスト1000までにサブミットされたファイルが表示されますが、読み取り専用です。複数のパスを指定できます。

単一のビューにおいて複数のマッピングを使用するとき、単一のファイルが不用意にディポまたはワークスペースの異なる2つの場所にマッピングされる場合があります。このようにして2つのマッピングが衝突する場合、後のマッピングがそれ以前のマッピングをオーバーライドします。

View:
    //depot/proj1/...    //joe/project/...
    //depot/proj2/...    //joe/project/...

オーバーレイマッピングにより、2つ以上のディポディレクトリのファイルをワークスペースの同じ場所にマッピングできます。2番目のディレクトリの内容をワークスペースにオーバーレイするには、マッピングの先頭にプラス記号(+)を付けます。

View:
    //depot/proj1/...    //joe/project/...
    +//depot/proj2/...   //joe/project/...

オーバーレイマッピングは、ビルド環境においてスパースパッチを適用する際に役立ちます。

スペースを含むファイルまたはディレクトリは、引用符を使用して囲みます。

View:
    "//depot/Release 2.0/..."   //joe/current/...
    "//depot/Release 1.1/..."   "//joe/Patch Release/..."
    //depot/webstats/2011/...   "//joe/2011 Web Stats/..."

詳細については、ファイル名、パス名、識別子でのスペースの使用を参照してください。

複数のWindowsドライブにわたってワークスペースを指定するには、Root:をnullに設定し、ワークスペースビューでドライブ文字を(小文字で)指定します。例:

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/...

デフォルトでは、Host:フィールドで指定されたマシン上のワークスペースのみが使用できます。同一のワークスペースを異なるプラットフォームの複数のマシン上で使用したい場合、クライアントワークスペース仕様のHost:項目を削除し、AltRoots:フィールドを設定してください。ワークスペースルートは2つまで指定できます。指定する場所は、例えばNFSまたはSambaマウントを介して、使用するすべてのマシンから参照可能である必要があります。

Perforceは現在の作業ディレクトリを最初にメインのRoot:と比較し、指定されている場合は次に2つのAltRoots:と比較します。現在の作業ディレクトリと一致する最初のルートが使用されます。ルートが一致しない場合、メインルートが使用されます。

以下の例において、ユーザbrunoの現在の作業ディレクトリが/usr/brunoの下である場合、Perforceはc:\bruno_wsではなくUNIXのパスをワークスペースルートとして使用します。この手法により、brunoはUNIXとWindowsの両開発環境において同一のクライアントワークスペース仕様を使用することができます。

Client: bruno_ws
Owner:  bruno
Description:
        Created by bruno.
Root:   c:\bruno_ws
AltRoots:
        /usr/bruno/

どちらのワークスペースルートが適用されているか確認するには、p4 infoコマンドを発行してClient root:フィールドをチェックします。

同一のワークスペースにあるテキストファイルを異なるプラットフォームから編集する場合、使用するエディタおよび設定で行末が保持されることを確認してください。異なるプラットフォーム間での行末コード設定に関して詳しくは、『行末コードを設定する』を参照してください。

デフォルトでは、Perforceは空のディレクトリをワークスペースから削除しません。この動作を変更するには、p4 clientコマンドを実行し、Options:フィールドにおいて、オプションnormdirをrmdirに変更します。

ワークスペースオプションの変更に関して詳しくは、ワークスペースオプションを構成するを参照してください。

お使いのインストールでSSL接続が必要とされる場合、P4PORTを確実にssl:hostname:portの形式にしてください。SSL接続が有効にされたPerforceサーバでプレーンテキストによる通信を行おうとすると、次のエラーメッセージが表示されます。

Failed client connect, server using SSL.
Client must add SSL protocol prefix to P4PORT.

P4PORTをssl:hostname:portに設定して、サーバに再接続を試みてください。

SSLが有効にされているサーバに最初に暗号化接続を確立したときに、サーバのフィンガープリントを検証するように要求されます。

The authenticity of '10.0.0.2:1818' can't be established,
this may be your first attempt to connect to this P4PORT.
The fingerprint for the key sent to your client is
CA:BE:5B:77:14:1B:2E:97:F0:5F:31:6E:33:6F:0E:1A:E9:DA:EF:E2

サイトの管理者は、表示されたフィンガープリントが正しいか否かを確認することができます。フィンガープリントが正しい場合(に限り)、p4 trustコマンドを使用してそのフィンガープリントを自分のP4TRUSTファイルに追加します。P4TRUSTが未設定である場合、このファイルはユーザのホームディレクトリ内の.p4trustであると想定されます。

$ p4 trust
The fingerprint of the server of your P4PORT setting
'ssl:example.com:1818' (10.0.0.2:1818) is not known.
That fingerprint is
CA:BE:5B:77:14:1B:2E:97:F0:5F:31:6E:33:6F:0E:1A:E9:DA:EF:E2
Are you sure you want to establish trust (yes/no)?
Added trust for P4PORT 'ssl:example.com:1818' (10.0.0.2:1818)

フィンガープリントが正しければ、yesと入力してこのサーバを信頼します。フィンガープリントを直接コマンドラインからtrustファイルにインストールすることも可能です。次のコマンドを実行します。

p4 trust -p ssl:hostname:port -i fingerprint

ただし、ssl:hostname:portはお使いのP4PORTの設定に該当し、fingerprintはサイトの管理者が確認したフィンガープリントに該当します。

これ以降は、example.com:1818のサーバがP4TRUSTファイル内に記録されたものと同じフィンガープリントを報告し続ける限り、ssl:example.com:1818へのSSL接続が信頼されます。

Perforceサーバが信頼済みのものとは異なるフィンガープリントを報告すると、次のエラーメッセージが表示されます。

******* WARNING P4PORT IDENTIFICATION HAS CHANGED! *******
It is possible that someone is intercepting your connection
to the Perforce P4PORT '10.0.50.39:1667'
If this is not a scheduled key change, then you should contact
your Perforce administrator.
The fingerprint for the mismatched key sent to your client is
18:FC:4F:C3:2E:FA:7A:AE:BC:74:58:2F:FC:F5:87:7C:BE:C0:2D:B5
To allow connection use the 'p4 trust' command.

このエラーメッセージは、そのサーバのフィンガープリントがP4TRUSTファイルに保存されたものから変更されていることと、サーバのSSL証明書が変更されていることを示します。

フィンガープリントへの変更が正当なものである場合でも(例えば、サーバのSSL証明書の有効期間を管理者が制御している場合に証明書が期限切れになっている可能性があるとき)、セキュリティリスクの存在を示すことがあります。

Perforce client error:
    SSL connect to ssl:host:port failed (Connection reset by peer).
    Remove SSL protocol prefix from P4PORT.

Perforceインストールが適用しているセキュリティレベルによって、Perforceコマンドを実行する前にPerforceにログインする必要がある場合があります。パスワードを使用しないと、どのユーザもP4USERの値を別のユーザ名に設定したり、-uオプションを付けてp4コマンドを発行したりすることにより、他のPerforceユーザとして操作することが可能になってしまいます。セキュリティを向上させるには、パスワードを使用してください。

Perforce管理者は、ユーザに対して時間制限を設定するようにPerforceサービスを構成することができます。Perforceではチケットベースの認証を使用して時間制限を設定します。チケットベースの認証は環境変数やコマンドラインオプションに依存しないため、パスワードベースの認証より安全です。

チケットはユーザのホームディレクトリ内のファイルに保存されます。チケットはログイン後、制限時間(デフォルトでは12時間)が経過するまで有効です。

あるワークステーションのすべてのユーザにP4CHARSETを設定するには、Windowsの管理者権限が必要です。次のコマンドを実行してください。

p4 set -s P4CHARSET=character_set

現在ログインしているユーザにP4CHARSETを設定するには、次のコマンドを実行します。

p4 set P4CHARSET=character_set

お使いのワークステーションに、TrueTypeまたはOpenTypeのフォントがインストールされている必要があります。

コマンドシェルまたは.kshrc、.cshrc、.profileなどの起動スクリプトにP4CHARSETを設定することができます。P4CHARSETの適切な値を決定するには、LANGまたはLOCALEの環境変数の設定を調べます。一般的な設定を以下に示します。

通常は、日本語のインストールではP4CHARSETをeucjpに設定し、ヨーロッパ言語のインストールではP4CHARSETをiso8859-1に設定します。