gpgconf - 云端在线

程序：

您的姓名

配置文件 - 修改 .gnupg 主目录

概要

配置文件 [选项] --列表组件
配置文件 [选项] --列表选项 元件
配置文件 [选项] --更改选项 元件

商品描述

这个 配置文件 是一个自动合理安全地查询和修改的实用程序
'中的配置文件.gnupg'主目录。 它旨在不被调用
由用户手动执行，但由图形用户界面 (GUI) 自动执行。 （[请注意
当前没有进行锁定，因此应避免并发访问。 有一些
避免并发使用损坏的预防措施，但结果可能不一致
某些更改可能会丢失。 无状态设计使其难以提供更多
保证。])

配置文件 提供对 GnuPG 的一个或多个组件的配置的访问
系统。 这些组件或多或少对应于 GnuPG 中存在的程序
框架，如 GnuPG、GPGSM、DirMngr 等。但这不是严格的一对一
关系。 并非所有配置选项都可以通过 配置文件. 配置文件
提供通用和抽象的方法来访问最重要的配置选项
可以通过这种机制进行控制。

配置文件 可用于收集和更改每个组件中可用的选项，并且可以
还提供它们的默认值。 配置文件 将提供详细的类型信息，可以
用于限制用户的输入而不尝试提交更改。

配置文件 提供配置编辑器的后端。 配置编辑器将
通常是一个图形用户界面程序，允许显示当前选项，
它们的默认值，并允许用户更改选项。 这些变化
然后可以激活 配置文件 再次。 这样的程序使用 配置文件 这样
在本节中将称为 GUI。

指令

必须给出以下命令之一：

--列表组件
列出所有组件。 如果没有指定，这是使用的默认命令。

--检查程序
列出所有可用的后端程序并测试它们是否可运行。

--列表选项 元件
列出组件的所有选项 元件.

--更改选项 元件
更改组件的选项 元件.

--检查选项 元件
检查组件的选项 元件.

--应用默认值
使用取自全局配置文件的值更新所有配置文件
（通常 '/etc/gnupg/gpgconf.conf“）。

--list-目录
列出使用的目录 配置文件. 每行列出一个目录，每个目录
行由冒号分隔的列表组成，其中第一个字段命名目录
类型（例如 系统配置目录) 并且第二个字段包含百分比转义
目录。 虽然它们不是目录，但它们使用的套接字文件名 GPG-
代理人 和 目录 也印刷。 请注意，套接字文件名和
家目录 行是默认名称，它们可能会被命令行覆盖
开关。

--列表配置 [文件名]
以冒号分隔的格式列出全局配置文件。 如果 文件名 is
给定，改为检查该文件。

--检查配置 [文件名]
对全局配置文件运行语法检查。 如果 文件名 给出，检查
那个文件代替。

--重新加载 [元件]
重新加载所有或给定的组件。 这与发送 SIGHUP 基本相同
到组件。 不支持重新加载的组件将被忽略。

- 发射 [元件]
如果 元件 尚未运行，启动它。 元件 必须是守护进程。
这通常不是必需的，因为系统会根据需要启动这些守护程序。
但是，直接使用外部软件 gpg代理 or 目录 可以用这个
命令以确保它们已启动。

- 杀 [元件]
杀死给定的组件。 支持查杀的组件有 gpg-agent 和
守护进程。 不支持重新加载的组件将被忽略。 请注意，截至
现在 reload 和 kill 对 scdaemon 具有相同的效果。

配置

可以使用以下选项：

-o 文件

- 输出 文件
将输出写入 文件. 默认是写入标准输出。

-v

--详细
运行时输出附加信息。 具体来说，这扩展了数字
字段值由人类可读的描述。

-q

- 安静的
尽量保持安静。

-n

--试运行
实际上不要改变任何东西。 这目前仅适用于 - 改变-
选项 并可用于测试目的。

-r

- 运行
仅与 --更改选项. 如果修改的选项之一可以
在正在运行的守护进程中发生变化，向正在运行的守护进程发出信号以要求它重新解析
更改后的配置文件。

