简体中文 ▾ 主题 ▾ 最新版本 ▾ git-send-pack 上次更新于 2.43.0

名称

git-send-pack - 通过 Git 协议向另一个仓库推送对象

概要

git send-pack [--mirror] [--dry-run] [--force]
		[--receive-pack=<git-receive-pack>]
		[--verbose] [--thin] [--atomic]
		[--[no-]signed | --signed=(true|false|if-asked)]
		[<host>:]<directory> (--all | <ref>…​)

描述

通常你会想使用 git push,它是这个命令的高级封装。请参阅 git-push[1]

在可能的远程仓库上调用 git-receive-pack,并从当前仓库更新它,发送指定引用。

选项

--receive-pack=<git-receive-pack>

远程端 git-receive-pack 程序的路径。当通过 ssh 推送到远程仓库,并且程序不在默认的 $PATH 目录中时,此选项有时很有用。

--exec=<git-receive-pack>

与 --receive-pack=<git-receive-pack> 相同。

--all

不显式指定要更新的引用,而是更新所有本地存在的头部(heads)。

--stdin

从标准输入(stdin)获取引用列表,每行一个。如果除了此选项外,命令行上也指定了引用,则标准输入中的引用将在命令行上的引用处理之后进行处理。

如果 --stateless-rpc 与此选项一起指定,则引用列表必须是包格式(pkt-line)。每个引用必须在一个单独的包中,并且列表必须以一个刷新包(flush packet)结束。

--dry-run

执行所有操作,但实际上不发送更新。

--force

通常,命令会拒绝更新不是用于覆盖它的本地引用祖先的远程引用。此标志禁用该检查。这意味着远程仓库可能会丢失提交;请谨慎使用。

--verbose

运行详细模式。

--thin

发送一个“thin”包,它以基于未包含在包中的对象进行增量化(deltified)的形式记录对象,以减少网络流量。

--atomic

使用原子事务更新引用。如果任何引用更新失败,则整个推送将失败,不会更改任何引用。

--[no-]signed
--signed=(true|false|if-asked)

对推送请求进行 GPG 签名,以更新接收端的引用,以便钩子可以检查和/或记录。如果 false--no-signed,将不尝试签名。如果 true--signed,如果服务器不支持签名推送,则推送将失败。如果设置为 if-asked,则仅当服务器支持签名推送时才签名。如果实际调用 gpg --sign 失败,推送也将失败。有关接收端的详细信息,请参阅 git-receive-pack[1]

--push-option=<string>

将指定的字符串作为推送选项传递,供服务器端的钩子使用。如果服务器不支持推送选项,则报错。有关详细信息,请参阅 git-push[1]githooks[5]

<host>

托管仓库的远程主机。指定此部分时,git-receive-pack 会通过 ssh 调用。

<directory>

要更新的仓库。

<ref>…​

要更新的远程引用。

指定引用

有三种方法可以指定要更新远程端的引用。

使用 --all 标志时,所有本地存在的引用都会传输到远程端。如果使用此标志,则不能指定任何 <ref>

在不使用 --all 且不带任何 <ref> 的情况下,同时存在于本地和远程的头部(heads)会被更新。

当明确指定一个或多个 <ref>(无论是通过命令行还是通过 --stdin)时,它可以是一个单独的模式,或者是两个由冒号 ":" 分隔的模式(这意味着引用名称不能包含冒号)。单个模式 <name> 只是 <name>:<name> 的简写。

每个模式对都包含源端(冒号前)和目标端(冒号后)。要推送的引用通过查找与源端匹配的引用来确定,其推送位置由目标端确定。用于匹配引用的规则与 git rev-parse 解析符号引用名称的规则相同。请参阅 git-rev-parse[1]

  • 如果 <src> 未完全匹配一个本地引用,则会报错。

  • 如果 <dst> 匹配多个远程引用,则会报错。

  • 如果 <dst> 未匹配任何远程引用,则:

    • 它必须以 "refs/" 开头;在这种情况下,<dst> 将被字面用作目标。

    • <src> == <dst> 且匹配 <src> 的引用必须不存在于远程引用集中;本地匹配 <src> 的引用将用作目标的名称。

在不带 --force 的情况下,仅当 <dst> 不存在,或者 <dst> 是 <src> 的一个适当子集(即祖先)时,<src> 引用才会被存储到远程。此检查(称为“快进检查”)旨在避免意外覆盖远程引用并丢失其中其他人的提交。

使用 --force 时,所有引用的快进检查都被禁用。

可选地,<ref> 参数可以加一个加号 + 前缀,以仅在该引用上禁用快进检查。

GIT

Git[1] 套件的一部分

scroll-to-top