qacli config udl

本Perforce QACインストレーションにおけるユーザデータの保存先（UDL-User Data Location)　を管理します。


使用方法

config udl {-S <directory>|-L|--reset|--remove} [-G] [-c] [--] [-h]

詳しい説明

Perforce QACには、サンプルプロジェクト、サンプル設定、および各種コンパイラのための互換設定が同梱されています。

Perforce QACの初回起動時に、これらのデータが「ユーザデータの保存先」にコピーされます。 デフォルトの場所はユーザ依存で、使用しているOS特有の場所になります。

  • Windows: %LOCALAPPDATA%\Perforce\QAC-<version>
  • Linux: $HOME/.config/Perforce/QAC-<version>

UDLは消去または他の場所（ユーザ間でUDLを共有するなど）に移動することが可能です。


オプション

オプション名、短縮形 デフォルト 説明
‑‑current, ‑c   バージョン固有の接尾辞を含むユーザデータの現在の保存先を返します。
‑‑global, ‑G  

--set および --reset オプションは　デフォルトで、USER UDL（各ユーザ固有）を設定します。 GLOBAL（全ユーザ）のレベルに設定するためにはこのオプションを使用してください。

注：OS特有のフォルダは以下です。

  • /etc/Perforce.d
  • %PROGRAMDATA%/Perforce

このフォルダは既に存在し、許可の設定がされている必要があります。そうすることで、ユーザはこのディレクトリ下で読込み/書込みおよび、ファイル/ディレクトリの削除をすることができます。
‑‑help, ‑h   使用方法の情報を表示し、終了します。
‑‑ignore‑rest, ‑‑   このフラグ以降のラベルの付いた引数をすべて無視します。
‑‑list, ‑L  

現在のユーザデータの保存先とそのタイプを返します。

  • DEFAULT : Perforce QACが指定したデフォルトの場所
  • VARIABLE : 環境変数により設定されたUDL
  • USER : ユーザが指定するUDL、作業をしているユーザが利用可能
  • GLOBAL : ユーザが指定するUDL、すべてのユーザが利用可能
‑‑remove  

現在のユーザデータの保存先からユーザデータを削除するコマンドです。 Perforce QACが次に稼働されるときにデフォルト値が再読込みされます。

この操作は元に戻せません！
‑‑reset   ユーザデータの保存デフォルト値にリセットするコマンドです。デフォルトでこれは、USER UDL（各ユーザ固有）を変更します。
GLOBAL（全ユーザ）のレベルに設定するためには ‑‑global オプションを使用してください。
‑‑set, ‑S   ユーザデータの保存先を作業をしているディレクトリに変更するコマンドです。 例えば、共通のユーザデータの保存先をユーザ同士で共有することが可能になります。 デフォルトでこれは、USER UDL（各ユーザ固有）を変更します。 GLOBAL（全ユーザ）のレベルに設定するためには --global　オプションを使用してください。
UDLは --set 　オプションまたは、環境変数を使用して変更することができます。　「D　　環境変数」のQAC_UDLを参照してください。

新しいUDLターゲットディレクトリが存在、し、そのディレクトリの読取り/書込み/削除 の操作をする権限が必要です。

最初は、ファイルは以前のユーザデータの保存先からコピーされません。 次回Perforce QACコマンドが出されると、インストールディレクトリのデフォルトファイルがコピーされます。 以前の場所でユーザが作成したファイルはコピーされません。ユーザが作成したファイルは必要に応じて手動でコピーする必要があります。

Perforce QAC GUIを使用している場合は、新しいUDLを有効にするためにPerforce QACを直ちに再起動してください。


例

デフォルトではないユーザデータの保存先の使用

デフォルトではない、ユーザ固有の場所を指定するには以下に示す形式のコマンドを使用してください。

qacli config udl --set /home/bob/QAC

このコマンドにより、指定したディレクトリ下にUDLを配置します。 次回Perforce QACを稼働すると、必要なファイルを生成し、その場所にファイルをコピーします。トップレベルのディレクトリは以下です。 

QAC-<version>


ユーザデータの保存先をチェックする

使用中のユーザデータの保存先を確かめるには　 --list　を使用します。

qacli config udl --list

このコマンドは現在のUDLの場所とそのタイプを表示します。

  • DEFAULT : Perforce QACが指定したデフォルトの場所
  • VARIABLE : 環境変数により設定されたUDL
  • USER : ユーザが指定するUDL、作業をしているユーザが利用可能
  • GLOBAL : ユーザが指定するUDL、すべてのユーザが利用可能

現在のユーザデータの保存先の内容を削除する

現在のユーザデータの保存先の内容を削除するには以下の形式のコマンドを使用します。

qacli config udl --remove
この操作は元に戻せません！

次回Perforce QACを稼働すると、必要なファイルを生成し、その新しい場所にファイルをコピーします。トップレベルのディレクトリは以下です。

QAC-<version>



デフォルトのユーザデータの保存先にリセットする

デフォルトの場所にリセットするには以下の形式のコマンドを使用します。

qacli config udl --reset

古いUDLの内容は削除されません。次回Perforce QACを稼働すると、必要なファイルを生成し、その場所にファイルをコピーします。トップレベルのディレクトリは以下です。

QAC-<version>


環境変数を使用してユーザデータの保存先を設定する

環境変数はUDL設定するために使用することができます。 これは　qacli コマンドを使用する前に設定（確保）する必要があります。

export QAC_UDL=/home/neo/qac
qacli config udl --list

全ユーザのための共通のユーザデータの保存先を設定する

環境変数を設定するかまたは、GLOBALレベルの UDLを設定することで共通のユーザデータの保存先を設定できます。 例:

qacli config udl --set /tmp/QAC --global

このUDLはマシン上のPerforce QACの全ユーザが使用するこができます。