show ports sharing

show ports port_listsharing distribution configuration


Displays port load-sharing groups, or link aggregation groups (LAGs).

Syntax Description

This command has no arguments or variables.



Usage Guidelines

Output from this command displays the following information:
  • Config Master—The port that is configured as the master logical port of the link aggregation group (LAG). This number is also the LAG group ID.

  • Current Master—In LACP, this is the port that is currently the LAG group ID, or master logical port for the LAG.

  • Agg Control—This is the aggregation control for the specified LAG; it can be either static, LACP or health-check. In LACP, it is the aggregation control for the specified LAG.

  • Min Active—The minimum number of active links that must be up for the trunk to remain up.

  • Ld Share Algorithm—The algorithm used for the link aggregation. The available link aggregation algorithms vary among platforms; see the for more information.

  • Flags—Distribution mode flags: A - All: Distribute to all members, L - Local: Distribute to members local to ingress slot, P - Port Lists: Distribute to per-slot configurable subset of members.
  • Ld Share Group—The specific ports that belong to each LAG, or the port numbers in the trunk. A port can belong to only one LAG, either static or dynamic.

  • Agg Mbr—In LACP, this shows whether the port has been added to the aggregator or not; it will be either Y for yes or - for no.

  • Link State—This is the current status of the link.

  • Link Up transitions—Number of times the link has cycled through being up, then down, then up.


Following is sample output displaying link aggregation on a Summit series switch:

sh port sharing * BDX8.1 # show sharing 

Load Sharing Monitor 
Config    Current Agg     Min    Ld Share  Flags Ld Share Agg  Link  Link Up 
Master    Master  Control Active Algorithm       Group    Mbr  State Transitions 
   1:1    1:1     Static     1    L2       L     1:1       Y      A       1 
                                  L2             1:2       Y      A       1 
                                  L2             5:1       Y      A       1 
                                  L2             5:2       Y      A       1 
  1:25            Static     1    custom   A     1:25      -      R       0 
                                  custom         1:26      -      R       0 
  1:27            Static     1    L2       A     1:27      -      R       0 
                                  L2             1:28      -      R       0 
  1:29            Static     1    L2       L     1:29      -      R       0 
                                  L2             1:30      -      R       0 
Link State: A-Active, D-Disabled, R-Ready, NP-Port not present, L-Loopback 
Minimum Active: (<) Group is down. # active links less than configured minimum 
Load Sharing Algorithm: (L2) Layer 2 address based, (L3) Layer 3 address based 
                        (L3_L4) Layer 3 address and Layer 4 port based 
                        (custom) User-selected address-based configuration 
Custom Algorithm Configuration: ipv4 L3-and-L4, xor 
Distribution Mode Flags: 
        A - All: Distribute to all members 
        L - Local: Distribute to members local to ingress slot 
        P - Port Lists: Distribute to per-slot configurable subset of members 
Number of load sharing trunks: 4          

The following example shows the distribution modes and lists for a BlackDiamond X8 series switch:

* BDX8.2 # show sharing distribution configuration 
  Config    Distribution Distribution 
  Master    Mode         Lists 
  1:1       Port Lists   Slot 1: 1:1-10, 1:15 
                         Slot 5: 1:11-22 
  1:25      Local Slot   Slot 1: 1:25 
                         Slot 5: 1:26 
  5:1       Port Lists 
  5:10      All          Slot 1: 5:11 
                         Slot 5: 5:10 


This command was first available in ExtremeXOS 10.1.

The LACP feature was added in ExtremeXOS 11.3.

The Health Check LAG was added in ExtremeXOS 12.1.3.

The round-robin algorithm was added in ExtremeXOS 12.5.

Support for the Min Active parameter was added in ExtremeXOS 15.7.1.

Support for LAG distribution mode was added in ExtremeXOS 16.2.

Platform Availability

This command is available on all platforms.