NAME

       gfncopy - 自動ファイル複製作成数を操作する。

SYNOPSIS

       gfncopy [-vh] path

       gfncopy [-vh] [-C | -M] -s NCOPY path

       gfncopy [-vh] [-C | -M] -S REPATTR path

       gfncopy [-vh] -r path [path...]

       gfncopy [-vh] -c path

       gfncopy [-v] -w [-t TIMEOUT] path [path...]

DESCRIPTION

       pathに指定したファイルないしディレクトリに関する自動ファイル複製作成数を操作します。 オプ
       ションを指定しない場合は、設定された自動複製作成数を表示します。 総自動複製作成数(NCOPY)と
       ホストグループごとの自動複製作成数(REPATTR)の両方が指定されていたら、 それぞれの値を2行で
       表示します。 -vオプションを指定すると、自動複製作成数を設定している先祖のディレクトリまで
       のパス名も含めて表示します。

OPTIONS

       -s NCOPY
           ファイルまたはディレクトリに、自動複製作成数を設定します。 NCOPYはgfarm.ncopy拡張属性
           に格納されます。

       -S REPATTR
           ファイルまたはディレクトリに、ホストグループごとの自動複製作成数を設定します。

           NCOPYとREPATTRの両方が設定されている場合、 REPATTRに設定された複製数の合計NがNCOPYより
           も大きければ、最低でもN個の複製が作成されます。 そうでなければ、REPATTR従って複製を作
           成し、 さらに、複製数の合計がNCOPYになるように複製を作成します。
           REPATTRはgfarm.replicainfo拡張属性に格納されます。

           REPATTR の形式を以下の BNF で示します。

                   <repattr> ::= <an_attr> | <an_attr> ',' <repattr>
                   <an_attr> ::= <host_group> ':' <num_rep>
                   <host_group> ::= <string>
                   <num_rep> ::= <integer>

                 例)
                   group0:2
                   group0:1,group1:2,group2:3

       -C
           既に自動複製作成数が設定されている場合に、 gfncopy の -s または -S オプションは失敗し
           ます。

       -M
           自動複製作成数が設定されていない場合に、 gfncopy の -s または -S オプションは失敗しま
           す。

       -r
           自動複製作成数の設定を消去します。 複数個のpathを指定できます。

       -c
           実際のファイル複製数を表示します。

       -w
           設定に従った個数の複製が作成されているかどうか確認し、複製作成中であれば、複製作成が完
           了するまで待ちます。 複数個のpathを指定できます。 pathにディレクトリを指定すれば、その
           ディレクトリ以下すべてのファイルを確認します。

       -t TIMEOUT
           -wオプション使用時に、設定に従った個数の複製が作成開始されるまで待つ時間を秒で指定しま
           す。 複製作成中であればタイムアウトしません。デフォルトは30秒です。

       -h
           シンボリックリンクを辿らないようにします。

       -v
           詳細なメッセージを表示します。

       -?
           引数オプションを表示します。

SEE ALSO

       gfhostgroup(1), gfarm_attr(5)