LVGROUP(3PVM)

💖 LVGROUP — leaving the group chat (but make it PVM) 💖

okay bestie, so this is pvm_lvgroup from PVM Version 3.4, manual page LVGROUP(3PVM). Short version: it's the "i'm leaving the group chat" button, but for a PVM named group. no drama, just ✨departure✨.

---

🌸 NAME 🌸

pvm_lvgroup — unenrolls the calling process from a named group. that's it, that's the whole job. it's giving "peace out, i'm out of here" 🦋

---

✨ SYNOPSIS ✨

C girlies:

int info = pvm_lvgroup( char *group )

Fortran girlies:

call pvmflvgroup( group, info )

---

🎀 PARAMETERS 🎀

• group — a character string, the group name of an existing group. like, it has to already exist, okay? don't be out here making up groups 💅
• info — the integer status code the routine hands back to you. if it's less than zero, that's a big yikes, something went wrong. negative = error, periodt.

---

💜 DESCRIPTION 💜

So pvm_lvgroup unenrolls the calling process from the group named group. that's the whole vibe. and if there's an error, info will be negative — like, the routine will literally tell you it's upset.

Now here's the tea, and it's important tea 🫖: if a process leaves a group by calling either pvm_lvgroup or pvm_exit, and then later rejoins the same group, the process may be assigned a new instance number. and the old instance numbers? yeah, those get reassigned to processes calling pvm_joingroup. so don't get attached to your instance number bestie, it's not forever. 🙈

---

🌈 EXAMPLES 🌈

C:

info = pvm_lvgroup( "worker" );

Fortran:

CALL PVMFLVGROUP( 'group2', INFO )

look at her go, so iconic 👑

---

💀 ERRORS 💀

here's the hall of shame — the error conditions pvm_lvgroup can return. if you see any of these, that's not a slay, that's a cry 😭

• PvmSysErr — pvmd not responding. the daemon ghosted you fr fr 💀
• PvmBadParam — you gave a NULL group name. not the move bestie, that's giving nothing to work with.
• PvmNoGroup — you gave a non-existent group name. that group is not real, it never was 🌸
• PvmNotInGroup — you're asking to leave a group you're not even a member of. main character energy but in the wrong way 💅

---

🔥 SEE ALSO 🔥

• pvm_joingroup(3PVM) — the opposite of this whole page. the "hiii can i join 👋" one.

---

and that's the whole manual, bestie!! written 30 August, 1993 in PVM Version 3.4 — old but still lowkey serving ✨ go forth and leave your groups responsibly 🫶💖