gfrm(1) [debian man page]

GFRM(1) 																   GFRM(1)

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 sec-
	      tion 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 spec-
	      ified 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)

GFRUN(1)																  GFRUN(1)

NAME

       gfrun, gfrsh, gfssh - run Gfarm parallel programs

SYNOPSIS

       gfrun [ options ] command arg ...

       gfrsh [ options ] command arg ...

       gfssh [ options ] command arg ...

DESCRIPTION

       gfrun executes a parallel command on filesystem nodes, which is determined by the -G option, the -H option, or the -N option.

       The  -G	option	specifies the gfarm-URL, which will be used by file-affinity scheduling.  In this case, gfrun schedules the same number of
       filesystem nodes as the number of Gfarm fragments, taking into consideration the physical locations of each fragment replica of	the  Gfarm
       file, and filesystem node status.  The -H option specifies the hostfile that lists filesystem nodes.  The -N option specifies the number of
       filesystem nodes.

       The -G, -H, and -N options are exclusive.  When none of the -G, -H, or -N options are specified, gfrun schedules filesystem nodes by  file-
       affinity  scheduling  using the first existent Gfarm file in the argument list, args.  If there are no existent Gfarm files in the argument
       list, an appropriate filesystem node is selected to be executed.

       gfrsh and gfssh utilize rsh and ssh, respectively, instead of gfrcmd.

       A command can be specified by a gfarm-URL that is registered using gfreg(1).

OPTIONS

       -G gfarm-URL
	      Specifies a Gfarm file gfarm-URL for file-affinity scheduling.  Please read the DESCRIPTION section about how file-affinity schedul-
	      ing works.

       -H hostfile
	      Specifies a hostfile that lists filesystem nodes.

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

       -N np  Specifies the number of nodes, np, which are selected in the increasing order of load average.

       -r     Specifies an on-demand replication mode.	In this mode, every file will be replicated before it is accessed remotely.

       -o gfarm-URL
	      Specifies a Gfarm file that the standard output of the executed program will be redirected to.

       -e gfarm-URL
	      Specifies a Gfarm file that the standard error of the executed program will be redirected to.

       -I fragment-index
	      Specifies  a Gfarm fragment index executed by the gfrun command.	This option is available only when either file-affinity scheduling
	      is selected by the -G option or a gfarm file in the argument list, or the -N option is specified.

       -v     Displays error message verbosely.

       -p     Displays the elapsed time of each Gfarm parallel I/O API after the program terminates.

       -g     Explicitly specifies that the command is a Gfarm program.  Gfarm specific options will be passed to the command as the result.

       -u     Explicitly specifies that the command is an ordinary program, and does not take Gfarm specific options.

       -b     Specifies global file view as the default file view for programs linked with the Gfarm syscall-hooking library.  If this	option	is
	      not specified, the default is local file view.

       -?     Displays a list of command options.

ENVIRONMENT VARIABLES

       GFRUN_CMD
	      Specifies a remote shell command.  If globus-job-run is specified, gfrun executes each process using globus-job-run.

SEE ALSO

       gfmpirun_p4(1)

Gfarm								 13 November 2006							  GFRUN(1)