DragonFly On-Line Manual Pages

RSA_METH_NEW(3)       DragonFly Library Functions Manual       RSA_METH_NEW(3)

NAME
     RSA_meth_new, RSA_meth_dup, RSA_meth_free, RSA_meth_get_finish,
     RSA_meth_set1_name, RSA_meth_set_finish, RSA_meth_set_priv_enc,
     RSA_meth_set_priv_dec -- build up RSA methods

SYNOPSIS
     #include <openssl/rsa.h>

     RSA_METHOD *
     RSA_meth_new(const char *name, int flags);

     RSA_METHOD *
     RSA_meth_dup(const RSA_METHOD *meth);

     void
     RSA_meth_free(RSA_METHOD *meth);

     int
     RSA_meth_set1_name(RSA_METHOD *meth, const char *name);

     int
     (*RSA_meth_get_finish(const RSA_METHOD *meth))(RSA *rsa);

     int
     RSA_meth_set_finish(RSA_METHOD *meth, int (*finish)(RSA *rsa));

     int
     RSA_meth_set_priv_enc(RSA_METHOD *meth,
	 int (*priv_enc)(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding));

     int
     RSA_meth_set_priv_dec(RSA_METHOD *meth,
	 int (*priv_dec)(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding));

DESCRIPTION
     The RSA_METHOD structure holds function pointers for custom RSA implemen-
     tations.

     RSA_meth_new() creates a new RSA_METHOD structure.  A copy of the NUL-
     terminated name is stored in the new RSA_METHOD object.  Any new RSA
     object constructed from this RSA_METHOD will have the given flags set by
     default.

     RSA_meth_dup() creates a deep copy of meth.  This might be useful for
     creating a new RSA_METHOD based on an existing one, but with some differ-
     ences.

     RSA_meth_free() destroys meth and frees any memory associated with it.

     RSA_meth_set1_name() Stores a copy of the NUL-terminated name in the
     RSA_METHOD object after freeing the previously stored name.

     RSA_meth_get_finish() and RSA_meth_set_finish() get and set an optional
     function for destroying an RSA object.  Unless finish is NULL, it will be
     called from RSA_free(3).  It takes the same argument and is intended to
     do RSA implementation specific cleanup.  The memory used by the RSA
     object itself should not be freed by the finish function.

     RSA_meth_set_priv_enc() and RSA_meth_set_priv_dec() set the functions
     used for private key encryption and decryption.  These functions will be
     called from RSA_private_decrypt(3) and RSA_private_encrypt(3) and take
     the same parameters as those.

RETURN VALUES
     RSA_meth_new() and RSA_meth_dup() return the newly allocated RSA_METHOD
     object or NULL on failure.

     All RSA_meth_set*() functions return 1 on success or 0 on failure.

SEE ALSO
     RSA_new(3), RSA_private_decrypt(3), RSA_private_encrypt(3),
     RSA_set_method(3)

HISTORY
     These functions first appeared in OpenSSL 1.1.0.  RSA_meth_get_finish()
     and RSA_meth_set1_name() have been available since OpenBSD 6.4, all the
     other functions since OpenBSD 6.3.

DragonFly 5.5		      September 12, 2018		 DragonFly 5.5