Scroll to navigation

GBP-PULL(1) git-buildpackage Manual GBP-PULL(1)

NAME

gbp-pull - Safely update a repository from remote

SYNOPSIS

gbp pull [ --version ] [ --help ] [ --verbose ] [ --color=[auto|on|off] ] [ --color-scheme=COLOR_SCHEME ] [ --force ] [ --redo-pq ] [ --[no-]pristine-tar ] [ --ignore-branch ] [ --debian-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
force a branch update even if this results in a non fast forward update.
 
Warning: Forcing a branch update 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.
--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.
--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 <agx@sigxcpu.org>