Document X509_verify_ex() and X509_REQ_verify_ex()
[openssl.git] / doc / man3 / PKCS12_get_friendlyname.pod
1 =pod
2
3 =head1 NAME
4
5 PKCS12_get_friendlyname - Retrieve the friendlyname attribute from a PKCS#12 safeBag
6
7 =head1 SYNOPSIS
8
9  #include <openssl/pkcs12.h>
10
11  char *PKCS12_get_friendlyname(PKCS12_SAFEBAG *bag);
12
13 =head1 DESCRIPTION
14
15 PKCS12_get_friendlyname() retrieves a UTF-8 string representation of the PKCS#9
16 friendlyName attribute for a PKCS#12 safeBag item.
17
18 I<bag> is the B<PKCS12_SAFEBAG> to retrieve the attribute from.
19
20 =head1 RETURN VALUES
21
22 A UTF-8 string, or NULL if the attribute was either not present or an error occurred.
23
24 The returned string is allocated by OpenSSL and should be freed by the user.
25
26 =head1 SEE ALSO
27
28 L<PKCS12_add_friendlyname_asc(3)>
29
30 =head1 COPYRIGHT
31
32 Copyright 2019 The OpenSSL Project Authors. All Rights Reserved.
33
34 Licensed under the Apache License 2.0 (the "License").  You may not use
35 this file except in compliance with the License.  You can obtain a copy
36 in the file LICENSE in the source distribution or at
37 L<https://www.openssl.org/source/license.html>.
38
39 =cut