source: ProjectBuilder/devel/pb-modules/lib/ProjectBuilder/Distribution.pm

#!/usr/bin/perl -w
#
# Creates common environment for distributions
#
# Copyright B. Cornec 2007-today
# Eric Anderson's changes are (c) Copyright 2012 Hewlett Packard
# Provided under the GPL v2
#
# $Id$
#

package ProjectBuilder::Distribution;

use strict;
use Data::Dumper;
use Carp qw/cluck confess/;
use ProjectBuilder::Version;
use ProjectBuilder::Base;
use ProjectBuilder::Conf;
use File::Basename;
use File::Copy;
# requires perl 5.004 minimum in VM/VE
use File::Compare;

# Global vars
# Inherit from the "Exporter" module which handles exporting functions.
 
use vars qw(@ISA @EXPORT);
use Exporter;
 
# Export, by default, all the functions into the namespace of
# any code which uses this module.
 
our @ISA = qw(Exporter);
our @EXPORT = qw(pb_distro_init pb_distro_conffile pb_distro_sysconffile pb_distro_api pb_distro_get pb_distro_get_if pb_distro_getlsb pb_distro_installdeps pb_distro_installpkgs pb_distro_getdeps pb_distro_only_deps_needed pb_distro_setuprepo pb_distro_setuposrepo pb_distro_setuprepo_gen pb_distro_get_context pb_distro_to_keylist pb_distro_conf_print pb_apply_conf_proxy);
our ($VERSION,$REVISION,$PBCONFVER) = pb_version_init();

=pod

=head1 NAME

ProjectBuilder::Distribution, part of the project-builder.org - module dealing with distribution detection

=head1 DESCRIPTION

This modules provides functions to allow detection of Linux distributions, and giving back some attributes concerning them.

=head1 SYNOPSIS

  use ProjectBuilder::Distribution;

  # 
  # Return information on the running distro
  #
  my $pbos = pb_distro_get_context();
  print "distro tuple: ".Dumper($pbos->name, $pbos->ver, $pbos->fam, $pbos->type, $pbos->pbsuf, $pbos->pbupd, $pbos->pbins, $pbos->arch)."\n";
  # 
  # Return information on the requested distro
  #
  my $pbos = pb_distro_get_context("ubuntu-7.10-x86_64");
  print "distro tuple: ".Dumper($pbos->name, $pbos->ver, $pbos->fam, $pbos->type, $pbos->pbsuf, $pbos->pbupd, $pbos->pbins, $pbos->arch)."\n";
  # 
  # Return information on the running distro
  #
  my ($ddir,$dver) = pb_distro_guess();

=head1 USAGE

=over 4

=item B<pb_distro_api>

This function returns the mandatory configuration file used for api

=cut

sub pb_distro_api {

return("CCCC/api.yaml");
}


=item B<pb_distro_conffile>

This function returns the mandatory configuration file used for distribution/OS detection

=cut

sub pb_distro_conffile {

if ($PBCONFVER < 1) {
    return("CCCC/pb.conf");
} else {
    return("CCCC/pb.yml");
}
}

=item B<pb_distro_sysconffile>

This function returns the optional configuration file used for local customization

=cut

sub pb_distro_sysconffile {

if ($PBCONFVER < 1) {
    return("SSSS/pb.conf");
} else {
    return("SSSS/pb.yml");
}
}


=item B<pb_distro_init>

This function returns a hash of parameters indicating the distribution name, version, family, type of build system, suffix of packages, update command line, installation command line and architecture of the underlying Linux distribution. The value of the fields may be "unknown" in case the function was unable to recognize on which distribution it is running.

As an example, Ubuntu and Debian are in the same "du" family. As well as RedHat, RHEL, CentOS, fedora are on the same "rh" family.
Mandriva, Open SuSE and Fedora have all the same "rpm" type of build system. Ubuntu and Debian have the same "deb" type of build system. 
And "fc" is the extension generated for all Fedora packages (Version will be added by pb).
All this information is stored in an external configuration file typically at /etc/pb/pb.yml

When passing the distribution name and version as parameters, the B<pb_distro_init> function returns the parameter of that distribution instead of the underlying one.

Cf: http://linuxmafia.com/faq/Admin/release-files.html
Ideas taken from http://search.cpan.org/~kerberus/Linux-Distribution-0.14/lib/Linux/Distribution.pm

=cut


