PTP-MIB

All MIBs › PTP-MIB

Organization: D-Link Corp.

Last Updated: 2010-08-25

Category: Synchronization

Description: Manages D-Link IEEE 1588 Precision Time Protocol (PTP) clock configuration, port state, and grandmaster clock synchronization.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is PTP-MIB?

PTP-MIB (module identity swPTPMIB) is a D-Link vendor-private MIB, registered under dlink-common-mgmt.94, that manages IEEE 1588 Precision Time Protocol (PTP) clock behavior on D-Link switches. It exposes global settings through swPTPState, swPTPMode (boundary/p2p-transparent/e2e-transparent), swPTPTransportProtocol (udp/ethernet), and boundary-clock attributes swPTPBoundaryPriority1/swPTPBoundaryPriority2 used by the Best Master Clock algorithm; a swPTPClockDomainTable tracks per-unit PTP domain number and name, a swPTPPortTable exposes per-port swPTPPortState, and a swPTPBoundaryPortCFGTable defines per-port timing parameters such as announce interval/timeout, sync interval, and delay-request intervals plus the delay mechanism used. Separate swPTPClock, swPTPClockParent, and swPTPForeignMaster branches track the local clock's own state, its current parent/grandmaster, and any foreign master candidates seen on the network. Because clock synchronization accuracy hinges on stable PTP port states and correctly negotiated master/slave roles, monitoring this MIB is useful for detecting a switch that has lost its grandmaster reference or is stuck in an unexpected boundary-clock role. It is deployed on D-Link switches used as PTP boundary or transparent clocks in synchronization-sensitive networks (e.g. mobile backhaul, TDM-over-packet), and administrators can download the PTP-MIB file to monitor 1588 clock synchronization on these devices.

IPNetwork Monitor allows you to monitor SNMP objects defined in PTP-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

D-Link switches (e.g. layer-3 managed switch series) supporting IEEE 1588 PTP

Monitoring Examples

An operator polls swPTPPortTable to confirm swPTPPortState is enabled(1) on the uplink port acting as the PTP path to the grandmaster, and checks the swPTPClockParent branch to verify the expected parent clock is still selected; a port unexpectedly reporting disabled(2) or a change in the reported parent clock would indicate a PTP synchronization path failure that could degrade downstream timing accuracy.

What Can Be Monitored

global PTP enable state
PTP device mode (boundary/transparent)
boundary clock priority1/priority2
per-port PTP state
boundary-port announce/sync/delay-request intervals
per-domain clock configuration

Imported Objects

From DLINK-ID-REC-MIB

dlink-common-mgmt

From Q-BRIDGE-MIB

PortList

From SNMPv2-SMI

MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

DisplayString

OIDs

