man1/git-http-fetch.1

   1 '\" t
   2 .\"     Title: git-http-fetch
   3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
   5 .\"      Date: 2024-09-18
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.46.1.565.g6531f31ef3
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-HTTP\-FETCH" "1" "2024-09-18" "Git 2\&.46\&.1\&.565\&.g6531f3" "Git Manual"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 git-http-fetch \- Download from a remote Git repository via HTTP
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 \fIgit http\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w <filename>] [\-\-recover] [\-\-stdin | \-\-packfile=<hash> | <commit>] <URL>
  36 .fi
  37 .SH "DESCRIPTION"
  38 .sp
  39 Downloads a remote Git repository via HTTP\&.
  40 .sp
  41 This command always gets all objects\&. Historically, there were three options \fB\-a\fR, \fB\-c\fR and \fB\-t\fR for choosing which objects to download\&. They are now silently ignored\&.
  42 .SH "OPTIONS"
  43 .PP
  44 commit\-id
  45 .RS 4
  46 Either the hash or the filename under [URL]/refs/ to pull\&.
  47 .RE
  48 .PP
  49 \-a, \-c, \-t
  50 .RS 4
  51 These options are ignored for historical reasons\&.
  52 .RE
  53 .PP
  54 \-v
  55 .RS 4
  56 Report what is downloaded\&.
  57 .RE
  58 .PP
  59 \-w <filename>
  60 .RS 4
  61 Writes the commit\-id into the specified filename under $GIT_DIR/refs/<filename> on the local end after the transfer is complete\&.
  62 .RE
  63 .PP
  64 \-\-stdin
  65 .RS 4
  66 Instead of a commit id on the command line (which is not expected in this case),
  67 \fIgit http\-fetch\fR
  68 expects lines on stdin in the format
  69 .sp
  70 .if n \{\
  71 .RS 4
  72 .\}
  73 .nf
  74 <commit\-id>[\*(Aq\et\*(Aq<filename\-as\-in\-\-w>]
  75 .fi
  76 .if n \{\
  77 .RE
  78 .\}
  79 .RE
  80 .PP
  81 \-\-packfile=<hash>
  82 .RS 4
  83 For internal use only\&. Instead of a commit id on the command line (which is not expected in this case),
  84 \fIgit http\-fetch\fR
  85 fetches the packfile directly at the given URL and uses index\-pack to generate corresponding \&.idx and \&.keep files\&. The hash is used to determine the name of the temporary file and is arbitrary\&. The output of index\-pack is printed to stdout\&. Requires \-\-index\-pack\-args\&.
  86 .RE
  87 .PP
  88 \-\-index\-pack\-args=<args>
  89 .RS 4
  90 For internal use only\&. The command to run on the contents of the downloaded pack\&. Arguments are URL\-encoded separated by spaces\&.
  91 .RE
  92 .PP
  93 \-\-recover
  94 .RS 4
  95 Verify that everything reachable from target is fetched\&. Used after an earlier fetch is interrupted\&.
  96 .RE
  97 .SH "GIT"
  98 .sp
  99 Part of the \fBgit\fR(1) suite