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.

Example

The following command displays on slot 2-3 on port 1 and slot 12 on port 10 on a modular switch:

  BD-X8.34 # show ports 1:1,2:1-2 buffer    
Packet Buffer Allocation for ports in range 1:1-12,1:25-36    
 Total Packet Buffer Size: 9584640 bytes, Not Overcommitted    
 Total Shared Buffer Size: 9051328     
  Port 1:1  Max Shared Buffer Usage: 8055632 bytes (89%)      
   QP1: Reserved Buffer: 3328 bytes      
   QP8: Reserved Buffer: 1664 bytes      
   MCQ: Reserved Buffer: 1664 bytes   
Packet Buffer Allocation for ports in range 2:1-12,2:25-36    
 Total Packet Buffer Size: 9584640 bytes, Not Overcommitted    
 Total Shared Buffer Size: 9051328     
  Port 2:1  Max Shared Buffer Usage: 1810224 bytes (20%)      
   QP1: Reserved Buffer: 3328 bytes      
   QP8: Reserved Buffer: 1664 bytes      
   MCQ: Reserved Buffer: 1664 bytes     
  Port 2:2  Max Shared Buffer Usage: 1810224 bytes (20%)      
   QP1: Reserved Buffer: 3328 bytes      
   QP8: Reserved Buffer: 1664 bytes      
   MCQ: Reserved Buffer: 1664 bytes   
BD-X8.35 #    

History

This command was first available in ExtremeXOS 15.3.

Platform Availability

This command is available on all platforms.