.\" -*- nroff -*-
.TH FETCHNEWS 8 "Project Cyrus" CMU
.\"
.\" Copyright (c) 1994-2008 Carnegie Mellon University.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\"
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\"
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in
.\"    the documentation and/or other materials provided with the
.\"    distribution.
.\"
.\" 3. The name "Carnegie Mellon University" must not be used to
.\"    endorse or promote products derived from this software without
.\"    prior written permission. For permission or any legal
.\"    details, please contact
.\"      Carnegie Mellon University
.\"      Center for Technology Transfer and Enterprise Creation
.\"      4615 Forbes Avenue
.\"      Suite 302
.\"      Pittsburgh, PA  15213
.\"      (412) 268-7393, fax: (412) 268-7395
.\"      innovation@andrew.cmu.edu
.\"
.\" 4. Redistributions of any form whatsoever must retain the following
.\"    acknowledgment:
.\"    "This product includes software developed by Computing Services
.\"     at Carnegie Mellon University (http://www.cmu.edu/computing/)."
.\"
.\" CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
.\" THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
.\" AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
.\" FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
.\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.SH NAME
fetchnews \- retrieve new articles from peer and feed to Cyrus
.SH SYNOPSIS
.B fetchnews
[
.B \-C
.I config-file
]
[
.B \-s
.I servername[:port]
]
.br
          [
.B \-n
]
[
.B \-y
]
[
.B \-w
.I wildmat
]
[
.B \-f
.I tstampfile
]
.br
          [
.B \-a
.I authname
[
.B \-p
.I password
]
]
.I peername
.SH DESCRIPTION
.I Fetchnews
retrieves news articles from a peer news server and feeds them to a
Cyrus server.
.I Fetchnews
connects to the peer specified by
.IR peername ,
requests new articles since the time stored in
.I tstampfile
and feeds them to
.IR servername .
.PP
.I Fetchnews
reads its configuration options out of the
.IR imapd.conf (5)
file unless specified otherwise by \fB-C\fR.
.SH OPTIONS
.TP
.BI \-C " config-file"
Read configuration options from \fIconfig-file\fR.
.TP
.BI \-s " servername"
Hostname of the Cyrus server (with optional port) to which articles
should be fed.  Defaults to "localhost:nntp".
.TP
.B \-n
Don't use the NEWNEWS command.
.I Fetchnews
will keep track of the high and low water marks for each group and use
them to fetch new articles.
.TP
.B \-y
Use 4 instead of 2 digits for year. 2-digits are rfc977- but not y2k-compliant.
.TP
.BI \-w " wildmat"
Wildmat pattern specifying which newsgroups to search for new
articles.  Defaults to "*".
.TP
.BI \-f " tstampfile"
File in which to read/write the timestamp of when articles were last
retrieved.  Defaults to "newsstamp" located in
.I configdir
as specified by the configuration options.
.TP
.BI \-a " authname"
Userid to use for authentication.
.TP
.BI \-p " password"
Password to use for authentication.
.SH FILES
.TP
.B /etc/imapd.conf