这意味着更改将在运行时生效，只要这是
可能的。 否则，它们将在各自的下一次开始时生效。
后端程序。

用法

命令 --列表组件 将列出所有可以配置的组件
配置文件. 通常，一个组件会对应一个 GnuPG 相关的程序并包含
可以使用修改的程序配置文件的选项 配置文件.
然而，情况并非一定如此。 一个组件也可能是一组选定的
来自多个程序的选项，或包含具有特殊功能的完全虚拟选项
效果，而不是只更改一个配置文件中的一个选项。

组件是一组在语义上属于一起的配置选项。
此外，可以使用单个原子方式对组件进行多次更改
手术。 例如，GUI 可以为每个组件提供一个带有一个条目的菜单，或者
一个窗口，每个组件有一个制表符。

命令参数 --列表组件 列出所有可用的组件，每行一个。 这
每行的格式为：

姓名:描述:程序名称:

姓名 该字段包含组件的名称标签。 名称标签用于指定
与所有通信的组件 配置文件. 名牌将被使用
逐字. 因此它不是任何转义格式。

描述
这个 绳子 在此字段中包含组件的人类可读描述。
它可以显示给 GUI 用户以供参考。 这是
百分比转义 和 本地化.

程序名称
这个 绳子 在此字段中包含程序文件的绝对名称。 它可以
用于明确地调用该程序。 这是 百分比转义.

计费示例：
$ gpgconf --列表组件
gpg：用于 OpenPGP 的 GPG：/usr/local/bin/gpg2：
gpg-agent:GPG 代理:/usr/local/bin/gpg-agent:
scdaemon：智能卡守护进程：/usr/local/bin/scdaemon：
gpgsm:S/MIME 的 GPG:/usr/local/bin/gpgsm:
dirmngr:目录管理器:/usr/local/bin/dirmngr:

检查 程式

命令 --检查程序 类似于 --列表组件 但适用于后端程序
而不是在组件上。 它运行每个程序以测试它是否已安装和可运行。
这还包括对程序所有配置文件选项的语法检查。

命令参数 --检查程序 列出所有可用的程序，每行一个。 这
每行的格式为：

姓名:描述:程序名称:利用:还好啦:配置文件:线:错误:

姓名 该字段包含与程序名称相同的程序名称标签
成分。 名牌将被使用 逐字. 因此它不在任何逃脱的
格式。 此字段可能为空以指示错误描述的延续
为姓氏。 description 和 pgmname 字段也为空。

描述
这个 绳子 在此字段中包含组件的人类可读描述。
它可以显示给 GUI 用户以供参考。 这是
百分比转义 和 本地化.

程序名称
这个 绳子 在此字段中包含程序文件的绝对名称。 它可以
用于明确地调用该程序。 这是 百分比转义.

利用 这个 布尔 折扣值 在此字段中指示程序是否已安装和
可运行。

还好啦 这个 布尔 折扣值 在此字段中指示程序的配置文件是否为
语法上没问题。

配置文件
如果配置文件中发生错误（如
场 还好啦)，该字段具有失败的配置文件的名称。 这是
百分比转义.

线 如果配置文件发生错误，该字段的行号为
配置文件中的失败语句。 它是一个 无符号 数.

错误 如果配置文件中发生错误，则该字段的错误文本为
配置文件中的失败语句。 这是 百分比转义 和
本地化.

在下面的例子中 目录 是不可运行的和配置文件
守护进程 不行。

$ gpgconf --check-程序
gpg:GPG 用于 OpenPGP:/usr/local/bin/gpg2:1:1:
gpg-agent:GPG 代理:/usr/local/bin/gpg-agent:1:1:
scdaemon:智能卡守护进程：/usr/local/bin/scdaemon:1:0:
gpgsm:GPG 用于 S/MIME:/usr/local/bin/gpgsm:1:1:
dirmngr:目录管理器:/usr/local/bin/dirmngr:0:0:

命令配置文件的方式与 --检查程序，但只针对
元件 元件.

上市 选项

