153 lines
4.7 KiB
C
153 lines
4.7 KiB
C
/*
|
|
* Copyright (c) 2005-2014 Lev Walkin <vlm@lionet.info>.
|
|
* All rights reserved.
|
|
* Redistribution and modifications are permitted subject to BSD license.
|
|
*/
|
|
#ifndef _PER_SUPPORT_H_
|
|
#define _PER_SUPPORT_H_
|
|
|
|
#include <asn_system.h> /* Platform-specific types */
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* Pre-computed PER constraints.
|
|
*/
|
|
typedef const struct asn_per_constraint_s {
|
|
enum asn_per_constraint_flags {
|
|
APC_UNCONSTRAINED = 0x0, /* No PER visible constraints */
|
|
APC_SEMI_CONSTRAINED = 0x1, /* Constrained at "lb" */
|
|
APC_CONSTRAINED = 0x2, /* Fully constrained */
|
|
APC_EXTENSIBLE = 0x4 /* May have extension */
|
|
} flags;
|
|
int range_bits; /* Full number of bits in the range */
|
|
int effective_bits; /* Effective bits */
|
|
int64_t lower_bound; /* "lb" value */
|
|
int64_t upper_bound; /* "ub" value */
|
|
} asn_per_constraint_t;
|
|
typedef const struct asn_per_constraints_s {
|
|
struct asn_per_constraint_s value;
|
|
struct asn_per_constraint_s size;
|
|
int (*value2code)(unsigned int value);
|
|
int (*code2value)(unsigned int code);
|
|
} asn_per_constraints_t;
|
|
|
|
/*
|
|
* This structure describes a position inside an incoming PER bit stream.
|
|
*/
|
|
typedef struct asn_per_data_s {
|
|
const uint8_t *buffer; /* Pointer to the octet stream */
|
|
size_t nboff; /* Bit offset to the meaningful bit */
|
|
size_t nbits; /* Number of bits in the stream */
|
|
size_t moved; /* Number of bits moved through this bit stream */
|
|
int (*refill)(struct asn_per_data_s *);
|
|
void *refill_key;
|
|
} asn_per_data_t;
|
|
|
|
/*
|
|
* Extract a small number of bits (<= 31) from the specified PER data pointer.
|
|
* This function returns -1 if the specified number of bits could not be
|
|
* extracted due to EOD or other conditions.
|
|
*/
|
|
int32_t per_get_few_bits(asn_per_data_t *per_data, int get_nbits);
|
|
|
|
/* Undo the immediately preceeding "get_few_bits" operation */
|
|
void per_get_undo(asn_per_data_t *per_data, int get_nbits);
|
|
|
|
/*
|
|
* Extract a large number of bits from the specified PER data pointer.
|
|
* This function returns -1 if the specified number of bits could not be
|
|
* extracted due to EOD or other conditions.
|
|
*/
|
|
int per_get_many_bits(asn_per_data_t *pd, uint8_t *dst, int right_align,
|
|
int get_nbits);
|
|
|
|
/*
|
|
* Get the length "n" from the Unaligned PER stream.
|
|
*/
|
|
ssize_t uper_get_length(asn_per_data_t *pd,
|
|
int effective_bound_bits,
|
|
int *repeat);
|
|
|
|
ssize_t aper_get_length(asn_per_data_t *pd,
|
|
int range,
|
|
int effective_bound_bits,
|
|
int *repeat);
|
|
|
|
/*
|
|
* Get the normally small length "n".
|
|
*/
|
|
ssize_t uper_get_nslength(asn_per_data_t *pd);
|
|
ssize_t aper_get_nslength(asn_per_data_t *pd);
|
|
|
|
/*
|
|
* Get the normally small non-negative whole number.
|
|
*/
|
|
ssize_t uper_get_nsnnwn(asn_per_data_t *pd);
|
|
ssize_t aper_get_nsnnwn(asn_per_data_t *pd, int range);
|
|
|
|
/* X.691-2008/11, #11.5.6 */
|
|
int uper_get_constrained_whole_number(asn_per_data_t *pd, unsigned long *v, int nbits);
|
|
|
|
/* Non-thread-safe debugging function, don't use it */
|
|
char *per_data_string(asn_per_data_t *pd);
|
|
|
|
/*
|
|
* This structure supports forming PER output.
|
|
*/
|
|
typedef struct asn_per_outp_s {
|
|
uint8_t *buffer; /* Pointer into the (tmpspace) */
|
|
size_t nboff; /* Bit offset to the meaningful bit */
|
|
size_t nbits; /* Number of bits left in (tmpspace) */
|
|
uint8_t tmpspace[32]; /* Preliminary storage to hold data */
|
|
int (*outper)(const void *data, size_t size, void *op_key);
|
|
void *op_key; /* Key for (outper) data callback */
|
|
size_t flushed_bytes; /* Bytes already flushed through (outper) */
|
|
} asn_per_outp_t;
|
|
|
|
/* Output a small number of bits (<= 31) */
|
|
int per_put_few_bits(asn_per_outp_t *per_data, uint32_t bits, int obits);
|
|
|
|
/* Output a large number of bits */
|
|
int per_put_many_bits(asn_per_outp_t *po, const uint8_t *src, int put_nbits);
|
|
|
|
/* X.691-2008/11, #11.5 */
|
|
int uper_put_constrained_whole_number_s(asn_per_outp_t *po, long v, int nbits);
|
|
int uper_put_constrained_whole_number_u(asn_per_outp_t *po, unsigned long v, int nbits);
|
|
|
|
/* Align the current bit position to octet bundary */
|
|
int aper_put_align(asn_per_outp_t *po);
|
|
int32_t aper_get_align(asn_per_data_t *pd);
|
|
|
|
/*
|
|
* Put the length "n" to the Unaligned PER stream.
|
|
* This function returns the number of units which may be flushed
|
|
* in the next units saving iteration.
|
|
*/
|
|
ssize_t uper_put_length(asn_per_outp_t *po, size_t whole_length);
|
|
|
|
ssize_t aper_put_length(asn_per_outp_t *po, int range, size_t length);
|
|
|
|
/*
|
|
* Put the normally small length "n" to the Unaligned PER stream.
|
|
* Returns 0 or -1.
|
|
*/
|
|
int uper_put_nslength(asn_per_outp_t *po, size_t length);
|
|
|
|
int aper_put_nslength(asn_per_outp_t *po, size_t length);
|
|
|
|
/*
|
|
* Put the normally small non-negative whole number.
|
|
*/
|
|
int uper_put_nsnnwn(asn_per_outp_t *po, int n);
|
|
|
|
int aper_put_nsnnwn(asn_per_outp_t *po, int range, int number);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _PER_SUPPORT_H_ */
|