From 6d3410238049780bfcf36014868c61994fb629b8 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 27 May 2026 20:14:40 +0200 Subject: [PATCH 1/4] translate: openssl cipher & digest functions --- .../functions/openssl-cipher-iv-length.xml | 96 +++++++ .../functions/openssl-cipher-key-length.xml | 93 +++++++ .../openssl/functions/openssl-decrypt.xml | 206 ++++++++++++++ .../openssl/functions/openssl-digest.xml | 106 ++++++++ .../functions/openssl-get-cipher-methods.xml | 252 ++++++++++++++++++ 5 files changed, 753 insertions(+) create mode 100644 reference/openssl/functions/openssl-cipher-iv-length.xml create mode 100644 reference/openssl/functions/openssl-cipher-key-length.xml create mode 100644 reference/openssl/functions/openssl-decrypt.xml create mode 100644 reference/openssl/functions/openssl-digest.xml create mode 100644 reference/openssl/functions/openssl-get-cipher-methods.xml diff --git a/reference/openssl/functions/openssl-cipher-iv-length.xml b/reference/openssl/functions/openssl-cipher-iv-length.xml new file mode 100644 index 000000000..0c0252158 --- /dev/null +++ b/reference/openssl/functions/openssl-cipher-iv-length.xml @@ -0,0 +1,96 @@ + + + + + + openssl_cipher_iv_length + Ermittelt die Länge des Initialisierungsvektors einer Verschlüsselungsmethode + + + + &reftitle.description; + + intfalseopenssl_cipher_iv_length + stringcipher_algo + + + Ermittelt die Länge des Initialisierungsvektors (IV) einer + Verschlüsselungsmethode. + + + + + &reftitle.parameters; + + + cipher_algo + + + Die Verschlüsselungsmethode; openssl_get_cipher_methods + liefert eine Liste der möglichen Werte. + + + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg die Länge des Initialisierungsvektors zurück, im Fehlerfall + &false;. + + + + + &reftitle.errors; + + Gibt einen Fehler der Stufe E_WARNING aus, wenn die + Verschlüsselungsmethode unbekannt ist. + + + + + &reftitle.examples; + + Beispiel für <function>openssl_cipher_iv_length</function> + + +]]> + + &example.outputs.similar; + + + + + + + + diff --git a/reference/openssl/functions/openssl-cipher-key-length.xml b/reference/openssl/functions/openssl-cipher-key-length.xml new file mode 100644 index 000000000..86daec974 --- /dev/null +++ b/reference/openssl/functions/openssl-cipher-key-length.xml @@ -0,0 +1,93 @@ + + + + + + openssl_cipher_key_length + Ermittelt die Schlüssellänge einer Verschlüsselungsmethode + + + + &reftitle.description; + + intfalseopenssl_cipher_key_length + stringcipher_algo + + + Ermittelt die Schlüssellänge einer Verschlüsselungsmethode. + + + + + &reftitle.parameters; + + + cipher_algo + + + Die Verschlüsselungsmethode; openssl_get_cipher_methods + liefert eine Liste der möglichen Werte. + + + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg die Schlüssellänge zurück, &return.falseforfailure;. + + + + + &reftitle.errors; + + Gibt einen Fehler der Stufe E_WARNING aus, wenn die + Verschlüsselungsmethode unbekannt ist. + + + + + &reftitle.examples; + + Beispiel für <function>openssl_cipher_key_length</function> + + +]]> + + &example.outputs.similar; + + + + + + + + diff --git a/reference/openssl/functions/openssl-decrypt.xml b/reference/openssl/functions/openssl-decrypt.xml new file mode 100644 index 000000000..cdadc9b30 --- /dev/null +++ b/reference/openssl/functions/openssl-decrypt.xml @@ -0,0 +1,206 @@ + + + + + + openssl_decrypt + Entschlüsselt Daten + + + + &reftitle.description; + + stringfalseopenssl_decrypt + stringdata + stringcipher_algo + #[\SensitiveParameter]stringpassphrase + intoptions0 + stringiv"" + stringnulltag&null; + stringaad"" + + + Entschlüsselt eine unbearbeitete oder base64-kodierte Zeichenkette mit der + angegebenen Methode und der angegebenen Passphrase. + + + + + + &reftitle.parameters; + + + + data + + + Die zu entschlüsselnde verschlüsselte Nachricht. + + + + + cipher_algo + + + Die Verschlüsselungsmethode. + openssl_get_cipher_methods liefert eine Liste der + verfügbaren Verschlüsselungsmethoden. + + + + + passphrase + + + Die Passphrase. Ist die Passphrase kürzer als erwartet, wird sie + stillschweigend mit NUL-Zeichen aufgefüllt; ist die + Passphrase länger als erwartet, wird sie stillschweigend abgeschnitten. + + + + Für passphrase wird keine Funktion zur Ableitung + eines Schlüssels verwendet, wie der Name vielleicht vermuten lässt. + Die einzige Operation, die verwendet wird, ist das Auffüllen mit + NUL-Zeichen oder das Abschneiden, wenn die Länge + anders ist als erwartet. + + + + + + options + + + options kann einer der Werte + OPENSSL_RAW_DATA, + OPENSSL_ZERO_PADDING + oder OPENSSL_DONT_ZERO_PAD_KEY sein. + + + + + iv + + + Der Initialisierungsvektor (darf nicht &null; sein). Ist der IV kürzer + als erwartet, wird er mit NUL-Zeichen aufgefüllt und + eine Warnung ausgegeben; ist die Passphrase länger als erwartet, wird + sie abgeschnitten und eine Warnung ausgegeben. + + + + + tag + + + Das Authentifizierungskennzeichen im AEAD-Verschlüsselungsmodus. Ist es + falsch, schlägt die Authentifizierung fehl und die Funktion gibt + &false; zurück. + + + + Die Länge des Parameters tag wird von der + Funktion nicht überprüft. Es liegt in der Verantwortung des Aufrufers + sicherzustellen, dass die Länge des Kennzeichens mit der Länge des + Kennzeichens übereinstimmt, das beim Aufruf von + openssl_encrypt zurückgegeben wurde. Andernfalls + kann die Entschlüsselung auch dann erfolgreich sein, wenn das + übergebene Kennzeichen nur dem Anfang des korrekten Kennzeichens + entspricht. + + + + + + aad + + + Zusätzliche authentifizierte Daten. + + + + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg die entschlüsselte Zeichenkette zurück, + &return.falseforfailure;. + + + + + &reftitle.errors; + + Gibt einen Fehler der Stufe E_WARNING aus, wenn eine + unbekannte Verschlüsselungsmethode über den Parameter + cipher_algo übergeben wird. + + + Gibt einen Fehler der Stufe E_WARNING aus, wenn eine + leere Zeichenkette über den Parameter iv übergeben + wird. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.1.0 + + Der Parameter tag ist nun nullable. + + + + 7.1.0 + + Die Parameter tag und aad + wurden hinzugefügt. + + + + + + + + + &reftitle.seealso; + + + openssl_encrypt + + + + + + diff --git a/reference/openssl/functions/openssl-digest.xml b/reference/openssl/functions/openssl-digest.xml new file mode 100644 index 000000000..29f501b6a --- /dev/null +++ b/reference/openssl/functions/openssl-digest.xml @@ -0,0 +1,106 @@ + + + + + + openssl_digest + Berechnet einen Hashwert (Digest) + + + + &reftitle.description; + + stringfalseopenssl_digest + stringdata + stringdigest_algo + boolbinary&false; + + + Berechnet einen Hashwert (Digest) für die übergebenen Daten mit der + angegebenen Methode und gibt das Ergebnis als unbearbeitete oder + hexadezimal kodierte Zeichenkette zurück. + + + + + + &reftitle.parameters; + + + + data + + + Die Daten. + + + + + digest_algo + + + Die zu verwendende Hash-Methode, z. B. "sha256"; + openssl_get_md_methods liefert eine Liste der + verfügbaren Hash-Methoden. + + + + + binary + + + Wird der Wert auf &true; gesetzt, werden die Daten unbearbeitet + zurückgegeben, andernfalls hexadezimal kodiert. + + + + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg den berechneten Hashwert zurück, &return.falseforfailure;. + + + + + &reftitle.errors; + + Gibt einen Fehler der Stufe E_WARNING aus, wenn eine + unbekannte Signaturmethode über den Parameter + digest_algo übergeben wird. + + + + + &reftitle.seealso; + + + openssl_get_md_methods + + + + + + diff --git a/reference/openssl/functions/openssl-get-cipher-methods.xml b/reference/openssl/functions/openssl-get-cipher-methods.xml new file mode 100644 index 000000000..cc76cfb2b --- /dev/null +++ b/reference/openssl/functions/openssl-get-cipher-methods.xml @@ -0,0 +1,252 @@ + + + + + + + openssl_get_cipher_methods + Liefert die verfügbaren Verschlüsselungsmethoden + + + + &reftitle.description; + + arrayopenssl_get_cipher_methods + boolaliases&false; + + + Liefert eine Liste der verfügbaren Verschlüsselungsmethoden. + + + + + + &reftitle.parameters; + + + + aliases + + + Auf &true; setzen, wenn Aliase der Verschlüsselungsmethoden im + zurückgegebenen array enthalten sein sollen. + + + + + + + + + &reftitle.returnvalues; + + Ein array der verfügbaren Verschlüsselungsmethoden. + Es ist zu beachten, dass vor OpenSSL 1.1.1 die Verschlüsselungsmethoden in + Groß- und Kleinschreibung zurückgegeben wurden; ab OpenSSL 1.1.1 werden nur + die Varianten in Kleinschreibung zurückgegeben. + + + + + &reftitle.examples; + + + Beispiel für <function>openssl_get_cipher_methods</function> + + Zeigt, wie die verfügbaren Verschlüsselungsmethoden aussehen können und + welche Aliase verfügbar sein können. + + + +]]> + + &example.outputs.similar; + + aes-128-cbc + [1] => aes-128-cbc-hmac-sha1 + [2] => aes-128-cbc-hmac-sha256 + [3] => aes-128-ccm + [4] => aes-128-cfb + [5] => aes-128-cfb1 + [6] => aes-128-cfb8 + [7] => aes-128-ctr + [9] => aes-128-gcm + [10] => aes-128-ocb + [11] => aes-128-ofb + [12] => aes-128-xts + [13] => aes-192-cbc + [14] => aes-192-ccm + [15] => aes-192-cfb + [16] => aes-192-cfb1 + [17] => aes-192-cfb8 + [18] => aes-192-ctr + [20] => aes-192-gcm + [21] => aes-192-ocb + [22] => aes-192-ofb + [23] => aes-256-cbc + [24] => aes-256-cbc-hmac-sha1 + [25] => aes-256-cbc-hmac-sha256 + [26] => aes-256-ccm + [27] => aes-256-cfb + [28] => aes-256-cfb1 + [29] => aes-256-cfb8 + [30] => aes-256-ctr + [32] => aes-256-gcm + [33] => aes-256-ocb + [34] => aes-256-ofb + [35] => aes-256-xts + [36] => aria-128-cbc + [37] => aria-128-ccm + [38] => aria-128-cfb + [39] => aria-128-cfb1 + [40] => aria-128-cfb8 + [41] => aria-128-ctr + [43] => aria-128-gcm + [44] => aria-128-ofb + [45] => aria-192-cbc + [46] => aria-192-ccm + [47] => aria-192-cfb + [48] => aria-192-cfb1 + [49] => aria-192-cfb8 + [50] => aria-192-ctr + [52] => aria-192-gcm + [53] => aria-192-ofb + [54] => aria-256-cbc + [55] => aria-256-ccm + [56] => aria-256-cfb + [57] => aria-256-cfb1 + [58] => aria-256-cfb8 + [59] => aria-256-ctr + [61] => aria-256-gcm + [62] => aria-256-ofb + [63] => bf-cbc + [64] => bf-cfb + [66] => bf-ofb + [67] => camellia-128-cbc + [68] => camellia-128-cfb + [69] => camellia-128-cfb1 + [70] => camellia-128-cfb8 + [71] => camellia-128-ctr + [73] => camellia-128-ofb + [74] => camellia-192-cbc + [75] => camellia-192-cfb + [76] => camellia-192-cfb1 + [77] => camellia-192-cfb8 + [78] => camellia-192-ctr + [80] => camellia-192-ofb + [81] => camellia-256-cbc + [82] => camellia-256-cfb + [83] => camellia-256-cfb1 + [84] => camellia-256-cfb8 + [85] => camellia-256-ctr + [87] => camellia-256-ofb + [88] => cast5-cbc + [89] => cast5-cfb + [91] => cast5-ofb + [92] => chacha20 + [93] => chacha20-poly1305 + [111] => id-aes128-CCM + [112] => id-aes128-GCM + [113] => id-aes128-wrap + [114] => id-aes128-wrap-pad + [115] => id-aes192-CCM + [116] => id-aes192-GCM + [117] => id-aes192-wrap + [118] => id-aes192-wrap-pad + [119] => id-aes256-CCM + [120] => id-aes256-GCM + [121] => id-aes256-wrap + [122] => id-aes256-wrap-pad + [124] => idea-cbc + [125] => idea-cfb + [127] => idea-ofb + [137] => seed-cbc + [138] => seed-cfb + [140] => seed-ofb + [141] => sm4-cbc + [142] => sm4-cfb + [143] => sm4-ctr + [145] => sm4-ofb +) +Array +( + [36] => aes128 + [37] => aes128-wrap + [38] => aes192 + [39] => aes192-wrap + [40] => aes256 + [41] => aes256-wrap + [69] => aria128 + [70] => aria192 + [71] => aria256 + [72] => bf + [77] => blowfish + [99] => camellia128 + [100] => camellia192 + [101] => camellia256 + [102] => cast + [103] => cast-cbc + [146] => idea + [164] => seed + [169] => sm4 +) + +]]> + + + + + + + &reftitle.seealso; + + + openssl_get_md_methods + + + + + + + From 95a04793d9a000c7773546fd501d72140d6d6551 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Wed, 27 May 2026 21:46:45 +0200 Subject: [PATCH 2/4] Update openssl-cipher-key-length.xml Co-authored-by: Martin Samesch --- reference/openssl/functions/openssl-cipher-key-length.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/openssl/functions/openssl-cipher-key-length.xml b/reference/openssl/functions/openssl-cipher-key-length.xml index 86daec974..b98ec11f7 100644 --- a/reference/openssl/functions/openssl-cipher-key-length.xml +++ b/reference/openssl/functions/openssl-cipher-key-length.xml @@ -36,7 +36,7 @@ &reftitle.returnvalues; - Gibt bei Erfolg die Schlüssellänge zurück, &return.falseforfailure;. + Gibt bei Erfolg die Schlüssellänge zurück. &return.falseforfailure; From f42bb0459a975c3ab5c92003ba35dd588a2fc378 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Wed, 27 May 2026 22:05:13 +0200 Subject: [PATCH 3/4] Update openssl-digest.xml Co-authored-by: Martin Samesch --- reference/openssl/functions/openssl-digest.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/openssl/functions/openssl-digest.xml b/reference/openssl/functions/openssl-digest.xml index 29f501b6a..c6fd4e54c 100644 --- a/reference/openssl/functions/openssl-digest.xml +++ b/reference/openssl/functions/openssl-digest.xml @@ -39,7 +39,7 @@ digest_algo - Die zu verwendende Hash-Methode, z. B. "sha256"; + Die zu verwendende Hash-Methode, &zb; "sha256"; openssl_get_md_methods liefert eine Liste der verfügbaren Hash-Methoden. From 77ed223b0a99f7ad14c8fcdb1e026df0778bd2bb Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Wed, 27 May 2026 22:06:16 +0200 Subject: [PATCH 4/4] Update openssl-digest.xml Co-authored-by: Martin Samesch --- reference/openssl/functions/openssl-digest.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/openssl/functions/openssl-digest.xml b/reference/openssl/functions/openssl-digest.xml index c6fd4e54c..8e28c53e2 100644 --- a/reference/openssl/functions/openssl-digest.xml +++ b/reference/openssl/functions/openssl-digest.xml @@ -61,7 +61,7 @@ &reftitle.returnvalues; - Gibt bei Erfolg den berechneten Hashwert zurück, &return.falseforfailure;. + Gibt bei Erfolg den berechneten Hashwert zurück. &return.falseforfailure;