From eb8dd9dca1228af0cd132f515509051ecfabf6f6 Mon Sep 17 00:00:00 2001 From: cvs2svn Date: Mon, 14 Apr 2025 17:32:06 +0000 Subject: This commit was manufactured by cvs2git to create tag 'tb_20250414'. --- src/lib/libcrypto/man/X509_keyid_set1.3 | 171 -------------------------------- 1 file changed, 171 deletions(-) delete mode 100644 src/lib/libcrypto/man/X509_keyid_set1.3 (limited to 'src/lib/libcrypto/man/X509_keyid_set1.3') diff --git a/src/lib/libcrypto/man/X509_keyid_set1.3 b/src/lib/libcrypto/man/X509_keyid_set1.3 deleted file mode 100644 index c529fc742b..0000000000 --- a/src/lib/libcrypto/man/X509_keyid_set1.3 +++ /dev/null @@ -1,171 +0,0 @@ -.\" $OpenBSD: X509_keyid_set1.3,v 1.2 2021/07/09 14:41:14 tb Exp $ -.\" -.\" Copyright (c) 2021 Ingo Schwarze -.\" -.\" Permission to use, copy, modify, and distribute this software for any -.\" purpose with or without fee is hereby granted, provided that the above -.\" copyright notice and this permission notice appear in all copies. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF -.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -.\" -.Dd $Mdocdate: July 9 2021 $ -.Dt X509_KEYID_SET1 3 -.Os -.Sh NAME -.Nm X509_keyid_set1 , -.Nm X509_keyid_get0 , -.Nm X509_alias_set1 , -.Nm X509_alias_get0 -.Nd auxiliary certificate data for PKCS#12 -.Sh SYNOPSIS -.In openssl/x509.h -.Ft int -.Fo X509_keyid_set1 -.Fa "X509 *x" -.Fa "const unsigned char *data" -.Fa "int len" -.Fc -.Ft unsigned char * -.Fo X509_keyid_get0 -.Fa "X509 *x" -.Fa "int *plen" -.Fc -.Ft int -.Fo X509_alias_set1 -.Fa "X509 *x" -.Fa "const unsigned char *data" -.Fa "int len" -.Fc -.Ft unsigned char * -.Fo X509_alias_get0 -.Fa "X509 *x" -.Fa "int *plen" -.Fc -.Sh DESCRIPTION -These functions store non-standard auxiliary data in -.Fa x -and retrieve it. -.Pp -The -.Fa len -bytes of -.Fa data -stored using -.Fn X509_keyid_set1 -will be written to the -.Sy localKeyID -attribute of the PKCS#12 structure if -.Xr PKCS12_create 3 -is later called on -.Fa x , -and the -.Fa data -stored using -.Fn X509_alias_set1 -will be written to the -.Sy friendlyName -attribute. -If -.Fa data -points to a NUL-terminated string, \-1 can be passed as the -.Fa len -argument to let -.Fa len -be calculated internally using -.Xr strlen 3 . -If a -.Dv NULL -pointer is passed as the -.Fa data -argument, the respective auxiliary data stored in -.Fa x , -if any, is removed from -.Fa x -and freed. -.Pp -Conversely, -.Xr PKCS12_parse 3 -retrieves these attributes from a PKCS#12 structure such that they can -subsequently be accessed with -.Fn X509_keyid_get0 -and -.Fn X509_alias_get0 . -Unless -.Dv NULL -is passed for the -.Fa plen -argument, these functions store the size of the returned buffer in bytes in -.Pf * Fa plen . -After the call, the returned buffer is not necessarily NUL-terminated, -but it may contain internal NUL bytes. -.Pp -API design is very incomplete; given the complexity of PKCS#12, -that's probably an asset rather than a defect. -The PKCS#12 standard defines many attributes that cannot be stored in -.Vt X509 -objects. -.Pp -To associate certificates with alternative names and key identifiers, -X.509 certificate extensions are more commonly used than PKCS#12 -attributes, for example using -.Xr X509_EXTENSION_create_by_NID 3 -with -.Dv NID_subject_alt_name -or -.Dv NID_subject_key_identifier . -.Sh RETURN VALUES -.Fn X509_keyid_set1 -and -.Fn X509_alias_set1 -return 1 if -.Fa data -is -.Dv NULL -or if the input -.Fa data -was successfully copied into -.Fa x , -or 0 if -.Fa data -is not -.Dv NULL -but could not be copied because -.Fa x -is -.Dv NULL -or memory allocation failed. -.Pp -.Fn X509_keyid_get0 -and -.Fn X509_alias_get0 -return an internal pointer to an array of bytes or -.Dv NULL -if -.Fa x -does not contain auxiliary data of the requested kind. -.Sh SEE ALSO -.Xr ASN1_STRING_set 3 , -.Xr X509_CERT_AUX_new 3 , -.Xr X509_EXTENSION_new 3 , -.Xr X509_new 3 , -.Xr X509V3_get_d2i 3 -.Sh HISTORY -.Fn X509_alias_set1 -and -.Fn X509_alias_get0 -first appeared in OpenSSL 0.9.5 and have been available since -.Ox 2.7 . -.Pp -.Fn X509_keyid_set1 -first appeared in OpenSSL 0.9.6 and has been available since -.Ox 2.9 . -.Pp -.Fn X509_keyid_get0 -first appeared in OpenSSL 0.9.8 and has been available since -.Ox 4.5 . -- cgit v1.2.3-55-g6feb