gbp-pull

Name

gbp-pull -- Safely update a repository from remote

Synopsis

gbp-pull [--verbose] [--force] [--redo-pq] [--[no-]pristine-tar] [--debian-branch=branch_name] [--upstream-branch=branch_name]

DESCRIPTION

gbp-pull updates the debian, upstream and pristine-tar branches from a remote repository in one go. It checks if the update is safe (would result in a fast-forward merge) and aborts otherwise.

OPTIONS

--force

force a branch update even if this results in a non fast forward update.

Warning

Forcing a branch updates makes you lose your modifications.

--redo-pq

also rebuild the corresponding patch-queue using gbp-pq.

Warning

This drops the patch-queue branch if it exists.

--debian-branch=branch_name

The branch in the Git repository the Debian package is being developed on, default is master.

--upstream-branch=branch_name

The branch in the Git repository the upstream sources are put onto. Default is upstream.

--verbose, -v

verbose execution

--pristine-tar

Whether to update the pristine-tar branch too.

EXIT CODES

When gbp-pull finishes it indicates success or failure with it's exit code:

0

Success.

1

An error occured during the pull, see the printed error message for details.

2

At least one branch couldn't be fast forwarded.

CONFIGURATION FILES

Four configuration files are parsed to set defaults for the above commandline arguments:

/etc/git-buildpackage/gbp.conf

system wide configuraton

~/.gbp.conf

per user configuration

.gbp.conf

per branch configuration, can be published with the repository

debian/gbp.conf

per branch configuration, can be published with the repository

.git/gbp.conf

per repository configuration

See /etc/git-buildpackage/gbp.conf for an example.

SEE ALSO

git-buildpackage(1), gbp-clone(1), gbp-pq(1)

AUTHOR

Guido Guenther