1HOSTSYNC(3PVM)                  PVM Version 3.4                 HOSTSYNC(3PVM)
2
3
4

NAME

6       pvm_hostsync - Get time-of-day clock from PVM host.
7
8

SYNOPSIS

10       C    #include <sys/time.h>
11            int info = pvm_hostsync( int host, struct timeval *clk,
12                 struct timeval *delta )
13
14       Fortran   call pvmfhostsync( host, clksec, clkusec, deltasec, deltausec, info )
15
16

PARAMETERS

18       host    TID of host.
19
20       clk     (or  clksec  and clkusec) Returns time-of-day clock sample from
21               host.
22
23       delta   (or deltasec and deltausec) Returns  difference  between  local
24               clock and remote host clock.
25
26

DESCRIPTION

28       pvm_hostsync  samples  the  time-of  day clock of a host in the virtual
29       machine and returns both the clock value  and  the  difference  between
30       local and remote clocks.
31
32       To reduce the delta error due to message transit time, local clock sam‐
33       ples are taken before and after reading the remote clock.  Delta is the
34       difference between the mean local clocks and remote clock.
35
36       Note  that  the  delta time can be negative.  The microseconds field is
37       always normalized to 0..999999, while the sign  of  the  seconds  field
38       gives the sign of the delta.  For example:
39            3.25 Sec =  3,250000
40            0        =  0,0
41            -1 uSec  = -1,999999
42            -1 Sec   = -1,000000
43            -1.1 Sec = -2,999000
44
45       In  C,  if  clk  or  delta  is  a  null  pointer, that parameter is not
46       returned.
47
48

ERRORS

50       If pvm_hostsync is successful, it returns PvmOk.   These  error  condi‐
51       tions can be returned by pvm_hostsync
52
53       PvmSysErr
54              pvmd not responding.
55
56       PvmNoHost
57              specified host not in virtual machine.
58
59       PvmHostFail
60              host is unreachable (and thus possibly failed)
61

SEE ALSO

63       pvm_config(3PVM)
64
65
66
67                               20 February, 1994                HOSTSYNC(3PVM)