Skip to content

Commit

Permalink
OpenSSL sync with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
devnexen committed Dec 16, 2024
1 parent e5d6670 commit 43930ea
Show file tree
Hide file tree
Showing 3 changed files with 526 additions and 68 deletions.
134 changes: 91 additions & 43 deletions reference/openssl/constants.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 434366e9284206b3b073a49bddf7c42e85427aa0 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 3b06ef4bb06db8cf2cd8ea8470287f7f43ef9e71 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<appendix xml:id="openssl.constants" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -142,14 +142,14 @@
<section xml:id="openssl.key-types">
<title>Types de clés</title>
<variablelist>
<varlistentry xml:id="constant.openssl-keytype-rsa">
<term>
<constant>OPENSSL_KEYTYPE_RSA</constant>
(<type>int</type>)
</term>
<listitem>
<varlistentry xml:id="constant.openssl-keytype-rsa">
<term>
<constant>OPENSSL_KEYTYPE_RSA</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>

Type de clé RSA.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -160,7 +160,7 @@
</term>
<listitem>
<simpara>

Type de clé DSA.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -171,42 +171,90 @@
</term>
<listitem>
<simpara>

</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-ec">
<term>
<constant>OPENSSL_KEYTYPE_EC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Cette constante n'est disponible que lorsque PHP est compilé avec OpenSSL 0.9.8+.
Type de clé DH (Diffie-Hellman).
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>

<section xml:id="openssl.pkcs7.flags">
<title>Constantes/options <acronym>PKCS7</acronym></title>
<para>
Les fonctions S/MIME utilisent des options qui sont spécifiées
par un champ de bits. Les valeurs valides sont :
<table>
<title>Constantes <acronym>PKCS7</acronym></title>
<tgroup cols="2">
<thead>
<row>
<entry>Constante</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.pkcs7-text">
<entry>
<constant>PKCS7_TEXT</constant>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-ec">
<term>
<constant>OPENSSL_KEYTYPE_EC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Type de clé à courbe elliptique.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-x25519">
<term>
<constant>OPENSSL_KEYTYPE_X25519</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Type de clé à courbe X25519.
Cette constante n'est disponible que lorsque PHP est compilé avec OpenSSL 3.0+.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-ed25519">
<term>
<constant>OPENSSL_KEYTYPE_ED25519</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Type de clé à courbe Ed25519.
Cette constante n'est disponible que lorsque PHP est compilé avec OpenSSL 3.0+.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-x448">
<term>
<constant>OPENSSL_KEYTYPE_X448</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Type de clé à courbe X448.
Cette constante n'est disponible que lorsque PHP est compilé avec OpenSSL 3.0+.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-ed448">
<term>
<constant>OPENSSL_KEYTYPE_ED448</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Type de clé à courbe Ed448.
Cette constante n'est disponible que lorsque PHP est compilé avec OpenSSL 3.0+.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>

<section xml:id="openssl.pkcs7.flags">
<title>Constantes/options <acronym>PKCS7</acronym></title>
<para>
Les fonctions S/MIME utilisent des options qui sont spécifiées
par un champ de bits. Les valeurs valides sont :
<table>
<title>Constantes <acronym>PKCS7</acronym></title>
<tgroup cols="2">
<thead>
<row>
<entry>Constante</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.pkcs7-text">
<entry>
<constant>PKCS7_TEXT</constant>
(<type>int</type>)
</entry>
<entry>
Expand Down
49 changes: 29 additions & 20 deletions reference/openssl/functions/openssl-pkey-get-details.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0e80601cabf499c7db372149916b5cb3e2740f1b Maintainer: yannick Status: ready -->
<!-- EN-Revision: 3b06ef4bb06db8cf2cd8ea8470287f7f43ef9e71 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.openssl-pkey-get-details" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -46,7 +46,12 @@
<constant>OPENSSL_KEYTYPE_RSA</constant>,
<constant>OPENSSL_KEYTYPE_DSA</constant>,
<constant>OPENSSL_KEYTYPE_DH</constant>,
<constant>OPENSSL_KEYTYPE_EC</constant> ou -1, signifiant "inconnu").
<constant>OPENSSL_KEYTYPE_EC</constant>,
<constant>OPENSSL_KEYTYPE_X25519</constant>,
<constant>OPENSSL_KEYTYPE_ED25519</constant>,
<constant>OPENSSL_KEYTYPE_X448</constant>,
<constant>OPENSSL_KEYTYPE_ED448</constant>,
ou <literal>-1</literal> signifiant inconnu).
</para>
<para>
En fonction du type de clés utilisées, des détails supplémentaires peuvent être retournés.
Expand Down Expand Up @@ -177,8 +182,16 @@
</listitem>
<listitem>
<simpara>
<constant>OPENSSL_KEYTYPE_EC</constant>, une clé de tableau additionnelle nommé
<literal>"ec"</literal>, contenant les données de la clé est retourné.
<constant>OPENSSL_KEYTYPE_X25519</constant>,
<constant>OPENSSL_KEYTYPE_ED25519</constant>,
<constant>OPENSSL_KEYTYPE_X448</constant>,
ou <constant>OPENSSL_KEYTYPE_ED448</constant>
une clé supplémentaire dans le tableau nommée
<literal>"x25519"</literal>,
<literal>"ed25519"</literal>,
<literal>"x448"</literal>,
ou <literal>"ed448"</literal> respectivement,
est retournée, contenant les données de la clé.
</simpara>
<informaltable>
<tgroup cols="2">
Expand All @@ -190,24 +203,12 @@
</thead>
<tbody>
<row>
<entry><literal>"curve_name"</literal></entry>
<entry>nom de la courbe, voir <function>openssl_get_curve_names</function></entry>
</row>
<row>
<entry><literal>"curve_oid"</literal></entry>
<entry>Identifiant Objet ASN1 (OID) pour la courbe EC.</entry>
</row>
<row>
<entry><literal>"x"</literal></entry>
<entry>coordonnée x (publique)</entry>
</row>
<row>
<entry><literal>"y"</literal></entry>
<entry>coordonnée y (publique)</entry>
<entry><literal>"priv_key"</literal></entry>
<entry>clé privée</entry>
</row>
<row>
<entry><literal>"d"</literal></entry>
<entry>clé privée</entry>
<entry><literal>"pub_key"</literal></entry>
<entry>clé publique</entry>
</row>
</tbody>
</tgroup>
Expand All @@ -227,6 +228,14 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Ajout de la prise en charge des clés basées sur Curve25519 et Curve448.
Plus précisément, les champs <literal>x25519</literal>, <literal>ed25519</literal>,
<literal>x448</literal> et <literal>ed448</literal> ont été introduits.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
Loading

0 comments on commit 43930ea

Please sign in to comment.