LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

gbp

Git integration for Debian package building

TLDR

Import an existing Debian source package into Git
$ gbp import-dsc [path/to/package.dsc]
copy
Build the package using the default builder
$ gbp buildpackage -jauto -us -uc
copy
Build a package in a pbuilder environment
$ DIST=bullseye ARCH=amd64 gbp buildpackage -jauto -us -uc --git-builder=git-pbuilder
copy
Import a new upstream release
$ gbp import-orig --pristine-tar [path/to/package.tar.gz]
copy
Clone a repository with gbp branch tracking
$ gbp clone [url]
copy
Generate changelog entries from Git commits
$ gbp dch --auto
copy
Tag the current Debian release in Git
$ gbp tag
copy
Push packaging branches and tags to remote
$ gbp push
copy

SYNOPSIS

gbp command [options]

DESCRIPTION

gbp (git-buildpackage) integrates Debian package building with Git version control. It maintains separate Git branches for upstream source, Debian packaging, and optionally pristine tarballs, providing a clean workflow for package maintenance.The typical workflow involves importing upstream releases with gbp import-orig, making packaging changes on the debian branch, and building with gbp buildpackage. The tool handles merging upstream changes and generating proper Debian source packages.gbp supports building in clean environments via pbuilder, sbuild, or cowbuilder for reproducible builds.

PARAMETERS

buildpackage

Build Debian source and binary packages from a Git repository.
import-dsc
Import an existing Debian source package into a Git repository.
import-orig
Import a new upstream source tarball into a Git repository.
export-orig
Recreate upstream tarballs from a Git repository.
clone
Clone a Git repository and set up gbp tracking branches.
pull
Update a repository from remote, aware of packaging branch tracking.
push
Push to a remote repository, aware of packaging branch tracking.
dch
Generate debian/changelog entries from Git commit history.
tag
Tag a Debian release in a Git repository.
pq
Manage debian/patches as Git topic branches (patch queue).
create-remote-repo
Create a remote Git repository and push the local repository into it.
import-dscs
Import several Debian source packages into a Git repository, sorted by version.

CONFIGURATION

debian/gbp.conf

Project-specific settings for branch names, build options, and pristine-tar configuration.
~/.gbp.conf
User-level defaults for gbp behavior across all projects.

CAVEATS

Requires understanding of both Git branching and Debian packaging. Branch naming conventions (upstream, debian, pristine-tar) must be followed. Complex merge scenarios may require manual intervention. Options prefixed with --git- are for gbp itself; other options are passed through to the underlying build command.

HISTORY

git-buildpackage was created by Guido Gunther and first released around 2007. It became a standard tool for Debian developers who wanted to combine the benefits of Git's distributed version control with Debian's packaging system.

SEE ALSO

debuild(1), dpkg-buildpackage(1), pbuilder(8), sbuild(1), git(1)

Copied to clipboard
Kai