SETRBUF(3PVM)

💖 SETRBUF 💖

okay bestie, welcome to SETRBUF(3PVM) — part of the PVM Version 3.4 era, and yes she's serving vintage 1993 realness the whole time. let's get into it 🎀

---

✨ NAME ✨

pvm_setrbuf — switches the active receive buffer and saves the previous buffer. literally it's the "hold my old buffer while i grab this new one" queen 👑

---

✨ SYNOPSIS ✨

C girlies:

int oldbuf = pvm_setrbuf( int bufid )

Fortran girlies:

call pvmfsetrbuf( bufid, oldbuf )

---

✨ PARAMETERS ✨

• bufid — an Integer that specifies the message buffer identifier for the new active receive buffer. the new main character 💅
• oldbuf — an Integer that returns the message buffer identifier for the previous active receive buffer. the one she left behind, saved for later 🥺

---

✨ DESCRIPTION ✨

so pvm_setrbuf switches the active receive buffer to bufid and saves the previous active receive buffer as oldbuf. the way that it just... swaps them. iconic behavior honestly.

and here's the tea: if bufid is set to 0, then the present active receive buffer is saved and no active receive buffer exists. periodt, she's empty, she's free, she's on a break 🌸

a successful receive automatically creates a new active receive buffer. so if a previous receive hasn't been unpacked yet and needs to be saved for later, you can save the previous bufid and reset it later to the active buffer for unpacking. no cap, that's the whole move 🫶

this routine is required when you're managing multiple message buffers — like, say, switching back and forth between two buffers. one buffer could be used to send information to a graphical interface while a second buffer could be used to send data to other tasks in the application. two buffers, two vibes, one girl managing it all 😤

---

✨ EXAMPLES ✨

C bestie:

rbuf1 = pvm_setrbuf( rbuf2 );

Fortran bestie:

CALL PVMFSETRBUF( NEWBUF, OLDBUF )

---

✨ ERRORS ✨

these error conditions can be returned by pvm_setrbuf — lowkey rude but highkey useful to know:

• PvmBadParam — you gave an invalid bufid. not the vibe, bestie 😭
• PvmNoSuchBuf — you tried to switch to a non-existent message buffer. it's giving ghosting a buffer that was never even there 💀

---

✨ SEE ALSO ✨

• pvm_setsbuf(3PVM) — her sister, go say hi 🌈

---

kisses, and remember: your buffers are yours, save them accordingly. this page was brought to you by PVM Version 3.4, dated 30 August, 1993 — a vintage drop, a timeless slay 👑💖