com doc/ru: Обновлен ие до англи йской верси и: reference/openssl/constants.xml

Commit: aa08117754a70769fe02a06a718b020c57826ff1 Author: Sergey Panteleev <sergey@php.net> Fri, 22 Jan 2021 09:34:09 +0300 Parents: 73ef80accc4fd5fc9cad2c900d672550507af830 Branches: master Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=aa08117754a70769fe02a06a718b020c57826ff1 Log: Обновление до английской версии Changed paths: M reference/openssl/constants.xml

diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml index e03ca3689..10302a9da 100644 --- a/reference/openssl/constants.xml +++ b/reference/openssl/constants.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: aur Status: ready --> +<!-- EN-Revision: e52245f15da8b19397478a4edbf6dc16ff2f80bd Maintainer: aur Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <appendix xml:id="openssl.constants" xmlns="http://docbook.org/ns/docbook"> @@ -275,6 +275,97 @@ </para> </section> + <section xml:id="openssl.cms.flags"> + <title>Флаги/Константы <acronym>CMS</acronym></title> + <para> + Функции CMS используют флаги, которые задаются с помощью + битового поля, которое может включать одно или несколько следующих значений: + <table> + <title>Константы <acronym>CMS</acronym></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Константа</entry> + <entry>Описание</entry> + </row> + </thead> + <tbody> + <row xml:id="constant.openssl-cms-text"> + <entry><constant>OPENSSL_CMS_TEXT</constant></entry> + <entry> + Добавляет заголовки content-type text/plain в зашифрованное/подписанное + сообщение. При расшифровке или проверке эти заголовки удаляются из вывода - + если расшифрованное или проверенное сообщение не относится к MIME-типу + text/plain, произойдёт ошибка. + </entry> + </row> + <row xml:id="constant.openssl-cms-binary"> + <entry><constant>OPENSSL_CMS_BINARY</constant></entry> + <entry> + Обычно входное сообщение преобразуется в "каноничный" формат, который + эффективно использует <literal>CR</literal> и <literal>LF</literal> + в качестве конца строки: как требуется спецификацией CMS. Когда + присутствует эта опция, перевод не выполняется. Это полезно при обработке + двоичных данных, которые могут быть не в формате CMS. + </entry> + </row> + <row xml:id="constant.openssl-cms-nointern"> + <entry><constant>OPENSSL_CMS_NOINTERN</constant></entry> + <entry> + При проверке сообщения, сертификаты (если есть), включённые в сообщение, + обычно проверяются на наличие сертификата подписи. С этой опцией используются + только сертификаты, указанные в параметре <parameter>untrusted_certificates_filename</parameter> + в <function>openssl_cms_verify</function>. + Однако предоставленные сертификаты можно использовать как ненадёжные центры сертификации. + </entry> + </row> + <row xml:id="constant.openssl-cms-noverify"> + <entry><constant>OPENSSL_CMS_NOVERIFY</constant></entry> + <entry> + Не проверять сертификат подписавшего у подписанного сообщения. + </entry> + </row> + <row xml:id="constant.openssl-cms-nocerts"> + <entry><constant>OPENSSL_CMS_NOCERTS</constant></entry> + <entry> + При подписании сообщения сертификат подписывающей стороны обычно + включается - с этой опцией он исключается. Это уменьшит размер + подписанного сообщения, но у проверяющего должна быть копия сертификата + подписавшего, доступная локально (например, переданная с помощью <parameter>untrusted_certificates_filename</parameter> + в <function>openssl_cms_verify</function>). + </entry> + </row> + <row xml:id="constant.openssl-cms-noattr"> + <entry><constant>OPENSSL_CMS_NOATTR</constant></entry> + <entry> + Обычно при подписании сообщения включается набор атрибутов, + который включает время подписи и поддерживаемые симметричные алгоритмы. + С этой опцией они не включены. + </entry> + </row> + <row xml:id="constant.openssl-cms-detached"> + <entry><constant>OPENSSL_CMS_DETACHED</constant></entry> + <entry> + При подписании сообщения используйте подпись открытым текстом с MIME-типом + <literal>"multipart/signed"</literal>. Это значение по умолчанию, + если вы не укажете никаких <parameter>flags</parameter> для + <function>openssl_cms_sign</function>. + Если вы отключите эту опцию, сообщение будет подписано с использованием + непрозрачной подписи, которая более устойчива к переводу почтовыми + ретрансляторами, но не может быть прочитана почтовыми агентами, + не поддерживающими S/MIME. + </entry> + </row> + <row xml:id="constant.openssl-cms-nosigs"> + <entry><constant>OPENSSL_CMS_NOSIGS</constant></entry> + <entry>Не пытаться проверять подписи в сообщении</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </section> + <section xml:id="openssl.signature-algos"> <title>Алгоритмы подписи</title> <variablelist> @@ -545,6 +636,20 @@ <section xml:id="openssl.constants.other"> <title>Другие константы</title> <variablelist> + <varlistentry xml:id="constant.openssl-raw-data"> + <term> + <constant>OPENSSL_RAW_DATA</constant> + (<type>bool</type>) + </term> + <listitem> + <simpara> + Если <constant>OPENSSL_RAW_DATA</constant> установлена в + <function>openssl_encrypt</function> или <function>openssl_decrypt</function>, + возвращаемые данные возвращаются как есть. + Если константа не указана, вызывающей стороне возвращаются данные в кодировке Base64. + </simpara> + </listitem> + </varlistentry> <varlistentry xml:id="constant.openssl-zero-padding"> <term> <constant>OPENSSL_ZERO_PADDING</constant> @@ -562,11 +667,43 @@ </simpara> </listitem> </varlistentry> + <varlistentry xml:id="constant.openssl-encoding-smime"> + <term> + <constant>OPENSSL_ENCODING_SMIME</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + Указывает, что используется кодировка S/MIME. + </simpara> + </listitem> + </varlistentry> + <varlistentry xml:id="constant.openssl-encoding-der"> + <term> + <constant>OPENSSL_ENCODING_DER</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + Указывает, что используется кодировка DER (Distinguished Encoding Rules). + </simpara> + </listitem> + </varlistentry> + <varlistentry xml:id="constant.openssl-encoding-pem"> + <term> + <constant>OPENSSL_ENCODING_PEM</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + Указывает, что используется кодировка PEM (Privacy-Enhanced Mail). + </simpara> + </listitem> + </varlistentry> </variablelist> </section> </appendix> - <!-- Keep this comment at the end of the file Local variables: mode: sgml