NAME
    rhupdate.pl - Check for updates to RedHat RPMs

SYNOPSIS
    rhupdate.pl [ pattern ] [ --download [dir] | --list ] [ --options ]

DESCRIPTION
    Checks for updates for installed RPMS on RedHat's updates site.

    Requires `Net::FTP' and `Pod::Usage' perl modules to be installed.  On
    some versions of RedHat you will need to update File::Spec before
    Pod::Usage will install.  (Even using CPAN.)

    NOTE: since version strings aren't simple numerics, I can only tell you
    when the version on the server is different from what you have
    installed.

    Install updates at your own risk.

    See
    http://www.redhat.com/support/docs/howto/kernel-upgrade/kernel-upgrade.h
    tml for information on installing the kernel-* packages.  Failure to
    install the Linux Kernel properly will result in a non-bootable machine.
    Use --exclude kernel to skip notification and download of Kernel
    packages.

INSTALL
    (see INSTALL file)

    http://www.jjminer.org/rhupdate/INSTALL

OPTIONS
    pattern
        A pattern that the updates should match. (Shortcut for "--include
        pattern".)

    --all
        List or Download all updates that are available on the server, not
        just those that are installed on the local machine (and different
        from the local version.) Different from just mirroring the updates
        directory because it downloads only the correct architecture.

    --arch arch
        Default architecture (default: i386).

    --dir directory
        Root directory of THIS VERSION'S updates.

    --download [dir]
        Download updated RPMs to the named directory or the current
        directory.

    --exclude pattern
        Pattern for packages to exclude.  NOTE Exclude takes precedence over
        include.

    --hash
        Print hash marks as the file is downloaded.

    --include pattern
        Pattern for packages to include.  NOTE Exclude takes precedence over
        include.

    --list
        List the available updates.

    --passive
        Get updates in passive mode.

    --passwd passwd
        Password to log in with (default: $USER@$HOST).

    --retry [num]
        Retry connecting to the FTP server num times (or infinitely if num
        is not specified) if it fails.

    --server server
        Server to check for updates on.

    --user user
        Username to log in as (default: anonymous).

DOWNLOAD
    http://www.jjminer.org/rhupdate

CHANGELOG
    (See ChangeLog file)

    http://www.jjminer.org/rhupdate/ChangeLog

TODO
    multiple servers
        Allow multiple servers to be queried (but, the question is, should
        they be queried only if the previous server was unavailable, if
        there were no updates at the previous server, or always?)

    config file
        Create/use a config file (~/.rhupdate or something?)  To record the
        defaults for a specific site.

    all installed updates
        Add an option to download/list all files that are installed
        (different or not.)

    multiple patterns
        Allow for multiple patterns (include and exclude) to be entered.

    version checks
        Is there a way to check to see if the version on the server is
        greater-than the version installed?

    powertools
        Add the ability to update the "powertools" (usually
        "$updatedir/powertools/version/arch")

    error messages
        Print a different error message when there are no updates versus
        nothing found in the updates directory.

AUTHOR
    Jonathan J. Miner <jon@jjminer.org>

LICENSE
    Copyright (C) 2001 Jonathan J. Miner

    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by the
    Free Software Foundation; either version 2 of the License, or (at your
    option) any later version.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    General Public License for more details.

VERSION
    1.5 beta $Revision: 1.52 $

