Documentation update

diff --git a/doc/bundles.texi b/doc/bundles.texi
index bb965b2e7f02eb45aa9180b47ac6dffee74228c0..445150c423733b6ad04af5a3b3ea03e7dd80c857 100644 (file)
--- a/doc/bundles.texi
+++ b/doc/bundles.texi
@@ -18,11 +18,11 @@ sequentially streamed for recording and digested back.
 @item They do not require intermediate storage before recording on
 either CD-ROM or tape drive.
 @verbatim
-% nncp-bundle -tx SOMENODE | cdrecord -tao -       # record directly to CD
-% nncp-bundle -tx SOMENODE | dd of=/dev/sa0 bs=512 # record directly to tape
+% nncp-bundle -tx SOMENODE | cdrecord -tao -         # record directly to CD
+% nncp-bundle -tx SOMENODE | dd of=/dev/sa0 bs=10240 # record directly to tape
 
-% dd if=/dev/cd0 bs=2048 | nncp-bundle -rx # read directly from CD
-% dd if=/dev/sa0 bs=512 | nncp-bundle -rx  # read directly from tape
+% dd if=/dev/cd0 bs=2048 | nncp-bundle -rx  # read directly from CD
+% dd if=/dev/sa0 bs=10240 | nncp-bundle -rx # read directly from tape
 @end verbatim
 
 @item They do not require filesystem existence to deal with, simplifying

diff --git a/doc/cmds.texi b/doc/cmds.texi
index 0cc551a542631c9788dcce32177fd88bba40d613..253c01d0eaae7e99fe3c64b776d2233cf37f70e1 100644 (file)
--- a/doc/cmds.texi
+++ b/doc/cmds.texi
@@ -470,3 +470,6 @@ configuration file version without any private keys.
 @file{DIR} directory has the following structure:
 @file{RECIPIENT/SENDER/PACKET}, where @file{RECIPIENT} is Base32 encoded
 destination node, @file{SENDER} is Base32 encoded sender node.
+
+Also look for @ref{nncp-bundle}, especially if you deal with CD-ROM and
+tape drives.

diff --git a/doc/usecases.ru.texi b/doc/usecases.ru.texi
index 2a03a2b2d9ae2675c324df4276acc314481d5750..1407c8e7e359f52c71117ab46bac23b3e8fe1cd3 100644 (file)
--- a/doc/usecases.ru.texi
+++ b/doc/usecases.ru.texi
@@ -7,6 +7,7 @@
 * Ненадёжный/дорогой канал связи: UsecaseUnreliableRU.
 * Медленная/дорогая связь для больших объёмов данных, плохой QoS: UsecaseQoSRU.
 * Экстремальные наземные окружающие условия, нет связи: UsecaseNoLinkRU.
+* Односторонняя широковещательная связь: UsecaseBroadcastRU.
 * Частные, изолированные MitM/Sybil-устойчивые сети: UsecaseF2FRU.
 * Высоко защищённые изолированные компьютеры с воздушным зазором: UsecaseAirgapRU.
 * Обход сетевой цензуры, здоровье: UsecaseCensorRU.
@@ -113,6 +114,13 @@ NNCP поддерживает @ref{Niceness, приоритезацию траф
 давая возможность передачи, по сути, любых объёмов используя накопители
 небольших размеров.
 
+Вы также можете использовать CD-ROM и ленточные накопители:
+
+@verbatim
+% nncp-bundle -tx bob | cdrecord -tao -
+% nncp-bundle -tx bob | dd of=/dev/sa0 bs=10240
+@end verbatim
+
 @node UsecaseNoLinkRU
 @subsection Экстремальные наземные окружающие условия, нет связи
 
@@ -153,6 +161,27 @@ NNCP поддерживает @ref{Niceness, приоритезацию траф
 дальнейшей обработки. @command{nncp-xfer} это единственная команда
 используемая с переносными устройствами хранения.
 
+@node UsecaseBroadcastRU
+@subsection Односторонняя широковещательная связь
+
+Иногда у вас есть ёмкий, но односторонний, канал связи, например
+широковещательный сигнал со спутника. Вы не можете использовать online
+@ref{Sync, протокол синхронизации}, потому что он требует двустороннего
+взаимодействия.
+
+Вы можете использовать, так называемые, @ref{Bundles, пачки} и потоково
+отсылать их. Они -- всего-лишь последовательность @ref{Encrypted,
+зашифрованных пакетов}, которые вы можете принять.
+
+@verbatim
+% nncp-bundle -tx alice bob eve ... | команда для отправки широковещательной рассылки
+% команда для приёма широковещательной рассылки | nncp-bundle -rx
+@end verbatim
+
+Встроенная возможность определять дубляжи пакетов позволит вам
+переотправлять широковещательные рассылки время от времени, повышая
+шансы на то, что получатель примет их, регулярно слушая рассылку.
+
 @node UsecaseF2FRU
 @subsection Частные, изолированные MitM/Sybil-устойчивые сети
 

diff --git a/doc/usecases.texi b/doc/usecases.texi
index 81af4bbcfc8c1e5fa62422dd76adac1332aa6510..47307f8d0546bdf08e4eb80570f639de616c2331 100644 (file)
--- a/doc/usecases.texi
+++ b/doc/usecases.texi
@@ -9,6 +9,7 @@ See also this page @ref{Сценарии, on russian}.
 * Unreliable/expensive communication link: UsecaseUnreliable.
 * Slow/expensive link for high-volume data, bad QoS: UsecaseQoS.
 * Extreme terrestrial environments, no link: UsecaseNoLink.
+* One-way broadcasting communications: UsecaseBroadcast.
 * Private, isolated MitM/Sybil-resistant networks: UsecaseF2F.
 * Highly secure isolated air-gap computers: UsecaseAirgap.
 * Network censorship bypassing, health: UsecaseCensor.
@@ -108,6 +109,13 @@ Huge files could be split on smaller @ref{Chunked, chunks}, giving
 possibility to transfer virtually any volumes using small capacity
 storages.
 
+You can also use CD-ROM and tape drives:
+
+@verbatim
+% nncp-bundle -tx bob | cdrecord -tao -
+% nncp-bundle -tx bob | dd of=/dev/sa0 bs=10240
+@end verbatim
+
 @node UsecaseNoLink
 @section Extreme terrestrial environments, no link
 
@@ -145,6 +153,25 @@ to find all packets related to their node and copy them locally for
 further processing. @command{nncp-xfer} is the only command used with
 removable devices.
 
+@node UsecaseBroadcast
+@section One-way broadcasting communications
+
+Sometimes you have got high-bandwidth but unidirectional link, for
+example, satellite's broadcasting signal. You are not able to use online
+@ref{Sync, synchronization protocol} because it requires mutual interaction.
+
+You can use @ref{Bundles, bundles} and stream them above. They are just
+a sequence of @ref{Encrypted, encrypted packets} you can catch on.
+
+@verbatim
+% nncp-bundle -tx alice bob eve ... | command to send broadcast
+% command to receive broadcast | nncp-bundle -rx
+@end verbatim
+
+With built-in packet duplicates detection ability, you can retransmit
+your broadcasts from time to time, to increase chances the recipient
+will catch them by regular stream listening.
+
 @node UsecaseF2F
 @section Private, isolated MitM/Sybil-resistant networks