rpmgrill-fetch-build man page

rpmgrill-fetch-build — extract all RPMs and build logs from a Koji build

Synopsis

rpmgrill-fetch-build BUILDINFO DESTDIR

rpmgrill-fetch-build --help | --version | --man

Description

rpmgrill-fetch-build extracts all RPMs and build logs from a koji build. This is a helper step required by the rpmgrill analysis tool.

Usage Examples

# By name
$ rpmgrill-fetch-build  coreutils-8.15-10.fc17  my-coreutils-8.15-10.fc17
# Same thing, by Koji task ID
$ rpmgrill-fetch-build  381337 my-coreutils-8.15-10.fc17

Arguments

·
BUILDINFO describes what to extract. It may be an N-V-R or a task ID. FIXME: test with scratch builds.
·
DESTDIR is the path to a directory into which rpmgrill-fetch-build will extract RPMs. It must not exist: if it does, rpmgrill-fetch-build will abort with a fatal error.

Options

--download-only
Download the RPMs and build logs into DESTDIR, then exit cleanly.

RPM filenames will be exactly as downloaded; log files will be named "build.log.ARCH" for all available ARCHes.
--server-url
URL of the Koji XMLRPC endpoint.

(Default: http://koji.fedoraproject.org/kojihub)
--top-url
Download URL for the Koji file access.

(Default: http://kojipkgs.fedoraproject.org/)
--verbose
Show progress messages.
--help
Emit usage hints.
--version
Display program version.
--man
Display this man page.

Diagnostics

FIXME

Environment

If the environment variable $RPMGRILL_FETCH_BUILD_CACHE is defined, and points to an existing directory, and that directory has a subdirectory named N-V-R, rpmgrill-fetch-build fetches RPMs and build logs from there.

The format of this directory is:

\$RPMGRILL_FETCH_BUILD_CACHE/
`-- mypkg-1.0-1.fc19/
    |-- build.log.i686
    |-- build.log.x86_64
    |-- mypkg-1.0-1.fc19.i686.rpm
    `-- mypkg-1.0-1.fc19.x86_64.rpm

That is: all *.rpm files (as fetched from koji), and all build logs using the convention "build.log.ARCH" for all available ARCHes.

Files

rpmgrill-fetch-build writes a README file to DESTDIR. On successful completion of all rpms, it will look like:

  Contents: coreutils-8.15-10.fc17
        on: Fri May  3 12:02:03 2013
        by: rpmgrill-fetch-build 0.0
invoked as: rpmgrill-fetch-build 381337 my-coreutils-8.15-10.fc17

During extraction, or if there's a failure, the README will have the above text and also a note explaining that the directory is incomplete and should not be used.

Author

Ed Santiago <santiago@redhat.com>

Info

2016-08-23 perl v5.24.0 User Contributed Perl Documentation