show ports buffer

show ports port_list buffer

Description

Displays the packet buffer organization for the specified ports.

Syntax Description

port_list Optionally specifies the list of ports, or slots and ports, for which packet buffer information is displayed. If the port_list is omitted then packet buffer information is displayed for all ports in the system.

Default

N/A.

Usage Guidelines

This command shows the packet buffer organization for the specified ports.

The port_list can span multiple ranges. The packet buffer description for each such port range is displayed.

Since ports and packet buffer are grouped by the hardware, the command displays the range of ports that share the same packet buffer.

The Total Packet Buffer Size for the port range is displayed in bytes, along with an indication of whether or not the user has configured over-commitment of the packet buffer (not overcommitted by default).

The amount of Reserved Buffer allocated to each port and QoS Profile is shown for the ports in the user-specified port_list. To configure the reserved buffer, use the configure qosprofile qosprofile maxbuffer percentage ports port_list command.

The Total Shared Buffer Size displayed is the Total Packet Buffer Size minus the total Reserved Buffer allocated to all ports and QoS profiles in the port range. Note that some packet buffer is also reserved to internal ports.  

For each port, the maximum of the Total Shared Buffer Size that the port is allowed to use (Max Shared Buffer Usage) is shown both as an absolute number of bytes and as a percentage of the Total Shared Buffer Size. A port‘s Max Shared Buffer Usage may be configured using the command   configure ports {port_list} shared-packet-bufferpercentage  

Note the configured percentage may be different than the displayed percentage. This is because more recent hardware can only allocate shared packet buffer in steps, while older hardware can precisely allocate the requested percentage.  

The more recent hardware dynamically adjusts each port‘s shared buffer usage limit based on simultaneous usage by multiple ports and QoS profiles, automatically providing fair usage of the shared buffer among the ports and QoS profiles that are currently demanding buffer space. This allows larger packet buffer usage bursts on a port when other ports are not using shared buffer. This dynamic adjustment cannot be observed with this command since only the maximum possible limits are displayed.

The VLAN name is displayed only if that port contains a single VLAN. If the port contains more than one VLAN, then the number of VLANs is displayed.

The tag value may be associated with either a VMAN or a VLAN.

The Pipe bytes descriptor is only displayed on platforms with multiple pipelines, such as the Extreme 7720.

Example

The following example displays port buffer information for ports 1:1, 17:1:

# show ports 1:1,17:1 buffer
Packet Buffer Allocation for ports in range 1-130
Total Packet Buffer Size: 33030144 bytes (16515072 bytes per Pipe), Not Overcommitted
Total Shared Buffer Size: 31899648 bytes
  Port 1:1 Max Shared Buffer Usage: 3194880 bytes (20% of 15974400 Pipe bytes)
   QP1: Reserved Buffer: 4096 bytes
   QP2: Reserved Buffer: 4096 bytes
   QP3: Reserved Buffer: 4096 bytes
   QP4: Reserved Buffer: 4096 bytes
   QP5: Reserved Buffer: 4096 bytes
   QP6: Reserved Buffer: 4096 bytes
   QP7: Reserved Buffer: 4096 bytes
   QP8: Reserved Buffer: 4096 bytes
  Port 17:1 Max Shared Buffer Usage: 3184896 bytes (20% of 15925248 Pipe bytes)
   QP1: Reserved Buffer: 4096 bytes
   QP2: Reserved Buffer: 4096 bytes
   QP3: Reserved Buffer: 4096 bytes
   QP4: Reserved Buffer: 4096 bytes
   QP5: Reserved Buffer: 4096 bytes
   QP6: Reserved Buffer: 4096 bytes
   QP7: Reserved Buffer: 4096 bytes
   QP8: Reserved Buffer: 4096 bytes

History

This command was first available in ExtremeXOS 15.3.

Platform Availability

This command is available on all Universal switches supported in this document.