Packet Path Troubleshoot
PREVIEW — for evaluation, not the live site

Troubleshoot › Error Decoder

Error Message Decoder

Paste the exact line your device printed — or just its code, like %PM-4-ERR_DISABLE — and get the plain-English meaning, the likely causes in order, the commands to run, and the fix. Every entry is written from vendor documentation; an entry earns a "Verified in lab" label only after the fault has been reproduced and the fix proven in a Packet Path lab.

17 messages decoded so far. New entries are added from the problems engineers ask about most.

All decoded messages

Decoder

%PM-4-ERR_DISABLE

Port shut itself off (err-disabled): link-flap

The switch saw the link on this port drop and come back 5 times within 10 seconds (the default flap setting) and shut the port down on purpose to protect the network.

Meaning, causes, check commands and the fix →

Decoder

%PORT_SECURITY-2-PSECURE_VIOLATION

Port security violation: port shut down

The port is configured to allow only certain MAC addresses (the hardware addresses of approved devices).

Meaning, causes, check commands and the fix →

Decoder

%BGP-5-ADJCHANGE

BGP neighbor went down (or came up)

A BGP session — the connection that exchanges routes with a neighboring network — dropped.

Meaning, causes, check commands and the fix →

Decoder

%OSPF-5-ADJCHG

OSPF neighbor dropped

Two routers that were exchanging routes with OSPF stopped hearing from each other.

Meaning, causes, check commands and the fix →

Decoder

%LINK-3-UPDOWN · %LINEPROTO-5-UPDOWN

Interface went down (and its line protocol followed)

The physical link on this port dropped.

Meaning, causes, check commands and the fix →

Decoder

%CDP-4-DUPLEX_MISMATCH

Duplex mismatch between two connected devices

The two ends of one cable disagree about how to talk.

Meaning, causes, check commands and the fix →

Decoder

%CDP-4-NATIVE_VLAN_MISMATCH

Native VLAN mismatch on a trunk

A trunk is a link carrying many VLANs (separate virtual networks) between switches.

Meaning, causes, check commands and the fix →

Decoder

%SPANTREE-2-BLOCK_PVID_LOCAL

Spanning tree blocked a port: VLAN inconsistency

Spanning tree — the safety system that prevents network loops — detected that this port's VLAN setup contradicts what is arriving on it, and blocked the port to protect the network.

Meaning, causes, check commands and the fix →

Decoder

%UDLD-4-UDLD_PORT_DISABLED

UDLD shut the port: one-way link detected

UDLD is a watchdog that checks a link works in BOTH directions.

Meaning, causes, check commands and the fix →

Decoder

%IP-4-DUPADDR

Duplicate IP address on the network

Two devices are claiming the same IP address.

Meaning, causes, check commands and the fix →

Decoder

%EC-5-CANNOT_BUNDLE2

EtherChannel refused: ports do not match

Several physical links can be bundled into one logical link (an EtherChannel / port-channel) — but only if every port in the bundle is configured identically.

Meaning, causes, check commands and the fix →

Decoder

%HSRP-4-STATECHANGE

HSRP router keeps changing role

HSRP pairs two routers so devices see one 'virtual' gateway; one router is Active (working) and the other is Standby (waiting).

Meaning, causes, check commands and the fix →

Decoder

%DUAL-5-NBRCHANGE

EIGRP neighbor dropped

EIGRP, Cisco's routing protocol, lost a neighbor.

Meaning, causes, check commands and the fix →

Decoder

%CRYPTO-4-RECVD_PKT_INV_SPI

IPsec VPN received a packet it cannot place

A VPN tunnel received an encrypted packet stamped with a security ID (SPI) that this router no longer knows.

Meaning, causes, check commands and the fix →

Decoder

%SPANTREE-2-LOOPGUARD_BLOCK

Loop Guard blocked a port: possible one-way trouble

Loop Guard is a spanning-tree safety net.

Meaning, causes, check commands and the fix →

Decoder

%SPANTREE-2-BLOCK_BPDUGUARD

BPDU Guard shut the port: something switch-like appeared on an access port

BPDU Guard is a tripwire on ports meant for end devices — PCs, phones, printers.

Meaning, causes, check commands and the fix →

Decoder

%ETHCNTR-3-LOOP_BACK_DETECTED

Loop-back detected: the switch heard its own voice come back

The switch sends itself small keepalive frames on every port.

Meaning, causes, check commands and the fix →