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