4 htsn \- Parse XML files from The Sports Network feed.
8 \fBhtsn\fR [OPTIONS] [HOSTNAMES]
13 The Sports Network <http://www.sportsnetwork.com> offers an XML feed
14 containing various sports news and statistics. The goal of \fBhtsn\fR
15 is to watch the XML feed and parse the individual XML documents into
21 The program takes no input; a username and password must be supplied
22 on the command-line or in a configuration file.
27 Standard out and standard error are fairly noisy. All traffic between
28 htsn and the feed server is displayed on stdout. Status messages are
29 interspersed when they are generated.
31 The only data we send to the feed are the username and password. These
32 will be highlighted in green on stdout.
34 All data received from the feed will be echoed in the default color to
37 Informational messages will be highlighted in cyan and sent to stdout.
39 Warnings will be highlighted in yellow and sent to stderr.
41 Errors will be highlighted in red and sent to stderr.
45 Logging is done either to syslog or a file. The destination and
46 verbosity are controlled by the \fIlog_file\fR, \fIlog_level\fR, and
47 \fIsyslog\fR parameters which may be specified either on the
48 command line or in the configuration file.
52 .IP \fB\-\-log-file\fR
53 If you specify a file here, logs will be written to it (possibly in
54 addition to syslog). Can be either a relative or absolute path. It
55 will not be auto-rotated; use something log logrotate for that.
59 .IP \fB\-\-log-level\fR
60 How verbose should the logs be? We log notifications at three levels:
61 INFO, WARN, and ERROR. Specify the \(dqmost boring\(dq level of
62 notifications you would like to receive (in all-caps); more
63 interesting notifications will be logged as well.
67 .IP \fB\-\-password\fR,\ \fB\-p\fR
68 The password associated with your TSN username. A password is
69 required, so you must supply one either on the command line or in a
74 .IP \fB\-\-output_directory\fR,\ \fB\-o\fR
75 To which directory should we write the XML files?
79 .IP \fB\-\-syslog\fR,\ \fB\-s\fR
80 Enable logging to syslog. On Windows this will attempt to communicate
81 (over UDP) with a syslog daemon on localhost, which will most likely
84 .IP \fB\-\-username\fR,\ \fB\-u\fR
85 Your TSN username. A username is required, so you must supply one
86 either on the command line or in a configuration file.
92 It is possible to pass a list of feed hostnames on the command-line
93 (see [HOSTNAMES] in the synopsis). By default \fBhtsn\fR will attempt
94 to connect to every known TSN XML feed host in a round-robin fashion,
95 so there is rarely a need to do this.
100 Send bugs to michael@orlitzky.com.