git-annex - 云端在线

程序：

您的姓名

git-annex - 使用 git 管理文件，而不检查它们的内容

概要

git 附件命令 [参数 ...]

商品描述

git-annex 允许使用 git 管理文件，而无需将文件内容检查到 git 中。
虽然这看起来很矛盾，但在处理大于 git 的文件时很有用
当前易于处理，无论是由于内存、校验和时间或磁盘的限制
空间。

即使没有文件内容跟踪，也能够使用 git 管理文件，移动文件
删除带有版本化目录树的文件，并使用分支和分布式克隆，
都是使用 git 的非常方便的理由。 并且附加的文件可以共存于同一个 git 中
具有定期版本化文件的存储库，便于维护文档，
与附件文件相关但受益于完整修订的 Makefile 等
控制。

当一个文件被附加时，它的内容被移动到一个键值存储中，并建立一个符号链接
即指向内容。 这些符号链接被检入 git 并像常规一样进行版本控制
文件。 您可以移动它们、删除它们等等。 推送到另一个 git 存储库
将使 git-annex 知道附件文件，它可以用来检索它的
来自键值存储的内容。

示例

# git附件获取视频/hackity_hack_and_kaxxt.mov
获取视频/hackity_hack_and_kaxxt.mov（不可用）
我无法访问这些遥控器：服务器
尝试使其中一些存储库可用：
5863d8c0-d9a9-11df-adb2-af51e6559a49——我的家庭文件服务器
58d84e8a-d9ae-11df-a1aa-ab9aa8c00826 -- portable USB drive
ca20064c-dbb5-11df-b2fe-002170d25c55 -- 备份SATA驱动器
失败
# sudo 挂载 /media/usb
# git 远程添加 usbdrive /media/usb
# git附件获取视频/hackity_hack_and_kaxxt.mov
获取视频/hackity_hack_and_kaxxt.mov（来自usbdrive...）好的

#git附件添加iso
添加iso/Debian_5.0.iso ok

# git附件删除iso/Debian_4.0.iso
删除iso/Debian_4.0.iso ok

# git附件移动iso --to=usbdrive
移动 iso/Debian_5.0.iso（移动到 USB 驱动器...） ok

常见的 用过的 指令

像许多 git 命令一样， git-annex 可以传递一个文件或一个路径
目录。 在后一种情况下，它作用于目录中的所有相关文件。 没有路的时候
指定后，大多数 git-annex 命令默认作用于目录中的所有相关文件
当前目录（和子目录）。

帮助 显示内置帮助。

有关特定命令的帮助，请使用 混帐 附件 帮助 命令

加 [小路 ...]
将路径中的文件添加到附件。 如果未指定路径，则从
当前目录及以下。

参见 git-附件-添加(1) 详情。

得到 [小路 ...]
使附加文件的内容在此存储库中可用。

参见 git-附件-get(1) 详情。

下降 [小路 ...]
从此存储库中删除附件文件的内容。

参见 git-附件-drop(1) 详情。

移动 [小路 ...] [--from=远程|--to=远程]
将文件内容从另一个遥控器移动或移到另一个遥控器。

参见 git-附件-移动(1) 详情。

复制 [小路 ...] [--from=远程|--to=远程]
将文件内容从另一个远程复制或复制到另一个远程。

参见 git-附件副本(1) 详情。

状态 [小路 ...]
像 混帐 状态 - 短的, 显示正在工作的文件的状态
树。 在直接模式下特别有用。

参见 git-附件状态(1) 详情。

开锁 [小路 ...]
解锁附件文件进行修改。

参见 git-附件解锁(1) 详情。

编辑 [小路 ...]
这是解锁命令的别名。 可能更容易记住，如果你想到
这允许您编辑附件文件。

锁 [小路 ...]
如果您不想修改文件，或者不想修改文件，请使用它来撤消解锁命令
进行了要放弃的修改。

参见 git-附件锁(1) 详情。

同步 [偏僻的 ...]
将本地存储库与遥控器同步。

参见 git-附件同步(1) 详情。

镜面 [小路 ...] [--to=远程|--from=远程]
将文件内容镜像到/从另一个存储库。

参见 git-附件镜像(1) 详情。

地址 [网址 ...]
将每个 url 下载到它自己的文件中，该文件被添加到附件中。

参见 git-附件地址(1) 详情。

网址 文件 网址
记录该文件在 url 上不再可用。

参见 git-附件-rmurl(1) 详情。

进口 [小路 ...]
将外部 git 工作副本中的文件移动并添加到附件中。

