php/archived-doc-de
1
0
Fork 0
mirror of https://github.com/php/doc-de.git synced 2026-03-23 23:02:13 +01:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-25 15:13:42 +00:00
parent eb0509ad5a
commit 746c08dd2e
28 changed files with 289 additions and 302 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
reference/sodium/book.xml
View File

@@ -1,21 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e7853a8a24fd5de419860cf00e00320905e7cb4c Maintainer: joshuaruesweg Status: ready -->
<book xml:id="book.sodium" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sodium">
<?phpdoc extension-membership="bundledexternal" ?>
<title>Sodium</title>
<titleabbrev>Sodium</titleabbrev>
<preface xml:id="intro.sodium">
&reftitle.intro;
<para>
<simpara>
Sodium ist eine moderne und einfach zu bedienende Software-Bibliothek für
Verschlüsselungen, Entschlüsselungen, Signaturen, Passwort-Hashing und mehr.
Ihr Ziel ist es, alle grundlegenden Operationen zur Verfügung zu stellen,
die für die Entwicklung von kryptographischen Werkzeugen auf höherer Ebene
erforderlich sind.
</para>
</simpara>
</preface>
&reference.sodium.setup;
@@ -24,7 +23,6 @@
&reference.sodium.sodiumexception;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

15
reference/sodium/configure.xml
View File

@@ -1,23 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 021e8a170c7b17932c94f437e2d7fee472e51e96 Maintainer: joshuaruesweg Status: ready -->
<section xml:id="sodium.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sodium.installation">
&reftitle.install;
<para>
<simpara>
Beim Kompilieren von PHP muss
<option role="configure">--with-sodium[=DIR]</option> verwendet werden.
</para>
</simpara>
<para>
<simpara>
Windows-Benutzer sollten <filename>php_sodium.dll</filename> in
die &php.ini; hinzufügen.
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

20
reference/sodium/functions/sodium-add.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 506da7e0e634b719869062933e738b7635b08815 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-add">
<refnamediv>
<refname>sodium_add</refname>
<refpurpose>Addition großer Zahlen</refpurpose>
@@ -14,13 +14,13 @@
<methodparam><type>string</type><parameter role="reference">string1</parameter></methodparam>
<methodparam><type>string</type><parameter>string2</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Diese Funktion addiert den Parameter <parameter>string2</parameter>
zu <parameter>string1</parameter> hinzu und überschreibt den in
<parameter>string1</parameter> gespeicherten Wert. Diese Funktion geht
davon aus, dass beide Parameter binäre Zeichenketten (Strings) sind,
die vorzeichenlose Ganzzahlen in Little-Endian-Byte-Reihenfolge darstellen.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,20 +29,20 @@
<varlistentry>
<term><parameter>string1</parameter></term>
<listitem>
<para>
<simpara>
Eine Zeichenkette, die eine vorzeichenlose Ganzzahl beliebiger Länge in
Little-Endian-Byte-Reihenfolge darstellt. Dieser Parameter wird als
Referenz übergeben und enthält die Summe der beiden Parameter.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>string2</parameter></term>
<listitem>
<para>
<simpara>
Eine Zeichenkette, die eine vorzeichenlose Ganzzahl beliebiger Länge in
Little-Endian-Byte-Reihenfolge darstellt.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -50,9 +50,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
</refentry>

18
reference/sodium/functions/sodium-base642bin.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2214cd3277cf065a3abf395e9bbde73ed61d7d12 Maintainer: joshuaruesweg Status: ready -->
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-base642bin">
<refnamediv>
<refname>sodium_base642bin</refname>
@@ -15,14 +15,14 @@
<methodparam><type>int</type><parameter>id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>ignore</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Konvertiert eine Base64-kodierte Zeichenkette in das Binärformat.
Anders als <function>base64_decode</function> und
<function>sodium_base642bin</function> ist die Funktion zeitkonstant (eine
Eigenschaft, welche für jeden Programmcode wichtig ist, der kryptographische
Eingaben wie Klartexte oder Schlüssel verarbeitet) und unterstützt mehrere
Zeichensätze.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,9 +31,9 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
<type>string</type>; Kodierte Zeichenfolge.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -64,10 +64,10 @@
<varlistentry>
<term><parameter>ignore</parameter></term>
<listitem>
<para>
<simpara>
Zeichen, die bei der Dekodierung ignoriert werden sollen
(&zb; Leerzeichen).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -75,9 +75,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Dekodierte Zeichenkette.
</para>
</simpara>
</refsect1>
</refentry>

