utun2/tools/bping/bping_doc.md

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.

Примеры:

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