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