gpgconf - Интернет в облаке

ПРОГРАММА:

ИМЯ

gpgconf - Изменить домашние каталоги .gnupg

СИНТАКСИС

gpgconf [кредита] --список-компонентов
gpgconf [кредита] --список-опций компонент
gpgconf [кредита] - параметры-изменения компонент

ОПИСАНИЕ

The gpgconf это утилита для автоматического и разумного безопасного запроса и изменения
файлы конфигурации в папке '.gnupg'домашний каталог. Он разработан, чтобы его нельзя было вызывать
вручную пользователем, но автоматически с помощью графического пользовательского интерфейса (GUI). ([Пожалуйста, обрати внимание
что в настоящее время блокировка не выполняется, поэтому следует избегать одновременного доступа. Есть некоторые
меры предосторожности, чтобы избежать повреждения при одновременном использовании, но результаты могут быть несовместимыми и
некоторые изменения могут потеряться. Дизайн без сохранения состояния затрудняет предоставление дополнительных
гарантии.])

gpgconf обеспечивает доступ к настройке одного или нескольких компонентов GnuPG
система. Эти компоненты более или менее соответствуют программам, которые существуют в GnuPG.
framework, как GnuPG, GPGSM, DirMngr и т. д. Но это не строгий однозначный
отношение. Не все параметры конфигурации доступны через gpgconf. gpgconf
предоставляет общий и абстрактный метод для доступа к наиболее важным параметрам конфигурации
которым можно реально управлять с помощью такого механизма.

gpgconf может использоваться для сбора и изменения параметров, доступных в каждом компоненте, и может
также укажите их значения по умолчанию. gpgconf предоставит подробную информацию о типе, которая может
использоваться для ограничения ввода пользователя без попытки зафиксировать изменения.

gpgconf предоставляет серверную часть редактора конфигурации. Редактор конфигурации
обычно это программа с графическим пользовательским интерфейсом, которая позволяет отображать текущие параметры,
их значения по умолчанию, и позволяет пользователю вносить изменения в параметры. Эти изменения
затем можно сделать активным с помощью gpgconf опять таки. Такая программа, которая использует gpgconf таким образом
в этом разделе будет называться GUI.

КОМАНДЫ

Должна быть дана одна из следующих команд:

--список-компонентов
Перечислите все компоненты. Это команда по умолчанию, используемая, если ничего не указано.

- чек-программы
Перечислите все доступные серверные программы и проверьте, работают ли они.

--список-опций компонент
Перечислить все параметры компонента компонент.

- параметры-изменения компонент
Измените параметры компонента компонент.

--check-параметры компонент
Проверьте параметры компонента компонент.

