EXPORT(3PVM)

💖 EXPORT — pvm_export, pvm_unexport 💖

okay bestie, welcome to EXPORT(3PVM), a little corner of the PVM manuals where we mark environment variables so they get shipped out through spawn. yes, that spawn. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

pvm_export, pvm_unexport — mark environment variables to export through spawn

---

🌸 SYNOPSIS 🌸

so here's the whole vibe, in C:

int cc = pvm_export( char *name )
int cc = pvm_unexport( char *name )

and in Fortran?

Not available

yeah. Fortran said "not me" 💀 it's just not a thing here, no cap.

---

🎀 PARAMETERS 🎀

• name — the name of an environment variable you wanna add to (or delete from) the export list. that's the whole job. one little string, so much power 👑

---

🦋 DESCRIPTION 🦋

okay so the tea: pvm_export and pvm_unexport exist purely for convenience — they're your little helpers for editing the environment variable PVM_EXPORT, and they do it while keeping the colon-separated list syntax it requires. like, the syntax stays correct, always, no messy hand-editing, periodt.

and here's the important part: the variable can also be modified by other means, and at the same time as the pvm_export functions are doing their thing. so like, share the sandbox, besties 🤝

now for the behaviours that make this so chill:

• pvm_export checks whether a name is already in PVM_EXPORT before it includes it — so no dupes sneaking in. and exporting a name more than once? not considered an error. it's giving unbothered ✨
• pvm_unexport is equally chill — it will not complain if you hand it a name that isn't in PVM_EXPORT. no drama, no error, just vibes 🦋

---

🌈 EXAMPLES 🌈

here's the C one, in all its glory:

/* PVM_EXPORT=SHELL:HOME */
pvm_export("DISPLAY");
pvm_export("TERM");
pvm_unexport("HOME");
/* PVM_EXPORT=SHELL:DISPLAY:TERM */

see how it started as SHELL:HOME, we added DISPLAY and TERM, yeeted HOME, and landed on SHELL:DISPLAY:TERM? character development 💅 literally the glow-up arc of an env var.

---

💀 ERRORS 💀

bestie, listen — no error conditions are currently returned by pvm_export and pvm_unexport. none. zero. nothing to handle. you can relax 😌

---

💜 SEE ALSO 💜

• pvm(1PVM)
• pvm_spawn(3PVM)

---

that's the page, bestie 🎀 this was EXPORT(3PVM) from the PVM crew, dated 15 May, 1996 — yeah, it's vintage, and it still ate 🔥 go export something iconic. mwah 💖