     [file defs.ru.inc not included]

Вспомогательные средства
************************

В GnuPG есть несколько небольших программ:

watchgnupg.ru.1

Чтение запротоколированных данных из сокета
===========================================

ВЫЗОВ

ОПИСАНИЕ
Большинство основных утилит способно записывать файлы протоколов своей работы в сокет домена Unix, если это задано настройками. watchgnupg представляет простую программу прослушивания такого сокета. Она обогащает выходные данные временными метками и гарантирует, что длинные строки не перемешиваются с данными, исходящими от других утилит. Под Windows это средство недоступно.

watchgnupg обычно вызывается как

     watchgnupg --force $(gpgconf --list-dirs socketdir)/S.log

Программа запускается в текущем терминале для прослушивания сконфигурированного сокета протоколирования (~/.gnupg/S.log или /var/run/user/UID/gnupg/S.log).

ПАРАМЕТРЫ

watchgnupg воспринимает параметры:

--force
     Удалить файл сокета, если тот существует.

--tcp N
     Вместо чтения из локального сокета прослушивать соединения по порту TCP N.

--time-only
     Не выводить дату в метке времени.

--verbose
     Включить вывод дополнительной информации.

--version
     Вывести версию программы и завершить работу.

--help
     Показать краткую справку и завершить работу.

ПРИМЕРЫ

Примеры
*******

     $ watchgnupg --force --time-only $(gpgconf --list-dirs socketdir)/S.log

Ждать соединений по локальному сокету (напр., /home/foo/.gnupg/S.log) и показывать все записи протокола работы. Для этого нужно использовать параметр log-file со всеми модулями, протоколы работы которых нужно показывать. Пример записи для файлов настроек:

     log-file socket://

Если исходный сокет, заданный выше и возвращаемый командой «echo $(gpgconf --list-dirs socketdir)/S.log», нежелателен, можно указать любое произвольное имя сокета, например, socket:///home/foo/bar/mysocket. В целях отладки можно выполнять также удаленное протоколирование. Пользуйтесь этим с осторожностью, поскольку информация посылается по сети открытым текстом. Для этого в файле настроек размещается строка вида:

     log-file tcp://192.168.1.1:4711

Вместо порта 4711 можно пользоваться любым другим портом; поддерживаются только адреса IP (версий 4 и 6), имена машин не поддерживаются. Команду watchgnupg нужно вызывать с параметром tcp. Обратите внимание, что под Windows для изменения исходного канала, в который выводится протокол работы (stderr), можно применять пункт реестра HKCU\SOFTWARE\GNU\GNUPG:DEFAULTLOGFILE. Однако это может быть полезно, только когда пункт содержит адрес TCP для удаленной отладки.

СМ. ТАКЖЕ
     [file see-also-note.ru.texi not included]

     [file gpgv.ru.texi not included]

addgnupghome.ru.8

Создание домашних каталогов .gnupg
==================================

ВЫЗОВ

ОПИСАНИЕ
Если GnuPG устанавливается в системе с существующими учетными записями пользователей, иногда требуется заполнить домашний каталог GnuPG существующими файлами. Часто особенно желательны некоторые первоначальные сертификаты в trustlist.txt и щите с ключами. Эта программа помогает в этом, копируя все файлы из /etc/skel/.gnupg в домашние каталоги учетных записей, заданных в командной строке. При этом запись поверх существующих домашних каталогов GnuPG не производится.

addgnupghome вызывается от имени суперпользователя командой:

     addgnupghome учетная_запись_1 учетная_запись_2 ... учетная_запись_n

gpgconf.ru.1

Изменение домашних каталогов .gnupg
===================================

ВЫЗОВ

ОПИСАНИЕ
Утилита gpgconf предназначена для автоматического и относительно безопасного чтения и модификации файлов настроек в домашнем каталоге .gnupg. Она проектирована не для выполнения пользователем вручную, а для автоматического запуска графическими оболочками (Обратите внимание, что в настоящее время блокирование не проводится, так что одновременного доступа из разных программ следует избегать. Некоторые меры против повреждений из-за одновременного доступа предпринимаются, но результаты могут быть непредсказуемы, а некоторые изменения могут быть потеряны. Схема без состояния затрудняет обеспечение чего-то большего.).

Программа gpgconf обеспечивает доступ к настройкам одного или более компонентов системы GnuPG. Эти компоненты более или менее соответствуют программам, составляющим каркас GnuPG, таким как GPG, GPGSM, Dirmngr и т.д. Но строгого соответствия нет. Не все параметры настроек доступны через gpgconf. Программа gpgconf обеспечивает обобщенный и абстрактный метод доступа к тем из наиболее важных параметров настроек, которыми на практике можно управлять посредством такого механизма.

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

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

Вызов gpgconf
-------------

КОМАНДЫ
Должна быть задана одна из команд:

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

--check-programs
     Перечислить все доступные служебные программы и проверить, можно ли их вызывать.

--list-options КОМПОНЕНТ
     Перечислить все параметры указанного компонента.

--change-options КОМПОНЕНТ
     Изменить параметры указанного компонента.

--check-options КОМПОНЕНТ
     Проверить параметры указанного компонента.

