gitremote-helpers - 云端在线

程序：

您的姓名

gitremote-helpers - 与远程存储库交互的帮助程序

概要

混帐 偏僻的- [ ]

商品描述

远程帮助程序通常不被最终用户直接使用，但它们被调用
当需要与 Git 本身不支持的远程存储库交互时，可以使用 Git。 A
给定的助手将实现此处记录的功能的子集。 当 Git 需要时
要使用远程助手与存储库进行交互，它会生成助手作为
独立进程，将命令发送到助手的标准输入，并期望结果
来自助手的标准输出。 因为远程助手作为独立进程运行
从 Git 中，不需要重新链接 Git 来添加新的助手，也不需要链接
Git 实施的助手。

每个助手都必须支持“功能”命令，Git 使用该命令来确定要执行的操作
助手将接受的其他命令。 这些其他命令可用于发现和
更新远程引用，在对象数据库和远程之间传输对象
存储库，并更新本地对象存储。

Git 附带了一个“curl”远程助手家族，可以处理各种传输协议，
如 git-远程-http, git-远程-https, git 远程 ftp 和 git 远程 ftps。 他们
实施能力 取, 选项和 推.

召唤

远程帮助程序通过一个或（可选）两个参数来调用。 首先
参数指定一个远程存储库，如 Git 中一样； 它是配置的名称
远程或 URL。 第二个参数指定 URL； 它通常是这样的形式
://，但任何任意字符串都是可能的。 这 GIT_目录 环境
变量是为远程帮助程序设置的，可用于确定存储位置
其他数据或从哪个目录调用辅助 Git 命令。

当 Git 遇到以下形式的 URL 时 ://，在 Moku:Pro 上 是一个
它本身无法处理的协议，它会自动调用 混帐 偏僻的-
将完整的 URL 作为第二个参数。 如果直接在
命令行，第一个参数与第二个参数相同，如果在命令行中遇到
配置远程，第一个参数是该远程的名称。

表单的 URL :: 明确指示 Git 调用 混帐
偏僻的- - 作为第二个参数。 如果遇到这样的URL
直接在命令行上，第一个参数是 ，并且如果遇到
配置的遥控器，第一个参数是该遥控器的名称。

此外，当配置的遥控器具有 偏僻的。 .vcs 设置 , 吉特
显式调用 混帐 偏僻的- - 作为第一个参数。 如果设置，则
第二个参数是 偏僻的。 .url; 否则，第二个参数被省略。

INPUT FORMAT

Git 在标准输入上向远程助手发送一系列命令，每行一个。 首先
命令始终是 能力 命令，远程帮助者必须响应该命令
打印它支持的功能列表（见下文），后跟一个空行。 这
对功能命令的响应决定了 Git 在其余部分中使用哪些命令
命令流。

命令流以空行终止。 在某些情况下（在
相关命令的文档），这个空行后面跟着一些有效负载
其他协议（例如，pack 协议），而在其他协议中，它表示输入结束。

能力
每个远程帮助程序预计仅支持命令的子集。 操作一
在对功能命令的响应中向 Git 声明助手支持（请参阅
命令，如下）。

下面，我们列出了所有已定义的功能，并为每个功能列出了哪些命令
必须提供具有该能力的帮助者。

能力 HPMC胶囊 推动
联接
可以尝试连接到 混帐 接收包 （用于推动）， 混帐 上传包等对于
使用 git 的本机 packfile 协议进行通信。 这需要一个双向的、
全双工连接。

支持的命令： 联接.

推
可以发现远程引用并推送本地提交以及导致它们的历史记录
到新的或现有的远程参考。

支持的命令： 名单 推力, 推.

出口
可以发现远程引用并将指定对象从快速导入流推送到
远程参考。

支持的命令： 名单 推力, 出口.

如果帮手打广告 联接，如果可能，Git 将使用它并回退到另一个
如果助手在连接时请求的话，则具有能力（请参阅 联接 下命令
命令）。 当选择之间 推 和 出口, Git 更喜欢 推。 其他前端
可能有其他一些优先顺序。

无私人更新
使用时 参考规范 能力，git 通常会更新私有引用
成功推送。 当远程帮助程序声明
能力 无私人更新.

能力 HPMC胶囊 正在取得
联接
可以尝试连接到 混帐 上传包 （用于获取）， 混帐 接收包等对于
使用 Git 的本机 packfile 协议进行通信。 这需要一个
双向、全双工连接。

支持的命令： 联接.

取
可以发现远程引用并将可访问的对象传输到本地
对象存储。

支持的命令： 名单, 取.

进口
可以发现远程引用和可从它们作为流访问的输出对象
快速导入格式。

支持的命令： 名单, 进口.

检查连通性
可以保证当请求克隆时，收到的包是独立的
并且已连接。

