p4 client
構文
p4 [g-opts
] client [-f] [-t template
] [clientname
]
p4 [g-opts
] client -o [-t template
] [clientname
]
p4 [g-opts
] client -d [-f [-Fs]]clientname
p4 [g-opts
] client -s [-S stream
| -t clientname
] clientname
p4 [g-opts
] client -S stream
[[-c change
] -o] [clientname
]
p4 [g-opts
] client -i [-f]
解説
Perforceクライアントワークスペースは、ユーザのマシン上にあるファイルの集合で、ディポ内にあるファイルの集合の一部に対応しています。より正確には、ディポファイルとワークスペースファイルの名前付きのマッピングです。p4 clientコマンドは、クライアントワークスペース仕様の生成または編集に使用します。このコマンドを実行すると、Perforceがワークスペース管理のために必要とする情報の入力フォームが表示されます。
p4 clientコマンドは、クライアント仕様を一時ファイルに置き、環境変数P4EDITOR
により構成されたエディタを起動します。新規のワークスペースでは、クライアント名はデフォルトでは環境変数P4CLIENT
(設定されている場合)、またはクライアントのホスト名になります。ファイルを保存すると、クライアント仕様が作成または変更されます。
クライアントワークスペースのファイルとディポのファイルは、常に1対1のマッピングで関連づけられていますが、これらのファイルは、同じ相対的位置に保存されている必要もなければ、同じ名前を持っている必要もありません。p4 clientフォームの[View:
]フィールドで指定されるクライアントビューが、ワークスペースのファイルからディポへのマッピング経路、およびその逆のマッピング経路を指定します。
p4 clientが完了すると、新しく生成された、または変更されたワークスペース仕様がPerforceデータベースに保存されます。この時点では、ワークスペースのファイルは影響を受けません。新しいビューは、次にp4 syncが実行されて初めて有効になります。
変更をストリームにサブミットするには、p4 client -S stream
clientname
コマンドを実行してストリームをワークスペースに関連づける必要があります。ワークスペースに関連付けられたストリームを変更するには、p4 client -s -S stream
clientname
コマンドを実行します。
フォームフィールド
フィールド名 |
タイプ |
解説 |
---|---|---|
|
読み取り専用 |
環境変数
引数 |
|
書き込み可能、入力必須 |
クライアントワークスペースを所有するユーザのユーザ名。デフォルトは、そのワークスペースを生成したユーザです。 指定する所有者は、Perforceユーザである必要はありません。ユーザがまだ存在していない場合や、ユーザを削除してから仕様を新しいユーザに割り当てるまでのプレースホルダーが必要な場合は、任意の名前を使用する可能性があります。 |
|
読み取り専用 |
ワークスペース仕様が最後に更新された日付。 |
|
読み取り専用 |
ワークスペースが何らかの形で最後に使用された日付と時刻。(注: p4 reloadによるワークスペースのリロードは、アクセス時刻には反映されません。) |
|
書き込み可能、任意入力 |
ワークスペースが常駐するワークステーションの名前。指定されていれば、このクライアントワークスペースは上記ホストからのみ操作できます。未設定の場合、どのホストからでもアクセス可能になります。 ホスト名は、そのホストからp4 infoを実行したときの出力と正確に一致していなければなりません。
このフィールドは、クライアントワークスペースが誤って別のホスト上で使用されるのを防ぐためにあります。ホスト名を設定しても、セキュリティは保証されません。その理由は、ホスト名の実効値はp4コマンドの |
|
書き込み可能、任意入力 |
ワークスペースに関するコメント。デフォルトは |
|
書き込み可能、入力必須 |
[
この設定を変更すると、現在そこにあるファイルをすべて物理的に移動しなくてはなりません。Windowsのクライアントマシンでは、ルートを |
|
書き込み可能、任意入力 |
2つまで任意で指定するクライアントワークスペースのルートの別名です。 Perforceのアプリケーションでは、最初にメインのクライアントルート、次に別名のクライアントルートを検査することによって、現在のワーキングディレクトリと合致させます。p4 infoコマンドを使用して、表示するルートを表示します。 これによりユーザは、異なるディレクトリ名の変換をすることができ、複数プラットフォーム上で同じPerforceクライアントワークスペース仕様を使用することができます。
複数または別名のワークスペースルートを使用している場合(
ワークスペースルートのいずれかでWindowsディレクトリを使用している場合には、そのWindowsディレクトリをメインのワークスペースルートとして指定し、他のワークスペースルートを
例えば、複数のプラットフォーム上で製品をビルドしているエンジニアは、Windows上でのビルド用としてメインのクライアントルートを |
|
書き込み可能、入力必須 |
ワークスペースオプションを制御する7つのスイッチを指定します。オプションの内容については、オプションのリストの使用上の留意点を参照してください。 |
|
書き込み可能、入力必須 |
p4 submitのデフォルトの動作を制御するオプション。
|
|
書き込み可能、入力必須 |
復帰/改行(CR/LF)の変換を設定します。オプションの内容については、オプションのリストの使用上の留意点を参照してください。 |
|
書き込み可能、任意入力 |
ワークスペースを、指定したストリームに関連付けます。Perforceはストリームに関連付けられたワークスペースのビューを生成します。ユーザは手動でそれを変更できません。 |
|
書き込み可能、任意入力 |
過去のある時点におけるストリームのビューを設定するチェンジリスト番号。
同時に |
|
書き込み可能、任意入力 |
設定されている場合、ワークスペースは指定されたサーバに限り使用可能です。未設定の場合、このワークスペースはどのサーバでも使用可能です。 |
|
書き込み可能、複数行 |
ディポのファイルとワークスペースのファイルとの間のマッピングを指定します。詳しくは、p4 help viewsを参照してください。新しいビューは次のp4 syncで有効になります。 |
|
書き込み可能、任意入力、複数行 |
ディポのパスを特定の時点に制限します。ChangeViewフィールドで指定されるファイルは読み取り専用です。すなわち、開くことはできますがサブミットはできません。例: //depot/path/...@1000 指定されたパスにあるファイルのリビジョンは、指定されたチェンジリスト番号の後にサブミットされた場合、表示されません。ChangeViewパスに一致しているファイルは、サブミットできません。 |
オプション
|
ワークスペースがユーザによって所有されているか否かとは無関係に、指定されたクライアントワークスペースを削除します。ワークスペースのロックは解除し、作業中のファイルや作業中の変更が無いようにする必要があります。( |
|
通常は読み取り専用になっている最終更新日を設定可能にします。管理者は
このオプションを使用するには、p4
protectにより承認された |
|
クライアントに保留中の変更があっても、クライアントを削除することができます。クライアントは削除され、保留中の変更はそのまま残されます。( |
|
クライアントワークスペース仕様を標準入力から読み込みます。 |
|
クライアントワークスペース仕様を標準出力へ書き出します。 |
|
|
|
ワークスペースビューを切り替えます。ワークスペースビューをストリームに切り替えるには、
作業中のファイルのあるクライアントでは、ビューの切り替えはできません。 |
|
ワークスペースを指定ストリームに関連付けます。そのストリームがワークスペースビューの生成に使用されます。 |
|
クライアントワークスペース |
|
“グローバルオプション”を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
-
スペースを含むファイルまたはディレクトリ名のディポサイドまたはクライアントサイドのマッピングは引用符で囲みます。
-
ワークスペース名に含まれるスペースはアンダーバーと解釈されます。例えば、p4 client "my workspace"というコマンドを入力すると、
my_workspace
というワークスペースが生成されます。 -
デフォルトでは、すべてのユーザがp4 client
ですべてのワークスペースを編集できます。これが起きるのを防ぐには、clientname
locked
オプションを設定し、p4 passwdでワークスペース所有者のパスワードを生成します。 -
複数ドライブにまたがるWindows上のワークスペースを指定するには、ワークスペースビューで
Root:
をnull
に設定し、ドライブの文字を指定します。例えば、下のワークスペース仕様では、ルートがnull
に設定され、//depot/main/...
はC:
ドライブ領域へ、他のリリースはD:
ドライブへマッピングされています。Client: eds_win Owner: edk Description: Ed's Windows Workspace Root: null Options: nomodtime noclobber SubmitOptions: submitunchanged View: //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/...
ワークスペースを複数ドライブにわたって指定する場合は、小文字を使用してください。
オプションフィールド
[Options:
]フィールドには、6つの設定項目がスペースで区切られて表示されます。これらの設定項目には、それぞれ2つの設定値があり、その設定値と意味を次の表に示します。
設定値 |
意味 |
デフォルト |
---|---|---|
|
設定により、ワークスペース内の作業状態でないファイルは書き込み可能のままになります。
|
|
|
設定により、p4 sync実行時にワークスペースで新たに同期したファイルと同じ名前を持つ、書き込み可能だが作業状態でないファイルが上書き(clobber)されます。
|
|
|
設定により、ユーザのワークステーションとPerforceサービスの間のデータストリームが圧縮されます。 compressオプションは、伝送するデータ量を減らして、低速リンクを介した通信を高速化します。高速リンクの場合には、圧縮プロセスそのものに、節約される伝送時間より多くの時間がかかることがあります。一般に、compressはT1以下の伝送速度のときに設定するものであり、それ以外の場合は設定しません。 |
|
|
他のユーザにワークスペース仕様を編集または削除するパーミッションを認めるか否かを設定します。(
|
|
|
ファイルタイプ修飾子
ファイルタイプ修飾子
|
大半のファイルでは
ファイルタイプ修飾子 |
|
ワークスペースにあるディレクトリ内のすべてのファイルが削除されている場合、設定するとp4 syncによりワークスペース内の空のディレクトリが削除されます。
デフォルトでは、クライアントワークスペースに空のディレクトリがあっても(例えば、そのディレクトリにマッピングされるすべてのファイルが最後の同期以後に削除されているような場合)、p4 syncはそのディレクトリをそのまま残します。ただし、
|
|
行末の処理
[LineEnd:
]フィールドは、クライアントワークスペースのテキストファイルに使用される行末文字を制御します。行末オプションを変更しても、実際にはクライアントのファイルは更新されないため、p4 sync -fコマンドで更新することができます。
[LineEnd:
]フィールドは、次の5種類の設定値のいずれかを受け付けます。
設定値 |
意味 |
---|---|
|
クライアントのネイティブモード(デフォルト)を使用します。 |
|
UNIX形式(および MAC OS X)の行末識別を |
|
OS X より前のバージョンのMacの行末識別を |
|
|
|
ワークスペースの同期の際、行末は
一般に |
Perforceによる行末設定の使用方法に関して詳しくは、Perforceナレッジベースの「CR/LF Issues and Text Line-endings」を参照してください。
ストリームを使用する
-s
が付いていない場合、-S
オプションにより、ストリーム専用の新規クライアント仕様を作成することができます。クライアント仕様がすでに存在していて、stream
-S
オプションが-s
オプションなしで使用されている場合、これは無視されます。-S
により、クライアントのStream
フィールドが設定されます。専用のシンタックス-S
//
により、a
/stream
@changelist
Stream
およびStreamAtChange
を同時に設定することができます。
-S
オプションは、stream
-o -c
と共に使用されることで、古いストリームのクライアントビューを確認することができます。これは、変更が記録された時点でストリームに作成されていたクライアント仕様を生成します。
change
ビルドサーバを使用する
ビルドサーバタイプのサーバ(p4 help server参照)は、ビルドファーム統合をサポートするレプリカであり、p4 clientコマンドを使用してビルドサーバにクライアントワークスペースを作成し、編集できます。このワークスペースでは、レプリカのサポートするすべての読み取り専用コマンドに加えてp4 syncコマンドを発行できます。詳細な情報については、p4 help buildserverを実行してください。
ビルドサーバにクライアントワークスペースを作成または編集する場合、オプションのname
引数で指定されたクライアントは、環境変数P4CLIENT
やグローバルな-c client
引数で設定されるクライアントと同様、存在する必要がない、あるいはこのサーバに制限される必要があります。このコマンドは、このビルドサーバに制限されていないワークスペースの作成または編集に使用することはできません。
例
p4 client |
|
p4 client -t sue joe |
デフォルトとしてワークスペース |
p4 client -d release1 |
ワークスペース |