<addFile> 要素

<addFile> 要素は <capture> 要素の子であり、包含するスナップショットの一部としてキャプチャーされるファイルを指定します。

<addFile> 要素の属性

<addFile> 要素には次の属性が含まれます。

• path – 必須属性で、ターゲットホストのファイルシステム上のファイルまたはディレクトリのパス名を指定します。この属性は、単純置換変数を参照できます。

• ownership – オプション属性で、キャプチャーされたファイルの所有権オプションを指定します。

  スナップショットによってキャプチャされるインストール状態の情報の 1 つに、ファイルおよびディレクトリの所有権があります。この所有権は UNIX のアクセス許可と同じではありません。所有権は、参照カウントの概念により近いと言えます。具体的には、ファイルまたはディレクトリは、1 つ以上のスナップショットによって所有されているものとしてキャプチャできます。

  ほかのコンポーネントのインストールにより、ファイルの所有者が変更された場合、そのファイルがその初期状態と比較されたときに、この変更が認識され報告されます。この機能により、あるコンポーネントが、別のコンポーネントに関連付けられているファイルを誤って上書きしたために生じた差異を追跡することができます。スナップショットの所有権情報は、所有者テーブルと呼ばれる、ターゲットホスト上のリポジトリ内にキャプチャされます。

  ownership 属性の値は以下のセマンティクスを持ちます。

  • SET_SELF – ownership 値がこの値に設定された場合、所有者テーブルは関連付けられたファイルまたはディレクトリ用の単一のエントリを含むように更新されます。そのエントリは、実行するインストール済みコンポーネントとスナップショットを所有者としてリストします。また、キャプチャされたファイルコンテンツまたはディレクトリコンテンツのキャプチャ領域 ID もリストします。

  • ADD_SELF – ownership がこの値に設定された場合、インストール済みコンポーネントとスナップショットが付加的な所有者として追加され、以前の所有者として既存のキャプチャー領域 ID を共有します。

  • ADD_TEMP – この値は ADD_SELF と似ていますが、新しいキャプチャーが常に作成されてその ID が常に新しいエントリに使用されます (ほかの所有者の ID を共有することはありません)。

  この属性を指定しない場合、デフォルト値は SET_SELF です。

• filter – boolean 型のオプション属性で、ファイルまたはディレクトリ、あるいはその両方をキャプチャーすべきかを示します。

  path の値がディレクトリである場合、この属性は、ディレクトリ自体、そのディレクトリに含まれるファイル、またはその両方をキャプチャーすべきかを示すために使用されます。path の値がディレクトリでない場合、この属性は無視され、ファイルが直接キャプチャーされます。この属性を指定しない場合、デフォルトの BOTH が使用されます。

  この属性の値には次のものがあります。

  • DIRECTORIES

  • FILES

  • BOTH

• recursive – オプション属性で、現在のフィルタ設定を使用してサブディレクトリを再帰的にキャプチャーすべきかどうかを示します。

  path の値がディレクトリである場合、この属性は、現在のフィルタ設定を使用してサブディレクトリを再帰的にキャプチャすべきかどうかを示します。path の値がディレクトリでない場合、この属性は無視され、ファイルが直接キャプチャーされます。デフォルト値は true です。

• displayName – オプション属性で、当該スナップショットエントリがほかのエントリと比較される際に表示に含めるテキスト。

  この属性は、単純置換変数を参照できます。