NAME

    LCFG::Build::Utils::RPM - LCFG software building utilities

VERSION

    This documentation refers to LCFG::Build::Utils::RPM version 0.0.45

SYNOPSIS

    my $dir = q{.};

    my $spec = LCFG::Build::PkgSpec->new_from_metafile("$dir/lcfg.yml");

    my $resultsdir = '/tmp/foo';
    LCFG::Build::Utils::RPM->generate_metadata( $spec, $dir, $resultsdir )

DESCRIPTION

This module provides a suite of utilities to help in building RPM packages from LCFG projects, particularly LCFG components. The methods are mostly used by tools which implement the LCFG::Build::Tool base class (e.g. LCFG::Build::Tool::RPM) but typically they are designed to be generic enough to be used elsewhere.

SUBROUTINES/METHODS

There are two public methods you can call on this class.

generate_metadata( $pkgspec, $dir, $outdir )

This generates the necessary metadata file (i.e. the specfile) for building RPM packages from this project. It takes an LCFG build package metadata object, an input directory where the template RPM specfile and change log files are stored and an output directory where the generate file should be placed.

build( $tarfile, $specfile, $sourceonly, $options )

This actually builds the RPM packages using the RPM4 wrapper around rpmbuild. It requires the name of the source tar file and the RPM specfile. Optionally it can do a source-only build, and a reference to a hash of options can be passed in, this allows one to specify things like making rpmbuild ignore dependencies with "nodeps". See the RPM4::Spec Perl documentation for full details of the supported options.

DEPENDENCIES

For building packages you will need RPM4(3), for formatting the change log file you will need Date::Parse(3) and Date::Format(3) which are part of the TimeDate suite.

PLATFORMS

This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.

FedoraCore5, FedoraCore6, ScientificLinux5

BUGS AND LIMITATIONS

There are no known bugs in this application. Please report any problems to bugs@lcfg.org, feedback and patches are also always very welcome.

AUTHOR

    Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE AND COPYRIGHT

    Copyright (C) 2008 University of Edinburgh. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.