14
reference/sodium/functions/sodium-bin2base64.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2214cd3277cf065a3abf395e9bbde73ed61d7d12 Maintainer: joshuaruesweg Status: ready -->
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-bin2base64">
<refnamediv>
<refname>sodium_bin2base64</refname>
@@ -14,14 +14,14 @@
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string</parameter></methodparam>
<methodparam><type>int</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Konvertiert eine Zeichenkette in eine Base64-kodierte Zeichenkette.
Anders als <function>base64_encode</function> und
<function>sodium_bin2base64</function> ist die Funktion zeitkonstant (eine
Eigenschaft, welche für jeden Programmcode wichtig ist, der kryptographische
Eingaben, wie Klartexte oder Schlüssel, verarbeitet) und unterstützt mehrere
Zeichensätze.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,9 +30,9 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Rohbinäre Zeichenfolge.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -65,9 +65,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Base64-enkodierte Zeichenkette.
</para>
</simpara>
</refsect1>
</refentry>

16
reference/sodium/functions/sodium-bin2hex.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-bin2hex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-bin2hex">
<refnamediv>
<refname>sodium_bin2hex</refname>
<refpurpose>Kodiert in Hexadezimal</refpurpose>
@@ -13,13 +13,13 @@
<type>string</type><methodname>sodium_bin2hex</methodname>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Konvertiert eine rohbinäre Zeichenkette in eine hexadezimal
kodierte Zeichenkette. Anders als <function>sodium_bin2hex</function> ist
die Funktion zeitkonstant (eine Eigenschaft, welche für jeden Programmcode
wichtig ist, der kryptographische Eingaben, wie Klartexte oder Schlüssel,
verarbeitet).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,9 +28,9 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Rohbinäre Zeichenfolge.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -38,9 +38,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Hexadezimal kodierte Zeichenkette.
</para>
</simpara>
</refsect1>
</refentry>

28
reference/sodium/functions/sodium-compare.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-compare" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-compare">
<refnamediv>
<refname>sodium_compare</refname>
<refpurpose>Vergleicht große Zahlen</refpurpose>
@@ -14,10 +14,10 @@
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string1</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string2</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Vergleicht zwei Zeichenketten, als ob sie beliebig lange, vorzeichenlose
Little-Endian-Ganzzahlen wären, ohne dass eine Seitenkanalattacke möglich ist.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>string1</parameter></term>
<listitem>
<para>
<simpara>
Linker Operand
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>string2</parameter></term>
<listitem>
<para>
<simpara>
Rechter Operand
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,17 +44,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt <literal>-1</literal> zurück, wenn <parameter>string1</parameter>
kleiner als <parameter>string2</parameter> ist.
</para>
<para>
</simpara>
<simpara>
Gibt <literal>1</literal> zurück, wenn <parameter>string1</parameter> größer
als <parameter>string2</parameter> ist.
</para>
<para>
</simpara>
<simpara>
Gibt <literal>0</literal> zurück, wenn beide Zeichenketten identisch sind.
</para>
</simpara>
</refsect1>
</refentry>

