6.2.8.3 clonefile

1つ以上のファイルをクローニングします。

用途

clonefileコマンドを使用すると、ファイルまたはファイル・グループの書込み可能クローンを作成できます。

構文

clonefile source target [ source target ]... [ --exclude exclude-spec ]...

コマンド・オプション

clonefileコマンドのオプションは、次のとおりです:

• source: クローン・ソースであるファイル(1つまたは複数)の名前を指定します。

• target: クローン宛先であるファイル(1つまたは複数)の名前を指定します。

• --exclude: クローン操作から除外されるファイル(1つまたは複数)の名前を指定します。

使用上のノート

このコマンドを使用する際は、次の情報に注意してください:

• sourceでワイルドカード(*)を使用すると、複数のソース・ファイルを指定できます。その場合は、対応するtargetにも一致するワイルドカードを含める必要があります。

• クローン操作におけるすべてのファイルは同じボールト内にある必要があり、そうでない場合はエラーが返されます。

• 複数のsourceとtargetのペアを使用できます。この場合、ソース・ファイルの指定は順番に考慮され、最初の一致のみが使用されます。

• --excludeオプションを使用して指定したファイルは、クローン操作から除外されます。このような除外は、すべてのsourceとtargetのペアに適用されます。

• NULL (空の)文字列をtarget値として指定した場合、対応するsourceのクローンは作成されません。NULL targetの指定は、クローン操作からファイルを除外する代替方法です。

  sourceとNULL targetは、他のすべてのsourceとtargetのペアとともに順番に考慮され、最初の一致のみが使用されます。

• 同じ操作で作成されるすべてのクローンは、ポイントインタイム一貫性があります。

例

例6-77 ファイルのクローニング

次の例では、ファイルをクローニングします。ソース・ファイルは@my-data/file1で、クローンは@my-data/clone-file1です。

@> clonefile @my-data/file1 @my-data/clone-file1

例6-78 ファイル・グループのクローニング

次の例では、ワイルドカードを使用したファイル・グループをクローニングします。この例では、@my-data/file1、@my-data/file2などの名前のファイルが存在する場合、@my-data/clone-dir/file1という名前の@my-data/file1のクローン、@my-data/clone-dir/file2という名前の@my-data/file2のクローンなどが作成されます。

@> clonefile @my-data/file* @my-data/clone-dir/file*

例6-79 複数のファイル・グループのクローニング

次の例では、複数のファイル・グループをクローニングします。この例では、@my-data/a*および@my-data/b*をクローニングし、結果のクローンは@my-data/clone/に配置されます。

@> clonefile @my-data/a* @my-data/clone/a* @my-data/b* @my-data/clone/b*

例6-80 順序の重要性

次の各例では、sourceとtargetのペアが指定される順序の重要性を示します。

最初のコマンドでは、@my-data/a*に一致するファイルのクローンは@my-data/clone/aに作成され、その他のファイルのクローンは@my-data/clone/otherに作成されます。

@> clonefile @my-data/a* @my-data/clone/a/a* @my-data/* @my-data/clone/other/*

次のコマンドでは、すべてのファイルが@my-data/*と一致するため、クローンはすべて@my-data/clone/otherに作成されます。この場合、2番目のsourceとtargetのペアは使用されません。

@> clonefile @my-data/* @my-data/clone/other/* @my-data/a* @my-data/clone/a/a*

例6-81 除外を指定したファイル・グループのクローニング

次の例では、@my-data/a*または@my-data/b*と一致するファイルを除き、@my-data内のファイルをクローニングします。

@> clonefile @my-data/* @my-data/clone/* --exclude @my-data/a* --exclude @my-data/b*

@> clonefile @my-data/a* "" @my-data/b* "" @my-data/* @my-data/clone/*

例6-82 無効なコマンド

次の各例では、無効なコマンドを示します。複数のボールトが参照されるため、最初と2番目のコマンドは無効です。クローン宛先にソース指定に一致するワイルドカードが含まれていないため、最後のコマンドは無効です。

@> clonefile @my-data/a* @my-data-backup/a*

@> clonefile @my-data/a* @my-data/clone/a* @vault2/a* @vault2/clone/a*

@> clonefile @my-data/withwc* @my-data/clone/withoutwc