NAME

crossbow-fetch — Request, parse and process all registered feeds

SYNOPSIS

DESCRIPTION

The crossbow-fetch command is part of crossbow(1), the cron(8)-friendly RSS aggregator. It is responsible for retrieving, parsing, and processing all new items of the tracked feeds. In order to be tracked, a feed must be registered via crossbow-set(1).

If crossbow-fetch is invoked without options all registered feeds are updated. By supplying an identifier via the -i flag, only the corresponding feed is updated.

A feed is updated by the following sequence of actions:

• The URL is fetched, and the obtained XML is parsed into a set of feed items.
• The obtained set is compared with the one retrieved on the previous execution. Items appearing in the former but not in the latter are marked as "fresh".
• Unless dry-run mode is enabled (-d), the updated set is stored in place of the previous, so it can be used for the same comparison on the next execution.
• The "fresh" items are processed according to the set-up defined via crossbow-set(1).

OPTIONS

-d

When this flag is in use, crossbow-fetch will not store updates in the save-file. This is useful when testing connectivity or the configuration of the feed. It is worth noting that, even though -d stands for dry-run, the subproc and pipe output modes will still result in the execution of the supplied sub-command. See crossbow-set(1)

-h

Prints the synopsis and exits.

-i identifier

Only fetch the feed identified by identified.

-v

Increase verbosity

EXAMPLES

Place this string in your crontab in oroder to check for updates from all feeds every two hours.

0 0-23/2 * * * crossbow-fetch

If the local mail is configured properly, the output produced by the invocation should be delivered in the user's mailbox.

SEE ALSO

crossbow(1), crossbow-del(1), crossbow-query(1), crossbow-set(1), crossbow-outfmt(5)