Scroll to navigation

GFNCOPY(1) Gfarm GFNCOPY(1)

NAME

gfncopy - Manipulate number of file replicas automatically created

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

gfncopy manipulates the number of file replicas automatically created. When no option is specified, it displays the specified number of file replicas. When replication attributes of both NCOPY and REPATTR are set to a file, these attributes are displayed in two lines. With the -v option, it also displays path names up to the ancient directory that specifies the number of file repilcas.

OPTIONS

-s NCOPY
specifies the attribute for automatic replication represented by the number of file replicas to a file or directory.
-S REPATTR
specifies the attribute for automatic replication represented by host groups to a file or directory.
a REPATTR is represented by the following BNF:
    <repattr> ::= <an_attr> | <an_attr> ',' <repattr>
    <an_attr> ::= <host_group> ':' <num_rep>
    <host_group> ::= <string>
    <num_rep> ::= <integer>
e.g.) group0:2 group0:1,group1:2,group2:3
-C
If the replication attribute exists already on the file, gfncopy with the -s or -S options fails.
-M
If the replication attribute does not exist on the file, gfncopy with the -s or -S options fails.
-r
removes the specified replication attributes.
The path can be specified multiple times.
-c
displays the number of file repicas the file really has.
-w
checks whether or not the file replicas have been created according to the replication attributes (NCOPY or REPATTR), otherwise waits for the completion of the replication.
The path can be specified multiple times.
If the path is a directory, files in subdirectories are checked.
-t TIMEOUT
specifies the time in seconds for the -w option to wait until automatic replication starts. Timeout does not occur while the replication is running. Default is 30 seconds.
-h
processes symbolic link instead of any referenced files.
-v
displays verbose messages.
-?
displays a list of command options.

SEE ALSO

gfhostgroup(1)
18 Jul 2013 Gfarm