xref: /freebsd/crypto/openssl/doc/man3/GENERAL_NAME.pod (revision e7be843b4a162e68651d3911f0357ed464915629)
1*e7be843bSPierre Pronchery=pod
2*e7be843bSPierre Pronchery
3*e7be843bSPierre Pronchery=head1 NAME
4*e7be843bSPierre Pronchery
5*e7be843bSPierre ProncheryGENERAL_NAME,
6*e7be843bSPierre ProncheryGENERAL_NAME_set1_X509_NAME
7*e7be843bSPierre Pronchery- GENERAL_NAME method routines
8*e7be843bSPierre Pronchery
9*e7be843bSPierre Pronchery=head1 SYNOPSIS
10*e7be843bSPierre Pronchery
11*e7be843bSPierre Pronchery #include <openssl/x509v3.h>
12*e7be843bSPierre Pronchery
13*e7be843bSPierre Pronchery typedef struct GENERAL_NAME_st GENERAL_NAME;
14*e7be843bSPierre Pronchery
15*e7be843bSPierre Pronchery int GENERAL_NAME_set1_X509_NAME(GENERAL_NAME **tgt, const X509_NAME *src);
16*e7be843bSPierre Pronchery
17*e7be843bSPierre Pronchery=head1 DESCRIPTION
18*e7be843bSPierre Pronchery
19*e7be843bSPierre ProncheryGENERAL_NAME_set1_X509_NAME() creates a new GENERAL_NAME of type GEN_DIRNAME
20*e7be843bSPierre Proncheryand populates it based on provided X509_NAME I<src> which can be NULL.
21*e7be843bSPierre ProncheryI<tgt> must not be NULL. If successful, I<*tgt> will be set to point
22*e7be843bSPierre Proncheryto the newly created GENERAL_NAME.
23*e7be843bSPierre Pronchery
24*e7be843bSPierre Pronchery=head1 RETURN VALUES
25*e7be843bSPierre Pronchery
26*e7be843bSPierre ProncheryGENERAL_NAME_set1_X509_NAME() return 1 on success, 0 on error.
27*e7be843bSPierre Pronchery
28*e7be843bSPierre Pronchery=head1 HISTORY
29*e7be843bSPierre Pronchery
30*e7be843bSPierre ProncheryGENERAL_NAME_set1_X509_NAME() was added in OpenSSL 3.4.
31*e7be843bSPierre Pronchery
32*e7be843bSPierre Pronchery=head1 COPYRIGHT
33*e7be843bSPierre Pronchery
34*e7be843bSPierre ProncheryCopyright 2007-2024 The OpenSSL Project Authors. All Rights Reserved.
35*e7be843bSPierre Pronchery
36*e7be843bSPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
37*e7be843bSPierre Proncherythis file except in compliance with the License.  You can obtain a copy
38*e7be843bSPierre Proncheryin the file LICENSE in the source distribution or at
39*e7be843bSPierre ProncheryL<https://www.openssl.org/source/license.html>.
40*e7be843bSPierre Pronchery
41*e7be843bSPierre Pronchery=cut
42