.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "FILECHAN 8" .TH FILECHAN 8 "2022-10-20" "INN 2.6.5" "InterNetNews Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" filechan \- File\-writing backend for INN .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBfilechan\fR [\fB\-d\fR \fIdirectory\fR] [\fB\-f\fR \fInum-fields\fR] [\fB\-m\fR \fImap-file\fR] [\fB\-p\fR \fIpid-file\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBfilechan\fR reads lines from standard input and copies the initial fields in each line to the files named by the remaining fields on the line. \fBfilechan\fR is intended to be called by \fBinnd\fR as a channel feed. (It is not a full exploder and does not accept commands; see \fBnewsfeeds\fR\|(5) for a description of the difference, and \fBbuffchan\fR\|(8) for an exploder program.) .PP The input is interpreted as a sequence of lines. Each line contains a fixed number of initial fields, followed by a variable number of filename fields. All fields in a line are separated by whitespace and do not contain any whitespace. The default number of initial fields is one. .PP For each line of input, \fBfilechan\fR writes the initial fields, separated by a space and followed by a newline, to each of the files named in the filename fields. When writing to a file, \fBfilechan\fR opens it in append mode and tries to lock it and change the ownership to the user and group owning the directory where the file is being written. .PP Because the time window in which a file is open is very small, complicated flushing and locking protocols have not been implemented and are not necessarily needed for the way \fBfilechan\fR is called and works; \fBmv\fR\|(1) followed by \fBsleep\fR\|(1) for a couple of seconds is sufficient. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-d\fR \fIdirectory\fR" 4 .IX Item "-d directory" By default, \fBfilechan\fR writes its output into the \fIpathoutgoing\fR directory. This flag may be used to specify a directory the program should change to before starting. .IP "\fB\-f\fR \fInum-fields\fR" 4 .IX Item "-f num-fields" This flag specifies a different number of initial fields. .IP "\fB\-m\fR \fImap-file\fR" 4 .IX Item "-m map-file" A map file may be specified by using this flag. Blank lines and lines starting with a number sign (\f(CW\*(C`#\*(C'\fR) are ignored. All other lines should have two host names separated by a colon. The first field is the name that may appear in the input stream; the second field names the file to be used when the name in the first field appears. .Sp For example, the following map file may be used to map the short names used in the example below to the full domain names: .Sp .Vb 4 \& # This is a comment. \& uunet:news.uu.net \& foo:foo.com \& munnari:munnari.oz.au .Ve .IP "\fB\-p\fR \fIpid-file\fR" 4 .IX Item "-p pid-file" If this flag is used, \fBfilechan\fR will write a line containing its process \s-1ID\s0 (in text) to the specified file. .SH "EXAMPLES" .IX Header "EXAMPLES" If \fBfilechan\fR is invoked with \f(CW\*(C`\-f 2\*(C'\fR and given the following input: .PP .Vb 3 \& news.software.nntp <1643@munnari.oz.au> foo uunet \& news.software.nntp <102060@litchi.foo.com> uunet munnari \& comp.sources.unix <999@news.foo.com> foo uunet munnari .Ve .PP then the file \fIfoo\fR in \fIpathoutgoing\fR will have these lines: .PP .Vb 2 \& news.software.nntp <1643@munnari.oz.au> \& comp.sources.unix <999@news.foo.com> .Ve .PP the file \fImunnari\fR in \fIpathoutgoing\fR will have these lines: .PP .Vb 2 \& news.software.nntp <102060@litchi.foo.com> \& comp.sources.unix <999@news.foo.com> .Ve .PP and the file \fIuunet\fR in \fIpathoutgoing\fR will have these lines: .PP .Vb 3 \& news.software.nntp <1643@munnari.oz.au> \& news.software.nntp <102060@litchi.foo.com> \& comp.sources.unix <999@news.foo.com> .Ve .PP Using \fBfilechan\fR this way can be done in \fInewsfeeds\fR with for instance: .PP .Vb 4 \& foo:*,@misc.*:Ap,Tm:filechan! \& munnari:*,@rec.*:Ap,Tm:filechan! \& uunet:*:Ap,Tm:filechan! \& filechan!:*:Tc,WGm*:/filechan \-f 2 .Ve .PP It will generate the examples above. See the \f(CW\*(C`W\*(C'\fR flag in \fBnewsfeeds\fR\|(5) for how to parameter the output. .SH "HISTORY" .IX Header "HISTORY" Written by Robert Elz , flags added by Rich \f(CW$alz\fR . Rewritten into \s-1POD\s0 by Julien Elie. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBbuffchan\fR\|(8), \fBnewsfeeds\fR\|(5).