X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ian/git?a=blobdiff_plain;f=doc%2Fman%2Ffilechan.8;fp=doc%2Fman%2Ffilechan.8;h=0000000000000000000000000000000000000000;hb=b7a32e2d73e3ab1add8208d3e157f7269a31ef4d;hp=0d7a38763d4e6bb4d269bdd849d7dfd4e7e86d45;hpb=ac902a8299ff4469b356836f431ead31c3377377;p=inn-innduct.git diff --git a/doc/man/filechan.8 b/doc/man/filechan.8 deleted file mode 100644 index 0d7a387..0000000 --- a/doc/man/filechan.8 +++ /dev/null @@ -1,149 +0,0 @@ -.\" $Revision: 5909 $ -.TH FILECHAN 8 -.SH NAME -filechan \- file-writing backend for InterNetNews -.SH SYNOPSIS -.B filechan -[ -.BI \-d " directory" -] -[ -.BI \-f " num_fields" -] -[ -.BI \-m " mapfile" -] -[ -.BI \-p " pidfile" -] -.SH DESCRIPTION -.I Filechan -reads lines from standard input and copies certain fields in -each line into files named by other fields within the line. -.I Filechan -is intended to be called by -.IR innd (8) -as a channel feed. -(It is not a full exploder and does not accept commands; see -.IR newsfeeds (5) -for a description of the difference, and -.IR buffchan (8) -for an exploder program.) -.PP -.I Filechan -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. -The default number of initial fields is one. -.PP -For each line of input, -.I filechan -writes the initial fields, separated by whitespace and followed by a -newline, to each of the files named in the filename fields. -When writing to a file, -.I filechan -opens it in append mode and tries to lock it and change the -ownership to the user and group who owns 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 are not needed; a -.IR mv (1) -followed by a -.IR sleep (1) -for a couple of seconds is sufficient. -.SH OPTIONS -.TP -.B \-f num_fields -The ``\fB\-f\fP'' flag may be -used to specify a different number of initial fields. -.TP -.B \-d directory -By default, -.I filechan -writes its output into the directory -.IR . -The ``\fB\-d\fP'' flag may be used to specify a directory the program should -change to before starting. -.TP -.B \-p pidfile -If the ``\fB\-p\fP'' flag is used, the program will write a line containing -its process ID (in text) to the specified file. -.TP -.B \-m mapfile -A map file may be specified by using the ``\fB\-m\fP'' flag. -Blank lines and lines starting with a number sign (``#'') 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. -For example, the following map file may be used to map the short -names used in the example below to the full domain names: -.PP -.RS -.nf -# This is a comment -uunet:news.uu.net -foo:foo.com -munnari:munnari.oz.au -.fi -.RE -.SH EXAMPLES -If -.I filechan -is invoked with ``\fB\-f 2\fP'' and given the following input: -.PP -.RS -.nf -news/software/b/132 <1643@munnari.oz.au> foo uunet -news/software/b/133 <102060@litchi.foo.com> uunet munnari -comp/sources/unix/2002 <999@news.foo.com> foo uunet munnari -.fi -.RE -.PP -Then the file -.I foo -will have these lines: -.PP -.RS -.nf -news/software/b/132 <1643@munnari.oz.au> -comp/sources/unix/2002 <999@news.foo.com> -.fi -.RE -.sp -the file -.I munnari -will have these lines: -.PP -.RS -.nf -news/software/b/133 <102060@litchi.foo.com> -comp/sources/unix/2002 <999@news.foo.com> -.fi -.RE -.sp -and the file -.I uunet -will have these lines: -.PP -.RS -.nf -news/software/b/132 <1643@munnari.oz.au> -news/software/b/133 <102060@litchi.foo.com> -comp/sources/unix/2002 <999@news.foo.com> -.fi -.RE -.SH HISTORY -Written by Robert Elz , flags added by Rich $alz -. -.de R$ -This is revision \\$3, dated \\$4. -.. -.R$ $Id: filechan.8 5909 2002-12-03 05:17:18Z vinocur $ -.SH "SEE ALSO" -buffchan(8), -inn.conf(5), -innd(8), -newsfeeds(5).