Man Linux: Main Page and Category List

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.