EXPORT(3PVM)

πŸ“¦ version 3.4.6, in debian bookworm, ubuntu jammy

πŸ’– pvm_export, pvm_unexport β€” the environment variable export besties πŸ’–

okay so this is the EXPORT(3PVM) page, aka the corner of the PVM manual where we learn how to mark environment variables so they ride along through spawn. yes bestie, we're doing env var plumbing and it's lowkey iconic πŸŽ€


✨ NAME ✨

pvm_export, pvm_unexport β€” mark environment variables to export through spawn πŸ¦‹


✨ SYNOPSIS ✨

C

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

Fortran

Not available 😭 (fr, the Fortran girlies are not getting this one)


✨ PARAMETERS ✨

  • name β€” the name of an environment variable you wanna add to, or delete from, the export list πŸ’…

✨ DESCRIPTION ✨

so pvm_export and pvm_unexport exist purely for convenience, bestie β€” they're here to help you edit the environment variable PVM_EXPORT while keeping the colon-separated list syntax it requires intact. no cap, that colon syntax is the whole vibe and we are NOT breaking it πŸ™ˆ

and here's the thing: the variable can still be modified by other means, and at the same time by the pvm_export functions. so yeah, it's a shared situation, everyone's editing the same list, it's giving group project but like, in a good way ✨

pvm_export checks whether a name is already in PVM_EXPORT before it includes it, so exporting a name more than once is not considered an error. no drama, no complaints πŸ’–

likewise, pvm_unexport will not complain if you specify a name that isn't in PVM_EXPORT. she's chill like that 🫢


✨ EXAMPLES ✨

C:

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

look at her go. HOME said bye, DISPLAY and TERM said hi, and the colon list stayed perfectly formatted the entire time. slay πŸ’…βœ¨


✨ ERRORS ✨

No error conditions are currently returned by pvm_export and pvm_unexport. that's right, zero error conditions β€” she simply does not miss πŸ”₯


✨ SEE ALSO ✨

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

and that's the whole page bestie, we ate and left no crumbs πŸ‘‘

this little gem comes from the 15 May, 1996 era of the PVM manual β€” the EXPORT(3PVM) page, in all her retro glory. ancient? yes. still useful? also yes πŸ’€πŸ’–

πŸ“¦ where this page comes from