1109998Smarkm=pod 2109998Smarkm 3109998Smarkm=head1 NAME 4109998Smarkm 5109998SmarkmASN1_OBJECT_new, ASN1_OBJECT_free, - object allocation functions 6109998Smarkm 7109998Smarkm=head1 SYNOPSIS 8109998Smarkm 9215697Ssimon #include <openssl/asn1.h> 10215697Ssimon 11109998Smarkm ASN1_OBJECT *ASN1_OBJECT_new(void); 12109998Smarkm void ASN1_OBJECT_free(ASN1_OBJECT *a); 13109998Smarkm 14109998Smarkm=head1 DESCRIPTION 15109998Smarkm 16109998SmarkmThe ASN1_OBJECT allocation routines, allocate and free an 17109998SmarkmASN1_OBJECT structure, which represents an ASN1 OBJECT IDENTIFIER. 18109998Smarkm 19109998SmarkmASN1_OBJECT_new() allocates and initializes a ASN1_OBJECT structure. 20109998Smarkm 21109998SmarkmASN1_OBJECT_free() frees up the B<ASN1_OBJECT> structure B<a>. 22109998Smarkm 23109998Smarkm=head1 NOTES 24109998Smarkm 25109998SmarkmAlthough ASN1_OBJECT_new() allocates a new ASN1_OBJECT structure it 26109998Smarkmis almost never used in applications. The ASN1 object utility functions 27109998Smarkmsuch as OBJ_nid2obj() are used instead. 28109998Smarkm 29109998Smarkm=head1 RETURN VALUES 30109998Smarkm 31109998SmarkmIf the allocation fails, ASN1_OBJECT_new() returns B<NULL> and sets an error 32109998Smarkmcode that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>. 33109998SmarkmOtherwise it returns a pointer to the newly allocated structure. 34109998Smarkm 35109998SmarkmASN1_OBJECT_free() returns no value. 36109998Smarkm 37109998Smarkm=head1 SEE ALSO 38109998Smarkm 39109998SmarkmL<ERR_get_error(3)|ERR_get_error(3)>, L<d2i_ASN1_OBJECT(3)|d2i_ASN1_OBJECT(3)> 40109998Smarkm 41109998Smarkm=head1 HISTORY 42109998Smarkm 43109998SmarkmASN1_OBJECT_new() and ASN1_OBJECT_free() are available in all versions of SSLeay and OpenSSL. 44109998Smarkm 45109998Smarkm=cut 46