FREE TOOL

Interface and port map

Paste "show interfaces status" output from a Cisco IOS or IOS XE switch. The tool reads each port's status, VLAN, duplex, speed and type, says what each status means, and lists trunk and routed ports. Add "show interfaces description" output from the same switch to get the full port descriptions and the VLAN interfaces. The map is built in this page, and the page does not send what you paste to a server. No account is required.

Switch output

This tool runs in your browser and needs JavaScript turned on. The boxes stay locked until the page script loads, so the page cannot send anything you enter. If they stay locked, the script did not load. Turn on JavaScript or reload the page to use the tool.

Paste it as the switch printed it, starting with the header line "Port Name Status Vlan Duplex Speed Type". The columns are read by position, so keep the spacing.

From the same switch, at about the same time. It adds full descriptions, line and protocol state, and VLAN interfaces.

How the output is read

"show interfaces status" prints a table with fixed column positions. The tool finds the header line, notes where each column starts, and cuts every row at those positions. It does not split rows on spaces, because a port name can hold spaces ("desk 2-115 disable" is one name). The values after the name are read in order: Status, Vlan, Duplex, Speed, and the rest of the line as Type. "show interfaces description" is read the same way, because its Status column can hold the two words "admin down".

What the status values mean

  • connected: the link is up. On the captured switch, every connected port is up and up in "show interfaces description".
  • disabled: the port is shut down by configuration. On the captured switch, both disabled ports have "shutdown" in their configuration and are "admin down".
  • err-disabled: the switch shut the port down after it detected an error. The status column does not say which error; "show interfaces status err-disabled" lists the reason. On the captured switch, Et0/1 was err-disabled with port security configured on it.
  • notconnect: the port is not connected to anything, or the cable is not seated. inactive: commonly, the VLAN the port belongs to no longer exists. These two come from Cisco's troubleshooting guide; the captured switch could not produce them.

The Vlan column holds the access VLAN for an access port, "trunk" for a trunk and "routed" for a routed port. It does not hold everything about the port. On the captured switch, Et0/0 is a trunk with native VLAN 999, which only "show interfaces trunk" shows, and Et0/2 has voice VLAN 20 configured while the Vlan column shows 10.

Why a name is cut short

The Name column is as wide as the space before the Status column, 18 characters on the captured switch. A longer description is cut, so "bldg-2 floor-3 print room MFP, port-security static MAC, ticket 4471 follow-up" shows as "bldg-2 floor-3 pri". "show interfaces description" prints the whole description, so when you paste both, the map shows the full text and notes that the status output cut it. When the two pastes disagree in a way that is not a cut, the map lists the difference instead of picking one.

To practice, take the example rows below and decide on paper which ports are trunks, which are shut down by configuration and which one the switch shut down itself. Then paste them and compare.

Port         Name               Status       Vlan       Duplex  Speed Type
Et0/0        uplink to core-rtr connected    trunk        full   auto 10/100/1000BaseTX
Et0/1        bldg-2 floor-3 pri err-disabled 30           full   auto 10/100/1000BaseTX
Et0/3        desk 2-115 disable disabled     10           full   auto 10/100/1000BaseTX
Et1/2        routed port test   connected    routed       full   auto 10/100/1000BaseTX

Output this tool does not read

The tool reads one header layout: "Port Name Status Vlan Duplex Speed Type", with the rows straight under it. A different header, a dashed line under the header, or output with no header gets a "not supported" result that says why, instead of a map built on guessed column positions. NX-OS prints the same seven columns, so the tool also checks the rows: a port named like Eth1/1 or mgmt0, or a status such as xcvrAbsen or sfpAbsent, means the output came from NX-OS, and it gets a "not supported" result too. A row that does not line up with the header, a status or VLAN value the tool does not interpret, a port the two pastes disagree about, and a switch port that is in one paste but not the other are listed as findings with the line they came from.

When a port-channel row (Po1, for example) has nothing in the Type column, the tool reads the row and shows the Type as empty. It does not fill in a type. Any other row with a missing value is listed as a finding and is not read.

Why this tool has no share link

Both boxes hold output from your switch, with port names and descriptions that can say where equipment sits and who uses it. This page never writes device output to a link, so the tool has no share link and never writes either paste to the page's URL. Use Copy results to keep a record of the map.

What this tool does not do

The map shows what one paste of each command says at the time it was taken. It does not read the configuration, so it cannot fill in native VLANs, allowed VLANs or voice VLANs. The layout was checked against output captured from Cisco IOS XE 17.12.1 running as IOL-L2 on Cisco Modeling Labs, and that virtual switch has limits a real switch does not: ports with no cable still show "connected", so it could not produce "notconnect"; every port shows Duplex "full", Speed "auto" and Type "10/100/1000BaseTX"; and it refused a speed setting. Real hardware shows negotiated values such as a-full and a-1000, where the a- prefix means the value was reached by autonegotiation. Other platforms and releases can print other columns, which the tool reports as not supported.

Sources: Cisco, Troubleshoot Switch Port and Interface Problems, for notconnect, err-disabled, inactive and the a- prefix; Cisco IOS XE 17.12 command reference, Catalyst 9300, show interfaces, for "status err-disabled" and the description keyword; Cisco NX-API CLI reference, Nexus 7000, interface commands, for the NX-OS port names and status values. The connected and disabled meanings and the IOL limits come from the captured output.