2 * Copyright (c) 2017 Lev Walkin <vlm@lionet.info>. All rights reserved.
\r
3 * Redistribution and modifications are permitted subject to BSD license.
\r
5 #ifndef ASN_RANDOM_FILL
\r
6 #define ASN_RANDOM_FILL
\r
8 /* Forward declarations */
\r
9 struct asn_TYPE_descriptor_s;
\r
10 struct asn_encoding_constraints_s;
\r
13 * Initialize a structure with random data according to the type specification
\r
14 * and optional member constraints.
\r
16 * (max_length) - See (approx_max_length_limit).
\r
17 * (memb_constraints) - Member constraints, if exist.
\r
18 * The type can be constrained differently according
\r
19 * to PER and OER specifications, so we find a value
\r
20 * at the intersection of these constraints.
\r
21 * In case the return differs from ARFILL_OK, the (struct_ptr) contents
\r
22 * and (current_length) value remain in their original state.
\r
24 typedef struct asn_random_fill_result_s {
\r
26 ARFILL_FAILED = -1, /* System error (memory?) */
\r
27 ARFILL_OK = 0, /* Initialization succeeded */
\r
28 ARFILL_SKIPPED = 1 /* Not done due to (length?) constraint */
\r
30 size_t length; /* Approximate number of bytes created. */
\r
31 } asn_random_fill_result_t;
\r
32 typedef asn_random_fill_result_t(asn_random_fill_f)(
\r
33 const struct asn_TYPE_descriptor_s *td, void **struct_ptr,
\r
34 const struct asn_encoding_constraints_s *memb_constraints,
\r
38 * Returns 0 if the structure was properly initialized, -1 otherwise.
\r
39 * The (approx_max_length_limit) specifies the approximate limit of the
\r
40 * resulting structure in units closely resembling bytes. The actual result
\r
41 * might be several times larger or smaller than the length limit.
\r
43 int asn_random_fill(const struct asn_TYPE_descriptor_s *td, void **struct_ptr,
\r
44 size_t approx_max_length_limit);
\r
47 * Returns a random number between min and max.
\r
49 intmax_t asn_random_between(intmax_t min, intmax_t max);
\r
51 #endif /* ASN_RANDOM_FILL */
\r