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
More sensible use of paths for feedfile and chdir
[inn-innduct.git]
/
doc
/
man
/
innduct.8
diff --git
a/doc/man/innduct.8
b/doc/man/innduct.8
index 71c2afe0a5124948229ebc2537f2dfe6180efa77..a294372dd022f3a2e877282789dcd1f435cf3d54 100644
(file)
--- a/
doc/man/innduct.8
+++ b/
doc/man/innduct.8
@@
-71,15
+71,26
@@
feeding by looking in
is the actual NNTP feeder program used by nntpsend.
.SH GENERAL OPTIONS
.TP
is the actual NNTP feeder program used by nntpsend.
.SH GENERAL OPTIONS
.TP
-.BR \-f | \-\-feedfile= \fIfeedfile\fR
-Specifies
-.IR feedfile .
-If the specified value ends in a
+.BR \-f | \-\-feedfile= \fIpath\fR
+Specifies the
+.I feedfile
+to read, and indirectly specifies the paths to
+be used for various ancillary files (see FILES, below).
+If
+.I path
+ends in a
.B /
.B /
-it is taken as a directory to use as if it were
-.I pathoutgoing
-and the actual feed file used is
-.IR specified_feedfile / site .
+it is taken as a directory to use, and the actual feed file used is
+.IR path / site .
+If
+.I path
+does not start with a
+.BR / ,
+it is taken to be relative to
+.IR pathoutgoing
+from inn.conf.
+The default is
+.IR site .
.TP
.BR \-q | \-\-quiet-multiple
Makes innduct silently exit (with status 0) if another innduct holds
.TP
.BR \-q | \-\-quiet-multiple
Makes innduct silently exit (with status 0) if another innduct holds
@@
-107,6
+118,18
@@
Read
instead of the default
.BR inn.conf .
.TP
instead of the default
.BR inn.conf .
.TP
+.BI \-\-port= PORT
+Connect to port
+.I PORT
+at the remote site rather than to the NNTP port (119).
+.TP
+.BI \-\-chdir= pathrun
+Change directory to
+.IR pathrun
+at startup. The default is
+.I pathrun
+from inn.conf.
+.TP
.BR \-\-cli= \fICLI-DIR\fR / |\fICLI-PATH\fR| none
Listen for control command line connections on
.IB CLI-DIR / site
.BR \-\-cli= \fICLI-DIR\fR / |\fICLI-PATH\fR| none
Listen for control command line connections on
.IB CLI-DIR / site
@@
-115,24
+138,17
@@
Listen for control command line connections on
or
.I CLI-PATH
(if it doesn't). See CONTROLLING INNDUCT, below.
or
.I CLI-PATH
(if it doesn't). See CONTROLLING INNDUCT, below.
-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
+Note that there is a fairly short limit on the paths to AF_UNIX
sockets. If specified as
.IR CLI-DIR \fB/\fR,
the directory will be created with mode 700 if necessary.
The default is
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
+.B innduct/
+which means to create that directory in
+.I pathrun
+and listen on
.RB \fIpathrun\fR /innduct/ \fIsite\fR.
.TP
.RB \fIpathrun\fR /innduct/ \fIsite\fR.
.TP
-.BI \-\-port= PORT
-Connect to port
-.I PORT
-at the remote site rather than to the NNTP port (119).
-.TP
.BI \-\-help
Just print a brief usage message and list of the options to stdout.
.SH TUNING OPTIONS
.BI \-\-help
Just print a brief usage message and list of the options to stdout.
.SH TUNING OPTIONS
@@
-328,8
+344,8
@@
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. innduct listens on
-.I
B pathrun /innduct/ site
+debugging. innduct listens
(by default
on
+.I
R pathrun \fB/innduct/\fR site )
and when connected reads and writes lines (with unix line endings).
The cli can most easily be accessed with a program like
.I netcat-openbsd
and when connected reads and writes lines (with unix line endings).
The cli can most easily be accessed with a program like
.I netcat-openbsd
@@
-431,6
+447,10
@@
two ascii-art diagrams in innduct.c for details of the protocol.) Do
not mess with the feedfile and other associated files, other than as
explained here:
.IX Header "FILES"
not mess with the feedfile and other associated files, other than as
explained here:
.IX Header "FILES"
+.IP \fIpathrun\fR
+.IX Item "default directory"
+Default current working directory for innduct, and also default
+parent directory for the command line socket.
.IP \fIpathoutgoing\fR/\fIsite\fR
.IX Item "default feedfile"
Default
.IP \fIpathoutgoing\fR/\fIsite\fR
.IX Item "default feedfile"
Default