gfrm

Name

gfrm -- remove Gfarm files, directories, or file replicas

Synopsis

gfrm [-frRnqv] [-I file-section] [-h filesystem-node] [-D domain-name] [-H hostfile] [-N num-of-replicas] [-j num-of-threads] gfarm-URL...

DESCRIPTION

gfrm removes each specified file. It does not remove directories unless the -r or -R option is specified. '.' or '..' cannot be removed.

When the -I option is specified, gfrm removes the specified file section. File section is an architecture name for executable files, or a fragment index for a regular file.

With the -h, -D, or -H option, gfrm removes file replicas of each specified file or file section on the specified filesystem node(s). All file replicas of a file cannot be removed, unless the -f option is specified.

OPTIONS

-f

Even when all file replicas are specified by the -h, -D, or -H option, forcibly deletes all the file replica. In this case, the specified file will be deleted.

-j num-of-threads

Specifies the number of threads to delete file replicas simultaneously. This option is only available when gfrm is compiled by an OpenMP C compiler.

-n

Prints file names to be deleted, but does not delete them.

-q

Does not print any verbose message.

-r, -R

Removes all entries under the directories specified by the command-line argument recursively.

-v

Prints verbose messages.

-h filesystem-node

Specifies a filesystem node from which file replicas will be removed. With the -I option, a file replica of the specified file section will be removed.

-D domain-name

Specifies a domain name of filesystem nodes on which file replicas will be removed. With the -I option, a file replica of the specified file section will be removed.

-H hostfile

Specifies a hostfile that lists filesystem nodes on which file replicas will be removed. With the -I option, a file replica of the specified file section will be removed.

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

-I file-section

Specifies the file section to be removed. File section is an architecture name, such as sparc-sun-solaris8, for executable files, and a fragment index for regular files.

-N num-of-replicas

Specifies the maximum number of file replicas. If files has more number of file replicas than specified, reduce the number of file replicas.

-?

Displays a list of command options.