Poster of Linux kernelThe best gift for a Linux geek
CLOCKDIFF

CLOCKDIFF

Section: System Manager's Manual: iputils (8) Updated: 15 November 2010
Local index Up
 

NAME

clockdiff - measure clock difference between hosts  

SYNOPSIS

clockdiff [-o] [-o1] destination

 

DESCRIPTION

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

OPTIONS

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

WARNINGS

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

SEE ALSO

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

REFERENCES

[1] ICMP ECHO, RFC0792, page 14.

[2] ICMP TIMESTAMP, RFC0792, page 16.

[3] IP TIMESTAMP option, RFC0791, 3.1, page 16.  

AUTHOR

clockdiff was compiled by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>. It was based on code borrowed from BSD timed daemon. It is now maintained by YOSHIFUJI Hideaki <yoshfuji@skbuff.net>.  

SECURITY

clockdiff requires CAP_NET_RAWIO capability to be executed. It is safe to be used as set-uid root.  

AVAILABILITY

clockdiff is part of iputils package and the latest versions are available in source form at http://www.skbuff.net/iputils/iputils-current.tar.bz2.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
WARNINGS
SEE ALSO
REFERENCES
AUTHOR
SECURITY
AVAILABILITY

This document was created by man2html, using the manual pages.
Time: 22:01:26 GMT, April 16, 2011