--apply-по умолчанию
Обновите все файлы конфигурации значениями, взятыми из файла глобальной конфигурации
(как правило '/etc/gnupg/gpgconf.conf«).

--список-каталогов
Перечисляет каталоги, используемые gpgconf. Один каталог указан в каждой строке, и каждый
Строка состоит из списка, разделенного двоеточиями, в котором первое поле обозначает каталог
тип (например системный каталог), а второе поле содержит экранированные проценты
каталог. Хотя они не являются каталогами, имена файлов сокетов, используемые gpg-
агент и дирмнгр также печатаются. Обратите внимание, что имена файлов сокетов и
Хомедир строки являются именами по умолчанию, и они могут быть переопределены командной строкой
переключатели.

--список-конфигурации [имя файла]
Перечислите файл глобальной конфигурации в формате, разделенном двоеточиями. Если имя файла is
учитывая, вместо этого проверьте этот файл.

--check-config [имя файла]
Выполните проверку синтаксиса глобального файла конфигурации. Если имя файла дан, проверьте
этот файл вместо этого.

- перезагрузить [компонент]
Перезагрузите весь или данный компонент. Это в основном то же самое, что и отправка SIGHUP.
к компоненту. Компоненты, не поддерживающие перезагрузку, игнорируются.

--запуск [компонент]
Если же линия индикатора компонент еще не запущен, запустите его. компонент должен быть демон.
Обычно это не требуется, поскольку система запускает эти демоны по мере необходимости.
Однако внешнее программное обеспечение, напрямую использующее gpg-агент or дирмнгр может использовать это
команда, чтобы убедиться, что они запущены.

--убийство [компонент]
Убить данный компонент. Компоненты, поддерживающие убийство: gpg-agent и
scdaemon. Компоненты, не поддерживающие перезагрузку, игнорируются. Обратите внимание, что с
теперь reload и kill имеют одинаковый эффект для scdaemon.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Могут использоваться следующие варианты:

-o файл

--выход файл
Записать вывод в файл. По умолчанию запись выполняется в стандартный вывод.

-v

--подробный
Выводит дополнительную информацию во время работы. В частности, это расширяет числовые
значения полей с помощью удобочитаемых описаний.

-q

--тихий
Постарайтесь вести себя как можно тише.

-n

--прогон, репетиция
На самом деле ничего не меняйте. В настоящее время это реализовано только для --изменение-
кредита и может использоваться для тестирования.

-r

- время выполнения
Используется только вместе с - параметры-изменения. Если один из измененных вариантов может быть
изменено в запущенном процессе демона, сигнализируйте запущенному демону, чтобы он попросил его повторно проанализировать
его конфигурационный файл после изменения.

Это означает, что изменения вступят в силу во время выполнения, если это
возможный. В противном случае они вступят в силу при следующем запуске соответствующего
серверные программы.

ИСПОЛЬЗОВАНИЕ

Команда --список-компонентов перечислит все компоненты, которые можно настроить с помощью
gpgconf. Обычно один компонент соответствует одной программе, связанной с GnuPG, и содержит
параметры этого файла конфигурации программы, которые можно изменить с помощью gpgconf.
Однако это не всегда так. Компонент также может быть группой выбранных
опции из нескольких программ или содержат полностью виртуальные опции, которые имеют особые
эффект, а не изменение только одной опции в одном файле конфигурации.

Компонент - это набор параметров конфигурации, которые семантически связаны друг с другом.
Кроме того, несколько изменений в компоненте могут быть внесены атомарным способом с помощью одного
операция. Графический интерфейс пользователя может, например, предоставить меню с одной записью для каждого компонента или
окно с одним листом табулятора на компонент.

Аргумент команды --список-компонентов перечисляет все доступные компоненты, по одному в каждой строке. В
формат каждой строки:

имя:описание:имя_программы:

имя Это поле содержит именной тег компонента. Тег имени используется для указания
компонент во всем общении с gpgconf. Тег имени должен использоваться
дословно. Таким образом, это не в каком-либо экранированном формате.

описание
The string в этом поле содержится удобочитаемое описание компонента.
Он может отображаться пользователю графического интерфейса в информационных целях. это
процент сбежавших и локализованный.

имя_программы
The string в этом поле содержится абсолютное имя файла программы. Оно может
использоваться для однозначного вызова этой программы. это процент сбежавших.

Пример:
$ gpgconf --list-компоненты
gpg: GPG для OpenPGP: / usr / local / bin / gpg2:
gpg-агент: Агент GPG: / usr / local / bin / gpg-агент:
scdaemon: Демон смарт-карты: / usr / local / bin / scdaemon:
gpgsm: GPG для S / MIME: / usr / local / bin / gpgsm:
dirmngr: Диспетчер каталогов: / usr / local / bin / dirmngr:

Контроль программы

Команда - чек-программы аналогично --список-компонентов но работает с бэкэнд-программами
а не на компоненты. Он запускает каждую программу, чтобы проверить, установлена ​​ли она и работает ли она.
Это также включает проверку синтаксиса всех параметров файла конфигурации программы.

Аргумент команды - чек-программы перечисляет все доступные программы, по одной в каждой строке. В
формат каждой строки:

имя:описание:имя_программы:выгода:хорошо:cfgfile:линия:ошибка:

имя Это поле содержит тег имени программы, который идентичен имени программы.
составная часть. Тег имени должен использоваться дословно. Таким образом, это не ускользало
формат. Это поле может быть пустым, что указывает на продолжение описания ошибок.
по фамилии. Поля description и pgmname также будут пустыми.

описание
The string в этом поле содержится удобочитаемое описание компонента.
Он может отображаться пользователю графического интерфейса в информационных целях. это
процент сбежавших и локализованный.

имя_программы
The string в этом поле содержится абсолютное имя файла программы. Оно может
использоваться для однозначного вызова этой программы. это процент сбежавших.

выгода The логический ценностное в этом поле указывает, установлена ​​ли программа и
работоспособный.

хорошо The логический ценностное в этом поле указывает, является ли файл конфигурации программы
синтаксически нормально.

cfgfile
Если в файле конфигурации произошла ошибка (на что указывает ложное значение в
поле хорошо), в этом поле указано имя файла конфигурации, в котором произошел сбой. это
процент сбежавших.

линия Если в файле конфигурации произошла ошибка, в этом поле указывается номер строки
оператор сбоя в файле конфигурации. Это неподписанный номер.

ошибка Если в файле конфигурации произошла ошибка, в этом поле отображается текст ошибки
оператор сбоя в файле конфигурации. это процент сбежавших и
локализованный.

В следующем примере дирмнгр не запускается, а файл конфигурации
scdaemon это не нормально.

$ 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:

Файл конфигурации команды так же, как и - чек-программы, но только для
компонент компонент.

Список кредита

Каждый компонент содержит одну или несколько опций. Опции могут быть объединены в группы опций
чтобы позволить графическому интерфейсу пользователя визуально подсказывать пользователю, какие параметры связаны.

Аргумент команды перечисляет все параметры (и группы, к которым они принадлежат) в компоненте.
компонент, по одному в строке. компонент должна быть строка в поле имя на выходе
--список-компонентов команда.

Для каждого варианта и каждой группы есть одна строка. Сначала идут все варианты, которых нет в
любая группа. Затем идет строка, описывающая группу. Затем идут все варианты, которые относятся к
каждая группа. Затем идет следующая группа и так далее. Нет необходимости в какой-либо группе
(и в этом случае вывод будет остановлен после последней несгруппированной опции).

Формат каждой строки:

имя:Флаги:уровень:описание:напишите:альтернативный тип:имя_аргумента:по умолчанию:argdef:ценностное

имя Это поле содержит тег имени для группы или варианта. Тег имени используется для
укажите группу или опцию во всех сообщениях с gpgconf. Тег имени должен
использоваться дословно. Таким образом, это не в каком-либо экранированном формате.

Флаги Поле флагов содержит неподписанный номер. Его значение представляет собой комбинацию по ИЛИ.
следующих значений флага:

группы (1)
Если этот флаг установлен, это строка, описывающая группу, а не вариант.

Следующие значения флагов определены только для опций (то есть, если группы флаг не
используемый).

необязательный аргумент (2)
Если этот флаг установлен, аргумент не обязателен. Это никогда не устанавливается для напишите 0
(нет) вариантов.

список (4)
Если этот флаг установлен, параметр можно указывать несколько раз.

время выполнения (8)
Если этот флаг установлен, параметр можно изменить во время выполнения.

по умолчанию (16)
Если этот флаг установлен, доступно значение по умолчанию.

по умолчанию по убыванию (32)
Если этот флаг установлен, доступно значение по умолчанию (время выполнения). Это и по умолчанию
flag являются взаимоисключающими.

нет аргумент по убыванию (64)
Если этот флаг установлен, и необязательный аргумент установлен флаг, то опция имеет
особое значение, если аргумент не указан.

нет изменение (128)
Если этот флаг установлен, gpgconf игнорирует запросы на изменение значения. GUI
внешние интерфейсы должны выделить эту опцию серым цветом. Обратите внимание, что ручные изменения
файлы конфигурации все еще возможны.

уровень Это поле определено для опций и для групп. Он содержит неподписанный номер
который указывает экспертный уровень, на котором эта группа или опция должны быть
отображается. Следующие экспертные уровни определены для опций (у них есть
аналогичное значение для групп):

основной (0)
Этот вариант всегда следует предлагать пользователю.

продвинутый (1)
Эта опция может быть предложена опытным пользователям.

эксперту (2)
Этот вариант следует предлагать только опытным пользователям.

невидимый (3)
Эта опция обычно никогда не должна отображаться даже для опытных пользователей.

в нашей внутренней среде, (4)
Эта опция предназначена только для внутреннего использования. Игнорируй это.

Уровень группы всегда будет самым низким из всех содержащихся в ней вариантов.

описание
Это поле определено для опций и групп. В string в этом поле содержится
удобочитаемое описание опции или группы. Он может быть отображен пользователю
графического интерфейса пользователя в информационных целях. это процент сбежавших и локализованный.

напишите Это поле определено только для опций. Он содержит неподписанный номер которая
указывает тип аргумента опции, если таковой имеется. Следующие типы
определенный:

Основные типы:

нет (0)
Аргументы недопустимы.

string (1)
An неотформатированная string.

int32 (2)
A подписанный номер.

uint32 (3)
An неподписанный номер.

Сложные типы:

пути (32)
A string который описывает путь к файлу. Файл не
обязательно нужно существовать.

LDAP сервер (33)
A string который описывает сервер LDAP в формате:

хоста:порт:username:password:base_dn

ключ отпечаток пальца (34)
A string с 40-значным отпечатком пальца, указывающим на сертификат.

паб ключ (35)
A string который описывает сертификат по идентификатору пользователя, идентификатору ключа или отпечатку пальца.

сек ключ (36)
A string который описывает сертификат с ключом по идентификатору пользователя, идентификатору ключа или
отпечаток пальца.

псевдоним список (37)
A string который описывает список псевдонимов, например, тот, который используется с группой gpg
вариант. Список состоит из ключа, знака равенства и разделенных пробелами.
значения.

В будущем будут добавлены другие типы. Пожалуйста, посмотрите альтернативный тип поле для информации о
как справиться с неизвестными типами.

альтернативный тип
Это поле идентично напишите, за исключением того, что только типы 0 в 31 разрешается.
Ожидается, что графический интерфейс предоставит пользователю параметр в формате, указанном напишите.
Но если тип аргумента напишите не поддерживается графическим интерфейсом, он все еще может отображать
вариант в более общем базовом типе альтернативный тип. Графический интерфейс должен поддерживать все
определены базовые типы, чтобы иметь возможность отображать все параметры. Более базовые типы могут быть
добавлено в будущих версиях. Если GUI встречает базовый тип, который не поддерживает,
он должен сообщить об ошибке и прервать операцию.

имя_аргумента
Это поле определено только для параметров с типом аргумента. напишите это не 0.
В этом случае он может содержать процент сбежавших и локализованный string это дает
короткое имя аргумента. Однако поле также может быть пустым, и в этом случае
короткое имя не известно.

по умолчанию
Это поле определено только для опций, для которых по умолчанию or по умолчанию по убыванию флажок
установлен. Если по умолчанию установлен, его формат соответствует формату вариант аргумент (видеть:
[Условные обозначения формата], для подробностей). Если значение по умолчанию пусто, то по умолчанию нет
известен. В противном случае значение указывает значение по умолчанию для этой опции. Если
по умолчанию по убыванию установлен флаг, поле либо пустое, либо содержит описание
эффекта, если опция не указана.

argdef Это поле определено только для опций, для которых необязательный аргумент установлен флаг. Если
нет аргумент по убыванию флаг не установлен, его формат соответствует формату вариант аргумент (видеть:
[Условные обозначения формата], для подробностей). Если значение по умолчанию пусто, то по умолчанию нет
известен. В противном случае значение указывает аргумент по умолчанию для этой опции. Если
нет аргумент по убыванию установлен флаг, поле либо пустое, либо содержит описание
эффект этой опции, если не указан аргумент.

ценностное Это поле определено только для опций. Его формат - это формат вариант аргумент.
Если он пуст, то в текущей конфигурации этот параметр явно не задан,
и применяется значение по умолчанию (если есть). В противном случае он содержит текущее значение
вариант. Обратите внимание, что это поле также имеет значение, если сама опция не принимает
реальный аргумент (в данном случае он содержит количество появлений опции).

Изменение кредита

Команда для изменения параметров компонента компонент к указанным значениям.
компонент должна быть строка в поле имя на выходе --список-компонентов
команда. Вы должны указать параметры, которые должны быть изменены в следующем формате на
стандартный ввод:

имя:Флаги:новое значение

имя Это название опции, которую нужно изменить. имя должна быть строка в поле
имя на выходе --список-опций команда.

Флаги Поле флагов содержит неподписанный номер. Его значение представляет собой комбинацию по ИЛИ.
следующих значений флага:

по умолчанию (16)
Если этот флаг установлен, опция удаляется и используется значение по умолчанию.
вместо этого (если применимо).

новое значение
Новое значение опции. Это поле определяется только в том случае, если по умолчанию флаг
не задано. Формат такой вариант аргумент. Если он пуст (или поле
опущен), используется аргумент по умолчанию (разрешен только в том случае, если аргумент является необязательным.
для этого варианта). В противном случае для параметра будет установлено указанное значение.

Вывод команды такой же, как и у --check-параметры для модифицированного
Файл конфигурации.

Примеры:

Чтобы установить опцию силы, которая имеет базовый тип нет (0):

$ echo 'force: 0: 1' | gpgconf --change-options dirmngr

Чтобы удалить опцию принудительного действия:

$ echo 'force: 16:' | gpgconf --change-options dirmngr

The - время выполнения опция может повлиять на то, когда изменения вступят в силу.

Список Глобальный кредита

Иногда приложениям полезно просматривать файл глобальных опций 'gpgconf.conf.
Формат списка, разделенного двоеточием, ориентирован на записи и использует первое поле для идентификации
тип записи:

k Это описывает ключевую запись для начала определения нового набора правил для
группа пользователей. Формат ключевой записи:

k:пользователь:группы:

пользователь Это пользовательское поле ключа. Это процент уцелевший. Увидеть
определение формата gpgconf.conf для деталей.

группы Это групповое поле ключа. Это процент уцелевший.

r Это описывает запись правила. Все записи правил до следующей ключевой записи составляют
набор правил для этого ключа. Формат записи правила:

р:::компонент:вариант:Флаги:ценностное :

компонент
Это составная часть правила. Это простая струна.

вариант Это опционная часть правила. Это простая струна.

флажок Это флаговая часть правила. В правиле может быть только один флаг, но
используя один и тот же компонент и опцию, несколько флагов могут быть присвоены
вариант. Это простая струна.

ценностное Это необязательное значение для опции. Это строка с экранированием в процентах
с одинарной кавычкой для обозначения строки. Кавычка
требуется только для того, чтобы различать отсутствие указанного значения и пустую строку.

Неизвестные типы записей следует игнорировать. Обратите внимание, что здесь намеренно нет функции
изменить глобальный файл опций через gpgconf.

Используйте gpgconf онлайн с помощью сервисов onworks.net