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

Syntax	Description
`<domain-id>`	The bridge name.
`<vlan-id>`	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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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

Syntax	Description
`<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