BN_CTX_START(3SSL)

BEZEICHNUNG
BN_CTX_start, BN_CTX_get, BN_CTX_end - Temporäre BIGNUM-Variablen verwenden

ÜBERSICHT
 #include <openssl/bn.h>

 void BN_CTX_start(BN_CTX *ctx);

 BIGNUM *BN_CTX_get(BN_CTX *ctx);

 void BN_CTX_end(BN_CTX *ctx);

BESCHREIBUNG
Diese Funktionen werden zum Erlangen temporärer BIGNUM-Variablen aus einem BN_CTX (der mittels BN_CTX_new(3) erstellt worden sein kann) verwandt, um den Mehraufwand des wiederholten Erstellens und Freigebens von BIGNUMs in Funktionen zu vermeiden, die innerhalb einer Schleife aufgerufen werden.

Eine Funktion muss zuerst BN_CTX_start() aufrufen. Dann kann wiederholt BN_CTX_get() aufgerufen werden, um temporäre BIGNUMs zu erhalten. Alle Aufrufe BN_CTX_get() müssen vor dem Aufruf jeder anderen Funktion erfolgen, die die ctx als Argument nutzen.

Schließlich muss BN_CTX_end() aufgerufen werden, bevor aus der Funktion zurückgekehrt wird. Falls ctx NULL ist, passiert nichts. Wenn BN_CTX_end() aufgerufen wird, werden die von BN_CTX_get() erhaltenen BIGNUM-Zeiger ungültig.

RÜCKGABEWERTE
BN_CTX_start() und BN_CTX_end() geben keine Werte zurück.

BN_CTX_get() liefert einen Zeiger auf die BIGNUM oder NULL im Fehlerfall. Sobald BN_CTX_get() fehlgeschlagen ist, werden auch nachfolgende Aufrufe NULL zurückliefern, daher reicht es aus, den Rückgabewert des letzten Aufrufs von BN_CTX_get() zu prüfen. Im Fehlerfall wird ein Fehler-Code gesetzt, der mittels ERR_get_error(3) erlangt werden kann.

SIEHE AUCH
BN_CTX_new(3)

COPYRIGHT
Copyright 2000-2016 Die OpenSSL-Projekt-Autoren. Alle Rechte vorbehalten.

Lizenziert under der Apache License 2.0 (der »Lizenz«). Sie dürfen diese Datei nur verwenden, wenn Sie der Lizenz folgen. Sie können eine Kopie der Lizenz in der Datei LICENSE in der Quelldistribution finden oder unter <https://www.openssl.org/source/license.html>.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer (debian-l10n-german@lists.debian.org).