PTP


nv show bridge domain <domain-id> vlan <vid> ptp

Shows PTP configuration and counters for a specific VLAN interface on the specified bridge domain.

Command Syntax

SyntaxDescription
<domain-id>The bridge domain.
<vid>The VLAN name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show bridge domain br_default vlan 10 ptp

nv show interface <interface-id> counters ptp

Shows PTP statistics for the specified interface.

In Cumulus Linux 5.4 and earlier, this command is nv show interface <interface-id> ptp counters

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters ptp
       operational  applied
------  -----------  -------
enable  on           on     
cumulus@leaf03:mgmt:~$ nv show interface swp1 counters ptp
Packet Type          Received  Transmitted
-------------------  --------  -----------
Announce             0         663        
Delay Request        0         0          
Delay Response       0         0          
Follow-up            0         1325       
Management           0         0          
Peer Delay Request   0         0          
Peer Delay Response  0         0          
Signaling            0         0          
Sync                 0         1325

nv show interface <interface-id> ptp

Shows PTP configuration and counters for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ptp
                          operational  applied  pending   
------------------------  -----------  -------  ----------
enable                                          on        
acceptable-master                               off       
delay-mechanism                                 end-to-end
forced-master                                   off       
instance                                        1         
mixed-multicast-unicast                         off       
ttl                                             1         
unicast-request-duration                        300       
shaper                                                    
  enable                                        off       
timers                                                    
  announce-interval                             1         
  announce-timeout                              3         
  delay-req-interval                            0         
  sync-interval                                 0

nv show interface <interface-id> ptp shaper

Shows if PTP shaper is ON or OFF on the specified PTP interface.

This command is available for the NVIDIA Spectrum 1 switch only for PTP-enabled ports with speeds lower than 100G.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show interface swp1 ptp shaper
        operational  applied  pending
------  -----------  -------  -------
enable                        off

nv show interface <interface-id> ptp timers

Shows PTP timer settings for the specified PTP interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ptp timers
                    operational  applied  pending
------------------  -----------  -------  -------
announce-interval                         1      
announce-timeout                          3      
delay-req-interval                        0      
sync-interval                             0

nv show service ptp

Shows global PTP configuration.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp
id  Clock-id                 Enabled  Domain  Priority1  Priority2
--  -----------------------  -------  ------  ---------  ---------
1   48:b0:2d:ff:fe:0a:67:46  on       28      128        128

nv show service ptp <instance-id>

Shows configuration for the specified PTP instance. PTP commands require an instance number for management purposes.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1
cumulus@switch:~$ nv show service ptp 1
                             operational  applied
---------------------------  -----------  ------------------
enable                       on           on
current-profile                           default-itu-8275-2
domain                                    0
ip-dscp                                   46
logging-level                             info
priority1                                 128
priority2                                 128
[acceptable-master]
monitor
  max-offset-threshold                    50
  max-timestamp-entries                   100
  max-violation-log-entries               4
  max-violation-log-sets                  2
  min-offset-threshold                     -50
  path-delay-threshold                    200
  violation-log-interval                  1
[profile]                                 abc
[profile]                                 default-1588
[profile]                                 default-itu-8275-1
[profile]                                 default-itu-8275-2
[unicast-master]                          1
[unicast-master]                          2
[unicast-master]                          3
[unicast-master]                          4
[unicast-master]
...

nv show service ptp <instance-id> acceptable-master

Shows the acceptable master clocks for the specified PTP instance.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 acceptable-master

nv show service ptp <instance-id> acceptable-master <clock-id>

Shows the configuration settings for the specified acceptable master clock.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.
<clock-id>The clock ID.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 acceptable-master 24:8a:07:ff:fe:f4:16:06
              operational  applied
------------  -----------  -------
alt-priority  255          255

nv show service ptp <instance-id> counters

