]> Cypherpunks.ru repositories - nncp.git/blobdiff - doc/news.ru.texi
Remove hdr/ files during ACK tossing
[nncp.git] / doc / news.ru.texi
index 34d39d834df9926adb4fd7f9402f77594e531f29..e814570b6f7d7e4d3effe667c75cdd571b157c90 100644 (file)
@@ -1,6 +1,509 @@
 @node Новости
 @section Новости
 
+@node Релиз 8.7.0
+@subsection Релиз 8.7.0
+@itemize
+
+@item
+В прошлом, @command{nncp-ack} не удаляла соответствующие @file{hdr/} файлы.
+
+@end itemize
+
+@node Релиз 8.6.0
+@subsection Релиз 8.6.0
+@itemize
+
+@item
+@command{nncp-xfer} проверяет сходится ли контрольная сумма
+скопированного локально пакета и исходного.
+
+@item
+@command{nncp-call} имеет плохой код возврата если в очередях на приём и
+отправку остаются незаконченные задания.
+
+@item
+Появилась @command{nncp-ack} команда, которая отправляет явное
+подтверждение доставки пакета (ACK пакет). Это подтверждение удаляет
+упомянутый пакет из исходящего spool-а.
+
+@item
+Появилась возможность отключения @code{fsync} операции
+@env{$NNCPNOSYNC=1} переменной окружения.
+
+@item
+Добавлены разнообразные индексы в документации, что должно помочь при
+поиске в ней.
+
+@end itemize
+
+@node Релиз 8.5.0
+@subsection Релиз 8.5.0
+@itemize
+
+@item
+Исправлена работоспособность @command{nncp-bundle}.
+
+@item
+По ошибке @option{-mcd-wait} опция у @command{nncp-call} была включена
+по умолчанию.
+
+@item
+Возможность переопределять внутренний timeout по умолчанию для протокола
+синхронизации через @env{$NNCPDEADLINE} переменную окружения. Может быть
+полезно для каналов с очень большими задержками.
+
+@item
+NNCP собирается на OpenBSD.
+
+@end itemize
+
+@node Релиз 8.4.0
+@subsection Релиз 8.4.0
+@itemize
+
+@item
+Имена интерфейсов относящихся к multicast (@code{mcd-listen} и
+@code{mcd-send} опции конфигурации) теперь являются регулярными
+выражениями. По умолчанию @command{nncp-cfgnew} не комментирует
+их теперь и прописывает @code{.*} имя интерфейса.
+
+@item
+У @command{nncp-call} команды появился @option{-mcd-wait} аргумент,
+позволяющий дожидаться multicast сообщения об адресе ноды.
+
+@item
+@command{nncp-file} команда пропускает всё что не является регулярным
+файлом или директорией во время создания pax-архива.
+
+@end itemize
+
+@node Релиз 8.3.0
+@subsection Релиз 8.3.0
+@itemize
+
+@item
+Исправлена возможность сборки на 32-бит системах.
+
+@end itemize
+
+@node Релиз 8.2.0
+@subsection Релиз 8.2.0
+@itemize
+
+@item
+Yggdrasil использует IPv6+TCP сетевой стэк написанный полностью на Go,
+вместо голого μTP транспортного протокола, делая возможным работу в
+качестве обычного TCP сервера внутри overlay сети.
+
+@item
+Конфигурационные строки Yggdrasil вида @code{prv;bind1,bind2;pub@dots{}}
+заменены на URL-подобные (@code{yggdrasils://PRV?bind=BIND1&bind=BIND2&pub=PUB}).
+
+@item
+Возможно передавать параметры Yggdrasil конфигурации связанные с multicast.
+
+@item
+@command{nncp-daemon} может слушать одновременно и на TCP и на
+Yggdrasil-управляемом сокетах.
+
+@item
+Слушание на endpoint сокете для пиринга в @command{nncp-daemon}
+опционально -- вы можете быть доступны и через связь с peer-ами.
+
+@end itemize
+
+@node Релиз 8.1.0
+@subsection Релиз 8.1.0
+@itemize
+
+@item
+@command{nncp-cfgdir} команда не требует обязательного наличия
+@code{self} секции конфигурационного файла.
+
+@item
+Появилась возможность работы в качестве клиента overlay сети Yggdrasil,
+используя online протокол поверх неё.
+
+@end itemize
+
+@node Релиз 8.0.2
+@subsection Релиз 8.0.2
+@itemize
+
+@item
+Исправлена возможность отправки мультивещательных пакетов.
+
+@end itemize
+
+@node Релиз 8.0.1
+@subsection Релиз 8.0.1
+@itemize
+
+@item
+Исправлено некорректное вычисление @code{freq.chunked} значения, при
+отсутствии которого всё равно форсированно включалась chunked передача.
+
+@item
+Исправлено некорректное вычисление значения полного размера файла в
+@file{.nncp.meta}.
+
+@end itemize
+
+@node Релиз 8.0.0
+@subsection Релиз 8.0.0
+@itemize
+
+@item
+@strong{Несовместимое} изменение формата зашифрованных пакетов: размеры
+полезной нагрузки и дополнения посылаются прямо внутри зашифрованного
+потока. Это даёт возможность потоково создавать шифрованные пакеты, без
+знания размеров заранее, без создания временного файла или буферизации в
+памяти.
+
+@item
+Производится корректная проверка дополнения зашифрованного пакета. Это
+не критичная проблема, но прежде ни размер, ни значение дополнения не
+были аутентифицированы, позволяя циклично откусывать по байту с конца и
+узнавать размер полезной нагрузки, наблюдая за реакцией по обработке
+такого зашифрованного пакета.
+
+@item
+@command{nncp-exec} больше не имеет @option{-use-tmp} опции, из-за
+совместимого с потоковой работой формата зашифрованных пакетов.
+
+@item
+У @command{nncp-file} и @command{nncp-exec} команд появилась опция
+@option{-maxsize}, ограничивающая максимальный результирующий размер
+зашифрованного пакета (возвращая ошибку если он превышен). Может быть
+полезно, так как размер полезной нагрузки может быть неизвестен заранее.
+
+@end itemize
+
+@node Релиз 7.7.0
+@subsection Релиз 7.7.0
+@itemize
+
+@item
+Экспериментальная поддержка @code{kqueue} и @code{inotify} оповещений об
+изменениях в spool директориях, для сокращения накладных расходов на их
+частое чтение.
+
+@item
+@file{.seen} и @file{.hdr} файлы находятся в @file{seen/} и @file{hdr/}
+поддиректориях теперь, дабы ускорить сканирование spool областей.
+Необходима миграция текущих файлов:
+
+@example
+$ find $NNCPSPOOL -type f -name "*.hdr" -exec rm @{@} +
+
+$ find $NNCPSPOOL -type d -name rx | while read rx ; do
+    cd $rx
+    mkdir -p seen
+    find . -type f -name "*.seen" | while read fn ; do
+        mv $fn seen/$@{fn%.seen@}
+    done
+done
+
+$ find $NNCPSPOOL -type d -name area | while read area ; do
+    find $area -type f -name "*.seen" | while read fn ; do
+        mv $fn $@{fn%.seen@}
+    done
+done
+@end example
+
+@end itemize
+
+@node Релиз 7.6.0
+@subsection Релиз 7.6.0
+@itemize
+
+@item
+Журналирование может производиться в назначенный открытый файловый
+дескриптор (@env{$NNCPLOG=FD:5} например).
+Что дружелюбно к использованию под @command{daemontools}.
+
+@item
+Добавлены дополнительные проверки наличия публичных ключей в
+конфигурационном файле, предотвращающие падения некоторых команд.
+
+@end itemize
+
+@node Релиз 7.5.1
+@subsection Релиз 7.5.1
+@itemize
+
+@item
+NNCP собирается на NetBSD.
+
+@end itemize
+
+@node Релиз 7.5.0
+@subsection Релиз 7.5.0
+@itemize
+
+@item
+@command{nncp-daemon} соблюдает UCSPI-TCP интерфейс, благодаря чему в
+журнале будет присутствовать адрес удалённой системы (при запуске под
+совместимой утилитой). Желательно применять @option{-ucspi} опцию вместо
+@option{-inetd}.
+
+@item
+@command{nncp-call} может быть UCSPI-TCP клиентом, используя
+@option{-ucspi} опцию.
+
+@item
+Не выходить если не получается слушать на каком-либо MCD сетевом
+интерфейсе -- только предупреждать об ошибке.
+
+@end itemize
+
+@node Релиз 7.4.0
+@subsection Релиз 7.4.0
+@itemize
+
+@item
+Исправлена работоспособность MCD при одновременном использовании
+@command{nncp-daemon} и @command{nncp-caller}.
+
+@end itemize
+
+@node Релиз 7.3.2
+@subsection Релиз 7.3.2
+@itemize
+
+@item
+@command{hjson-cli} утилита теперь собирается в vendor-режиме.
+
+@end itemize
+
+@node Релиз 7.3.1
+@subsection Релиз 7.3.1
+@itemize
+
+@item
+Исправлена проблема с возможно остающимся открытым файловым
+дескриптором в online командах.
+
+@item
+Существенно снижено потребление памяти MTH хэширования.
+
+@end itemize
+
+@node Релиз 7.3.0
+@subsection Релиз 7.3.0
+@itemize
+
+@item
+Поправлены проблемы работоспособности на 32-бит системах с большими файлами.
+
+@item
+Возможность использовать конфигурацию в виде директории с набором
+файлов. Появилась команда @command{nncp-cfgdir}.
+
+@end itemize
+
+@node Релиз 7.2.1
+@subsection Релиз 7.2.1
+@itemize
+
+@item
+Небольшие оптимизации в online командах.
+
+@end itemize
+
+@node Релиз 7.2.0
+@subsection Релиз 7.2.0
+@itemize
+
+@item
+Появилась @command{nncp-trns} команда для ручного создания транзитных пакетов.
+
+@item
+Если у целевой ноды транзитного пакета задан @option{via} маршрут, то
+использовать его, а не игнорировать.
+
+@item
+Не отправлять multicast пакет оригинатору сообщения, очевидно точно
+видящего свой собственный пакет.
+
+@item
+Намного меньшее потребление памяти во время MTH хэширования когда
+смещение равно нулю: когда пакет не является докачиванием, а например
+проверяется @command{nncp-check} командой.
+
+@end itemize
+
+@node Релиз 7.1.1
+@subsection Релиз 7.1.1
+@itemize
+
+@item
+Исправлено падение при @code{fsync} директорий после создания @file{.seen} файлов.
+
+@end itemize
+
+@node Релиз 7.1.0
+@subsection Релиз 7.1.0
+@itemize
+
+@item
+Появилась возможность мультивещательной (multicast) рассылки пакетов.
+Реализовано всего лишь дополнительным типом простых пакетов и изменением
+@command{nncp-toss}, @command{nncp-file} и @command{nncp-exec} команд.
+
+@item
+Исправлена работоспособность @command{nncp-file} и @command{nncp-exec}
+команд использующих временный файл (@code{stdin} и @option{-use-tmp}).
+
+@item
+Исправлен пропадающий плохой код возврата в @command{nncp-exec} команде.
+
+@item
+Исправлено некорректное генерирование @file{.hdr} при использовании
+транзитных пакетов.
+
+@item
+У @command{nncp-rm} команды появилась @option{-all} опция, применяемая
+ко всем нодам сразу.
+
+@item
+У @command{nncp-check} команды появилась @option{-cycle} опция, вводящая
+проверку в бесконечный цикл.
+
+@item
+У @command{nncp-rm} команды можно указывать alias-ы имён нод.
+
+@item
+@command{nncp-pkt} может парсить @file{.hdr} файлы.
+
+@end itemize
+
+@node Релиз 7.0.0
+@subsection Релиз 7.0.0
+@itemize
+
+@item
+Минимальная требуемая версия Go 1.13.
+
+@item
+Хэширование с BLAKE3 на базе деревьев Меркле (Merkle Tree Hashing, MTH)
+используется вместо BLAKE2b. Из-за этого, обратно @strong{несовместимое}
+изменение формата шифрованных файлов (всего что находится в spool
+области) и формата @file{.meta} файла при chunked передаче.
+
+Текущая реализация далека от оптимальной: в ней нет распараллеливания
+вычислений и имеет повышенное потребление памяти: около 512 KiB на
+каждый 1 GiB данных файла. Будущая оптимизация производительности и
+потребления памяти не должна привести к изменению формата пакетов. Но
+это всё равно в несколько раз быстрее BLAKE2b.
+
+@item
+Из-за использования MTH, докачиваемые в online режиме файлы потребуют
+чтения с диска только предшествующей части, а не полностью всего файла,
+как было прежде.
+
+@item
+Добавлена @command{nncp-hash} утилита для вычисления MTH хэша файла.
+
+@item
+В шифрованных пакетах BLAKE2 KDF и XOF функции заменены на BLAKE3. Ещё
+уменьшая количество примитивов. А также заголовок шифрованного файла
+теперь является ассоциированными данными при шифровании.
+
+@item
+MultiCast Discovery использует
+@verb{|ff02::4e4e:4350|} адрес вместо @verb{|ff02::1|}.
+
+@item
+@command{nncp-cfgenc} ошибочно трижды спрашивал парольную фразу при шифровании.
+
+@item
+@command{nncp-stat} выводит сводку о частично скачанных пакетах.
+
+@item
+Обновлены зависимые библиотеки.
+
+@end itemize
+
+@node Релиз 6.6.0
+@subsection Релиз 6.6.0
+@itemize
+
+@item
+@command{nncp-daemon}, @command{nncp-call} и @command{nncp-caller}
+ожидают завершения всех процессов фоновой проверки контрольных сумм,
+после того как соединение закрыто.
+
+@item
+Добавлена возможность определения адреса через multicast оповещение в
+локальной сети, так называемый MCD (MultiCast Discovery).
+
+@end itemize
+
+@node Релиз 6.5.0
+@subsection Релиз 6.5.0
+@itemize
+
+@item
+Исправлено падение в @command{nncp-daemon} когда SP рукопожатие не было успешно.
+
+@item
+Исправлено возможное игнорирование плохого кода возврата автоматического tosser.
+
+@item
+Исправлена гонка при закрытии файловых дескрипторов во время завершения
+работы online протокола, которая могла привести к ошибке записи
+принятого фрагмента пакета.
+
+@item
+Убирать показ прогресса передачи пакетов когда вызов уже завершён в
+@command{nncp-daemon}, @command{nncp-call} и @command{nncp-caller}.
+
+@end itemize
+
+@node Релиз 6.4.0
+@subsection Релиз 6.4.0
+@itemize
+
+@item
+Исправлена возможная гонка в online протоколе, приводящая к падению
+программы.
+
+@end itemize
+
+@node Релиз 6.3.0
+@subsection Релиз 6.3.0
+@itemize
+
+@item
+Исправлено возможное падение программы во время показа прогресса online
+протокола.
+
+@end itemize
+
+@node Релиз 6.2.1
+@subsection Релиз 6.2.1
+@itemize
+
+@item
+В трёх местах сообщений журналов по ошибке остались лишние @code{%s}.
+
+@end itemize
+
+@node Релиз 6.2.0
+@subsection Релиз 6.2.0
+@itemize
+
+@item
+Возвращена работоспособность @option{-autotoss*} опций @command{nncp-caller}.
+
+@item
+Очередной рефакторинг и упрощение системы журналирования.
+Не должно быть видимых изменений для конечного пользователя.
+
+@end itemize
+
 @node Релиз 6.1.0
 @subsection Релиз 6.1.0
 @itemize
@@ -24,6 +527,11 @@ online демоны не выполнят проверку целостност
 Оптимизация: для файлов, скачивание которых не было продолжено, сразу же
 вычисляет контрольная сумма, пропуская промежуточный @file{.nock} шаг.
 
+@item
+Возможность хранения заголовков зашифрованных пакетов в @file{.hdr}
+файлах, рядом с самими пакетами. Это может существенно повысить скорость
+получения списка пакетов на файловых системах с большим размером блока.
+
 @end itemize
 
 @node Релиз 6.0.0
@@ -68,7 +576,7 @@ online демоны не выполнят проверку целостност
 Вы можете настраивать опции автоматического tosser для каждого вызова.
 
 @item
-Использовать vendoring вместо переопределения @env{GOPATH} во время
+Использовать vendoring вместо переопределения @env{$GOPATH} во время
 установки tarball, так как текущая минимальная версия Go это 1.12,
 поддерживающая модули.
 
@@ -79,7 +587,7 @@ online демоны не выполнят проверку целостност
 @itemize
 
 @item
-Уважать @env{BINDIR}, @env{INFODIR} и @env{DOCDIR} переменные окружения
+Уважать @env{$BINDIR}, @env{$INFODIR} и @env{$DOCDIR} переменные окружения
 в @file{config} во время установки.
 
 @end itemize
@@ -245,7 +753,7 @@ SP протокол порождает меньше вызовов записе
 невозможности online аутентификации нод.
 
 @item
-Явная синхронизация (fsync) директорий для гарантированного
+Явная синхронизация (@code{fsync}) директорий для гарантированного
 переименования файлов.
 
 @end itemize
@@ -274,7 +782,7 @@ SP протокол порождает меньше вызовов записе
 @item
 @option{freq}, @option{freqminsize}, @option{freqchunked} опции
 конфигурационного файла заменены на структуру
-@option{freq: @{path: ..., minsize: ..., chunked: ...@}}.
+@option{freq: @{path: @dots{}, minsize: @dots{}, chunked: @dots{}@}}.
 
 @item
 Добавлена @option{freq.maxsize} опция конфигурационного файл,
@@ -455,8 +963,8 @@ pipe вызов сторонней команды.
     нужно использовать @verb{|nncp-exec NODE sendmail RECIPIENT|}.
     @item
     @option{sendmail} опция конфигурационного файла заменена на более гибкую
-    @option{exec}. @verb{|sendmail: [...]|} нужно заменить на @verb{|exec:
-    sendmail: [...]|}.
+    @option{exec}. @code{sendmail: [@dots{}]} нужно заменить на
+    @code{exec: sendmail: [@dots{}]}.
     @end itemize
 
 @item
@@ -470,7 +978,7 @@ Chunked файлы, меньшего размера чем указанный ch
 
 @item
 Exec команды вызываются с дополнительными переменными окружения
-@env{NNCP_NICE} и @env{NNCP_SELF}.
+@env{$NNCP_NICE} и @env{$NNCP_SELF}.
 
 @item
 Отправляемые файлы в ответ на запрос имеют приоритет указанный в запросе.
@@ -546,7 +1054,7 @@ HKDF-BLAKE2b-256 KDF алгоритм заменён на BLAKE2Xb XOF. Ещё 
 @node Релиз 0.12
 @subsection Релиз 0.12
 @itemize
-@item Команда sendmail вызывается с @env{NNCP_SENDER} переменной окружения.
+@item Команда sendmail вызывается с @env{$NNCP_SENDER} переменной окружения.
 @end itemize
 
 @node Релиз 0.11