BUFINFO(3PVM)

💖 BUFINFO(3PVM) — or, how to snoop on your message buffers (lovingly) 💖

okay bestie, so this is a page from PVM Version 3.4, and it's all about pvm_bufinfo(). no cap, it's lowkey one of the most useful little gremlins in the whole PVM toolbox. let's get into it 🫶

---

✨ NAME ✨

pvm_bufinfo() — returns information about a message buffer. it's giving detective energy, fr fr 🔍

---

✨ SYNOPSIS ✨

C    int info = pvm_bufinfo( int bufid, int *bytes, int *msgtag,
int *tid )

Fortran   call pvmfbufinfo( bufid, bytes, msgtag, tid, info )

---

✨ PARAMETERS ✨

• bufid — an Integer that says which message buffer identifier we're talking about. it's the specific one, the main character 👑
• bytes — an Integer that comes back with the length in bytes of the body of the message. heads up though: this equals the actual size of the data packed if PvmDataRaw is used — otherwise it may include pad bytes. so like, don't be shocked if it's a lil extra 💅
• msgtag — an Integer returning the message label. this one's your bestie when the message was received with a wildcard msgtag 🌸
• tid — an Integer returning the source of the message. same deal — absolute lifesaver when the message was received with a wildcard tid 🦋
• info — the Integer status code the routine hands back. anything less than zero means error, so if you see that, it's not slaying 😭

---

✨ DESCRIPTION ✨

so, pvm_bufinfo returns information about the requested message buffer. typically you use it to figure out facts about the last received message — like its size, or where it came from. and honestly? pvm_bufinfo is especially useful when your application is set up to receive any incoming message, and whatever it does next depends on the source tid and the msgtag attached to whichever message shows up first. it's like reading the vibe check before you decide how to act 💅

if pvm_bufinfo is successful, info will be 0. if some error occurs then info will be < 0. periodt.

---

✨ EXAMPLES ✨

C:

bufid = pvm_recv( -1, -1 );
info = pvm_bufinfo( bufid, &bytes, &type, &source );

Fortran:

CALL PVMFRECV( -1, -1, BUFID )
CALL PVMFBUFINFO( BUFID, BYTES, TYPE, SOURCE, INFO )

---

✨ ERRORS ✨

this error condition can be returned by pvm_bufinfo:

• PvmNoSuchBuf — specified buffer does not exist. it's gone, babe, nowhere to be found 🙈
• PvmBadParam — invalid argument. ngl that one's on you 💀

---

✨ SEE ALSO ✨

pvm_recv(3PVM)

---

okay that's the whole page, no skips, no crumbs left behind 🍓

and that's a wrap, bestie — this one's from PVM Version 3.4, dated 30 August, 1993, and it ate, fr fr. go forth and inspect those buffers 💖✨🎀