GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PVM_JOINGROUP (3)

NAME

pvm_joingroup - Enrolls the calling process in a named group.

CONTENTS

Synopsis
Parameters
Description
Examples
Errors
See Also

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)
Search for    or go to Top of page |  Section 3 |  Main Index


JOINGROUP (3PVM) 30 August, 1993

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.