]> Cypherpunks.ru repositories - nncp.git/blob - doc/news.texi
Use gvisor.dev/gvisor again instead of inet.af/netstack
[nncp.git] / doc / news.texi
1 @node News
2 @cindex news
3 @unnumbered News
4
5 See also this page @ref{Новости, on russian}.
6
7 @node Release 8_8_0
8 @section Release 8.8.0
9 @itemize
10
11 @item
12 Fixed buildability under Go 1.19.
13
14 @item
15 Minimal required Go version is 1.17.
16
17 @end itemize
18
19 @node Release 8_7_2
20 @section Release 8.7.2
21 @itemize
22
23 @item
24 More intuitive, clear and slightly more flexible behaviour of @command{nncp-rm}.
25
26 @item
27 @command{nncp-rm} also removes corresponding @file{hdr/} file for each
28 removed packet.
29
30 @end itemize
31
32 @node Release 8_7_1
33 @section Release 8.7.1
34 @itemize
35
36 @item
37 @command{nncp-xfer} now correctly checks for @file{seen/} files for
38 inbound packets.
39
40 @end itemize
41
42 @node Release 8_7_0
43 @section Release 8.7.0
44 @itemize
45
46 @item
47 @command{nncp-ack} does not acknowledge ACK-packets, preventing an
48 endless loop of ACKs.
49
50 @item
51 @command{nncp-ack} previously did not remove corresponding @file{hdr/} files.
52
53 @item
54 @command{nncp-rm} now takes list of packet from @code{stdin} when
55 @option{-pkt} option is used.
56
57 @item
58 @command{nncp-ack} now generates list of ACK packets it created, that
59 could be used as an input to @command{nncp-rm} to remove outbound ACK
60 packets.
61
62 @end itemize
63
64 @node Release 8_6_0
65 @section Release 8.6.0
66 @itemize
67
68 @item
69 @command{nncp-xfer} checks if locally copied packet's checksum differs
70 from the source's one.
71
72 @item
73 @command{nncp-call} has bad return code if its queues contain unfinished jobs.
74
75 @item
76 @command{nncp-ack} command appeared, that sends explicit packet receipt
77 acknowledgement (ACK packet). That acknowledgement deletes referenced
78 packet from the outbound spool.
79
80 @item
81 Ability to turn @code{fsync} operation off using @env{$NNCPNOSYNC=1}
82 environment variable.
83
84 @item
85 Added various indices in documentation, that should help searching in it.
86
87 @end itemize
88
89 @node Release 8_5_0
90 @section Release 8.5.0
91 @itemize
92
93 @item
94 Fixed @command{nncp-bundle} workability.
95
96 @item
97 Mistakenly @option{-mcd-wait} option was enabled by default in
98 @command{nncp-call}.
99
100 @item
101 Ability to override internal default timeout for online protocol through
102 @env{$NNCPDEADLINE} environment variable. Can be useful for very high
103 delay links.
104
105 @item
106 NNCP builds on OpenBSD.
107
108 @end itemize
109
110 @node Release 8_4_0
111 @section Release 8.4.0
112 @itemize
113
114 @item
115 Multicast related interface names (@code{mcd-listen} and @code{mcd-send}
116 configuration options) are now regular expressions. By default
117 @command{nncp-cfgnew} uncomments them now with @code{.*} interface name.
118
119 @item
120 @command{nncp-call} command has @option{-mcd-wait} option to wait for
121 multicast packet about node's address.
122
123 @item
124 @command{nncp-file} command skips everything that is neither regular
125 file nor directory during pax-archive creation.
126
127 @end itemize
128
129 @node Release 8_3_0
130 @section Release 8.3.0
131 @itemize
132
133 @item
134 Fixed building issues on 32-bit systems.
135
136 @end itemize
137
138 @node Release 8_2_0
139 @section Release 8.2.0
140 @itemize
141
142 @item
143 Yggdrasil uses pure-Go IPv6+TCP network stack, instead of naked μTP
144 transport protocol, making it able to work as an ordinary TCP server
145 inside overlay network.
146
147 @item
148 Yggdrasil's @code{prv;bind1,bind2;pub@dots{}}-like configuration strings are
149 replaced with URL-like ones (@code{yggdrasils://PRV?bind=BIND1&bind=BIND2&pub=PUB}).
150
151 @item
152 Ability to pass multicast-related parameters to Yggdrasil configuration.
153
154 @item
155 @command{nncp-daemon} is able to listen on both TCP and Yggdrasil-driven
156 sockets simultaneously.
157
158 @item
159 @command{nncp-daemon}'s listening on peering endpoint socket is optional
160 -- you can be reached through the peers.
161
162 @end itemize
163
164 @node Release 8_1_0
165 @section Release 8.1.0
166 @itemize
167
168 @item
169 @command{nncp-cfgdir} does not require @code{self} section existence in
170 configuration file.
171
172 @item
173 Ability to act as Yggdrasil network client, using online protocol on top of it.
174
175 @end itemize
176
177 @node Release 8_0_2
178 @section Release 8.0.2
179 @itemize
180
181 @item
182 Fixed sending ability to areas.
183
184 @end itemize
185
186 @node Release 8_0_1
187 @section Release 8.0.1
188 @itemize
189
190 @item
191 Fixed incorrect @code{freq.chunked} value calculation. If it was missed,
192 then chunked transfer mode was forcefully turned on anyway.
193
194 @item
195 Fixed incorrect full file's size calculation in @file{.nncp.meta}.
196
197 @end itemize
198
199 @node Release 8_0_0
200 @section Release 8.0.0
201 @itemize
202
203 @item
204 @strong{Incompatible} encrypted packet format change: payload and pad
205 sizes are sent in-bound in the encrypted stream. That gives ability to
206 streamingly create encrypted packets, without knowing sizes in advance,
207 without creating temporary file or buffer data in memory.
208
209 @item
210 Proper encrypted packet padding verification is done now. This is not
211 critical issue, but previously neither padding value, nor its size were
212 authenticated, giving ability to iteratively strip trailing bytes and
213 determine payload's size by observing the reaction of the encrypted
214 packet processing.
215
216 @item
217 @command{nncp-exec} loses its @option{-use-tmp} option, because of
218 streaming-compatible encrypted packets format.
219
220 @item
221 @command{nncp-file} and @command{nncp-exec} commands have
222 @option{-maxsize} option, limiting maximal resulting encrypted packet's
223 maximal size (returning error if it is exceeded). Could be useful,
224 because no payload size could be known in advance.
225
226 @end itemize
227
228 @node Release 7_7_0
229 @section Release 7.7.0
230 @itemize
231
232 @item
233 Experimental @code{kqueue} and @code{inotify} based notifications
234 support about spool directory changes, for reducing their often reading
235 overhead.
236
237 @item
238 @file{.seen} and @file{.hdr} files moved to @file{seen/} and @file{hdr/}
239 subdirectories, for faster scanning of spool directories.
240 Current files migration required:
241
242 @example
243 $ find $NNCPSPOOL -type f -name "*.hdr" -exec rm @{@} +
244
245 $ find $NNCPSPOOL -type d -name rx | while read rx ; do
246     cd $rx
247     mkdir -p seen
248     find . -type f -name "*.seen" | while read fn ; do
249         mv $fn seen/$@{fn%.seen@}
250     done
251 done
252
253 $ find $NNCPSPOOL -type d -name area | while read area ; do
254     find $area -type f -name "*.seen" | while read fn ; do
255         mv $fn $@{fn%.seen@}
256     done
257 done
258 @end example
259
260 @end itemize
261
262 @node Release 7_6_0
263 @section Release 7.6.0
264 @itemize
265
266 @item
267 Logging may be done to specified opened file descriptor
268 (@env{$NNCPLOG=FD:5} for example).
269 That is friendly to use under @command{daemontools}.
270
271 @item
272 Added additional checks of public keys existence in configuration file,
273 preventing some commands from failing.
274
275 @end itemize
276
277 @node Release 7_5_1
278 @section Release 7.5.1
279 @itemize
280
281 @item
282 NNCP builds on NetBSD.
283
284 @end itemize
285
286 @node Release 7_5_0
287 @section Release 7.5.0
288 @itemize
289
290 @item
291 @command{nncp-daemon} is compatible with UCSPI-TCP interface, so log
292 will contain remote side's address (when running under appropriate
293 utility). @option{-ucspi} option should be used instead of @option{-inetd}.
294
295 @item
296 @command{nncp-call} can be UCSPI-TCP client, using @option{-ucspi} option.
297
298 @item
299 Do not exit if some of MCD network interfaces can not be listened --
300 only warn about that.
301
302 @end itemize
303
304 @node Release 7_4_0
305 @section Release 7.4.0
306 @itemize
307
308 @item
309 Fixed simultaneous @command{nncp-daemon} and @command{nncp-caller} MCD work.
310
311 @end itemize
312
313 @node Release 7_3_2
314 @section Release 7.3.2
315 @itemize
316
317 @item
318 @command{hjson-cli} utility builds in vendor-mode now.
319
320 @end itemize
321
322 @node Release 7_3_1
323 @section Release 7.3.1
324 @itemize
325
326 @item
327 Fixed possibly left opened file descriptor in online commands.
328
329 @item
330 Severely decreased memory usage of MTH hashing.
331
332 @end itemize
333
334 @node Release 7_3_0
335 @section Release 7.3.0
336 @itemize
337
338 @item
339 Fixed some workability problems on 32-bit systems with big files.
340
341 @item
342 Ability to use directory with a bunch of files as a configuration.
343 @command{nncp-cfgdir} command appeared.
344
345 @end itemize
346
347 @node Release 7_2_1
348 @section Release 7.2.1
349 @itemize
350
351 @item
352 Small optimizations in online commands.
353
354 @end itemize
355
356 @node Release 7_2_0
357 @section Release 7.2.0
358 @itemize
359
360 @item
361 @command{nncp-trns} command appeared for manual transition packets creation.
362
363 @item
364 If destination node of transitional packet has non empty @option{via}
365 route, then do not ignore, but use it.
366
367 @item
368 Do not relay multicast packet to area message's originator, that
369 obviously has seen its own packet.
370
371 @item
372 Much less memory usage during MTH hashing when offset is zero: when
373 packet is not resumed, but for example checked with @command{nncp-check}
374 command.
375
376 @end itemize
377
378 @node Release 7_1_1
379 @section Release 7.1.1
380 @itemize
381
382 @item
383 Fixed failing directories @code{fsync} after @file{.seen} file creation.
384
385 @end itemize
386
387 @node Release 7_1_0
388 @section Release 7.1.0
389 @itemize
390
391 @item
392 Multicasting areas feature appeared. Implemented merely by an additional
393 plain packet type with @command{nncp-toss}, @command{nncp-file} and
394 @command{nncp-exec} commands modification.
395
396 @item
397 Fixed workability of @command{nncp-file} and @command{nncp-exec}
398 commands, that use temporary file (@code{stdin} and @option{-use-tmp}).
399
400 @item
401 Fixed disappearing bad return code in @command{nncp-exec} command.
402
403 @item
404 Fixed invalid @file{.hdr} generation when transitional packets are used.
405
406 @item
407 @option{-all} option appeared in @command{nncp-rm} command, applying to
408 all the nodes at once.
409
410 @item
411 @option{-cycle} option appeared in @command{nncp-check} command, looping
412 the check in infinite cycle.
413
414 @item
415 @command{nncp-rm} command can take node alias name.
416
417 @item
418 @command{nncp-pkt} can parse @file{.hdr} files.
419
420 @end itemize
421
422 @node Release 7_0_0
423 @section Release 7.0.0
424 @itemize
425
426 @item
427 Minimal required Go version is 1.13.
428
429 @item
430 Merkle Tree-based Hashing with BLAKE3 (MTH) is used instead of BLAKE2b.
431 Because of that, there are backward @strong{incompatible} changes of
432 encrypted files (everything laying in the spool directory) and
433 @file{.meta} files of chunked transfer.
434
435 Current implementation is far from being optimal: it lacks
436 parallelizable calculations and has higher memory consumption: nearly
437 512 KiB for each 1 GiB of file's data. Future performance and memory
438 size optimizations should not lead to packet's format change. But it is
439 still several times faster than BLAKE2b.
440
441 @item
442 Resumed online downloads, because of MTH, require reading only of the
443 preceding part of file, not the whole one as was before.
444
445 @item
446 @command{nncp-hash} utility appeared for calculating file's MTH hash.
447
448 @item
449 BLAKE2 KDF and XOF functions are replaced with BLAKE3 in encrypted
450 packets. Lowering number of used primitives. Also, its encrypted
451 packet's header is used as an associated data during encryption.
452
453 @item
454 MultiCast Discovery uses
455 @verb{|ff02::4e4e:4350|} address instead of @verb{|ff02::1|}.
456
457 @item
458 @command{nncp-cfgenc} mistakenly asked passphrase three times during encryption.
459
460 @item
461 @command{nncp-stat} reports about partly downloaded packets.
462
463 @item
464 Updated dependencies.
465
466 @end itemize
467
468 @node Release 6_6_0
469 @section Release 6.6.0
470 @itemize
471
472 @item
473 @command{nncp-daemon}, @command{nncp-call} and @command{nncp-caller}
474 commands wait for all background checksummers completion after
475 connection is finished.
476
477 @item
478 Added possibility of address determining through multicast announcement
479 in local area network, so called MCD (MultiCast Discovery).
480
481 @end itemize
482
483 @node Release 6_5_0
484 @section Release 6.5.0
485 @itemize
486
487 @item
488 Fixed segfault in @command{nncp-daemon} when SP handshake did not succeed.
489
490 @item
491 Fixed possible bad return code ignoring in automatic tosser.
492
493 @item
494 Fixed race during file descriptors closing when online protocol call is
495 finished, that could lead to write error of received packet fragment.
496
497 @item
498 Kill all packet transmission progress bars in @command{nncp-daemon},
499 @command{nncp-call} and @command{nncp-caller} when call is finished.
500
501 @end itemize
502
503 @node Release 6_4_0
504 @section Release 6.4.0
505 @itemize
506
507 @item
508 Fixed possible race in online protocol, that lead to panic.
509
510 @end itemize
511
512 @node Release 6_3_0
513 @section Release 6.3.0
514 @itemize
515
516 @item
517 Fixed possible panic while showing progress during online protocol.
518
519 @end itemize
520
521 @node Release 6_2_1
522 @section Release 6.2.1
523 @itemize
524
525 @item
526 Three places in logs contained excess @code{%s}.
527
528 @end itemize
529
530 @node Release 6_2_0
531 @section Release 6.2.0
532 @itemize
533
534 @item
535 Returned @command{nncp-caller}'s @option{-autotoss*} options workability.
536
537 @item
538 Yet another logging refactoring and simplification.
539 Should be no visible differences to the end user.
540
541 @end itemize
542
543 @node Release 6_1_0
544 @section Release 6.1.0
545 @itemize
546
547 @item
548 Optimization: most commands do not keep opened file descriptors now.
549 Previously you can exceed maximal number of opened files if you have got
550 many packets in the spool directory.
551
552 @item
553 Optimization: do not close file descriptor of the file we download
554 online. Previously each chunk lead to expensive open/close calls.
555
556 @item
557 Online downloaded files are saved with @file{.nock} (non-checksummed)
558 suffix, waiting either for @command{nncp-check}, or online daemons to
559 perform integrity check.
560
561 @item
562 Optimization: files, that are not resumed, are checksummed immediately
563 during the online download, skipping @file{.nock}-intermediate step.
564
565 @item
566 Ability to store encrypted packet's header in @file{.hdr} file, close to
567 the packet itself. That can greatly increase performance of packets
568 listing on filesystems with big block's size.
569
570 @end itemize
571
572 @node Release 6_0_0
573 @section Release 6.0.0
574 @itemize
575
576 @item
577 Log uses human readable and easy machine parseable
578 @url{https://www.gnu.org/software/recutils/, recfile} format for the
579 records, instead of structured RFC 3339 lines. Old logs are not readable
580 by @command{nncp-log} anymore.
581
582 @item
583 @option{-autotoss*} option workability with @command{nncp-daemon}'s
584 @option{-inetd} mode.
585
586 @item
587 Call's @option{when-tx-exists} allows to make a call only when outbound
588 packets exists. Combined with seconds-aware cron expression that can be
589 used as some kind of auto dialler.
590
591 @item
592 @command{nncp-cronexpr} command allows you to check validity and
593 expectations of specified cron expression.
594
595 @end itemize
596
597 @node Release 5_6_0
598 @section Release 5.6.0
599 @itemize
600
601 @item
602 @option{-autotoss*} option runs tosser not after the call, but every
603 second while it is active.
604
605 @item
606 @option{autotoss}, @option{autotoss-doseen},
607 @option{autotoss-nofile}, @option{autotoss-nofreq},
608 @option{autotoss-noexec}, @option{autotoss-notrns} options available in
609 @option{calls} configuration section. You can configure per-call
610 automatic tosser options.
611
612 @item
613 Use vendoring, instead of @env{$GOPATH} overriding during tarball
614 installation, because current minimal Go's version is 1.12 and it
615 supports modules.
616
617 @end itemize
618
619 @node Release 5_5_1
620 @section Release 5.5.1
621 @itemize
622
623 @item
624 Respect for @env{$BINDIR}, @env{$INFODIR} and @env{$DOCDIR} environment
625 variables in @file{config} during installation.
626
627 @end itemize
628
629 @node Release 5_5_0
630 @section Release 5.5.0
631 @itemize
632
633 @item
634 Bugfixes in @command{nncp-call(er)}/@command{nncp-daemon},
635 @command{nncp-bundle} and @command{nncp-stat}.
636
637 @item
638 @command{nncp-rm} has @option{-dryrun} and @option{-older} options now.
639
640 @item
641 @command{nncp-exec} has @option{-use-tmp} and @option{-nocompress}
642 options now. Uncompressed packets are not compatible with previous NNCP
643 versions.
644
645 @item
646 @command{nncp-call}, @command{nncp-caller} and @command{nncp-daemon} commands
647 have @option{-autotoss*} options for running tosser after call is ended.
648
649 @item
650 Updated dependencies. Minimal required Go version is 1.12.
651
652 @end itemize
653
654 @node Release 5_4_1
655 @section Release 5.4.1
656 @itemize
657
658 @item
659 Fixed @code{SENDMAIL} variable usage during the build.
660
661 @end itemize
662
663 @node Release 5_4_0
664 @section Release 5.4.0
665 @itemize
666
667 @item
668 Updated dependencies.
669
670 @item
671 Build system is moved from Makefiles to @url{http://cr.yp.to/redo.html, redo}.
672 This should not influence package maintainers, because minimal @command{redo}
673 implementation is included in tarball.
674
675 @end itemize
676
677 @node Release 5_3_3
678 @section Release 5.3.3
679 @itemize
680
681 @item
682 More various error checks.
683
684 @item
685 Updated dependencies.
686
687 @end itemize
688
689 @node Release 5_3_2
690 @section Release 5.3.2
691 @itemize
692
693 @item
694 Fixed incorrect logic of @option{onlinedeadline} timeout, where
695 connection won't take into account incoming packets events and will
696 forcefully disconnect.
697
698 @end itemize
699
700 @node Release 5_3_1
701 @section Release 5.3.1
702 @itemize
703
704 @item
705 Fixed @option{onlinedeadline} workability with call addresses that use
706 external commands (@verb{#"|somecmd"#}).
707
708 @item
709 @command{nncp-stat} has @option{-pkt} option displaying information
710 about each packet in the spool.
711
712 @end itemize
713
714 @node Release 5_3_0
715 @section Release 5.3.0
716 @itemize
717
718 @item
719 Progress messages contain prefix, describing the running action.
720
721 @item
722 Fixed not occurring handshake messages padding.
723
724 @item
725 Finish all SP protocol related goroutines, less memory leak.
726
727 @item
728 SP protocol generates less socket write calls, thus generating less TCP
729 packets.
730
731 @item
732 Check @option{onlinedeadline} and @option{maxonlinetime} options every
733 second, independently from socket reads (up to 10 seconds).
734
735 @item
736 Once per minute, if no other traffic exists, PING packets are sent in
737 SP-connection. That allows faster determining of connection unworkability.
738
739 @item
740 @command{nncp-toss} uses lock-file to prevent simultaneous tossing.
741
742 @end itemize
743
744 @node Release 5_2_1
745 @section Release 5.2.1
746 @itemize
747
748 @item
749 Fixed SP protocol error handling, sometimes causing program panic.
750
751 @end itemize
752
753 @node Release 5_2_0
754 @section Release 5.2.0
755 @itemize
756
757 @item
758 Most commands by default show oneline operations progress.
759 @option{-progress}, @option{-noprogress} command line options,
760 @option{noprogress} configuration file option appeared.
761
762 @item
763 Fixed incorrect @command{nncp-check} command return code, that returned
764 bad code when everything is good.
765
766 @item
767 Free disk space check during @command{nncp-bundle -rx} call.
768
769 @end itemize
770
771 @node Release 5_1_2
772 @section Release 5.1.2
773 @itemize
774
775 @item
776 @strong{Critical} vulnerability: remote peers authentication could lead
777 to incorrect identification of remote side, allowing foreign encrypted
778 packets downloading.
779
780 @item
781 Bugfix: private and public Noise keys were swapped in newly created
782 configuration files, that lead to inability to authenticate online peers.
783
784 @item
785 Explicit directories @code{fsync}-ing for guaranteed files renaming.
786
787 @end itemize
788
789 @node Release 5_1_1
790 @section Release 5.1.1
791 @itemize
792
793 @item
794 Fixed workability of @command{nncp-file} with @option{-chunked 0} option.
795
796 @end itemize
797
798 @node Release 5_1_0
799 @section Release 5.1.0
800 @itemize
801
802 @item
803 @command{nncp-file} can send directories, automatically creating pax
804 archive on the fly.
805
806 @item
807 Free disk space is checked during outbound packets creation.
808
809 @item
810 @option{freq}, @option{freqminsize}, @option{freqchunked} configuration
811 file options replaced with the structure:
812 @option{freq: @{path: @dots{}, minsize: @dots{}, chunked: @dots{}@}}.
813
814 @item
815 Added @option{freq.maxsize} configuration file option, forbidding of
816 freq sending larger than specified size.
817
818 @item
819 Ability to notify about successfully executed commands (exec) with
820 @option{notify.exec} configuration file option.
821
822 @end itemize
823
824 @node Release 5_0_0
825 @section Release 5.0.0
826 @itemize
827
828 @item
829 @strong{Incompatible} configuration file format change: YAML is
830 replaced with Hjson, due to its simplicity, without noticeable lack
831 of either functionality or convenience.
832
833 @item
834 @strong{Incompatible} plain packet format changes. Older versions are
835 not supported. @code{zlib} compression is replaced with
836 @code{Zstandard}, due to its speed and efficiency, despite library
837 version is not mature enough.
838
839 @item
840 Ability to call remote nodes via pipe call of external command, not only
841 through TCP.
842
843 @item
844 @command{nncp-cfgnew} generates configuration file with many
845 comments. @option{-nocomments} option can be used for an old
846 behaviour.
847
848 @item
849 Duplicate filenames have @file{.CTR} suffix, instead of @file{CTR}, to
850 avoid possible collisions with @file{.nncp.chunkCTR}.
851
852 @item
853 Ability to override process umask through configuration file option.
854
855 @item
856 Files and directories are created with 666/777 permissions by default,
857 allowing control with @command{umask}.
858
859 @item
860 Updated dependencies.
861
862 @item
863 Full usage of go modules for dependencies management
864 (@code{go.cypherpunks.ru/nncp/v5} namespace is used).
865
866 @item
867 Forbid any later GNU GPL version autousage
868 (project's licence now is GNU GPLv3-only).
869
870 @end itemize
871
872 @node Release 4_1
873 @section Release 4.1
874 @itemize
875 @item Workability on GNU/Linux systems and Go 1.10 is fixed.
876 @end itemize
877
878 @node Release 4_0
879 @section Release 4.0
880 @itemize
881
882 @item
883 @strong{Incompatible} encrypted and eblob packet format change: AEAD
884 encryption mode with 128 KiB blocks is used now, because previously
885 @command{nncp-toss} did not verify encrypted packet's MAC before feeding
886 decrypted data to external command. Older versions are not supported.
887
888 @item
889 Available free space checking before copying in @command{nncp-xfer},
890 @command{nncp-daemon}, @command{nncp-call(er)}.
891
892 @item
893 @command{nncp-call} has ability only to list packets on remote node,
894 without their transmission.
895
896 @item
897 @command{nncp-call} has ability to transfer only specified packets.
898
899 @item
900 Workability of @option{xxrate} preference in @option{calls}
901 configuration file section.
902
903 @item
904 Dependant libraries are updated.
905
906 @item
907 Minor bugfixes.
908
909 @item
910 Begin using of @code{go.mod} subsystem.
911
912 @end itemize
913
914 @node Release 3_4
915 @section Release 3.4
916 @itemize
917 @item @command{nncp-daemon} can be run as @command{inetd}-service.
918 @end itemize
919
920 @node Release 3_3
921 @section Release 3.3
922 @itemize
923
924 @item
925 @command{nncp-daemon}, @command{nncp-call}, @command{nncp-caller} check
926 if @file{.seen} exists and treat it like file was already downloaded.
927 Possibly it was transferred out-of-bound and remote side needs to be
928 notifier about that.
929
930 @item
931 If higher priority packet is spooled, then @command{nncp-daemon} will
932 queue its sending first, interrupting lower priority transmissions.
933
934 @item
935 Simple packet rate limiter added to online-related tools
936 (@command{nncp-daemon}, @command{nncp-call}, @command{nncp-caller}).
937
938 @item
939 Ability to specify niceness with symbolic notation:
940 @verb{|NORMAL|}, @verb{|BULK+10|}, @verb{|PRIORITY-5|}, etc.
941
942 @item
943 Changed default niceness levels:
944 for @command{nncp-exec} from 64 to 96,
945 for @command{nncp-freq} from 64 to 160,
946 for @command{nncp-file} from 196 to 224.
947
948 @end itemize
949
950 @node Release 3_2
951 @section Release 3.2
952 @itemize
953 @item
954 @strong{Incompatible} @emph{bundle} archive format changes and
955 @command{nncp-bundle} workability with Go 1.10+. Bundles must be
956 valid tar archives, but Go 1.9 made them invalid because of long paths
957 inside. NNCP accidentally was dependant on that bug. Explicit adding of
958 @file{NNCP/} directory in archive restores workability with valid tar
959 archives.
960 @end itemize
961
962 @node Release 3_1
963 @section Release 3.1
964 @itemize
965 @item
966 Ability to disable relaying at all using @verb{|-via -|} command line option.
967 @end itemize
968
969 @node Release 3_0
970 @section Release 3.0
971 @itemize
972
973 @item
974 @strong{Incompatible} plain packet format changes. Older versions are
975 not supported.
976
977 @item
978 Ability to queue remote command execution, by configuring @option{exec}
979 option in configuration file and using @command{nncp-exec} command:
980     @itemize
981     @item
982     @command{nncp-mail} command is replaced with more flexible
983     @command{nncp-exec}. Instead of @verb{|nncp-mail NODE RECIPIENT|}
984     you must use @verb{|nncp-exec NODE sendmail RECIPIENT|}.
985     @item
986     @option{sendmail} configuration file option is replaced with
987     @option{exec}. @code{sendmail: [@dots{}]} must be replaced with
988     @code{exec: sendmail: [@dots{}]}.
989     @end itemize
990
991 @item
992 Ability to override @option{via} configuration option for destination
993 node via @option{-via} command line option for following commands:
994 @command{nncp-file}, @command{nncp-freq}, @command{nncp-exec}.
995
996 @item
997 Chunked files, having size less than specified chunk size, will be sent
998 as an ordinary single file.
999
1000 @item
1001 Exec commands are invoked with additional @env{$NNCP_NICE} and
1002 @env{$NNCP_SELF} environment variables.
1003
1004 @item
1005 Files, that are sent as a reply to freq, have niceness level taken from
1006 the freq packet. You can set desired niceness during @command{nncp-freq}
1007 invocation using @option{-replynice} option.
1008
1009 @item
1010 @command{nncp-toss} command can ignore specified packet types during
1011 processing: @option{-nofile}, @option{-nofreq}, @option{-noexec},
1012 @option{-notrns}.
1013
1014 @item
1015 @command{nncp-file} command uses
1016 @option{FreqMinSize}/@option{FreqChunked} configuration file options
1017 for @option{-minsize}/@option{-chunked} by default. You can turn this
1018 off by specifying zero value.
1019
1020 @end itemize
1021
1022 @node Release 2_0
1023 @section Release 2.0
1024 @itemize
1025
1026 @item
1027 @strong{Incompatible} encrypted/eblob packet format changes. Older
1028 versions are not supported.
1029
1030 @item
1031 Twofish encryption algorithm is replaced with ChaCha20. It is much more
1032 faster. One cryptographic primitive less.
1033
1034 @item
1035 HKDF-BLAKE2b-256 KDF algorithm is replaced with BLAKE2Xb XOF. Yet
1036 another cryptographic primitive less (assuming that BLAKE2X is nearly
1037 identical to BLAKE2).
1038
1039 @end itemize
1040
1041 @node Release 1_0
1042 @section Release 1.0
1043 @itemize
1044
1045 @item
1046 @strong{Incompatible} encrypted packet format changes. Older versions
1047 are not supported.
1048
1049 @item
1050 @command{nncp-bundle} command can either create stream of encrypted
1051 packets, or digest it. It is useful when dealing with
1052 @code{stdin}/@code{stdout} based transmission methods (like writing to
1053 CD-ROM without intermediate prepared ISO image and working with tape
1054 drives).
1055
1056 @item
1057 @command{nncp-toss} is able to create @file{.seen} files preventing
1058 duplicate packets receiving.
1059
1060 @item
1061 Single background checksum verifier worker is allowed in
1062 @command{nncp-call}. This is helpful when thousands of small inbound
1063 packets could create many goroutines.
1064
1065 @item
1066 Ability to override path to spool directory and logfile through either
1067 command line argument, or environment variable.
1068
1069 @item
1070 @command{nncp-rm} is able to delete outbound/inbound, @file{.seen},
1071 @file{.part}, @file{.lock} and temporary files.
1072
1073 @end itemize
1074
1075 @node Release 0_12
1076 @section Release 0.12
1077 @itemize
1078 @item Sendmail command is called with @env{$NNCP_SENDER} environment variable.
1079 @end itemize
1080
1081 @node Release 0_11
1082 @section Release 0.11
1083 @itemize
1084 @item @command{nncp-stat}'s command output is sorted by node name.
1085 @end itemize
1086
1087 @node Release 0_10
1088 @section Release 0.10
1089 @itemize
1090 @item
1091 @command{nncp-freq}'s @file{DST} argument is optional now. Last
1092 @file{SRC} path's element will be used by default.
1093 @end itemize
1094
1095 @node Release 0_9
1096 @section Release 0.9
1097 @itemize
1098 @item
1099 Fix @option{-rx}/@option{-tx} arguments processing in
1100 @command{nncp-call} command. They were ignored.
1101 @end itemize
1102
1103 @node Release 0_8
1104 @section Release 0.8
1105 @itemize
1106 @item
1107 Little bugfix in @command{nncp-file} command, where @option{-minsize}
1108 option for unchunked transfer was not in KiBs, but in bytes.
1109 @end itemize
1110
1111 @node Release 0_7
1112 @section Release 0.7
1113 @itemize
1114
1115 @item
1116 Ability to feed @command{nncp-file} from @code{stdin}, that uses an
1117 encrypted temporary file for that.
1118
1119 @item
1120 Chunked files transmission appeared with corresponding
1121 @command{nncp-reass} command and @option{freqchunked} configuration file
1122 entry. Useful for transferring big files over small storage devices.
1123
1124 @item
1125 @option{freqminsize} configuration file option, analogue to
1126 @option{-minsize} one.
1127
1128 @item
1129 @command{nncp-xfer}'s @option{-force} option is renamed to
1130 @option{-mkdir} for clarity.
1131
1132 @item
1133 @option{-minsize} option is specified in KiBs, not bytes, for
1134 convenience.
1135
1136 @item
1137 @command{nncp-newcfg} command is renamed to @command{nncp-cfgnew},
1138 and @command{nncp-mincfg} to @command{nncp-cfgmin} -- now they have
1139 common prefix and are grouped together for convenience.
1140
1141 @item
1142 @command{nncp-cfgenc} command appeared, allowing configuration file
1143 encryption/decryption, for keeping it safe without any either OpenPGP or
1144 similar tools usage.
1145
1146 @item
1147 Cryptographic libraries (dependencies) are updated.
1148
1149 @end itemize
1150
1151 @node Release 0_6
1152 @section Release 0.6
1153 @itemize
1154 @item Small @command{nncp-rm} command appeared.
1155 @item Cryptographic libraries (dependencies) are updated.
1156 @end itemize
1157
1158 @node Release 0_5
1159 @section Release 0.5
1160 @itemize
1161 @item
1162 Trivial small fix in default niceness level of @command{nncp-file}
1163 and @command{nncp-freq} commands.
1164 @end itemize
1165
1166 @node Release 0_4
1167 @section Release 0.4
1168 @itemize
1169
1170 @item
1171 Small fix in @command{nncp-call}, @command{nncp-caller},
1172 @command{nncp-daemon}: they can segmentation fail sometimes (no data is
1173 lost).
1174
1175 @item
1176 @command{nncp-newnode} renamed to @command{nncp-newcfg} -- it is shorter
1177 and more convenient to use.
1178
1179 @item
1180 @command{nncp-mincfg} command appeared: helper allowing to create
1181 minimalistic stripped down configuration file without private keys, that
1182 is useful during @command{nncp-xfer} usage.
1183
1184 @end itemize
1185
1186 @node Release 0_3
1187 @section Release 0.3
1188 @itemize
1189 @item Fixed compatibility with Go 1.6.
1190 @end itemize
1191
1192 @node Release 0_2
1193 @section Release 0.2
1194 @itemize
1195
1196 @item
1197 @strong{Incompatible} packet's format change (magic number is changed
1198 too): size field is encrypted and is not send in plaintext anymore.
1199
1200 @item
1201 @option{-minsize} option gives ability to automatically pad outgoing
1202 packets to specified minimal size.
1203
1204 @item
1205 @command{nncp-daemon} and @command{nncp-call}/@command{nncp-caller}
1206 always check new @emph{tx} packets appearance in the background while
1207 connected. Remote side is immediately notified.
1208
1209 @item
1210 @option{-onlinedeadline} option gives ability to configure timeout of
1211 inactivity of online connection, when it could be disconnected. It could
1212 be used to keep connection alive for a long time.
1213
1214 @item
1215 @option{-maxonlinetime} option gives ability to set maximal allowable
1216 online connection aliveness time.
1217
1218 @item
1219 @command{nncp-caller} command appeared: cron-ed TCP daemon caller.
1220
1221 @item
1222 @command{nncp-pkt} command can decompress the data.
1223
1224 @end itemize