xref: /onnv-gate/usr/src/common/openssl/doc/crypto/ASN1_STRING_new.pod (revision 2175:b0b2f052a486)
1*2175Sjp161948=pod
2*2175Sjp161948
3*2175Sjp161948=head1 NAME
4*2175Sjp161948
5*2175Sjp161948ASN1_STRING_new, ASN1_STRING_type_new, ASN1_STRING_free -
6*2175Sjp161948ASN1_STRING allocation functions
7*2175Sjp161948
8*2175Sjp161948=head1 SYNOPSIS
9*2175Sjp161948
10*2175Sjp161948 ASN1_STRING * ASN1_STRING_new(void);
11*2175Sjp161948 ASN1_STRING * ASN1_STRING_type_new(int type);
12*2175Sjp161948 void ASN1_STRING_free(ASN1_STRING *a);
13*2175Sjp161948
14*2175Sjp161948=head1 DESCRIPTION
15*2175Sjp161948
16*2175Sjp161948ASN1_STRING_new() returns an allocated B<ASN1_STRING> structure. Its type
17*2175Sjp161948is undefined.
18*2175Sjp161948
19*2175Sjp161948ASN1_STRING_type_new() returns an allocated B<ASN1_STRING> structure of
20*2175Sjp161948type B<type>.
21*2175Sjp161948
22*2175Sjp161948ASN1_STRING_free() frees up B<a>.
23*2175Sjp161948
24*2175Sjp161948=head1 NOTES
25*2175Sjp161948
26*2175Sjp161948Other string types call the B<ASN1_STRING> functions. For example
27*2175Sjp161948ASN1_OCTET_STRING_new() calls ASN1_STRING_type(V_ASN1_OCTET_STRING).
28*2175Sjp161948
29*2175Sjp161948=head1 RETURN VALUES
30*2175Sjp161948
31*2175Sjp161948ASN1_STRING_new() and ASN1_STRING_type_new() return a valid
32*2175Sjp161948ASN1_STRING structure or B<NULL> if an error occurred.
33*2175Sjp161948
34*2175Sjp161948ASN1_STRING_free() does not return a value.
35*2175Sjp161948
36*2175Sjp161948=head1 SEE ALSO
37*2175Sjp161948
38*2175Sjp161948L<ERR_get_error(3)|ERR_get_error(3)>
39*2175Sjp161948
40*2175Sjp161948=head1 HISTORY
41*2175Sjp161948
42*2175Sjp161948TBA
43*2175Sjp161948
44*2175Sjp161948=cut
45