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

FreeBSD Manual Pages

  
 
  

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

NAME
       pvm_getinst - Returns the instance number in a group of a PVM process.

SYNOPSIS
       C    int	inum = pvm_getinst( char *group, int tid )

       Fortran	 call pvmfgetinst( group, tid, inum )

PARAMETERS
       group   Character string	group name of an existing group.

       tid     Integer task identifier of a PVM	process.

       inum    Integer instance	number returned	by the routine.	 Instance num-
	       bers start at 0 and count up.  Values less than	zero  indicate
	       an error.

DESCRIPTION
       The routine pvm_getinst takes a group name group	and a PVM task identi-
       fier tid	and returns the	unique instance	number that corresponds	to the
       input.	It  can	be called by any task whether in the group or not.  If
       pvm_getinst is successful, inum will be >= 0.   If  some	 error	occurs
       then inum will be < 0.

EXAMPLES
       C:
	    inum = pvm_getinst(	"worker", pvm_mytid() );
	    --------
	    inum = pvm_getinst(	"worker", tid[i] );

       Fortran:
	    CALL PVMFGETINST( 'GROUP3',	TID, INUM )

ERRORS
       These error conditions can be returned by pvm_getinst

       PvmSysErr
	      pvmd was not started or has crashed.

       PvmBadParam
	      giving an	invalid	tid value.

       PvmNoGroup
	      giving a non-existent group name.

       PvmNotInGroup
	      specifying a group in which the tid is not a member.

SEE ALSO
       pvm_joingroup(3PVM), pvm_gettid(3PVM)

				30 August, 1993			 GETINST(3PVM)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | EXAMPLES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pvm_getinst&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help