参见 git-附件导入(1) 详情。

进口饲料 [网址 ...]
将播客提要的内容导入附件。

参见 git-附件-importfeed(1) 详情。

复原 [文件名|目录] ...
撤消对文件或目录的最后更改。

参见 git-附件-撤消(1) 详情。

看 注意更改并自动提交。

参见 git-附件手表(1) 详情。

助理
在设备之间自动同步文件夹。

参见 git-annex-助手(1) 详情。

网络应用 打开一个 web 应用程序，它允许轻松设置 git-annex 存储库，并控制
git-annex 助手。 如果助手尚未运行，它将是
开始。

参见 git-附件-webapp(1) 详情。

存储库 设置 指令

初始化 [说明]

在存储库（或其远程之一）被初始化之前，git-annex 将
拒绝对其进行操作，以避免在已存在的存储库中意外使用它
不打算有附件。

参见 git-附件-初始化(1) 详情。

描述 知识库 描述
更改存储库的描述。

参见 git-附件-描述(1) 详情。

远程 姓名 类型=值 [参数=值 ...]
创建一个新的特殊遥控器，并将其添加到 .git/配置.

参见 git-附件-初始化远程(1) 详情。

启用远程 姓名 [参数=值 ...]
允许使用当前存储库中现有的特殊遥控器。

参见 git-附件-启用远程(1) 详情。

份数 [N]
配置所需的份数。

参见 git-附件-numcopies(1) 详情。

信托 [存储库 ...]
记录存储库被信任不会意外丢失内容。 与
照顾。

参见 git-附件-信任(1) 详情。

不信任 [存储库 ...]
记录存储库不受信任并且可能随时丢失内容。

参见 git-附件不信任(1) 详情。

半信托 [存储库 ...]
将存储库返回到默认的半信任状态。

参见 git-附件-半信任(1) 详情。

组 知识库 团队名字
将存储库添加到组。

参见 git-附件组(1) 详情。

取消分组 知识库 团队名字
从组中删除存储库。

参见 git-附件-取消组(1) 详情。

通缉 知识库 [表达]
获取或设置首选内容表达式。

参见 git-annex-通缉(1) 详情。

通缉犯 团队名字 [表达]
获取或设置 groupwanted 表达式。

参见 git-annex-group 需要(1) 详情。

必须 知识库 [表达]
获取或设置所需的内容表达式。

参见 需要 git-annex(1) 详情。

始你 知识库 [表达]
获取或设置预定作业。

参见 git-附件-时间表(1) 详情。

维克多 在包含大部分上述配置设置的临时文件上打开 EDITOR，如
以及其他一些，当它退出时，将所做的任何更改存储回 git-
附件分行。

参见 git-附件-vicfg(1) 详情。

直接 将存储库切换为使用直接模式，而不是文件的符号链接，
文件直接存在于存储库中。

参见 git-附件-直接(1) 详情。

间接
将存储库从直接模式切换回默认的间接模式。

参见 git-附件-间接(1) 详情。

存储库 维护 指令

fsck的 [小路 ...]

检查附件的一致性，并警告或修复发现的任何问题。 这是
很好的补充 混帐 fsck的.

参见 git-附件-fsck(1) 详情。

到期 [存储库：]时间 ...
使最近未执行活动（例如 fsck）的存储库到期。

参见 git-附件-过期(1) 详情。

未使用 检查附件中与任何标签中存在的任何文件都不对应的数据
或分支，并打印数据的编号列表。

参见 git-附件未使用(1) 详情。

未使用 [数字|范围 ...]
删除与数字对应的数据，如最后一个所列 混帐 附件 未使用

参见 git-附件-dropunused(1) 详情。

附加使用 [数字|范围 ...]
为与数字或范围对应的内容添加回文件，如所列
到最后 混帐 附件 未使用.

参见 git-附件-addunused(1) 详情。

固定 [小路 ...]
修复已损坏的符号链接再次指向附件内容。

参见 git-附件修复(1) 详情。

合并 自动合并来自遥控器的更改。

参见 git-附件-合并(1) 详情。

升级
将存储库升级到当前布局。

参见 git-附件升级(1) 详情。

死 [存储库 ...] [ - 钥匙 钥匙]
表示存储库或单个密钥已不可挽回地丢失。

参见 git-附件死(1) 详情。

忘记 导致 git-annex 分支被改写，丢掉历史数据
过去的文件位置。

参见 git-附件-忘记(1) 详情。

