Autogenerated manpages for v2.44.0-rc1-17-g3e0d3
[git-manpages.git] / man1 / git-upload-pack.1
blobbffb5470833ba67c920c7c70b365e5ee7a9c1a29
1 '\" t
2 .\"     Title: git-upload-pack
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-02-15
6 .\"    Manual: Git Manual
7 .\"    Source: Git 2.44.0.rc1.17.g3e0d3cd5c7
8 .\"  Language: English
9 .\"
10 .TH "GIT\-UPLOAD\-PACK" "1" "2024\-02\-15" "Git 2\&.44\&.0\&.rc1\&.17\&.g3" "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-upload-pack \- Send objects packed back to git\-fetch\-pack
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 \fIgit\-upload\-pack\fR [\-\-[no\-]strict] [\-\-timeout=<n>] [\-\-stateless\-rpc]
36                   [\-\-advertise\-refs] <directory>
37 .fi
38 .sp
39 .SH "DESCRIPTION"
40 .sp
41 Invoked by \fIgit fetch\-pack\fR, learns what objects the other side is missing, and sends them after packing\&.
42 .sp
43 This command is usually not invoked directly by the end user\&. The UI for the protocol is on the \fIgit fetch\-pack\fR side, and the program pair is meant to be used to pull updates from a remote repository\&. For push operations, see \fIgit send\-pack\fR\&.
44 .SH "OPTIONS"
45 .PP
46 \-\-[no\-]strict
47 .RS 4
48 Do not try <directory>/\&.git/ if <directory> is not a Git directory\&.
49 .RE
50 .PP
51 \-\-timeout=<n>
52 .RS 4
53 Interrupt transfer after <n> seconds of inactivity\&.
54 .RE
55 .PP
56 \-\-stateless\-rpc
57 .RS 4
58 Perform only a single read\-write cycle with stdin and stdout\&. This fits with the HTTP POST request processing model where a program may read the request, write a response, and must exit\&.
59 .RE
60 .PP
61 \-\-http\-backend\-info\-refs
62 .RS 4
63 Used by
64 \fBgit-http-backend\fR(1)
65 to serve up
66 \fB$GIT_URL/info/refs?service=git\-upload\-pack\fR
67 requests\&. See "Smart Clients" in
68 \fBgitprotocol-http\fR(5)
69 and "HTTP Transport" in the
70 \fBgitprotocol-v2\fR(5)
71 documentation\&. Also understood by
72 \fBgit-receive-pack\fR(1)\&.
73 .RE
74 .PP
75 <directory>
76 .RS 4
77 The repository to sync from\&.
78 .RE
79 .SH "ENVIRONMENT"
80 .PP
81 \fBGIT_PROTOCOL\fR
82 .RS 4
83 Internal variable used for handshaking the wire protocol\&. Server admins may need to configure some transports to allow this variable to be passed\&. See the discussion in
84 \fBgit\fR(1)\&.
85 .RE
86 .SH "SEE ALSO"
87 .sp
88 \fBgitnamespaces\fR(7)
89 .SH "GIT"
90 .sp
91 Part of the \fBgit\fR(1) suite