| 1 | =pod
|
|---|
| 2 |
|
|---|
| 3 | =head1 NAME
|
|---|
| 4 |
|
|---|
| 5 | PKCS12_SAFEBAG_get0_attrs, PKCS12_get_attr_gen
|
|---|
| 6 | - Retrieve attributes from a PKCS#12 safeBag
|
|---|
| 7 |
|
|---|
| 8 | =head1 SYNOPSIS
|
|---|
| 9 |
|
|---|
| 10 | #include <openssl/pkcs12.h>
|
|---|
| 11 |
|
|---|
| 12 | const STACK_OF(X509_ATTRIBUTE) *PKCS12_SAFEBAG_get0_attrs(const PKCS12_SAFEBAG *bag);
|
|---|
| 13 |
|
|---|
| 14 | ASN1_TYPE *PKCS12_get_attr_gen(const STACK_OF(X509_ATTRIBUTE) *attrs,
|
|---|
| 15 | int attr_nid);
|
|---|
| 16 |
|
|---|
| 17 | =head1 DESCRIPTION
|
|---|
| 18 |
|
|---|
| 19 | PKCS12_SAFEBAG_get0_attrs() retrieves the stack of B<X509_ATTRIBUTE>s from a
|
|---|
| 20 | PKCS#12 safeBag. I<bag> is the B<PKCS12_SAFEBAG> to retrieve the attributes from.
|
|---|
| 21 |
|
|---|
| 22 | PKCS12_get_attr_gen() retrieves an attribute by NID from a stack of
|
|---|
| 23 | B<X509_ATTRIBUTE>s. I<attr_nid> is the NID of the attribute to retrieve.
|
|---|
| 24 |
|
|---|
| 25 | =head1 RETURN VALUES
|
|---|
| 26 |
|
|---|
| 27 | PKCS12_SAFEBAG_get0_attrs() returns the stack of B<X509_ATTRIBUTE>s from a
|
|---|
| 28 | PKCS#12 safeBag, which could be empty.
|
|---|
| 29 |
|
|---|
| 30 | PKCS12_get_attr_gen() returns an B<ASN1_TYPE> object containing the attribute,
|
|---|
| 31 | or NULL if the attribute was either not present or an error occurred.
|
|---|
| 32 |
|
|---|
| 33 | PKCS12_get_attr_gen() does not allocate a new attribute. The returned attribute
|
|---|
| 34 | is still owned by the B<PKCS12_SAFEBAG> in which it resides.
|
|---|
| 35 |
|
|---|
| 36 | =head1 SEE ALSO
|
|---|
| 37 |
|
|---|
| 38 | L<PKCS12_get_friendlyname(3)>,
|
|---|
| 39 | L<PKCS12_add_friendlyname_asc(3)>
|
|---|
| 40 |
|
|---|
| 41 | =head1 COPYRIGHT
|
|---|
| 42 |
|
|---|
| 43 | Copyright 2019-2021 The OpenSSL Project Authors. All Rights Reserved.
|
|---|
| 44 |
|
|---|
| 45 | Licensed under the Apache License 2.0 (the "License"). You may not use
|
|---|
| 46 | this file except in compliance with the License. You can obtain a copy
|
|---|
| 47 | in the file LICENSE in the source distribution or at
|
|---|
| 48 | L<https://www.openssl.org/source/license.html>.
|
|---|
| 49 |
|
|---|
| 50 | =cut
|
|---|
