blob: 4deb4893f517c3a0bc1e01228f0a28818c05daea [file] [log] [blame]
Junio C Hamano215a7ad2005-09-07 17:26:23 -07001git-http-fetch(1)
2=================
David Greaves2cf565c2005-05-10 22:32:30 +01003
4NAME
5----
Thomas Ackermann2de9b712013-01-21 20:17:53 +01006git-http-fetch - Download from a remote Git repository via HTTP
David Greaves2cf565c2005-05-10 22:32:30 +01007
8
9SYNOPSIS
10--------
Martin von Zweigbergk7791a1d2011-07-01 22:38:26 -040011[verse]
Jonathan Tan8d5d2a32020-06-10 13:57:18 -070012'git http-fetch' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] [--stdin | --packfile=<hash> | <commit>] <url>
David Greaves2cf565c2005-05-10 22:32:30 +010013
14DESCRIPTION
15-----------
Thomas Ackermann2de9b712013-01-21 20:17:53 +010016Downloads a remote Git repository via HTTP.
David Greaves2cf565c2005-05-10 22:32:30 +010017
Martin Ågren2e85a0c2018-04-22 20:12:49 +020018This command always gets all objects. Historically, there were three options
19`-a`, `-c` and `-t` for choosing which objects to download. They are now
20silently ignored.
Ben Waltona6c786f2011-08-23 20:29:51 -040021
Nikolai Weibull5dd73422005-12-09 00:28:05 +010022OPTIONS
23-------
24commit-id::
25 Either the hash or the filename under [URL]/refs/ to
26 pull.
27
Martin Ågren2e85a0c2018-04-22 20:12:49 +020028-a, -c, -t::
29 These options are ignored for historical reasons.
David Greaves2cf565c2005-05-10 22:32:30 +010030-v::
31 Report what is downloaded.
Johannes Schindelin2c6e4772005-08-05 17:05:02 +020032
33-w <filename>::
34 Writes the commit-id into the filename under $GIT_DIR/refs/<filename> on
Junio C Hamano613d8722005-06-25 02:25:57 -070035 the local end after the transfer is complete.
David Greaves2cf565c2005-05-10 22:32:30 +010036
Petr Baudis8e29f6a2006-07-27 23:56:22 +020037--stdin::
Brian Hetro02783072007-08-23 20:44:13 -040038 Instead of a commit id on the command line (which is not expected in this
Thomas Rast0b444cd2010-01-10 00:33:00 +010039 case), 'git http-fetch' expects lines on stdin in the format
Petr Baudis8e29f6a2006-07-27 23:56:22 +020040
41 <commit-id>['\t'<filename-as-in--w>]
42
Jonathan Tan8d5d2a32020-06-10 13:57:18 -070043--packfile=<hash>::
44 Instead of a commit id on the command line (which is not expected in
45 this case), 'git http-fetch' fetches the packfile directly at the given
46 URL and uses index-pack to generate corresponding .idx and .keep files.
47 The hash is used to determine the name of the temporary file and is
48 arbitrary. The output of index-pack is printed to stdout.
49
Andrew Ruder71e2e592007-04-26 23:59:02 -050050--recover::
51 Verify that everything reachable from target is fetched. Used after
52 an earlier fetch is interrupted.
53
David Greaves2cf565c2005-05-10 22:32:30 +010054GIT
55---
Christian Couder9e1f0a82008-06-06 09:07:32 +020056Part of the linkgit:git[1] suite