From 22b91e04610f925569f142ae9df7f7558696ee11 Mon Sep 17 00:00:00 2001 From: Sergey Matveev Date: Sat, 25 Nov 2017 22:10:27 +0300 Subject: [PATCH] Documentation update --- doc/bundles.texi | 8 ++++---- doc/cmds.texi | 3 +++ doc/usecases.ru.texi | 29 +++++++++++++++++++++++++++++ doc/usecases.texi | 27 +++++++++++++++++++++++++++ 4 files changed, 63 insertions(+), 4 deletions(-) diff --git a/doc/bundles.texi b/doc/bundles.texi index bb965b2..445150c 100644 --- 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 0cc551a..253c01d 100644 --- 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 2a03a2b..1407c8e 100644 --- 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 81af4bb..47307f8 100644 --- 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 -- 2.48.1