2005-11-02 19:19:24 +00:00
|
|
|
git-http-push(1)
|
|
|
|
================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2007-01-18 23:53:37 +00:00
|
|
|
git-http-push - Push objects over HTTP/DAV to another repository
|
2005-11-02 19:19:24 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2011-07-02 02:38:26 +00:00
|
|
|
[verse]
|
2021-11-06 18:48:55 +00:00
|
|
|
'git http-push' [--all] [--dry-run] [--force] [--verbose] <URL> <ref> [<ref>...]
|
2005-11-02 19:19:24 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
Sends missing objects to remote repository, and updates the
|
|
|
|
remote branch.
|
|
|
|
|
2008-06-15 10:14:12 +00:00
|
|
|
*NOTE*: This command is temporarily disabled if your libcurl
|
|
|
|
is older than 7.16, as the combination has been reported
|
2008-01-22 01:34:43 +00:00
|
|
|
not to work and sometimes corrupts repository.
|
2005-11-02 19:19:24 +00:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
2007-04-27 04:59:00 +00:00
|
|
|
--all::
|
2005-11-02 19:19:24 +00:00
|
|
|
Do not assume that the remote repository is complete in its
|
|
|
|
current state, and verify all objects in the entire local
|
|
|
|
ref's history exist in the remote repository.
|
|
|
|
|
|
|
|
--force::
|
|
|
|
Usually, the command refuses to update a remote ref that
|
|
|
|
is not an ancestor of the local ref used to overwrite it.
|
|
|
|
This flag disables the check. What this means is that
|
|
|
|
the remote repository can lose commits; use it with
|
|
|
|
care.
|
|
|
|
|
2007-10-16 04:35:22 +00:00
|
|
|
--dry-run::
|
|
|
|
Do everything except actually send the updates.
|
|
|
|
|
2005-11-02 19:19:24 +00:00
|
|
|
--verbose::
|
|
|
|
Report the list of objects being walked locally and the
|
|
|
|
list of objects successfully sent to the remote repository.
|
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-d::
|
|
|
|
-D::
|
2007-04-27 04:59:00 +00:00
|
|
|
Remove <ref> from remote repository. The specified branch
|
|
|
|
cannot be the remote HEAD. If -d is specified the following
|
|
|
|
other conditions must also be met:
|
|
|
|
|
|
|
|
- Remote HEAD must resolve to an object that exists locally
|
|
|
|
- Specified branch resolves to an object that exists locally
|
|
|
|
- Specified branch is an ancestor of the remote HEAD
|
|
|
|
|
2006-10-12 16:26:34 +00:00
|
|
|
<ref>...::
|
2005-11-02 19:19:24 +00:00
|
|
|
The remote refs to update.
|
|
|
|
|
|
|
|
|
2018-04-30 15:35:33 +00:00
|
|
|
SPECIFYING THE REFS
|
2005-11-02 19:19:24 +00:00
|
|
|
-------------------
|
|
|
|
|
|
|
|
A '<ref>' specification can be either a single pattern, or a pair
|
|
|
|
of such patterns separated by a colon ":" (this means that a ref name
|
2007-06-07 07:04:01 +00:00
|
|
|
cannot have a colon in it). A single pattern '<name>' is just a
|
2005-11-02 19:19:24 +00:00
|
|
|
shorthand for '<name>:<name>'.
|
|
|
|
|
2021-11-06 18:48:56 +00:00
|
|
|
Each pattern pair '<src>:<dst>' consists of the source side (before
|
|
|
|
the colon) and the destination side (after the colon). The ref to be
|
|
|
|
pushed is determined by finding a match that matches the source side,
|
|
|
|
and where it is pushed is determined by using the destination side.
|
2005-11-02 19:19:24 +00:00
|
|
|
|
2021-11-06 18:48:56 +00:00
|
|
|
- It is an error if '<src>' does not match exactly one of the
|
2005-11-02 19:19:24 +00:00
|
|
|
local refs.
|
|
|
|
|
2021-11-06 18:48:56 +00:00
|
|
|
- If '<dst>' does not match any remote ref, either
|
2005-11-02 19:19:24 +00:00
|
|
|
|
|
|
|
* it has to start with "refs/"; <dst> is used as the
|
|
|
|
destination literally in this case.
|
|
|
|
|
|
|
|
* <src> == <dst> and the ref that matched the <src> must not
|
|
|
|
exist in the set of remote refs; the ref matched <src>
|
|
|
|
locally is used as the name of the destination.
|
|
|
|
|
2016-06-28 11:40:11 +00:00
|
|
|
Without `--force`, the <src> ref is stored at the remote only if
|
2005-11-02 19:19:24 +00:00
|
|
|
<dst> does not exist, or <dst> is a proper subset (i.e. an
|
2009-10-24 08:31:32 +00:00
|
|
|
ancestor) of <src>. This check, known as "fast-forward check",
|
2023-10-08 06:45:03 +00:00
|
|
|
is performed to avoid accidentally overwriting the
|
|
|
|
remote ref and losing other peoples' commits from there.
|
2005-11-02 19:19:24 +00:00
|
|
|
|
2016-06-28 11:40:11 +00:00
|
|
|
With `--force`, the fast-forward check is disabled for all refs.
|
2005-11-02 19:19:24 +00:00
|
|
|
|
|
|
|
Optionally, a <ref> parameter can be prefixed with a plus '+' sign
|
|
|
|
to disable the fast-forward check only on that ref.
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|