---
name: "gfrep"
section: "1"
platform: "linux"
package: "gfarm-client"
version: "2.7.20+dfsg-1.2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gfrep"
---

# gfrep(1)

replicate Gfarm files

## 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.