|
|
|
git-send-pack(1)
|
|
|
|
================
|
|
|
|
v0.1, July 2005
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
git-send-pack - Push missing objects packed.
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
'git-send-pack' [--all] [--exec=<git-receive-pack>] [<host>:]<directory> [<head>...]
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
Invokes 'git-receive-pack' on a possibly remote repository, and
|
|
|
|
updates it from the current repository, sending named heads.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
--exec=<git-receive-pack>::
|
|
|
|
Path to the 'git-receive-pack' program on the remote
|
|
|
|
end. Sometimes useful when pushing to a remote
|
|
|
|
repository over ssh, and you do not have the program in
|
|
|
|
a directory on the default $PATH.
|
|
|
|
|
|
|
|
--all::
|
|
|
|
Instead of explicitly specifying which refs to update,
|
|
|
|
update all refs that locally exist.
|
|
|
|
|
|
|
|
<host>::
|
|
|
|
A remote host to house the repository. When this
|
|
|
|
part is specified, 'git-receive-pack' is invoked via
|
|
|
|
ssh.
|
|
|
|
|
|
|
|
<directory>::
|
|
|
|
The repository to update.
|
|
|
|
|
|
|
|
<head>...:
|
|
|
|
The remote refs to update.
|
|
|
|
|
|
|
|
|
|
|
|
Specifying the Refs
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
There are three ways to specify which refs to update on the
|
|
|
|
remote end.
|
|
|
|
|
|
|
|
With '--all' flag, all refs that exist locally are transfered to
|
|
|
|
the remote side. You cannot specify any '<head>' if you use
|
|
|
|
this flag.
|
|
|
|
|
|
|
|
Without '--all' and without any '<head>', the refs that exist
|
|
|
|
both on the local side and on the remote side are updated.
|
|
|
|
|
|
|
|
When '<head>'s are specified explicitly, it can be either a
|
|
|
|
single pattern, or a pair of such pattern separated by a colon
|
|
|
|
':' (this means that a ref name cannot have a colon in it). A
|
|
|
|
single pattern '<name>' is just a shorthand for '<name>:<name>'.
|
|
|
|
Each pattern pair consists of the source side (before the colon)
|
|
|
|
and the destination side (after the colon). The ref that is
|
|
|
|
pushed is determined by finding a match that matches the source
|
|
|
|
side, and where it is pushed is determined by using the
|
|
|
|
destination side.
|
|
|
|
|
|
|
|
- It is an error if <src> does not match exactly one of local
|
|
|
|
refs.
|
|
|
|
|
|
|
|
- It is an error if <dst> matches more than one remote refs.
|
|
|
|
|
|
|
|
- If <dst> does not match any remote ref, either
|
|
|
|
|
|
|
|
- it has to start with "refs/"; <dst> is used as the
|
|
|
|
destination literally in this case.
|
|
|
|
|
|
|
|
- <src> == <dst> and the ref that matched the <src> must not
|
|
|
|
exist in the set of remote refs; the ref matched <src>
|
|
|
|
locally is used as the name of the destination.
|
|
|
|
|
|
|
|
|
|
|
|
Author
|
|
|
|
------
|
|
|
|
Written by Linus Torvalds <torvalds@osdl.org>
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
--------------
|
|
|
|
Documentation by Junio C Hamano.
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
|
|
|
Part of the link:git.html[git] suite
|