Shared Buffer Commands
traffic pool <name> [force] Creates a traffic pool and enters the traffic pool context on prefix mode enabled. | ||
Syntax Description | name | String up to 20 characters |
force | Enforces configuration | |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.5000 | |
Example | switch (config)# traffic pool name | |
Related Commands | ||
Notes |
type <type> Configures the traffic pool type. | ||
Syntax Description | type |
|
Default | Lossy | |
Configuration Mode | config pool | |
History | 3.6.5000 | |
Example | switch (config pool name)# type lossless | |
Related Commands | ||
Notes | When using “traffic pool <name> type <type>”, if the traffic pool does not exist then it is created. |
map switch-priority <list-of-priorities> Maps switch-priorities to the traffic pool. | ||
Syntax Description | list-of-priorities | Range: 0-7 |
Default | N/A | |
Configuration Mode | config pool | |
History | 3.6.5000 | |
Example | switch (config pool name)# map switch-priority 2 3 1 7 | |
Related Commands | ||
Notes | When using “traffic pool <name> map switch-priority <list-of-priorities>”, if the traffic pool does not exist then it is created. |
type {lossless | lossy | lossy-mc} map switch-priority <priority> Configures type of traffic pool and maps switch-priorities to it. | ||
Syntax Description | type |
|
priority | Range: 0-7 | |
Default | Type: Lossy | |
Configuration Mode | config pool | |
History | 3.6.5000 | |
Example | switch (config pool name)# type lossy-mc map switch-priority 2 3 1 7 | |
Related Commands | ||
Notes | When using “traffic pool <name> type <type> map switch-priority <priority>”, if the traffic pool does not exist the it is created. |
memory percent [<percent>] Sets traffic pool size in percentage out of entire shared buffer memory. | ||
Syntax Description | percent | Range: 0.00-100.00 or “auto” |
Default | Auto | |
Configuration Mode | config pool | |
History | 3.6.5000 | |
Example | switch (config pool name)# memory percent 50.03 | |
Related Commands | ||
Notes |
|
advanced buffer management [force] Enable the advanced mode shared buffer configuration. | ||
Syntax Description | force | Run command skipping confirmation prompt |
Default | Disabled | |
Configuration Mode | config | |
History | 3.6.5000 | |
3.6.8008 | Updated Note field | |
Example | switch (config)# advanced buffer management force | |
Related Commands | ||
Notes | When moving advanced buffer management from disable to enable, buffer/PFC configuration returns all shared buffer configuration to default. |
ingress-buffer <buffer-name> Creates and enters the ingress buffer context. | ||
Syntax Description | buffer-name | Name of ingress buffer |
Default | N/A | |
Configuration Mode | config interface ethernet | |
History | 3.6.1002 | |
Example | switch (config interface ethernet 1/1)# ingress-buffer iPort.pg1 | |
Related Commands | ||
Notes | iPort.pg9 is reserved for control traffic and hence cannot be edited |
egress-buffer <buffer-name> Creates and enters the buffer context. | ||
Syntax Description | buffer-name | Name of egress buffer |
Default | N/A | |
Configuration Mode | config interface ethernet | |
History | 3.6.1002 | |
Example | switch (config interface ethernet 1/1)# egress-buffer ePort.tc4 | |
Related Commands | ||
Notes | ePort.tc16 is reserved for control traffic and hence cannot be edited |
reserved <value> shared size <size> Configures the ePort.mc multicast-buffer. | ||
Syntax Description | buffer-name | Name of egress buffer |
value | Amount of reserved memory for buffer in bytes | |
shared size | Shared memory in bytes or “infinite” | |
Default | According to system default OOB configuration | |
Configuration Mode | config interface ethernet egress-buffer | |
History | 3.6.5000 | |
Example | switch (config 1/1 egress-buffer ePort.mc)# reserved 5k shared alpha 1/128 | |
Related Commands | ||
Notes |
|
pool <pool-name> size <value> type {static | dynamic} Creates pool. | ||
Syntax Description | pool-name | Possible values:
|
size | Size of pool in bytes, or “inf” for infinite | |
Default | According to system default OOB configuration | |
Configuration Mode | config | |
History | 3.6.5000 | |
Example | switch (config)# pool iPool2 size 2M type dynamic | |
Related Commands | ||
Notes | It is possible to use “K” for kilobytes and “M” for megabytes to define pool size. |
pool <pool-name> reserved <reserved> shared <shared units> <shared> Configures the buffer. | ||
Syntax Description | pool-name | Possible values: iPool0-iPool7 |
reserved | Amount of reserved memory for the buffer in bytes | |
shared units | The amount of shared memory for this buffer
| |
Default | According to system default OOB configuration | |
Configuration Mode | config interface ethernet egress-buffer | |
History | 3.6.1002 | |
Example | switch (config interface ethernet 1/1 ingress-buffer iPort)# pool iPool0 reserved 90K shared alpha 1/8 | |
Related Commands | ||
Notes |
map [pool <pool name> type <type> [xoff <xoff-value> xon <xon value>] reserved <reserved size> shared <shared units> <shared size>] Maps iPort.pg buffer to a given pool and sets its reserved and shared sizes. | ||
Syntax Description | pool-name | Possible values: iPool0 ... iPool7 |
type | Possible values: lossy, lossless | |
reserved size | Amount of reserved memory for the buffer in bytes | |
shared units | Possible values: size, alpha, max | |
shared size | The amount of shared memory for this buffer
Shared size depends on type and size of the given pool:
| |
xoff | Relevant only on lossless type, Xoff threshold in bytes | |
xon | Relevant only on lossless type, Xon threshold in bytes | |
Default | According to system default OOB configuration | |
Configuration Mode | config interface ethernet ingress-buffer | |
History | 3.6.1002 | |
3.6.5000 | Updated command syntax | |
Example | switch (config interface ethernet 1/9 ingress-buffer iPort.pg5)# map pool iPool6 type lossy reserved 3k shared alpha 2 | |
Related Commands | ||
Notes |
|
bind switch-priority <list-of-switch-priorities> Bind a switch priority (SP) to an ingress buffer. | ||
Syntax Description | list-of-switch-priorities | Possible values: 0-7 |
Default | According to system default OOB configuration | |
Configuration Mode | config interface ethernet ingress-buffer | |
History | 3.6.1002 | |
Example | switch (config interface ethernet 1/1 ingress-buffer iPort.pg1)# bind switch-priority 0 1 | |
Related Commands | ||
Notes |
description <description> Configures buffer description. | ||
Syntax Description | description | Text string |
Default | “” | |
Configuration Mode | config interface ethernet egress-buffer | |
History | 3.6.1002 | |
Example | switch (config interface ethernet 1/1 ingress-buffer iPort.pg1)# description example | |
Related Commands | ||
Notes |
pool <pool-name> mc-buffer <buffer> reserved <reserved> shared <shared units> <shared-size> Maps MC-buffer to specified egress pool and sets its reserved and shared sizes. | ||
Syntax Description | mc-buffer | Buffer can have the values mc.sp0, mc.sp1...mc.sp7 |
reserved | The amount of shared memory for this buffer | |
shared | The amount of shared memory for this buffer
| |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.1002 | |
3.6.5000 | Added “size” parameter and note | |
Example | switch (config)# pool ePool4 mc-buffer mc.sp6 reserved 3k shared size 2K | |
Related Commands | ||
Notes |
|
clear buffers pool mc-buffers max-usage Clears max-usage statistics for MC.SP (multicast switch priority, mc.sp0 – mc.sp7) shared buffers. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | config | |
History | 3.8.1000 | |
Example | switch (config)# clear buffers pool mc-buffers max-usage | |
Related Commands | ||
Notes |
clear buffers interface ethernet <interface name> max-usage Clears max-usage indicator for all buffers of an interface. | ||
Syntax Description | Name of the interface | |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.1002 | |
3.8.2000 | Added the command to the user manual | |
Example | switch (config) # clear buffers interface ethernet 1/1 max-usage | |
Related Commands | ||
Notes |
clear buffers interface max-usage Clears max-usage indicator for all buffers of all interfaces. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.1002 | |
3.8.2000 | Added the command to the user manual | |
Example | switch (config) # clear buffers interface max-usage | |
Related Commands | ||
Notes |
clear buffers pool <pool name> max-usage Clears max-usage indicator for a specific pool. | ||
Syntax Description | pool name | Name of the ingress/egress pool |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.1002 | |
3.8.2000 | Added the command to the user manual | |
Example | switch (config) # clear buffers pool iPool2 max-usage | |
Related Commands | ||
Notes |
clear buffers pool max-usage Clears max-usage indicator for all pools. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.1002 | |
3.8.2000 | Added the command to the user manual | |
Example | switch (config) # clear buffers pool max-usage | |
Related Commands | ||
Notes |
pool <pool-name> description <description> Configures the buffer description of a specific pool-name. | ||
Syntax Description | pool-name | Possible values:
|
description | String text (20 character max) | |
Default | “” | |
Configuration Mode | config | |
History | 3.6.1002 | |
Example | switch (config)# pool iPool6 description mapped-to-pg3 | |
Related Commands | ||
Notes |
cable-length [<meters>] Configures the cable length in meters for the given port. | ||
Syntax Description | meters | Cable length in meters |
Default | N/A | |
Configuration Mode | config interface ethernet | |
History | 3.6.5000 | |
Example | switch (config interface ethernet 1/4)# cable-length 10 | |
Related Commands | show interfaces ethernet cable-length | |
Notes |
|
show buffers mode Displays current mode for shared buffers. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.5000 | |
Example | switch (config)# show buffers mode | |
Related Commands | ||
Notes |
show buffers status [interfaces ethernet <slot>/<port>] Displays buffer usage status. | ||
Syntax Description | <slot>/<port> | Ethernet interface |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.1002 | |
3.6.5000 | Updated example | |
3.6.6000 | Updated example | |
3.8.2000 | Updated example | |
Example | ---------------------------------------------------------------------------------------------------------------------- Interface Buffer Pool Resv Shared Usage MaxUsage Resv/Hdrm Usage Resv/Hdrm MaxUsage [Byte] [%/a/Byte] [Byte] [Byte] [Byte] [Byte] ---------------------------------------------------------------------------------------------------------------------- Eth1/1 iPort.iPool0 iPool0 10.0K alpha 8 0 0 n/a n/a Eth1/1 iPort.iPool1 iPool1 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPool2 iPool2 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPool3 iPool3 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPool4 iPool4 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPool5 iPool5 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPool6 iPool6 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPool7 iPool7 0 alpha 0 0 0 n/a n/a Eth1/1 iPort.iPoolCtrl iPoolCtrl 0 alpha 8 0 0 n/a n/a Eth1/1 iPort.pg0 iPool0 0 alpha 8 0 0 0 0 Eth1/1 iPort.pg1 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg2 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg3 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg4 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg5 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg6 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg7 iPool0 0 alpha 0 0 0 0 0 Eth1/1 iPort.pg9 iPoolCtrl 10.0K alpha 8 0 0 0 0 Eth1/1 ePort.ePool0 ePool0 10.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.ePool1 ePool1 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.ePool2 ePool2 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.ePool3 ePool3 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.ePool4 ePool4 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.ePool5 ePool5 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.ePool6 ePool6 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.ePool7 ePool7 0 alpha 0 0 0 n/a n/a Eth1/1 ePort.mc ePool15 10.0K 90.0K 0 0 n/a n/a Eth1/1 ePort.ePoolCtrl ePoolCtrl 0 alpha 8 0 0 n/a n/a Eth1/1 ePort.tc0 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc1 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc2 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc3 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc4 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc5 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc6 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc7 ePool0 1.0K alpha 8 0 0 n/a n/a Eth1/1 ePort.tc16 ePoolCtrl 1.0K alpha 8 0 0 n/a n/a | |
Related Commands | ||
Notes | Resv/Hdrm Usage/MaxUsage counters specify the usage of reserved buffer set for lossless PG buffers, and of headroom buffer set to fixed 20KB for lossy PG buffers. |
show buffers details [ <id>] Displays buffer status in details. | ||
Syntax Description | <slot>/<port> | Ethernet interface |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.1002 | |
3.6.5000 | Updated Example | |
3.7.1000 | Updated Example | |
Example |
switch-priority to Buffers mapping: | |
Related Commands | ||
Notes |
show buffers pools [pool-name] Displays buffer pool statistics. | ||
Syntax Description | pool-name |
|
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.1002 | |
3.6.5000 | Updated example output | |
Example |
| |
Related Commands | ||
Notes | When advanced buffer management is disabled, the “Description” field specifies the e/iPool’s relevant traffic pool name. |
show buffers pools [<pool-name>] mc-buffers Displays global multicast buffers usage status. | ||
Syntax Description | pool-name | Possible values: ePool0 ... ePool7 |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.5000 | |
Example | switch (config)# show buffers pools ePool4 mc-buffers | |
Related Commands | ||
Notes |
show traffic pool [<name>] Displays state and configuration information for a given traffic pool. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.5000 | |
Example |
| |
Related Commands | ||
Notes |
|
show traffic pool <name> <device/port> interface ethernet <slot>/<port> Displays state and configuration information for the buffers on a given port related to a given traffic pool. | ||
Syntax Description | <slot>/<port> | Ethernet interface |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.5000 | |
3.8.2000 | Updated example | |
Example |
| |
Related Commands | ||
Notes | The “Exception list” section displays messages to indicate unrecommended configuration. See section “Exceptions to Legal Shared Buffer Configuration” for more details. |