Files
utun2/tools/bping/bping_doc.md
T

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 остановлен» и выход