1=pod
2
3=head1 NAME
4
5X509_ACERT_add_attr_nconf
6- Add attributes to X509_ACERT from configuration section
7
8=head1 SYNOPSIS
9
10 #include <openssl/x509_acert.h>
11
12 int X509_ACERT_add_attr_nconf(CONF *conf, const char *section,
13                               X509_ACERT *acert);
14
15=head1 DESCRIPTION
16
17X509_ACERT_add_attr_nconf() adds one or more B<X509_ATTRIBUTE>s to the
18existing B<X509_ACERT> structure I<acert>. The attributes are read
19from a I<section> of the I<conf> object.
20
21The give I<section> of the configuration should contain attribute
22descriptions of the form:
23
24  attribute_name = value
25
26The format of B<value> will vary depending on the B<attribute_name>.
27B<value> can either be a string value or an B<ASN1_TYPE>
28object.
29
30To encode an B<ASN1_TYPE> object, use the prefix "ASN1:" followed by
31the object description that uses the same syntax as L<ASN1_generate_nconf(3)>.
32For example:
33
34 id-aca-group = ASN1:SEQUENCE:ietfattr
35
36 [ietfattr]
37 values = SEQUENCE:groups
38
39 [groups]
40 1.string = UTF8:mygroup1
41
42=head1 RETURN VALUES
43
44X509_ACERT_add_attr_nconf() returns 1 for success and 0 for failure.
45
46=head1 SEE ALSO
47
48L<ASN1_generate_nconf(3)>.
49
50=head1 HISTORY
51
52The function X509_ACERT_add_attr_nconf() was added in OpenSSL 3.4.
53
54=head1 COPYRIGHT
55
56Copyright 2023-2024 The OpenSSL Project Authors. All Rights Reserved.
57
58Licensed under the Apache License 2.0 (the "License").  You may not use
59this file except in compliance with the License.  You can obtain a copy
60in the file LICENSE in the source distribution or at
61L<https://www.openssl.org/source/license.html>.
62
63=cut
64