doc/cmd/nncp-call.texi

   1 @node nncp-call
   2 @pindex nncp-call
   3 @section nncp-call
   4
   5 @example
   6 $ nncp-call [options]
   7     [-onlinedeadline INT]
   8     [-maxonlinetime INT]
   9     [-rx|-tx]
  10     [-list]
  11     [-pkts PKT,PKT,@dots{}]
  12     [-rxrate INT]
  13     [-txrate INT]
  14     [-autotoss*]
  15     [-nock]
  16     [-ucspi]
  17     [-mcd-wait INT]
  18     NODE[:ADDR] [FORCEADDR]
  19 @end example
  20
  21 Call (connect to) specified @option{NODE} and run @ref{Sync,
  22 synchronization} protocol with the @ref{nncp-daemon, daemon} on the
  23 remote side. Normally this command could be run any time you wish to
  24 either check for incoming packets, or to send out queued ones.
  25 Synchronization protocol allows resuming and bidirectional packets
  26 transfer.
  27
  28 If @option{-rx} option is specified then only inbound packets
  29 transmission is performed. If @option{-tx} option is specified, then
  30 only outbound transmission is performed.
  31
  32 @option{-onlinedeadline} overrides @ref{CfgOnlineDeadline, @emph{onlinedeadline}}.
  33 @option{-maxonlinetime} overrides @ref{CfgMaxOnlineTime, @emph{maxonlinetime}}.
  34 @option{-rxrate}/@option{-txrate} override @ref{CfgXxRate, rxrate/txrate}.
  35
  36 @option{-list} option allows you to list packets of remote node, without
  37 any transmission. You can specify what packets your want to download, by
  38 specifying @option{-pkts} option with comma-separated list of packets
  39 identifiers.
  40
  41 Each @option{NODE} can contain several uniquely identified
  42 @option{ADDR}esses in @ref{CfgAddrs, configuration} file. If you do
  43 not specify the exact one, then all will be tried until the first
  44 success. Optionally you can force @option{FORCEADDR} address usage,
  45 instead of addresses taken from configuration file. You can specify
  46 @verb{|host:port|}, @verb{#|some command#} and
  47 @verb{|yggdrasil:PUB;PRV;PEER[,...]|} formats.
  48
  49 If you specify @option{-ucspi} option, then it is assumed that you run
  50 @command{nncp-call} command under some UCSPI-TCP compatible utility,
  51 that provides read/write channels through 6/7 file descriptors.
  52
  53 @option{-mcd-wait} options tells to wait up to specified number of
  54 seconds for the @ref{MCD} packet from the specified @code{NODE}. When
  55 the packet is received, initiate a call.
  56
  57 @option{-autotoss} option runs tosser on node's spool every second
  58 during the call. All @option{-autotoss-*} options is the same as in
  59 @ref{nncp-toss} command.
  60
  61 Partly downloaded packets are stored in @file{.part} files. By default
  62 all downloaded files are sequentially checksummed in the background,
  63 stripping @file{.part} extension if is successful. If @option{-nock}
  64 option is set, then no checksumming is done, renaming fully downloaded
  65 files to @file{.nock} extension. Pay attention that checksumming can be
  66 time consuming and connection could be lost during that check, so remote
  67 node won't be notified that the file is finished. If you run
  68 @ref{nncp-check, @command{nncp-check -nock}}, that will checksum files
  69 and strip the @file{.nock} extension, then repeated call to remote node
  70 will notify about packet's completion. Also it will be notified if
  71 @ref{nncp-toss, tossing} created @file{seen/} file.
  72 Read @ref{CfgNoCK, more} about @option{-nock} option.