修复 这可以修复 git 存储库的许多问题 混帐 fsck的 检测，
但本身并没有修复。 如果存储库严重损坏，这很有用。 一
如果 git-annex 使用的存储库位于可移动驱动器上，就会发生这种情况
在错误的时间拔掉插头。

参见 git-附件修复(1) 详情。

QUERY 指令

发现 [小路 ...]

输出指定路径中的附件文件列表。 没有路径，查找文件
当前目录及其子目录。

参见 git附件查找(1) 详情。

哪里 [小路 ...]
显示有关文件内容所在位置的信息。

参见 git-附件-whereis(1) 详情。

名单 [小路 ...]
显示包含指定文件内容的遥控器表。 这个
与 whereis 类似，但显示更紧凑。

参见 git-附件列表(1) 详情。

日志 [小路 ...]
显示指定文件的位置日志，显示每个存储库
它们被添加到 ("+") 并从 ("-") 中删除。

参见 git-附件日志(1) 详情。

info [目录|文件|远程|uuid ...]
显示指定项目的统计信息和其他信息，可以是
目录、文件、远程或存储库的 uuid。

未指定项目时，显示存储库的统计信息和信息
作为一个整体。

参见 git-附件信息(1) 详情。

版本
显示 git-annex 的版本，以及存储库版本信息。

参见 git-附件版本(1) 详情。

地图 生成存储库映射。

参见 git-附件地图(1) 详情。

元数据 指令

元数据 [小路 ...]

附件文件的内容可以有任意数量的元数据字段附加到
它来描述它。 每个元数据字段又可以具有任意数量的值。

该命令可用于设置元数据，或显示当前设置的元数据。

参见 git-附件元数据(1) 详情。

查看 [标签 ...] [字段=值 ...] [字段=glob ...] [！标签 ...] [字段！=值 ...]
使用元数据构建当前分支中文件的视图分支，并检查
退出视图分支。 仅当前分支中元数据匹配所有文件
指定的字段值和标签将显示在视图中。

参见 git-附件视图(1) 详情。

流行音乐 [N]
从当前活动视图切换回上一个视图。 或者，从
第一次查看回到原始分支。

参见 git-附件-vpop(1) 详情。

过滤器 [标签 ...] [字段=值 ...] [！标签 ...] [字段！=值 ...]
将当前视图过滤为仅具有指定字段值和
标签。

参见 git-附件-vfilter(1) 详情。

瓦德 [字段=glob ...] [字段=值 ...] [标签 ...]
更改当前视图，添加额外级别的目录以进行分类
文件。

参见 git-附件-vfilter(1) 详情。

自行车 当视图涉及嵌套的子目录时，这会循环顺序。

参见 git-附件-vcycle(1) 详情。

UTILITY 指令

迁移 [小路 ...]

更改指定的附件文件以使用不同的键值后端。

参见 git-附件-迁移(1) 详情。

重新注射 SRC DEST
将 src 文件作为 dest 文件的内容移动到附件中。 这可以
如果您从其他地方获得了文件的内容并希望将其放入，则很有用
在当地的附件中。

参见 git-附件-重新注入(1) 详情。

附件 [小路 ...]
使用它来撤消意外 混帐 附件 加 命令。 它把文件放回原处
在添加之前。

参见 git-附件-unannex(1) 详情。

初始化 取消初始化 git-annex 并清理存储库。

参见 git-附件-uninit(1) 详情。

重新初始化 用户名|说明
初始化存储库，重用旧的 UUID。

参见 git-附件-重新初始化(1) 详情。

管道 指令

预先提交 [小路 ...]

这意味着从 git 的预提交钩子调用。 混帐 附件 初始化 自动
使用它创建一个预提交钩子。

参见 git-附件-预提交(1) 详情。

查找键 [文件 ...]
查找用于文件的密钥。

参见 git-附件-查找键(1) 详情。

内容定位 [钥匙 ..]
查找键的附件内容的位置。

参见 git-附件内容位置(1) 详情。

检查键 [钥匙 ...]
打印可以纯粹通过查看密钥确定的信息。

参见 git-附件-检查键(1) 详情。

从密钥 [钥匙 文件]
在 git 存储库中手动设置文件以链接到指定的密钥。

参见 git-附件-fromkey(1) 详情。

注册网址 [钥匙 网址]
为密钥注册一个 url。

参见 git-附件-注册网址(1) 详情。

设定键 键 文件
将文件作为键的内容移动到附件中。

参见 git-附件-setkey(1) 详情。

下拉键 [钥匙 ...]
删除指定键的附件内容。

