]>
Commit | Line | Data |
---|---|---|
58e60dd2 NH |
1 | git-http-push(1) |
2 | ================ | |
3 | ||
4 | NAME | |
5 | ---- | |
c3f0baac | 6 | git-http-push - Push objects over HTTP/DAV to another repository |
58e60dd2 NH |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
7791a1d9 | 11 | [verse] |
7706294e | 12 | 'git http-push' [--all] [--dry-run] [--force] [--verbose] <URL> <ref> [<ref>...] |
58e60dd2 NH |
13 | |
14 | DESCRIPTION | |
15 | ----------- | |
0a4f051f | 16 | Sends missing objects to the remote repository, and updates the |
58e60dd2 NH |
17 | remote branch. |
18 | ||
8da1e212 JH |
19 | *NOTE*: This command is temporarily disabled if your libcurl |
20 | is older than 7.16, as the combination has been reported | |
0a4f051f | 21 | not to work and sometimes corrupts the repository. |
58e60dd2 NH |
22 | |
23 | OPTIONS | |
24 | ------- | |
d8190a8e | 25 | --all:: |
58e60dd2 NH |
26 | Do not assume that the remote repository is complete in its |
27 | current state, and verify all objects in the entire local | |
28 | ref's history exist in the remote repository. | |
29 | ||
30 | --force:: | |
31 | Usually, the command refuses to update a remote ref that | |
32 | is not an ancestor of the local ref used to overwrite it. | |
33 | This flag disables the check. What this means is that | |
34 | the remote repository can lose commits; use it with | |
35 | care. | |
36 | ||
fe5d1d3e SP |
37 | --dry-run:: |
38 | Do everything except actually send the updates. | |
39 | ||
58e60dd2 NH |
40 | --verbose:: |
41 | Report the list of objects being walked locally and the | |
42 | list of objects successfully sent to the remote repository. | |
43 | ||
3240240f SB |
44 | -d:: |
45 | -D:: | |
d8190a8e | 46 | Remove <ref> from remote repository. The specified branch |
4d542687 | 47 | cannot be the remote HEAD. If -d is specified, the following |
d8190a8e AR |
48 | other conditions must also be met: |
49 | ||
50 | - Remote HEAD must resolve to an object that exists locally | |
51 | - Specified branch resolves to an object that exists locally | |
52 | - Specified branch is an ancestor of the remote HEAD | |
53 | ||
23bed43d | 54 | <ref>...:: |
58e60dd2 NH |
55 | The remote refs to update. |
56 | ||
57 | ||
76a8788c | 58 | SPECIFYING THE REFS |
58e60dd2 NH |
59 | ------------------- |
60 | ||
61 | A '<ref>' specification can be either a single pattern, or a pair | |
62 | of such patterns separated by a colon ":" (this means that a ref name | |
a6080a0a | 63 | cannot have a colon in it). A single pattern '<name>' is just a |
58e60dd2 NH |
64 | shorthand for '<name>:<name>'. |
65 | ||
6ae7e883 JNA |
66 | Each pattern pair '<src>:<dst>' consists of the source side (before |
67 | the colon) and the destination side (after the colon). The ref to be | |
68 | pushed is determined by finding a match that matches the source side, | |
69 | and where it is pushed is determined by using the destination side. | |
58e60dd2 | 70 | |
6ae7e883 | 71 | - It is an error if '<src>' does not match exactly one of the |
58e60dd2 NH |
72 | local refs. |
73 | ||
6ae7e883 | 74 | - If '<dst>' does not match any remote ref, either |
58e60dd2 NH |
75 | |
76 | * it has to start with "refs/"; <dst> is used as the | |
77 | destination literally in this case. | |
78 | ||
79 | * <src> == <dst> and the ref that matched the <src> must not | |
80 | exist in the set of remote refs; the ref matched <src> | |
81 | locally is used as the name of the destination. | |
82 | ||
bcf9626a | 83 | Without `--force`, the <src> ref is stored at the remote only if |
58e60dd2 | 84 | <dst> does not exist, or <dst> is a proper subset (i.e. an |
a75d7b54 | 85 | ancestor) of <src>. This check, known as "fast-forward check", |
cf6cac20 EN |
86 | is performed to avoid accidentally overwriting the |
87 | remote ref and losing other peoples' commits from there. | |
58e60dd2 | 88 | |
bcf9626a | 89 | With `--force`, the fast-forward check is disabled for all refs. |
58e60dd2 NH |
90 | |
91 | Optionally, a <ref> parameter can be prefixed with a plus '+' sign | |
92 | to disable the fast-forward check only on that ref. | |
93 | ||
58e60dd2 NH |
94 | GIT |
95 | --- | |
9e1f0a85 | 96 | Part of the linkgit:git[1] suite |