PTP4l(8) System Manager's Manual PTP4l(8) (NAME) ptp4l - // PTP (SYNOPSIS) ptp4l [ -AEP246HSLmqsv ] [ -f config ] [ -p phc-device ] [ -l print-level ] [ -i interface ] [ long-options ] ... (DESCRIPTION) ptp4l << >> (PTP) IEEE 1588 . (Boundary Clock - BC) (Ordinary Clock - OC) (Transparent Clock - TC) . (OPTIONS) -A . E2E (peer delay request) P2P . -E - (E2E) . . PTP . E2E . -P (P2P) . P2P . -2 IEEE 802.3 . -4 UDP IPv4 . . -6 UDP IPv6 . -H . -i PTP ( PHC) . . -S . -L (legacy) . -f config . . -i interface PTP . . -p phc-device ( .) 3.5 PHC . PHC ( /dev/ptp0) . -s clientOnly . -l print-level (syslog) . 6 (LOG_INFO) . -m . -q . -v . -h . (LONG OPTIONS) ( ) <<>> (long) . clientOnly : --clientOnly 1 --clientOnly=1 (global) (override). (CONFIGURATION FILE) . () . . # . : 1. ( [global] ) . . 2. ( [eth0]). -i . . 3. [unicast_master_table] . << (UNICAST DISCOVERY OPTIONS)>> . (PORT OPTIONS) active_key_id spp sa_file << >> (Security Association) spp icv . sa_file . spp sa_file . 1 1-2^32 ( ) . 0 () . allowedLostResponses (peer delay responses) asCapable. 3 . announceReceiptTimeout (Announce) . 3 . boundary_clock_jbod ( ) ptp4l . ptp4l ("just a bunch of devices") . phc2sys(8) "automatic" . 0 () . cmlds.client_address (UNIX domain socket) "COMMON_P2P" . /var/run/cmlds_client . cmlds.domainNumber domainNumber << >> (Common Mean Link Delay Service) "COMMON_P2P" . 0 . cmlds.majorSdoId transportSpecific << >> "COMMON_P2P" . 2 . cmlds.port << >> . . 0 ( ) . cmlds.server_address "COMMON_P2P" . /var/run/cmlds_server . delayAsymmetry . . 0 . delay_filter . moving_average moving_median . moving_median . delay_filter_length . 10 . delay_mechanism . Auto COMMON_P2P E2E P2P NONE. E2E . delay_response_timeout . . 0 . egressLatency . (egress) . 0 . fault_badpeernet_interval . . ASAP . 16 . fault_reset_interval . . 128- "ASAP" . 4 (16 ) . follow_up_info 802.1AS Follow_Up . 0 () . G.8275.portDS.localPriority (ITU-T G.8275.1 G.8275.2) << >> (BMCA) . Announce clockClass clockAccuracy offsetScaledLogVariance priority2 (tie breaker) . "dataset_comparison" "G.8275.x" . 128 . : BMCA G.8275.defaultDS.localPriority G.8275.portDS.localPriority ( ) . . hybrid_e2e <<>> (hybrid) Enterprise Profile . (unicast) . . delay_mechanism P2P . 0 () . ignore_transport_specific transportSpecific . 1588 . . 1 . 0 . ingressLatency . (ingress) . 0 . inhibit_delay_req . asCapable 'true' . . 0 () . inhibit_multicast_service (multicast) . . 0 ( ) . logAnnounceInterval Announce. ptp4l / . . . 1 (2 ) . logMinDelayReqInterval Delay_Req. ptp4l . . 0 (1 ) . logMinPdelayReqInterval Pdelay_Req. . 0 (1 ) . logSyncInterval Sync. . . 0 (1 ) . masterOnly . "serverOnly" . min_neighbor_prop_delay . 802.1AS . neighborPropDelayThresh . 802.1AS . network_transport . UDPv4 UDPv6 L2. UDPv4 . net_sync_monitor << >> (NetSync Monitor - NSM) . NSM . sync follow up . GM . 'hybrid_e2e' . 0 () . operLogPdelayReqInterval Pdelay SERVO_LOCKED_STABLE . 'msg_interval_request' "locked stable" . 0 (1 ) . operLogSyncInterval Sync SERVO_LOCKED_STABLE . 'msg_interval_request' TLV . 0 (1 ) . path_trace_enabled Announce . 0 () . phc_index PHC . ( /sys/class/ptp/ptp*/n_vclocks) . 1- PHC -p . power_profile.2011.grandmasterTimeInaccuracy GM . power_profile.version 2011 . POWER_PROFILE_SETTINGS_NP . 1- . power_profile.2011.networkTimeInaccuracy . power_profile.version 2011 . POWER_PROFILE_SETTINGS_NP . 1- . power_profile.2017.totalTimeInaccuracy GM . power_profile.version 2017 . POWER_PROFILE_SETTINGS_NP . 1- . power_profile.grandmasterID GM . clockIdentity . POWER_PROFILE_SETTINGS_NP . 0 . power_profile.version (power profile) . "none" "2011" "2017". POWER_PROFILE_SETTINGS_NP . "none" . ptp_dst_ipv4 IPv4 PTP . UDPv4 . 224.0.1.129 . p2p_dst_ipv4 IPv4 . UDPv4 . 224.0.0.107 . ptp_dst_ipv6 IPv6 PTP . udp6_scope . UDPv6 . FF0E:0:0:0:0:0:0:181 . p2p_dst_ipv6 IPv6 . UDPv6 . FF02:0:0:0:0:0:0:6B . ptp_dst_mac MAC PTP . L2 . 01:1B:19:00:00:00 . p2p_dst_mac MAC . L2 . 01:80:C2:00:00:0E . serverOnly (1) . Announce . ITU-T G.8265.1 G.8275.1 G.8275.2 . false . spp (Security Parameters Pointer) << >> (Security Association) Authentication TLV . spp Authentication TLV sa_file Authentication TLV . Authentication TLV active_key_id . (one step) PTPv2.1 . sa_file active_key_id . 0 255 ( ) . 1- () . syncReceiptTimeout sync/follow up (BMCA) . gPTP 802.1AS-2011 . . 0 . transportSpecific (transport specific). 0 255 . 0 . tsproc_mode . filter raw filter_weight raw_weight. Raw sync ( logSyncInterval) delay ( logMinDelayReqInterval logMinPdelayReqInterval) . (weighting) ( ) . filter . udp_ttl << >> (TTL) IPv4 (hop limit) IPv6 . IPv4 IPv6 UDP . 1 ptp4l . unicast_listen . . 0 () . unicast_master_table . . . 0 ( ) . unicast_req_duration . . 3600 . (PROGRAM AND CLOCK OPTIONS) asCapable 'true' asCapable ( 10.2.4.1 802.1AS ) . 'auto' asCapable 'false' 'true' . 'auto' . assume_two_step (one- step) (two-step) . 802.1AS . 0 () . BMCA << >> (BMCA) 1588 . . 'noop' BMCA 1588 . masterOnly clientOnly . (bridge) clientOnly ( ) . masterOnly ( ) . 'ptp' BMCA . check_fup_sync follow up sync . sequenceID ptp4l . sync . (sequence IDs) . 0 () . clientOnly . 0 () . clockAccuracy clockAccuracy . PTP . 0xFE . clockClass clockClass . (grandmaster clock) . 248 . clock_class_threshold clock class (master) (sub-ordinate) . 248 . clockIdentity clockIdentity . clockIdentity . . clockIdentity . "000000.0000.000000" . clock_servo (servo) . "pi" PI "linreg" "ntpshm" "refclock_sock" NTP SHM chrony SOCK "nullf" ( SyncE). "pi" . clock_type PTP . "OC" "BC" "P2P_TC" (peer to peer transparent clock) "E2E_TC" (end to end transparent clock). . "OC" . dataset_comparison . "ieee1588" "G.8275.x" . "ieee1588" . domainNumber . 0 . dscp_event (DSCP) PTP . 0 63 . . 46 (EF PHB) AES67 48 (CS6 PHB) RAVENNA. 0 . dscp_general (DSCP) PTP . 0 63 . . 34 (AF41 PHB) AES67 46 (EF PHB) RAVENNA. 0 . first_step_threshold ( nullf) . . . 0.0 . 0.00002 (20 ) . pi_f_offset_const . free_running . 0 () . freq_est_interval . . 1 (2 ) . G.8275.defaultDS.localPriority (ITU-T G.8275.1 G.8275.2) << >> (BMCA) . clockClass clockAccuracy offsetScaledLogVariance priority2 (tie breaker) . "dataset_comparison" "G.8275.x" . 128 . : BMCA G.8275.defaultDS.localPriority G.8275.portDS.localPriority ( ) . . gmCapable (grand master) . 802.1AS 1588 . 1 () . ignore_source_id Sync Follow_Up . . 0 () . inhibit_announce ( FD_MANNO_TIMER) ( FD_ANNOUNCE_TIMER) . (Automotive profile) BMCA . ignore_source_id Sync Follow_Up . 0 () . initial_delay E2E P2P . 0 . 0 . interface_rate_tlv . TLV D G.8275.2 . 0 ( tlv ). hwts_filter . normal check full. normal . check . full . normal . kernel_leap (leap second) ( step_threshold ). . 1 () . logging_level . 6 (LOG_INFO) . manufacturerIdentity OUI . 00:00:00 . max_frequency (ppb). . 0 . 900000000 (90%) . pi_max_frequency . maxStepsRemoved stepsRemoved Announce maxStepsRemoved Announce BMCA . 255 . message_tag . "{level}" . ( ). msg_interval_request SERVO_LOCKED_STABLE Sync . Sync pdelay . Sync operLogSyncInterval operLogPdelayReqInterval . msg_interval_request 0 () . ntpshm_segment (SHM) ntpshm. 0 . offsetScaledLogVariance offsetScaledLogVariance . . 0xFFFF . pi_integral_const PI. 0.0 sync : 0.0 . ki = min(ki_scale * sync^ki_exponent, ki_norm_max / sync) pi_integral_exponent ki_exponent PI sync. 0.4 . pi_integral_norm_max ki_norm_max PI sync. 0.3 . pi_integral_scale ki_scale PI sync. 0.0 0.3 0.001 . 0.0 . pi_proportional_const PI. 0.0 sync : 0.0 . kp = min(kp_scale * sync^kp_exponent, kp_norm_max / sync) pi_proportional_exponent kp_exponent PI sync. 0.3- . pi_proportional_norm_max kp_norm_max PI sync. 0.7 . pi_proportional_scale kp_scale PI sync. 0.0 0.7 0.1 . 0.0 . productDescription . manufacturerName;modelNumber;instanceIdentifier 64 utf8 . ";;" . priority1 priority1 . PTP . 0 255 . 128 . priority2 priority2 . PTP . 0 255 . 128 . ptp_minor_version minorVersionPTP PTP . 1 . refclock_sock_address refclock_sock . /var/run/refclock.ptp.sock . revisionData (HW) (FW) (SW) . HW;FW;SW 32 utf8 . ";;" . sa_file << >> (Security Associations) Authentication TLV 14.16 ieee1588-2019 . (SECURITY ASSOCIATION OPTIONS) . spp active_key_id sa_file . . sanity_freq_limit (monotonic) (ppb). . . ptp4l ( ) . 0 . 200000000 (20%) . servo_num_offset_values SERVO_LOCKED SERVO_LOCKED_STABLE. 'servo_num_offset_values' 'servo_offset_threshold' . 10 . servo_offset_threshold SERVO_LOCKED SERVO_LOCKED_STABLE. 'servo_num_offset_values' . offset_threshold 0 () . slave_event_monitor . TLV SLAVE_RX_SYNC_TIMING_DATA SLAVE_DELAY_TIMING_DATA_NP . () . slaveOnly . "clientOnly" . socket_priority SO_PRIORITY . ptp4l qdisc (traffic shaping) . IEEE 802.3 ( -2) UDP IPv4/6 . 0 15 . 0 . step_threshold ( nullf) . 0.0 . . 0.0 . pi_offset_const . step_window Sync . . 0 () . summary_interval . . (RMS) . (ppb) . . LOG_INFO . 0 (1 ) . tc_spanning_tree (Transparent Clock) "stepsRemoved" Announce . PTP BMCA . timeSource . . time_stamping . hardware software legacy onestep p2p1step. hardware . twoStepFlag (two-step) sync . (one-step) . 1 () . tx_timestamp_timeout (polling) (tx) . 10 . udp6_scope (scope) IPv6 . . IPv6 . RFC 4291 . 0x0E . uds_address . /var/run/ptp4l . uds_file_mode (file mode) . 0 . 0660 . uds_ro_address GET . . /var/run/ptp4lro . uds_ro_file_mode () . 0 . 0666 . use_syslog . 1 () . userDescription . name;location 128 utf8 . . utc_offset TAI UTC. 37 . verbose . 0 () . write_phase_mode "write phase" PTP . . 0 () . (UNICAST DISCOVERY OPTIONS) L2|UDPv4|UDPv6 . (unicast negotiation) . logQueryInterval . . 0 (1 ) . peer_address (peer to peer) . (multicast) . table_id . 'unicast_master_table' . (SECURITY ASSOCIATION OPTIONS) spp spp . spp 'spp' . 0 255 ( ) . seqid_window (sequence id) sync/follow_up sync/follow_up (replayed message) . seqid Sync/follow_up . . 0 32767 (0x7FFF) . 3 . allow_mutable authentication tlv (mutable correction fields) . . 0 () . key (format: id type length value) . 'id type length value' : - (Key id): 1 1-2^32 ( ) . - (Key type): SHA256-128 SHA256 AES128 AES256. - (Key length): (). . - (Key value): ASCII "ASCII:" "HEX:" Base64 "B64:" . ASCII . . (AES) ( AES-128 128 16 ). : [security_association] spp 0 allow_mutable 1 1 SHA256-128 HEX:F8ADC6B8B8E9AA709106BA42481EC9E29607334DE2C3C737A11A12931DB27F8C 2 SHA256 32 HEX:EE91D469B3A8ADC6AC8EB28E21794C706E08FDE48863828A7B0281AFCA81B17D [security_association] spp 1 seqid_window 20 1 AES128 HEX:FAF48EBA01E7C5966A76CB787AED4E7B 2 AES256 B64:PKTF9VQz94qPaoAzW4eE3JtFoQ8Ov1OTQSojalWyMbs= 3 SHA256 26 abcdefghijklmnopqrstuvwxyz (TIME SCALE USAGE) ptp4l PTP UTC . (Arbitrary) UTC . PTP . ptp4l UTC PTP phc2sys . phc2sys(8) . (KTHREAD PRIORITY) : timed out while polling for tx timestamp increasing tx_timestamp_timeout or increasing kworker priority may correct this issue, but a driver bug likely causes it kworker (starved) . kworker . kworker PTP . kworker : ptp< > chrt kworker . : pgrep -f "ptp[0-9]+" | xargs -I {} sudo chrt -f --pid 75 {} Intel ice kworker (NIC) . Intel E810: pgrep -f ice-ptp | xargs -I {} sudo chrt -f --pid 75 {} . (SEE ALSO) pmc(8), phc2sys(8) linuxptp March 2024 PTP4l(8)