blob: 4ec7c68d3b9ecd18b3358563c2c1de4addff6eb0 [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]
Jean-Noël Avila77062942021-11-06 19:48:55 +010012'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>::
Elijah Newrencf6cac22023-10-08 06:45:03 +000034 Writes the commit-id into the specified 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>::
Jonathan Tan27e35ba2021-02-22 11:20:07 -080044 For internal use only. Instead of a commit id on the command
45 line (which is not expected in
Jonathan Tan8d5d2a32020-06-10 13:57:18 -070046 this case), 'git http-fetch' fetches the packfile directly at the given
47 URL and uses index-pack to generate corresponding .idx and .keep files.
48 The hash is used to determine the name of the temporary file and is
Jonathan Tan27e35ba2021-02-22 11:20:07 -080049 arbitrary. The output of index-pack is printed to stdout. Requires
50 --index-pack-args.
51
52--index-pack-args=<args>::
53 For internal use only. The command to run on the contents of the
54 downloaded pack. Arguments are URL-encoded separated by spaces.
Jonathan Tan8d5d2a32020-06-10 13:57:18 -070055
Andrew Ruder71e2e592007-04-26 23:59:02 -050056--recover::
57 Verify that everything reachable from target is fetched. Used after
58 an earlier fetch is interrupted.
59
David Greaves2cf565c2005-05-10 22:32:30 +010060GIT
61---
Christian Couder9e1f0a82008-06-06 09:07:32 +020062Part of the linkgit:git[1] suite