X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcmds.texi;h=665b57629d394f9926f95d1b04f79deabf3c6cb8;hb=0ca5764d9eeff210ebf50d6c2e03fa6cbd173b99;hp=ae7bd52824db6b5346220341612a1bfa223719ee;hpb=d182e82482b61ac3b0e9e0005ca7a018acf899f1;p=nncp.git diff --git a/doc/cmds.texi b/doc/cmds.texi index ae7bd52..665b576 100644 --- a/doc/cmds.texi +++ b/doc/cmds.texi @@ -102,6 +102,7 @@ $ nncp-call [options] [-rxrate INT] [-txrate INT] [-autotoss*] + [-nock] NODE[:ADDR] [FORCEADDR] @end example @@ -114,15 +115,17 @@ transfer. If @option{-rx} option is specified then only inbound packets transmission is performed. If @option{-tx} option is specified, then -only outbound transmission is performed. @option{-onlinedeadline} -overrides @ref{CfgOnlineDeadline, @emph{onlinedeadline}}. -@option{-maxonlinetime} overrides @ref{CfgMaxOnlineTime, -@emph{maxonlinetime}}. @option{-rxrate}/@option{-txrate} override -@ref{CfgXxRate, rxrate/txrate}. @option{-list} option allows you to list -packets of remote node, without any transmission. +only outbound transmission is performed. -You can specify what packets your want to download, by specifying -@option{-pkts} option with comma-separated list of packets identifiers. +@option{-onlinedeadline} overrides @ref{CfgOnlineDeadline, @emph{onlinedeadline}}. +@option{-maxonlinetime} overrides @ref{CfgMaxOnlineTime, @emph{maxonlinetime}}. +@option{-rxrate}/@option{-txrate} override @ref{CfgXxRate, rxrate/txrate}. +Read @ref{CfgNoCK, more} about @option{-nock} option. + +@option{-list} option allows you to list packets of remote node, without +any transmission. You can specify what packets your want to download, by +specifying @option{-pkts} option with comma-separated list of packets +identifiers. Each @option{NODE} can contain several uniquely identified @option{ADDR}esses in @ref{CfgAddrs, configuration} file. If you do @@ -230,19 +233,34 @@ operating system. @section nncp-check @example -$ nncp-check [options] +$ nncp-check [-nock] [options] @end example 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. That supplementary command is -not used often in practice, if ever. +@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 +(verified) encrypted packets. + +@node nncp-cronexpr +@section nncp-cronexpr + +@example +$ nncp-cronexpr -num 12 "*/1 * * * * SAT,SUN 2021" +@end example + +Check validity of specified @ref{CronExpr, cron expression} and print 12 +next time entities. @node nncp-daemon @section nncp-daemon @example -$ nncp-daemon [options] [-maxconn INT] [-bind ADDR] [-inetd] [-autotoss*] +$ nncp-daemon [options] + [-maxconn INT] [-bind ADDR] [-inetd] + [-autotoss*] [-nock] [-mcd-once] @end example Start listening TCP daemon, wait for incoming connections and run @@ -268,6 +286,11 @@ uucp stream tcp6 nowait nncpuser /usr/local/bin/nncp-daemon nncp-daemon -quiet - during the call. All @option{-autotoss-*} options is the same as in @ref{nncp-toss} command. +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 @@ -339,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. @@ -381,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 @@ -388,7 +429,8 @@ queuing. $ nncp-log [options] @end example -Parse @ref{Log, log} file and print out its records in human-readable form. +Parse @ref{Log, log} file and print out its records in short +human-readable form. @node nncp-pkt @section nncp-pkt @@ -498,6 +540,7 @@ $ nncp-rm [options] -tmp $ nncp-rm [options] -lock $ nncp-rm [options] -node NODE -part $ nncp-rm [options] -node NODE -seen +$ nncp-rm [options] -node NODE -nock $ nncp-rm [options] -node NODE [-rx] [-tx] $ nncp-rm [options] -node NODE -pkt PKT @end example @@ -518,10 +561,10 @@ Base32 name) will be deleted. This is useful when you see some packet failing to be processed. @item When either @option{-rx} or @option{-tx} options are specified -(maybe both of them), then delete all packets from that given queues. If -@option{-part} is given, then delete only @file{.part}ly downloaded -ones. If @option{-seen} option is specified, then delete only -@file{.seen} files. +(maybe both of them), then delete all packets from that given queues. +@option{-part} option deletes @file{.part}ly downloaded files. +@option{-seen} option deletes @file{.seen} files. @option{-nock} option +deletes non-checksummed (non-verified) @file{.nock} files. @item @option{-dryrun} option just prints what will be deleted.