rnpath¶

rnpath — утилита для поиска и просмотра путей к назначениям (destinations) в сети Reticulum. Аналогична программе traceroute в традиционных сетях.

Примеры использования¶

Поиск пути к назначению:

$ rnpath c89b4da064bf66d280f0e4d8abfd9806

Path found, destination <c89b4da064bf66d280f0e4d8abfd9806> is 4 hops away via <f53a1c4278e0726bb73fcc623d6ce763> on TCPInterface[Testnet/dublin.connect.reticulum.network:4965]

Расшифровка вывода:

Path found — путь найден
4 hops away — назначение находится в 4 узлах (хопах) от текущего
via — путь проходит через узел с указанным хешем
on TCPInterface[...] — интерфейс, через который доступен путь

Все опции командной строки (переведены для понимания)¶

usage: rnpath [-h] [--config CONFIG] [--version] [-t] [-m hops] [-r] [-d] [-D]
              [-x] [-w seconds] [-R hash] [-i path] [-W seconds] [-b] [-B] [-U]
              [--duration DURATION] [--reason REASON] [-p] [-j] [-v]
              [destination] [list_filter]

Утилита управления путями Reticulum

positional arguments:
  destination           шестнадцатеричный хеш назначения (destination)
  list_filter           фильтр для просмотра удалённого чёрного списка

options:
  -h, --help            показать эту справку и выйти
  --config CONFIG       путь к альтернативному каталогу конфигурации Reticulum
  --version             показать номер версии программы и выйти
  -t, --table           показать все известные пути
  -m, --max hops        максимальное количество хопов для фильтрации таблицы путей
  -r, --rates           показать информацию о частоте объявлений (announce rate)
  -d, --drop            удалить путь к назначению
  -D, --drop-announces  удалить все queued-объявления
  -x, --drop-via        удалить все пути через указанный транспортный интерфейс
  -w seconds            таймаут ожидания перед отказом
  -R hash               хеш транспортной идентичности удалённого экземпляра для управления
  -i path               путь к файлу идентичности для удалённого управления
  -W seconds            таймаут ожидания ответа от удалённых запросов
  -b, --blackholed      показать список заблокированных идентичностей (blackholed)
  -B, --blackhole       добавить идентичность в чёрный список (blackhole)
  -U, --unblackhole     удалить идентичность из чёрного списка
  --duration DURATION   длительность блокировки в часах
  --reason REASON       причина добавления в чёрный список
  -p, --blackholed-list
                        показать опубликованный список чёрных списков для удалённого транспорта
  -j, --json            вывод в формате JSON
  -v, --verbose         подробный вывод

Дополнительные примеры¶

Показать все известные пути¶

$ rnpath -t

Показать пути с ограничением по хопам¶

$ rnpath -t -m 3

Показать статистику частоты объявлений¶

$ rnpath -r

Удалить путь к назначению¶

$ rnpath -d c89b4da064bf66d280f0e4d8abfd9806

Добавить идентичность в чёрный список¶

$ rnpath -B c89b4da064bf66d280f0e4d8abfd9806 --duration 24 --reason "spam"

Удалить идентичность из чёрного списка¶

$ rnpath -U c89b4da064bf66d280f0e4d8abfd9806

Вывод в формате JSON¶

$ rnpath -j c89b4da064bf66d280f0e4d8abfd9806

Примечание¶

Хеш назначения должен быть указан в шестнадцатеричном формате
Утилита работает с разделёнными экземплярами Reticulum (если запущен rnsd)
Для корректной работы должен быть активен хотя бы один интерфейс Reticulum
Если путь не найден, утилита сообщит об этом (назначение недоступно)

При использовании опций -R для управления удалённым транспортным экземпляром необходимо также указать -i с путём к файлу идентичности, авторизованному для удалённого управления на целевой системе.

См. также¶

Основы RNS — введение в протокол Reticulum
Утилиты RNS — обзор всех утилит командной строки
rnstatus — просмотр статуса интерфейсов
rnprobe — проверка доступности узлов