Next: nncp-exec, Previous: nncp-cfgdir, Up: Commands
$ nncp-file [options] [-chunked INT] SRC NODE:[DST] $ nncp-file [options] [-chunked INT] SRC area:AREA:[DST]
Send SRC file to remote NODE. DST specifies destination file name in remote’s incoming directory. If this file already exists there, then counter will be appended to it.
This command queues file in spool directory immediately (through the temporary file of course) – so pay attention that sending 2 GiB file will create 2 GiB outbound encrypted packet.
If SRC equals to -, then create an encrypted temporary
file and copy everything taken from stdin
to it and use for outbound
packet creation. Pay attention that if you want to send 1 GiB of data
taken from stdin
, then you have to have more than 2 GiB of disk space
for that temporary file and resulting encrypted packet. You can control
temporary file location directory with $TMPDIR
environment
variable. Encryption is performed in AEAD mode with
ChaCha20-Poly1305
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.
If SRC points to directory, then
pax archive
will be created on the fly with directory contents and destination
filename .tar appended. It won’t contain any entities
metainformation, but modification time with the names. UID/GID are set
to zero. Directories have 777 permissions, files have 666, for being
friendly with umask
. Also each entity will have comment like
Autogenerated by NNCP version X.Y.Z built with goXXX.
If -chunked is specified, then source file will be split on chunks. INT is the desired chunk size in KiBs. This mode is more CPU hungry. Pay attention that chunk is saved in spool directory immediately and it is not deleted if any error occurs. -minsize option is applied per each chunk. Do not forget about possible ZFS deduplication issues. Zero -chunked disables chunked transmission.
If notification is enabled on the remote side for file transmissions, then it will sent simple letter after successful file receiving.
If you use area:AREA instead of NODE, then multicast packet will be sent to specified area. That creates outgoing packet to the self node, so you have to run tossing to create outgoing packets to required subscribers.
Next: nncp-exec, Previous: nncp-cfgdir, Up: Commands