p4 labelsync
概要
ラベルを現在のクライアントワークスペースの内容と同期させます。
構文
p4 [g-opts
] labelsync [-a -d -g -n -q] -l labelname
[file
[revRange
] …]
解説
p4 labelsyncは、クライアントに最後に同期した各ファイルのリビジョンをそのラベル名でタグ付けすることによって、指定したラベルにクライアントワークスペースの現在の内容を反映させます。その結果、ラベル名を@
としてリビジョン指定内で使用し、ラベルでタグ付けされたファイルのリビジョンを参照することができます。
label
ファイル引数を付けない場合、p4 labelsyncによってラベルにクライアントワークスペースの内容が反映され、ラベルでタグ付けされたファイルの集合が追加、削除、更新されます。
ファイルが指定されている場合、p4 labelsyncは指定されたファイルに対してのみタグを更新します。ファイル引数にリビジョン指定子が含まれている場合、クライアントビューは無視され、指定されたリビジョンがワークスペース内に存在するリビジョンの代わりに使用されます。ファイル引数にリビジョン範囲が含まれている場合、その範囲内の最新リビジョンだけが使用されます。
unlocked
のラベルのOwner:
だけが、p4 labelsyncを使用して、そのラベルでファイルにタグ付けすることができます。
[Options:
]フィールドがlocked
に設定されているラベルを、p4
labelsyncで更新することはできません。
オプション
|
ファイルパターン引数に適合するファイルにラベルを追加します。ファイルがラベルから削除されることはありません。 |
|
指定されたファイルからラベルタグを削除します。 |
|
分散環境では |
|
ファイルリビジョンに適用されるラベルを指定します。 |
|
p4 labelsyncが実行する予定の動作を、実際にその動作を実行することなく表示します。 |
|
クワイエットモード: 通常の出力メッセージを抑止します。エラーや例外条件に関するメッセージは抑止されません。 |
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
使用可 |
使用可 |
|
-
デフォルトでは、p4 labelsyncは、クライアントワークスペースに最後に同期されたファイルのリビジョンに対して動作します。ファイルの最新リビジョン(または指定した範囲で最も大きい番号のリビジョン)にタグ付けするには、p4 tagを使用します。
-
どのファイルがラベルによってタグ付けされているかを調べるには、p4 files @
labelname
を使用します。 -
分散Perforceサービスでは、p4 labelsyncはエッジサーバのローカルなラベルに対して動作します。
-g
オプションは、グローバルラベルを適用するときに使用できます。ただし、クライアントワークスペースはバインドされていない(グローバルである)必要があります。ラベルはデフォルトでエッジサーバに対してローカルになります。コミットサーバのグローバルラベルには
-g
オプションを使用してアクセスします。管理者がrpc.labels.global
を1
に設定している場合、ラベルはデフォルトでグローバルになります。つまり、-g
オプションは反転してローカルラベルの更新を可能にします。