Johan Vromans > Convert-BulkDecoder-1.03 > mfetch

Download:
Convert-BulkDecoder-1.03.tar.gz

Annotate this POD

View/Report Bugs
Source  

NAME ^

mfetch - fetch and decode (multi-part) articles from a NNTP server

SYNOPSIS ^

  mfetch newszilla.news.com:alt.binaries.sounds.mp3.camel 35351 35353 35355 35350 35356

  NNTPHOST=newszilla.news.com; export NNTPHOST
  mfetch alt.binaries.sounds.mp3.camel 35351:35353:35355 35350:35356

  mfetch --destdir my_mp3_dir alt.binaries.sounds.mp3.camel 35351:35353:35355 35350:35356

DESCRIPTION ^

mfetch retrieves news articles from an NNTP server, and decodes them to extract the (possible binary) contents. It is particular useful for news postings that contain programs or binary data like sounds and images.

COMMAND LINE ARGUMENTS ^

mfetch takes two arguments: the name of the news group, and a list of article numbers. The name of the news group may be prefixed with the name of an NNTP server, separated by a colon. If the NNTP server is left unspecified, mfetch uses standard environment variables to find the NNTP server name, see below.

The list of article numbers may be passed as distinct arguments, or combined in colon separated lists, or any combination thereof.

mfetch uses Convert::BulkDecoder to decode the contents, and hence supports UUdecoding, ydecoding and MIME attachments.

For yencoded contents, file consistency is verified using length and checksum tests.

COMMAND LINE OPTIONS ^

--destdir dir

The name of the directory where the resultant contents must be placed. Default is to put the contents in the current directory.

--fetch

Just fetch the articles, and store them under the article numbers. No decoding is done.

--delay secs

Pause for secs seconds between article fetches to reduce the load of the network and server.

--dry-run -n

Don't do anything but checking the arguments.

--comment text

Remarks for this action.

LIMITATIONS ^

Only yencoded data can be CRC checked. CRC checking is slow, so only the partial checksums are verified.

For multi-part submissions, the article numbers must be passed in the right order.

DEPENDENCIES ^

Net::NNTP, Convert::BulkDecoder.

ENVIRONMENT VARIABLES ^

To find the news server, mfetch uses environment variables NNTPSERVER, NEWSHOST, or defaults to a host named news.

AUTHOR ^

Johan Vromans, Squirrel Consultancy <jvromans@squirrel.nl>

SEE ALSO ^

Convert::BulkDecoder, newsgrab.

COPYRIGHT AND LICENCE ^

Copyright 2003 Squirrel Consultancy.

License: Artistic.

syntax highlighting: