Merge branch 'rs/archive-plug-leak-refname'
[git] / Documentation / git-http-fetch.txt
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, -c, -t::
29         These options are ignored for historical reasons.
30 -v::
31         Report what is downloaded.
32
33 -w <filename>::
34         Writes the commit-id into the filename under $GIT_DIR/refs/<filename> on
35         the local end after the transfer is complete.
36
37 --stdin::
38         Instead of a commit id on the command line (which is not expected in this
39         case), 'git http-fetch' expects lines on stdin in the format
40
41                 <commit-id>['\t'<filename-as-in--w>]
42
43 --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
50 --recover::
51         Verify that everything reachable from target is fetched.  Used after
52         an earlier fetch is interrupted.
53
54 GIT
55 ---
56 Part of the linkgit:git[1] suite