logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

git-http-fetch.1 (3211B)


  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: 2025-03-14
  6. .\" Manual: Git Manual
  7. .\" Source: Git 2.49.0
  8. .\" Language: English
  9. .\"
  10. .TH "GIT\-HTTP\-FETCH" "1" "2025-03-14" "Git 2\&.49\&.0" "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