X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcmd%2Fnncp-ack.texi;h=2fc607788f654185ac9d24aa10589a7d3f0a3cb7;hb=d9ecff4495f8e5b98c9d75844b1ea32c84b20727;hp=5635cc15c27158f9e15677165b2ff1626650dcbb;hpb=904e7d0c6b99b13e57a987d583fa7e769add8c09;p=nncp.git diff --git a/doc/cmd/nncp-ack.texi b/doc/cmd/nncp-ack.texi index 5635cc1..2fc6077 100644 --- a/doc/cmd/nncp-ack.texi +++ b/doc/cmd/nncp-ack.texi @@ -7,12 +7,19 @@ $ nncp-ack [options] -all $ nncp-ack [options] -node NODE[,@dots{}] $ nncp-ack [options] -node NODE -pkt PKT + +$ nncp-ack [@dots{}] 4>&1 >&2 | nncp-rm [@dots{}] -pkt @end example Send acknowledgement of successful @option{PKT} (Base32-encoded hash) packet receipt from @option{NODE} node. If no @option{-pkt} is -specified, then acknowledge all packet in node's @code{rx} outbound -spool. If @option{-all} is specified, then do that for all nodes. +specified, then acknowledge all packet in node's @code{rx} spool. +If @option{-all} is specified, then do that for all nodes. + +That commands outputs list of created encrypted ACK packets +(@code{NODE/PKT}) to @strong{4}th file descriptor. That output can be +passed for example to @command{@ref{nncp-rm}} to remove them after +transmission to not wait for acknowledgement and retransmission. General workflow with acknowledgement is following, assuming that Alice has some outbound packets for Bob: @@ -33,16 +40,24 @@ bob$ nncp-xfer -rx /mnt/shared That will also check if copied packets checksum is not mismatched. -@item Create ACK packets of received ones: +@item Create ACK packets of received ones, saving the list of encrypted + ACK packets: @example -bob$ nncp-ack -node alice +bob$ nncp-ack -node alice 4>acks @end example @item Send those newly created packets back to Alice: @example -bob$ nncp-xfer -tx /mnt/shared +bob$ nncp-xfer [-keep] -tx /mnt/shared +@end example + +@item Remove them from outbound spool, because we expect no + acknowledgement for them: + +@example +bob$ nncp-rm -node alice -pkt