SENDSIG(3PVM)

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

πŸ’Œ SENDSIG(3PVM) β€” sending signals to your PVM besties πŸ’–

okay so real talk, this is the PVM Version 3.4 manual page for pvm_sendsig, and it's lowkey one of those "with great power comes great responsibility" situations, so let's get into it 🫢


✨ NAME ✨

pvm_sendsig β€” Sends a signal to another PVM process. πŸ’…


🌸 SYNOPSIS 🌸

C    int info = pvm_sendsig( int tid, int signum )

Fortran   call pvmfsendsig( tid, signum, info )

πŸŽ€ PARAMETERS πŸŽ€

  • tid β€” Integer task identifier of PVM process to receive the signal. it's literally the address of who you're signalling, no cap.
  • signum β€” Integer signal number. the actual signal you're yeeting at them.
  • info β€” Integer status code returned by the routine. this is the receipts, bestie.

πŸ¦‹ DESCRIPTION πŸ¦‹

The routine pvm_sendsig sends the signal number signum to the PVM process identified by tid. If pvm_sendsig is successful, info will be 0. If some error occurs then info will be < 0. so like, zero is the slay outcome, negative is the "we don't talk about it" outcome 😭

⚠️ pvm_sendsig should only be used by programmers with Unix signal handling experience. not me gatekeeping but honestly bestie, this one is for the girlies who already know their way around a signal handler. Many library functions (and in fact the PVM library functions) cannot be called in a signal handler context because they do not mask signals or lock internal data structures. it's giving chaos if you get it wrong fr fr.
⚠️ Further caveat: the signal numbers passed between systems are not mapped β€” PVM assumes that signal 9 on one system is the same as on another. so if you're on some cross-platform situation, that assumption is just vibing there, unverified. πŸ’€

🌈 EXAMPLES 🌈

C:

tid = pvm_parent();
info = pvm_sendsig( tid, SIGKILL);

Fortran:

CALL PVMFBUFINFO( BUFID, BYTES, TYPE, TID, INFO );
CALL PVMFSENDSIG( TID, SIGNUM, INFO )

πŸ’œ ERRORS πŸ’œ

These error conditions can be returned by pvm_sendsig β€” the vibe check failures, if you will:

  • PvmSysErr β€” pvmd not responding. the daemon ghosted you, iconic but unhelpful πŸ™ˆ
  • PvmBadParam β€” giving an invalid tid value. you gave it a bad address, it's not gonna work, periodt.

πŸ‘‘ SEE ALSO πŸ‘‘

bestie... it's empty. there are genuinely no cross-references listed here. nothing. a whole section, zero entries. we respect the minimalist queen energy ✨


so yeah β€” that's pvm_sendsig from the PVM Version 3.4 manual, dated 30 August, 1993, and that footer is literally all it says: 30 August, 1993 and SENDSIG(3PVM). that's the whole page, we ate, no crumbs left πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from