DH_SET_METHOD(3ssl)

NUME
DH_set_default_method, DH_get_default_method, DH_set_method, DH_new_method, DH_OpenSSL - selectează metoda DH

SINOPSIS
 #include <openssl/dh.h>

Următoarele funcții au fost depreciate de la OpenSSL 3.0 și pot fi ascunse complet prin definirea OPENSSL_API_COMPAT cu o valoare de versiune adecvată, a se vedea openssl_user_macros(7):

 void DH_set_default_method(const DH_METHOD *meth);

 const DH_METHOD *DH_get_default_method(void);

 int DH_set_method(DH *dh, const DH_METHOD *meth);

 DH *DH_new_method(ENGINE *engine);

 const DH_METHOD *DH_OpenSSL(void);

DESCRIERE
Toate funcțiile descrise în această pagină sunt învechite. Aplicațiile ar trebui să utilizeze în schimb API-urile furnizorului.

A DH_METHOD specifică funcțiile pe care OpenSSL le utilizează pentru operațiile Diffie-Hellman. Prin modificarea metodei, pot fi utilizate implementări alternative, cum ar fi acceleratoarele hardware. IMPORTANT: Consultați secțiunea NOTE pentru informații importante despre modul în care aceste funcții API DH sunt afectate de utilizarea apelurilor API ENGINE.

Inițial, metoda DH_METHOD implicită este implementarea internă OpenSSL, așa cum este returnată de DH_OpenSSL().

DH_set_default_method() face din meth metoda implicită pentru toate structurile DH create ulterior. NB: Acest lucru este valabil numai în cazul în care niciun MOTOR nu a fost definit ca implicit pentru DH, astfel încât această funcție nu mai este recomandată. Această funcție nu este sigură pentru firele de execuție și nu trebuie apelată în același timp cu alte funcții OpenSSL.

DH_get_default_method() returnează un indicator către DH_METHOD implicită curentă. Cu toate acestea, semnificația acestui rezultat depinde de utilizarea API-ului MOTOR, astfel încât această funcție nu mai este recomandată.

DH_set_method() selectează meth pentru a efectua toate operațiile utilizând cheia dh. Aceasta va înlocui DH_METHOD utilizată de cheia DH și, dacă metoda anterioară a fost furnizată de un MOTOR, gestionarul către acel MOTOR va fi eliberat în timpul schimbării. Este posibil să existe chei DH care funcționează numai cu anumite implementări DH_METHOD (de exemplu, dintr-un modul MOTOR care acceptă chei protejate hardware încorporate) și, în astfel de cazuri, încercarea de a modifica DH_METHOD pentru cheie poate avea rezultate neașteptate.

DH_new_method() alocă și inițializează o structură DH astfel încât engine să fie utilizat pentru operațiile DH. Dacă engine este NULL, se utilizează MOTORUL implicit pentru operațiile DH, iar dacă nu este definit niciun MOTOR implicit, se utilizează DH_METHOD controlată de DH_set_default_method().

Un nou obiect DH_METHOD poate fi construit folosind DH_meth_new() (a se vedea DH_meth_new(3)).

VALORI RETURNATE
DH_OpenSSL() și DH_get_default_method() returnează indicatori către respectivele metode DH_METHOD.

DH_set_default_method() nu returnează nicio valoare.

DH_set_method() returnează o valoare diferită de zero dacă meth furnizată a fost definită cu succes ca metodă pentru dh (inclusiv descărcarea gestionarului MOTORULUI dacă metoda anterioară a fost furnizată de un MOTOR).

DH_new_method() returnează NULL și definește un cod de eroare care poate fi obținut prin ERR_get_error(3) dacă alocarea eșuează. În caz contrar, returnează un indicator către structura nou alocată.

CONSULTAȚI ȘI
DH_new(3), DH_new(3), DH_meth_new(3)

ISTORIC
Toate aceste funcții au fost depreciate în OpenSSL 3.0.

DREPTURI DE AUTOR
Drepturi de autor 2000-2020 The OpenSSL Project Authors. Toate drepturile rezervate.

Licențiat sub Licența Apache 2.0 („License”). Nu aveți voie să utilizați acest fișier decât în conformitate cu licența. Puteți obține o copie din fișierul LICENSE din distribuția sursei sau de la <https://www.openssl.org/source/license.html>.

TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.