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

FreeBSD Manual Pages

  
 
  

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

NAME
       pvm_joingroup - Enrolls the calling process in a	named group.

SYNOPSIS
       C    int	inum = pvm_joingroup( char *group )

       Fortran	 call pvmfjoingroup( group, inum )

PARAMETERS
       group   Character string	group name of an existing group.

       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_joingroup enrolls the calling task in the  group	 named
       group  and returns the instance number inum of this task	in this	group.
       If there	is an error inum will be negative.

       Instance	numbers	start at 0 and count up.  When using groups a  (group,
       inum)  pair uniquely identifies a PVM process.  This is consistent with
       the PVM 2.4 naming schemes.  If	a  task	 leaves	 a  group  by  calling
       pvm_lvgroup  and	 later rejoins the same	group, the task	is not guaran-
       teed to get the same instance number.  PVM attempts to  reuse  old  in-
       stance  numbers,	 so  when  a task joins	a group	it will	get the	lowest
       available instance number.  A task can be a member of  multiple	groups
       simultaneously.

EXAMPLES
       C:
	    inum = pvm_joingroup( "worker" );

       Fortran:
	    CALL PVMFJOINGROUP(	'group2', INUM )

ERRORS
       These error conditions can be returned by pvm_joingroup

       PvmSysErr
	      pvmd was not started or has crashed.

       PvmBadParam
	      giving a NULL group name.

       PvmDupGroup
	      trying to	join a group you are already in.

SEE ALSO
       pvm_lvgroup(3PVM)

				30 August, 1993		       JOINGROUP(3PVM)

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

home | help