3 * Copyright (c) 2004-2017 Lev Walkin <vlm@lionet.info>. All rights reserved.
4 * Redistribution and modifications are permitted subject to BSD license.
6 #ifndef ASN1_CONSTRAINTS_VALIDATOR_H
7 #define ASN1_CONSTRAINTS_VALIDATOR_H
9 #include <asn_system.h> /* Platform-dependent types */
15 struct asn_TYPE_descriptor_s; /* Forward declaration */
18 * Validate the structure according to the ASN.1 constraints.
19 * If errbuf and errlen are given, they shall be pointing to the appropriate
20 * buffer space and its length before calling this function. Alternatively,
21 * they could be passed as NULL's. If constraints validation fails,
22 * errlen will contain the actual number of bytes taken from the errbuf
23 * to encode an error message (properly 0-terminated).
26 * This function returns 0 in case all ASN.1 constraints are met
27 * and -1 if one or more constraints were failed.
29 int asn_check_constraints(
30 const struct asn_TYPE_descriptor_s *type_descriptor,
31 const void *struct_ptr, /* Target language's structure */
32 char *errbuf, /* Returned error description */
33 size_t *errlen /* Length of the error description */
38 * Generic type for constraint checking callback,
39 * associated with every type descriptor.
41 typedef int(asn_constr_check_f)(
42 const struct asn_TYPE_descriptor_s *type_descriptor, const void *struct_ptr,
43 asn_app_constraint_failed_f *optional_callback, /* Log the error */
44 void *optional_app_key /* Opaque key passed to a callback */
47 /*******************************
48 * INTERNALLY USEFUL FUNCTIONS *
49 *******************************/
51 asn_constr_check_f asn_generic_no_constraint; /* No constraint whatsoever */
52 asn_constr_check_f asn_generic_unknown_constraint; /* Not fully supported */
55 * Invoke the callback with a complete error message.
57 #define ASN__CTFAIL if(ctfailcb) ctfailcb
63 #endif /* ASN1_CONSTRAINTS_VALIDATOR_H */