libs/smux/include/stg/per_decoder.h

   1 /*-
   2  * Copyright (c) 2005-2017 Lev Walkin <vlm@lionet.info>. All rights reserved.
   3  * Redistribution and modifications are permitted subject to BSD license.
   4  */
   5 #ifndef _PER_DECODER_H_
   6 #define _PER_DECODER_H_
   7
   8 #include <asn_application.h>
   9 #include <per_support.h>
  10
  11 #ifdef __cplusplus
  12 extern "C" {
  13 #endif
  14
  15 struct asn_TYPE_descriptor_s;   /* Forward declaration */
  16
  17 /*
  18  * Unaligned PER decoder of a "complete encoding" as per X.691 (08/2015) #11.1.
  19  * On success, this call always returns (.consumed >= 1), as per #11.1.3.
  20  */
  21 asn_dec_rval_t uper_decode_complete(
  22     const struct asn_codec_ctx_s *opt_codec_ctx,
  23     const struct asn_TYPE_descriptor_s *type_descriptor, /* Type to decode */
  24     void **struct_ptr,  /* Pointer to a target structure's pointer */
  25     const void *buffer, /* Data to be decoded */
  26     size_t size         /* Size of data buffer */
  27 );
  28
  29 /*
  30  * Unaligned PER decoder of any ASN.1 type. May be invoked by the application.
  31  * WARNING: This call returns the number of BITS read from the stream. Beware.
  32  */
  33 asn_dec_rval_t uper_decode(
  34     const struct asn_codec_ctx_s *opt_codec_ctx,
  35     const struct asn_TYPE_descriptor_s *type_descriptor, /* Type to decode */
  36     void **struct_ptr,  /* Pointer to a target structure's pointer */
  37     const void *buffer, /* Data to be decoded */
  38     size_t size,        /* Size of the input data buffer, in bytes */
  39     int skip_bits,      /* Number of unused leading bits, 0..7 */
  40     int unused_bits     /* Number of unused tailing bits, 0..7 */
  41 );
  42
  43
  44 /*
  45  * Type of the type-specific PER decoder function.
  46  */
  47 typedef asn_dec_rval_t(per_type_decoder_f)(
  48     const asn_codec_ctx_t *opt_codec_ctx,
  49     const struct asn_TYPE_descriptor_s *type_descriptor,
  50     const asn_per_constraints_t *constraints, void **struct_ptr,
  51     asn_per_data_t *per_data);
  52
  53 #ifdef __cplusplus
  54 }
  55 #endif
  56
  57 #endif  /* _PER_DECODER_H_ */