## Name

gfpcopy — copy Gfarm files in parallel

## Synopsis

`gfpcopy` [-nqvdpPU] [-f] [-S `source-domainname`] [-h `source-hostfile`] [-D `destination-domainname`] [-H `destination-hostfile`] [-j `num-of-processes`] [-J `num-of-processes`] [-M `limit-byte`] [-w `way-of-scheduling`] [-W `kilobytes-for-threshold`] [-s `KB/s-to-simulate`] [-F `num-for-readahead`] [-b `bufsize`] `source-path` `destination-path`

## DESCRIPTION

gfpcopy は、ファイルやディレクトリを 並列にコピーします。

転送先や転送元のホスト群を指定するには、 ドメイン名で指定するか、ホスト名を行ごとに記述したホストリストファイルを指定します。 ドメイン名とホストリストファイルを両方指定した場合は、 両方の条件に合うホスト群を決定します。 転送元ホスト群を指定した場合、そのホストに存在するファイルのみ複製が作成されます。

`source-path` がディレクトリの場合、 それ以下にあるすべてのファイルをコピーします。

gfpcopy は、ディレクトリを辿る際に、 ディレクトリエントリ情報も並列に取得します。

## GFPCOPY OPTIONS

以下は gfpcopy 専用のオプションです。

`-b` `bufsize`

  コピー時に使用するバッファサイズを指定します。

  標準は 64 キビバイト (64 * 1024) です。

`-f`

  -f オプションを指定する場合、コピー先のファイルとコピー元のファイルが、 サイズまたは mtime が異なる場合に上書きします。

  -f オプションを指定しない場合、 コピー先のほうが mtime が古い場合に、上書きします。

## COMMON OPTIONS

gfpcopy には gfprep と共通のオプションがあります。 gfprep のマニュアルを参照してください。

## EXAMPLES

ディレクトリ以下すべてをコピーします。

$ gfpcopy gfarm:///dir file:///tmp/dir

$ gfpcopy file:///tmp/dir gfarm:///dir

$ gfpcopy gfarm:///dir1 gfarm:///dir2

$ cd /mnt/gfarm2fs
$ gfpcopy dir /tmp/dir

一つのファイルをコピーします。

$ gfpcopy gfarm:///dir/file file:///dir

$ cd /mnt/gfarm2fs
$ gfpcopy file /tmp/dir

## NOTES

gfmd と gfpcopy が距離的に離れている場合には、 gfpcopy の動作が遅くなります。 そのような場合には、-j または -J オプションに大きな値を指定すると、 性能が改善するかもしれません。

## SEE ALSO

gfprep(1), gfreg(1), gfexport(1), gfarm2.conf(5)