GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
X509_PKEY_NEW(3) FreeBSD Library Functions Manual X509_PKEY_NEW(3)

X509_PKEY_new, X509_PKEY_free
X.509 private key wrapper object

#include <openssl/x509.h>

X509_PKEY *
X509_PKEY_new(void);

void
X509_PKEY_free(X509_PKEY *wrapper);

X509_PKEY is a reference-counted wrapper object that can store
  • a pointer to an encrypted and ASN.1-encoded private key
  • a pointer to an EVP_PKEY object representing the same key in decrypted form
  • a pointer to an X509_ALGOR object identifying the algorithm used by the key

The object may contain only the encrypted key or only the decrypted key or both.

X509_PKEY is used as a sub-object of the X509_INFO object created by PEM_X509_INFO_read_bio(3) if the PEM file contains any RSA, DSA, or EC PRIVATE KEY object.

X509_PKEY_new() allocates and initializes an empty X509_PKEY object and sets its reference count to 1.

X509_PKEY_free() decrements the reference count of the wrapper object by 1. If the reference count reaches 0, it frees all internal objects allocated by the wrapper as well as the storage needed for the wrapper object itself. If wrapper is a NULL pointer, no action occurs.

X509_PKEY_new() returns a pointer to the new X509_PKEY object or NULL if memory allocation fails.

EVP_PKEY_new(3), PEM_X509_INFO_read(3), X509_INFO_new(3)

X509_PKEY_new() and X509_PKEY_free() first appeared in SSLeay 0.6.0 and have been available since OpenBSD 2.4.
October 19, 2021 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.