如果帮手打广告 联接，如果可能，Git 将使用它并回退到另一个
如果助手在连接时请求的话，则具有能力（请参阅 联接 下命令
命令）。 当选择之间 取 和 进口, Git 更喜欢 取。 其他前端
可能有其他一些优先顺序。

其他 能力
选项
用于指定详细程度（写入 stderr 的输出量）等设置以及
深度（在浅克隆的情况下需要多少历史记录）会影响如何
执行其他命令。

参考规范
对于实施的远程帮助者 进口 or 出口，这种能力允许
refs 被限制在私有命名空间中，而不是写入 refs/heads 或
直接参考/遥控器。 建议所有提供以下信息的进口商 进口
能力使用这个。 这是强制性的 出口.

宣传功能 refspec 的助手
refs/heads/*:refs/svn/origin/branches/* 是说，当要求导入时
refs/heads/topic，它输出的流将更新
refs/svn/origin/branches/topic ref。

此功能可以多次宣传。 第一个适用的参考规范
优先。 具有此功能的参考规范的左侧必须
覆盖 list 命令报告的所有引用。 如果不 参考规范 能力是
广告中，有一个隐含的参考规范 *:*。

当为去中心化版本控制系统编写远程帮助程序时，
建议保留存储库的本地副本以进行交互，并让
私有名称空间 refs 指向此本地存储库，而 refs/remotes
命名空间用于跟踪远程存储库。

比迪进口
这修改了 进口 能力。 快速导入命令 猫团 和 ls 能够
被远程帮助者用来检索有关 blob 和树的信息
已经存在于快速导入的内存中。 这就需要一个从快速导入到
远程助手。 如果除了“导入”之外还进行了广告，Git 会建立一个
从快速导入到远程帮助程序的标准输入的管道。 由此可见，Git 和
fast-import 都连接到远程助手的标准输入。 因为Git可以发送
向远程帮助程序发送多个命令，需要使用的帮助程序
比迪进口 全部缓冲 进口 发送数据之前的一批命令
快速导入。 这是为了防止混合命令和快速导入响应
助手的标准输入。

出口标志
这修改了 出口 功能，指示 Git 转储内部标记
表到完成时。 有关详细信息，请阅读 --export-marks= in
git 快速导出（1）。

进口标记
这修改了 出口 能力，指示 Git 加载指定的标记
在在处理任何输入之前。 有关详细信息，请阅读
--import-marks= in git 快速导出（1）。

签名标签
这修改了 出口 能力，指示Git通过
--signed-tags=逐字记录 至 git 快速导出(1). 在没有这种能力的情况下，
git 将使用 --signed-tags=警告条.

指令

命令由调用者在助手的标准输入上给出，每行一个。

能力
列出帮助程序的功能，每行一项，以空行结尾。 每个
能力之前可以是 *，这使得它们对于使用的 Git 版本是强制性的
远程助手了解一下。 任何未知的强制能力都是致命错误。

必须支持该命令。

名单
列出参考文献，每行一个，格式为“ [ ...]“。 价值
可能是十六进制 sha1 哈希值，“@ ” 表示符号引用，或“?” 表示帮助器
无法获取 ref 的值。 后面是一个以空格分隔的属性列表
姓名; 无法识别的属性将被忽略。 该列表以空行结尾。

有关当前定义的属性的列表，请参阅参考列表属性。

如果助手具有“获取”或“导入”功能，则受支持。

名单 推力
像 名单，除了当且仅当调用者想要
生成的参考列表来准备推送命令。 支持推送和获取的助手
可以用它来区分哪个操作的输出 名单 将是
使用，可能会减少需要执行的工作量。

如果助手具有“推送”或“导出”功能，则支持。

选项
设置传输助手选项到。 输出一行包含
之一 ok （选项成功设置）， 不支持 （选项无法识别）或 错误
（选项受支持，但是对其无效）。 选项应该是
在其他命令之前设置，并可能影响这些命令的行为。

有关当前定义的选项的列表，请参阅选项。

如果助手具有“选项”功能，则支持。

取
获取给定的对象，将必要的对象写入数据库。 拿来
命令是批量发送的，每行一个，以空行结束。 输出一个
当同一批次中的所有获取命令完成时，单个空行。 仅对象
其输出中报告了 名单 使用 sha1 可以通过这种方式获取。

可以选择输出一个 锁 指示 GIT_DIR/objects/pack 下的文件的行
它会保留一个包，直到参考可以适当更新。

如果选项 检查连通性 被请求时，助手必须输出 连接正常 if
克隆是独立且相互连接的。

如果助手具有“获取”功能，则受支持。

推 + :
推送给定的本地提交或分支到由描述的远程分支。
一个或多个的批次序列 推 命令以空行终止（如果
只有一个对推送的引用，一个 推 命令后跟一个空格
线）。 例如，以下是两批 推，第一个询问的是
远程助手推送本地引用 主 到远程参考 主 和当地的 校长
到遥控器 科，第二个请求推送 ref FOO 参考 酒吧 （强制更新
被要求 +).

推送 refs/heads/master:refs/heads/master
推送 HEAD：refs/heads/branch
\n
推 +refs/heads/foo:refs/heads/bar
\n

在最后一个协议选项之后可以输入零个或多个协议选项 推 命令，在
批处理的终止空行。

当推送完成后，输出一个或多个 ok or 错误 ？ 生产线
指示每个推送的引用成功或失败。 状态报告输出为
以空行终止。 选项字段可以在 C 风格字符串中引用
如果它包含 LF。

如果助手具有“推送”功能，则支持。

进口
生成一个快速导入流，导入指定引用的当前值。 它可能
另外根据需要导入其他参考以有效构建历史记录。 这
脚本写入特定于帮助程序的私有命名空间。 指定引用的值
应写入通过应用 refspec 派生的此名称空间中的位置
从“refspec”功能到参考名称。

对于与外国版本控制系统的互操作性特别有用。

就像 推，一个或多个的批序列 进口 以空白终止
线。 对于每批 进口，远程助手应该生成一个快速导入流
终止于 完成 命令。

请注意，如果 比迪进口 使用的能力必须是完整的批次序列
在开始发送数据到快速导入之前进行缓冲，以防止命令和命令的混合
在助手的标准输入上快速导入响应。

如果助手具有“导入”功能，则支持。

出口
指示远程帮助程序任何后续输入都是快速导入流的一部分
（由生成 混帐 快速出口）包含应推送到的对象
远程。

对于与外国版本控制系统的互操作性特别有用。

这个 出口标志 和 进口标记 功能（如果指定）会影响此命令
只要它们被传递到 混帐 快速出口，然后将加载/存储一个表
本地对象的标记。 这可以用来实现增量操作。

如果助手具有“导出”功能，则支持。

联接
连接到给定的服务。 helper的标准输入和标准输出连接
到指定的服务（服务名称中包含 git 前缀，因此例如获取使用
git上传包 作为服务）在远程端。 该命令的有效回复为空
线路（已建立连接）， 后备 （没有智能传输支持，退回到哑
传输）并退出并打印错误消息（无法连接，请勿打扰
试图后退）。 换行终止正（空）响应后，
服务开始输出。 连接结束后，远程助手退出。

如果助手具有“连接”功能，则支持。

如果发生致命错误，程序会将错误消息写入 stderr 并退出。 这
如果子进程关闭，调用者应该期望已打印出合适的错误消息
在没有完成当前命令的有效响应的情况下连接。

可以支持附加命令，这可以根据报告的功能确定
帮手。

号 清单 ATTRIBUTES

这个 名单 命令生成一个引用列表，其中每个引用后面可能跟着一个列表
属性。 定义了以下引用列表属性。

不变
该引用自上次导入或获取以来没有变化，尽管助手不能
必然决定产生什么价值。

配置

以下选项由 Git 定义和（在适当的情况下）设置，如果
远程助手有 选项 能力。

选项 冗长
更改帮助程序显示的消息的详细程度。 值为 0 时方法
该进程安静地运行，并且帮助器仅产生错误输出。 1 是
默认的详细级别，以及更高的值对应-v的个数
在命令行上传递的标志。

选项 成果进展 {true|false}
启用（或禁用）传输帮助程序在传输过程中显示的进度消息
命令。

选项 深度
加深浅层存储库的历史。

选项 关注标签 {true|false}
如果启用，则帮助程序应自动获取带注释的标签对象（如果该对象
标记点 at 是在获取命令期间传输的。 如果未获取标签
助手通常会发送第二个获取命令来请求标签
具体来说。 一些助手可能能够使用此选项来避免第二个网络
连接。

选项 试运行 {true|false}：如果为真，则假装操作成功完成，但是
实际上并不更改任何存储库数据。 对于大多数助手来说，这仅适用于 推,
如果支持。

选项 服务路径
设置下次连接的服务路径（--upload-pack、--receive-pack 等）。 远程助手
可以支持此选项，但不得依赖在连接之前设置的此选项
请求发生。

选项 检查连通性 {true|false}
请求助手检查克隆的连接性。

选项 力 {true|false}
请求助手执行强制更新。 默认为 false.

选项 克隆 {'真的|false}
通知助手这是一个克隆请求（即保证当前存储库
空的）。

选项 更新浅层 {'真的|false}
如果新的参考文献需要，允许扩展 .git/shallow 。

选项 推送证书 {'真的|false}
GPG 标志推动。

使用 onworks.net 服务在线使用 gitremote-helpers