Shows all PTP counters, such as the number of received and transmitted announce, sync, followup, and delay request and response packets.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv show service ptp 1 counters
Packet Type              Received       Transmitted    
---------------------    ------------   ------------   
Port swp4
  Announce                 0              10370            
  Sync                     0              20731             
  Follow-up                0              20731            
  Delay Request            0              0              
  Delay Response           0              0              
  Peer Delay Request       0              0              
  Peer Delay Response      0              0              
  Management               0              0              
  Signaling                0              0

nv show service ptp <instance-id> current

Shows the local states learned from the exchange of PTP messages for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 current
                    operational  applied
------------------  -----------  -------
mean-path-delay     0                   
offset-from-master  0                   
steps-removed       0

nv show service ptp <instance-id> clock-quality

Shows the clock quality status, such as accuracy, class and the offset scaled log variance, for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 clock-quality
                            operational  applied
--------------------------  -----------  -------
clock-accuracy              254                 
clock-class                 248                 
offset-scaled-log-variance  65535

nv show service ptp <instance-id> force-version

Shows the PTP version. Cumulus Linux uses a linuxptp package that is PTP v2.1 compliant, and sets the major PTP version to 2 and the minor PTP version to 1 by default in the configuration. If your PTP configuration does not work correctly when the minor version is set, you can change the minor version to 0.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.8.0

Example

cumulus@switch:~$ nv show service ptp 1 force-version
               applied
-------------  -------
force-version  2.0

nv show service ptp <instance-id> ipv6-scope

Shows the PTP IPv6-scope configuration setting.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show service ptp 1 ipv6-scope
            operational  applied
----------  -----------  -------
ipv6-scope               global

nv show service ptp <instance-id> monitor

Shows the PTP monitor configuration for the specified PTP instance, such as:

  • The minimum and maximum difference allowed between the master and slave time.
  • The mean time that PTP packets take to travel between the master and slave.
  • The maximum number of timestamp entries allowed.
  • The maximum number of violation log sets allowed.
  • The maximum number of violation log entries allowed for each set.
  • The violation log interval.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor
                           operational  applied
-------------------------  -----------  -------
max-offset-threshold       50           50     
max-timestamp-entries      100          100    
max-violation-log-entries  4            4      
max-violation-log-sets     2            2      
min-offset-threshold       -50          -50    
path-delay-threshold       200          200    
violation-log-interval     1            1

nv show service ptp <instance-id> monitor timestamp-log

Shows the monitor timestamp log for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor timestamp-log

nv show service ptp <instance-id> monitor violations

Shows the PTP violations for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations
 cumulus@switch:~$ nv show service ptp 1 monitor violations
                  operational                  applied
----------------  ---------------------------  -------
last-max-offset
last-min-offset   2023-04-24T15:22:01.312295Z
last-path-delay
max-offset-count  0
min-offset-count  2
path-delay-count  0

nv show service ptp <instance-id> monitor violations log

Shows all the PTP violation logs for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations log

nv show service ptp <instance-id> monitor violations log acceptable-master

Shows the acceptable master violation logs for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations log acceptable-master

nv show service ptp <instance-id> monitor violations log forced-master

Shows the forced master violation logs for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations log forced-master

nv show service ptp <instance-id> monitor violations log max-offset

Shows violation logs for the maximum difference allowed between the master and slave time for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations log max-offset

nv show service ptp <instance-id> monitor violations log min-offset

Shows violation logs for the minimum difference allowed between the master and slave time for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations log min-offset

nv show service ptp <instance-id> monitor violations log path-delay

Shows violation logs for the mean time that PTP packets take to travel between the master and slave for the specified PTP instance.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 monitor violations log path-delay

nv show service ptp <instance-id> parent

Shows global PTP parent information.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 parent

nv show service ptp <instance-id> parent grandmaster-clock-quality

Shows the grandmaster clock quality for the PTP parent.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 parent grandmaster-clock-quality
                            operational  applied
--------------------------  -----------  -------
clock-accuracy              254                 
clock-class                 248                 
offset-scaled-log-variance  65535

nv show service ptp <instance-id> profile

