NAME

       gfrep - replicate Gfarm files

SYNOPSIS

       gfrep  [  -mnqvx  ]  [  -S  source-domainname ] [ -D destination-domainname ] [ -h source-
       hostfile ] [ -H destination-hostfile ] [ -N num-of-replicas ] [ -j num-of-threads  ]  path
       ...

DESCRIPTION

       gfrep  creates  specified  number  of  replicas  of  Gfarm  files specified by the path to
       specified set of destination hosts.  When set of source hosts are  specified,  only  files
       stored  on  the  set of source hosts are replicated.  A set of hosts can be specified by a
       domain name and/or a host file.  When both a domain name and a host file are specified,  a
       set of hosts is determined by both conditions.

       If  the  path  parameter  is  a  directory,  files  under  the  directory  will  be copied
       recursively.

OPTIONS

       -S source-domainname
              Specifies the domain name of source filesystem nodes from which  replicas  will  be
              copied.

       -D destination-domainname
              Specifies the domain name of destination filesystem nodes to which replicas will be
              copied.

              If neither this nor the -H option is specified,  replicas  may  be  copied  to  any
              available host.

       -h source-hostfile
              Specifies  a  file  which describes hostnames of source filesystem nodes from which
              the replica will be made.  The source-hostfile consists of a filesystem  node  name
              on each line.

              if ``-'' is specified, standard input is used to read the host list.

       -H destination-hostfile
              Specifies a file which describes hostnames of destination filesystem nodes on which
              the replica will be made.  The destination-hostfile consists of a  filesystem  node
              name on each line.

              if ``-'' is specified, standard input is used to read the host list.

       -N num-of-replicas
              Specifies the required number of file replicas, counting already existing ones.  If
              there are a sufficient number of replicas in the  destination  hosts,  neither  any
              copying nor any removal will be done.

              If this option is not specified, -N 1 is assumed.

       -j num-of-threads
              Specifies  the  number  of  threads  to  create file replicas simultaneously.  This
              option is only available when compiled by an OpenMP C  compiler.   By  default,  it
              will  be  the smallest among the number of total files, the number of source hosts,
              and the number of destination hosts.

       -m     Lets gfrep command do a migrate/move, instead of doing replication.

       -x     Removes file replicas when a set of destination nodes has more file  replicas  than
              specified.

       -n     Displays files to be replicated, but does nothing.

       -q     Suppresses non-error messages.

       -v     Displays verbose output.

       -?     Displays a list of command options.

BUGS

       A source host is not always selected within a set of source hosts.