X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcmds.texi;h=665b57629d394f9926f95d1b04f79deabf3c6cb8;hb=0ca5764d9eeff210ebf50d6c2e03fa6cbd173b99;hp=5141b08dd09bf0d98f0f0c4e686d71ca8452d941;hpb=16ac75d51758c249f5fc4e8fac9cf71b84331c55;p=nncp.git diff --git a/doc/cmds.texi b/doc/cmds.texi index 5141b08..665b576 100644 --- a/doc/cmds.texi +++ b/doc/cmds.texi @@ -238,7 +238,7 @@ $ nncp-check [-nock] [options] Perform @ref{Spool, spool} directory integrity check. Read all files that has Base32-encoded filenames and compare it with recalculated -BLAKE2b hash output of their contents. +@ref{MTH} hash output of their contents. The most useful mode of operation is with @option{-nock} option, that checks integrity of @file{.nock} files, renaming them to ordinary @@ -260,7 +260,7 @@ next time entities. @example $ nncp-daemon [options] [-maxconn INT] [-bind ADDR] [-inetd] - [-autotoss*] [-nock] + [-autotoss*] [-nock] [-mcd-once] @end example Start listening TCP daemon, wait for incoming connections and run @@ -288,6 +288,9 @@ during the call. All @option{-autotoss-*} options is the same as in Read @ref{CfgNoCK, more} about @option{-nock} option. +@option{-mcd-once} option sends @ref{MCD} announcements once and quits. +Could be useful with inetd-based setup, where daemons are not running. + @node nncp-exec @section nncp-exec @@ -359,7 +362,7 @@ for that temporary file and resulting encrypted packet. You can control temporary file location directory with @env{TMPDIR} environment variable. Encryption is performed in AEAD mode with @url{https://cr.yp.to/chacha.html, ChaCha20}-@url{https://en.wikipedia.org/wiki/Poly1305, Poly1305} -algorithms. Data is splitted on 128 KiB blocks. Each block is encrypted +algorithms. Data is divided on 128 KiB blocks. Each block is encrypted with increasing nonce counter. File is deletes immediately after creation, so even if program crashes -- disk space will be reclaimed, no need in cleaning it up later. @@ -401,6 +404,24 @@ If @ref{CfgNotify, notification} is enabled on the remote side for file request, then it will sent simple letter after successful file queuing. +@node nncp-hash +@section nncp-hash + +@example +$ nncp-log [-file ...] [-seek X] [-debug] [-progress] +@end example + +Calculate @ref{MTH} hash of either stdin, or @option{-file} if +specified. + +You can optionally force seeking the file first, reading only part of +the file, and then prepending unread portion of data, with the +@option{-seek} option. It is intended only for testing and debugging of +MTH hasher capabilities. + +@option{-debug} option shows all intermediate MTH hashes. +And @option{-progress} will show progress bar. + @node nncp-log @section nncp-log