]> Cypherpunks.ru repositories - nncp.git/blob - doc/index.texi
Documentation draft
[nncp.git] / doc / index.texi
1 \input texinfo
2 @documentencoding UTF-8
3 @settitle NNCP
4
5 @copying
6 This manual is for NNCP (Node to Node copy) --  collection of utilities
7 simplifying secure store-and-forward files and mail exchanging.
8
9 Copyright @copyright{} 2016-2017 @email{stargrave@@stargrave.org, Sergey Matveev}
10
11 @quotation
12 Permission is granted to copy, distribute and/or modify this document
13 under the terms of the GNU Free Documentation License, Version 1.3
14 or any later version published by the Free Software Foundation;
15 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
16 A copy of the license is included in the section entitled "Copying conditions".
17 @end quotation
18 @end copying
19
20 @node Top
21 @top NNCP
22
23 NNCP (Node to Node copy) is a collection of utilities simplifying
24 secure store-and-forward files and mail exchanging.
25
26 This utilities are intended to help build up small size (dozens of
27 nodes) ad-hoc @url{https://en.wikipedia.org/wiki/Friend-to-friend,
28 friend-to-friend} (F2F) statically routed
29 @url{https://en.wikipedia.org/wiki/Darknet, darknet} networks for
30 fire-and-forget secure reliable files, file requests and Internet mail
31 transmission. All packets are integrity checked,
32 @url{https://en.wikipedia.org/wiki/End-to-end_encryption, end-to-end}
33 encrypted, explicitly authenticated by known participants public keys.
34 @url{https://en.wikipedia.org/wiki/Onion_routing, Onion encryption} is
35 applied to relayed packets. Each node acts both as a client and server,
36 can use push and poll behaviour model.
37
38 Out-of-box offline @url{https://en.wikipedia.org/wiki/Sneakernet,
39 sneakernet/floppynet}, @url{https://en.wikipedia.org/wiki/Dead_drop,
40 dead drops} and @url{https://en.wikipedia.org/wiki/Air_gap_(networking),
41 air-gapped} computers support. But online TCP daemon with full-duplex
42 resumable data transmission exists.
43
44 NNCP is @url{https://www.gnu.org/philosophy/pragmatic.html, copylefted}
45 @url{https://www.gnu.org/philosophy/free-sw.html, free software}
46 licenced under @url{https://www.gnu.org/licenses/gpl-3.0.html, GPLv3+}.
47 It should work on all @url{https://en.wikipedia.org/wiki/POSIX,
48 POSIX}-compatible systems. Easy integration with existing
49 @url{https://en.wikipedia.org/wiki/SMTP, SMTP} servers. Single
50 @url{http://yaml.org/, YAML} configuration file.
51
52 @menu
53 * Comparison with existing solutions: Comparison.
54 * Use cases::
55 * Commands::
56 * Configuration file: Configuration.
57 * Packet format: Packet.
58 * Sync protocol: Sync.
59 * Copying conditions::
60 @end menu
61
62 @include comparison.texi
63 @include usecases.texi
64 @include cmds.texi
65 @include cfg.texi
66 @include pkt.texi
67 @include sp.texi
68
69 @node Copying conditions
70 @unnumbered Copying conditions
71
72 @insertcopying
73 @verbatiminclude fdl.txt
74
75 @bye