1CLOCKDIFF(8)                        iputils                       CLOCKDIFF(8)
2
3
4

NAME

6       clockdiff - measure clock difference between hosts
7

SYNOPSIS

9       clockdiff [-o] [-o1] [--time-format ctime iso] [-V] {destination}
10

DESCRIPTION

12       clockdiff Measures clock difference between us and destination with 1
13       msec resolution using ICMP TIMESTAMP [2] packets or, optionally, IP
14       TIMESTAMP option [3] added to ICMP ECHO. [1]
15

OPTIONS

17       -o
18           Use IP TIMESTAMP with ICMP ECHO instead of ICMP TIMESTAMP messages.
19           It is useful with some destinations, which do not support ICMP
20           TIMESTAMP (f.e. Solaris <2.4).
21
22       -o1
23           Slightly different form of -o, namely it uses three-term IP
24           TIMESTAMP with prespecified hop addresses instead of four term one.
25           What flavor works better depends on target host. Particularly, -o
26           is better for Linux.
27
28       -T, --time-format ctime iso
29           Print time stamp in output either ISO-8601 format or classical
30           ctime format. The ctime format is default. The ISO time stamp
31           includes timezone, and is easier to parse.
32
33       -I
34           Alias of --time-format iso option and argument.
35
36       -h, --help
37           Print help and exit.
38
39       -V, --version
40           Print version and exit.
41

WARNINGS

43           • Some nodes (Cisco) use non-standard timestamps, which is allowed
44           by RFC, but makes timestamps mostly useless.
45
46           • Some nodes generate messed timestamps (Solaris>2.4), when run
47           xntpd. Seems, its IP stack uses a corrupted clock source, which is
48           synchronized to time-of-day clock periodically and jumps randomly
49           making timestamps mostly useless. Good news is that you can use NTP
50           in this case, which is even better.
51
52clockdiff shows difference in time modulo 24 days.
53

SEE ALSO

55       ping(8), arping(8), tracepath(8).
56

REFERENCES

58       [1] ICMP ECHO, RFC0792, page 14.
59
60       [2] ICMP TIMESTAMP, RFC0792, page 16.
61
62       [3] IP TIMESTAMP option, RFC0791, 3.1, page 16.
63

AUTHOR

65       clockdiff was compiled by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>. It
66       was based on code borrowed from BSD timed daemon.
67

SECURITY

69       clockdiff requires CAP_NET_RAW and CAP_SYS_NICE capabilities to be
70       executed. It is safe to be used as set-uid root.
71

AVAILABILITY

73       clockdiff is part of iputils package.
74
75
76
77iputils 20221126                                                  CLOCKDIFF(8)
Impressum