KILL(3PVM)

💅 KILL — pvm_kill, bestie edition 💅

okay so this is pvm_kill from the PVM library, and it does exactly what it sounds like: it ends a process. respectfully. from a distance. 🫶

---

✨ NAME ✨

pvm_kill — Terminates a specified PVM process. that's it. that's the whole job. no cap. 💀

---

✨ SYNOPSIS ✨

C bestie:

int info = pvm_kill( int tid )

Fortran bestie:

call pvmfkill( tid, info )

---

✨ PARAMETERS ✨

• tid — the Integer task identifier of the PVM process you wanna kill. and NOT yourself, okay?? not yourself. we'll get to that. 🙈
• info — the Integer status code the routine hands back to you. anything less than zero means something went wrong. Values less than zero indicate an error.

---

✨ DESCRIPTION ✨

so basically, pvm_kill sends a terminate signal — that's SIGTERM — to whichever PVM process tid is pointing at. 🎯

now, plot twist for the multiprocessor girlies: when you're on multiprocessors, that terminate signal gets swapped out for a host dependent method of killing a process. so it's giving "we have our own way of doing this over here." ✨

if pvm_kill slays and everything goes right, info will be 0. and if some error occurs? then info will be < 0. simple as. 🎀

⚠️ okay this is the important one, listen up. pvm_kill is not designed to kill the calling process. it is not for you. it is not about you. do not use it on yourself.

so how do you kill yourself, you ask? bestie. 😭

• In C, call pvm_exit() followed by exit().
• In Fortran, call pvmfexit followed by stop.

that's the self-exit arc. main character energy, but make it graceful. 💅

---

✨ EXAMPLES ✨

C:

info = pvm_kill( tid );

Fortran:

CALL PVMFKILL( TID, INFO )

look at you go. iconic. ⭐

---

✨ ERRORS ✨

here are the error conditions that pvm_kill can hand back to you, no cap:

• PvmBadParam — you gave it an invalid tid value. bestie the tid was not tidding. 😭
• PvmSysErr — pvmd not responding. she's ghosting you. 💀

---

✨ SEE ALSO ✨

• pvm_exit(3PVM)
• pvm_halt(3PVM)

---

and that's the whole page, bestie!! this was PVM Version 3.4, dated 30 August, 1993 — yeah she's vintage, she's an icon, she's still serving 💖 thanks for reading, mwah, go terminate something responsibly 🎀✨🦋