参见 git-附件-dropkey(1) 详情。

传输密钥 键 [--from=远程|--to=远程]
从或向遥控器传输密钥。

参见 git-附件-传输密钥(1) 详情。

传输密钥
由助手内部使用。

参见 git-附件-传输密钥(1) 详情。

设置当前密钥 键 uid [1|0]
这个管道级别的命令改变了 git-annex 的关于指定的
密钥的内容存在于具有指定 uuid 的遥控器中。

参见 git-附件-setpresentkey(1) 详情。

读取当前密钥 键 uid
读取密钥所在位置的记录。

参见 git-附件-readpresentkey(1) 详情。

检查当前密钥 键 远程
检查遥控器中是否存在钥匙。

参见 git-附件-checkpresentkey(1) 详情。

密钥更新 [文件 键 ...]
更改用于文件的密钥。

参见 git-附件-rekey(1) 详情。

查找引用 [参考]
列出 git ref 中的文件。

参见 git-附件-findref(1) 详情。

代理 -- 混帐 CMD [选项]
仅在直接模式存储库中有用，这会使用指定的 git 命令运行
临时工作树，并更新工作树以反映任何上演或
由 git 命令提交。

参见 git-附件代理(1) 详情。

解析合并
通过将文件的两个冲突版本添加到
树，使用其文件名的变体。 这是在使用时自动完成的 混帐
附件 同步 or 混帐 附件 合并.

参见 git-附件-解决合并(1) 详情。

差速器
这可以用来制作 混帐 差异 使用带有附件文件的外部差异驱动程序。

参见 git-附件-diffdriver(1) 详情。

远程守护进程
检测网络遥控器何时收到 git push 和从他们那里获取。

参见 git-annex-remotedaemon(1) 详情。

xmppgit
该命令由助手内部使用，用于执行 git pull over XMPP。

参见 git-附件-xmppgit(1) 详情。

测试 指令

测试

这将运行 git-annex 的内置测试套件。

参见 git-附件测试(1) 详情。

测试遥控器 远程
这通过生成一些随机对象并将它们发送到遥控器来测试遥控器
远程，然后重新下载它们，从远程删除它们，等等。

在现有存储库中运行是安全的（存储库内容不是
更改），尽管它可能会执行昂贵的数据传输。

参见 git-附件测试远程(1) 详情。

模糊测试
对当前存储库中的文件生成随机更改，用于测试
助理。

参见 git-附件-模糊测试(1) 详情。

COMMON 配置

所有 git-annex 命令都接受这些通用选项，并且可能不会明确
列在他们各自的手册页上。 （许多命令也接受 混帐-
附件匹配选项（1）。）

- 力量
强制执行不安全的操作，例如在没有其他来源的情况下删除文件的内容
可以验证是否仍然存在，或添加忽略的文件。 小心使用。

- 快速地 启用一些命令的更便宜但也不太彻底的版本。 什么是
避免取决于命令。

- 安静的
避免默认的详细显示已完成的操作； 只显示错误。

--详细
启用详细显示。

-调试
显示调试消息。

--无调试
禁用调试消息。

--numcopies=n
覆盖 numcopies 设置，强制 git-annex 确保指定的数量
的副本存在。

请注意，将 numcopies 设置为 0 非常不安全。

--time-limit=时间
限制 git-annex 命令运行的时间。 时间可以是“5h”之类的，或者
“30m”甚至“45s”或“10d”。

请注意 git-annex 可能会继续运行超过指定的时间限制，在
以完成处理文件。

另外，请注意，如果时间限制阻止 git-annex 执行所有要求
到，它将以特殊代码 101 退出。

--trust=存储库

--semitrust=存储库

--untrust=存储库
覆盖存储库的信任设置。 可以多次指定。

应该使用配置的远程名称指定存储库，或者
存储库的 UUID 或描述。

--信任冰川库存
Amazon Glacier 库存需要数小时才能检索，并且可能不代表
存储库的当前状态。 所以 git-annex 不信任那些文件
冰川中的库存索赔确实存在。 此开关可用于允许
它信任库存。

小心使用它，特别是如果您或其他人最近可能
从 Glacier 中删除了一个文件。 如果您尝试删除文件的唯一其他副本，
并且此开关已启用，您可能会丢失数据！

--后端=名称
指定要使用的键值后端。 这可以在添加文件时使用
附件，或迁移文件。 一旦文件在附件中，它们的后端就知道了
并且此选项不是必需的。

--用户代理=值
从 Web 下载文件时覆盖要使用的用户代理。

