1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00

rnp : fix XML by converting para to simpara tags via script

This commit is contained in:
Gina Peter Banyard
2026-01-25 16:13:25 +00:00
parent 8d0db71948
commit 8df700ce72
37 changed files with 389 additions and 389 deletions

View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 858059e0482cabe7aa5c91d852ae8ff00f0a5cb7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<!-- State: experimental -->
<book xml:id="book.rnp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.rnp">
<?phpdoc extension-membership="pecl" ?>
<title>Rnp</title>
<titleabbrev>Rnp</titleabbrev>
@@ -10,11 +10,11 @@
<preface xml:id="intro.rnp">
&reftitle.intro;
&warn.experimental;
<para>
<simpara>
Модуль открывает доступ к библиотеке <link xlink:href="&url.rnp;">RNP</link>.
RNP — высокопроизводительная библиотека OpenPGP на языке программирования C++,
с которой работает почтовый клиент Mozilla Thunderbird.
</para>
</simpara>
</preface>
&reference.rnp.setup;

View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<section xml:id="rnp.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="rnp.installation">
&reftitle.install;
<para>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;rnp">&url.pecl.package;rnp</link>
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file

View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="rnp.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="rnp.examples">
&reftitle.examples;
<section xml:id="rnp.examples-clearsign">
<title>Подписание текста</title>
<para>
<simpara>
В данном примере будет подписание заданного текста.
</para>
</simpara>
<example>
<title>Пример расчёта RNP</title>
<programlisting role="php">

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-backend-string" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-backend-string">
<refnamediv>
<refname>rnp_backend_string</refname>
<refpurpose>Возвращает имя библиотеки криптографического бэкенда</refpurpose>
@@ -11,11 +11,11 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>rnp_backend_string</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -27,9 +27,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Строка имени бэкенда. В настоящее время поддерживаются следующие: "Botan" и "OpenSSL".
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-backend-version" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-backend-version">
<refnamediv>
<refname>rnp_backend_version</refname>
<refpurpose>Возвращает версию криптографической библиотеки бэкенда</refpurpose>
@@ -11,11 +11,11 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>rnp_backend_version</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает версию в виде строки.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-decrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-decrypt">
<refnamediv>
<refname>rnp_decrypt</refname>
<refpurpose>Расшифровывает сообщение PGP</refpurpose>
@@ -14,11 +14,11 @@
<methodparam><type>RnpFFI</type><parameter>ffi</parameter></methodparam>
<methodparam><type>string</type><parameter>input</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Закрытые ключи, используемые для расшифровки, должны быть загружены в объект FFI перед вызовом функции.
Если использовалось шифрование паролем, то провайдер пароля должен быть установлен
вызовом функции <function>rnp_ffi_set_pass_provider</function>.
</para>
</simpara>
</refsect1>
@@ -28,17 +28,17 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
<simpara>
Зашифрованное сообщение.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -46,9 +46,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Расшифрованное сообщение в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-dump-packets-to-json" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-dump-packets-to-json">
<refnamediv>
<refname>rnp_dump_packets_to_json</refname>
<refpurpose>Выгрузка информации о потоке пакетов OpenPGP в строку JSON</refpurpose>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>input</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
<simpara>
Входная строка, содержащая данные OpenPGP в двоичном или ASCII-закодированном формате.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
Смотрите предопределённые константы <constant>RNP_JSON_DUMP_<replaceable>*</replaceable></constant>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,9 +44,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Строка JSON с выводом&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-dump-packets" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-dump-packets">
<refnamediv>
<refname>rnp_dump_packets</refname>
<refpurpose>Выгружает информацию о потоке пакетов OpenPGP в человеко-читаемом формате</refpurpose>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>input</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
<simpara>
Входная строка, содержащая данные OpenPGP в двоичном или ASCII-закодированном формате.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
Смотрите предопределённые константы <constant>RNP_DUMP_<replaceable>*</replaceable></constant>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,9 +44,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Текст, описывающий последовательность пакетов&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-ffi-create" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-ffi-create">
<refnamediv>
<refname>rnp_ffi_create</refname>
<refpurpose>Создаёт объект верхнего уровня, используемый для взаимодействия с библиотекой</refpurpose>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>pub_format</parameter></methodparam>
<methodparam><type>string</type><parameter>sec_format</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -27,17 +27,17 @@
<varlistentry>
<term><parameter>pub_format</parameter></term>
<listitem>
<para>
<simpara>
Формат открытого ключа, RNP_KEYSTORE_GPG или другая константа RNP_KEYSTORE_*.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>sec_format</parameter></term>
<listitem>
<para>
<simpara>
Формат закрытого ключа, RNP_KEYSTORE_GPG или другая константа RNP_KEYSTORE_*.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -45,9 +45,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает объект <type>RnpFFI</type> в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-ffi-destroy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-ffi-destroy">
<refnamediv>
<refname>rnp_ffi_destroy</refname>
<refpurpose>Уничтожает объект верхнего уровня, используемый для взаимодействия с библиотекой</refpurpose>
@@ -13,9 +13,9 @@
<type>void</type><methodname>rnp_ffi_destroy</methodname>
<methodparam><type>RnpFFI</type><parameter>ffi</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -25,9 +25,9 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -35,9 +35,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
</para>
</simpara>
</refsect1>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8e27a460226d3bf8f9ab700089b80536d9f9359a Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-ffi-set-pass-provider">
<refnamediv>
@@ -14,12 +14,12 @@
<methodparam><type>RnpFFI</type><parameter>ffi</parameter></methodparam>
<methodparam><type>callable</type><parameter>password_callback</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Устанавливает callback-функцию поставщика пароля. Функция может запрашивать пароль на стандартном входе
(если PHP скрипт выполняется в среде командной строки), отображать диалог GUI или предоставлять пароль
любым другим возможным способом. Запрашиваемые пароли используются для шифрования или расшифровки
секретных ключей или выполнения операций симметричного шифрования/дешифрования.
</para>
</simpara>
</refsect1>
@@ -29,9 +29,9 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -59,9 +59,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-import-keys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-import-keys">
<refnamediv>
<refname>rnp_import_keys</refname>
<refpurpose>Импортирует ключи из строки PHP в связку ключей и получает JSON с описанием новых/обновлённых ключей</refpurpose>
@@ -15,8 +15,8 @@
<methodparam><type>string</type><parameter>input</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
</para>
<simpara>
</simpara>
</refsect1>
@@ -26,25 +26,25 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
<simpara>
Пакеты OpenPGP, содержащие ключ(и), которые нужно загрузить. Могут быть бинарными или ASCII-закодированными.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
Смотрите предопределённые константы <constant>RNP_LOAD_SAVE_<replaceable>*</replaceable></constant>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,9 +52,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
JSON-строка с информацией о новых и обновлённых ключах в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-import-signatures" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-import-signatures">
<refnamediv>
<refname>rnp_import_signatures</refname>
<refpurpose>Импортирует автономные подписи в связку ключей и получает JSON с описанием обновлённых ключей</refpurpose>
@@ -15,8 +15,8 @@
<methodparam><type>string</type><parameter>input</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
</para>
<simpara>
</simpara>
</refsect1>
@@ -26,25 +26,25 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
<simpara>
Пакеты OpenPGP, содержащие подписи, которые необходимо импортировать. Могут быть бинарными или ASCII-закодированными.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
В настоящее время должно быть 0.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,9 +52,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
JSON-строка с информацией об обновлённых ключах в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-key-export-autocrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-key-export-autocrypt">
<refnamediv>
<refname>rnp_key_export_autocrypt</refname>
<refpurpose>Экспортирует минимальный ключ для функции автоматического шифрования
@@ -18,8 +18,8 @@
<methodparam><type>string</type><parameter>uid</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
</para>
<simpara>
</simpara>
</refsect1>
@@ -29,44 +29,44 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_fp</parameter></term>
<listitem>
<para>
<simpara>
Цифровой отпечаток первичного ключа.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>subkey_fp</parameter></term>
<listitem>
<para>
<simpara>
Дочерний ключ для экспорта. Может быть пустой строкой,
чтобы выбрать первый подходящий дочерний ключ.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>uid</parameter></term>
<listitem>
<para>
<simpara>
Идентификатор пользователя для экспорта. Может быть пустой строкой,
если у экспортируемого ключа только один uid.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
В настоящее время поддерживается только <constant>RNP_KEY_EXPORT_BASE64</constant>.
Включение приведёт к экспорту данных ключа в кодировке base64 вместо двоичной.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -74,9 +74,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
OpenPGP-пакеты экспортированного ключа в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-key-export-revocation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-key-export-revocation">
<refnamediv>
<refname>rnp_key_export_revocation</refname>
<refpurpose>Генерирует и экспортирует подпись отзыва первичного ключа</refpurpose>
@@ -16,10 +16,10 @@
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Примечание: чтобы отозвать ключ, вам нужно импортировать подпись в хранилище ключей
или воспользоваться функцией <function>rnp_key_revoke</function>.
</para>
</simpara>
</refsect1>
@@ -29,33 +29,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_fp</parameter></term>
<listitem>
<para>
<simpara>
Цифровой отпечаток первичного ключа, который должен быть отозван.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
<constant>RNP_KEY_EXPORT_ARMORED</constant> или 0.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -92,9 +92,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Экспортированная подпись отзыва в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-key-export" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-key-export">
<refnamediv>
<refname>rnp_key_export</refname>
<refpurpose>Экспортирует ключ</refpurpose>
@@ -15,8 +15,8 @@
<methodparam><type>string</type><parameter>key_fp</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
</para>
<simpara>
</simpara>
</refsect1>
@@ -26,26 +26,26 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_fp</parameter></term>
<listitem>
<para>
<simpara>
Цифровой отпечаток ключа.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
Смотрите предопределённые константы <constant>RNP_KEY_EXPORT_<replaceable>*</replaceable></constant>
(за исключением <constant>RNP_KEY_EXPORT_BASE64</constant>).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -53,9 +53,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
OpenPGP-пакеты экспортированного ключа (двоичные или ASCII-закодированные) в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-key-get-info" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-key-get-info">
<refnamediv>
<refname>rnp_key_get_info</refname>
<refpurpose>Получает информацию о ключе</refpurpose>
@@ -14,9 +14,9 @@
<methodparam><type>RnpFFI</type><parameter>ffi</parameter></methodparam>
<methodparam><type>string</type><parameter>key_fp</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_fp</parameter></term>
<listitem>
<para>
<simpara>
Цифровой отпечаток ключа.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,9 +44,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Ассоциативный массив с информацией о ключе&return.falseforfailure;.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-key-remove" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-key-remove">
<refnamediv>
<refname>rnp_key_remove</refname>
<refpurpose>Удаляет ключ из связки (связок)</refpurpose>
@@ -15,9 +15,9 @@
<methodparam><type>string</type><parameter>key_fp</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Примечание: необходимо вызвать функцию <function>rnp_save_keys</function> для записи обновлённых связок ключей.
</para>
</simpara>
</refsect1>
@@ -27,26 +27,26 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_fp</parameter></term>
<listitem>
<para>
<simpara>
Цифровой отпечаток ключа.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
Смотрите константы <constant>RNP_KEY_REMOVE_<replaceable>*</replaceable></constant>.
Флаг <constant>RNP_KEY_REMOVE_SUBKEYS</constant> будет работать только для первичного ключа и удалит также все его подключи.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,9 +54,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-key-revoke" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-key-revoke">
<refnamediv>
<refname>rnp_key_revoke</refname>
<refpurpose>Отзывает ключ или дочерний ключ путём создания и добавления подписи отзыва</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Примечание: необходимо вызвать функцию <function>rnp_save_keys</function> для записи обновлённых связок ключей.
</para>
</simpara>
</refsect1>
@@ -28,33 +28,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_fp</parameter></term>
<listitem>
<para>
<simpara>
Цифровой отпечаток ключа.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
В настоящее время должно быть 0.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -91,9 +91,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-list-keys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-list-keys">
<refnamediv>
<refname>rnp_list_keys</refname>
<refpurpose>Перечисляет все ключи, присутствующие в связке ключей, по указанному типу идентификатора</refpurpose>
@@ -14,9 +14,9 @@
<methodparam><type>RnpFFI</type><parameter>ffi</parameter></methodparam>
<methodparam><type>string</type><parameter>identifier_type</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>identifier_type</parameter></term>
<listitem>
<para>
<simpara>
Тип идентификатора ключа ("userid", "keyid", "grip", "fingerprint").
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,9 +44,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Ассоциативный массив, где ключ - строка идентификатора, а значение - цифровой отпечаток ключа PGP&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-load-keys-from-path" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-load-keys-from-path">
<refnamediv>
<refname>rnp_load_keys_from_path</refname>
<refpurpose>Загружает ключи из указанного пути</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>input_path</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Обратите внимание, что для G10 входными данными должен быть каталог (который должен уже существовать).
</para>
</simpara>
</refsect1>
@@ -28,33 +28,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.key-format;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>input_path</parameter></term>
<listitem>
<para>
<simpara>
Файл или каталог, содержащий ключи.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.loadsave-flags;
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -62,9 +62,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-load-keys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-load-keys">
<refnamediv>
<refname>rnp_load_keys</refname>
<refpurpose>Загружает ключи из строки PHP</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>input</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Обратите внимание, что для G10 входными данными должен быть каталог (который должен уже существовать).
</para>
</simpara>
</refsect1>
@@ -28,33 +28,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.key-format;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
<simpara>
Пакеты OpenPGP, содержащие ключ(и), которые нужно загрузить. Могут быть бинарными или ASCII-закодированными.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.loadsave-flags;
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -62,9 +62,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-locate-key" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-locate-key">
<refnamediv>
<refname>rnp_locate_key</refname>
<refpurpose>Поиск ключа</refpurpose>
@@ -15,9 +15,9 @@
<methodparam><type>string</type><parameter>identifier_type</parameter></methodparam>
<methodparam><type>string</type><parameter>identifier</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Примечание: при поиске по userid проверяются только действительные имена пользователей.
</para>
</simpara>
</refsect1>
@@ -27,26 +27,26 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>identifier_type</parameter></term>
<listitem>
<para>
<simpara>
Строка типа идентификатора: "userid", "keyid", "fingerprint", "grip".
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>identifier</parameter></term>
<listitem>
<para>
<simpara>
PGP идентификатор пользователя (имя и e-mail) для типа "userid", шестнадцатеричная строка,
которая представляет собой идентификатор ключа, цифровой отпечаток или захват ключа соответственно.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,9 +54,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает шестнадцатеричный цифровой отпечаток ключа, найденного в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-encrypt">
<refnamediv>
<refname>rnp_op_encrypt</refname>
<refpurpose>Шифрует сообщение</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>array</type><parameter>recipient_keys_fp</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -28,33 +28,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>message</parameter></term>
<listitem>
<para>
<simpara>
Сообщение, которое необходимо зашифровать.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>recipient_keys_fp</parameter></term>
<listitem>
<para>
<simpara>
Массив с отпечатками ключей получателя. Должен присутствовать хотя бы один ключ.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -162,9 +162,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Зашифрованные данные в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-generate-key" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-generate-key">
<refnamediv>
<refname>rnp_op_generate_key</refname>
<refpurpose>Генерирует ключ</refpurpose>
@@ -17,9 +17,9 @@
<methodparam choice="opt"><type>string</type><parameter>sub_alg</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -30,43 +30,43 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>userid</parameter></term>
<listitem>
<para>
<simpara>
PGP User ID - текст, предназначенный для представления
имени и адреса электронной почты владельца ключа.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key_alg</parameter></term>
<listitem>
<para>
<simpara>
Алгоритм первичного ключа (например, 'RSA', 'DSA' и т.д.).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>sub_alg</parameter></term>
<listitem>
<para>
<simpara>
Алгоритм дочернего ключа. Если значение не задано,
то дочерний ключ генерироваться не будет.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -147,13 +147,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Отпечаток сгенерированного первичного ключа&return.falseforfailure;.
Этот отпечаток может быть использован в дальнейшем для ссылки на ключ
в операциях подписи и шифрования.
Данные ключа хранятся в контексте памяти FFI и могут быть сохранены
с помощью функции <function>rnp_save_keys</function> или <function>rnp_save_keys_to_path</function>.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-sign-cleartext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-sign-cleartext">
<refnamediv>
<refname>rnp_op_sign_cleartext</refname>
<refpurpose>Выполняет операцию подписания текстовых данных, возвращая подписанный открытый текст сообщения</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>array</type><parameter>keys_fp</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -28,34 +28,34 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Данные для подписи.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>keys_fp</parameter></term>
<listitem>
<para>
<simpara>
Массив с цифровыми отпечатками ключей. Должен быть указан хотя бы один ключ.
Ключи должны присутствовать в параметре <parameter>ffi</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -99,11 +99,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Подписанный открытый текст, содержащий исходные данные
с дополнительными заголовками и ASCII-защищённой подписью в случае
успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-sign-detached" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-sign-detached">
<refnamediv>
<refname>rnp_op_sign_detached</refname>
<refpurpose>Выполняет операцию подписания, возвращает отсоединённую подпись (подписи)</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>array</type><parameter>keys_fp</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -28,34 +28,34 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Данные для подписи.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>keys_fp</parameter></term>
<listitem>
<para>
<simpara>
Массив с цифровыми отпечатками ключей. Должен быть указан хотя бы один ключ.
Ключи должны присутствовать в параметре <parameter>ffi</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -99,9 +99,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает данные с отсоединённой подписью (подписями) в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-sign" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-sign">
<refnamediv>
<refname>rnp_op_sign</refname>
<refpurpose>Выполняет операцию подписания бинарных данных, возвращает присоединённую подпись (подписи)</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>array</type><parameter>keys_fp</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -28,34 +28,34 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Данные для подписи.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>keys_fp</parameter></term>
<listitem>
<para>
<simpara>
Массив с цифровыми отпечатками ключей. Должен быть указан хотя бы один ключ.
Ключи должны присутствовать в параметре <parameter>ffi</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив с опциями.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -124,9 +124,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает данные с присоединённой подписью (подписями) в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-verify-detached" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-verify-detached">
<refnamediv>
<refname>rnp_op_verify_detached</refname>
<refpurpose>Проверяет отсоединённые подписи</refpurpose>
@@ -15,9 +15,9 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam><type>string</type><parameter>signature</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -27,25 +27,25 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Исходные данные.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>signature</parameter></term>
<listitem>
<para>
<simpara>
Данные отсоединённой подписи.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -53,9 +53,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Ассоциативный массив, содержащий информацию о результатах проверки&return.falseforfailure;.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -116,9 +116,9 @@
</tbody>
</tgroup>
</informaltable>
<para>
<simpara>
Дочерний массив "signatures".
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-op-verify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-op-verify">
<refnamediv>
<refname>rnp_op_verify</refname>
<refpurpose>Проверяет присоединённую подпись или подпись открытого текста</refpurpose>
@@ -14,9 +14,9 @@
<methodparam><type>RnpFFI</type><parameter>ffi</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Подписанные данные.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,9 +44,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Ассоциативный массив, содержащий информацию о результатах проверки&return.falseforfailure;.
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>
@@ -107,9 +107,9 @@
</tbody>
</tgroup>
</informaltable>
<para>
<simpara>
Дочерний массив "signatures".
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<thead>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-save-keys-to-path" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-save-keys-to-path">
<refnamediv>
<refname>rnp_save_keys_to_path</refname>
<refpurpose>Сохраняет ключи по указанному пути</refpurpose>
@@ -16,10 +16,10 @@
<methodparam><type>string</type><parameter>output_path</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Сохраняет ключи, присутствующие в объекте FFI (загруженном или сгенерированном),
в указанном файле или каталоге.
</para>
</simpara>
</refsect1>
@@ -30,33 +30,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.key-format;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>output_path</parameter></term>
<listitem>
<para>
<simpara>
Путь к файлу или каталогу, в который должны быть сохранены ключи.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.loadsave-flags;
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -64,9 +64,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-save-keys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-save-keys">
<refnamediv>
<refname>rnp_save_keys</refname>
<refpurpose>Сохраняет ключи в строке PHP</refpurpose>
@@ -16,10 +16,10 @@
<methodparam><type>string</type><parameter role="reference">output</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Обратите внимание, что для G10 значением <parameter>output</parameter>
должен быть каталог (который уже должен существовать).
</para>
</simpara>
</refsect1>
@@ -30,33 +30,33 @@
<varlistentry>
<term><parameter>ffi</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.ffi-description;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.key-format;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>output</parameter></term>
<listitem>
<para>
<simpara>
Ключевые пакеты будут сохранены в строке, на которую ссылается <parameter>output</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
&rnp.parameter.loadsave-flags;
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -64,9 +64,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true; в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-supported-features" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-supported-features">
<refnamediv>
<refname>rnp_supported_features</refname>
<refpurpose>Получает поддерживаемые функции в формате JSON</refpurpose>
@@ -13,10 +13,10 @@
<type class="union"><type>string</type><type>false</type></type><methodname>rnp_supported_features</methodname>
<methodparam><type>string</type><parameter>type</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Получение строки в формате JSON, содержащей массив поддерживаемых
значений признаков rnp (алгоритмов, кривых и т.д.) по типам.
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
<para>
<simpara>
Поддерживаемые значения смотрите в константах RNP_FEATURE_*.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -36,9 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, содержащую JSON-форматированный массив поддерживаемых алгоритмов, кривых и т.д.&return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-version-string-full" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-version-string-full">
<refnamediv>
<refname>rnp_version_string_full</refname>
<refpurpose>Возвращает строку полной версии библиотеки RNP</refpurpose>
@@ -11,11 +11,11 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>rnp_version_string_full</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -27,9 +27,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку полной версии библиотеки RNP.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.rnp-version-string" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-version-string">
<refnamediv>
<refname>rnp_version_string</refname>
<refpurpose>Возвращает строку версии библиотеки RNP</refpurpose>
@@ -11,11 +11,11 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>rnp_version_string</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку версии библиотеки RNP.
</para>
</simpara>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.rnpffi" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.rnpffi" role="class">
<title>Класс RnpFFI</title>
<titleabbrev>RnpFFI</titleabbrev>
@@ -10,9 +10,9 @@
<!-- {{{ RnpFFI intro -->
<section xml:id="rnpffi.intro">
&reftitle.intro;
<para>
<simpara>
</para>
</simpara>
</section>
<!-- }}} -->

View File

@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sergey Status: ready -->
<!-- EN-Revision: 462b2bc5580f4bfaabe48be54a91f978cc181e9b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="rnp.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="rnp.setup">
&reftitle.setup;
<section xml:id="rnp.requirements">
&reftitle.required;
<para>
<simpara>
Чтобы использовать функции модуля RNP, необходимо установить
<link xlink:href="&url.rnp;">библиотеку RNP</link>.
Модулю требуется библиотека RNP &gt;= 0.16.2.
</para>
</simpara>
</section>
&reference.rnp.configure;