Commit 26c4fdb0 authored by Willem de Bruijn's avatar Willem de Bruijn Committed by David S. Miller

net-timestamp: document deprecated syststamp

The SO_TIMESTAMPING API defines option SOF_TIMESTAMPING_SYS_HW.
This feature is deprecated. It should not be implemented by new
device drivers. Existing drivers do not implement it, either --
with one exception.

Driver developers are encouraged to expose the NIC hw clock as a
PTP HW clock source, instead, and synchronize system time to the
HW source.

The control flag cannot be removed due to being part of the ABI, nor
can the structure scm_timestamping that is returned. Due to the one
legacy driver, the internal datapath and structure are not removed.

This patch only clearly marks the interface as deprecated. Device
drivers should always return a syststamp value of zero.
Signed-off-by: default avatarWillem de Bruijn <willemb@google.com>

----

We can consider adding a WARN_ON_ONCE in__sock_recv_timestamp
if non-zero syststamp is encountered
Acked-by: default avatarRichard Cochran <richardcochran@gmail.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 11878b40
...@@ -40,7 +40,7 @@ the set bits correspond to data that is available, then the control ...@@ -40,7 +40,7 @@ the set bits correspond to data that is available, then the control
message will not be generated: message will not be generated:
SOF_TIMESTAMPING_SOFTWARE: report systime if available SOF_TIMESTAMPING_SOFTWARE: report systime if available
SOF_TIMESTAMPING_SYS_HARDWARE: report hwtimetrans if available SOF_TIMESTAMPING_SYS_HARDWARE: report hwtimetrans if available (deprecated)
SOF_TIMESTAMPING_RAW_HARDWARE: report hwtimeraw if available SOF_TIMESTAMPING_RAW_HARDWARE: report hwtimeraw if available
It is worth noting that timestamps may be collected for reasons other It is worth noting that timestamps may be collected for reasons other
...@@ -94,7 +94,13 @@ not perfect; as a consequence, sorting packets received via different ...@@ -94,7 +94,13 @@ not perfect; as a consequence, sorting packets received via different
NICs by their hwtimetrans may differ from the order in which they were NICs by their hwtimetrans may differ from the order in which they were
received. hwtimetrans may be non-monotonic even for the same NIC. received. hwtimetrans may be non-monotonic even for the same NIC.
Filled in if SOF_TIMESTAMPING_SYS_HARDWARE is set. Requires support Filled in if SOF_TIMESTAMPING_SYS_HARDWARE is set. Requires support
by the network device and will be empty without that support. by the network device and will be empty without that support. This
field is DEPRECATED. Only one driver computes this value. New device
drivers must leave this zero. Instead, they can expose the hardware
clock device on the NIC directly as a HW PTP clock source, to allow
time conversion in userspace and optionally synchronize system time
with a userspace PTP stack such as linuxptp. For the PTP clock API,
see Documentation/ptp/ptp.txt.
SIOCSHWTSTAMP, SIOCGHWTSTAMP: SIOCSHWTSTAMP, SIOCGHWTSTAMP:
......
...@@ -211,7 +211,7 @@ static inline void skb_frag_size_sub(skb_frag_t *frag, int delta) ...@@ -211,7 +211,7 @@ static inline void skb_frag_size_sub(skb_frag_t *frag, int delta)
* struct skb_shared_hwtstamps - hardware time stamps * struct skb_shared_hwtstamps - hardware time stamps
* @hwtstamp: hardware time stamp transformed into duration * @hwtstamp: hardware time stamp transformed into duration
* since arbitrary point in time * since arbitrary point in time
* @syststamp: hwtstamp transformed to system time base * @syststamp: hwtstamp transformed to system time base (deprecated)
* *
* Software time stamps generated by ktime_get_real() are stored in * Software time stamps generated by ktime_get_real() are stored in
* skb->tstamp. The relation between the different kinds of time * skb->tstamp. The relation between the different kinds of time
...@@ -222,7 +222,9 @@ static inline void skb_frag_size_sub(skb_frag_t *frag, int delta) ...@@ -222,7 +222,9 @@ static inline void skb_frag_size_sub(skb_frag_t *frag, int delta)
* syststamp/tstamp/"syststamp from other device" comparison is * syststamp/tstamp/"syststamp from other device" comparison is
* limited by the accuracy of the transformation into system time * limited by the accuracy of the transformation into system time
* base. This depends on the device driver and its underlying * base. This depends on the device driver and its underlying
* hardware. * hardware. The syststamp implementation is deprecated in favor
* of hwtstamps and hw PTP clock sources exposed directly to
* userspace.
* *
* hwtstamps can only be compared against other hwtstamps from * hwtstamps can only be compared against other hwtstamps from
* the same device. * the same device.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment