gfrun(1) [debian man page]

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)

Check Out this Related Man Page

GFS_PIO_SET_VIEW_INDEX(3)												 GFS_PIO_SET_VIEW_INDEX(3)

NAME

       gfs_pio_set_view_index - change file view to an individual fragment

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_pio_set_view_index (GFS_File gf, int fragment_number, int fragment_index, char *host, int flags);

DESCRIPTION

       gfs_pio_set_view_index()  changes  the  process's  view	of  the  data  in the file specified by gf to a file fragment with the index frag-
       ment_index.

       When creating a new file, it is necessary to specify the total number of file fragments fragment_number.   Every  parallel  process  should
       specify the same fragment_number for the corresponding file.  When the file exists, GFARM_FILE_DONTCARE can be specified.  If fragment_num-
       ber is different from the total fragment number of the existent file, it is erroneous.

       host is used for explicitly specifying a filesystem node.  If host is NULL, appropriate filesystem node is chosen.

       Values of flag are constructed by a bitwise-inclusive-OR of the following list.

       GFARM_FILE_SEQUENTIAL
	      File will be accessed sequentially.

       GFARM_FILE_REPLICATE
	      File may be replicated to a local filesystem when accessing remotely.  This flag cannot be specified with GFARM_FILE_NOT_REPLICATE.

       GFARM_FILE_NOT_REPLICATE
	      File may not be replicated to a local filesystem when accessing remotely.  This flag cannot be specified with GFARM_FILE_REPLICATE.

       By default, Gfarm files are accessed as a whole file in global file view where each fragment can be seamlessly accessed.

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

       GFARM_ERR_OPERATION_NOT_PERMITTED
	      The file is not a regular fragmented file.

       GFARM_ERR_FRAGMENT_NUMBER_DOES_NOT_MATCH
	      The total number of file fragments is different from the existence one.

       GFARM_ERR_INVALID_ARGUMENT
	      Invalid arguments are specified, for instance, GFARM_FILE_DONTCARE is specified as the total number of fragments of a newly  created
	      file.

       Others An error except the above occurred.  The reason is shown by its pointed strings.

SEE ALSO

       gfs_pio_create(3), gfs_pio_open(3), gfs_pio_set_view_local(3)

Gfarm								 06 September 2005					 GFS_PIO_SET_VIEW_INDEX(3)

Linux and UNIX Man Pages

gfrun(1) [debian man page]

Check Out this Related Man Page