p4 add
ディポに追加するファイルをクライアントワークスペースで作業状態にします。
構文規則
p4 [g-opts] add [-c changelist] [-d -f -I -n] [-t
filetype] file ...
説明
p4 addは、ディポに追加するファイルをクライアントワークスペースで
作業状態にします。これらの指定されたファイルはチェンジリストにリンクされます。
このコマンドにより、新しいディポや空のディポにファイルを追加することができます。
すでにファイルが保管されているディポにファイルを追加することもできます。
p4
submitコマンドでチェンジリストをコミットすると、ファイルがディポに追加されます。
追加するファイルは、ディポに存在しないファイルか、最新リビジョンで
削除済みとしてマークされているファイルでなければなりません。
p4 add *は、p4 reconcile -a
*と同様に機能します。
p4 addでファイルを作業状態にするには、そのファイルがクライアントビューに存在する必要がありますが、
p4 addの実行時点でワークスペースに存在する必要はありません。
p4
submitを実行するとき、ファイルはワークスペースにある必要があります。
そうでなければ、サブミットは失敗します。
p4
addは、ファイルを作成しないか、あるいはワークスペースでファイルを上書きします。
ファイルが存在しない場合は、ユーザが作成しなければなりません。
デフォルトでは、指定されたファイルはデフォルトチェンジリストで作業状態にされます。
指定されたチェンジリストでファイルを作業状態にするには、-cオプションを使用します。
デフォルトチェンジリストから番号付きチェンジリストにファイルを移動するには、
p4 changeコマンドを使用します。
デフォルトでは、p4 addは、適用されるP4IGNOREファイルに記述された
ファイルを無視します。この動作をオーバーライドするには、
-Iオプションを使用して
P4IGNOREファイルの内容が無視されるようにします。
ファイルを追加するときには、コマンドはまずタイプマップテーブル(p4
typemap)を調べ、
追加しようとしているファイルのファイルタイプをシステム管理者が
定義しているかどうかを確かめます。合致するものが見つかれば、
そのファイルタイプがタイプマップテーブルの定義に従って設定されます。
一致するものが見つからない場合、
コマンドは構成可能変数filesys.binaryscanに従って
該当ファイルの先頭のバイト(デフォルトでは65536バイト)を調べ、
それがtextかbinaryかを判断した上、
ファイルをディポに保存します。デフォルトでは、テキストファイルのリビジョンは
リバースデルタ形式で保存されます。filetype.maxtextsizeによる制限値
(デフォルトでは10MB)を超える、新規に追加されたテキストファイルには
text+Cファイルタイプが割り当てられて完全な形で保存されます。
.zip形式(.jarファイルを含む)で圧縮されたファイルも
自動的に検出され、ubinaryタイプが割り当てられます。
その他のバイナリファイルのリビジョンは、圧縮されてファイル全体が保存されます。
-t filetypeオプションは、ファイルタイプを明示的に指定して、
タイプマップテーブルとデフォルトファイルタイプ検出機構の両方を
オーバーライドします。
@、#、*、%の文字が含まれたファイルを追加するには、
-fオプションを使用します。このオプションを指定すると、Helixサーバでワイルドカードとして
使用される文字が強制的に文字解釈されます。
編集または移動/追加目的でファイルを作業状態にした後で、
他のユーザがその作業状態のファイルを削除すると、チェンジリストをサブミットしたときに
処理がエラーで失敗します。反映先ファイルを確実に作成するには、
-dオプション(「ダウングレード」)を指定します。詳細に述べると、次のとおりです。
- 編集目的でファイルを作業状態にした後、別のユーザがそのファイルを削除または
移動するチェンジリストをサブミットします。編集をサブミットすると、
Helixサーバはエラーを返し、ファイルは編集目的の作業状態のままになります。
チェックアウトしたディポ内の場所から(実行したすべての変更を含めて)ファイルをリストアするには、
-dオプションを追加してファイルを追加目的で作業状態にしてから、 そのファイルをサブミットします。 - 移動/追加目的でファイルを作業状態にした後、別のユーザが元のファイルを
削除するチェンジリストをサブミットします。移動をサブミットすると、
Helixサーバはエラーを返し、ファイルは移動/追加目的の
作業状態のままになります。反映先ファイルを作成するには、
追加ファイルを指定して
p4 add -dコマンドを実行し、 そのファイルをサブミットします。
オプション
|
|
指定されたチェンジリストに対して、ファイルを |
|
|
ファイルを作業状態にするステータスを、単純な追加にダウングレードします。 |
|
|
|
|
|
無視するかどうかのチェックを行いません。 |
|
|
ファイルやメタデータを実際に変更せずに、追加目的で作業状態にする ファイルをプレビューします。 |
|
|
タイプマップテーブルのあらゆる設定をオーバーライドして、作業状態にあるファイルを 指定したファイルタイプに変更します。 Helixサーバのファイルタイプの一覧については、 「ファイルタイプ」を参照してください。 |
|
|
「グローバルオプション」を参照してください。 |
使用上の注意点
| ファイル引数でリビジョン指定子を使用できるか？ | ファイル引数でリビジョン範囲を使用できるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
いいえ |
いいえ |
|
p4 addコマンドのファイル仕様で指定したワイルドカード「*」は、 ローカルのオペレーティングシステムによって拡張されます(「ワイルドカード」を参照)。-
p4 add -fでは特殊文字のASCII拡張は使用しないでください。 ファイルstatus@june.txtを追加する場合は、次のように指定します。p4 add -f status@june.txt手動で
@記号を拡張して、 ファイルstatus%40june.txtを追加しようとすると、 Helixサーバが%記号を文字として解釈し 16進コード%25に拡張され、 ファイル名はstatus%2540june.txtとなります。
例
|
|
新しいファイルに特定のファイルタイプを割り当て、タイプマップテーブルの設定を オーバーライドします。 |
|
|
ユーザの現在のディレクトリにあるすべてのファイルをディポに |
|
|
|
|
|
このファイルをビューまたは他のコマンドで参照するために、その後はアスタリスクの代わりに
16進拡張 詳細については、 「ファイル名とエンティティに関する文字の制限」を参照してください。 |
関連コマンド
|
編集するファイルを作業状態にする |
|
|
削除するファイルを作業状態にする |
|
|
ファイルを移動(リネーム)する |
|
|
すべての作業状態のファイルをディポにコピーする |
|
|
ディポからクライアントワークスペースへファイルを読み込む |
|
|
新しいチェンジリストを作成または編集する |
|
|
テキスト/バイナリのファイル検出のデフォルトの動作を変更する |
|
|
すべての作業状態のファイルを一覧表示する |
|
|
ファイルを非作業状態に戻す |
|
|
作業状態のファイルを別の作業中チェンジリストに移動する |
|
|
作業状態のファイルのファイルタイプを変更する |
|
