DELHOSTS(3PVM)

💖 DELHOSTS(3PVM) — aka pvm_delhosts, the "bye bestie 👋" button for your virtual machine

okay so this is from the PVM Version 3.4 manual, and it's literally the routine that removes computers from your virtual machine. it's giving "block and delete" but for hosts. no cap. 🦋

---

✨ NAME ✨

pvm_delhosts — Deletes hosts from the virtual machine. bye felicia 💅

---

🌸 SYNOPSIS 🌸

C:

int info = pvm_delhosts( char **hosts, int nhost, int *infos )

Fortran:

call pvmfdelhost( host, info )

---

🎀 PARAMETERS 🎀

• hosts — An array of pointers to character strings containing the names of the machines to be deleted. so like, a whole lil squad of hostnames 👑
• nhost — Integer specifying the number of hosts to be deleted. yes bestie, you gotta tell it how many.
• infos — Integer array of length nhost which contains the status code returned by the routine for the individual hosts. Values less than zero indicate an error. so each host gets its own lil report card 🍓
• host — Character string containing the name of the machine to be deleted. (this one's the Fortran single-host version, one at a time, main character energy)
• info — Integer status code returned by the routine. Values less than nhost indicate partial failure, values less than 1 indicate total failure. 😭

---

💜 DESCRIPTION 💜

The routine pvm_delhosts deletes the computers pointed to in hosts from the existing configuration of computers making up the virtual machine. And listen — it is not subtle. All PVM processes and the pvmd running on these computers are killed as the computer is deleted. like, full ghosting. 💀

If pvm_delhosts is successful, info will be nhost. Partial success is indicated by 1 <= info < nhost, and total failure by info < 1. The array infos can be checked to determine which host caused the error. so if one of them is being messy, you can literally point at it. 🔍

The Fortran routine pvmfdelhost deletes a single host from the configuration with each call. one. at. a. time. no multitasking bestie 🧚

If a host fails, the PVM system will continue to function and will automatically delete this host from the virtual machine. An application can be notified of a host failure by calling pvm_notify. It is still the responsibility of the application developer to make his application tolerant of host failure. and that part is on YOU, not on PVM — don't forget it ✨

---

🌈 EXAMPLES 🌈

C:

static char *hosts[] = {
     "sparky",
     "thud.cs.utk.edu",
};
int status[2];
info = pvm_delhosts( hosts, 2, status );

Fortran:

CALL PVMFDELHOST( 'azure', INFO )

---

🔥 ERRORS 🔥

These error conditions can be returned by pvm_delhosts:

• PvmBadParam — giving an invalid argument value. bestie that input was not it 🙈
• PvmSysErr — local pvmd not responding. it's not answering your texts, lowkey a red flag 🚩

---

🦋 SEE ALSO 🦋

• pvm_addhosts(3PVM) — the add-bestie counterpart
• pvm_notify(3PVM) — so you actually find out when a host dips

---

okay so real talk: deleting a host kills every PVM process and the pvmd on it. that's not a soft launch, that's a full send. make sure that's what you want 💅

---

and that's the whole page, bestie!! this lil icon was documented way back on 30 August, 1993 (fr fr, ancient but still slaying) and it ships with PVM Version 3.4 — so when you're out here deleting hosts, just know the source and the date said so. periodt. 👑💖