Revert "Revert "and added files""
[bcm963xx.git] / userapps / opensource / openssl / doc / crypto / ASN1_STRING_new.pod
1 =pod
2
3 =head1 NAME
4
5 ASN1_STRING_new, ASN1_STRING_type_new, ASN1_STRING_free -
6 ASN1_STRING allocation functions
7
8 =head1 SYNOPSIS
9
10  ASN1_STRING * ASN1_STRING_new(void);
11  ASN1_STRING * ASN1_STRING_type_new(int type);
12  void ASN1_STRING_free(ASN1_STRING *a);
13
14 =head1 DESCRIPTION
15
16 ASN1_STRING_new() returns an allocated B<ASN1_STRING> structure. Its type
17 is undefined.
18
19 ASN1_STRING_type_new() returns an allocated B<ASN1_STRING> structure of
20 type B<type>.
21
22 ASN1_STRING_free() frees up B<a>.
23
24 =head1 NOTES
25
26 Other string types call the B<ASN1_STRING> functions. For example
27 ASN1_OCTET_STRING_new() calls ASN1_STRING_type(V_ASN1_OCTET_STRING).
28
29 =head1 RETURN VALUES
30
31 ASN1_STRING_new() and ASN1_STRING_type_new() return a valid
32 ASN1_STRING structure or B<NULL> if an error occurred.
33
34 ASN1_STRING_free() does not return a value.
35
36 =head1 SEE ALSO
37
38 L<ERR_get_error(3)|ERR_get_error(3)>
39
40 =head1 HISTORY
41
42 TBA
43
44 =cut