NAME

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

VERSION

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

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( $dir, $specfile, $options )

This actually builds the RPM packages using the rpmbuild command. It requires the name of the directory which contains the source tar file and the RPM specfile. A reference to a hash of options can be passed in, this allows one to specify things like only building the source package (with "sourceonly") and making rpmbuild ignore dependencies with "nodeps".

DEPENDENCIES

For formatting the change log file you will need DateTime(3).

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.

Fedora12, Fedora13, ScientificLinux5, ScientificLinux6, MacOSX7

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.