--通知完成
导致每次成功下载文件后显示桌面通知
并上传。

（仅在某些平台上受支持，例如带有 dbus 的 Linux。不支持时无操作
支持的。）

--通知开始
导致在文件上传或下载时显示桌面通知
开始，或者当文件被删除时。

-c 名称=值
覆盖 git 配置设置。 可以多次指定。

配置 威盛 .git/配置

与其他 git 命令一样，git-annex 是通过配置 .git/配置. 这里是所有
支持的配置设置。

附件.uuid
此存储库的唯一 UUID（自动设置）。

附件.backends
要使用的键值后端名称的空格分隔列表。 第一个上市
默认用于存储新文件。

附件.diskreserve
要保留的磁盘空间量。 传输内容时检查磁盘空间
避免耗尽，并且可以通过此选项保留额外的可用空间，以
为更重要的内容（例如 git commit 日志）腾出空间。 可以指定
使用任何常用单位，例如“0.5 gb”、“500M”或“100 KiloBytes”

默认保留为 1 兆字节。

附件.大文件
允许配置哪些文件被认为足够大需要
添加到附件中。 默认情况下，所有指定的文件都添加到附件中，但
配置这个会导致小文件被检入 git，而不使用
附件。

该值是首选的内容表达式。 看 git-附件-首选内容（1）
细节。

计费示例：

Annex.largefiles = 大于=100kb 而不是（include=*.c 或 include=*.h）

此设置由 混帐 附件 加, 混帐 附件 进口 和助理。 它是
也被使用 混帐 附件 地址 和 混帐 附件 进口饲料 下载文件时。

在命令行中通过 -c 临时覆盖它会很有用。 为了
例：

git附件添加 -c Annex.largefiles='include=*' 99kbfile

附件.numcopies
这是一个已弃用的设置。 您应该改为使用 混帐 附件 份数
命令来配置在所有存储库中保留多少文件副本。

此配置设置仅在 混帐 附件 份数 从来没有
配置。

请注意，将 numcopies 设置为 0 非常不安全。

附件.genmetadata
设置为 true 添加时让git-annex自动生成一些元数据
文件到存储库。

特别是，它存储来自文件修改的年和月元数据
日期。

使用 importfeed 时，它会存储来自提要的其他元数据，例如
作者、标题等。

Annex.used-refspec
这控制了哪些参考 git-附件 未使用 认为可以使用。 参见 REFSPEC 格式
in git-附件未使用(1) 详情。

附件队列大小
git-annex 建立一个 git 命令队列，以便将类似的命令组合起来
速度。 默认情况下，队列的大小限制为 10240 个命令； 这可以是
用于改变大小。 如果您有足够的内存并且正在使用非常
大量文件，增加队列大小可以加快速度。

附件.盛开能力
这个 混帐 附件 未使用 和 混帐 附件 同步 - 内容 命令使用布隆过滤器
确定哪些文件存在于例如工作树中。 默认布隆过滤器是
大小可处理多达 500000 个文件。 如果您的存储库大于那个，您
应该增加这个值。 较大的值将使 git-附件 未使用 和 混帐 附件
同步 - 内容 消耗更多内存； 跑 混帐 附件 info 用于内存使用数量。

附件.blooaccuracy
调整使用的布隆过滤器的准确性 混帐 附件 未使用 和 混帐 附件
同步 - 内容. 默认精度为 10000000 -- 1 中有 10000000 个未使用的文件
会被错过 混帐 附件 未使用. 提高准确率将使 混帐 附件
未使用 消耗更多内存； 跑 混帐 附件 info 用于内存使用数量。

附件.ssh缓存
默认情况下，git-annex 使用 ssh 的 ControlMaster 缓存 ssh 连接和
ControlPersist 设置（如果使用足够新的 ssh 构建）。 要禁用此功能，请设置为
false.

附件.始终提交
默认情况下，git-annex 会在每次执行后自动将数据提交到 git-annex 分支
命令运行。 如果你有一系列的命令想要制作一个
提交，您可以使用以下命令运行命令 -c 附件.总是提交=假. 你可以稍后
通过运行提交数据 混帐 附件 合并 （或通过自动合并）或 混帐 附件
同步.

请注意，您要小心运行 混帐 gc 如果使用此配置，因为它可以
暂存于 git-annex 索引但尚未提交的垃圾收集对象。

附件.硬链接
设置为 true 使文件内容在存储库和
尽可能使用遥控器，而不是更昂贵的副本。

