Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
TASKS(3PVM)			 PVM Version 3.4		     TASKS(3PVM)

NAME
     pvm_tasks	- Returns information about the tasks running on the virtual ma-
     chine.

SYNOPSIS
     C	  int info = pvm_tasks( int where, int *ntask, struct pvmtaskinfo **taskp )

	  struct pvmtaskinfo {
	  int ti_tid;
	  int ti_ptid;
	  int ti_host;
	  int ti_flag;
	  char *ti_a_out;
	  } taskp;

     Fortran   call pvmftasks( where, ntask, tid, ptid, dtid, flag, aout, info )

PARAMETERS
     where   Integer specifying what tasks to return information about.  The op-
	     tions are:

		     0	    for all the tasks on the virtual machine
		  pvmd tid  for all tasks on a given host
		    tid     for a specific task

     ntask   Integer returning the number of tasks being reported on.

     taskp   Returns pointer to an array of structures which contain information
	     about each task including its task ID, parent tid,  pvmd  task  ID,
	     status flag, and the name of this task's executable file.	The sta-
	     tus  flag	values are: waiting for a message, waiting for the pvmd,
	     and running.

     tid     Integer returning task ID of one task

     ptid    Integer returning parent task ID

     dtid    Integer returning pvmd task ID of host task is on.

     flag    Integer returning status of task

     aout    Character string returning the  name  of  spawned	task.	Manually
	     started tasks return blank.

     info    Integer status code returned by the routine.  Values less than zero
	     indicate an error.

DESCRIPTION
     The  routine pvm_tasks returns information about tasks presently running on
     the virtual machine.  The information returned is the same as  that  avail-
     able from the console command ps.	The C function returns information about
     the entire virtual machine in one call. The Fortran function returns infor-
     mation  about one task per call and cycles through all the tasks.	Thus, if
     where = 0, and pvmftasks is called ntask times, all tasks	will  be  repre-
     sented.

     Note  that  in  Fortran the reported value of ntask and the set of tasks do
     not change until the function resets at the end of a complete  cycle.   The
     user can reset pvmftasks() at any time by calling it with ntask = -1.

     If pvm_tasks is successful, info will be 0.  If some error occurs then info
     will be < 0.

EXAMPLES
     C:
	  struct pvmtaskinfo *taskp;
	  int i, ntask;

	  info = pvm_tasks( 0, &ntask, &taskp );
	  for (i = 0; i < ntask; i++)
		    printf("t%x\n", taskp[i].ti_tid);
     Fortran:
	  Do i=1, NTASK
	      CALL PVMFTASKS( DTID, NTASK, TID(i), PTID(i), DTID(i),
	  &		     FLAG(i), AOUT(i), INFO )
	  EndDo

ERRORS
     The following error condition can be returned by pvm_tasks

     PvmBadParam
	    invalid value for where argument.

     PvmSysErr
	    pvmd not responding.

     PvmNoHost
	    specified host not in virtual machine.

SEE ALSO
     pvm_config(3PVM), pvm_tidtohost(3PVM)

				 31 August, 1994		     TASKS(3PVM)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pvm_tasks&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help