.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" 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 turned on, 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 "SENDINPATHS 8" .TH SENDINPATHS 8 "2014-05-17" "INN 2.5.4" "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" sendinpaths \- Send Usenet Path: statistics via e\-mail .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBsendinpaths\fR [\fB\-cdhn\fR] [\fB\-k\fR \fIkeep-days\fR] [\fB\-r\fR \fIreport-days\fR] [\fIaddress\fR [\fIaddress\fR ...]] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBsendinpaths\fR checks \fIpathlog\fR/path for \fBninpaths\fR dump files, finds dump files generated in the past \fIreport-days\fR days, makes sure they are valid by running \fBninpaths\fR on each one and making sure the exit status is zero, and passes them to \fBninpaths\fR to generate a cumulative report. By default, that report is mailed to the e\-mail addresses configured at the beginning of this script (by default, only one address is configured: ) in order to supply the \s-1TOP1000\s0 project with useful statistics. See for more information. .PP When finished, \fBsendinpaths\fR deletes all dump files in \fIpathlog\fR/path that are older than \fIkeep-days\fR days. .PP For more information on how to set up \fBninpaths\fR, see \fIninpaths\fR\|(8). .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-c\fR" 4 .IX Item "-c" When this flag is used, the report is also e\-mailed, besides the default submission addresses or those given as command-line arguments, to the newsmaster's address set at configure time. .IP "\fB\-d\fR" 4 .IX Item "-d" Enables debug messages. .IP "\fB\-h\fR" 4 .IX Item "-h" Gives usage information. .IP "\fB\-k\fR \fIkeep-days\fR" 4 .IX Item "-k keep-days" After having processed dump files, \fBsendinpaths\fR removes those that are older than \fIkeep-days\fR days. The default is \f(CW0\fR, that is to say to remove all dump files. .Sp Setting \fIkeep-days\fR to another value can be useful for debugging purpose because it permits to keep a few dump files. .IP "\fB\-n\fR" 4 .IX Item "-n" Don't e\-mail the report; instead, just print it to standard output. Don't delete old dump files. .IP "\fB\-r\fR \fIreport-days\fR" 4 .IX Item "-r report-days" Process dump files generated during the last \fIreport-days\fR days. The default is \f(CW32\fR, that is to say to process all the dump files that have been generated during the last 32 days (if, of course, they have not been deleted yet by a previous run of \fBsendinpaths\fR according to the value set by the \fB\-k\fR flag). .IP "\fIaddress\fR ..." 4 .IX Item "address ..." E\-mail the report to the mentioned address or addresses, instead of the default one. Several addresses can be used, separated by whitespace (sending the e\-mail to your own e\-mail address can be useful for debugging purpose, to check that everything works fine). For instance, for two addresses: .Sp .Vb 1 \& sendinpaths pathsurvey@example.org top1000@anthologeek.net .Ve .SH "HISTORY" .IX Header "HISTORY" \&\fBsendinpaths\fR was written by Olaf Titz . .PP \&\f(CW$Id:\fR sendinpaths.pod 9625 2014\-03\-16 13:24:22Z iulius $ .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIninpaths\fR\|(8).