28
reference/sodium/functions/sodium-crypto-aead-aes256gcm-decrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-aes256gcm-decrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-aes256gcm-decrypt">
<refnamediv>
<refname>sodium_crypto_aead_aes256gcm_decrypt</refname>
<refpurpose>Überprüft und entschlüsselt eine Nachricht mit AES-256-GCM</refpurpose>
@@ -16,12 +16,12 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Überprüft und entschlüsselt eine Nachricht mit AES-256-GCM.
Nur verfügbar, wenn
<function>sodium_crypto_aead_aes256gcm_is_available</function> &true;
zurückgibt.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,37 +30,37 @@
<varlistentry>
<term><parameter>ciphertext</parameter></term>
<listitem>
<para>
<simpara>
Muss das von der Funktion
<function>sodium_crypto_aead_aes256gcm_encrypt</function> bereitgestellte
Format haben (Chiffretext und Tag, verknüpft).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
12 Bytes lang.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Entschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -68,9 +68,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt im Erfolgsfall den Klartext zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

28
reference/sodium/functions/sodium-crypto-aead-aes256gcm-encrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-aes256gcm-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-aes256gcm-encrypt">
<refnamediv>
<refname>sodium_crypto_aead_aes256gcm_encrypt</refname>
<refpurpose>Verschlüsselt und authentifiziert eine Nachricht mit AES-256-GCM</refpurpose>
@@ -16,12 +16,12 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Verschlüsselt und authentifiziert eine Nachricht mit AES-256-GCM.
Nur verfügbar, wenn
<function>sodium_crypto_aead_aes256gcm_is_available</function> &true;
zurückgibt.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,35 +30,35 @@
<varlistentry>
<term><parameter>message</parameter></term>
<listitem>
<para>
<simpara>
Der Klartext, welcher verschlüsselt werden soll.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
12 Bytes lang.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Verschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -66,10 +66,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt den Chiffriertext und das Authentifizierungskennzeichen als rohbinäre
Zeichenfolge zurück. (Format: Chiffriertext, dann Tag).
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

15
reference/sodium/functions/sodium-crypto-aead-aes256gcm-is-available.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-aes256gcm-is-available" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-aes256gcm-is-available">
<refnamediv>
<refname>sodium_crypto_aead_aes256gcm_is_available</refname>
<refpurpose>Prüft, ob die Hardware AES256-GCM unterstützt</refpurpose>
@@ -11,12 +11,12 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>sodium_crypto_aead_aes256gcm_is_available</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
Der Rückgabewert dieser Funktion hängt davon ab, ob die Hardware
hardwarebeschleunigtes AES unterstützt oder nicht.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,13 +26,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt &true; zurück, wenn es ist sicher ist mit AES-256-GCM zu verschlüsseln,
und &false; wenn nicht.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

15
reference/sodium/functions/sodium-crypto-aead-aes256gcm-keygen.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-aes256gcm-keygen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-aes256gcm-keygen">
<refnamediv>
<refname>sodium_crypto_aead_aes256gcm_keygen</refname>
<refpurpose>Generiert einen zufälligen AES-256-GCM-Schlüssel</refpurpose>
@@ -11,13 +11,13 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>sodium_crypto_aead_aes256gcm_keygen</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
Generiert einen zufälligen Schlüssel für die Nutzung von
<function>sodium_crypto_aead_aes256gcm_encrypt</function> und
<function>sodium_crypto_aead_aes256gcm_decrypt</function>.
</para>
</simpara>
</refsect1>
@@ -28,12 +28,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt einen 256-Bit-Zufallsschlüssel zurück.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

28
reference/sodium/functions/sodium-crypto-aead-chacha20poly1305-decrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-chacha20poly1305-decrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-chacha20poly1305-decrypt">
<refnamediv>
<refname>sodium_crypto_aead_chacha20poly1305_decrypt</refname>
<refpurpose>Überprüft und entschlüsselt eine Nachricht mit ChaCha20-Poly1305</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Überprüft und entschlüsselt eine Nachricht mit ChaCha20-Poly1305.
</para>
</simpara>
</refsect1>
@@ -28,37 +28,37 @@
<varlistentry>
<term><parameter>ciphertext</parameter></term>
<listitem>
<para>
<simpara>
Muss das von der Funktion
<function>sodium_crypto_aead_chacha20poly1305_encrypt</function>
bereitgestellte Format haben (Chiffretext und Tag, verknüpft).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
8 Bytes lang.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Entschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -66,9 +66,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt im Erfolgsfall den Klartext zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>

