chiark
/
gitweb
/
~ian
/
inn-innduct.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
sort out cli dir stuff
[inn-innduct.git]
/
doc
/
man
/
innduct.8
diff --git
a/doc/man/innduct.8
b/doc/man/innduct.8
index 055d083085466bc77731e9e0a0751a0cae9a355b..71c2afe0a5124948229ebc2537f2dfe6180efa77 100644
(file)
--- a/
doc/man/innduct.8
+++ b/
doc/man/innduct.8
@@
-88,7
+88,8
@@
be logged and a nonzero exit.
.TP
.BR \-\-no-daemon
Do not daemonise. innduct runs in the foreground and all messages
.TP
.BR \-\-no-daemon
Do not daemonise. innduct runs in the foreground and all messages
-(including all debug messages) are written to stderr.
+(including all debug messages) are written to stderr. A control
+command line is also available on stdin/stdout.
.TP
.BI \-\-no-streaming
Do not try to use the streaming extensions to NNTP (for use eg if the
.TP
.BI \-\-no-streaming
Do not try to use the streaming extensions to NNTP (for use eg if the
@@
-106,20
+107,26
@@
Read
instead of the default
.BR inn.conf .
.TP
instead of the default
.BR inn.conf .
.TP
-.BR \-\-cli= \fI
DIR\fR / |\fIPATH\fR
-Bind the control command line socket to
-.IB
DIR / site _cli
+.BR \-\-cli= \fI
CLI-DIR\fR / |\fICLI-PATH\fR| none
+Listen for control command line connections on
+.IB
CLI-DIR / site
(if the value ends with a
.BR /)
or
(if the value ends with a
.BR /)
or
-.I PATH
+.I
CLI-
PATH
(if it doesn't). See CONTROLLING INNDUCT, below.
(if it doesn't). See CONTROLLING INNDUCT, below.
-This option may be essential, if the
-path to
-.I feedfile
+This option may be essential, if
+.I pathrun
+or
+.I site
is too long, as there is a fairly short limit on the paths to AF_UNIX
is too long, as there is a fairly short limit on the paths to AF_UNIX
-sockets. The default is
-.IR feedfile \fB_cli\fR.
+sockets. If specified as
+.IR CLI-DIR \fB/\fR,
+the directory will be created with mode 700 if necessary.
+The default is
+.IB pathrun /innduct/
+which means to create that directory and listen on
+.RB \fIpathrun\fR /innduct/ \fIsite\fR.
.TP
.BI \-\-port= PORT
Connect to port
.TP
.BI \-\-port= PORT
Connect to port
@@
-321,14
+328,14
@@
corrupted; you just won't see some of the article stats.
.LP
innduct listens on an AF_UNIX socket, and provides a command-line
interface which can be used to trigger various events and for
.LP
innduct listens on an AF_UNIX socket, and provides a command-line
interface which can be used to trigger various events and for
-debugging.
The socket is called
-.IB
feedfile _cli
+debugging.
innduct listens on
+.IB
pathrun /innduct/ site
and when connected reads and writes lines (with unix line endings).
and when connected reads and writes lines (with unix line endings).
-
It
can most easily be accessed with a program like
+
The cli
can most easily be accessed with a program like
.I netcat-openbsd
(eg
.I netcat-openbsd
(eg
-.B nc.openbsd -U
-.IR
feedfile \fB_cli\fR
)
+.B nc.openbsd -U
/var/run/news/innduct/
+.IR
site
)
or
.IR socat .
The prompt is
or
.IR socat .
The prompt is
@@
-485,7
+492,7
@@
safely remove backlog files. \fIsomething\fR may not contain \fB#\fR
you rename it to match the pattern \fIfeedfile\fR\fB_backlog\fR*, as
otherwise innduct may find and process the file and read it to EOF
before you have finished creating it.
you rename it to match the pattern \fIfeedfile\fR\fB_backlog\fR*, as
otherwise innduct may find and process the file and read it to EOF
before you have finished creating it.
-.IP \fI
feedfile\fR_cli
+.IP \fI
pathrun\fR\fB/innduct/\fB\fIsite\fR
.IX Item "control command line socket"
Default AF_UNIX listening socket for the control command line. See
CONTROLLING INNDUCT, above.
.IX Item "control command line socket"
Default AF_UNIX listening socket for the control command line. See
CONTROLLING INNDUCT, above.
@@
-495,10
+502,17
@@
On request via a control connection innduct dumps a summary of its
state to this text file. This is mostly useful for debugging.
.IP /etc/news/inn.conf
.IX Item inn.conf
state to this text file. This is mostly useful for debugging.
.IP /etc/news/inn.conf
.IX Item inn.conf
-Used
to find
+Used
for
.IR pathoutgoing
.IR pathoutgoing
-if none is specified, for finding how to communicate with innd,
-and also for
+(to compute default
+.IR feedfile
+and associated paths),
+.IR pathrun
+(to compute default
+.IR CLI-DIR
+and
+.IR CLI-PATH ),
+for finding how to communicate with innd, and also for
.IR sourceaddress
and/or
.IR sourceaddress6 .
.IR sourceaddress
and/or
.IR sourceaddress6 .