谨慎使用——这会使 numcopies 计数无效，因为使用硬链接，
可以存在较少的文件副本。 因此，使用标记存储库是个好主意
此设置为不受信任。

当使用设置存储库时 混帐 克隆 - 共享, git-annex init 将
自动设置 Annex.hardlink 并将存储库标记为不受信任。

附件.delayadd
使手表和助手命令延迟指定的秒数
在将新创建的文件添加到附件之前。 一般不需要这个，
因为他们已经在等待文件的所有作者关闭它。 在 Mac OSX 上，当
不使用直接模式，默认为 1 秒，以解决不良交互
有软件。

附件.expireunused
控制助手对存储在
库。

默认是 false，这会导致保留所有旧的和未使用的文件内容，
除非助手能够将它们移动到某个其他存储库（例如
备份存储库）。

可以设置为时间规范，如“7d”或“1m”，然后文件内容
已知一周或一个月未使用将被删除。

附件.fscknudge
设置为 false 时，防止 webapp 在使用存储库时提醒您
缺乏一致性检查。

附件.自动升级
当设置为 ask（默认）时，webapp 将检查新版本并提示是否
他们应该升级到。 当设置为 true 时，自动升级而不
提示（在某些支持的平台上）。 设置为 false 时，禁用任何升级
检查。

请注意，升级检查仅在从其中一个安装 git-annex 时进行
来自其网站的预构建图像。 这不会绕过例如 Linux 发行版的
自己的升级处理代码。

这个设置还控制当git-
检测到附件二进制文件已更改。 无论你如何，这都是有用的
安装了 git-annex。

附件.自动提交
设置为 false 以防止 git-annex 助手和 git-annex 同步
自动提交对存储库中文件的更改。

附件.startupscan
设置为 false 以防止 git-annex 助手扫描存储库
启动时新建和更改的文件。 这将防止它注意到变化
是在它没有运行时制作的，但对于一个有用的性能调整
大型存储库。

附件.听
配置 webapp 侦听的地址。 默认为本地主机。 可
IP 地址或解析为所需地址的主机名。

附件.debug
设置为 true 以默认启用调试日志记录。

附件.version
自动维护，用于版本间自动升级。

附件.direct
当存储库处于直接模式时设置为 true。 不应手动设置； 用
代替“git附件直接”和“git附件间接”命令。

附件.crippled文件系统
如果存储库位于残缺的文件系统（例如 FAT）上，则设置为 true
不支持符号链接、硬链接或 unix 权限。 这是
由“git Annex init”自动探测。

附件.pidlock
通常，git-annex 使用细粒度的锁文件来允许多个进程运行
同时不妨碍对方。 这很好用，除非你是
在不支持 POSIX fcntl 锁的文件系统上使用 git-annex。 这是
有时使用 NFS 或 Lustre 文件系统时会出现这种情况。

支持这种情况，可以设置附件.pidlock为true，就会掉
回到单个顶级 pid 文件锁。

虽然，通常情况下，你真的最好修复你的网络文件系统
支持 POSIX 锁的配置.. 而且，一些网络文件系统是如此
不一致，即一个节点无法可靠地判断另一个节点何时持有 pid
锁。 买者自负。

附件.pidlocktimeout
使用 pid 锁定文件时，可能会遗留过时的锁定文件
通过之前运行的 git-annex 崩溃或被中断。 这主要是
避免，但可能会发生，尤其是在使用网络文件系统时。

git-annex 将等待这个 pid 锁文件消失的秒数，并且
如果无法继续，则将中止。 默认值：300

偏僻的。 .附件成本
在确定从哪个存储库传输附件文件或向哪个存储库传输附件时，具有
较低的成本是首选。 本地存储库的默认成本为 100，而 200
用于远程存储库。

偏僻的。 .annex-cost-command
如果设置，则运行该命令，并将其输出的数字用作成本。 这个
允许基于例如当前网络改变成本。 成本命令可以是
任何 shell 命令行。

偏僻的。 .annex-start-命令
当 git-annex 开始使用遥控器时运行的命令。 这可以用于，对于
例如，挂载包含远程的目录。

当多个 git-annex 进程同时运行时，该命令可能会重复运行
同时。

偏僻的。 .annex-停止命令
使用遥控器完成 git-annex 时运行的命令。

该命令只会在 *all* 运行 git-annex 进程完成后运行
使用遥控器。

偏僻的。 .annex-shell
在远程指定替代的 git-annex-shell 可执行文件而不是查找
对于 PATH 上的“git-annex-shell”。