28
reference/sodium/functions/sodium-crypto-aead-chacha20poly1305-encrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-chacha20poly1305-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-chacha20poly1305-encrypt">
<refnamediv>
<refname>sodium_crypto_aead_chacha20poly1305_encrypt</refname>
<refpurpose>Verschlüsselt und authentifiziert eine Nachricht mit ChaCha20-Poly1305</refpurpose>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Verschlüsselt und authentifiziert eine Nachricht mit ChaCha20-Poly1305.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,35 +27,35 @@
<varlistentry>
<term><parameter>message</parameter></term>
<listitem>
<para>
<simpara>
Der Klartext, welcher verschlüsselt werden soll.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
8 Bytes lang.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Verschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -63,9 +63,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt bei Erfolg den Chiffriertext und das Tag zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

32
reference/sodium/functions/sodium-crypto-aead-chacha20poly1305-ietf-decrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-chacha20poly1305-ietf-decrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-chacha20poly1305-ietf-decrypt">
<refnamediv>
<refname>sodium_crypto_aead_chacha20poly1305_ietf_decrypt</refname>
<refpurpose>Überprüft, ob der Chiffriertext ein gültiges Tag enthält</refpurpose>
@@ -16,14 +16,14 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Verschlüsselt und authentifiziert eine Nachricht mit ChaCha20-Poly1305
(IETF-Variante).
</para>
<para>
</simpara>
<simpara>
Die IETF-Variante verwendet 96-Bit-Nonces und interne 32-Bit Zähler anstelle
von 64-Bit für beides.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -32,37 +32,37 @@
<varlistentry>
<term><parameter>ciphertext</parameter></term>
<listitem>
<para>
<simpara>
Muss das von der Funktion
<function>sodium_crypto_aead_chacha20poly1305_ietf_encrypt</function>
bereitgestellte Format haben (Chiffretext und Tag, verknüpft).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
12 Bytes lang.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Entschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -70,9 +70,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt im Erfolgsfall den Klartext zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

32
reference/sodium/functions/sodium-crypto-aead-chacha20poly1305-ietf-encrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-chacha20poly1305-ietf-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-chacha20poly1305-ietf-encrypt">
<refnamediv>
<refname>sodium_crypto_aead_chacha20poly1305_ietf_encrypt</refname>
<refpurpose>Verschlüsselt eine Nachricht</refpurpose>
@@ -16,14 +16,14 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Verschlüsselt und authentifiziert eine Nachricht mit ChaCha20-Poly1305
(IETF-Variante).
</para>
<para>
</simpara>
<simpara>
Die IETF-Variante verwendet 96-Bit-Nonces und interne 32-Bit Zähler anstelle
von 64-Bit für beides.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -32,35 +32,35 @@
<varlistentry>
<term><parameter>message</parameter></term>
<listitem>
<para>
<simpara>
Der Klartext, welcher verschlüsselt werden soll.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
12 Bytes lang.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Verschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -68,9 +68,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt bei Erfolg den Chiffriertext und das Tag zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

15
reference/sodium/functions/sodium-crypto-aead-chacha20poly1305-ietf-keygen.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-chacha20poly1305-ietf-keygen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-chacha20poly1305-ietf-keygen">
<refnamediv>
<refname>sodium_crypto_aead_chacha20poly1305_ietf_keygen</refname>
<refpurpose>Generiert einen zufälligen ChaCha20-Poly1305-IETF-Schlüssel.</refpurpose>
@@ -11,13 +11,13 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>sodium_crypto_aead_chacha20poly1305_ietf_keygen</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
Generiert einen zufälligen Schlüssel für die Nutzung von
<function>sodium_crypto_aead_chacha20poly1305_ietf_encrypt</function> und
<function>sodium_crypto_aead_chacha20poly1305_ietf_decrypt</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,12 +27,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt einen 256-Bit-Zufallsschlüssel zurück.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

