'\" t
.\"     Title: gfpcopy
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 27 Aug 2015
.\"    Manual: Gfarm
.\"    Source: Gfarm
.\"  Language: English
.\"
.TH "GFPCOPY" "1" "27 Aug 2015" "Gfarm" "Gfarm"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gfpcopy \- ファイルを並列にコピーする
.SH "SYNOPSIS"
.HP \w'\fBgfpcopy\fR\ 'u
\fBgfpcopy\fR [\-nqvdpPU] [\-X\ \fIregexp\fR] [\-S\ \fIsource\-domainname\fR] [\-h\ \fIsource\-hostfile\fR] [\-D\ \fIdestination\-domainname\fR] [\-H\ \fIdestination\-hostfile\fR] [\-j\ \fInum\-of\-processes\fR] [\-J\ \fInum\-of\-processes\fR] [\-M\ \fItotal\-byte\fR] [\-z\ \fIminimum\-byte\fR] [\-Z\ \fImaximum\-byte\fR] [\-w\ \fIway\-of\-scheduling\fR] [\-W\ \fIkilobytes\-for\-threshold\fR] [\-s\ \fIKB/s\-to\-simulate\fR] [\-F\ \fInum\-for\-readahead\fR] [\-f] [\-b\ \fIbufsize\fR] [\-e] [\-k] \fIsource\-path\fR \fIdestination\-path\fR
.SH "DESCRIPTION"
.PP
\fBgfpcopy\fR
は、複数のファイルを並列にコピーします。
.PP
\fIsource\-path\fR
がディレクトリの場合は、その下にあるすべてのファイルとディ レクトリをコピーします。
.PP
\fIdestination\-path\fR
が存在しない場合は、 ディレクトリを作成します。
\fIdestination\-path\fR
が存在する場合は、 そのディレクトリの下に\fIsource\-path\fR
と同名のディレクトリを作成します。
.PP
作成先のホスト群を指定することにより、コピーしたファイルを格納するホス トを指定することができます。ホスト群は、ドメイン名か、ホスト名を行ごと に記述したホストファイルで指定します。ドメイン名とホストファイルを両方 指定した場合は、両方の条件に合うホスト群が選ばれます。また、作成元のホ スト群も指定可能です。その場合、そのホスト群に存在するファイルのみコピー されます。
.PP
\fBgfpcopy\fR
は、ディレクトリを辿る際に、ディレクトリエントリ情報も並列に 取得します。
.SH "SOURCE PATH"
.PP
\fIsource\-path\fR
には以下を指定できます。 なお、HPSS上のファイルはコピーでき ません。
.PP
\fIパス名\fR
.RS 4
ローカルファイルシステム上のパスを絶対パスまたは相対パスで指定しま す。そのパスが gfarm2fs のマウントポイントの場合は、gfarm2fsを経由 せずに Gfarm からコピーします。
.RE
.PP
\fIgfarm:\&.\&.\&.\fR
.RS 4
Gfarm URL で指定します。
.RE
.PP
\fIfile:\&.\&.\&.\fR
.RS 4
ローカルファイルシステム上のパスを URL で指定します。
.RE
.SH "DESTINATION PATH"
.PP
\fIdestination\-path\fR
には以下を指定できます。
.PP
\fIパス名\fR
.RS 4
ローカルファイルシステム上のディレクトリを絶対パスまたは相対パスで 指定します。そのパスが gfarm2fs のマウントポイントの場合は、 gfarm2fs を経由せずに Gfarm へコピーします。
.RE
.PP
\fIgfarm:\&.\&.\&.\fR
.RS 4
ディレクトリを Gfarm URL で指定します。
.RE
.PP
\fIfile:\&.\&.\&.\fR
.RS 4
ローカルファイルシステム上のディレクトリを URL で指定します。
.RE
.PP
\fIhpss:\&.\&.\&.\fR
.RS 4
HPSS 上に存在するディレクトリを URL で指定します。 その下に
\fIsource\-path\fR
と同名のディレクトリが存在する場合はエラーになります。 HPSS に対して差分コピーはできません。 hpss:\&. や hpss:dir のように 相対パスで指定することもできます。
.RE
.SH "GFPCOPY OPTIONS"
.PP
以下は
\fBgfpcopy\fR
専用のオプションです。
.PP
\fB\-b\fR \fIbufsize\fR
.RS 4
コピー時に使用するバッファサイズを指定します。 デフォルトは 64 KiByte (64 * 1024) です。
.RE
.PP
\fB\-f\fR
.RS 4
\-f オプションを指定する場合、コピー先のファイルとコピー元のファイル が、サイズまたは mtime が異なる場合に上書きします。
.sp
\-f オプションを指定しない場合、コピー先のほうが mtime が古い場合 に、上書きします。
.RE
.PP
\fB\-e\fR
.RS 4
gfpcopy を複数同時に実行するために、コピー先にファイルが存在すれば 無視します。
.RE
.PP
\fB\-k\fR
.RS 4
シンボリックリンクをコピーしません。
.RE
.SH "COMMON OPTIONS"
.PP
\fBgfprep\fR
と
\fBgfpcopy\fR
には、 共通で利用できるオプションがあります。
.PP
\fB\-X\fR \fIregexp\fR
.RS 4
\fIregexp\fRで指定した正規表現による パターンと一致するパス名を無視しま す。 複数個のパターンを指定する場合は、\-X オプションを複数回指定し ます。
.RE
.PP
\fB\-S\fR \fIsource\-domainname\fR
.RS 4
指定されたドメイン名に格納されているファイルだけを複製作成、コピー の対象にします。
.RE
.PP
\fB\-h\fR \fIsource\-hostfile\fR
.RS 4
指定されたホストファイルのホストに格納されているファイルだけを複 製作成、コピーの対象にします。ホストファイルには、ホストを一行ず つ記述します。
.sp
``\-\*(Aq\*(Aq を指定すると、ホスト名のリストを標準入力から読み込みます。
.RE
.PP
\fB\-L\fR
.RS 4
\-S または \-h で指定したホストから複製、コピーを作成します。
.RE
.PP
\fB\-D\fR \fIdestination\-domainname\fR
.RS 4
指定されたドメイン名のホストに複製、コピーを作成します。
.sp
このオプションも \-H オプションも指定しない場合、利用可能な全ホスト を対象に複製、コピーを作成します。
.RE
.PP
\fB\-H\fR \fIdestination\-hostfile\fR
.RS 4
指定されたホストファイルのホストに複製、コピーを作成します。ホスト ファイルには、ホストを一行ずつ記述します。
.sp
``\-\*(Aq\*(Aq を指定すると、ホスト名のリストを標準入力から読み込みます。
.RE
.PP
\fB\-j\fR \fInum\-of\-processes\fR
.RS 4
同時に複製作成やコピーをする際の最大並列数を指定します。
.sp
デフォルト値は gfarm2\&.conf の client_parallel_copy パラメータです。 最大値は gfarm2\&.conf の client_parallel_max パラメータです。 詳細 は gfarm2\&.conf のマニュアルを参照してください。
.sp
作成元または作成先のホストごとの最大並列数は、CPU 数です。 CPU 数 については、\fBgfhost\fR
のマニュアルを 参照してください。
.RE
.PP
\fB\-J\fR \fInum\-of\-processes\fR
.RS 4
並列にディレクトリを辿るための並列数を指定します。
.sp
デフォルト値は 8 です。
.RE
.PP
\fB\-M\fR \fItotal\-byte\fR
.RS 4
ファイル複製、またはコピーするファイルの合計のバイト数を指定します。 あるホストに格納されているファイルの容量を、指定バイト数移動して減 らしたいときなどに便利です。
.sp
デフォルトでは制限しません。
.RE
.PP
\fB\-z\fR \fIminimum\-byte\fR
.RS 4
ファイル複製、またはコピーするファイルの最低サイズをバイト単位 で指定します。小さいファイルはファイル複製やコピーの対象外とし たいときに便利です。
.sp
デフォルトでは制限しません。
.RE
.PP
\fB\-Z\fR \fImaximum\-byte\fR
.RS 4
ファイル複製、またはコピーするファイルの最大サイズをバイト単位 で指定します。大きいファイルはファイル複製やコピーの対象外とし たいときに便利です。
.sp
デフォルトでは制限しません。
.RE
.PP
\fB\-w\fR \fIway\-of\-scheduling\fR
.RS 4
スケジューリング方法を指定します。 noplan にすると、ファイルを 見つけながら、複製作成またはコピーします。 greedy にすると、複 製作成やコピーする前に、貪欲法によってスケジューリングします。
.sp
デフォルトは noplan です。
.sp
greedy にすると、\-N や \-m オプションを使用することができません。
.RE
.PP
\fB\-W\fR \fIkibibytes\fR
.RS 4
各 Connection のコスト(合計ファイルサイズ)を平均とみなすまでの 閾値をキビバイトで指定します。Connection とは、子プロセスごとに ファイルを割り当てるための、計画情報です。
.sp
\-w greedy オプションを使用した場合のみ効果があります。
.sp
デフォルトは 50 * 1024 キビバイト (50 メビバイト) です。
.RE
.PP
\fB\-I\fR \fIsec\-to\-update\fR
.RS 4
各ホストのロードアベレージやディスクの空き容量を定期的に取得する 間隔を秒単位で指定します。
.sp
デフォルトは 300 秒です。
.RE
.PP
\fB\-B\fR
.RS 4
高負荷なホストも作成先の対象にします。
.sp
デフォルトでは高負荷なホストを作成先の対象にしません。そのため、 すべてのホストが高負荷の場合はファイル複製、コピーは行われません。
.sp
高負荷なホストとは、(ロードアベレージ / CPU 数) が gfarm2\&.conf の schedule_busy_load_thresh よりも高いホストです。 schedule_busy_load_thresh のデフォルト値は gfarm2\&.conf のマニュ アルを参照してください。 CPU 数については gfhost のマニュアルを 参照してください。
.RE
.PP
\fB\-U\fR
.RS 4
ホストのディスクの空き容量を毎回チェックしなくなります。
.RE
.PP
\fB\-F\fR \fInum\-of\-dirents\fR
.RS 4
ディレクトリエントリの情報を先読みする数を指定します。
.sp
デフォルトは 10000 です。
.RE
.PP
\fB\-s\fR \fIkilobytes\-per\-second\fR
.RS 4
シミュレーションする際の転送速度を KB/s で指定します。 実際にはコピーせず、ファイル情報を取得するのみになります。
.RE
.PP
\fB\-n\fR
.RS 4
何もしません。 ディレクトリを辿るだけです。
.RE
.PP
\fB\-p\fR
.RS 4
性能の総合結果を報告します。
.RE
.PP
\fB\-P\fR
.RS 4
性能に関してファイルごとの結果と総合結果を報告します。
.RE
.PP
\fB\-q\fR
.RS 4
警告を表示しません。
.RE
.PP
\fB\-v\fR
.RS 4
冗長な情報を出力します。
.RE
.PP
\fB\-d\fR
.RS 4
デバッグ情報を出力します。
.RE
.PP
\fB\-?\fR
.RS 4
コマンドオプションを出力します。
.RE
.SH "EXAMPLES"
.PP
ディレクトリ以下すべてをコピーします。
.sp
.if n \{\
.RS 4
.\}
.nf
$ gfpcopy gfarm:///dir file:///tmp/dir
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ gfpcopy file:///tmp/dir gfarm:///dir
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ gfpcopy gfarm:///dir1 gfarm:///dir2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ gfpcopy gfarm:///dir hpss:///tmp/dir
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ cd /mnt/gfarm2fs
$ gfpcopy dir /tmp/dir
.fi
.if n \{\
.RE
.\}
.PP
一つのファイルをコピーします。
.sp
.if n \{\
.RS 4
.\}
.nf
$ gfpcopy gfarm:///dir/file file:///dir
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ cd /mnt/gfarm2fs
$ gfpcopy file /tmp/dir
.fi
.if n \{\
.RE
.\}
.SH "NOTES"
.PP
\fBgfmd\fRと\fBgfpcopy\fR
が距離的に離れている場合には、
\fBgfpcopy\fR
の動作が遅くなりま す。そのような場合には、\-j または \-J オプションに大きな値を指定すると、 性能が改善するかもしれません。
.SH "SEE ALSO"
.PP
\fBgfprep\fR(1),
\fBgfreg\fR(1),
\fBgfexport\fR(1),
\fBgfarm2.conf\fR(5)