diff --git a/Others/netperf/README.md b/Others/netperf/README.md new file mode 100644 index 0000000000000000000000000000000000000000..2fcd1836bb231934a0904597f0aa038584f12049 --- /dev/null +++ b/Others/netperf/README.md @@ -0,0 +1,47 @@ +# Quick reference + +- The official Netperf docker image. + +- Maintained by: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative). + +- Where to get help: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative), [openEuler](https://gitee.com/openeuler/community). + +# Netperf | openEuler +Current netperf docker images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +Netperf is a benchmark that can be used to measure the performance of many different types of networking. It provides tests for both unidirectional throughput, and end-to-end latency. + +# Supported tags and respective Dockerfile links +The tag of each `netperf` docker image is consist of the version of `netperf` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|----------|-------------|------------------| +|[2.7.0-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Others/netperf/2.7.0/24.03-lts-sp1/Dockerfile)| netperf 2.7.0 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +# Usage +In this usage, users can select the corresponding `{Tag}` based on their requirements. + +- Pull the `openeuler/netperf` image from docker + + ```bash + docker pull openeuler/netperf:{Tag} + ``` + +- Run with an interactive shell + + You can start the container with an interactive shell to use netperf. + ``` + docker run -it --rm openeuler/netperf:{Tag} bash + ``` + +- Using netperf + + Start the `netserver` on the server machine + ``` + netserver -p + ``` + * Netserver listen on TCP port `PORT`, you can specify a custom port with `-p `. + * It binds to `0.0.0.0`(or IN(6)ADDR_ANY) by default, which means it listens in all available network interface. + +# Question and answering +If you have any questions or want to use some special features, please submit an issue or a pull request on [openeuler-docker-images](https://gitee.com/openeuler/openeuler-docker-images). \ No newline at end of file diff --git a/Others/netperf/doc/image-info.yml b/Others/netperf/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..fbb595f1f7fd4be904c567526b2bbd13c44cf59d --- /dev/null +++ b/Others/netperf/doc/image-info.yml @@ -0,0 +1,45 @@ +name: netperf +category: others +description: netperf 是一个经典的网络性能测试工具,用于测量 TCP、UDP 等传输协议的吞吐量、延迟、请求/响应性能等。 +environment: | + 本应用在Docker环境中运行,安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + netperf镜像的Tag由其版本信息和基础镜像版本信息组成,详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[2.7.0-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Others/netperf/2.7.0/24.03-lts-sp1/Dockerfile)| netperf 2.7.0 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/netperf:{Tag} + ``` + +usage: | + - 以交互式Shell运行容器: + + 通过交互式 Shell 启动容器,使用netperf: + ``` + docker run -it --rm openeuler/netperf:{Tag} bash + ``` + + - 使用netperf + + 在要作为服务端的机器上执行netserver: + ``` + netserver -p 12865 + ``` + * 默认监听 TCP 端口 12865,你也可以通过 -p 指定端口。 + * 默认监听所有网卡 0.0.0.0。 + ``` + +license: MIT license +similar_packages: + - iperf: iperf 是一款网络性能测试工具,用于测量 带宽(Throughput) 和 延迟(Latency)。 +dependency: + - texinfo + - libtool diff --git a/Others/netperf/doc/picture/logo.png b/Others/netperf/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..183271cdad953aa7e7f36f47e07e2162ebef7243 Binary files /dev/null and b/Others/netperf/doc/picture/logo.png differ