sub pb_distro_init {

my $pbos = {
    'name' => undef,
    'version' => undef,
    'arch' => undef,
    'family' => "unknown",
    'suffix' => "unknown",
    'update' => "unknown",
    'install' => "unknown",
    'type' => "unknown",
    'os' => "unknown",
    'nover' => "false",
    'rmdot' => "false",
    'useminor' => "false",
    };
$pbos->{'name'} = shift;
$pbos->{'version'} = shift;
$pbos->{'arch'} = shift;

# Adds conf file for distribution description
# the location of the conf file is finalyzed at install time
# depending whether we deal with package install or tar file install

pb_conf_add(pb_distro_sysconffile());

# Similarly for the local file available for sysadmin. After the previous one to allow overwrite to work
pb_conf_add(pb_distro_conffile());

# If we don't know which distribution we're on, then guess it
($pbos->{'name'},$pbos->{'version'}) = pb_distro_guess() if ((not defined $pbos->{'name'}) || (not defined $pbos->{'version'}));

# For some rare cases, typically nover ones
$pbos->{'name'} = "unknown" if (not defined $pbos->{'name'});
$pbos->{'version'} = "unknown" if (not defined $pbos->{'version'});

# Initialize arch
$pbos->{'arch'} = pb_get_arch() if (not defined $pbos->{'arch'});
# Solves a bug on Red Hat 6.x where real arch is not detected when using setarch and a chroot
# As it was only i386 forcing it here.
$pbos->{'arch'} = "i386" if (($pbos->{'name'} eq "redhat") && ($pbos->{'version'} =~ /^6\./));

# Dig into the tuple to find the best answer
# Do NOT factorize here, as it won't work as of now for hash creation
# Do NOT change order without caution
$pbos->{'useminor'} = pb_distro_get($pbos,"osuseminorrel");
$pbos->{'family'} = pb_distro_get($pbos,"osfamily");
$pbos->{'type'} = pb_distro_get($pbos,"ostype");
($pbos->{'os'},$pbos->{'install'},$pbos->{'update'}) = pb_distro_get($pbos,("os","osins","osupd"));
($pbos->{'localinstall'},$pbos->{'nover'},$pbos->{'rmdot'},$pbos->{'suffix'}) = pb_distro_get_if($pbos,"oslocalins","osnover","osremovedotinver","ossuffix");

# Some OS have no interesting version
$pbos->{'version'} = "nover" if ((defined $pbos->{'nover'}) && ($pbos->{'nover'} eq "true"));

# For some OS remove the . in version name for extension
my $dver2 = $pbos->{'version'};
$dver2 =~ s/\.//g if ((defined $pbos->{'rmdot'}) && ($pbos->{'rmdot'} eq "true"));

if ((not defined $pbos->{'suffix'}) || ($pbos->{'suffix'} eq "")) {
    # By default suffix is a concatenation of name and version
    $pbos->{'suffix'} = ".$pbos->{'name'}$dver2" 
} else {
    # concat just the version to what has been found
    $pbos->{'suffix'} = ".$pbos->{'suffix'}$dver2";
}

#   if ($arch eq "x86_64") {
#   $opt="--exclude=*.i?86";
#   }
pb_log(2,"DEBUG: pb_distro_init: ".Dumper($pbos)."\n");

return($pbos);
}

=item B<pb_distro_guess>

This function returns a list of 2 parameters indicating the distribution name and version of the underlying Linux distribution. The value of those 2 fields may be "unknown" in case the function was unable to recognize on which distribution it is running.

On my home machine it would currently report ("mandriva","2010.2").

=cut