Shows the predefined and custom PTP profiles configured for the specified PTP instance. Predefined profiles are a standardized set of configurations and rules intended to meet the requirements of a specific application. You base a custom profile off a predefined profile. Profiles define required, allowed, and restricted PTP options, network restrictions, and performance requirements.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.2.0

Example

cumulus@switch:~$ nv show service ptp 1 profile
Profile Name        Type          Domain  Transport  Delay Mechanism
------------------  ------------  ------  ---------  ---------------
default-1588        ieee-1588     0       ipv4       end-to-end     
default-itu-8275-1  itu-g-8275-1  24      802.3      end-to-end     
default-itu-8275-2  itu-g-8275-2  44      ipv4       end-to-end 

nv show service ptp <instance-id> profile <profile-id>

Shows configuration settings for a specific PTP profile.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.
<profile-id>The PTP profile name.

Version History

Introduced in Cumulus Linux 5.2.0

Example

cumulus@switch:~$ nv show service ptp 1 profile CUSTOM1
                    operational   applied     
------------------  ------------  ------------
announce-interval   -3            -3          
announce-timeout    3             3           
delay-mechanism     end-to-end    end-to-end  
delay-req-interval  -4            -4          
domain              28            28          
local-priority      128           128         
priority1           128           128         
priority2           128           128         
profile-type        itu-g-8275-1  itu-g-8275-1
sync-interval       -4            -4          
transport           802.3         802.3

nv show service ptp <instance-id> status

Shows PTP status.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show service ptp 1 status
Port   Mode   State    Ustate                           Server
-----  -----  -------  -------------------------------  -------
swp9   Ucast  SLAVE    Sync and Delay Granted (H_SYDY)  9.9.9.2
swp10  Ucast  PASSIVE  Initial State (WAIT)
swp11  Ucast  PASSIVE  Initial State (WAIT)
swp12  Ucast  PASSIVE  Initial State (WAIT)

nv show service ptp <instance-id> time-properties

Shows time properties for the specified PTP instance, such as the current UTC offset and the PTP time scale.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service ptp 1 time-properties
                          operational  applied
------------------------  -----------  -------
current-utc-offset        37                  
current-utc-offset-valid  off                 
freq-traceable            off                 
leap59                    off                 
leap61                    off                 
ptp-time-scale            off                 
time-traceable            off

nv show service ptp <instance-id> unicast-master

Shows the PTP unicast master table configuration on the switch.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.

Version History

Introduced in Cumulus Linux 5.2.0

Example

cumulus@switch:~$ nv show service ptp 1 unicast-master
Table-id  Address     Peer-address  Query-interval
--------  ----------  ------------  --------------
1         10.10.10.1                4

nv show service ptp <instance-id> unicast-master <table-id>

Shows information about a specific PTP unicast master table on the switch.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.
<table-id>The unicast master table ID.

Version History

Introduced in Cumulus Linux 5.2.0

Example

cumulus@switch:~$ nv show service ptp 1 unicast-master 1
                operational  applied   
--------------  -----------  ----------
query-interval  4            4         
[address]       10.10.10.1   10.10.10.1

nv show service ptp <instance-id> unicast-master <table-id> address

Shows the IP addresses of the specified PTP unicast master table.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.
<table-id>The unicast master table ID.

Version History

Introduced in Cumulus Linux 5.2.0

Example

cumulus@switch:~$ nv show service ptp 1 unicast-master 1 address
IP or MAC Address
-----------------
10.10.10.1

nv show service ptp <instance-id> unicast-master <table-id> address <ip-mac-address-id>

Shows information about a specific IP or MAC address for the specified PTP unicast master table.

Command Syntax

SyntaxDescription
<instance-id>The PTP instance number.
<table-id>The unicast master table ID.
<ip-mac-address-id>The IP or MAC address.

Version History

Introduced in Cumulus Linux 5.2.0

Example

cumulus@switch:~$ nv show service ptp 1 unicast-master 1 address 10.10.10.1

nv show vrf <vrf-id> ptp

Shows PTP configuration for the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show vrf default ptp
        operational  applied
------  -----------  -------
enable  on           on