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 numbers
	     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	guaranteed  to	get  the
     same  instance number.  PVM attempts to reuse old instance 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=pvmfjoingrp&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help