src/asn1c/per_decoder.h

   1 /*-
   2  * Copyright (c) 2005, 2007 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#10.1.
  19  * On success, this call always returns (.consumed >= 1), as per X.691#10.1.3.
  20  */
  21 asn_dec_rval_t uper_decode_complete(struct asn_codec_ctx_s *opt_codec_ctx,
  22         struct asn_TYPE_descriptor_s *type_descriptor,  /* Type to decode */
  23         void **struct_ptr,      /* Pointer to a target structure's pointer */
  24         const void *buffer,     /* Data to be decoded */
  25         size_t size             /* Size of data buffer */
  26         );
  27
  28 /*
  29  * Unaligned PER decoder of any ASN.1 type. May be invoked by the application.
  30  * WARNING: This call returns the number of BITS read from the stream. Beware.
  31  */
  32 asn_dec_rval_t uper_decode(struct asn_codec_ctx_s *opt_codec_ctx,
  33         struct asn_TYPE_descriptor_s *type_descriptor,  /* Type to decode */
  34         void **struct_ptr,      /* Pointer to a target structure's pointer */
  35         const void *buffer,     /* Data to be decoded */
  36         size_t size,            /* Size of data buffer */
  37         int skip_bits,          /* Number of unused leading bits, 0..7 */
  38         int unused_bits         /* Number of unused tailing bits, 0..7 */
  39         );
  40
  41
  42 /*
  43  * Type of the type-specific PER decoder function.
  44  */
  45 typedef asn_dec_rval_t (per_type_decoder_f)(asn_codec_ctx_t *opt_codec_ctx,
  46                 struct asn_TYPE_descriptor_s *type_descriptor,
  47                 asn_per_constraints_t *constraints,
  48                 void **struct_ptr,
  49                 asn_per_data_t *per_data
  50         );
  51
  52 #ifdef __cplusplus
  53 }
  54 #endif
  55
  56 #endif  /* _PER_DECODER_H_ */