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