turqstat(1) Statistics tool for Fidonet and Usenet

SYNOPSIS

turqstat [options] outputfile areadef(s)

DESCRIPTION

Turquoise SuperStat reads the contents of a Fidonet message area in one of its supported formats, or a standard Usenet news spool, and creates statistics about this:

Quoter blacklist.

Toplist of senders.

Toplist of original content per message.

Toplist of Fidonet nets (Fidonet only).

Toplist of Internet topdomains.

Toplist of receivers (Fidonet only).

Toplist of subjects.

Toplist of used software.

Postings by weekday.

Postings by time of day.

OPTIONS

DATA SELECTION

-d days
Selects the number of days back to count messages from. The default is 0, which mean count all messages.
-n num
Selects the maximum number of entries in the toplists. The default is 15. 0 indicates no limit.
-r range
Selects a range of dates and times for which statistics will be gathered. The range is given on the form [yyyymmdd[Thhmmss]]-[yyyymmdd[Thhmmss]]. Examples: 20000101T000000-20001231T235959 is all of 2000, -20010101 is everything before (not including) January 1st, 2001, and 20010101- is everything from (and including) January 1st, 2001.

OUTPUT FORMAT

-F file
Selects the template file to use. The default is default.tpl

INPUT SELECTION

-a path/server
Selects the message base path for the FDAPX/w, MyPoint and taanstafl message bases, which have all message bases in the same files. Sects NNTP server for non-local Usenet news (-U).
-s
Squish message bases (default).
-m
FTSC *.MSG message bases.
-o
OPUS *.MSG message bases.
-j
JAM message bases.
-f
FDAPX/w message bases.
-t
Tanstaafl message bases.
-p
MyPoint message bases.
-u
Usenet news spool (local netnews).
-U
Usenet news (NNTP) server (remote netnews).

TOPLIST SELECTION

These options are used to turn toplists off. By default, all toplists are enabled (except for Internet top domains, see below).
-Q
Turns the quoter blacklist off.
-W
Turns the writer toplist off.
-O
Turns the original content per message toplist off.
-N
Turns the top nets (Fidonet only) list off.
-R
Turns the recipient (Fidonet only) toplist off.
-T
Turns the top Internet topdomain list on/off. For Usenet, the default is on, and this switch turns it off. For Fidonet, the default is off, and this switch turns it on, but only if there are any RFC gated messages detected.
-S
Turns the subject toplist off.
-P
Turns the program toplist off.
-H
Turns the hourly posting statistics off.
-D
Turns the daily posting statistics off.
-V
Turns the display of versions in the program toplist off.

OUTPUT OPTIONS

-A
Display all numbers in toplists (default is off).
-C charset
Selects character encoding to use for the created report files. The character encoding name can be specified by either its Fidonet or MIME name. Default for the Win32 and OS/2 versions is IBMPC (codepage 437), and for all other versions LATIN-1 (iso-8859-1).
-L
Use locale defined date format in output (default is ISO-8601 format, as per Swedish and EU standards).

BUGS

Report any bugs to the authors.

AUTHOR

Turquoise SuperStat was written by Peter Karlsson. If you have bug reports or questions, mail them to [email protected] or see the website at http://www.softwolves.pp.se/sw/

A Softwolves Software (tm) Release in 2008.

This program is released under the GNU General Public License, version 2.