HOSTSYNC(3PVM)

💖 HOSTSYNC(3PVM) 💖

okay bestie, sit down, hydrate, and let me tell you about pvm_hostsync from PVM Version 3.4 — it's the lil function that slides into a host's DMs and asks "hey babe what time is it" 🕐✨

---

✨ NAME ✨

pvm_hostsync — get the time-of-day clock from a PVM host 🎀 like literally just clock girlie things

---

🌸 SYNOPSIS 🌸

C girlies, include this first, no exceptions:

#include <sys/time.h>
int info = pvm_hostsync( int host, struct timeval *clk,
     struct timeval *delta )

Fortran girlies, you get this instead:

call pvmfhostsync( host, clksec, clkusec, deltasec, deltausec, info )

---

🦋 PARAMETERS 🦋

• host — the TID of the host. that's the whole vibe, it's just which host we're talking to 💅
• clk (or clksec and clkusec) — returns a time-of-day clock sample grabbed straight from that host ⏰
• delta (or deltasec and deltausec) — returns the difference between your local clock and the remote host's clock, iykyk 👀

---

👑 DESCRIPTION 👑

pvm_hostsync samples the time-of-day clock of a host in the virtual machine, and hands you back both the clock value and the difference between the local and remote clocks. two for one, we love to see it 🫶

to reduce the delta error caused by message transit time, local clock samples are taken before and after reading the remote clock. Delta is the difference between the mean local clocks and the remote clock. math queen behavior, honestly 🧚

⚠️ heads up bestie: the delta time can be negative! the microseconds field is always normalized to 0..999999, while the sign of the seconds field gives the sign of the delta. for example:

3.25 Sec =  3,250000
0        =  0,0
-1 uSec  = -1,999999
-1 Sec   = -1,000000
-1.1 Sec = -2,999000

In C, if clk or delta is a null pointer, that parameter is just not returned. she said "not today" and moved on 💀

---

💀 ERRORS 💀

if pvm_hostsync is successful, it returns PvmOk 🎉 slay. but these error conditions can also be returned by pvm_hostsync:

• PvmSysErr — pvmd not responding 😭 she ghosted you fr fr
• PvmNoHost — the specified host is not in the virtual machine 🙈 wrong address babe
• PvmHostFail — host is unreachable (and thus possibly failed) 💔 no cap, that host might be gone gone

---

🌈 SEE ALSO 🌈

• pvm_config(3PVM) — go read this one too, it's giving essential 💜

---

mwah, that's the whole page bestie — sending you all the clock-syncing energy 🕰️✨

this was PVM Version 3.4, dated 20 February, 1994 — vintage but still iconic, periodt 👑💅