OID symbolic	OID numeric	Type	Access	Description
swPTPMIB	1.3.6.1.4.1.171.12.94			The structure of Precision Time Protocol for the proprietary enterprise.
swPTPNotifications	1.3.6.1.4.1.171.12.94.0
swPTPMIBObjects	1.3.6.1.4.1.171.12.94.1
swPTPGeneralGroup	1.3.6.1.4.1.171.12.94.1.1
INT swPTPState	1.3.6.1.4.1.171.12.94.1.1.1	INTEGER	read-write	This indicates the global state of PTP.
INT swPTPMode	1.3.6.1.4.1.171.12.94.1.1.2	INTEGER	read-write	This indicates the switch's PTP device type.
INT swPTPTransportProtocol	1.3.6.1.4.1.171.12.94.1.1.3	INTEGER	read-write	This indicates the transport protocol that will be used for the communication path.
INT swPTPBoundaryPriority1	1.3.6.1.4.1.171.12.94.1.1.4	INTEGER	read-write	This indicates the PTP boundary clock attributes. The priority 1 attribute is used in the execution of the best master clock algorithm. Lower values take precedence.
INT swPTPBoundaryPriority2	1.3.6.1.4.1.171.12.94.1.1.5	INTEGER	read-write	This indicates the PTP boundary clock attributes. The priority 2 attribute is used in the execution of the best master clock algorithm. Lower values take precedence. In the event that the operation of the BMC algorithm fails to order the clocks based on the values of priority1, the clock's class, and the clock's accuracy; the priority2 attribute will allow the creation of lower values compared to the other devices.
swPTPClockDomainTable	1.3.6.1.4.1.171.12.94.1.1.6		not-accessible	This table contains the per unit domain of the PTP clock.
swPTPClockDomainEntry	1.3.6.1.4.1.171.12.94.1.1.6.1		not-accessible	This is an entry of the swPTPClockDomainTable.
INT swPTPUnit	1.3.6.1.4.1.171.12.94.1.1.6.1.1	INTEGER	not-accessible	This indicates the PTP unit number.
INT swPTPClockDomainNumber	1.3.6.1.4.1.171.12.94.1.1.6.1.2	INTEGER	read-write	This indicates the PTP clock common attribute of the domain number.
STR swPTPClockDomainName	1.3.6.1.4.1.171.12.94.1.1.6.1.3	DisplayString	read-write	This indicates the domain name of swPTPClockDomainNumber.
swPTPPortCFG	1.3.6.1.4.1.171.12.94.1.2
swPTPPortTable	1.3.6.1.4.1.171.12.94.1.2.1		not-accessible	This table contains the per port state of the PTP clock.
swPTPPortEntry	1.3.6.1.4.1.171.12.94.1.2.1.1		not-accessible	This is an entry of the swPTPPortTable.
INT swPTPPort	1.3.6.1.4.1.171.12.94.1.2.1.1.1	INTEGER	not-accessible	This indicates the PTP port number.
INT swPTPPortState	1.3.6.1.4.1.171.12.94.1.2.1.1.2	INTEGER	read-write	This indicates the port state of the PTP clock.
swPTPBoundaryPortCFGTable	1.3.6.1.4.1.171.12.94.1.2.2		not-accessible	This table contains the per port attributes of the PTP boundary clock. These attributes takes effect when the PTP device type is boundary.
swPTPBoundaryPortCFGEntry	1.3.6.1.4.1.171.12.94.1.2.2.1		not-accessible	This is an entry of the swPTPBoundaryPortTable.
INT swPTPBoundaryPortAnnounceInterval	1.3.6.1.4.1.171.12.94.1.2.2.1.1	INTEGER	read-write	This indicates the mean time interval between successive announce messages. In line with the IEEE1588 protocol, the value of the announce interval will be represented as the logarithm to base 2 of this time measured in seconds. The range is 1-16, so the import value must either be 1, 2, 4, 8, or 16. If the input is not allowed, then the input should be automatically adjusted to allow the biggest and closest value.
INT swPTPBoundaryPortAnnounceTimeout	1.3.6.1.4.1.171.12.94.1.2.2.1.2	INTEGER	read-write	This indicates the announce interval number that has to pass without receipt of an Announce message before the occurrence of the ANNOUNCE_RECEIPT_TIMEOUT_EXPIRES event. This value multiplied by the announce interval value is equal to the interval time of the announce receipt timeout.
INT swPTPBoundaryPortSyncInterval	1.3.6.1.4.1.171.12.94.1.2.2.1.3	INTEGER	read-write	This indicates the mean time interval between successive Sync messages. In line with the IEEE1588 protocol, the value of the sync interval shall be represented as the logarithm to base 2 of this time measured in seconds. So the import value must either be 0.5, 1 or 2.
INT swPTPBoundaryPortDelayReqInterval	1.3.6.1.4.1.171.12.94.1.2.2.1.4	INTEGER	read-write	This indicates the permitted mean time interval between successive delay request messages which are sent by a slave to a specific port on the master. In line with the IEEE1588 protocol, the value of delay req interval shall be an exponent of 2. In addition, this interval shall be an integer with the minimum value being sync interval, and the maximum value being 32 times the sync interval value. The actual range of the allowed exponent of the interval delay request is [logSyncInterval+0, logSyncInterval+5]. If the sync interval is half a second and the delay req interval is 0, then the permitted time interval between successive delay request messages will be automatically adjusted to one second.
INT swPTPBoundaryPortPDelayReqInterval	1.3.6.1.4.1.171.12.94.1.2.2.1.5	INTEGER	read-write	This indicates the permitted mean time interval between successive pdelay request messages. In line with the IEEE1588 protocol, the value of pdelay req interval shall be represented as the logarithm to base 2 of this time measured in seconds. The range is 1-32, so the import value must be either 1, 2, 4, 8, 16 or 32. If the input is not allowed, then the input will be automatically adjusted to allow for the bigger and closest value.
INT swPTPBoundaryPortDelayMechanism	1.3.6.1.4.1.171.12.94.1.2.2.1.6	INTEGER	read-write	This indicates the mechanism for measuring the propagation delay time of an event message. e2e: End-to-End indicates that the port is configured to use the delay request-response mechanism. p2p: Peer-to-Peer is the peer delay mechanism
swPTPp2pTransparentPortCFGTable	1.3.6.1.4.1.171.12.94.1.2.3		not-accessible	This table contains the per port attribute for the P2P transparent clock.
swPTPp2pTransparentPortCFGEntry	1.3.6.1.4.1.171.12.94.1.2.3.1		not-accessible	This is an entry of the swPTPPortTable.
INT swPTPp2pTransparentPortPDelayReqInterval	1.3.6.1.4.1.171.12.94.1.2.3.1.1	INTEGER	read-write	This indicates the permitted mean time interval between successive pdelay request messages. In line with the IEEE1588 protocol, the value of the pdelay req interval shall be represented as the logarithm to base 2 of this time measured in seconds. The range is 1-32, so the import value must be either 1, 2, 4, 8, 16 or 32. If the input is not allowed, then the input will be automatically adjusted to allow the biggest and closest value.
swPTPPortInfo	1.3.6.1.4.1.171.12.94.1.3
swPTPBoundaryPortInfoTable	1.3.6.1.4.1.171.12.94.1.3.1		not-accessible	This table contains the per port active attributes of the PTP boundary clock. This table will display when the PTP device type is boundary.
swPTPBoundaryPortInfoEntry	1.3.6.1.4.1.171.12.94.1.3.1.1		not-accessible	This is an entry of the swPTPBoundaryPortTable.
INT swPTPBoundaryPortRole	1.3.6.1.4.1.171.12.94.1.3.1.1.1	INTEGER	read-only	This indicates the port role.
INT swPTPBoundaryPortDM	1.3.6.1.4.1.171.12.94.1.3.1.1.2	INTEGER	read-only	This indicates the propagation delay measuring mechanism.
INT swPTPBoundaryPortAI	1.3.6.1.4.1.171.12.94.1.3.1.1.3	INTEGER	read-only	This indicates the mean time interval between successive announce messages.
INT swPTPBoundaryPortART	1.3.6.1.4.1.171.12.94.1.3.1.1.4	INTEGER	read-only	This indicates the timeout that has to pass without the receipt of an announce message.
INT swPTPBoundaryPortSI	1.3.6.1.4.1.171.12.94.1.3.1.1.5	INTEGER	read-only	This indicates the mean time interval between successive synchronization messages.
INT swPTPBoundaryPortDRIM	1.3.6.1.4.1.171.12.94.1.3.1.1.6	INTEGER	read-only	This indicates the master clock. This value is used by the slave clock to specify the mean time interval between successive delay request messages.
INT swPTPBoundaryPortDRIS	1.3.6.1.4.1.171.12.94.1.3.1.1.7	INTEGER	read-only	This indicates the slave clock. This value specifies the mean time interval between successive delay request messages sent by a slave.
INT swPTPBoundaryPortPDRI	1.3.6.1.4.1.171.12.94.1.3.1.1.8	INTEGER	read-only	This indicates the mean time interval between successive pdelay request messages.
INT swPTPBoundaryPortPMPD	1.3.6.1.4.1.171.12.94.1.3.1.1.9	INTEGER	read-only	This indicates the estimate of the current one-way propagation delays on the link.
INT swPTPBoundaryPortState	1.3.6.1.4.1.171.12.94.1.3.1.1.10	INTEGER	read-only	This indicates the port active state.
swPTPp2pTransparentPortInfoTable	1.3.6.1.4.1.171.12.94.1.3.2		not-accessible	This table contains the per port active attributes of PTP p2p-transparent clock. This table will display when the PTP device type is p2p-transparent.
swPTPp2pTransparentPortInfoEntry	1.3.6.1.4.1.171.12.94.1.3.2.1		not-accessible	This is an entry of the swPTPp2pTransparentPortTable.
INT swPTPp2pTransparentPortPDRI	1.3.6.1.4.1.171.12.94.1.3.2.1.1	INTEGER	read-only	This indicates the mean time interval between successive pdelay request messages.
INT swPTPp2pTransparentPortPMPD	1.3.6.1.4.1.171.12.94.1.3.2.1.2	INTEGER	read-only	This indicates the estimated number of current one-way propagation delays on the link.
INT swPTPp2pTransparentPortState	1.3.6.1.4.1.171.12.94.1.3.2.1.3	INTEGER	read-only	This indicates the port active state.
swPTPe2eTransparentPortInfoTable	1.3.6.1.4.1.171.12.94.1.3.3		not-accessible	This table contains the per port active attributes of the PTP e2e-transparent clock. This table will display when the PTP device type is e2e-transparent.
swPTPe2eTransparentPortInfoEntry	1.3.6.1.4.1.171.12.94.1.3.3.1		not-accessible	This is an entry of the swPTPe2eTransparentPortTable.
INT swPTPe2eTransparentPortState	1.3.6.1.4.1.171.12.94.1.3.3.1.3	INTEGER	read-only	This indicates the port active state.
swPTPClock	1.3.6.1.4.1.171.12.94.1.4
swPTPBoundaryClockTable	1.3.6.1.4.1.171.12.94.1.4.1		not-accessible	This table contains the per unit information of PTP boundary clock.
swPTPBoundaryClockEntry	1.3.6.1.4.1.171.12.94.1.4.1.1		not-accessible	This is an entry of the swPTPBoundaryClockTable.
OCT swPTPBoundaryClockIdentity	1.3.6.1.4.1.171.12.94.1.4.1.1.1	OCTET STRING	read-only	This indicates the PTP boundary clock identity. 8-octet array, The first 3 octets of the MAC address are assigned in order to the first 3 octets of the clockIdentity. Octets with index 3 and 4 are respectively assigned hex values FF and FE. The remaining 3 octets of the MAC address are assigned in order to the last 3 octets of the clockIdentity.
INT swPTPBoundaryClockClass	1.3.6.1.4.1.171.12.94.1.4.1.1.2	INTEGER	read-only	This indicates the PTP boundary clock class.
INT swPTPBoundaryClockStepsRemoved	1.3.6.1.4.1.171.12.94.1.4.1.1.3	INTEGER	read-only	This indicates the number of communication paths traversed between the local clock and the grandmaster clock.
STR swPTPBoundaryClockLastOffset	1.3.6.1.4.1.171.12.94.1.4.1.1.4	DisplayString	read-only	This indicates the time offset between a master and a slave as computed by the slave.
STR swPTPBoundaryClockMeanPathDelay	1.3.6.1.4.1.171.12.94.1.4.1.1.5	DisplayString	read-only	This indicates the mean propagation time between a master and a slave clock as computed by the slave.
POR swPTPBoundaryClockEnabledPorts	1.3.6.1.4.1.171.12.94.1.4.1.1.6	PortList	read-only	This indicates the PTP boundary clock enabled ports.
swPTPTransparentClockTable	1.3.6.1.4.1.171.12.94.1.4.2		not-accessible	This table contains the per unit information of PTP transparent clock.
swPTPTransparentClockEntry	1.3.6.1.4.1.171.12.94.1.4.2.1		not-accessible	This is an entry of the swPTPTransparentClockTable.
INT swPTPTransparentClockDelayMechanism	1.3.6.1.4.1.171.12.94.1.4.2.1.1	INTEGER	read-only	This indicates the PTP transparent clock mode.
OCT swPTPTransparentClockIdentity	1.3.6.1.4.1.171.12.94.1.4.2.1.2	OCTET STRING	read-only	This indicates the PTP clock identity. 8-octet array, The first 3 octets of the MAC address are assigned in order to the first 3 octets of the clockIdentity. Octets with index 3 and 4 are respectively assigned hex values FF and FE. The remaining 3 octets of the MAC address are assigned in order to the last 3 octets of the clockIdentity.
POR swPTPTransparentClockEnabledPorts	1.3.6.1.4.1.171.12.94.1.4.2.1.3	PortList	read-only	This indicates the PTP transparent clock enabled ports.
swPTPClockParent	1.3.6.1.4.1.171.12.94.1.5
swPTPBoundaryClockParentTable	1.3.6.1.4.1.171.12.94.1.5.1		not-accessible	This table contains the per unit information of PTP boundary clock parent.
swPTPBoundaryClockParentEntry	1.3.6.1.4.1.171.12.94.1.5.1.1		not-accessible	This is an entry of the swPTPBoundaryClockParentTable.
OCT swPTPParentPortIdentity	1.3.6.1.4.1.171.12.94.1.5.1.1.1	OCTET STRING	read-only	This indicates the PTP parent port identity.
INT swPTPParentPortNumber	1.3.6.1.4.1.171.12.94.1.5.1.1.2	INTEGER	read-only	This indicates the PTP parent port number.
OCT swPTPGrandmasterIdentity	1.3.6.1.4.1.171.12.94.1.5.1.1.3	OCTET STRING	read-only	This indicates the PTP grandmaster identity.
INT swPTPGrandmasterClockClass	1.3.6.1.4.1.171.12.94.1.5.1.1.4	INTEGER	read-only	This indicates the PTP grandmaster clock class.
INT swPTPGrandmasterClockAccuracy	1.3.6.1.4.1.171.12.94.1.5.1.1.5	INTEGER	read-only	This indicates the PTP grandmaster clock accuracy.
INT swPTPGrandmasterPriority1	1.3.6.1.4.1.171.12.94.1.5.1.1.6	INTEGER	read-only	This indicates the PTP grandmaster priority 1.
INT swPTPGrandmasterPriority2	1.3.6.1.4.1.171.12.94.1.5.1.1.7	INTEGER	read-only	This indicates the PTP grandmaster priority 2.
swPTPForeignMaster	1.3.6.1.4.1.171.12.94.1.6
swPTPForeignMasterTable	1.3.6.1.4.1.171.12.94.1.6.1		not-accessible	This table contains the current records of the foreign master data set of the boundary clock's special ports.
swPTPForeignMasterEntry	1.3.6.1.4.1.171.12.94.1.6.1.1		not-accessible	This is an entry of the swPTPForeignMasterTable.
OCT swPTPFMPortIdentity	1.3.6.1.4.1.171.12.94.1.6.1.1.1	OCTET STRING	not-accessible	This indicates the identity of the foreign master port.
INT swPTPFMPortNumber	1.3.6.1.4.1.171.12.94.1.6.1.1.2	INTEGER	not-accessible	This indicates the number of the foreign master port.
INT swPTPFMAnnounceMsg	1.3.6.1.4.1.171.12.94.1.6.1.1.3	INTEGER	read-only	This indicates the number of foreign master announce messages.

RFC description

Manages Precision Time Protocol configuration and monitoring for clock synchronization.

Start monitoring D-Link switches, e.g. layer-3 managed switch series, supporting IEEE 1588 PTP with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download PTP-MIB

What Is PTP-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description