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 scheduling 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)