Documentation/networking/timestamping.rst

4 Timestamping  title
24   Same timestamping mechanism as SO_TIMESTAMP, but reports the
45 This socket option enables timestamping of datagrams on the reception
98 requested by a particular socket, such as when receive timestamping is
180   have multiple concurrent timestamping requests outstanding. Packets
221   timestamping applications. SOF_TIMESTAMPING_OPT_ID defines how the
354 The SO_TIMESTAMPING interface supports timestamping of bytes in a
356 entire contents of the buffer has passed a timestamping point. That
536 3. Hardware Timestamping configuration: ETHTOOL_MSG_TSCONFIG_SET/GET
626 3.1 Hardware Timestamping Implementation: Device Drivers
663   and hardware timestamping is not possible (SKBTX_IN_PROGRESS not set).
680 user to select which PHC to use for timestamping Ethernet frames. Instead, the
698 switches include a timestamping clock of their own, and have the ability to
699 perform network timestamping on their own MAC, such that path delays only
700 measure wire and PHY propagation latencies. Timestamping DSA switches are
706 By design, PTP timestamping with a DSA switch does not need any special
708 host port also supports PTP timestamping, DSA will take care of intercepting
710 hardware timestamping on it. This is because the SO_TIMESTAMPING API does not
715 timestamping:
718   packets with a hardware TX timestamping request from user space.
719   This is required for two-step timestamping, since the hardware
730   packets in a queue waiting for timestamping and the actual timestamps,
736   One-step TX timestamping do not require packet cloning, since there is
749   (through another RX timestamping FIFO). Deferral on RX is typically
763 A PHY driver that supports PTP timestamping must create a ``struct
767 Since PHYs do not have network interface representations, the timestamping and
770 to each individual MAC driver for PHY timestamping support. This entails:
783   deferral for RX timestamping is necessary.  Again like DSA, it becomes the
797   drivers already perform for software timestamping purposes. Therefore, if a
798   MAC supports software timestamping, it does not need to do anything further
804 These perform the same role as timestamping Ethernet PHYs, save for the fact
806 any PHY even if it doesn't support timestamping. In Linux, they are
820 Any TX timestamping logic, be it a plain MAC driver, a DSA switch driver, a PHY
825 For example, a typical driver design for TX timestamping might be to split the
828 1. "TX": checks whether PTP timestamping has been previously enabled through
849 that PTP timestamping is not enabled for anything other than the outermost PHC,