OCTET_STRING.h

Go to the documentation of this file.

/*-
 * Copyright (c) 2003-2017 Lev Walkin <vlm@lionet.info>. All rights reserved.
 * Redistribution and modifications are permitted subject to BSD license.
 */
#ifndef _OCTET_STRING_H_
#define _OCTET_STRING_H_
 
#include <etsi_its_cpm_ts_coding/asn_application.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct OCTET_STRING {
        uint8_t *buf;   /* Buffer with consecutive OCTET_STRING bits */
        size_t size;    /* Size of the buffer */
 
        asn_struct_ctx_t _asn_ctx;      /* Parsing across buffer boundaries */
} OCTET_STRING_t;
 
extern asn_TYPE_descriptor_t asn_DEF_OCTET_STRING;
extern asn_TYPE_operation_t asn_OP_OCTET_STRING;
 
asn_struct_free_f OCTET_STRING_free;
 
#if !defined(ASN_DISABLE_PRINT_SUPPORT)
asn_struct_print_f OCTET_STRING_print;
asn_struct_print_f OCTET_STRING_print_utf8;
#endif  /* !defined(ASN_DISABLE_PRINT_SUPPORT) */
 
asn_struct_compare_f OCTET_STRING_compare;
asn_struct_copy_f    OCTET_STRING_copy;
 
#define OCTET_STRING_constraint asn_generic_no_constraint
 
#if !defined(ASN_DISABLE_BER_SUPPORT)
ber_type_decoder_f OCTET_STRING_decode_ber;
der_type_encoder_f OCTET_STRING_encode_der;
#endif  /* !defined(ASN_DISABLE_BER_SUPPORT) */
 
#if !defined(ASN_DISABLE_XER_SUPPORT)
xer_type_decoder_f OCTET_STRING_decode_xer_hex;     /* Hexadecimal */
xer_type_decoder_f OCTET_STRING_decode_xer_binary;  /* 01010111010 */
xer_type_decoder_f OCTET_STRING_decode_xer_utf8;    /* ASCII/UTF-8 */
xer_type_encoder_f OCTET_STRING_encode_xer;
xer_type_encoder_f OCTET_STRING_encode_xer_utf8;
#endif  /* !defined(ASN_DISABLE_XER_SUPPORT) */
 
#if !defined(ASN_DISABLE_JER_SUPPORT)
jer_type_decoder_f OCTET_STRING_decode_jer_hex;     /* Hexadecimal */
jer_type_decoder_f OCTET_STRING_decode_jer_utf8;    /* ASCII/UTF-8 */
jer_type_encoder_f OCTET_STRING_encode_jer;
jer_type_encoder_f OCTET_STRING_encode_jer_utf8;
#endif  /* !defined(ASN_DISABLE_JER_SUPPORT) */
 
#if !defined(ASN_DISABLE_OER_SUPPORT)
oer_type_decoder_f OCTET_STRING_decode_oer;
oer_type_encoder_f OCTET_STRING_encode_oer;
#endif  /* !defined(ASN_DISABLE_OER_SUPPORT) */
 
#if !defined(ASN_DISABLE_UPER_SUPPORT)
per_type_decoder_f OCTET_STRING_decode_uper;
per_type_encoder_f OCTET_STRING_encode_uper;
#endif  /* !defined(ASN_DISABLE_UPER_SUPPORT) */
#if !defined(ASN_DISABLE_APER_SUPPORT)
per_type_decoder_f OCTET_STRING_decode_aper;
per_type_encoder_f OCTET_STRING_encode_aper;
#endif  /* !defined(ASN_DISABLE_APER_SUPPORT) */
 
#if !defined(ASN_DISABLE_RFILL_SUPPORT)
asn_random_fill_f  OCTET_STRING_random_fill;
#endif  /* !defined(ASN_DISABLE_RFILL_SUPPORT) */
 
#if !defined(ASN_DISABLE_UPER_SUPPORT) || !defined(ASN_DISABLE_APER_SUPPORT)
int OCTET_STRING_per_get_characters(
        asn_per_data_t *po,
        uint8_t *buf,
        size_t units,
        unsigned int bpc,
        unsigned int unit_bits,
        long lb,
        long ub,
        const asn_per_constraints_t *pc);
 
int OCTET_STRING_per_put_characters(
        asn_per_outp_t *po,
        const uint8_t *buf,
        size_t units,
        unsigned int bpc,
        unsigned int unit_bits,
        long lb,
        long ub,
        const asn_per_constraints_t *pc);
#endif  /* !defined(ASN_DISABLE_UPER_SUPPORT) || !defined(ASN_DISABLE_APER_SUPPORT) */
/******************************
 * Handy conversion routines. *
 ******************************/
 
/*
 * This function clears the previous value of the OCTET STRING (if any)
 * and then allocates a new memory with the specified content (str/size).
 * If size = -1, the size of the original string will be determined
 * using strlen(str).
 * If str equals to NULL, the function will silently clear the
 * current contents of the OCTET STRING.
 * Returns 0 if it was possible to perform operation, -1 otherwise.
 */
int OCTET_STRING_fromBuf(OCTET_STRING_t *s, const char *str, int size);
 
/* Handy conversion from the C string into the OCTET STRING. */
#define OCTET_STRING_fromString(s, str) OCTET_STRING_fromBuf(s, str, -1)
 
/*
 * Allocate and fill the new OCTET STRING and return a pointer to the newly
 * allocated object. NULL is permitted in str: the function will just allocate
 * empty OCTET STRING.
 */
OCTET_STRING_t *OCTET_STRING_new_fromBuf(const asn_TYPE_descriptor_t *td,
                                         const char *str, int size);
 
/****************************
 * Internally useful stuff. *
 ****************************/
 
typedef struct asn_OCTET_STRING_specifics_s {
    /*
     * Target structure description.
     */
    unsigned struct_size;   /* Size of the structure */
    unsigned ctx_offset;    /* Offset of the asn_struct_ctx_t member */
 
    enum asn_OS_Subvariant {
        ASN_OSUBV_ANY, /* The open type (ANY) */
        ASN_OSUBV_BIT, /* BIT STRING */
        ASN_OSUBV_STR, /* String types, not {BMP,Universal}String  */
        ASN_OSUBV_U16, /* 16-bit character (BMPString) */
        ASN_OSUBV_U32  /* 32-bit character (UniversalString) */
    } subvariant;
} asn_OCTET_STRING_specifics_t;
 
extern asn_OCTET_STRING_specifics_t asn_SPC_OCTET_STRING_specs;
 
size_t OCTET_STRING_random_length_constrained(
    const asn_TYPE_descriptor_t *, const asn_encoding_constraints_t *,
    size_t max_length);
 
#if !defined(ASN_DISABLE_BER_SUPPORT)
struct _stack_el {
    ber_tlv_len_t left;   /* What's left to read (or -1) */
    ber_tlv_len_t got;    /* What was actually processed */
    unsigned cont_level;  /* Depth of subcontainment */
    int want_nulls;       /* Want null "end of content" octets? */
    int bits_chopped;     /* Flag in BIT STRING mode */
    ber_tlv_tag_t tag;    /* For debugging purposes */
    struct _stack_el *prev;
    struct _stack_el *next;
};
struct _stack {
    struct _stack_el *tail;
    struct _stack_el *cur_ptr;
};
#endif  /* !defined(ASN_DISABLE_BER_SUPPORT) */
 
#ifdef __cplusplus
}
#endif
 
#endif  /* _OCTET_STRING_H_ */