X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcall.texi;h=06566abc4a87c7a5c77e321e5a2c912bb84551ed;hb=HEAD;hp=fe55de5456d2b9f82c4aa83b428f6c13155d4c0b;hpb=16ac75d51758c249f5fc4e8fac9cf71b84331c55;p=nncp.git diff --git a/doc/call.texi b/doc/call.texi index fe55de5..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,17 +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 @@ -50,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 @@ -78,22 +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 @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 +connection attempts. @end table