diff options
| author |   schwarze <schwarze@openbsd.org> | 2018-02-14 23:49:52 +0000 |
|---|---|---|
| committer | schwarze <schwarze@openbsd.org> | 2018-02-14 23:49:52 +0000 |
| commit | 68b16125499c5652d7ae43131bb672117bfabb8a (patch) | |
| tree | 32d35cf3f40ee4708734561fe2f68d072b266d63 | |
| parent | sync (diff) | |
| download | wireguard-openbsd-68b16125499c5652d7ae43131bb672117bfabb8a.tar.xz wireguard-openbsd-68b16125499c5652d7ae43131bb672117bfabb8a.zip | |
In evp.h rev. 1.54 2018/02/14 16:40:42, jsing@ provided EVP_PKEY_up_ref(3).
Merge the documentation from OpenSSL commits 0c497e96 Dec 14 18:10:16
2015 +0000 and c5ebfcab Mar 7 22:45:58 2016 +0100 with tweaks by me.
| -rw-r--r-- | lib/libcrypto/man/EVP_PKEY_new.3 | 26 |
1 files changed, 22 insertions, 4 deletions
diff --git a/lib/libcrypto/man/EVP_PKEY_new.3 b/lib/libcrypto/man/EVP_PKEY_new.3 index 54b863b88f5..994e1680b97 100644 --- a/lib/libcrypto/man/EVP_PKEY_new.3 +++ b/lib/libcrypto/man/EVP_PKEY_new.3 @@ -1,5 +1,5 @@ -.\" $OpenBSD: EVP_PKEY_new.3,v 1.4 2018/02/14 02:15:46 schwarze Exp $ -.\" OpenSSL 9b86974e Aug 17 15:21:33 2015 -0400 +.\" $OpenBSD: EVP_PKEY_new.3,v 1.5 2018/02/14 23:49:52 schwarze Exp $ +.\" full merge up to: OpenSSL 99d63d42 Oct 26 13:56:48 2016 -0400 .\" .\" This file was written by Dr. Stephen Henson <steve@openssl.org>. .\" Copyright (c) 2002 The OpenSSL Project. All rights reserved. @@ -53,12 +53,17 @@ .Os .Sh NAME .Nm EVP_PKEY_new , +.Nm EVP_PKEY_up_ref , .Nm EVP_PKEY_free .Nd private key allocation functions .Sh SYNOPSIS .In openssl/evp.h .Ft EVP_PKEY * .Fn EVP_PKEY_new void +.Ft int +.Fo EVP_PKEY_up_ref +.Fa "EVP_PKEY *key" +.Fc .Ft void .Fo EVP_PKEY_free .Fa "EVP_PKEY *key" @@ -74,12 +79,19 @@ The function allocates an empty .Vt EVP_PKEY structure. +The reference count is set to 1. To add a private key to it, use the functions described in .Xr EVP_PKEY_set1_RSA 3 . .Pp +.Fn EVP_PKEY_up_ref +increments the reference count of +.Fa key +by 1. +.Pp .Fn EVP_PKEY_free -frees up the private key -.Fa key . +decrements the reference count of +.Fa key +by 1, and if the reference count reaches zero, frees it up. If .Fa key is a @@ -92,6 +104,9 @@ returns either the newly allocated structure or .Dv NULL if an error occurred. +.Pp +.Fn EVP_PKEY_up_ref +returns 1 for success or 0 for failure. .Sh SEE ALSO .Xr EVP_PKEY_asn1_set_free 3 , .Xr EVP_PKEY_set1_RSA 3 @@ -100,3 +115,6 @@ if an error occurred. and .Fn EVP_PKEY_free exist in all versions of OpenSSL. +.Pp +.Fn EVP_PKEY_up_ref +first appeared in OpenSSL 1.1.0. |