]>
Commit | Line | Data |
---|---|---|
2a3b52ea DO |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
7df56ada | 5 | OSSL_CRMF_MSG_get0_regInfo_utf8Pairs, |
2a3b52ea | 6 | OSSL_CRMF_MSG_set1_regInfo_utf8Pairs, |
7df56ada | 7 | OSSL_CRMF_MSG_get0_regInfo_certReq, |
2a3b52ea | 8 | OSSL_CRMF_MSG_set1_regInfo_certReq |
7df56ada | 9 | - functions getting or setting CRMF Registration Info |
2a3b52ea DO |
10 | |
11 | =head1 SYNOPSIS | |
12 | ||
13 | #include <openssl/crmf.h> | |
14 | ||
7df56ada DDO |
15 | ASN1_UTF8STRING |
16 | *OSSL_CRMF_MSG_get0_regInfo_utf8Pairs(const OSSL_CRMF_MSG *msg); | |
2a3b52ea DO |
17 | int OSSL_CRMF_MSG_set1_regInfo_utf8Pairs(OSSL_CRMF_MSG *msg, |
18 | const ASN1_UTF8STRING *utf8pairs); | |
7df56ada DDO |
19 | OSSL_CRMF_CERTREQUEST |
20 | *OSSL_CRMF_MSG_get0_regInfo_certReq(const OSSL_CRMF_MSG *msg); | |
2a3b52ea DO |
21 | int OSSL_CRMF_MSG_set1_regInfo_certReq(OSSL_CRMF_MSG *msg, |
22 | const OSSL_CRMF_CERTREQUEST *cr); | |
23 | ||
24 | =head1 DESCRIPTION | |
25 | ||
7df56ada DDO |
26 | OSSL_CRMF_MSG_get0_regInfo_utf8Pairs() returns the first utf8Pairs regInfo |
27 | in the given I<msg>, if present. | |
28 | ||
6d1f50b5 DDO |
29 | OSSL_CRMF_MSG_set1_regInfo_utf8Pairs() adds a copy of the given I<utf8pairs> |
30 | value as utf8Pairs regInfo to the given I<msg>. See RFC 4211 section 7.1. | |
2a3b52ea | 31 | |
7df56ada DDO |
32 | OSSL_CRMF_MSG_get0_regInfo_certReq() returns the first certReq regInfo |
33 | in the given I<msg>, if present. | |
34 | ||
6d1f50b5 DDO |
35 | OSSL_CRMF_MSG_set1_regInfo_certReq() adds a copy of the given I<cr> value |
36 | as certReq regInfo to the given I<msg>. See RFC 4211 section 7.2. | |
2a3b52ea DO |
37 | |
38 | =head1 RETURN VALUES | |
39 | ||
7df56ada DDO |
40 | All get0_*() functions return the respective pointer value, NULL if not present. |
41 | ||
42 | All set1_*() functions return 1 on success, 0 on error. | |
2a3b52ea DO |
43 | |
44 | =head1 NOTES | |
45 | ||
7df56ada DDO |
46 | Calling the set1_*() functions multiple times |
47 | adds multiple instances of the respective | |
6d1f50b5 | 48 | control to the regInfo structure of the given I<msg>. While RFC 4211 expects |
2a3b52ea DO |
49 | multiple utf8Pairs in one regInfo structure, it does not allow multiple certReq. |
50 | ||
51 | =head1 SEE ALSO | |
52 | ||
53 | RFC 4211 | |
54 | ||
7960dbec DDO |
55 | =head1 HISTORY |
56 | ||
57 | The OpenSSL CRMF support was added in OpenSSL 3.0. | |
58 | ||
2a3b52ea DO |
59 | =head1 COPYRIGHT |
60 | ||
eec0ad10 | 61 | Copyright 2007-2020 The OpenSSL Project Authors. All Rights Reserved. |
2a3b52ea | 62 | |
ce9b9964 | 63 | Licensed under the Apache License 2.0 (the "License"). You may not use |
2a3b52ea DO |
64 | this file except in compliance with the License. You can obtain a copy |
65 | in the file LICENSE in the source distribution or at | |
66 | L<https://www.openssl.org/source/license.html>. | |
67 | ||
68 | =cut |