X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcall.texi;h=bb29b58bc8aa7acf9f9bb82a37f475ff39f9ccdd;hb=2e22bda93fdf8f2f84e4d19b3f1d46318b497139;hp=81ee9bafd465a0b5d15044c3406fc035b5d431f6;hpb=ae2b0d687a4ed40fe0161b79b4a9ec42290ffb6b;p=nncp.git diff --git a/doc/call.texi b/doc/call.texi index 81ee9ba..bb29b58 100644 --- a/doc/call.texi +++ b/doc/call.texi @@ -1,7 +1,9 @@ @node Call +@cindex call +@vindex calls @unnumbered Call configuration -Call is a rule when and how node can be called. +Call is a rule when and how node can be called by @command{@ref{nncp-caller}}. Example list of call structures: @@ -14,7 +16,8 @@ calls: [ autotoss: true autotoss-doseen: true - }, + autotoss-gen-ack: true + } { cron: "30 * * * SAT,SUN" onlinedeadline: 1800 @@ -22,16 +25,18 @@ calls: [ nice: NORMAL rxrate: 10 txrate: 20 - }, + } { cron: "0 * * * SAT,SUN" xx: rx addr: lan - }, + } { cron: "*/5 * * * * * *" when-tx-exists: true - }, + nock: true + mcd-ignore: true + } ] @end verbatim @@ -49,17 +54,23 @@ It contains the following fields (only @emph{cron} is required): @table @emph +@vindex cron @item cron @include cronexpr.texi +@vindex nice @item nice Optional. Use that @ref{Niceness, niceness} during the call (255 is used otherwise). +@vindex xx +@vindex rx +@vindex tx @item xx Optional. Either @verb{|rx|} or @verb{|tx|}. Tells only to either to receive or to transmit data during that call. +@vindex addr @item addr Optional. Call only that address, instead of trying all from @ref{CfgAddrs, @emph{addrs}} configuration option. It can be either key @@ -77,12 +88,37 @@ configuration option when calling. Optional. Override @ref{CfgMaxOnlineTime, @emph{maxonlinetime}} configuration option when calling. -@item autotoss, -doseen, -nofile, -nofreq, -noexec, -notrns +@vindex autotoss +@item autotoss, -doseen, -nofile, -nofreq, -noexec, -notrns, -noack, -gen-ack Optionally enable auto tossing: run tosser on node's spool every second -during the call. You can control either are @file{.seen} files must be -created, or skip any kind of packet processing. +during the call. You can control either are @file{seen/} files must be +created, or skip any kind of packet processing, or enable @ref{ACK} +packets generation. +@vindex when-tx-exists @item when-tx-exists -Call only if packets for sending exists. +Call only if packets for sending exists. The check of outbound packets +existence is performed @strong{every} time we are going to make a call, +but @emph{when-tx-exists} does not influence @emph{cron}. When +@emph{cron} configuration decides that it is time to make a call, with +@emph{when-tx-exists} option it checks packets existence first. + +@vindex nock +@anchor{CfgNoCK} +@item nock +NoCK (no-checksumming) tells not to do checksumming of received files, +assuming that it will be done for example with +@command{@ref{nncp-check}} command later. That can help minimizing time +spent online, because HDD won't do simultaneous reading of the data for +checksumming and writing of the received one, but just sequential +writing of the file. Pay attention that you have to make a call to +remote node after checksumming is done, to send notification about +successful packet reception. + +@vindex mcd-ignore +@anchor{CfgMCDIgnore} +@item mcd-ignore +Ignore @ref{MCD} announcements: do not add MCD addresses for possible +connection attempts. @end table