如果 git-annex-shell 程序在 PATH 之外或具有
非标准名称。

偏僻的。 .annex-忽略
如果设置为 true, 通过以下方式防止 git-annex 在此遥控器上存储文件内容
默认。 （您仍然可以要求它被 - 从 和 - 到 选项。）

例如，如果遥控器位于没有 git- 的某个地方，这很有用
附件外壳。 （例如，如果它在 GitHub 上）。 或者，如果网络可以使用它
两个存储库之间的连接太慢，无法正常使用。

这不会阻止 git-annex sync（或 git-annex 助手）同步
git 存储库到远程。

偏僻的。 .附件同步
如果设置为 false, 防止 git-annex 同步（和 git-annex 助手）同步
用这个遥控器。

偏僻的。 .annex-只读
如果设置为 true, 防止 git-annex 对远程进行更改。 这两者
防止 git-annex 同步推送更改，并防止存储或删除
来自只读远程的文件。

偏僻的。 .annex-验证, 附件验证
默认情况下，git-annex 将验证从遥控器下载的对象的校验和。
如果您信任远程并且不想要这些校验和的开销，您可以设置
这个到 false.

偏僻的。 .annexUrl
可用于指定与常规网址不同的网址 偏僻的。 .url 对于 git-
与遥控器通话时使用的附件。 类似于 推送网址 由 git-push 使用。

偏僻的。 .annex-uuid
git-annex 在此处缓存远程存储库的 UUID。

偏僻的。 .annex-trustlevel
为远程配置本地信任级别。 这会覆盖配置的值
通过 trust 和 untrust 命令。 该值可以是“可信”、“半可信”中的任何一个
或“不受信任”。

偏僻的。 .附件可用性
可用于告诉 git-annex 远程是否为 LocallyAvailable 或
全球可用。 通常，git-annex 会自动确定这一点。

偏僻的。 .annex-bare
可用于告诉 git-annex 远程是否是裸存储库。 一般，
git-annex 会自动确定这一点。

偏僻的。 .annex-ssh-options
使用 ssh 与此远程通信时使用的选项。

偏僻的。 .annex-rsync-options
使用 rsync 往返此遥控器时使用的选项。 例如，要强制使用 IPv6，
并将带宽限制为 100Kbyte/s，将其设置为 -6 --bw限制 100

偏僻的。 .annex-rsync-upload-options
使用 rsync 将文件上传到远程时使用的选项。

这些选项在其他适用的 rsync 选项之后传递，因此可用于
覆盖它们。 例如，要将上传带宽限制为 10Kbyte/s，设置 --bw限制
10.

偏僻的。 .annex-rsync-download-options
使用 rsync 从远程下载文件时使用的选项。

这些选项在其他适用的 rsync 选项之后传递，因此可用于
覆盖它们。

偏僻的。 .annex-rsync-传输
用于连接到 rsync 远程的远程 shell。 可能的值为 SSH
（默认）和 RSH，连同他们的论点，例如 SSH -p 2222 -c
河豚; 请注意，远程主机名不应出现在那里，请参阅 rsync的（1）
细节。 当使用的交通工具是 SSH, 连接被自动缓存
除非 附件.ssh缓存 未设置。

偏僻的。 .annex-bup-split-options
在此遥控器中存储内容时传递给 bup split 的选项。 例如，到
将带宽限制为 100Kbyte/s，将其设置为 --bw限制 100k （没有
bup join 的相应选项。）

偏僻的。 .annex-gnupg-options
传递给 GnuPG 进行对称加密的选项。 例如，要使用 AES
使用 256 位密钥加密并禁用压缩，将其设置为 --密码算法 AES256
--压缩算法 没有. （这些选项优先于默认的 GnuPG
配置，否则会使用。）

附件.ssh-options, Annex.rsync-options,
Annex.rsync-upload-options, Annex.rsync-download-options, Annex.bup-split-options,
附件.gnupg-options

如果遥控器没有描述的更具体的选项，则使用默认选项
以上。

Annex.web-options
运行 wget 或 curl 时传递的选项。 例如，要强制仅使用 IPv4，请将其设置为
到“-4”

附件.quvi-options
使用 quvi 查找要下载视频的 url 时传递给 quvi 的选项。

附件.aria-torrent-options
使用 aria2c 下载 torrent 时传递给它的选项。

附件.http-headers
从 Web 下载时要发送的 HTTP 标头。 此选项的多行
可以设置，每个标题一个。

