X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcall.texi;h=bb29b58bc8aa7acf9f9bb82a37f475ff39f9ccdd;hb=2e22bda93fdf8f2f84e4d19b3f1d46318b497139;hp=52572baa11558f2a9a62a94a3d496a14510b5572;hpb=6395395ff9539da173b1ef634623d4fcc5a786c2;p=nncp.git diff --git a/doc/call.texi b/doc/call.texi index 52572ba..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 by @ref{nncp-caller}. +Call is a rule when and how node can be called by @command{@ref{nncp-caller}}. Example list of call structures: @@ -14,6 +16,7 @@ calls: [ autotoss: true autotoss-doseen: true + autotoss-gen-ack: true } { cron: "30 * * * SAT,SUN" @@ -51,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 @@ -79,11 +88,14 @@ 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. The check of outbound packets existence is performed @strong{every} time we are going to make a call, @@ -91,16 +103,19 @@ 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 @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. - +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