每个组件都包含一个或多个选项。 选项可以收集到选项组中
允许 GUI 向用户提供有关哪些选项相关的视觉提示。

命令参数列出组件中的所有选项（以及它们所属的组）
元件，每行一个。 元件 必须是字段中的字符串 姓名 在输出
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 --列表组件 命令。

每个选项和每个组都有一行。 先来所有不在的选项
任何团体。 然后是一行描述一个组。 然后是属于的所有选项
每组。 然后是下一组等等。 不需要任何组
（在这种情况下，输出将在最后一个非分组选项之后停止）。

每行的格式为：

姓名:标志:水平:描述:类型:替代型:参数名称:默认:参数定义:折扣值

姓名 此字段包含组或选项的名称标签。 名牌用于
在所有通信中指定组或选项 配置文件. 名称标签是
使用 逐字. 因此它不是任何转义格式。

标志 flags 字段包含一个 无符号 数. 它的值是 OR-wise 组合
以下标志值：

组 (1)
如果设置了此标志，则这是描述组而不是选项的行。

以下标志值仅为选项定义（即，如果 组 国旗不是
用过的）。

可选 ARG (2)
如果设置了此标志，则该参数是可选的。 这从未设置为 类型 0
（无）选项。

名单 (4)
如果设置了此标志，则可以多次给出该选项。

运行 (8)
如果设置了此标志，则可以在运行时更改该选项。

默认 (16)
如果设置了此标志，则可以使用默认值。

默认 说明 (32)
如果设置了此标志，则可以使用（运行时）默认值。 这和 默认
标志是互斥的。

没有 ARG 说明 (64)
如果设置了这个标志，并且 可选 ARG 标志被设置，那么该选项有一个
如果没有给出参数，则特殊含义。

没有 更改 (128)
如果设置了此标志，gpgconf 将忽略更改值的请求。 图形用户界面
前端应该将此选项灰显。 请注意，手动更改
配置文件还是可以的。

水平 该字段是为选项和组定义的。 它包含一个 无符号 数
指定该组或选项应处于的专家级别
显示。 为选项定义了以下专家级别（它们有
组的类似含义）：

基本包 (0)
此选项应始终提供给用户。

高级 (1)
此选项可能会提供给高级用户。

专家交谈 (2)
此选项应仅提供给专家用户。

无形 (3)
通常不应显示此选项，即使是专家用户也不应显示。

内部 (4)
此选项仅供内部使用。 忽略它。

组的级别将始终是它包含的所有选项的最低级别。

描述
该字段是为选项和组定义的。 这 绳子 在该字段中包含一个
选项或组的人类可读描述。 它可以显示给用户
用于信息目的的 GUI。 这是 百分比转义 和 本地化.

类型 该字段仅为选项定义。 它包含一个 无符号 数 这
指定选项参数的类型（如果有）。 以下类型是
定义：

基本类型：

没有 (0)
不允许争论。

绳子 (1)
An 未格式化 绳子.

int32 (2)
A 签 数.

单位32 (3)
An 无符号 数.

复杂类型：

路径名 (32)
A 绳子 描述文件的路径名。 该文件不
必然需要存在。

LDAP 服务器 (33)
A 绳子 以以下格式描述 LDAP 服务器：

主机:端口:用户名:密码:基本域名

键 指纹 (34)
A 绳子 带有指定证书的 40 位指纹。

酒馆 键 (35)
A 绳子 通过用户 ID、密钥 ID 或指纹描述证书。

秒 键 (36)
A 绳子 通过用户 ID、密钥 ID 或
指纹。

别号 名单 (37)
A 绳子 描述别名列表，就像与 gpg 的组一起使用的列表一样
选项。 该列表由一个键、一个等号和空格组成
值。

将来会添加更多类型。 请参阅 替代型 有关信息的字段
如何应对未知类型。

替代型
该字段等同于 类型, 除了只有类型 0 至 31 被允许。
GUI 应该以指定的格式向用户显示选项 类型.
但是如果参数类型 类型 GUI 不支持，它仍然可以显示
更通用的基本类型中的选项 替代型. GUI 必须支持所有
定义了能够显示所有选项的基本类型。 更基本的类型可能是
在以后的版本中添加。 如果 GUI 遇到它不支持的基本类型，
它应该报告错误并中止操作。

