2020-02-14 18:14:30 +08:00
|
|
|
=pod
|
|
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
|
|
i2s_ASN1_UTF8STRING,
|
2020-04-06 20:00:55 +08:00
|
|
|
s2i_ASN1_UTF8STRING
|
2020-02-14 18:14:30 +08:00
|
|
|
- convert objects from/to ASN.1/string representation
|
|
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
2020-04-06 20:00:55 +08:00
|
|
|
#include "crypto/x509v3.h"
|
2020-02-14 18:14:30 +08:00
|
|
|
|
|
|
|
|
char *i2s_ASN1_UTF8STRING(X509V3_EXT_METHOD *method,
|
|
|
|
|
ASN1_UTF8STRING *utf8);
|
|
|
|
|
ASN1_UTF8STRING *s2i_ASN1_UTF8STRING(X509V3_EXT_METHOD *method,
|
|
|
|
|
X509V3_CTX *ctx, const char *str);
|
2020-03-03 22:34:53 +08:00
|
|
|
|
2020-02-14 18:14:30 +08:00
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
|
|
These functions convert OpenSSL objects to and from their ASN.1/string
|
2020-06-30 03:13:07 +08:00
|
|
|
representation. This function is used for B<X509v3> extensions.
|
2020-02-14 18:14:30 +08:00
|
|
|
|
|
|
|
|
=head1 NOTES
|
|
|
|
|
|
2020-04-06 20:00:55 +08:00
|
|
|
The letters B<i> and B<s> in i2s_ASN1_UTF8STRING() stand for
|
2020-02-14 18:14:30 +08:00
|
|
|
"internal" (that is, an internal C structure) and string respectively.
|
|
|
|
|
So B<i2s_ASN1_UTF8STRING>() converts from internal to string.
|
|
|
|
|
|
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
|
|
|
|
|
|
B<s2i_ASN1_UTF8STRING>() return a valid
|
|
|
|
|
B<ASN1_UTF8STRING> structure or NULL if an error occurs.
|
|
|
|
|
|
|
|
|
|
B<i2s_ASN1_UTF8STRING>() returns the pointer to a UTF-8 string
|
|
|
|
|
or NULL if an error occurs.
|
|
|
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
|
|
Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
|
|
|
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
|
|
|
this file except in compliance with the License. You can obtain a copy
|
|
|
|
|
in the file LICENSE in the source distribution or at
|
|
|
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
|
|
|
|
|
|
=cut
|
