1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
/* cell_common.h -- generated by by Trunnel v1.5.1.
* https://gitweb.torproject.org/trunnel.git
* You probably shouldn't edit this file.
*/
#ifndef TRUNNEL_CELL_COMMON_H
#define TRUNNEL_CELL_COMMON_H
#include <stdint.h>
#include "trunnel.h"
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_CELL_EXTENSION_FIELDS)
struct cell_extension_fields_st {
uint8_t field_type;
uint8_t field_len;
TRUNNEL_DYNARRAY_HEAD(, uint8_t) field;
uint8_t trunnel_error_code_;
};
#endif
typedef struct cell_extension_fields_st cell_extension_fields_t;
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_CELL_EXTENSION)
struct cell_extension_st {
uint8_t num;
TRUNNEL_DYNARRAY_HEAD(, struct cell_extension_fields_st *) fields;
uint8_t trunnel_error_code_;
};
#endif
typedef struct cell_extension_st cell_extension_t;
/** Return a newly allocated cell_extension_fields with all elements
* set to zero.
*/
cell_extension_fields_t *cell_extension_fields_new(void);
/** Release all storage held by the cell_extension_fields in 'victim'.
* (Do nothing if 'victim' is NULL.)
*/
void cell_extension_fields_free(cell_extension_fields_t *victim);
/** Try to parse a cell_extension_fields from the buffer in 'input',
* using up to 'len_in' bytes from the input buffer. On success,
* return the number of bytes consumed and set *output to the newly
* allocated cell_extension_fields_t. On failure, return -2 if the
* input appears truncated, and -1 if the input is otherwise invalid.
*/
ssize_t cell_extension_fields_parse(cell_extension_fields_t **output, const uint8_t *input, const size_t len_in);
/** Return the number of bytes we expect to need to encode the
* cell_extension_fields in 'obj'. On failure, return a negative
* value. Note that this value may be an overestimate, and can even be
* an underestimate for certain unencodeable objects.
*/
ssize_t cell_extension_fields_encoded_len(const cell_extension_fields_t *obj);
/** Try to encode the cell_extension_fields from 'input' into the
* buffer at 'output', using up to 'avail' bytes of the output buffer.
* On success, return the number of bytes used. On failure, return -2
* if the buffer was not long enough, and -1 if the input was invalid.
*/
ssize_t cell_extension_fields_encode(uint8_t *output, size_t avail, const cell_extension_fields_t *input);
/** Check whether the internal state of the cell_extension_fields in
* 'obj' is consistent. Return NULL if it is, and a short message if
* it is not.
*/
const char *cell_extension_fields_check(const cell_extension_fields_t *obj);
/** Clear any errors that were set on the object 'obj' by its setter
* functions. Return true iff errors were cleared.
*/
int cell_extension_fields_clear_errors(cell_extension_fields_t *obj);
/** Return the value of the field_type field of the
* cell_extension_fields_t in 'inp'
*/
uint8_t cell_extension_fields_get_field_type(const cell_extension_fields_t *inp);
/** Set the value of the field_type field of the
* cell_extension_fields_t in 'inp' to 'val'. Return 0 on success;
* return -1 and set the error code on 'inp' on failure.
*/
int cell_extension_fields_set_field_type(cell_extension_fields_t *inp, uint8_t val);
/** Return the value of the field_len field of the
* cell_extension_fields_t in 'inp'
*/
uint8_t cell_extension_fields_get_field_len(const cell_extension_fields_t *inp);
/** Set the value of the field_len field of the
* cell_extension_fields_t in 'inp' to 'val'. Return 0 on success;
* return -1 and set the error code on 'inp' on failure.
*/
int cell_extension_fields_set_field_len(cell_extension_fields_t *inp, uint8_t val);
/** Return the length of the dynamic array holding the field field of
* the cell_extension_fields_t in 'inp'.
*/
size_t cell_extension_fields_getlen_field(const cell_extension_fields_t *inp);
/** Return the element at position 'idx' of the dynamic array field
* field of the cell_extension_fields_t in 'inp'.
*/
uint8_t cell_extension_fields_get_field(cell_extension_fields_t *inp, size_t idx);
/** As cell_extension_fields_get_field, but take and return a const
* pointer
*/
uint8_t cell_extension_fields_getconst_field(const cell_extension_fields_t *inp, size_t idx);
/** Change the element at position 'idx' of the dynamic array field
* field of the cell_extension_fields_t in 'inp', so that it will hold
* the value 'elt'.
*/
int cell_extension_fields_set_field(cell_extension_fields_t *inp, size_t idx, uint8_t elt);
/** Append a new element 'elt' to the dynamic array field field of the
* cell_extension_fields_t in 'inp'.
*/
int cell_extension_fields_add_field(cell_extension_fields_t *inp, uint8_t elt);
/** Return a pointer to the variable-length array field field of
* 'inp'.
*/
uint8_t * cell_extension_fields_getarray_field(cell_extension_fields_t *inp);
/** As cell_extension_fields_get_field, but take and return a const
* pointer
*/
const uint8_t * cell_extension_fields_getconstarray_field(const cell_extension_fields_t *inp);
/** Change the length of the variable-length array field field of
* 'inp' to 'newlen'.Fill extra elements with 0. Return 0 on success;
* return -1 and set the error code on 'inp' on failure.
*/
int cell_extension_fields_setlen_field(cell_extension_fields_t *inp, size_t newlen);
/** Return a newly allocated cell_extension with all elements set to
* zero.
*/
cell_extension_t *cell_extension_new(void);
/** Release all storage held by the cell_extension in 'victim'. (Do
* nothing if 'victim' is NULL.)
*/
void cell_extension_free(cell_extension_t *victim);
/** Try to parse a cell_extension from the buffer in 'input', using up
* to 'len_in' bytes from the input buffer. On success, return the
* number of bytes consumed and set *output to the newly allocated
* cell_extension_t. On failure, return -2 if the input appears
* truncated, and -1 if the input is otherwise invalid.
*/
ssize_t cell_extension_parse(cell_extension_t **output, const uint8_t *input, const size_t len_in);
/** Return the number of bytes we expect to need to encode the
* cell_extension in 'obj'. On failure, return a negative value. Note
* that this value may be an overestimate, and can even be an
* underestimate for certain unencodeable objects.
*/
ssize_t cell_extension_encoded_len(const cell_extension_t *obj);
/** Try to encode the cell_extension from 'input' into the buffer at
* 'output', using up to 'avail' bytes of the output buffer. On
* success, return the number of bytes used. On failure, return -2 if
* the buffer was not long enough, and -1 if the input was invalid.
*/
ssize_t cell_extension_encode(uint8_t *output, size_t avail, const cell_extension_t *input);
/** Check whether the internal state of the cell_extension in 'obj' is
* consistent. Return NULL if it is, and a short message if it is not.
*/
const char *cell_extension_check(const cell_extension_t *obj);
/** Clear any errors that were set on the object 'obj' by its setter
* functions. Return true iff errors were cleared.
*/
int cell_extension_clear_errors(cell_extension_t *obj);
/** Return the value of the num field of the cell_extension_t in 'inp'
*/
uint8_t cell_extension_get_num(const cell_extension_t *inp);
/** Set the value of the num field of the cell_extension_t in 'inp' to
* 'val'. Return 0 on success; return -1 and set the error code on
* 'inp' on failure.
*/
int cell_extension_set_num(cell_extension_t *inp, uint8_t val);
/** Return the length of the dynamic array holding the fields field of
* the cell_extension_t in 'inp'.
*/
size_t cell_extension_getlen_fields(const cell_extension_t *inp);
/** Return the element at position 'idx' of the dynamic array field
* fields of the cell_extension_t in 'inp'.
*/
struct cell_extension_fields_st * cell_extension_get_fields(cell_extension_t *inp, size_t idx);
/** As cell_extension_get_fields, but take and return a const pointer
*/
const struct cell_extension_fields_st * cell_extension_getconst_fields(const cell_extension_t *inp, size_t idx);
/** Change the element at position 'idx' of the dynamic array field
* fields of the cell_extension_t in 'inp', so that it will hold the
* value 'elt'. Free the previous value, if any.
*/
int cell_extension_set_fields(cell_extension_t *inp, size_t idx, struct cell_extension_fields_st * elt);
/** As cell_extension_set_fields, but does not free the previous
* value.
*/
int cell_extension_set0_fields(cell_extension_t *inp, size_t idx, struct cell_extension_fields_st * elt);
/** Append a new element 'elt' to the dynamic array field fields of
* the cell_extension_t in 'inp'.
*/
int cell_extension_add_fields(cell_extension_t *inp, struct cell_extension_fields_st * elt);
/** Return a pointer to the variable-length array field fields of
* 'inp'.
*/
struct cell_extension_fields_st * * cell_extension_getarray_fields(cell_extension_t *inp);
/** As cell_extension_get_fields, but take and return a const pointer
*/
const struct cell_extension_fields_st * const * cell_extension_getconstarray_fields(const cell_extension_t *inp);
/** Change the length of the variable-length array field fields of
* 'inp' to 'newlen'.Fill extra elements with NULL; free removed
* elements. Return 0 on success; return -1 and set the error code on
* 'inp' on failure.
*/
int cell_extension_setlen_fields(cell_extension_t *inp, size_t newlen);
#endif
|
