2006-09-07 13:12:05 +00:00
|
|
|
git-upload-archive(1)
|
|
|
|
====================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2007-01-18 23:53:37 +00:00
|
|
|
git-upload-archive - Send archive back to git-archive
|
2006-09-07 13:12:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2011-07-02 02:38:26 +00:00
|
|
|
[verse]
|
2008-06-30 06:09:04 +00:00
|
|
|
'git upload-archive' <directory>
|
2006-09-07 13:12:05 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2010-01-09 23:33:00 +00:00
|
|
|
Invoked by 'git archive --remote' and sends a generated archive to the
|
2013-01-21 19:17:53 +00:00
|
|
|
other end over the Git protocol.
|
2006-09-07 13:12:05 +00:00
|
|
|
|
|
|
|
This command is usually not invoked directly by the end user. The UI
|
2010-01-09 23:33:00 +00:00
|
|
|
for the protocol is on the 'git archive' side, and the program pair
|
2006-09-07 13:12:05 +00:00
|
|
|
is meant to be used to get an archive from a remote repository.
|
|
|
|
|
2014-02-28 10:01:29 +00:00
|
|
|
SECURITY
|
|
|
|
--------
|
|
|
|
|
|
|
|
In order to protect the privacy of objects that have been removed from
|
|
|
|
history but may not yet have been pruned, `git-upload-archive` avoids
|
|
|
|
serving archives for commits and trees that are not reachable from the
|
|
|
|
repository's refs. However, because calculating object reachability is
|
|
|
|
computationally expensive, `git-upload-archive` implements a stricter
|
|
|
|
but easier-to-check set of rules:
|
|
|
|
|
|
|
|
1. Clients may request a commit or tree that is pointed to directly by
|
|
|
|
a ref. E.g., `git archive --remote=origin v1.0`.
|
|
|
|
|
|
|
|
2. Clients may request a sub-tree within a commit or tree using the
|
|
|
|
`ref:path` syntax. E.g., `git archive --remote=origin v1.0:Documentation`.
|
|
|
|
|
|
|
|
3. Clients may _not_ use other sha1 expressions, even if the end
|
|
|
|
result is reachable. E.g., neither a relative commit like `master^`
|
|
|
|
nor a literal sha1 like `abcd1234` is allowed, even if the result
|
|
|
|
is reachable from the refs.
|
|
|
|
|
|
|
|
Note that rule 3 disallows many cases that do not have any privacy
|
|
|
|
implications. These rules are subject to change in future versions of
|
|
|
|
git, and the server accessed by `git archive --remote` may or may not
|
|
|
|
follow these exact rules.
|
|
|
|
|
2006-09-07 13:12:05 +00:00
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
<directory>::
|
|
|
|
The repository to get a tar archive from.
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|