15
reference/sodium/functions/sodium-crypto-aead-chacha20poly1305-keygen.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-chacha20poly1305-keygen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-chacha20poly1305-keygen">
<refnamediv>
<refname>sodium_crypto_aead_chacha20poly1305_keygen</refname>
<refpurpose>Generiert einen zufälligen ChaCha20-Poly1305-Schlüssel</refpurpose>
@@ -11,13 +11,13 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>sodium_crypto_aead_chacha20poly1305_keygen</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
Generiert einen zufälligen Schlüssel für die Nutzung von
<function>sodium_crypto_aead_chacha20poly1305_encrypt</function> und
<function>sodium_crypto_aead_chacha20poly1305_decrypt</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,12 +27,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt einen 256-Bit-Zufallsschlüssel zurück.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

32
reference/sodium/functions/sodium-crypto-aead-xchacha20poly1305-ietf-decrypt.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c9351adb0a56f29096cce33e2790f441a26c3d8d Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-decrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-decrypt">
<refnamediv>
<refname>sodium_crypto_aead_xchacha20poly1305_ietf_decrypt</refname>
<refpurpose>(Empfohlen) Überprüft und entschlüsselt eine Nachricht mit XChaCha20-Poly1305</refpurpose>
@@ -15,13 +15,13 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Überprüft und entschlüsselt eine Nachricht mit ChaCha20-Poly1305
(Erweiterte-Nonce-Variante).
</para>
<para>
</simpara>
<simpara>
Im Allgemeinen ist XChaCha20-Poly1305 der beste der angebotenen AEAD-Modi.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,39 +30,39 @@
<varlistentry>
<term><parameter>ciphertext</parameter></term>
<listitem>
<para>
<simpara>
Muss das von der Funktion
<function>sodium_crypto_aead_xchacha20poly1305_ietf_encrypt</function>
bereitgestellte Format haben (Chiffretext und Tag, verknüpft).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
24 Bytes lang.
Diese Größe ist groß genug, um sie zufällig zu erzeugen
(&zb; mit <function>random_bytes</function>).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Entschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -70,9 +70,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt im Erfolgsfall den Klartext zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

32
reference/sodium/functions/sodium-crypto-aead-xchacha20poly1305-ietf-encrypt.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-encrypt">
<refnamediv>
<refname>sodium_crypto_aead_xchacha20poly1305_ietf_encrypt</refname>
<refpurpose>(Empfohlen) Verschlüsselt und authentifiziert eine Nachricht mit XChaCha20-Poly1305</refpurpose>
@@ -16,13 +16,13 @@
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Verschlüsselt und authentifiziert eine Nachricht mit XChaCha20-Poly1305
(Erweiterte-Nonce-Variante).
</para>
<para>
</simpara>
<simpara>
Im Allgemeinen ist XChaCha20-Poly1305 der beste der angebotenen AEAD-Modi.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,37 +31,37 @@
<varlistentry>
<term><parameter>message</parameter></term>
<listitem>
<para>
<simpara>
Der Klartext, welcher verschlüsselt werden soll.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
<simpara>
Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder
verschlüsselt, noch an den Chiffriertext angehängt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
<simpara>
Eine Nummer, die nur einmal pro Nachricht verwendet werden darf;
24 Bytes lang.
Diese Größe ist groß genug, um sie zufällig zu erzeugen
(&zb; mit <function>random_bytes</function>).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Schlüssel für die Verschlüsselung (256-bit).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -69,9 +69,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt bei Erfolg den Chiffriertext und das Tag zurück. &return.falseforfailure;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

15
reference/sodium/functions/sodium-crypto-aead-xchacha20poly1305-ietf-keygen.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-keygen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-keygen">
<refnamediv>
<refname>sodium_crypto_aead_xchacha20poly1305_ietf_keygen</refname>
<refpurpose>Generiert einen zufälligen XChaCha20-Poly1305-Schlüssel.</refpurpose>
@@ -11,13 +11,13 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>sodium_crypto_aead_xchacha20poly1305_ietf_keygen</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
Generiert einen zufälligen Schlüssel für die Nutzung von
<function>sodium_crypto_aead_xchacha20poly1305_ietf_encrypt</function> und
<function>sodium_crypto_aead_xchacha20poly1305_ietf_decrypt</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,12 +27,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt einen 256-Bit-Zufallsschlüssel zurück.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

