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 vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 2024-05-28
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.45.1.313.g3a57aa566a
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-HTTP\-FETCH" "1" "2024\-05\-28" "Git 2\&.45\&.1\&.313\&.g3a57aa" "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 .sp
  38 .SH "DESCRIPTION"
  39 .sp
  40 Downloads a remote Git repository via HTTP\&.
  41 .sp
  42 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\&.
  43 .SH "OPTIONS"
  44 .PP
  45 commit\-id
  46 .RS 4
  47 Either the hash or the filename under [URL]/refs/ to pull\&.
  48 .RE
  49 .PP
  50 \-a, \-c, \-t
  51 .RS 4
  52 These options are ignored for historical reasons\&.
  53 .RE
  54 .PP
  55 \-v
  56 .RS 4
  57 Report what is downloaded\&.
  58 .RE
  59 .PP
  60 \-w <filename>
  61 .RS 4
  62 Writes the commit\-id into the specified filename under $GIT_DIR/refs/<filename> on the local end after the transfer is complete\&.
  63 .RE
  64 .PP
  65 \-\-stdin
  66 .RS 4
  67 Instead of a commit id on the command line (which is not expected in this case),
  68 \fIgit http\-fetch\fR
  69 expects lines on stdin in the format
  70 .sp
  71 .if n \{\
  72 .RS 4
  73 .\}
  74 .nf
  75 <commit\-id>[\*(Aq\et\*(Aq<filename\-as\-in\-\-w>]
  76 .fi
  77 .if n \{\
  78 .RE
  79 .\}
  80 .RE
  81 .PP
  82 \-\-packfile=<hash>
  83 .RS 4
  84 For internal use only\&. Instead of a commit id on the command line (which is not expected in this case),
  85 \fIgit http\-fetch\fR
  86 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\&.
  87 .RE
  88 .PP
  89 \-\-index\-pack\-args=<args>
  90 .RS 4
  91 For internal use only\&. The command to run on the contents of the downloaded pack\&. Arguments are URL\-encoded separated by spaces\&.
  92 .RE
  93 .PP
  94 \-\-recover
  95 .RS 4
  96 Verify that everything reachable from target is fetched\&. Used after an earlier fetch is interrupted\&.
  97 .RE
  98 .SH "GIT"
  99 .sp
 100 Part of the \fBgit\fR(1) suite