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.

Gfarm                                           13 November 2006                                         GFRM(1)