24
reference/sodium/functions/sodium-hex2bin.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-hex2bin" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-hex2bin">
<refnamediv>
<refname>sodium_hex2bin</refname>
<refpurpose>Dekodiert eine hexadezimal kodierte binäre Zeichenkette</refpurpose>
@@ -14,14 +14,14 @@
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>ignore</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Dekodiert eine hexadezimal kodierte binäre Zeichenkette.
</para>
<para>
</simpara>
<simpara>
Wie <function>sodium_bin2hex</function> ist auch
<function>sodium_hex2bin</function> resistent gegen Seitenkanalattacken,
während <function>hex2bin</function> dies nicht ist.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,17 +30,17 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Hexadezimale Darstellung der Daten.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>ignore</parameter></term>
<listitem>
<para>
<simpara>
Optionales String-Argument für zu ignorierende Zeichen.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -48,10 +48,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt die binäre Darstellung der angegebenen Zeichenkette
(<parameter>string</parameter>) zurück.
</para>
</simpara>
</refsect1>
</refentry>

16
reference/sodium/functions/sodium-increment.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-increment" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-increment">
<refnamediv>
<refname>sodium_increment</refname>
<refpurpose>Inkrementieren einer großen Zahl</refpurpose>
@@ -13,11 +13,11 @@
<type>void</type><methodname>sodium_increment</methodname>
<methodparam><type>string</type><parameter role="reference">string</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Behandelt die gegebene Zeichenkette als Little-Endian-Ganzzahl ohne
Vorzeichen und erhöht sie dann um 1.
Diese Funktion läuft zeitkonstant.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,9 +26,9 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Zeichenkette, die erhöht werden soll.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -36,9 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
</refentry>

24
reference/sodium/functions/sodium-memcmp.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-memcmp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-memcmp">
<refnamediv>
<refname>sodium_memcmp</refname>
<refpurpose>Prüfung auf Gleichheit bei konstanter Zeit</refpurpose>
@@ -14,10 +14,10 @@
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string1</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string2</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Vergleich zweier Zeichenketten in konstanter Zeit.
</para>
<para>
</simpara>
<simpara>
In der Praxis sollte man statt dieser Funktion fast immer
<function>hash_equals</function> verwenden, da diese Funktion die gleiche
Logik bietet, aber einen <type>bool</type>-Rückgabewert anstelle
@@ -25,7 +25,7 @@
des Vergleichs in einer Berechnung verwendet wird, welche zeitkonstant sein
soll, und daher eine Typkonvertierung vermieden werden soll, ist
<function>sodium_memcmp</function> ein idealer Ersatz.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -34,17 +34,17 @@
<varlistentry>
<term><parameter>string1</parameter></term>
<listitem>
<para>
<simpara>
Zu vergleichende Zeichenkette
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>string2</parameter></term>
<listitem>
<para>
<simpara>
Andere Zeichenkette zum Vergleich
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,10 +52,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt <literal>0</literal> zurück, wenn beide Zeichenketten gleich sind;
<literal>-1</literal> im anderen Fall.
</para>
</simpara>
</refsect1>
</refentry>

16
reference/sodium/functions/sodium-memzero.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-memzero" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-memzero">
<refnamediv>
<refname>sodium_memzero</refname>
<refpurpose>Überschreibt eine Zeichenkette mit einem Nullzeichen</refpurpose>
@@ -13,10 +13,10 @@
<type>void</type><methodname>sodium_memzero</methodname>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter role="reference">string</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>sodium_memzero</function> überschreibt eine Zeichenkette
mit Nullzeichen.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,9 +25,9 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Zeichenkette.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -35,9 +35,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
</refentry>