Annex.http-headers-command
如果设置，则运行该命令并将其输出的每一行用作 HTTP 标头。
这会覆盖 Annex.http-headers。

Annex.web-download-command
用于指定要运行的命令以从 Web 下载文件。 （默认为
使用 wget 或 curl。）

在命令行中，%url 替换为要下载的 url，而 %file 是
替换为应该保存到的文件。

Annex.secure-erase-command
这可以设置为一个命令，当 git-annex 删除
存储库中文件的内容。

在命令行中，%file 被替换为应该删除的文件。

例如，要使用擦除命令，请将其设置为 擦拭 -f ％文件.

偏僻的。 .rsyncurl
由 rsync 特殊遥控器使用，这将配置 rsync 存储库的位置
使用。 通常这是自动设置的 混帐 附件 远程， 但是你可以
如果需要，请更改它。

偏僻的。 .buprepo
由 bup 特殊遥控器使用，这会将 bup 存储库的位置配置为
用。 通常这是自动设置的 混帐 附件 远程， 但是你可以
如果需要，请更改它。

偏僻的。 .ddarrepo
由 ddar 特殊遥控器使用，这将配置 ddar 存储库的位置
使用。 通常这是自动设置的 混帐 附件 远程， 但是你可以
如果需要，请更改它。

偏僻的。 。目录
由目录特殊遥控器使用，这将配置目录的位置
附件文件存储于此遥控器的位置。 通常这是自动设置的
由 混帐 附件 远程，但您可以根据需要更改它。

偏僻的。 .s3
用于识别 Amazon S3 特殊遥控器。 通常这是自动设置的
by 混帐 附件 远程.

偏僻的。 。冰川
用于识别 Amazon Glacier 特殊遥控器。 通常这是自动的
设立者 混帐 附件 远程.

偏僻的。 .webdav
用于识别 webdav 特殊遥控器。 通常这是自动设置的
混帐 附件 远程.

偏僻的。 .tahoe
用于识别太浩专用遥控器。 指向配置目录
太浩。

偏僻的。 .annex-xmppaddress
用于识别 Jabber 好友的 XMPP 地址。 通常这是由
通过 XMPP 配对时的 git-annex 助手。

偏僻的。 .gcrypt
用于识别 gcrypt 特殊遥控器。 通常这是自动设置的
混帐 附件 远程.

如果这是 gcrypt 遥控器，则设置为“true”。 如果 gcrypt 远程可访问
通过 ssh 并有 git-annex-shell 可用于管理它，它被设置为“shell”。

偏僻的。 .hooktype, 偏僻的。 .外部类型
钩子专用遥控器和外置专用遥控器用来记录挂机类型
远程。

附件.tune.objecthash1, 附件.tune.objecthashlower, 附件.tune.branchhash1
这些可以传递给 混帐 附件 初始化 调整存储库。 他们不能
在正在运行的存储库中安全地更改。 有关详细信息，请参阅http://git-
Annex.branchable.com/tuning/>。

配置 威盛 .git 属性

向附件添加新文件时使用的键值后端可以配置在
每个文件类型的基础通过 .git 属性 文件。 在文件中， 附件.backend 属性可以
设置为要使用的后端的名称。 例如，这是如何使用 WORM
默认为后端，但 ogg 文件的 SHA256E 后端：

* Annex.backend=WORM
*.ogg 附件.backend=SHA256E

也可以通过每个文件类型配置 numcopies 设置
附件.numcopies 归因于 .git 属性 文件。 这会覆盖其他 numcopies
设置。 例如，这使得 wav 文件需要两份副本，而 wav 文件需要 3 份副本。
flac 文件：

*.wav 附件.numcopies=2
*.flac 附件.numcopies=3

请注意，将 numcopies 设置为 0 非常不安全。

每当 git-annex 对匹配的文件进行操作时，它都会遵循这些设置。
但是，当使用 --all、--unused 或 --key 指定要操作的键时，git-annex 是
操作键而不是文件，因此不会遵守 .gitattributes 的设置。

另请注意，在使用视图时，仅顶层 .gitattributes 文件保留在
查看，因此其他文件中的其他设置不会产生任何影响。

退出 状态

git-annex，当作为 git 子命令调用时，可能会返回退出代码 0 或 1 以表示成功或
失败，或者，对于某些非常具体的失败，更罕见的是 127 或 128。 git附件
本身应该在成功时返回 0，在失败时返回 1，除非 --time-limit=时间 选项是
命中，在这种情况下，它返回退出代码 101。

使用 onworks.net 服务在线使用 git-annex