--apply-profile ФАЙЛ
     Применить настройки, перечисленные в указанном файле, к файлам конфигурации. Если в аргументе ФАЙЛ нет суффикса и символов «/», сначала производится попытка считать файл с суффиксом .prf из каталога данных (gpgconf --list-dirs datadir); в случае неудачи имя файла воспринимается буквально. Названия компонентов в квадратных скобках делят настройки на группы. В каждой группе указывается параметр, который должен перейти в соответствующий файл настроек.

--apply-defaults
     Записать во все файлы настроек значения, взятые из глобального файла настроек (обычно это /etc/gnupg/gpgconf.conf).

--list-dirs [ИМЕНА]
     Перечислить каталоги, которыми пользуется gpgconf. Перечисляется по одному каталогу в строке, каждая строка состоит из списка с двоеточием в качестве разделителя, в котором первое поле представляет тип каталога (например, sysconfdir), а второе — каталог с процентом в качестве экранирующего символа. Выводятся также имена сокетов для gpg-agent и dirmngr, хотя это и не каталоги. Обратите внимание, что имена сокетов и строки homedir представляют исходные значения, их можно изменять параметрами командной строки. Если заданы ИМЕНА, выводятся только имена каталогов или файлов, указанные в списке имен, без экранирующих символов.

--list-config [ИМЯ_ФАЙЛА]
     Вывести глобальный файл настроек в формате с двоеточием в качестве разделителя. Если задано имя файла, работать с ним вместо глобального файла настроек.

--check-config [ИМЯ_ФАЙЛА]
     Провести проверку синтаксиса глобального файла настроек. Если задано имя файла, работать с ним вместо исходного глобального файла настроек.

--query-swdb ПАКЕТ [ВЕРСИЯ]
     Возвращает текущую версию указанного пакета, а если задана строка ВЕРСИЯ, показывает, доступно ли обновление. Сам файл с версией программы автоматически получается по сети и проверяется программой dirmngr; при этом установлен порог, чтобы это не происходило слишком часто, и по умолчанию это делается только через Tor. Чтобы принудительно обновить этот файл, можно воспользоваться командой:

                 gpg-connect-agent --dirmngr 'loadswdb --force' /bye

--reload [КОМПОНЕНТ]
     Перезагрузить все или заданный компонент. В основном это эквивалентно посылке компоненту сигнала SIGHUP. Компоненты, которые не поддерживают перезагрузку, игнорируются. Если КОМПОНЕНТ не задан или задано «all», перезагружаются все компоненты, работающие в фоновом режиме.

--launch [КОМПОНЕНТ]
     Если указанный компонент еще не работает, запустить его. Компонент должен поддерживать работу в фоновом режиме. Обычно команда не требуется, поскольку система запускает эти процессы по мере необходимости. Однако внешняя программа, использующая напрямую gpg-agent или dirmngr, может воспользоваться этой командой, чтобы гарантировать, что они запущены. Если в качестве аргумента КОМПОНЕНТ задано «all», запускаются все компоненты, работающие в фоновом режиме.

--kill [КОМПОНЕНТ]
     Завершить работу заданного компонента. Это поддерживают компоненты gpg-agent и scdaemon. Компоненты, которые этого не поддерживают, игнорируются. Если в качестве аргумента КОМПОНЕНТ задано «all», завершаются все компоненты, работающие в фоновом режиме. Обратите внимание, что на настоящий момент для scdaemon завершение эквивалентно перезагрузке.

--create-socketdir
     Создать каталог для сокетов в  /run/user или /var/run/user. Эта команда нужна, только если применяется отличный от исходного домашний каталог, а сокеты должны находиться в /run. В исходном домашнем каталоге GnuPG создает каталог на ходу.

--remove-socketdir
     Удалить каталог, созданный командой --create-socketdir.

ПАРАМЕТРЫ

Можно использовать параметры:

-o ФАЙЛ
--output ФАЙЛ
     Выводить данные в указанный файл. По умолчанию вывод производится в стандартный поток вывода.

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

-q
--quiet
     Стараться выводить на экран как можно меньше.

-n
--dry-run
     Ничего не менять. Пока это реализовано только для --change-options и может использоваться в целях отладки.

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

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

Формат
------

Некоторые строки в данных на выходе gpgconf содержат список полей, разделенных двоеточием. Установлены следующие соглашения:

  * Пользовательская оболочка должна отсекать в данных на выходе gpgconf завершающие символы перевода строки и возврата каретки.

  * Старые поля никогда не будут отбрасываться. Если определенное поле есть в какой-то версии, это поле всегда будет присутствовать во всех последующих версиях gpgconf.

  * Будущие версии gpgconf могут добавлять поля к концу списка. Новые поля всегда будут отделяться от старых двоеточием. Пользовательская программа должна быть готова считывать последнее известное ей поле до конца строки или до двоеточия.

  * Некоторые поля при некоторых условиях не определены. Содержимое полей, которые не определены, требуется игнорировать.

Для данных поля определено несколько типов:

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

экранированные процентом
     В некоторых полях содержатся строки, которые описываются как экранированные процентом. Из таких строк нужно удалять экранирующие символы перед представлением их пользователю. В этих строках все последовательности %XY заменяются байтом, представляющим шестнадцатеричное число XY. X и Y должны входить в множество 0-9a-f.

