GETINST(3PVM)

✨ NAME ✨

okay bestie, gather round — this is the GETINST(3PVM) page, and the star is 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 numbers start at 0 and count up. Values less than zero indicate an error. 🚨

🌸 DESCRIPTION 🌸

So like, pvm_getinst takes a group name group and a PVM task identifier 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. No gatekeeping, periodt. 💅

If pvm_getinst is successful, inum will be >= 0. If some error occurs then inum will be < 0. Vibe check: negative means something went wrong. 😭

✨ 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)

---

that's the whole page, bestie 🫶 this cutie is from PVM Version 3.4, dated 30 August, 1993, and it's the GETINST(3PVM) manual page. slay, bye! 💖✨