To display the
Precision Time Protocol (PTP) foreign master clocks that are available to the
router, use the
show ptp foreign-masters command in EXEC mode.
show
ptp
foreign-masters
breif
[
interface
name
location
node
]
[
best
]
Syntax Description
|
brief
|
Lists all
foreign-masters known on the router, ordered by the interface on which they
were discovered.
If this
option is omitted, the output also includes detailed clock properties, unicast
messages that are granted from the master, length of time the master has been
qualified, and information about the clock peer.
|
|
name
|
Displays
foreign masters that were discovered the specified interface. For more
information, use the question mark ( ? ) online help function
|
|
node
|
Displays
foreign masters that were discovered the specified node
|
| best
|
Displays
the state of the best foreign master found in the network
|
Command History
|
Release
|
Modification
|
|
Release 24.2.1
|
The command output was modified to include phase difference values and servo status.
|
|
Release 4.2.0
|
This command was introduced.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user
group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command
displays the state of foreign masters for the PTP processes. It is only
relevant when running as a boundary clock; in grandmaster mode, no relevant
output gets displayed.
The show ptp foreign-masters command with the best keyword collects grandmaster information from all RPs and filters out all but the grandmaster on the active timing card.
If the active timing card does not support running as slave, no foreign masters are displayed and instead, it is indicated
that slaving is not supported (refer examples section).
Task ID
| Task ID
|
Operation
|
|
ethernet-services
|
read
|
Examples
The following
shows output with the brief option.
RP/0/RSP0/CPU0:router# show ptp foreign-masters brief
M=Multicast,Q=Qualified,GM=Grandmaster
Interface Transport Address Priority1 State
Gi0/2/0/0 IPv4 192.168.172.122 13 M,Q
IPv4 192.168.172.123 17 M
Gi0/2/0/1 IPv6 fe80::2b0:4aff:fe6b:f4fc 1 Q,GM
IPv6 fe80::2b0:4aff:fe6b:1234 18 Q
Gi0/3/0/0 Ethernet 00b0.4a6b.f4fc
The example
indicates if the foreign-master is multicast and the clock that is being used
as the grandmaster.
Examples
The following
example shows output for the location 0/2/CPU0, including the brief option.
RP/0/RSP0/CPU0:router# show ptp foreign-masters brief location 0/2/CPU0
M=Multicast,Q=Qualified,GM=Grandmaster
Interface Transport Address Priority1 State
Gi0/2/0/0 IPv4 192.168.172.122 13 M,Q
IPv4 192.168.172.123 17 M
Gi0/2/0/1 IPv6 fe80::2b0:4aff:fe6b:f4fc 1 Q,GM
IPv6 fe80::2b0:4aff:fe6b:1234 18 Q
Examples
The following
example shows output for the interface GigabitEthernet0/2/0/0, without the
brief option.
RP/0/RSP0/CPU0:router# show ptp foreign-masters brief interface GigabitEthernet0/2/0/0
Interface GigabitEthernet0/2/0/3 (PTP port number 27):
IPv4, Address 172.108.11.25
Configured priority: None
Announce granted: every 2 seconds, 600 seconds
Sync granted: 16 per-second, 400 seconds
Delay-Resp granted: 16 per-second, 600 seconds
Qualified for 6 days, 2 hours, 11 minutes
Clock ID: ACDE48FFFE234567
Clock properties:
Priority1: 1, Priority2: 83, Class: 6, Accuracy: 0x2B
Offset scaled log variance: 0x27FF, Steps-removed: 5
Domain: 0, Time Source: GPS, Timescale: PTP
Frequency-traceable, Time-traceable
Current UTC offset: 25 seconds
Parent properties:
Clock-ID: BADE48FFFE234367
Port number: 3, Steps Removed: 2
IPv4, Address 172.108.11.23, Multicast
Configured priority: 27
Announce granted: every 2 seconds, 600 seconds
Qualified for 5 days, 4 hours, 27 minutes
Clock ID: ACDE48FFFE234567
Clock properties:
Priority1: 7, Priority2: 83, Class: 6, Accuracy: 0x2B
Offset scaled log variance: 0x27FF, Steps-removed: 5
Domain: 0, Time Source: GPS, Timescale: PTP
Frequency-traceable, Time-traceable
Current UTC offset: 25 seconds
Parent properties:
Clock-ID: BADE48FFFE234367
Port number: 5, Steps Removed: 1
IPv4, Address 172.108.11.18, Multicast
Configured priority: 11
Not qualified
Examples
The following
example shows state information for the best foreign master in the network.
RP/0/RSP0/CPU0:router# show ptp foreign-masters best
Used to set system frequency and time
IPv4, Address 1.2.3.4
Received on interface GigabitEthernet0/2/0/3 (port number 0x1007)
Clock ID: ACDE48FFFE234567
Best foreign-master for 5 days, 4 hours, 27 minutes
Advertised for 5 days, 4 hours, 20 minutes
Clock properties:
Priority1: 7, Priority2: 83, Class: 6, Accuracy: 0x2B
Offset scaled log variance: 0x27FF, Steps-removed: 5
Domain: 0, Time Source: GPS, Timescale: PTP
Frequency-traceable, Time-traceable
Current UTC offset: 25 seconds
Parent properties:
Clock-ID: BADE48FFFE234367
Port number: 0x0005
This example indicates the display when slaving is not supported on
the active timing card.
RP/0/RSP0/CPU0:router # show ptp foreign-masters best
PTP slaving is not supported on the RSP.
This example indicates the phase-difference and servo status as PTSF-unuable.
Router#show-ptp-foreign-masters
Ethernet, Address 0102.0304.050a, Multicast
Configured priority: 40
Configured clock class: None
Configured delay asymmetry: 3 microseconds
Announce granted: 4 per-second, 600 seconds
Sync granted: 4 per-second, 600 seconds
Delay-resp granted: 4 per-second, 600 seconds
Not qualified (PTSF lossSync)
Clock ID: abcdef1
Phase difference: -5000ns
Servo status: PTSF-unusable
Received clock properties:
Domain: 0, Priority1: 1, Priority2: 100, Class: 52
Accuracy: 0x00, Offset scaled log variance: 0x0000
Steps-removed: 2, Time source: GPS, Timescale: PTP
Time-traceable
Current UTC offset: 0 seconds
Parent properties:
Clock ID: 0
Port number: 0
Feedback