переводимые
     В некоторых полях содержатся строки, которые описываются как переводимые. Такие строки переводятся на действующий язык и форматируются в действующей кодировке.

беззнаковое число
     Такие поля содержат неотрицательное число. Это число всегда находится в пределах 32 бит без знака. За числом может следовать пробел с предназначенным для человека описанием величины (если задан параметр --verbose). Все, что следует за числом, нужно игнорировать.

число со знаком
     Такие поля содержат число со знаком. Это число всегда находится в пределах 32 бит со знаком. За числом может следовать пробел с предназначенным для человека описанием величины (если задан параметр --verbose). Все, что следует за числом, нужно игнорировать.

логическая величина
     Такие поля содержат логическую величину. Это число, равное 0 или 1. За числом может следовать пробел с предназначенным для человека описанием величины (если задан параметр --verbose). Все, что следует за числом, нужно игнорировать.

аргумент параметра
     Такие поля содержат аргумент параметра. Формат аргумента зависит от параметра и нескольких признаков:

     без аргумента
          В простейшем случае параметр вообще не требует аргумента (ТИП 0). Тогда аргумент представляет беззнаковое число, которое указывает, сколько раз задан параметр. Если не установлен признак список, аргумент может быть равен только 1. У параметров без аргументов не могут быть установлены признаки исходное и необязательный аргумент.

     число
          Если параметр сопровождается числовым аргументом (ДОП-ТИП равен 2 или 3) и может задаваться только один раз (признак список не установлен), то аргумент параметра либо пуст (допустимо, только когда аргумент не обязателен), либо является числом. Число — это строка, которая начинается с необязательного знака минуса, за которым следует одна или более цифр. Число должно умещаться в целую переменную (беззнаковую или со знаком, в зависимости от значения ДОП-ТИП).

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

     строка
          Если параметр сопровождается аргументом-строкой (ДОП-ТИП равен 1) и может задаваться только один раз (признак список не установлен), то аргумент параметра либо пуст (допустимо, только когда аргумент не обязателен), либо начинается с символа двойной кавычки ("), за которым следует экранированная процентом строка, представляющая значение аргумента. Обратите внимание, что открывающая кавычка есть, а закрывающей — нет. Символ двойной кавычки нужен только для того, чтобы отсутствие аргумента можно было отличать от пустой строки.

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

Действующий язык и кодировка в настоящее время определяются по переменным среды программы gpgconf.

ПРИМЕНЕНИЕ

Перечисление компонентов
------------------------

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

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

Команда --list-components перечисляет все доступные компоненты по одному в строке вида:

ИМЯ:ОПИСАНИЕ:ИМЯ ПРОГРАММЫ:

имя
     В этом поле содержится именная метка компонента. Она используется для указания компонента во всяком обмене с gpgconf. Именную метку следует использовать буквально. Таким образом, в ее формате нет никаких экранирующих символов.

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

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

Пример:

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

Проверка программ
-----------------

Команда --check-programs аналогична --list-components, но работает со служебными программами, а не компонентами. Она запускает каждую программу, чтобы проверить, что та установлена и может выполняться. При этом проводится также проверка синтаксиса всех параметров файла настройки этой программы.

Команда --check-programs перечисляет все доступные программы, по одному в строке вида:

ИМЯ:ОПИСАНИЕ:ИМЯ ПРОГРАММЫ:ДОСТУПНОСТЬ:НОРМА:ФАЙЛ НАСТРОЕК:СТРОКА:ОШИБКА:

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

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

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

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

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

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

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

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

В следующем примере dirmngr не запускается, а в файле настроек scdaemon ошибка.

     $ gpgconf --check-programs
     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:

Команда --check-options КОМПОНЕНТ проверяет файл настроек так же, как это делает --check-programs, но только для заданного компонента.

Перечисление параметров
-----------------------

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

Команда --list-options КОМПОНЕНТ перечисляет все параметры (и группы, в которые они входят) заданного компонента по одному в строке. Компонент должен задаваться именем, которое выводится командой --list-components.

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

Строки имеют вид:

ИМЯ:ПРИЗНАКИ:УРОВЕНЬ:ОПИСАНИЕ:ТИП:ДОП-ТИП:ИМЯ АРГУМЕНТА:ИСХОДНОЕ:ИСХ.АРГ:ЗНАЧЕНИЕ

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

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

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

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

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

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

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

     исходное (16)
          Если этот признак установлен, у параметра есть исходное значение.

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

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

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

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

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

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

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

     невидимый (3)
          В обычных ситуациях элемент отображать не следует — даже для экспертов.

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

     Уровень группы всегда является минимальным уровнем всех входящих в нее параметров.

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

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

     Простые типы:

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

     строка (1)
          Аргумент — неформатированная строка.

     int32 (2)
          Аргумент — число со знаком.

     uint32 (3)
          Аргумент — беззнаковое число.

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

     путь в файловой системе (32)
          Это строка, в которой записан путь до файла. Файл не обязательно существует.

     сервер LDAP (33)
          Это строка, в которой описан сервер LDAP в виде:

          ИМЯ СЕРВЕРА:ПОРТ:ИМЯ ПОЛЬЗОВАТЕЛЯ:ПАРОЛЬ:БАЗА ПОИСКА

     отпечаток ключа (34)
          Это строка с 40-значным отпечатком, определяющим сертификат.

     открытый ключ (35)
          Это строка, которая задает сертификат идентификатором пользователя, идентификатором ключа или отпечатком.

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

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

     В дальнейшем будут добавляться новые типы. О том, как обрабатывать неизвестные типы, см. в описании ДОП-ТИП.

доп-тип
     Это поле идентично полю ТИП, но в нем допустимы значения только от 0 до 31. Пользовательская оболочка должна представлять пользователю параметр в формате, указанном в поле ТИП. Но если аргумент данного типа не поддерживается оболочкой, она может представить его в более общем простом типе, указанном в поле ДОП-ТИП. Пользовательская оболочка должна поддерживать все определенные здесь простые типы, чтобы можно было отображать все параметры. В дальнейшем будут добавляться новые простые типы. Если пользовательская оболочка встречает основной тип, который она не поддерживает, она должна сообщить об ошибке и отменить операцию.

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

исходное
     Это поле определено только для параметров, для которых установлен признак исходное или рабочее исходное. Если установлен признак исходное, формат поля соответствует аргументу параметра (see Формат). Если исходное значение пусто, то оно считается неизвестным. В противном случае содержимое поля указывает исходное значение этого параметра. Если установлен признак рабочее исходное, то поле либо пусто, либо определяет значение параметра, когда он не задан.

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

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

Изменение параметров
--------------------

Команда --change-options КОМПОНЕНТ пытается изменить параметры заданного компонента на указанные. В качестве аргумента задается строка из поля ИМЯ в списке, который выводит команда --list-components. В стандартный поток ввода надо подавать изменяемые параметры в формате:

ИМЯ:ПРИЗНАКИ:НОВОЕ ЗНАЧЕНИЕ

имя
     Имя параметра, который нужно изменить. Это должна быть строка из поля ИМЯ в списке, который выводит команда --list-components.

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

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

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

Команда выводит то же, что и --check-options, для измененного файла настроек.

Примеры:

Установить параметр force, который имеет тип пустой (0):

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

Сбросить параметр force:

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

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

Список глобальных параметров
----------------------------

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

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

     k:ПОЛЬЗОВАТЕЛЬ:ГРУППА:

     пользователь
          Это пользовательское поле ключа, оно экранировано процентом. Подробности см. в определении формата gpgconf.conf.

     группа
          Это поле группы ключа, оно экранировано процентом.

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

     r:::КОМПОНЕНТ:ПАРАМЕТР:ПРИЗНАК:ЗНАЧЕНИЕ:

     компонент
          Эта часть содержит компонент. Это простая строка.

     параметр
          Эта часть содержит параметр. Это простая строка.

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

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

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

Получить и сравнить версии программ.
------------------------------------

Проект GnuPG предоставляет сервер для запроса текущих версий пакетов программ, относящихся к GnuPG. Для доступа к это базе данных в сети можно применять gpgconf. Чтобы обеспечить возможность работы без сети, при выполнении этой операции dirmngr получает файл из https://versions.gnupg.org, проверяя подпись этого файла и сохраняя его в домашнем каталоге GnuPG. Если gpgconf вызывается, когда работает dirmngr, первый может запросить у последнего обновление этого файла перед тем, как использовать его.

Команда --query-swdb возвращает сведения по заданному пакету в формате с двоеточиями в качестве ограничителей:

имя
     Это имя запрошенного пакета. Обратите внимание, что «gnupg» является специальным именем, которое заменяется на конкретный пакет, реализующий эту версию GnuPG. Для этого имени также не требуется указывать версию, потому что gpgconf в этом случае берет версию самого себя.

iversion
     Установленная в настоящий момент версия или пустая строка. Значение берется из аргумента командной строки, но если оно не задано, его может заполнять gpg.

status
     Статус пакета согласно таблице:

     -
          Нет сведений — либо потому, что не указана текущая версия, либо из-за ошибки.

     ?
          Данное имя в сетевой базе данных отсутствует.

     u
          Есть более новая версия программы.

     c
          Установлена самая последняя версия.

     n
          Установленная версия новее последнего выпуска.

urgency
     Если значение больше нуля, доступно важное обновление. Пустая строка считается нулем.

ошибка
     Возвращает код ошибки gpg-error для диагностики.

filedate
     Возвращает дату файла с номерами версий в стандартном формате ИСО (ггггммддTччммсс). Дату dirmngr извлекает из подписи файла.

verified
     Дата, когда файл был получен, в формате ИСО. Может использоваться для оценки свежести данных.

version
     Возвращает строку из файла с версией заданной программы.

reldate
     Возвращает дату выпуска в формате ИСО.

size
     Возвращает размер пакета в байтах в виде десятичного числа.

hash
     Возвращает SHA-2 пакета в шестнадцатеричном виде.

В будущем могут быть добавлены новые поля.

ФАЙЛЫ

Файлы gpgconf
-------------

/etc/gnupg/gpgconf.conf
     Если этот файл существует, он обрабатывается как файл глобальных настроек. Прокомментированный пример можно найти в каталоге examples дистрибутива.

GNUPGHOME/swdb.lst
     Файл с текущими версиями программ. Создается из сетевого источника программой dirmngr по мере необходимости.

СМ. ТАКЖЕ
     [file see-also-note.ru.texi not included]

applygnupgdefaults.ru.8

Выполнение gpgconf для всех пользователей
=========================================

ВЫЗОВ

ОПИСАНИЕ
Программа представляет обертку gpgconf для выполнения команды --apply-defaults для всех настоящих пользователей, у которых есть домашний каталог GnuPG. Программа может быть полезна администраторам для обновления файлов настроек GnuPG для всех пользователей после изменения /etc/gnupg/gpgconf.conf. Это позволяет устанавливать определенные правила для всех пользователей. Обратите внимание, что это не является надежным способом заставить пользователя применять определенные настройки. Пользователь всегда может отредактировать файлы настроек напрямую и обойти gpgconf.

Команда applygnupgdefaults вызывается от имени суперпользователя:

     applygnupgdefaults

Занесение фразы-пароля в буфер
==============================

gpg-preset-passphrase.ru.1

ВЫЗОВ

ОПИСАНИЕ
Программа gpg-preset-passphrase представляет утилиту для заполнения внутреннего буфера работающего gpg-agent фразами-паролями. Она полезна главным образом для машин, администрируемых по сети, на которых обычное средство ввода пароля pinentry применяться не может и фразы-пароли к ключам задаются при загрузке машины.

Срок действия фраз-паролей, заданных этой программой, не истекает, если не введен параметр --forget, явным образом очищающий буфер, или если не перезапускается программа gpg-agent (сигналом SIGHUP). Обратите внимание, что максимальное время хранения в буфере, задаваемое параметром --max-cache-ttl, все так же учитывается. Задание фраз-паролей должно быть разрешено при запуске gpg-agent параметром --allow-preset-passphrase.

Список всех команд и параметров
-------------------------------

gpg-preset-passphrase вызывается так:

     gpg-preset-passphrase [параметры] [команда] ИДЕНТИФИКАТОР БУФЕРА

ИДЕНТИФИКАТОР БУФЕРА представляет либо 40-символьный шестнадцатеричный код ключа, идентифицирующей ключ, для которого нужно установить или сбросить фразу-пароль. Код ключа можно узнать с помощью команды gpgsm --dump-secret-keys. В качестве идентификатора буфера можно также применять произвольную строку, которая идентифицирует фразу-пароль; предлагается приписывать в начале такой строки имя программы (напр., foo:12346).

Должна быть задана одна из команд:

--preset
     Установить фразу-пароль. Обычно этим вы и будете пользоваться. При этом gpg-preset-passphrase будет читать фразу-пароль из стандартного потока ввода.

--forget
     Сбросить фразу-пароль для указанного идентификатора буфера.

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

-v
--verbose
     Выводить во время работы дополнительные сведения.

-P СТРОКА
--passphrase СТРОКА
     Вместо чтения фразы-пароля из стандартного потока ввода использовать в качестве фразы-пароля аргумент. Обратите внимание, что это делает фразу-пароль видимой для других пользователей.

СМ. ТАКЖЕ
     [file see-also-note.ru.texi not included]

Соединение с работающей программой-агентом
==========================================

gpg-connect-agent.ru.1

ВЫЗОВ

ОПИСАНИЕ
Программа gpg-connect-agent представляет утилиту для связи с работающим gpg-agent. Она полезна для проверки команд, выполнение которых gpg-agent обеспечивает по протоколу Assuan. Она может быть также полезна для написания простых программ-сценариев. Программа читает из стандартного потока ввода и печатает результаты в стандартный поток вывода.

Это очень похоже на выполнение gpg-agent в режиме сервера, но здесь мы подключаемся к работающему экземпляру.

Список всех параметров
----------------------

gpg-connect-agent вызывается так:

     gpg-connect-agent [параметры] [команды]

Можно использовать параметры:

-v
--verbose
     Выводить во время работы дополнительные сведения.

-q

--quiet
     Стараться выводить на экран как можно меньше.

          [file opt-homedir.ru.texi not included]

--agent-program ФАЙЛ
     Указать программу-агент для запуска, если она еще не выполняется. Исходное значение определяется вызовом gpgconf с параметром --list-dirs. Обратите внимание, что символ конвейера («|») применяется для регрессионного тестирования и поэтому не может появляться в имени файла.

--dirmngr-program ФАЙЛ
     Указать программу диспетчера каталогов (клиент сервера ключей), которая будет запущена, если она еще не выполняется. Это влияет на работу, только когда задан параметр --dirmngr.

--dirmngr
     Соединяться с работающим диспетчером каталогов (клиентом сервера ключей) вместо gpg-agent. Если dirmngr не работает, запустить его.

-S
--raw-socket ИМЯ
     Подключиться к заданному сокету, предполагая, что это сервер типа Assuan. Не проводить никаких особых инициализаций и проверок среды. Таким образом можно напрямую подключаться к любому серверу сокетов типа Assuan.

-E
--exec
     Использовать остальную часть командной строки как программу и аргументы и вызвать ее как сервер Assuan. Вот как это делается с gpgsm:

           gpg-connect-agent --exec gpgsm --server

     Обратите внимание, что в этом случае нельзя использовать параметры в командной строке.

--no-ext-connect
     При вызове с -S или --exec команда gpg-connect-agent подключается к серверу Assuan в расширенном режиме, чтобы можно было передавать дескрипторы. Этот параметр переводит ее в старый режим.

--no-autostart
     Не запускать gpg-agent и dirmngr, если они еще не запущены.

-r ФАЙЛ
--run ФАЙЛ
     Выполнить при запуске команды из указанного файла, а затем перейти к обычному режиму ввода. Обратите внимание, что команды, переданные в командной строке, выполняются после этого файла.

-s
--subst
     Выполнить при запуске команду /subst.

--hex
     Выводить строки данных в шестнадцатеричном формате и текстовом представлении неуправляющих символов.

--decode
     Декодировать строки данных. Это удаляет экранирующие проценты, но строки всегда начинаются с «D» и пробела.

КОМАНДЫ УПРАВЛЕНИЯ

Команды управления
------------------

При чтении команд Assuan gpg-agent допускает также несколько специальных команд для управления работой. Эти управляющие команды начинаются с косой черты (/).

/echo АРГУМЕНТЫ
     Просто вывести АРГУМЕНТЫ.

/let ИМЯ ЗНАЧЕНИЕ
     Присвоить переменой ИМЯ заданное ЗНАЧЕНИЕ. Переменные заменяются на свои значения в данных на входе, только если была введена команда /subst. На переменную указывает знак доллара, имя переменной может включаться также в необязательные фигурные скобки. Ограничения на имена идентичны ограничениям в стандартном командном интерпретаторе Борна. Проверки пока нет, но она может быть введена в будущем. Внутри фигурных скобок в начале и в конце пробелы недопустимы.

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

     Можно вызывать функции переменных: за именем функции должен следовать по меньшей мере один пробел и по меньшей мере один аргумент. Определены следующие функции:

     get
          Возвращает значение, описанное аргументом. Доступны аргументы:

          cwd
               Текущий рабочий каталог.

          homedir
               Домашний каталог GnuPG.

          sysconfdir
               Каталог системных настроек GnuPG.

          bindir
               Каталог исполняемых файлов GnuPG.

          libdir
               Каталог библиотек GnuPG.

          libexecdir
               Каталог библиотек исполняемых файлов GnuPG.

          datadir
               Каталог данных GnuPG.

          serverpid
               Идентификатор процесса текущего сервера. Чтобы получить осмысленное значение, перед этим нужно вызвать команду /serverpid.

     unescape АРГУМЕНТЫ
          Удалить экранирующие символы в стиле Си из аргументов. Обратите внимание, что \0 и \x00 неявным образом завершают строку. В качестве преобразуемой строки берутся все аргументы направо от пробела, ограничивающего имя функции.

     unpercent АРГУМЕНТЫ
     unpercent+ АРГУМЕНТЫ
          Удалить экранирующие пробелы из аргументов. Обратите внимание, что %00 неявным образом завершает строку. В качестве преобразуемой строки берутся все аргументы направо от пробела, ограничивающего имя функции. unpercent+ переводит также знаки плюса в пробелы.

     percent АРГУМЕНТЫ
     percent+ АРГУМЕНТЫ
          Экранировать аргументы символом процента. Экранируются символы табуляции, конца страницы, конца строки, перевода каретки, а также двоеточия. percent+ переводит также пробелы в знаки плюса.

     errcode АРГУМЕНТ
     errsource АРГУМЕНТ
     errstring АРГУМЕНТ
          Считать аргумент целым числом и прочесть его с помощью strtol. Возвратить код ошибки gpg-error, источник ошибки или форматированную строку с кодом и источником ошибки.

     +
     -
     *
     /
     %
          Прочесть все аргументы в виде целых чисел типа long с помощью strtol и применить эту операцию. Деление на ноль дает пустую строку.

     !
     |
     &
          Прочесть все аргументы в виде целых чисел типа long с помощью strtol и применить логическую операцию НЕ, ИЛИ или И. Оператор НЕ действует только на последний аргумент.

/definq ИМЯ ПЕРЕМЕННАЯ
     Использовать содержимое указанной переменной для запросов с указанным именем. Если в качестве имени задана звездочка (*), это соответствует любым запросам.

/definqfile ИМЯ ФАЙЛ
     Использовать содержимое указанного файла для запросов с указанным именем. Если в качестве имени задана звездочка (*), это соответствует любым запросам.

/definqprog ИМЯ ПРОГРАММА
     Выполнять указанную программу для запросов с указанным именем, передавая всю строку в качестве аргументов командной строки.

/datafile ИМЯ
     Записывать все строки данных из сервера в указанный файл. Файл открывается для записи и создается, если не существует. Из существующего файла данные удаляются. Данные записываются в файл в полностью декодированном виде. Если в качестве имени задан «-», данные записываются в стандартный поток вывода. Файл остается открытым до тех пор, пока не будет задан новый файл или эта команда не будет введена без аргумента.

/showdef
     Вывести все определения

/cleardef
     Сбросить все определения

/sendfd ФАЙЛ РЕЖИМ
     Открыть указанный файл в заданном режиме (который должен быть допустимой строкой режима fopen) и выслать файловый дескриптор серверу. За этим обычно следует команда, подобная INPUT FD, чтобы установить источник ввода для других команд.

/recvfd
     Пока не реализовано.

/open ПЕРЕМЕННАЯ ФАЙЛ [РЕЖИМ]
     Открыть указанный файл и присвоить файловый дескриптор указанной переменной. Внимание: это экспериментальная команда, в будущих версиях она может поменяться.

/close FD
     Закрыть данный файловый дескриптор. Внимание: это экспериментальная команда, в будущих версиях она может поменяться.

/showopen
     Показать список открытых файлов.

/serverpid
     Отправить на сервер команду Assuan GETINFO pid и сохранить возвращенный идентификатор процесса для внутренних нужд.

/sleep
     Заснуть на секунду.

/hex
/nohex
     То же, что параметр командной строки --hex.

/decode
/nodecode
     То же, что параметр командной строки --decode.

/subst
/nosubst
     Включить и выключить подстановку переменных. В исходном состоянии выключена, если не задан параметр командной строки --subst. Если /subst включается один раз, из начала входных строк удаляются пробелы, чтобы их было легче читать.

/while УСЛОВИЕ
/end
     С помощью этих команд вводятся циклы. Все строки между while и соответствующим end выполняются, пока результат вычисления условия равен ненулевому числу, строке true или строке yes. Числа определяются функцией strtol. Пример:

            /subst
            /let i 3
            /while $i
              /echo счетчик цикла равен $i
              /let i ${- $i 1}
            /end

/if УСЛОВИЕ
/end
     С помощью этих команд вводится условное выполнение. Все строки между if и соответствующим end выполняются, если результат вычисления условия равен ненулевому числу, строке true или строке yes. Числа определяются функцией strtol.

/run ФАЙЛ
     Выполнить команды из указанного файла.

/bye
     Разорвать соединение и выйти из программы.

/help
     Вывести список доступных управляющих команд.

Программа-клиент Dirmngr
========================

dirmngr-client.ru.1

ВЫЗОВ

ОПИСАНИЕ
Программа dirmngr-client представляет простое средство обращения к работающему dirmngr и проверки, отозван ли сертификат — либо перечислением в соответствующем списке отозванных сертификатов, либо по протоколу OCSP. Если dirmngr не работает, будут запускаться новые экземпляры, но в целом это не хорошо, потому что связано с огромной потерей производительности.

Обычно это средство запускают с помощью командной строки

     dirmngr-client СЕРТИФИКАТ

или

     dirmngr-client <СЕРТИФИКАТ

Где СЕРТИФИКАТ содержит закодированные по DER (двоичные) сертификаты X.509, которые нужно проверить. Командой возвращается значение:

КОД ВЫХОДА

0
     Рассматриваемый сертификат достоверен, т.е. есть действительный список отозванных сертификатов, в котором он не перечислен, или запрос по OCSP показал, что сертификат достоверен.

1
     Сертификат отозван

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

ПАРАМЕТРЫ

dirmngr-client можно вызывать со следующими параметрами:

--version
     Вывести версию программы и лицензионные сведения. Эту команду нельзя сокращать (напр., как --versio).

--help, -h
     Вывести подсказку по наиболее полезным параметрам командной строки. Эту команду нельзя сокращать (напр., как --hel).

--quiet, -q
     Сократить вывод, подавив все информационные сообщения.

-v

--verbose
     Выводить во время работы дополнительную информацию. Уровень подробности можно повышать, вводя параметр несколько раз, например, -vv.

--pem
     Считать, что данный сертификат поступает в формате PEM (текстовом).

--ocsp
     Проводить проверку по протоколу OCSP, не учитывая никаких списков отозванных сертификатов.

--force-default-responder
     При проверке по протоколу OCSP принудительно пользоваться исходным ответчиком OCSP. Не пользоваться ответчиком, заданным в сертификате.

--ping
     Проверить, работает ли демон dirmngr.

--cache-cert
     Поместить данный сертификат в буфер работающего dirmngr. Это полезно в основном для отладки.

--validate
     Проверить данный сертификат с помощью внутренней процедуры dirmngr. Это полезно в основном для отладки.

--load-crl
     Команда ожидает список имен файлов, хранящих списки отозванных сертификатов в кодировке DER. С параметром --url ожидаются URL вместо имен файлов, они будут загружаться прямо из заданного адреса. Все списки отозванных сертификатов будут проверяться и загружаться в буфер dirmngr.

--lookup
     Взять оставшиеся аргументы и выполнить команду поиска над каждым из них. Результаты кодируются в base-64 (без заголовочных строк). Этим можно пользоваться для извлечения сертификатов с сервера. Однако формат данных на выходе не очень удобен, когда возвращается более одного сертификата.

--url
-u
     Задать URL в качестве аргумента в командах lookup и load-crl.

--local
-l
     Ограничить команду lookup поиском в локальном буфере.

--squid-mode
     Выполнить dirmngr-client в режиме вспомогательной программы для параметра Squid external_acl_type.

Разбор и аннотация почтового сообщения
======================================

gpgparsemail.ru.1

ВЫЗОВ

ОПИСАНИЕ
gpgparsemail представляет утилиту, в настоящее время полезную только для отладки. Для справки вызывайте ее с параметром --help.

Вызов простого средства симметричного шифрования
================================================

symcryptrun.ru.1

ВЫЗОВ

ОПИСАНИЕ
Иногда уже применяются простые средства шифрования, которые может быть желательно интегрировать в каркас GnuPG. Протоколы и методы шифрования могут быть нестандартны или даже недостаточно документированы, так что сделать из них полноценное средство шифрования с таким интерфейсом, как у gpg, нереально. Программа symcryptrun решает эту задачу: она работает, вызывая внешний модуль шифрования-расшифровки и передает фразу-пароль для ключа с помощью механизма на базе обычной программы ввода пароля pinentry при посредстве gpg-agent.

Обратите внимание, что symcryptrun доступна, только когда GnuPG настроен с параметром --enable-symcryptrun во время сборки.

Список всех команд и параметров
-------------------------------

symcryptrun вызывается так:

     symcryptrun --class класс --program программа --keyfile файл ключа
        [--decrypt | --encrypt] [входной файл]

Для шифрования открытый текст должен передаваться по стандартному потоку ввода или через аргумент ВХОДНОЙ ФАЙЛ, а зашифрованный текст будет выводиться в стандартный поток вывода. Для расшифровки — наоборот.

Аргумент КЛАСС описывает соглашения вызова внешнего средства. В настоящее время это должен быть confucius. Аргумент ПРОГРАММА представляет полное имя этого внешнего средства.

Для класса confucius параметр --keyfile обязателен; он задает имя файла, содержащего секретный ключ, который может быть защищен фразой-паролем. Подробности соглашений вызова см. в исходном тексте программы.

Обратите внимание, что на момент вызова symcryptrun должен работать gpg-agent.

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

-v
--verbose
     Выводить во время работы дополнительные сведения.

-q

--quiet
     Стараться выводить на экран как можно меньше.

          [file opt-homedir.ru.texi not included]

--log-file ФАЙЛ
     Дописывать протокол работы в указанный файл. Укажите socket://, если нужно протоколировать в сокет. По умолчанию эта информация выводится в стандартный поток ошибок.

Возможные коды выхода symcryptrun:

0
     Успех.

1
     Произошла ошибка.

2
     Не получена верная фраза-пароль.

3
     Операция отменена пользователем.

СМ. ТАКЖЕ
     [file see-also-note.ru.texi not included]

gpg-zip.ru.1

Зашифровать или подписать файлы в архив
=======================================

ВЫЗОВ

ОПИСАНИЕ
gpg-zip шифрует и подписывает файлы в архив. Это gpg-ованный архив того же формата, что используется программой PGP Zip.

gpg-zip вызывается так:

     gpg-zip [параметры] ИМЯ_ФАЙЛА1 [ИМЯ_ФАЙЛА2, ...] КАТАЛОГ [КАТАЛОГ2, ...]

ПАРАМЕТРЫ

gpg-zip распознает параметры:

--encrypt
-e
     Зашифровать данные. Этот параметр можно комбинировать с --symmetric (чтобы вывод можно было расшифровывать секретным ключом или фразой-паролем).

--decrypt
-d
     Расшифровать данные.

--symmetric
-c
     Зашифровать симметричным шифром с помощью фразы-пароля. Исходный симметричный шифр — CAST5, но можно выбрать другой параметром --cipher-algo команды gpg.

--sign
-s
     Сделать подпись. См. gpg.

--recipient ПОЛЬЗОВАТЕЛЬ
-r ПОЛЬЗОВАТЕЛЬ
     Зашифровать для заданного идентификатора пользователя. См. gpg.

--local-user ПОЛЬЗОВАТЕЛЬ
-u ПОЛЬЗОВАТЕЛЬ
     Подписать с помощью заданного ключа. См. gpg.

--list-archive
     Вывести оглавление указанного архива.

--output ФАЙЛ
-o ФАЙЛ
     Выводить данные в указанный файл.

--gpg КОМАНДА
     Пользоваться вместо gpg указанной командой.

--gpg-args АРГУМЕНТЫ
     Передать в gpg указанные параметры.

--tar КОМАНДА
     Пользоваться вместо tar указанной командой.

--tar-args АРГУМЕНТЫ
     Передать в tar указанные параметры.

--version
     Вывести версию программы и завершить работу.

--help
     Показать краткую справку и завершить работу.

ДИАГНОСТИКА

Программа возвращает 0, если все в норме, в противном случае 1.

ПРИМЕРЫ

Несколько примеров:

Зашифровать содержимое каталога mydocs для пользователя Вова в файл test1:

     gpg-zip --encrypt --output test1 --gpg-args -r Вова mydocs

Вывести оглавление архива test1:

     gpg-zip --list-archive test1

СМ. ТАКЖЕ
     [file see-also-note.ru.texi not included]