Linux Certif

Toute la documentation sur la certification Linux LPI

git-pbuilder

NAME

git-pbuilder - Wrapper around pbuilder for git-buildpackage

SYNOPSIS

DIST=distribution ARCH=architecture git-pbuilder debbuild-options

DIST=distribution ARCH=architecture \
    git-pbuilder (update | create | login) cowbuilder-options

DESCRIPTION

git-pbuilder is a wrapper around pdebuild intended for use by git-buildpackage. It configures pdebuild to use cowbuilder, passes appropriate options to debbuild, and sets the base path for cowbuilder based on the environment variable DIST and, if set, the environment variable ARCH.

By default, git-pbuilder assumes the target distribution is "sid", the same architecture as the cowbuilder default, and uses /var/cache/pbuilder/base-sid.cow if it exists. If it doesn't, /var/cache/pbuilder/base.cow is tried. If DIST is set, its value is the target distribution and /var/cache/pbuilder/base-dist.cow is used instead. If DIST is "etch" or "ebo", --debian-etch-workaround is also passed to cowbuilder. If ARCH is set, its value is the target architecture and /var/cache/pbuilder/base-dist-arch.cow is used, with dist being set to "sid" if DIST was not set.

If git-pbuilder is invoked via a name that starts with "git-pbuilder-", the part after the last hyphen is taken to be the distribution (although the environment variable overrides this). One can therefore create symlinks like "git-pbuilder-lenny" pointing to git-pbuilder and use that name when wanting to use a distribution of "lenny".

Any arguments are passed as-is to dpkg-buildpackage via the --debbuildopts option to pdebuild.

Normally, one does not run this script directly. Instead, it's used as the builder script for git-buildpackage. To configure git-buildpackage to use it, add a stanza like:

     [DEFAULT]
     builder = /path/to/git-pbuilder
 
 

in your gbp.conf file (which can be .gbp.conf in your home directory or at the top level of the repository, or gbp.conf in the .git directory). DIST is read as an environment variable so that you can set it before running git-buildpackage without having to worry about passing parameters through git-buildpackage.

Alternately, git-pbuilder may be called with an argument of "update", "create", or "login". In this case, it calls cowbuilder using sudo and passes the corresponding command to cowbuilder, using the same logic as above to determine the base directory and distribution. Any additional arguments to git-pbuilder are passed along to cowbuilder.

ENVIRONMENT

DIST

Sets the target distribution. This is used primarily to determine the base path for cowbuilder, but it's also used to determine whether to pass --debian-etch-workaround to cowbuilder.

FILES

/var/cache/pbuilder/base-sid.cow

/var/cache/pbuilder/base.cow

The default "cowbuilder --basepath" directories, searched for in that order, if DIST is not set.

/var/cache/pbuilder/base-$DIST.cow

The "cowbuilder --basepath" directory used if DIST is set.

SEE ALSO

cowbuilder(8), dpkg-buildpackage(1), git-buildpackage(1), pdebuild(1), sudo(8)

The latest version of this script is available from <http://www.eyrie.org/~eagle/software/scripts/>.

AUTHOR

Russ Allbery <rra@stanford.edu>