| 1 | git-http-fetch(1) |
| 2 | ================= |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | git-http-fetch - Download from a remote Git repository via HTTP |
| 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
| 11 | [verse] |
| 12 | 'git http-fetch' [-c] [-t] [-a] [-d] [-v] [-w <filename>] [--recover] [--stdin | --packfile=<hash> | <commit>] <URL> |
| 13 | |
| 14 | DESCRIPTION |
| 15 | ----------- |
| 16 | Downloads a remote Git repository via HTTP. |
| 17 | |
| 18 | This command always gets all objects. Historically, there were three options |
| 19 | `-a`, `-c` and `-t` for choosing which objects to download. They are now |
| 20 | silently ignored. |
| 21 | |
| 22 | OPTIONS |
| 23 | ------- |
| 24 | commit-id:: |
| 25 | Either the hash or the filename under [URL]/refs/ to |
| 26 | pull. |
| 27 | |
| 28 | -a:: |
| 29 | -c:: |
| 30 | -t:: |
| 31 | These options are ignored for historical reasons. |
| 32 | |
| 33 | -v:: |
| 34 | Report what is downloaded. |
| 35 | |
| 36 | -w <filename>:: |
| 37 | Writes the commit-id into the specified filename under $GIT_DIR/refs/<filename> on |
| 38 | the local end after the transfer is complete. |
| 39 | |
| 40 | --stdin:: |
| 41 | Instead of a commit id on the command line (which is not expected in this |
| 42 | case), 'git http-fetch' expects lines on stdin in the format |
| 43 | |
| 44 | <commit-id>['\t'<filename-as-in--w>] |
| 45 | |
| 46 | --packfile=<hash>:: |
| 47 | For internal use only. Instead of a commit id on the command |
| 48 | line (which is not expected in |
| 49 | this case), 'git http-fetch' fetches the packfile directly at the given |
| 50 | URL and uses index-pack to generate corresponding .idx and .keep files. |
| 51 | The hash is used to determine the name of the temporary file. It need |
| 52 | not be the pack hash, but it must uniquely identify the pack contents |
| 53 | for resumption. The output of index-pack is printed to stdout. Requires |
| 54 | one or more --index-pack-arg options. |
| 55 | |
| 56 | --index-pack-arg=<arg>:: |
| 57 | For internal use only. The first instance specifies the command run on |
| 58 | the contents of the downloaded pack. Subsequent instances specify its |
| 59 | arguments. |
| 60 | |
| 61 | --recover:: |
| 62 | Verify that everything reachable from target is fetched. Used after |
| 63 | an earlier fetch is interrupted. |
| 64 | |
| 65 | GIT |
| 66 | --- |
| 67 | Part of the linkgit:git[1] suite |