LVGROUP(3PVM)

💖 LVGROUP — like, the group-leaving one 💖

okay bestie so this is LVGROUP(3PVM), straight outta PVM Version 3.4 🦋 and it's genuinely one of the most relatable routines in the whole library tbh. it's giving "it's not you, it's the group chat."

---

✨ NAME ✨

pvm_lvgroup — unenrolls the calling process from a named group. yep. you're leaving. it's a whole thing. 💅

---

🌸 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 actually exist, bestie, don't be out here naming groups that aren't real. 🙈
• info — integer status code that the routine hands back to you. anything less than zero means something went wrong. no cap. 💀

---

💜 DESCRIPTION 💜

so pvm_lvgroup unenrolls the calling process from the group named group. that's the whole vibe. if there's an error, info will be negative — lowercase negative, like your mood when the group chat gets archived. 😭

now here's the tea you actually need: if a process leaves a group by calling either pvm_lvgroup or pvm_exit, and then later rejoins that same group, the process may be assigned a new instance number. and the old instance numbers? those get reassigned to processes calling pvm_joingroup. so like, the number you had? it's not yours anymore. someone else is living in it now. main character energy transferred. 👑

---

🌈 EXAMPLES 🌈

C:

info = pvm_lvgroup( "worker" );

Fortran:

CALL PVMFLVGROUP( 'group2', INFO )

---

🔥 ERRORS 🔥

these error conditions can be returned by pvm_lvgroup — yes, there are four, and yes, they're all a little dramatic:

• PvmSysErr — pvmd not responding. it's ghosting you. literally.
• PvmBadParam — you gave a NULL group name. bestie. that's not a name, that's a void. 🕳️
• PvmNoGroup — you gave a non-existent group name. that group is not real and never was.
• PvmNotInGroup — you're asking to leave a group you are not a member of. the audacity?? the confidence?? iconic honestly but no. 💅

---

🦋 SEE ALSO 🦋

• pvm_joingroup(3PVM) — the join one. the other half of the situationship. 🫶

---

and that's the page, bestie! ✨ written by the lovely folks behind PVM Version 3.4, dated 30 August, 1993 — which is ancient in internet years but the vibes are still immaculate. go forth and leave your groups. periodt. 💖🎀🌸