nncp-ack (NNCP)

Next: nncp-xfer, Previous: nncp-trns, Up: Commands [Index]

nncp-ack

$ nncp-ack [options] -all
$ nncp-ack [options] -node NODE[,…]
$ nncp-ack [options] -node NODE -pkt PKT

$ nncp-ack […] 4>&1 >&2 | nncp-rm […] -pkt

Send acknowledgement of successful PKT (Base32-encoded hash) packet receipt from NODE node. If no -pkt is specified, then acknowledge all packet in node’s rx outbound spool. If -all is specified, then do that for all nodes.

That commands outputs list of created encrypted ACK packets (NODE/PKT) to 4th file descriptor. That output can be passed for example to 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:

Transfer encrypted packets, without deleting them locally:
```
alice$ nncp-xfer -keep -tx -node bob /mnt/shared
```
On Bob’s side retrieve those packets:
```
bob$ nncp-xfer -rx /mnt/shared
```
That will also check if copied packets checksum is not mismatched.
Create ACK packets of received ones, saving the list of encrypted ACK packets:
```
bob$ nncp-ack -node alice 4>acks
```
Send those newly created packets back to Alice:
```
bob$ nncp-xfer [-keep] -tx /mnt/shared
```
Remove them from outbound spool, because we expect no acknowledgement for them:
```
bob$ nncp-rm -node alice -pkt <acks
```
Get those acknowledgement packets and toss them:
```
alice$ nncp-xfer -rx /mnt/shared
alice$ nncp-toss
```
Each ACK packet will remove kept corresponding outbound packets, because Bob explicitly confirmed their receipt.

Similarly you can use it with nncp-bundle, but do not forget that by default it does not do checksumming of the packets, so you should either use its -check option, or run nncp-check after.