]> git.stg.codes - stg.git/blob - libs/smux/include/stg/constraints.h
5032345ee475564eeea0240bf73d76ae41139f6f
[stg.git] / libs / smux / include / stg / constraints.h
1 /*-
2  * Copyright (c) 2004, 2006 Lev Walkin <vlm@lionet.info>. All rights reserved.
3  * Redistribution and modifications are permitted subject to BSD license.
4  */
5 #ifndef _ASN1_CONSTRAINTS_VALIDATOR_H_
6 #define _ASN1_CONSTRAINTS_VALIDATOR_H_
7
8 #include <asn_system.h>         /* Platform-dependent types */
9
10 #ifdef __cplusplus
11 extern "C" {
12 #endif
13
14 struct asn_TYPE_descriptor_s;           /* Forward declaration */
15
16 /*
17  * Validate the structure according to the ASN.1 constraints.
18  * If errbuf and errlen are given, they shall be pointing to the appropriate
19  * buffer space and its length before calling this function. Alternatively,
20  * they could be passed as NULL's. If constraints validation fails,
21  * errlen will contain the actual number of bytes taken from the errbuf
22  * to encode an error message (properly 0-terminated).
23  * 
24  * RETURN VALUES:
25  * This function returns 0 in case all ASN.1 constraints are met
26  * and -1 if one or more constraints were failed.
27  */
28 int
29 asn_check_constraints(struct asn_TYPE_descriptor_s *type_descriptor,
30         const void *struct_ptr, /* Target language's structure */
31         char *errbuf,           /* Returned error description */
32         size_t *errlen          /* Length of the error description */
33         );
34
35
36 /*
37  * Generic type for constraint checking callback,
38  * associated with every type descriptor.
39  */
40 typedef int (asn_constr_check_f)(
41         struct asn_TYPE_descriptor_s *type_descriptor,
42         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 */
45         );
46
47 /*******************************
48  * INTERNALLY USEFUL FUNCTIONS *
49  *******************************/
50
51 asn_constr_check_f asn_generic_no_constraint;   /* No constraint whatsoever */
52 asn_constr_check_f asn_generic_unknown_constraint; /* Not fully supported */
53
54 /*
55  * Invoke the callback with a complete error message.
56  */
57 #define _ASN_CTFAIL     if(ctfailcb) ctfailcb
58
59 #ifdef __cplusplus
60 }
61 #endif
62
63 #endif  /* _ASN1_CONSTRAINTS_VALIDATOR_H_ */