table of contents
GFPCOPY(1) | Gfarm | GFPCOPY(1) |
NAME¶
gfpcopy - copy Gfarm files in parallel
SYNOPSIS¶
gfpcopy [-nqvdpPU] [-X regexp] [-S source-domainname] [-h source-hostfile] [-D destination-domainname] [-H destination-hostfile] [-j num-of-processes] [-J num-of-processes] [-M limit-byte] [-z minimum-byte] [-Z maximum-byte] [-w way-of-scheduling] [-W kilobytes-for-threshold] [-s KB/s-to-simulate] [-F num-for-readahead] [-b bufsize] [-f] [-e] [-k] source-path destination-path
DESCRIPTION¶
gfpcopy copies files in parallel.
When the source-path is a directory, files under the directory will be copied recursively.
When the destination-path does not exist, the directory is created. When the destination-path exists, a directory of the same name as the source-path is created under the destination-path.
A set of source/destination hosts can be specified by a domain name and/or a hostlist file. When both a domain name and a hostlist file are specified, a set of hosts is determined by both conditions. When a set of source hosts is specified, only files stored on the source hosts are copied.
gfpcopy also retrieves the directory entries in parallel.
SOURCE PATH¶
source-path must be one of the following formats. Files on HPSS cannot be copied.
path-name
gfarm:...
file:...
DESTINATION PATH¶
destination-path must be one of the following formats.
path-name
gfarm:...
file:...
hpss:...
GFPCOPY OPTIONS¶
These are options only for gfpcopy.
-b bufsize
The default value is 64 KiB (64 * 1024).
-f
Without the -f option, existing files will be overwritten when they are older than the corresponding source files in the modification time.
-e
-k
COMMON OPTIONS¶
There are several common options with gfprep. (see man gfprep)
EXAMPLES¶
To copy files under the directory recursively.
$ gfpcopy gfarm:///dir file:///tmp/dir
$ gfpcopy file:///tmp/dir gfarm:///dir
$ gfpcopy gfarm:///dir1 gfarm:///dir2
$ gfpcopy gfarm:///dir hpss:///tmp/dir
$ cd /mnt/gfarm2fs $ gfpcopy dir /tmp/dir
To copy a file.
$ gfpcopy gfarm:///dir/file file:///dir
$ cd /mnt/gfarm2fs $ gfpcopy file /tmp/dir
NOTES¶
To retrieve the directory entries efficiently, it is better to execute gfpcopy command near the metadata server. When you need to execute gfpcopy command far from the metadata server, increase the parallelism by the -j and -J options.
SEE ALSO¶
27 Aug 2015 | Gfarm |