#ifndef ASN1_H #define ASN1_H /* parser and formatter for ASN.1 DER encoding. * The parser can read BER encoding, too. */ #include enum asn1_tagclass { UNIVERSAL=(0<<6), APPLICATION=(1<<6), PRIVATE=(2<<6), CONTEXT_SPECIFIC=(3<<6) }; enum asn1_tagtype { PRIMITIVE=(0<<5), CONSTRUCTED=(1<<5) }; enum asn1_tag { BOOLEAN=1, INTEGER=2, BIT_STRING=3, OCTET_STRING=4, OBJECT_IDENTIFIER=6, ENUMERATED=10, SEQUENCE_OF=16, SET_OF=17, UTCTIME=23 }; /* write variable length integer in the encoding used in tag and oid */ size_t fmt_asn1tagint(char* dest,unsigned long val); /* write int in least amount of bytes, return number of bytes */ /* as used in ASN.1 tag */ size_t fmt_asn1tag(char* dest,enum asn1_tagclass tc,enum asn1_tagtype tt, unsigned long tag); /* write int in least amount of bytes, return number of bytes */ /* as used in ASN.1 length */ size_t fmt_asn1length(char* dest,size_t l); /* write int in least amount of bytes, return number of bytes */ /* as used in ASN.1 INTEGER. This only does the payload, not the tag * and length headers! */ size_t fmt_asn1intpayload(char* dest,unsigned long val); /* write int in least amount of bytes, return number of bytes */ /* as used in ASN.1 INTEGER. This only does the payload, not the tag * and length headers! */ size_t fmt_asn1sintpayload(char* dest,signed long val); /* write int in least amount of bytes, return number of bytes */ /* as used in ASN.1 INTEGER or ENUMERATED. */ size_t fmt_asn1int(char* dest,enum asn1_tagclass tc,enum asn1_tagtype tt, enum asn1_tag tag,unsigned long val); /* write int in least amount of bytes, return number of bytes */ /* as used in ASN.1 INTEGER or ENUMERATED. */ size_t fmt_asn1sint(char* dest,enum asn1_tagclass tc,enum asn1_tagtype tt, enum asn1_tag tag,signed long val); /* write any data type that does not require transformation in the least * amount of bytes, return number of bytes */ /* as used in ASN.1 OCTET STRING, SEQUENCE etc. */ /* does not wrote the payload itself, just the header! First construct * the sequence/octet string so you know the length, then use * fmt_asn1transparent to write the header before it */ size_t fmt_asn1transparent(char* dest,enum asn1_tagclass tc, enum asn1_tagtype tt,enum asn1_tag tag,size_t len); /* write string in least amount of bytes, return number of bytes */ /* as used in ASN.1 OCTET STRING. */ size_t fmt_asn1string(char* dest,enum asn1_tagclass tc,enum asn1_tagtype tt, enum asn1_tag tag,const char* c,size_t l); /* write ASN.1 OCTET STRING */ #define fmt_asn1OCTETSTRING(dest,c,l) fmt_asn1string(dest,UNIVERSAL,PRIMITIVE,OCTET_STRING,c,l) /* write ASN.1 INTEGER */ #define fmt_asn1INTEGER(dest,l) fmt_asn1int(dest,UNIVERSAL,PRIMITIVE,INTEGER,l) /* write ASN.1 BOOLEAN */ #define fmt_asn1BOOLEAN(dest,l) fmt_asn1int(dest,UNIVERSAL,PRIMITIVE,BOOLEAN,l) /* write ASN.1 ENUMERATED */ #define fmt_asn1ENUMERATED(dest,l) fmt_asn1int(dest,UNIVERSAL,PRIMITIVE,ENUMERATED,l) /* write ASN.1 SEQUENCE */ #define fmt_asn1SEQUENCE(dest,l) fmt_asn1transparent(dest,UNIVERSAL,CONSTRUCTED,SEQUENCE_OF,l) /* write ASN.1 SET */ #define fmt_asn1SET(dest,l) fmt_asn1transparent(dest,UNIVERSAL,CONSTRUCTED,SET_OF,l) size_t fmt_asn1OID(char* dest,const unsigned long* array,unsigned long len); /* conventions for the parser routines: * src points to the first byte to parse * max points to the first byte behind the buffer * the return value is the number of bytes parsed or 0 for parse error */ /* parse ASN.1 variable length integer as used in tag and oid */ size_t scan_asn1tagint(const char* src,const char* max,unsigned long* val); /* parse ASN.1 tag into a tag class, tag type and tag number */ size_t scan_asn1tag(const char* src,const char* max, enum asn1_tagclass* tc,enum asn1_tagtype* tt, unsigned long* tag); /* parse ASN.1 length */ size_t scan_asn1length(const char* src,const char* max,size_t* length); /* parse ASN.1 integer with tag and length */ size_t scan_asn1int(const char* src,const char* max, enum asn1_tagclass* tc,enum asn1_tagtype* tt, unsigned long* tag, long* val); /* parse raw integer (payload after tag and length); internal helper */ size_t scan_asn1rawint(const char* src,const char* max,size_t len,long* val); /* parse string with tag and length. * Points s to the first byte in the string, and writes the length of * the string to l. */ size_t scan_asn1string(const char* src,const char* max, enum asn1_tagclass* tc,enum asn1_tagtype* tt,unsigned long* tag, const char** s,size_t* l); /* the following expect a specific universal type and return a parse * error if the tag does not match that type */ size_t scan_asn1BOOLEAN(const char* src,const char* max,unsigned long* l); size_t scan_asn1INTEGER(const char* src,const char* max,signed long* l); size_t scan_asn1ENUMERATED(const char* src,const char* max,unsigned long* l); size_t scan_asn1STRING(const char* src,const char* max,const char** s,size_t* l); size_t scan_asn1BITSTRING(const char* src,const char* max,const char** s,size_t* l); size_t scan_asn1SEQUENCE(const char* src,const char* max,size_t* len); size_t scan_asn1SET(const char* src,const char* max,size_t* len); /* scan an ASN.1 OID and put the numbers into array. * Return numbers of bytes parsed or 0 on error. * Put at most arraylen longs into array; if the OID is longer, or if array is NULL, return real number in arraylen and return 0 * If 0 is returned and arraylen is also 0, there was a parse error */ size_t scan_asn1oid(const char* src,const char* max,unsigned long* array,unsigned long* arraylen); struct string { size_t l; const char* s; }; #endif