bcmsh: the Broadcom diag shell
The Broadcom diag shell is the command interpreter built into the Broadcom
switch SDK. On SONiC switches it is reached with bcmsh or bcmcmd and
shows the prompt drivshell>. It gives direct access to the switch ASIC:
port status, forwarding tables, registers, counters and the SDK API.
This guide describes the shell as shipped with SONiC for Trident 3
(BCM56870) switches. It covers how to reach the shell, the concepts its
commands share, task-oriented how-tos, and a reference entry for every
command, including those not listed by help.
New here? Start with Accessing the shell and Reading this guide, then look up commands in the Command reference or the Index.
Who we are
This is a collection of knowledge we have gathered while running SONIX, the first free and open source IX in Sweden. Come say hi if this is useful to you!
Getting started
Concepts
How-to
- SONiC and SDK troubleshooting
- KNET and the CPU port
- Capturing port traffic with tcpdump
- Protecting the CPU with CoPP
- Troubleshooting queues and buffers
- Debugging ACL rules
- Debugging a link
- PHYs and RJ-45 SFPs
- Building an L2 switch with VLANs and SVIs
- Port channels and LACP
- Inspecting L3 forwarding
- MPLS label switching
- VXLAN tunnels
- In-band Flow Analyzer (IFA 2.0)
- Changing the chip configuration live
- Cint recipes
Command reference
Appendix