ASN.1 Interface SilcAsn1 SilcAsn1Struct SilcAsn1Options SilcAsn1Tag silc_asn1_alloc silc_asn1_free silc_asn1_init silc_asn1_uninit silc_asn1_encode silc_asn1_decode SILC_ASN1_OPTS SILC_ASN1_ANY SILC_ASN1_ANY_PRIMITIVE SILC_ASN1_SEQUENCE SILC_ASN1_SET SILC_ASN1_SEQUENCE_OF SILC_ASN1_SET_OF SILC_ASN1_CHOICE SILC_ASN1_BOOLEAN SILC_ASN1_INT SILC_ASN1_SHORT_INT SILC_ASN1_ENUM SILC_ASN1_BIT_STRING SILC_ASN1_NULL SILC_ASN1_OID SILC_ASN1_OCTET_STRING SILC_ASN1_UTF8_STRING SILC_ASN1_NUMERIC_STRING SILC_ASN1_PRINTABLE_STRING SILC_ASN1_TELETEX_STRING SILC_ASN1_IA5_STRING SILC_ASN1_VISIBLE_STRING SILC_ASN1_UNIVERSAL_STRING SILC_ASN1_BMP_STRING SILC_ASN1_UNRESTRICTED_STRING SILC_ASN1_GENERAL_STRING SILC_ASN1_UTC_TIME SILC_ASN1_GEN_TIME SILC_ASN1_END

silc_asn1_alloc

SYNOPSIS

    SilcAsn1 silc_asn1_alloc(SilcStack stack);

DESCRIPTION

Allocates and initializes ASN.1 encoder/decoder and returns SilcAsn1 context or NULL on error. This context can be used with both silc_asn1_encode and silc_asn1_decode functions. If `stack' is non-NULL all memory will be allocated from `stack'.

Usually SilcAsn1 is allocated when encoder or decoder is needed, however it is also possible to allocate long-lasting SilcAsn1 and use that every time ASN.1 routines are needed. Application could for example allocate one SilcAsn1 and use that for all ASN.1 encoding and decoding.

When this context is freed with silc_asn1_free all memory will be freed, and all encoded ASN.1 buffers becomes invalid. Also all data that is returned by silc_asn1_encode and silc_asn1_decode function becomes invalid, unless SILC_ASN1_ALLOC flag is used, in which case the memory is allocated from `stack' and the `stack' is consumed.