https://github.com/yuuki/go-ibv-ud-pingpong
Go RDMA (RoCE) ping/pong tool
https://github.com/yuuki/go-ibv-ud-pingpong
cgo go ibverbs rdma rdma-programming roce
Last synced: 9 days ago
JSON representation
Go RDMA (RoCE) ping/pong tool
- Host: GitHub
- URL: https://github.com/yuuki/go-ibv-ud-pingpong
- Owner: yuuki
- License: gpl-2.0
- Created: 2025-05-14T18:19:21.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-28T08:58:37.000Z (5 months ago)
- Last Synced: 2025-05-28T09:41:03.873Z (5 months ago)
- Topics: cgo, go, ibverbs, rdma, rdma-programming, roce
- Language: Go
- Homepage:
- Size: 26.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-ibv-ud-pingpong
## Overview
go-ibv-ud-pingpong is a network diagnostic tool that performs ping/pong tests using the Infiniband Verbs interface (libibverbs) with the IB/RoCE protocol's Unreliable Datagram (UD) transport. This tool is particularly useful for testing and benchmarking RDMA network performance.
This project is a Go language implementation of the [ud_pingpong.c](https://github.com/linux-rdma/rdma-core/blob/master/libibverbs/examples/ud_pingpong.c) example from the rdma-core library.
## Prerequisites
- Go 1.24 or later
- RDMA-capable network interface card supporting RoCE v2
- rdma-core development packages
## Installation
### From Source
```bash
git clone https://github.com/yuuki/go-rocev2-ud-pingpong.git
cd go-rocev2-ud-pingpong
make extract-binary
```
## Usage
The tool operates in either server (passive) or client (active) mode:
```
Usage: ./go-rocev2-ud-pingpong [options] [servername]
-c Validate buffer contents (server side)
-d string
IB device name
-e Use CQ events
-g int
GID index (default -1)
-i int
IB port (default 1)
-l int
Service Level
-loglevel string
Log level (debug, info, warn, error) (default "info")
-n int
Number of iterations (default 1000)
-p int
TCP port for exchanging connection data (default 18515)
-r int
RX queue depth (default 500)
-s int
Size of message buffer (default 4096)
-servername string
Server hostname or IP address (client mode)
```
### Example Usage
To run in server mode:
```bash
./bin/go-rocev2-ud-pingpong -e -g 0
```
To run in client mode:
```bash
./bin/go-rocev2-ud-pingpong -e -g 0 -servername 192.168.1.100
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
This project is licensed under the GPL v2 - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- This project is inspired by and based on the [ud_pingpong.c](https://github.com/linux-rdma/rdma-core/blob/master/libibverbs/examples/ud_pingpong.c) example from the rdma-core library
- Thanks to the RDMA community for their excellent documentation and examples