START_PVMD(3PVM)

💖 START_PVMD(3PVM) — bestie's guide to starting a whole new PVM daemon 💖

okay so this page is START_PVMD(3PVM) from PVM Version 3.4, and it's literally about birthing a whole new virtual machine. no cap, this is main character energy for your cluster. let's get into it 🦋

---

✨ NAME ✨

pvm_start_pvmd — starts a new PVM daemon. that's it, that's the vibe. 💅

---

🌸 SYNOPSIS 🌸

C girlies:

int info = pvm_start_pvmd( int argc, char **argv, int block )

Fortran besties:

call pvmfstartpvmd( args, block, info )

---

🎀 PARAMETERS 🎀

• argc — how many arguments live in argv. the headcount, basically.
• argv — an array of arguments to the executable. the receipts. 🧾
• args — a character string containing the arguments to the executable.
• args — a character string containing the arguments to the executable. (yes bestie it's listed twice in the original, not me editing, i promise, we keep it 100 💀)
• block — an integer saying whether to block until startup of all hosts is complete, or just return immediately. like, do we wait for the group chat to finish typing or do we leave them on read? 👀
• info — an integer that returns the error code.

---

💜 DESCRIPTION 💜

pvm_start_pvmd starts up a pvmd3 process — and that's the master of a new virtual machine, so it's giving CEO energy fr fr. 👑

It returns as soon as the pvmd is started and ready for work. but here's the tea: if the block parameter is nonzero and a hostfile is passed to the pvmd as a parameter, it returns when all hosts marked to start have been added. so patience, bestie. pvm_start_pvmd returns zero on success. 🫶

If PVM is compiled to allow running more than one pvmd per host, a task calling pvm_start_pvmd before any other pvm functions will connect to the pvmd that it starts. and pvm_start_pvmd sets the environment variable PVMSOCK to the address printed by the pvmd as it starts up. iconic. ✨

---

🌈 EXAMPLES 🌈

C:

static char *argv[] = {
    "-d41",
    "/u/jones/pvmd_hosts",
};
argc = 2
info = pvm_start_pvmd( argc, argv, block );

Fortran:

CALL PVMFSTART_PVMD( '-d41 /u/jones/pvmd_hosts', BLOCK, INFO )

---

🌈 EXAMPLES 🌈

(and yeah, the original shows these twice. we don't skip. we don't summarize. we deliver. 💅)

C:

static char *argv[] = {
    "-d41",
    "/u/jones/pvmd_hosts",
};
argc = 2
info = pvm_start_pvmd( argc, argv, block );

Fortran:

CALL PVMFSTART_PVMD( '-d41 /u/jones/pvmd_hosts', BLOCK, INFO )

---

💀 ERRORS 💀

the following error conditions can be returned — read them, memorize them, manifest the good ones:

• PvmDupHost — a pvmd is already running. bestie you cannot start a second one, it's taken, it's in a relationship. 🙈
• PvmSysErr — the local pvmd is not responding. it's ghosting you. 😭

---

🦋 SEE ALSO 🦋

• pvm_addhosts(3PVM)
• pvmd3(1PVM)
• pvmd3(1PVM) — (again, on purpose, the original said it twice and we respect the source 🫶)

---

and that's the whole page, no crumbs left behind. sending you off with love from the PVM Version 3.4 girlies, dated 11 December, 1995 — stay slaying, stay blocking, and may your PVMSOCK always be set correctly. periodt. 💖✨🎀