https://github.com/hwipl/smc-llc
SMC LLC Protocol Parser
https://github.com/hwipl/smc-llc
command-line-tool golang link-layer-control llc network packet-capture packet-parser shared-memory-communication smc
Last synced: 4 months ago
JSON representation
SMC LLC Protocol Parser
- Host: GitHub
- URL: https://github.com/hwipl/smc-llc
- Owner: hwipl
- License: mit
- Created: 2020-01-26T12:10:56.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-05-02T08:51:12.000Z (about 1 year ago)
- Last Synced: 2025-05-02T09:49:03.728Z (about 1 year ago)
- Topics: command-line-tool, golang, link-layer-control, llc, network, packet-capture, packet-parser, shared-memory-communication, smc
- Language: Go
- Size: 137 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# smc-llc
smc-llc is a command line tool for capturing SMC LLC traffic from a network
interface or reading it from a pcap file and parsing the SMC LLC messages. The
LLC messages are part of the
[SMC protocol](https://www.rfc-editor.org/info/rfc7609) and are used to
establish SMC connections between communication partners over RoCE devices.
Although LLC messages are the main focus of this tool, it also captures and
parses RoCEv1 and RoCEv2 GRHs and BTHs as well as SMC CDC messages.
## Installation
You can download and install smc-llc with its dependencies to your GOPATH or
GOBIN with the go tool:
```console
$ go install github.com/hwipl/smc-llc/cmd/smc-llc
```
## Usage
You can run `smc-llc` with the following command line arguments:
```
-f file
read packets from a pcap file and set it to file
-http address
use http server output and listen on address (e.g.: :8000 or
127.0.0.1:8080)
-i interface
read packets from a network interface (default) and set it to interface
-pcap-filter filter
set pcap packet filter to filter (e.g.: "not port 22")
-pcap-maxpkts number
set maximum packets to capture to number (may require pcap-timeout
argument)
-pcap-maxtime seconds
set maximum capturing time to seconds (may require pcap-timeout
argument)
-pcap-promisc
set network interface to promiscuous mode (default true)
-pcap-snaplen milliseconds
set pcap timeout to milliseconds (default 2048)
-pcap-timeout milliseconds
set pcap timeout to milliseconds
-show-bth
show BTH of messages
-show-grh
show GRH of messages
-show-hex
show hex dumps of messages
-show-other
show non-LLC/CDC messages
-show-reserved
show reserved message fields
-show-timestamps
show timestamps of messages (default true)
```
### Examples
You can specify the network interface with the command line argument `-i`. Make
sure your user has the permission to capture traffic on the network interface.
For example, you can capture packets on the interface `eth0` with the following
command as the root user:
```console
# smc-llc -i eth0
```
Alternatively, you can read packets from a pcap file with the command line
argument `-f`. For example you can read the packets from pcap file `dump.pcap`
with the following command:
```console
$ smc-llc -f dump.pcap
```
You can also capture packets directly from a local Mellanox infiniband device
with the tool [ibdump](https://github.com/Mellanox/ibdump) and load the
resulting pcap file, e.g., `sniffer.pcap`, in smc-llc with the following
command:
```console
$ smc-llc -f sniffer.pcap
```