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.