gbp-pull

Name

gbp-pull -- Safely update a repository from remote

Synopsis

gbp pull [--version] [--help] [--verbose] [--color=[auto|on|off]] [--color-scheme=COLOR_SCHEME] [--force=[merge|clean]] [--all] [--redo-pq] [--[no-]pristine-tar] [--ignore-branch] [--debian-branch=branch_name | --packaging-branch=branch_name] [--upstream-branch=branch_name] [--depth=depth]

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

--version

Print version of the program, i.e. version of the git-buildpackage suite

-v, --verbose

Verbose execution

-h, --help

Print help and exit

--color=[auto|on|off]

Whether to use colored output.

--color-scheme=COLOR_SCHEME

Colors to use in output (when color is enabled). The format for COLOR_SCHEME is '<debug>:<info>:<warning>:<error>'. Numerical values and color names are accepted, empty fields imply the default color. For example, --git-color-scheme='cyan:34::' would show debug messages in cyan, info messages in blue and other messages in default (i.e. warning and error messages in red).

--force=[merge|clean]

Force a branch update even if this results in a non fast forward update. merge does a git-merge. clean checks out a clean copy from upstream.

Warning

using clean makes you lose your modifications.

--all

Update all remote-tracking branches that have identical name in the remote repository.

--redo-pq

also rebuild the corresponding patch-queue using gbp pq.

Warning

This drops the patch-queue branch if it exists.

--ignore-branch

Don't care if we're on a branch or in detached head state.

--debian-branch=branch_name

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

--packaging-branch=branch_name

The branch the packaging is being maintained on. Alternative to the --debian-branch option.

--upstream-branch=branch_name

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

--depth=depth

Git history depth, for deepening shallow git clones.

--pristine-tar

Whether to update the pristine-tar branch too.

EXIT CODES

When gbp pull finishes, it indicates success or failure with its exit code:

0

Success.

1

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

2

At least one branch couldn't be fast forwarded.

CONFIGURATION FILES

Several gbp.conf files are parsed to set defaults for the above command-line arguments. See the gbp.conf(5)> manpage for details.

SEE ALSO

gbp-buildpackage(1)>, gbp-clone(1)>, gbp-pq(1)>, gbp.conf(5)>

AUTHOR

Guido Guenther