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

NAME

6       clockdiff - measure clock difference between hosts
7

SYNOPSIS

9       clockdiff [-o] [-o1] destination
10
11

DESCRIPTION

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

OPTIONS

18       -o
19           Use IP TIMESTAMP with ICMP ECHO instead of ICMP TIMESTAMP messages.
20           It is useful with some destinations, which do not support ICMP
21           TIMESTAMP (f.e. Solaris <2.4).
22
23       -o1
24           Slightly different form of -o, namely it uses three-term IP
25           TIMESTAMP with prespecified hop addresses instead of four term one.
26           What flavor works better depends on target host. Particularly, -o
27           is better for Linux.
28

WARNINGS

30           · Some nodes (Cisco) use non-standard timestamps, which is allowed
31           by RFC, but makes timestamps mostly useless.
32
33           · Some nodes generate messed timestamps (Solaris>2.4), when run
34           xntpd. Seems, its IP stack uses a corrupted clock source, which is
35           synchronized to time-of-day clock periodically and jumps randomly
36           making timestamps mostly useless. Good news is that you can use NTP
37           in this case, which is even better.
38
39           · clockdiff shows difference in time modulo 24 days.
40

SEE ALSO

42       ping(8), arping(8), tracepath(8).
43

REFERENCES

45       [1] ICMP ECHO, RFC0792, page 14.
46
47       [2] ICMP TIMESTAMP, RFC0792, page 16.
48
49       [3] IP TIMESTAMP option, RFC0791, 3.1, page 16.
50

AUTHOR

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

SECURITY

56       clockdiff requires CAP_NET_RAW capability to be executed. It is safe to
57       be used as set-uid root.
58

AVAILABILITY

60       clockdiff is part of iputils package.
61
62
63
64iputils s20180629                                                 CLOCKDIFF(8)
Impressum