参数名称
此字段仅针对具有参数类型的选项定义 类型 那不是 0.
在这种情况下，它可能包含一个 百分比转义 和 本地化 绳子 这给了
参数的简称。 但是，该字段也可能为空，在这种情况下
简称未知。

默认
此字段仅针对以下选项定义 默认 or 默认 说明 旗
设置。 如果 默认 标志已设置，其格式为 选项 论点 （看到：
[格式约定]，详情）。 如果默认值为空，则没有默认值
是已知的。 否则，该值指定此选项的默认值。 如果
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 默认 说明 标志已设置，该字段为空或包含描述
如果没有给出选项的效果。

参数定义 此字段仅针对以下选项定义 可选 ARG 标志已设置。 如果
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 没有 ARG 说明 标志未设置，其格式为 选项 论点 （看到：
[格式约定]，详情）。 如果默认值为空，则没有默认值
是已知的。 否则，该值指定此选项的默认参数。 如果
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 没有 ARG 说明 标志已设置，该字段为空或包含对
如果没有给出参数，则此选项的效果。

折扣值 该字段仅为选项定义。 它的格式是 选项 论点.
如果为空，则该选项未在当前配置中显式设置，
并且默认值适用（如果有）。 否则，它包含当前的值
选项。 请注意，如果选项本身不带，则此字段也有意义
一个真正的参数（在这种情况下，它包含选项出现的次数）。

改变 选项

更改组件选项的命令 元件 到指定的值。
元件 必须是字段中的字符串 姓名 在输出中 --列表组件
命令。 您必须在以下格式中提供应更改的选项
标准输入：

姓名:标志:新价值

姓名 这是要更改的选项的名称。 姓名 必须是字段中的字符串
姓名 在输出中 --列表选项 命令。

标志 flags 字段包含一个 无符号 数. 它的值是 OR-wise 组合
以下标志值：

默认 (16)
如果设置了此标志，则删除该选项并使用默认值
代替（如果适用）。

新价值
选项的新值。 此字段仅在以下情况下定义 默认 标志是
没有设置。 格式是一个 选项 论点. 如果它是空的（或字段
省略），使用默认参数（仅当参数可选时才允许）
对于此选项）。 否则，该选项将设置为指定值。

命令的输出与 --检查选项 对于修改后的
配置文件。

例子：

设置强制选项，这是基本类型 没有 (0):

$回声'力：0：1' | gpgconf --change-options dirmngr

要删除强制选项：

$ echo '力：16：' | gpgconf --change-options dirmngr

这个 - 运行 选项会影响更改生效的时间。

上市 全球化 选项

有时，应用程序查看全局选项文件很有用配置文件“。
冒号分隔的列表格式是面向记录的，并使用第一个字段来标识
记录类型：

k 这描述了开始定义新规则集的关键记录
用户/组。 密钥记录的格式为：

k:用户:组:

用户 这是密钥的用户字段。 它是逃脱的百分比。 见
详细的 gpgconf.conf 格式的定义。

组 这是密钥的组字段。 它是逃脱的百分比。

r 这描述了规则记录。 直到下一个关键记录的所有规则记录构成一个
为该键设置的规则。 规则记录的格式为：

回复：：：元件:选项:标志:折扣值:

元件
这是规则的组成部分。 它是一个普通的字符串。

选项 这是规则的选项部分。 它是一个普通的字符串。

旗 这是规则的标志部分。 每个规则可能只有一个标志，但是
通过使用相同的组件和选项，可以将多个标志分配给一个
选项。 它是一个普通的字符串。

折扣值 这是选项的可选值。 这是一个百分比转义字符串
用单引号表示字符串。 引号是
只需要区分未指定值和空字符串。

应忽略未知的记录类型。 请注意，故意没有功能
通过更改全局选项文件 配置文件.

使用 onworks.net 服务在线使用 gpgconf