X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fspool.texi;h=8a4ce6c816b364a9b67e5ba5e4c306bd6a66ea18;hb=6942e7cfaacc951055282110e55c99f206444459;hp=097b1802c09ab3d381082485d2f7006cbdda7f2a;hpb=4a4c1be88baf3fa5426bc1c9c96e104643155fca;p=nncp.git diff --git a/doc/spool.texi b/doc/spool.texi index 097b180..8a4ce6c 100644 --- a/doc/spool.texi +++ b/doc/spool.texi @@ -13,22 +13,28 @@ spool/2WHB...OABQ/tx.lock spool/BYRR...CG6Q/rx.lock spool/BYRR...CG6Q/rx/ spool/BYRR...CG6Q/tx.lock +spool/BYRR...CG6Q/tx/AQUT...DGNT.seen spool/BYRR...CG6Q/tx/NSYY...ZUU6 +spool/BYRR...CG6Q/tx/VCSR...3VXX.seen spool/BYRR...CG6Q/tx/ZI5U...5RRQ @end verbatim -Except for @code{tmp}, all other directories are Base32-encoded node -identifiers (@code{2WHB...OABQ}, @code{BYRR...CG6Q} in our example). -Each node subdirectory has @code{rx} (received, partly received and -currently unprocessed packets) and @code{tx} (for outbound packets) +Except for @file{tmp}, all other directories are Base32-encoded node +identifiers (@file{2WHB...OABQ}, @file{BYRR...CG6Q} in our example). +Each node subdirectory has @file{rx} (received, partly received and +currently unprocessed packets) and @file{tx} (for outbound packets) directories. -Each @code{rx}/@code{tx} directory contains one file per encrypted +Each @file{rx}/@file{tx} directory contains one file per encrypted packet. Its filename is Base32 encoded BLAKE2b hash of the contents. So -it can be integrity checked at any time. @code{5ZIB...UMKW.part} is -partly received file from @code{2WHB...OABQ} node. @code{tx} directory +it can be integrity checked at any time. @file{5ZIB...UMKW.part} is +partly received file from @file{2WHB...OABQ} node. @file{tx} directory can not contain partly written files -- they are moved atomically from -@code{tmp}. +@file{tmp}. -Only one process can work with @code{rx}/@code{tx} directories at once, +When @ref{nncp-toss} utility is called with @option{-seen} option, it +will create empty @file{XXX.seen} files, telling that some kind of +packet was already tossed sometime. + +Only one process can work with @file{rx}/@file{tx} directories at once, so there are corresponding lock files.