Files
utun2/tools/bping/bping_doc.md
T
evgeny 38c9f229bc stcp: ed25519 pubkey exchange in handshake, fix instance destroy segfault, fix chat_tcp_test
- u_async.c: process immediate_queue BEFORE epoll_wait in uasync_poll
- stcp_link.c: defensive NULL etcp_conn/etcp_link in stcp_link_close
- utun_instance.c: move stcp_server_list_destroy_all to Phase J (before ETCP),
  add deferred drain in both Phase J and L
- stcp.h/c: STCP_HS_ENC_CLIENT 6→38, STCP_HS_ENC_SERVER 7→39,
  exchange ed25519_pubkey in both handshake directions
- etcp_connections.c: copy peer_ed25519 from STCP to ETCP_CONN in
  etcp_link_enter_ready_tcp; guard link->etcp in tcp_link_close_cb
- chat_sync.c: fix lk->conn NULL dereference for TCP links
- test_stcp.c: update stcp_server_create/stcp_client_connect callsites
- tools/chat_tcp_test: change transport udp→tcp
2026-08-07 00:48:27 +03:00

51 lines
2.7 KiB
Markdown

# bping — Bandwidth Ping
## 1. Назначение
Утилита измерения пропускной способности и потерь канала через burst-ы ICMP Echo.
В отличие от обычного ping, отправляет пачками (burst) — до 10,000 пингов за раз на максимальной скорости
с последующим сбором ответов в течение 5 секунд. Позволяет оценить пропускную способность
и packet loss под нагрузкой.
## 2. Как пользоваться
```
bping [-s размер] [-p посылок] [-b пачек] [-i интервал] host
```
| Опция | По умолчанию | Описание |
|-------|-------------|----------|
| `-s N` или `-s MIN:MAX` | 56 | Размер данных (payload) ICMP в байтах. Если диапазон — случайный размер в нём |
| `-p N` | 10 | Количество пингов в одной пачке (макс. 10000) |
| `-b N` | 0 (∞) | Число пачек. 0 — бесконечно (Ctrl+C для остановки) |
| `-i N` | 1.0 | Интервал между пачками в секундах (можно 0.001, 0.05 и т.д.) |
Требует **root** или **cap_net_raw** (raw sockets).
**Сборка:** `make` в `tools/bping/`, установка: `make install`.
**Примеры:**
```bash
sudo bping 8.8.8.8
bping -s 1472 -p 200 -i 0.05 1.1.1.1
bping -s 100:600 -p 500 -i 0.01 192.168.1.1
```
**Вывод:** per-packet RTT (размер, IP, ICMP seq, TTL, время) + per-burst сводка:
```
--- 200 transmitted, 195 received, 2% loss ---
```
## 3. Ключевые детали
- **SOCK_RAW + IPPROTO_ICMP** — raw сокет, требует привилегий
- **Без libpcap** — sendto/recvfrom напрямую, без сторонних библиотек
- ICMP Echo Request, идентификатор = `getpid() & 0xFFFF`, последовательные seq
- Данные заполняются `0x61` ('a'), как в стандартном ping
- Контрольная сумма ICMP — `in_cksum()`, своя реализация (RFC 1071)
- Приём: `select()` с таймаутом 1с в цикле до 5 секунд на пачку
- Ответы сопоставляются по ICMP ID + seq через `seq_list[]` (массив, не хеш-таблица)
- Межburst-интервал через `nanosleep()`, поддержка долей секунды
- Отдельный Makefile, не включён в autotools-сборку проекта
- SIGINT (Ctrl+C) — печать «⛔ bping остановлен» и выход