20
reference/sodium/functions/sodium-pad.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-pad" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-pad">
<refnamediv>
<refname>sodium_pad</refname>
<refpurpose>Fügt Fülldaten hinzu</refpurpose>
@@ -14,10 +14,10 @@
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string</parameter></methodparam>
<methodparam><type>int</type><parameter>block_size</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Füllt den rechten Teil einer Zeichenkette mit Fülldaten auf. Diese Funktion
arbeitet zeitkonstant.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,18 +26,18 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Zeichenkette ohne Fülldaten.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>block_size</parameter></term>
<listitem>
<para>
<simpara>
Die Zeichenkette wird aufgefüllt, bis sie ein gerades Vielfaches
der Blockgröße ist.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -45,9 +45,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Zeichenkette mit Fülldaten.
</para>
</simpara>
</refsect1>
</refentry>

20
reference/sodium/functions/sodium-unpad.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: joshuaruesweg Status: ready -->
<refentry xml:id="function.sodium-unpad" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-unpad">
<refnamediv>
<refname>sodium_unpad</refname>
<refpurpose>Entfernt Fülldaten</refpurpose>
@@ -14,10 +14,10 @@
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>string</parameter></methodparam>
<methodparam><type>int</type><parameter>block_size</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Entfernt Fülldaten von einer Zeichenkette. Diese Funktion arbeitet
zeitkonstant.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,17 +26,17 @@
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
<simpara>
Zeichenkette mit Fülldaten.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>block_size</parameter></term>
<listitem>
<para>
<simpara>
Die Blockgröße des Paddings.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,9 +44,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Zeichenkette ohne Fülldaten.
</para>
</simpara>
</refsect1>
</refentry>

26
reference/sodium/setup.xml
View File

@@ -1,55 +1,53 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: joshuaruesweg Status: ready -->
<chapter xml:id="sodium.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sodium.setup">
&reftitle.setup;
<section xml:id="sodium.requirements">
&reftitle.required;
<para>
<simpara>
Diese Erweiterung benötigt <link xlink:href="&url.libsodium;">libsodium</link>
≥ 1.0.8.
</para>
</simpara>
</section>
<section xml:id="sodium.installation">
&reftitle.install;
<para>
<simpara>
Ab PHP 7.2.0 ist diese Erweiterung im Lieferumfang von PHP enthalten.
Für ältere PHP-Versionen ist diese Erweiterung über <acronym>PECL</acronym>
verfügbar.
</para>
</simpara>
<section xml:id="sodium.installation.new">
<title>Linux-Systeme</title>
<para>
<simpara>
Um diese Erweiterung nutzen zu können, muss PHP mit Sodium-Unterstützung
kompiliert werden, indem die
<option role="configure">--with-sodium[=DIR]</option>-Option verwendet wird.
</para>
</simpara>
</section>
<section xml:id="sodium.installation.windows">
<title>Windows</title>
<para>
<simpara>
Um die Erweiterung zu nutzen muss <filename>php_sodium.dll</filename> in
die &php.ini; hinzugefügt werden.
</para>
</simpara>
</section>
<section xml:id="sodium.installation.pecl">
<title>Installation mittels PECL</title>
<para>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;libsodium">&url.pecl.package;libsodium</link>
</para>
</simpara>
</section>
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

9
reference/sodium/sodiumexception.xml
View File

@@ -1,8 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: joshuaruesweg Status: ready -->
<reference xml:id="class.sodiumexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: 96a8863cc0403bb23a99caff9a113b64f3524671 Maintainer: joshuaruesweg Status: ready -->
<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.sodiumexception" role="class">
<title>Die SodiumException-Klasse</title>
<titleabbrev>SodiumException</titleabbrev>
@@ -12,9 +11,9 @@
<!-- {{{ SodiumException intro -->
<section xml:id="sodiumexception.intro">
&reftitle.intro;
<para>
<simpara>
Exceptions, die von den Sodium-Funktionen geworfen werden.
</para>
</simpara>
</section>
<!-- }}} -->