sub pb_distro_guess {

# 1: List of files that unambiguously indicates what distro we have
# 2: List of files that ambiguously indicates what distro we have
# 3: Should have the same keys as the previous one. If ambiguity, which other distributions should be checked
# 4: Matching Rg. Expr to detect distribution and version
my ($single_rel_files, $ambiguous_rel_files,$distro_similar,$distro_match,$nover) = pb_conf_get("osrelfile","osrelambfile","osambiguous","osrelexpr","osnover");

my $release;
my $distro;

# Begin to test presence of non-ambiguous files
# that way we reduce the choice
my ($d,$r);
while (($d,$r) = each %$single_rel_files) {
    if (defined $ambiguous_rel_files->{$d}) {
        print STDERR "The key $d is considered as both unambiguous and ambiguous.\n";
        confess "Please fix your configuration file.\n"
    }
    if (-f "$r" && ! -l "$r") {
        my $tmp=pb_get_content("$r");
        # Found the only possibility. 
        # Try to get version and return
        if (defined ($distro_match->{$d})) {
            ($release) = $tmp =~ m/$distro_match->{$d}/m;
        } else {
            if (not defined ($nover->{$d})) {
                print STDERR "Unable to find $d version in $r (non-ambiguous)\n";
                confess "Please report to the maintainer bruno_at_project-builder.org\n";
            }
            $release = "unknown";
        }
        return($d,$release);
    }
}

# Now look at ambiguous files
# Ubuntu before 10.04 includes a /etc/debian_version file that creates an ambiguity with debian
# So we need to look at distros in reverse alphabetic order to treat ubuntu always first via lsb
my $found = 0;
foreach $d (reverse keys %$ambiguous_rel_files) {
    $r = $ambiguous_rel_files->{$d};
    if (-f "$r" && !-l "$r") {
        # Found one possibility. 
        # Get all distros concerned by that file
        my $tmp = pb_get_content("$r");
        my $ptr = $distro_similar->{$d};
        pb_log(2,"amb: ".Dumper($ptr)."\n");
        $release = "unknown";
        foreach my $dd (split(/,/,$ptr)) {
            pb_log(2,"check $dd\n");
            # Try to check pattern
            if (defined $distro_match->{$dd}) {
                pb_log(2,"cmp: $distro_match->{$dd} - vs - $tmp\n");
                ($release) = $tmp =~ m/$distro_match->{$dd}/m;
                if ((defined $release) && ($release ne "unknown")) {
                    $distro = $dd;
                    $found = 1;
                    last;
                }
            }
        }
        last if ($found == 1);
    }
}
if ($found == 0) {
    #
    # Now look at the os-release file to see if we have a std distribution description
    #
    foreach my $r ("/usr/lib/os-release","/etc/os-release") {
        if (-r $r) {
            my $tmp = pb_get_content("$r");
            ($release) = $tmp =~ m/.*\nVERSION_ID=[\"\']*([0-9a-z\._-]+)[\"\']*\n/m;
            ($distro) = $tmp =~ m/.*\nID=[\"\']*([0-9A-z\._-]+)[\"\']*\n/m;
            # Remove the leap suffix if present (OpenSUSE)
            $distro =~ s/-leap//;
            if ((defined $release) && (defined $distro)) {
                $found = 1;
                last;
            }
        }
    }
}
if ($found == 0) {
    print STDERR "Unable to find a version in ".join(' ',keys %$ambiguous_rel_files)." (ambiguous)\n";
    confess "Please report to the maintainer bruno_at_project-builder.org\n";
} else {
    return($distro,$release);
}
}

=item B<pb_distro_getlsb>

This function returns the 5 lsb values LSB version, distribution ID, Description, release and codename.
As entry it takes an optional parameter to specify whether the output is short or not.

=cut

sub pb_distro_getlsb {

my $s = shift;
pb_log(3,"Entering pb_distro_getlsb\n");

my ($ambiguous_rel_files) = pb_conf_get("osrelambfile");
my $lsbf = $ambiguous_rel_files->{"lsb"};

# LSB has not been configured.
if (not defined $lsbf) {
    print STDERR "no lsb entry defined for osrelambfile\n";
    confess "You modified upstream delivery and lost !\n";
}

if (-r $lsbf) {
    my $rep = pb_get_content($lsbf);
    # Create elementary fields
    my ($c, $r, $d, $i, $l) = ("", "", "", "", "");
    for my $f (split(/\n/,$rep)) {
        pb_log(3,"Reading file part ***$f***\n");
        $c = $f if ($f =~ /^DISTRIB_CODENAME/);
        $c =~ s/DISTRIB_CODENAME=/Codename:\t/;
        $r = $f if ($f =~ /^DISTRIB_RELEASE/);
        $r =~ s/DISTRIB_RELEASE=/Release:\t/;
        $d = $f if ($f =~ /^DISTRIB_DESCRIPTION/);
        $d =~ s/DISTRIB_DESCRIPTION=/Description:\t/;
        $d =~ s/"//g;
        $i = $f if ($f =~ /^DISTRIB_ID/);
        $i =~ s/DISTRIB_ID=/Distributor ID:\t/;
        $l = $f if ($f =~ /^LSB_VERSION/);
        $l =~ s/LSB_VERSION=/LSB Version:\t/;
    }
    my $regexp = "^[A-z ]*:[\t ]*";
    $c =~ s/$regexp// if (defined $s);
    $r =~ s/$regexp// if (defined $s);
    $d =~ s/$regexp// if (defined $s);
    $i =~ s/$regexp// if (defined $s);
    $l =~ s/$regexp// if (defined $s);
    return($l, $i, $d, $r, $c);
} else {
    print STDERR "Unable to read $lsbf file\n";
    confess "Please report to the maintainer bruno_at_project-builder.org\n";
}
}

# Internal function

sub pb_apply_conf_proxy {
my ($pbos) = @_;

my $ftp_proxy = pb_distro_get_if($pbos,"ftp_proxy");
my $http_proxy = pb_distro_get_if($pbos,"http_proxy");
my $https_proxy = pb_distro_get_if($pbos,"https_proxy");

# We do not overwrite shell settings
$ENV{'ftp_proxy'} ||= $ftp_proxy if ((defined $ftp_proxy) && ($ftp_proxy ne ""));
$ENV{'http_proxy'} ||= $http_proxy if ((defined $http_proxy) && ($http_proxy ne ""));
$ENV{'https_proxy'} ||= $https_proxy if ((defined $https_proxy) && ($https_proxy ne ""));
}

=item B<pb_distro_installpkgs>

This function install the packages passed as parameters on a distribution.

=cut

sub pb_distro_installpkgs {

my $pbos = shift;
my $pkgs = shift;    # list of pkgs to install
my $local = shift;   # optional should we install local packages or remote (for deb command is different)

# Protection
confess "Missing install command for $pbos->{name}-$pbos->{version}-$pbos->{arch}" unless (defined $pbos->{install} && $pbos->{install} =~ /\w/);
pb_apply_conf_proxy($pbos);
pb_log(1, "ftp_proxy=$ENV{'ftp_proxy'}\n") if (defined $ENV{'ftp_proxy'});
pb_log(1, "http_proxy=$ENV{'http_proxy'}\n")  if (defined $ENV{'http_proxy'});
pb_log(1, "https_proxy=$ENV{'https_proxy'}\n")  if (defined $ENV{'https_proxy'});

my $npkgs = "";
foreach my $p (split(/ /,$pkgs)) {
    $npkgs .= "'".$p."' "
    }

# This may not be // proof. We should test for availability of repo and sleep if not
my $cmd = "$pbos->{'install'} $npkgs";
$cmd = "$pbos->{'localinstall'} $npkgs" if ((defined $local) && (defined $pbos->{'localinstall'}) && ($pbos->{'localinstall'} !~ /[ ]*/));
my $ret = pb_system($cmd, "Installing packages ($cmd)","mayfail");
# Try to accomodate deficient proxies
if ($ret != 0) {
    $ret = pb_system($cmd, "Re-trying installing packages ($cmd)");
}
confess "Some packages did not install" if (($ret != 0) && ($Global::pb_stop_on_error));
}


=item B<pb_distro_installdeps>

This function install the dependencies required to build the package on a distro.
If $forcerepo is defined then do not assume packages are alredy installed, but reinstall them
(useful if you add a repo which contains more up to date packages that you need)
Dependencies can be passed as the 4th parameter in which case they are not computed

=cut

sub pb_distro_installdeps {

# SPEC file
my $f = shift;
my $pbos = shift;
my $forcerepo = shift;
my $deps = shift;   # optional list of deps to install
my $local = shift;   # optional should we install local packages or remote (for deb command is different)
my $deps2;

if (not defined $deps) {
    $deps = pb_distro_getdeps($f,$pbos, $forcerepo);
}
pb_log(2,"DEBUG: Packages to install: $deps\n") if (defined $deps);
return if ((not defined $deps) || ($deps =~ /^\s*$/));

pb_distro_installpkgs($pbos,$deps,$local);
# Check that all deps have been installed correctly
# This time we don't forcerepo to avoid getting a list as a return as we have
# already forced it previously, and this time we just want to check
$deps = pb_distro_getdeps($f, $pbos, undef);
confess "Some dependencies did not install ($deps)" if ((defined $deps) && ($deps =~ /\S/) && ($Global::pb_stop_on_error));
}

=item B<pb_distro_getdeps>

This function computes the dependencies indicated in the build file and return them as a string of packages to install

=cut

sub pb_distro_getdeps {

my $f = shift;
my $pbos = shift;
my $forcerepo = shift;

my $regexp = "";
my $deps = "";
my $sep = $/;

# Protection
return("") if (not defined $pbos->{'type'});
return("") if (not defined $f);

pb_log(3,"entering pb_distro_getdeps: $pbos->{'type'} - $f\n");
if ($pbos->{'type'} eq  "rpm") {
    # In RPM this could include files, but we do not handle them atm.
    $regexp = '^BuildRequires:(.*)$';
} elsif ($pbos->{'type'} eq "deb") {
    $regexp = '^Build-Depends:(.*)$';
} elsif ($pbos->{'type'} eq "aur") {
    $regexp = '^makedepends=(.*)$';
} elsif ($pbos->{'type'} eq "apk") {
    $regexp = '^makedepends=(.*)$';
} elsif ($pbos->{'type'} eq "ebuild") {
    $sep = '"'.$/;
    $regexp = '^DEPEND="(.*)"\n';
} else {
    # No idea
    return("");
}
pb_log(2,"regexp: $regexp\n");

# Preserve separator before using the one we need
my $oldsep = $/;
$/ = $sep;
open(DESC,"$f") || (cluck "Unable to open $f" && return(""));
while (<DESC>) {
    pb_log(4,"read: $_\n");
    next if (! /$regexp/);
    chomp();

    my $nextline;
    # Support multi-lines deps for .deb
    if ($pbos->{type} eq 'deb') {
        while ($nextline = <DESC>) {
            last unless $nextline =~ /^\s+(.+)$/o;
            $_ .= $1;
        }
    }

    # What we found with the regexp is the list of deps.
    pb_log(2,"found deps: $_\n");
    s/$regexp/$1/i;
    pb_log(4,"found deps 1: $_\n");
    # Remove conditions in the middle and at the end for deb
    s/\([><=]+[^,]*,/,/g;
    pb_log(4,"found deps 2: $_\n");
    s/\([><=]+[^,]*$//g;
    pb_log(4,"found deps 3: $_\n");
    # Same for rpm
    s/[><=]+[^,]*,/,/g;
    pb_log(4,"found deps 4: $_\n");
    s/[><=]+.*$//g;
    pb_log(4,"found deps 5: $_\n");
    # Improve string format (remove , and spaces at start, end and in double
    s/,/ /g;
    pb_log(4,"found deps 6: $_\n");
    s/^\s*//;
    pb_log(4,"found deps 7: $_\n");
    # $ here removes the \n
    s/\s*$//;
    pb_log(4,"found deps 8: $_\n");
    s/\s+/ /g;
    pb_log(4,"found deps 9: $_\n");
    $deps .= " ".$_;
    pb_log(4,"found deps end: $deps\n");

    # Support multi-lines deps for .deb (fwup)
    if (defined $nextline) {
        $_ = $nextline;
        redo;
    }
}
close(DESC);
$/ = $oldsep;
pb_log(2,"now deps: $deps\n");
if (defined $forcerepo) {
    # We want to force installation of all pkgs
    # because a repo was setup in between, which may contains updated versions
    pb_log(0,"Forcing installation of all packages due to previous repo setup\n");
    return($deps);
} else {
    pb_log(0,"Installation of only necessary packages\n");
    my $deps2 = pb_distro_only_deps_needed($pbos,$deps);
    return($deps2);
}
}


=item B<pb_distro_only_deps_needed>

This function returns only the dependencies not yet installed

=cut

sub pb_distro_only_deps_needed {

my $pbos = shift;
my $deps = shift;

return("") if ((not defined $deps) || ($deps =~ /^\s*$/));
my $deps2 = "";
# Avoid to install what is already there
delete $ENV{'COLUMNS'};
foreach my $p (split(/\s+/,$deps)) {
    next if $p =~ /^\s*$/o;
    if ($pbos->{'type'} eq  "rpm") {
        my $rpmcmd = "rpm -q --whatprovides --quiet";
        # whatprovides doesn't work for RH6.2
        $rpmcmd = "rpm -q --quiet" if (($pbos->{'name'} eq "redhat") && ($pbos->{'version'} =~ /6/));
        my $res = pb_system("$rpmcmd '".$p."'","Looking for $p","mayfail");
        next if ($res eq 0);
        pb_log(1, "INFO: missing dependency $p\n");
    } elsif ($pbos->{'type'} eq "deb") {
        my $res = pb_system("dpkg -L $p","Looking for $p","mayfail");
        next if ($res eq 0);
        open(CMD,"dpkg -l $p |") || (cluck "Unable to run dpkg -l $p: $!" && next);
        my $ok = 0;
        while (<CMD>) {
            $ok = 1 if /^ii\s+$p/;
        }
        close(CMD);
        next if $ok;
        pb_log(1, "INFO: missing dependency $p\n");
    } elsif ($pbos->{'type'} eq "ebuild") {
    } elsif ($pbos->{'type'} eq "apk") {
        my $res = pb_system("apk -e info $p","Looking for $p","mayfail");
        next if ($res eq 0);
        pb_log(1, "INFO: missing dependency $p\n");
    } else {
        # Not reached
    }
    $deps2 .= " $p";
}

$deps2 =~ s/^\s*//;
pb_log(2,"List of missing packages: $deps2\n");
return($deps2);
}

# Internal
sub pb_distro_compare_repo {

my $src = shift;
my $dest = shift;

if (not -f $dest) {
    pb_log(1, "INFO: Creating new file $dest\n");
} elsif (-f $dest && -s $dest == 0) {
    pb_log(1, "INFO: Overwriting empty file $dest\n");
} elsif (-f $dest && compare("$src", $dest) == 0) {
    pb_log(1, "INFO: Overwriting identical file $dest\n");
} else {
    pb_log(0, "ERROR: destination file $dest exists and is different than source $src\n");
    pb_system("cat $dest","INFO: Dest...\n","verbose");
    pb_system("cat $src","INFO: New...\n","verbose");
    pb_log(1, "INFO: Returning...\n");
    return(1);
}
return(0);
}


=item B<pb_distro_setuposrepo>

This function sets up potential additional repository for the setup phase

=cut

sub pb_distro_setuposrepo {

my $pbos = shift;

pb_log(3, "INFO: Adding osrepo from config file\n");
my %h;
my $h = \%h;
# Adds conf file for availability of conf elements either from the local build env or from a VE/VM/RM in which the conf file has been passed
$h = pb_conf_cache(pb_distro_conffile(),$h);
#my $repo = pb_distro_get_param($pbos,$osrepo);
my $repo = pb_distro_get_in_hash_if($pbos,$h,"osrepo");
return(pb_distro_setuprepo_gen($pbos,$repo));
}

=item B<pb_distro_setuprepo>

This function sets up potential additional repository to the build/install/test environment
If done, it returns forcerepo if a repo was added, if not undef

=cut

sub pb_distro_setuprepo {

my $pbos = shift;
my $repotype = shift;

my %h;
my $h = \%h;
# Adds conf file for availability of conf elements either from the local build env or from a VE/VM/RM in which the conf file has been passed
$h = pb_conf_cache("$ENV{'PBROOTDIR'}/$ENV{'PBPROJ'}.yml",$h) if ((defined $ENV{'PBROOTDIR'}) && (-f "$ENV{'PBROOTDIR'}/$ENV{'PBPROJ'}.yml"));
$h = pb_conf_cache("$ENV{'PBDESTDIR'}/pbrc.yml",$h) if ((defined $ENV{'PBDESTDIR'}) && (-f "$ENV{'PBDESTDIR'}/pbrc.yml"));

my $repo = pb_distro_get_in_hash_if($pbos,$h,"add".$repotype."repo");
# If no repo then set it up as undef so the return value is correct from pb_distro_setuprepo_gen
$repo = undef if ((defined $repo) && ($repo eq ""));
if ($repotype =~ /install/) {
    # Give a probable default if nothing is provided to avoid overloading conf files
    #
    if (not defined $repo) {
        my ($pbrepo) = pb_conf_get_in_hash_if($h,"pbrepo");
        if (not defined $pbrepo) {
            cluck("No pbrepo parameter defined in your project configuration file, please fix !");
            return(undef);
        }
        my $url = "$pbrepo->{$ENV{'PBPROJ'}}";
        my ($testver,$delivery) = pb_conf_get_in_hash_if($h,"testver","delivery");
        $delivery->{$ENV{'PBPROJ'}} = "" if (not defined $delivery->{$ENV{'PBPROJ'}});
        $url .= "/$delivery->{$ENV{'PBPROJ'}}/";
        my $repotag = "";
        $repotag = "-$delivery->{$ENV{'PBPROJ'}}" if ($delivery->{$ENV{'PBPROJ'}} ne "");
        $url .= "/$pbos->{'name'}/$pbos->{'version'}/$pbos->{'arch'}/$ENV{PBPROJ}$repotag.";
        my $ext = "";
        if ($pbos->{'type'} eq "rpm") {
            $ext = "repo";
            if ($pbos->{'family'} eq "md") {
                $ext = "addmedia";
            }
        } elsif ($pbos->{'type'} eq "deb") {
            $ext = ".sources.list";
        }
        $repo = $url.$ext;
    }
}
pb_log(1, "INFO: Adding $repo from config file for $repotype step\n") if (defined $repo);
return(pb_distro_setuprepo_gen($pbos,$repo));
}

=item B<pb_distro_setuprepo_gen>

This functionthe sets up in a generic way potential additional repository passed as a param
It returns forcerepo if one was added, else undef 

=cut

sub pb_distro_setuprepo_gen {

my $pbos = shift;
my $param = shift;

return(undef) if (not defined $param);

pb_apply_conf_proxy($pbos);

# Loop on the list of additional repo
foreach my $i (split(/,/,$param)) {

    pb_log(1,"Adding repository defined by $i\n");
    my ($scheme, $account, $host, $port, $path) = pb_get_uri($i);
    my $bn = basename($i);

    # The repo file can be local or remote. download or copy at the right place
    if (($scheme eq "ftp") || ($scheme =~ /http/)) {
        pb_system("wget -O $ENV{'PBTMP'}/$bn $i","Downloading additional repository file $i");
    } else {
        copy($i,"$ENV{'PBTMP'}/$bn");
    }

    # The repo file can be a real file or a package
    if ($pbos->{'type'} eq "rpm") {
        if ($bn =~ /\.rpm$/) {
            my $pn = $bn;
            $pn =~ s/\.rpm//;
            if (pb_system("rpm -q --quiet $pn","","mayfail") != 0) {
                pb_system("sudo rpm -Uvh $ENV{'PBTMP'}/$bn","Adding package $bn to setup repository");
            }
        } elsif ($bn =~ /\.repo$/) {
            my $dirdest = "";
            my $reponame = "";
            # TODO: could go in pb.yml in fact
            if ($pbos->{install} =~ /\byum\b/) {
                $reponame="yum";
                $dirdest = "/etc/yum.repos.d";
            } elsif ($pbos->{install} =~ /\bdnf\b/) {
                $reponame="dnf";
                $dirdest = "/etc/yum.repos.d";
            } elsif ($pbos->{install} =~ /\bzypper\b/) {
                $reponame="zypper";
                $dirdest = "/etc/zypp/repos.d";
            } else {
                cluck "Unknown location for repository file for '$pbos->{install}' command";
                next;
            }
            my $dest = "$dirdest/$bn";
            return(undef) if (pb_distro_compare_repo("$ENV{'PBTMP'}/$bn",$dest) == 1);
            if (! -d $dirdest) {
                cluck "Missing directory $dirdest ($reponame)";
                return(undef);
            }
            pb_system("sudo mv $ENV{'PBTMP'}/$bn $dest","Adding $reponame repository") if (not -f "$dest");
            # OpenSUSE does't seem to import keys automatically
            # :-(
            if ($pbos->{install} =~ /\bzypper\b/) {
                my $keyfile = undef;
                open(REPO,"$dest") || (cluck "Unable to open $dest" && next);
                while (<REPO>) {
                    $keyfile = $_;
                    if ($keyfile =~ /^gpgkey=/) {
                        $keyfile =~ s/gpgkey=//;
                        last;
                    }
                }
                close(REPO);
                if (defined $keyfile) {
                    pb_system("wget -O $ENV{'PBTMP'}/$bn $keyfile","Downloading GPG key file $keyfile");
                    pb_system("sudo rpm --import $ENV{'PBTMP'}/$bn","Importing GPG key file $keyfile");
                    unlink("$ENV{'PBTMP'}/$bn");
                }
            }
        } elsif ($bn =~ /\.addmedia/) {
            # URPMI repo
            # We should test that it's not an already setup urpmi repo
            open(URPMI,"/etc/urpmi/urpmi.cfg") || (cluck "Unable to open /etc/urpmi/urpmi.cfg" && next);
            my $found = 0;
            my $entry = $bn;
            $entry =~ s/.addmedia$//;
            while (<URPMI>) {
                $found = 1 if ($_ =~ /^$entry /);
            }
            pb_system("chmod 755 $ENV{'PBTMP'}/$bn ; sudo $ENV{'PBTMP'}/$bn 2>&1 > /dev/null","Adding urpmi repository") if ($found == 0);
            pb_log(0,"INFO urpmi $bn already set up\n") if ($found == 1);
        } else {
            pb_log(0,"ERROR: Unable to deal with repository file $i on rpm distro ! Please report to dev team\n");
        }
    } elsif ($pbos->{'type'} eq "deb") {
        if ($bn =~ /\.sources.list$/) {
            my $dest = "/etc/apt/sources.list.d/$bn";
            return(undef) if (pb_distro_compare_repo("$ENV{'PBTMP'}/$bn",$dest) == 1);
            pb_system("sudo mv $ENV{'PBTMP'}/$bn $dest","Adding apt repository $dest");
            # Check whether GPG keys for this repo are already known and if
            # not add them
            open(REPO,"$dest") || (cluck "Unable to open $dest" && next);
            my $debrepo;
            while (<REPO>) {
                if (/^deb\s/) {
                    $debrepo = $_;
                    chomp($debrepo);
                    $debrepo =~ s|^deb ([^\s]+)\s([^\s]+)\s([^\s]+)|$1/dists/$2|;
                    last;
                }
            }
            close(REPO);
            return(undef) if (not defined $debrepo);

            pb_system("wget -O $ENV{'PBTMP'}/Release $debrepo/Release","Downloading $debrepo/Release");
            pb_system("wget -O $ENV{'PBTMP'}/Release.gpg $debrepo/Release.gpg","Downloading $debrepo/Release.gpg");
            my $signature = undef;
            my ($pbgpgserver) = pb_conf_get("pbgpgserver");
            confess "Unable to find a GPG server in configuration, please define pbgpgserver" if (not defined $pbgpgserver);
            my $keyserver = $pbgpgserver->{$ENV{'PBPROJ'}};
            $keyserver = $pbgpgserver->{'default'} if (not defined $keyserver);
            confess "Unable to find a GPG server in configuration, please define correctly pbgpgserver" if (not defined $keyserver);
            open(SIGN,"LANGUAGE=C LANG=C gpg --verify --keyid-format=long $ENV{'PBTMP'}/Release.gpg $ENV{'PBTMP'}/Release 2>&1 |") || (cluck "Unable to verify GPG signature from Release.gpg\n" && next);
            while(<SIGN>) {
                chomp();
                if (/^gpg: .*key /) {
                    $signature = $_;
                    $signature =~ s/^gpg: .*key [ID ]*([A-Z0-9]+)/$1/;
                    pb_system("gpg --recv-keys --keyserver $keyserver $signature","Importing GPG signature for $signature");
                    last;
                }
            }
            close(SIGN);
            return(undef) if (not defined $signature);

            pb_log(3, "GnuPG repo verify returned: $signature\n");
            pb_system("gpg -a --export -o $ENV{'PBTMP'}/apt.sig \'$signature\'","Exporting GnuPG signature of $signature");
            pb_system("sudo apt-key add $ENV{'PBTMP'}/apt.sig","Adding GnuPG signature of $signature to APT key ring");
            pb_system("sudo apt-get update","Updating apt repository");
        } else {
            pb_log(0,"ERROR: Unable to deal with repository file $i on deb distro ! Please report to dev team\n");
        }
    } else {
        pb_log(0,"ERROR: Unable to deal with repository file $i on that distro ! Please report to dev team\n");
    }
}
return("forcerepo");
}

=item B<pb_distro_to_keylist>

Given a pbos object (first param) and the generic key (second param), get the list of possible keys for looking up variable for
filter names.  The list will be sorted most-specific to least specific.

=cut

sub pb_distro_to_keylist ($$) {

my ($pbos, $generic) = @_;

foreach my $key (qw/name version arch family type os/) {
    confess "missing pbos key $key" unless (defined $pbos->{$key});
}

my @keylist = ("$pbos->{'name'}-$pbos->{'version'}-$pbos->{'arch'}", "$pbos->{'name'}-$pbos->{'version'}");

# Loop to include also previous minor versions
# if configured so
if ((defined $pbos->{'useminor'}) && ($pbos->{'useminor'} eq "true") && ($pbos->{'version'} =~ /^(\d+)\.(\d+)$/o)) {
        my ($major, $minor) = ($1, $2);
        while ($minor > 0) {
                $minor--;
                push (@keylist, "$pbos->{'name'}-${major}.$minor");
        }
        push (@keylist, "$pbos->{'name'}-$major");
}

push (@keylist, $pbos->{'name'}, $pbos->{'family'}, $pbos->{'type'}, $pbos->{'os'}, $generic);
return @keylist;
}

=item B<pb_distro_get_param>

This internal function gets the parameters in the conf file from the most precise tuple up to default

=cut

sub pb_distro_get_param {

my $pbos = shift;
my $var = shift; 
my @param = ();
my $i = 0;
pb_log(3,"var: ".Dumper($var));

my @keylist = pb_distro_to_keylist($pbos,"default");
pb_log(3,"keylist: ".Dumper(@keylist));

my $p = $var->{"ptr"};
foreach my $opt (@$p) {
    pb_log(3,'opt: '.Dumper($opt));
    my $param = undef;
    my $fkey = undef;
    foreach my $key (@keylist) {
        pb_log(3,"key: $key\n");
        if (defined $opt->{$key}) {
            $param = $opt->{$key};
            $fkey = $key;
            last;
        }
    }
    my $field = $var->{"val"};
    pb_log(3,"field: ".Dumper($field));
    $fkey = "default" if (not defined $fkey);
    pb_log(3,"key: $fkey\n");
    pb_log(2,"DEBUG: pb_distro_get_if on $pbos->{'name'}-$pbos->{'version'}-$pbos->{'arch'} for $field->[$i]".'{'.$fkey.'}'." returns ");
    if (defined $param) {
        # Allow replacement of variables inside the parameter such as name, version, arch for rpmbootstrap 
        # but not shell variable which are backslashed
        if ($param =~ /[^\\]\$/) {
            pb_log(3,"Expanding variable on $param\n");
            eval { $param =~ s/(\$\w+->\{\'\w+\'\})/$1/eeg };
        }
        pb_log(2,"$param\n");
    } else {
        pb_log(2,"undefined\n");
    }
    push @param,$param;
    $i++;
}

# Return one param if user only asked for one lookup, an array if not.
my $nb = @param;
pb_log(3,"Param".Dumper(@param)." has $nb members\n");
if ($nb eq 1) {
    pb_log(3,"Return param $param[0]\n") if (defined $param[0]);
    return($param[0]);
} else {
    return(@param);
}
}


=item B<pb_distro_get_if>

This function gets the parameters in the conf file from the most precise tuple up to default

=cut

sub pb_distro_get_if {

my $pbos = shift;
my @ptr = pb_conf_get_if(@_);
my $var;
$var->{"ptr"} = \@ptr;
$var->{"val"} = \@_;
return(pb_distro_get_param($pbos,$var));
}

=item B<pb_distro_get>

This function gets the parameters in the conf file from the most precise tuple up to default. 
Aborts of one param doesn't exist whereas it should

=cut

sub pb_distro_get {

my $pbos = shift;
my @param = @_;
my @return = pb_distro_get_if($pbos,@param);

foreach my $i (0..$#param) {
    confess "No $param[$i] defined for $pbos->{'name'}-$pbos->{'version'}-$pbos->{'arch'}" if (not defined $return[$i]);
}
my $nb = @return;
if ($nb eq 1) {
    return($return[0]);
} else {
    return(@return);
}
}

=item B<pb_distro_get_in_hash_if>

This function gets the parameters in the conf file passed as hash from the most precise tuple up to default

=cut

sub pb_distro_get_in_hash_if {

my $pbos = shift;
my $lh = shift || return(());

my @ptr = pb_conf_get_in_hash_if($lh,@_);
my $var;
$var->{"ptr"} = \@ptr;
$var->{"val"} = \@_;
return(pb_distro_get_param($pbos,$var));
}

=item B<pb_distro_get_context>

This function gets the OS context passed as parameter and return the corresponding distribution hash
If passed undef or "" then auto-detects

=cut


sub pb_distro_get_context {

my $os = shift;
my $pbos;

if ((defined $os) && ($os ne "")) {
    my ($name,$ver,$darch) = split(/-/,$os);
    pb_log(0,"Bad format for $os") if ((not defined $name) || (not defined $ver) || (not defined $darch)) ;
    chomp($darch);
    $pbos = pb_distro_init($name,$ver,$darch);
} else {
    $pbos = pb_distro_init();
}
return($pbos);
}

=item B<pb_distro_conf_print>

This function prints every configuration parameter in order to help debug stacking issues with conf files. If a VM/VE/RM is given, restrict display to this distribution. If parameters are passed, restrict again the display to these values only.

=cut

sub pb_distro_conf_print {

my $pbos = shift;
my @keys = @_;
my $all = 0;

if ($#keys == -1) {
    pb_log(0,"Full pb configuration for project $ENV{'PBPROJ'}\n");
    pb_log(0,"================================================\n");
    @keys = pb_conf_get_all();
    $all = 1;
}
if (defined $ENV{'PBV'}) {
    pb_log(1,"Distribution $ENV{'PBV'}\n");
    pb_log(1,"========================\n");
} else {
    pb_log(1,"Local Distribution\n");
    pb_log(1,"==================\n");
}

my %rep;
my $i = 0;
# Index on distro
foreach my $r (pb_distro_get_if($pbos,@keys)) {
    $rep{$keys[$i]} = $r if (defined $keys[$i]);
    $i++;
}
$i = 0;
# Then Index on prj to overwrite previous value if needed
foreach my $r (pb_conf_get_if(@keys)) {
    $rep{$keys[$i]} = $r->{'default'} if (defined  $r->{'default'});
    $rep{$keys[$i]} = $r->{$ENV{'PBPROJ'}} if (defined  $r->{$ENV{'PBPROJ'}});
    $i++;
}
foreach my $r (keys %rep) {
    pb_log(1, "$r => ");
    pb_log(0, "$rep{$r}\n") if (($all == 0) && (defined $rep{$r}));
    pb_log(0, "$r = $rep{$r}\n") if (($all == 1) && (defined $rep{$r}));
}
}


=back 

=head1 WEB SITES

The main Web site of the project is available at L<http://www.project-builder.org/>. Bug reports should be filled using the trac instance of the project at L<http://trac.project-builder.org/>.

=head1 USER MAILING LIST

None exists for the moment.

=head1 AUTHORS

The Project-Builder.org team L<http://trac.project-builder.org/> lead by Bruno Cornec L<mailto:bruno@project-builder.org>.

=head1 COPYRIGHT

Project-Builder.org is distributed under the GPL v2.0 license
described in the file C<COPYING> included with the distribution.

=cut


1;