espressif/iperf-cmd

readme

# Iperf command

This repository contains `iperf` command based esp-idf console.

## Documentation

### Supported commands:

- Part of official iperf: https://iperf.fr/iperf-doc.php
- And `iperf --abort`

  ```
  iperf  [-suV] [-c <host>] [-p <port>] [-l <length>] [-i <interval>] [-t <time>] [-b <bandwidth>] [-f <format>] [--abort]
    iperf command to measure network performance, through TCP or UDP connections.
    -c, --client=<host>  run in client mode, connecting to <host>
    -s, --server  run in server mode
      -u, --udp  use UDP rather than TCP
    -p, --port=<port>  server port to listen on/connect to
    -l, --len=<length>  Set read/write buffer size
    -i, --interval=<interval>  seconds between periodic bandwidth reports
    -t, --time=<time>  time in seconds to transmit for (default 10 secs)
    -b, --bandwidth=<bandwidth>  bandwidth to send at in Mbits/sec
    -f, --format=<format>  'k' = Kbits/sec 'm' = Mbits/sec
        --abort  abort running iperf
  ```

### Installation

- To add a plugin command or any component from IDF component manager into your project, simply include an entry within the `idf_component.yml` file.

  ```yaml
  dependencies:
    espressif/iperf_cmd:
      version: "^0.1.1"
  ```
- For more details refer [IDF Component Manager](https://docs.espressif.com/projects/idf-component-manager/en/latest/)

api

# API Reference

## Header files

- [iperf_cmd.h](#file-iperf_cmdh)

## File iperf_cmd.h






## Functions

| Type | Name |
| ---: | :--- |
|  esp\_err\_t | [**app\_register\_iperf\_commands**](#function-app_register_iperf_commands) (void) <br>_Registers console commands: iperf._ |



## Functions Documentation

### function `app_register_iperf_commands`

_Registers console commands: iperf._
```c
esp_err_t app_register_iperf_commands (
    void
) 
```


**Returns:**

ESP\_OK on success