]> Cypherpunks.ru repositories - nncp.git/blob - doc/cmd/nncp-daemon.texi
73b44b034ce55da3b5d67973ba07f0b90eb0442c
[nncp.git] / doc / cmd / nncp-daemon.texi
1 @node nncp-daemon
2 @section nncp-daemon
3
4 @example
5 $ nncp-daemon [options]
6     [-maxconn INT] [-bind ADDR] [-ucspi]
7     [-autotoss*] [-nock] [-mcd-once]
8     [-yggdrasil PRV;BIND[,...];[PUB,...];[PEER,...]]
9 @end example
10
11 Start listening TCP daemon, wait for incoming connections and run
12 @ref{Sync, synchronization protocol} with each of them. You can run
13 @ref{nncp-toss} utility in background to process inbound packets from
14 time to time.
15
16 @option{-maxconn} option specifies how many simultaneous clients daemon
17 can handle. @option{-bind} option specifies @option{addr:port} it must
18 bind to and listen.
19
20 It could be run as @url{http://cr.yp.to/ucspi-tcp.html, UCSPI-TCP}
21 service, by specifying @option{-ucspi} option. Pay attention that
22 because it uses @code{stdin}/@code{stdout}, it can not effectively work
23 with IO timeouts and connection closing can propagate up to 5 minutes in
24 practice. Example startup command:
25
26 @verbatim
27 tcpserver -DHR -l 0 ::0 uucp nncp-daemon -quiet -ucspi
28 @end verbatim
29
30 Also it is some kind of backward compatible with @command{inetd}
31 interface, just lacking knowledge or remote's address:
32
33 @verbatim
34 uucp    stream  tcp6    nowait  nncpuser        /usr/local/bin/nncp-daemon      nncp-daemon -quiet -ucspi
35 @end verbatim
36
37 @option{-autotoss} option runs tosser on node's spool every second
38 during the call. All @option{-autotoss-*} options is the same as in
39 @ref{nncp-toss} command.
40
41 Read @ref{CfgNoCK, more} about @option{-nock} option.
42
43 @option{-mcd-once} option sends @ref{MCD} announcements once and quits.
44 Could be useful with inetd-based setup, where daemons are not running.
45
46 With @option{-yggdrasil} option daemon acts as a @ref{Yggdrasil}
47 listener daemon.