RS256_PK_NEW(3) | Library Functions Manual | RS256_PK_NEW(3) |
rs256_pk_new
, rs256_pk_free
,
rs256_pk_from_RSA
,
rs256_pk_from_EVP_PKEY
,
rs256_pk_from_ptr
,
rs256_pk_to_EVP_PKEY
—
#include <openssl/rsa.h>
#include <fido/rs256.h>
rs256_pk_t *
rs256_pk_new
(void);
void
rs256_pk_free
(rs256_pk_t
**pkp);
int
rs256_pk_from_EVP_PKEY
(rs256_pk_t
*pk, const EVP_PKEY
*pkey);
int
rs256_pk_from_RSA
(rs256_pk_t
*pk, const RSA
*rsa);
int
rs256_pk_from_ptr
(rs256_pk_t
*pk, const void
*ptr, size_t
len);
EVP_PKEY *
rs256_pk_to_EVP_PKEY
(const
rs256_pk_t *pk);
In libfido2, RS256 public keys are abstracted by the rs256_pk_t type.
The rs256_pk_new
() function returns a
pointer to a newly allocated, empty rs256_pk_t type.
If memory cannot be allocated, NULL is returned.
The rs256_pk_free
() function releases the
memory backing *pkp, where *pkp
must have been previously allocated by
rs256_pk_new
(). On return,
*pkp is set to NULL. Either pkp
or *pkp may be NULL, in which case
rs256_pk_free
() is a NOP.
The rs256_pk_from_EVP_PKEY
() function
fills pk with the contents of
pkey. No references to pkey are
kept.
The rs256_pk_from_RSA
() function fills
pk with the contents of rsa. No
references to rsa are kept.
The rs256_pk_from_ptr
() function fills
pk with the contents of ptr,
where ptr points to len bytes.
No references to ptr are kept.
The rs256_pk_to_EVP_PKEY
() function
converts pk to a newly allocated
EVP_PKEY type with a reference count of 1. No internal
references to the returned pointer are kept. If an error occurs,
rs256_pk_to_EVP_PKEY
() returns NULL.
rs256_pk_from_EVP_PKEY
(),
rs256_pk_from_RSA
(), and
rs256_pk_from_ptr
() functions return
FIDO_OK
on success. On error, a different error code
defined in <fido/err.h>
is
returned.
July 15, 2022 | Yubico AB |