]>
Commit | Line | Data |
---|---|---|
064af421 | 1 | /* |
27aa8793 | 2 | * Copyright (c) 2008, 2009, 2010, 2011, 2012, 2013, 2016 Nicira, Inc. |
064af421 | 3 | * |
a14bc59f BP |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at: | |
064af421 | 7 | * |
a14bc59f BP |
8 | * http://www.apache.org/licenses/LICENSE-2.0 |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
064af421 BP |
15 | */ |
16 | ||
17 | #include <config.h> | |
64c96779 | 18 | #include "openvswitch/ofpbuf.h" |
064af421 BP |
19 | #include <stdlib.h> |
20 | #include <string.h> | |
3e8a2ad1 | 21 | #include "openvswitch/dynamic-string.h" |
8a9562d2 | 22 | #include "netdev-dpdk.h" |
064af421 BP |
23 | #include "util.h" |
24 | ||
d8a59e89 PS |
25 | static void |
26 | ofpbuf_init__(struct ofpbuf *b, size_t allocated, enum ofpbuf_source source) | |
27 | { | |
28 | b->allocated = allocated; | |
29 | b->source = source; | |
6fd6ed71 PS |
30 | b->header = NULL; |
31 | b->msg = NULL; | |
417e7e66 | 32 | ovs_list_poison(&b->list_node); |
d8a59e89 PS |
33 | } |
34 | ||
31ac1e59 | 35 | static void |
4ac6dbe6 | 36 | ofpbuf_use__(struct ofpbuf *b, void *base, size_t allocated, size_t size, |
31ac1e59 | 37 | enum ofpbuf_source source) |
064af421 | 38 | { |
6fd6ed71 PS |
39 | b->base = base; |
40 | b->data = base; | |
4ac6dbe6 | 41 | b->size = size; |
1f317cb5 | 42 | |
d8a59e89 | 43 | ofpbuf_init__(b, allocated, source); |
064af421 BP |
44 | } |
45 | ||
31ac1e59 BP |
46 | /* Initializes 'b' as an empty ofpbuf that contains the 'allocated' bytes of |
47 | * memory starting at 'base'. 'base' should be the first byte of a region | |
48 | * obtained from malloc(). It will be freed (with free()) if 'b' is resized or | |
49 | * freed. */ | |
662eba3a | 50 | static void |
31ac1e59 BP |
51 | ofpbuf_use(struct ofpbuf *b, void *base, size_t allocated) |
52 | { | |
4ac6dbe6 | 53 | ofpbuf_use__(b, base, allocated, 0, OFPBUF_MALLOC); |
31ac1e59 BP |
54 | } |
55 | ||
37e23720 AZ |
56 | /* Converts ds into ofpbuf 'b'. 'b' contains the 'ds->allocated' bytes of |
57 | * memory starting at 'ds->string'. 'ds' should not be modified any more. | |
58 | * The memory allocated for 'ds' will be freed (with free()) if 'b' is | |
59 | * resized or freed. */ | |
60 | void | |
61 | ofpbuf_use_ds(struct ofpbuf *b, const struct ds *ds) | |
62 | { | |
63 | ofpbuf_use__(b, ds->string, ds->allocated + 1, ds->length, OFPBUF_MALLOC); | |
64 | } | |
65 | ||
31ac1e59 BP |
66 | /* Initializes 'b' as an empty ofpbuf that contains the 'allocated' bytes of |
67 | * memory starting at 'base'. 'base' should point to a buffer on the stack. | |
cca408da BP |
68 | * (Nothing actually relies on 'base' being allocated on the stack. It could |
69 | * be static or malloc()'d memory. But stack space is the most common use | |
70 | * case.) | |
31ac1e59 BP |
71 | * |
72 | * 'base' should be appropriately aligned. Using an array of uint32_t or | |
73 | * uint64_t for the buffer is a reasonable way to ensure appropriate alignment | |
125638eb | 74 | * for 32- or 64-bit data. |
31ac1e59 | 75 | * |
cca408da BP |
76 | * An ofpbuf operation that requires reallocating data will assert-fail if this |
77 | * function was used to initialize it. Thus, one need not call ofpbuf_uninit() | |
78 | * on an ofpbuf initialized by this function (though doing so is harmless), | |
79 | * because it is guaranteed that 'b' does not own any heap-allocated memory. */ | |
31ac1e59 BP |
80 | void |
81 | ofpbuf_use_stack(struct ofpbuf *b, void *base, size_t allocated) | |
82 | { | |
4ac6dbe6 | 83 | ofpbuf_use__(b, base, allocated, 0, OFPBUF_STACK); |
31ac1e59 BP |
84 | } |
85 | ||
cca408da BP |
86 | /* Initializes 'b' as an empty ofpbuf that contains the 'allocated' bytes of |
87 | * memory starting at 'base'. 'base' should point to a buffer on the stack. | |
88 | * (Nothing actually relies on 'base' being allocated on the stack. It could | |
be9fa766 | 89 | * be static or malloc()'d memory. But stack space is the most common use |
cca408da BP |
90 | * case.) |
91 | * | |
92 | * 'base' should be appropriately aligned. Using an array of uint32_t or | |
93 | * uint64_t for the buffer is a reasonable way to ensure appropriate alignment | |
125638eb | 94 | * for 32- or 64-bit data. |
cca408da BP |
95 | * |
96 | * An ofpbuf operation that requires reallocating data will copy the provided | |
97 | * buffer into a malloc()'d buffer. Thus, it is wise to call ofpbuf_uninit() | |
98 | * on an ofpbuf initialized by this function, so that if it expanded into the | |
99 | * heap, that memory is freed. */ | |
100 | void | |
101 | ofpbuf_use_stub(struct ofpbuf *b, void *base, size_t allocated) | |
102 | { | |
4ac6dbe6 | 103 | ofpbuf_use__(b, base, allocated, 0, OFPBUF_STUB); |
cca408da BP |
104 | } |
105 | ||
0bc9407d BP |
106 | /* Initializes 'b' as an ofpbuf whose data starts at 'data' and continues for |
107 | * 'size' bytes. This is appropriate for an ofpbuf that will be used to | |
108 | * inspect existing data, without moving it around or reallocating it, and | |
31ac1e59 BP |
109 | * generally without modifying it at all. |
110 | * | |
111 | * An ofpbuf operation that requires reallocating data will assert-fail if this | |
112 | * function was used to initialize it. */ | |
0bc9407d BP |
113 | void |
114 | ofpbuf_use_const(struct ofpbuf *b, const void *data, size_t size) | |
115 | { | |
4ac6dbe6 | 116 | ofpbuf_use__(b, CONST_CAST(void *, data), size, size, OFPBUF_STACK); |
d8a59e89 PS |
117 | } |
118 | ||
064af421 BP |
119 | /* Initializes 'b' as an empty ofpbuf with an initial capacity of 'size' |
120 | * bytes. */ | |
121 | void | |
122 | ofpbuf_init(struct ofpbuf *b, size_t size) | |
123 | { | |
124 | ofpbuf_use(b, size ? xmalloc(size) : NULL, size); | |
125 | } | |
126 | ||
127 | /* Frees memory that 'b' points to. */ | |
128 | void | |
d295e8e9 | 129 | ofpbuf_uninit(struct ofpbuf *b) |
064af421 | 130 | { |
8a9562d2 PS |
131 | if (b) { |
132 | if (b->source == OFPBUF_MALLOC) { | |
6fd6ed71 | 133 | free(b->base); |
8a9562d2 | 134 | } |
064af421 BP |
135 | } |
136 | } | |
137 | ||
138 | /* Frees memory that 'b' points to and allocates a new ofpbuf */ | |
139 | void | |
140 | ofpbuf_reinit(struct ofpbuf *b, size_t size) | |
141 | { | |
142 | ofpbuf_uninit(b); | |
143 | ofpbuf_init(b, size); | |
144 | } | |
145 | ||
146 | /* Creates and returns a new ofpbuf with an initial capacity of 'size' | |
147 | * bytes. */ | |
148 | struct ofpbuf * | |
149 | ofpbuf_new(size_t size) | |
150 | { | |
151 | struct ofpbuf *b = xmalloc(sizeof *b); | |
152 | ofpbuf_init(b, size); | |
153 | return b; | |
154 | } | |
155 | ||
68efcbec BP |
156 | /* Creates and returns a new ofpbuf with an initial capacity of 'size + |
157 | * headroom' bytes, reserving the first 'headroom' bytes as headroom. */ | |
158 | struct ofpbuf * | |
159 | ofpbuf_new_with_headroom(size_t size, size_t headroom) | |
160 | { | |
161 | struct ofpbuf *b = ofpbuf_new(size + headroom); | |
162 | ofpbuf_reserve(b, headroom); | |
163 | return b; | |
164 | } | |
165 | ||
a46c577a | 166 | /* Creates and returns a new ofpbuf that initially contains a copy of the |
6fd6ed71 | 167 | * 'buffer->size' bytes of data starting at 'buffer->data' with no headroom or |
a46c577a | 168 | * tailroom. */ |
064af421 BP |
169 | struct ofpbuf * |
170 | ofpbuf_clone(const struct ofpbuf *buffer) | |
171 | { | |
6aa728e0 | 172 | return ofpbuf_clone_with_headroom(buffer, 0); |
064af421 BP |
173 | } |
174 | ||
68efcbec BP |
175 | /* Creates and returns a new ofpbuf whose data are copied from 'buffer'. The |
176 | * returned ofpbuf will additionally have 'headroom' bytes of headroom. */ | |
177 | struct ofpbuf * | |
742c06cc | 178 | ofpbuf_clone_with_headroom(const struct ofpbuf *b, size_t headroom) |
68efcbec | 179 | { |
6aa728e0 | 180 | struct ofpbuf *new_buffer; |
6aa728e0 | 181 | |
742c06cc JR |
182 | new_buffer = ofpbuf_clone_data_with_headroom(b->data, b->size, headroom); |
183 | if (b->header) { | |
184 | ptrdiff_t header_offset = (char *) b->header - (char *) b->data; | |
437d0d22 | 185 | |
742c06cc | 186 | new_buffer->header = (char *) new_buffer->data + header_offset; |
6aa728e0 | 187 | } |
aacaeb37 JR |
188 | if (b->msg) { |
189 | ptrdiff_t msg_offset = (char *) b->msg - (char *) b->data; | |
190 | ||
191 | new_buffer->msg = (char *) new_buffer->data + msg_offset; | |
192 | } | |
6aa728e0 EJ |
193 | |
194 | return new_buffer; | |
68efcbec BP |
195 | } |
196 | ||
a46c577a BP |
197 | /* Creates and returns a new ofpbuf that initially contains a copy of the |
198 | * 'size' bytes of data starting at 'data' with no headroom or tailroom. */ | |
064af421 BP |
199 | struct ofpbuf * |
200 | ofpbuf_clone_data(const void *data, size_t size) | |
201 | { | |
a46c577a BP |
202 | return ofpbuf_clone_data_with_headroom(data, size, 0); |
203 | } | |
204 | ||
205 | /* Creates and returns a new ofpbuf that initially contains 'headroom' bytes of | |
206 | * headroom followed by a copy of the 'size' bytes of data starting at | |
207 | * 'data'. */ | |
208 | struct ofpbuf * | |
209 | ofpbuf_clone_data_with_headroom(const void *data, size_t size, size_t headroom) | |
210 | { | |
211 | struct ofpbuf *b = ofpbuf_new_with_headroom(size, headroom); | |
064af421 BP |
212 | ofpbuf_put(b, data, size); |
213 | return b; | |
214 | } | |
215 | ||
1f5cbaa3 | 216 | static void |
0dce369b BP |
217 | ofpbuf_copy__(struct ofpbuf *b, uint8_t *new_base, |
218 | size_t new_headroom, size_t new_tailroom) | |
064af421 | 219 | { |
6fd6ed71 | 220 | const uint8_t *old_base = b->base; |
0dce369b BP |
221 | size_t old_headroom = ofpbuf_headroom(b); |
222 | size_t old_tailroom = ofpbuf_tailroom(b); | |
223 | size_t copy_headroom = MIN(old_headroom, new_headroom); | |
224 | size_t copy_tailroom = MIN(old_tailroom, new_tailroom); | |
225 | ||
226 | memcpy(&new_base[new_headroom - copy_headroom], | |
227 | &old_base[old_headroom - copy_headroom], | |
6fd6ed71 | 228 | copy_headroom + b->size + copy_tailroom); |
064af421 BP |
229 | } |
230 | ||
0dce369b BP |
231 | /* Reallocates 'b' so that it has exactly 'new_headroom' and 'new_tailroom' |
232 | * bytes of headroom and tailroom, respectively. */ | |
1f5cbaa3 | 233 | static void |
0dce369b | 234 | ofpbuf_resize__(struct ofpbuf *b, size_t new_headroom, size_t new_tailroom) |
1f5cbaa3 | 235 | { |
0dce369b | 236 | void *new_base, *new_data; |
31ac1e59 | 237 | size_t new_allocated; |
31ac1e59 | 238 | |
6fd6ed71 | 239 | new_allocated = new_headroom + b->size + new_tailroom; |
31ac1e59 BP |
240 | |
241 | switch (b->source) { | |
242 | case OFPBUF_MALLOC: | |
0dce369b | 243 | if (new_headroom == ofpbuf_headroom(b)) { |
6fd6ed71 | 244 | new_base = xrealloc(b->base, new_allocated); |
0dce369b BP |
245 | } else { |
246 | new_base = xmalloc(new_allocated); | |
247 | ofpbuf_copy__(b, new_base, new_headroom, new_tailroom); | |
6fd6ed71 | 248 | free(b->base); |
0dce369b | 249 | } |
31ac1e59 BP |
250 | break; |
251 | ||
252 | case OFPBUF_STACK: | |
428b2edd | 253 | OVS_NOT_REACHED(); |
31ac1e59 | 254 | |
cca408da BP |
255 | case OFPBUF_STUB: |
256 | b->source = OFPBUF_MALLOC; | |
257 | new_base = xmalloc(new_allocated); | |
258 | ofpbuf_copy__(b, new_base, new_headroom, new_tailroom); | |
259 | break; | |
260 | ||
31ac1e59 | 261 | default: |
428b2edd | 262 | OVS_NOT_REACHED(); |
31ac1e59 BP |
263 | } |
264 | ||
265 | b->allocated = new_allocated; | |
6fd6ed71 | 266 | b->base = new_base; |
0dce369b BP |
267 | |
268 | new_data = (char *) new_base + new_headroom; | |
6fd6ed71 PS |
269 | if (b->data != new_data) { |
270 | if (b->header) { | |
742c06cc | 271 | ptrdiff_t header_offset = (char *) b->header - (char *) b->data; |
437d0d22 | 272 | |
742c06cc | 273 | b->header = (char *) new_data + header_offset; |
38876d31 AW |
274 | } |
275 | if (b->msg) { | |
742c06cc | 276 | ptrdiff_t msg_offset = (char *) b->msg - (char *) b->data; |
38876d31 | 277 | |
742c06cc | 278 | b->msg = (char *) new_data + msg_offset; |
0dce369b | 279 | } |
6fd6ed71 | 280 | b->data = new_data; |
0dce369b | 281 | } |
1f5cbaa3 BP |
282 | } |
283 | ||
284 | /* Ensures that 'b' has room for at least 'size' bytes at its tail end, | |
285 | * reallocating and copying its data if necessary. Its headroom, if any, is | |
286 | * preserved. */ | |
287 | void | |
d295e8e9 | 288 | ofpbuf_prealloc_tailroom(struct ofpbuf *b, size_t size) |
1f5cbaa3 BP |
289 | { |
290 | if (size > ofpbuf_tailroom(b)) { | |
0dce369b | 291 | ofpbuf_resize__(b, ofpbuf_headroom(b), MAX(size, 64)); |
1f5cbaa3 BP |
292 | } |
293 | } | |
294 | ||
0dce369b BP |
295 | /* Ensures that 'b' has room for at least 'size' bytes at its head, |
296 | * reallocating and copying its data if necessary. Its tailroom, if any, is | |
297 | * preserved. */ | |
064af421 | 298 | void |
d295e8e9 | 299 | ofpbuf_prealloc_headroom(struct ofpbuf *b, size_t size) |
064af421 | 300 | { |
0dce369b BP |
301 | if (size > ofpbuf_headroom(b)) { |
302 | ofpbuf_resize__(b, MAX(size, 64), ofpbuf_tailroom(b)); | |
303 | } | |
064af421 BP |
304 | } |
305 | ||
8b6c2c88 WSH |
306 | /* Trims the size of 'b' to fit its actual content, reducing its headroom and |
307 | * tailroom to 0, if any. | |
31ac1e59 BP |
308 | * |
309 | * Buffers not obtained from malloc() are not resized, since that wouldn't save | |
38876d31 AW |
310 | * any memory. |
311 | * | |
312 | * Caller needs to updates 'b->header' and 'b->msg' so that they point to the | |
313 | * same locations in the data. (If they pointed into the tailroom or headroom | |
314 | * then they become invalid.) | |
315 | * | |
316 | */ | |
064af421 BP |
317 | void |
318 | ofpbuf_trim(struct ofpbuf *b) | |
319 | { | |
0dce369b BP |
320 | if (b->source == OFPBUF_MALLOC |
321 | && (ofpbuf_headroom(b) || ofpbuf_tailroom(b))) { | |
322 | ofpbuf_resize__(b, 0, 0); | |
064af421 BP |
323 | } |
324 | } | |
325 | ||
63f2140a BP |
326 | /* If 'b' is shorter than 'length' bytes, pads its tail out with zeros to that |
327 | * length. */ | |
328 | void | |
329 | ofpbuf_padto(struct ofpbuf *b, size_t length) | |
330 | { | |
6fd6ed71 PS |
331 | if (b->size < length) { |
332 | ofpbuf_put_zeros(b, length - b->size); | |
63f2140a BP |
333 | } |
334 | } | |
335 | ||
b2348f6d BP |
336 | /* Shifts all of the data within the allocated space in 'b' by 'delta' bytes. |
337 | * For example, a 'delta' of 1 would cause each byte of data to move one byte | |
338 | * forward (from address 'p' to 'p+1'), and a 'delta' of -1 would cause each | |
38876d31 AW |
339 | * byte to move one byte backward (from 'p' to 'p-1'). |
340 | * | |
341 | * If used, user must make sure the 'header' and 'msg' pointers are updated | |
342 | * after shifting. | |
343 | */ | |
b2348f6d BP |
344 | void |
345 | ofpbuf_shift(struct ofpbuf *b, int delta) | |
346 | { | |
347 | ovs_assert(delta > 0 ? delta <= ofpbuf_tailroom(b) | |
348 | : delta < 0 ? -delta <= ofpbuf_headroom(b) | |
349 | : true); | |
350 | ||
351 | if (delta != 0) { | |
6fd6ed71 PS |
352 | char *dst = (char *) b->data + delta; |
353 | memmove(dst, b->data, b->size); | |
354 | b->data = dst; | |
b2348f6d BP |
355 | } |
356 | } | |
357 | ||
064af421 BP |
358 | /* Appends 'size' bytes of data to the tail end of 'b', reallocating and |
359 | * copying its data if necessary. Returns a pointer to the first byte of the | |
360 | * new data, which is left uninitialized. */ | |
361 | void * | |
d295e8e9 | 362 | ofpbuf_put_uninit(struct ofpbuf *b, size_t size) |
064af421 BP |
363 | { |
364 | void *p; | |
365 | ofpbuf_prealloc_tailroom(b, size); | |
366 | p = ofpbuf_tail(b); | |
6fd6ed71 | 367 | b->size += size; |
064af421 BP |
368 | return p; |
369 | } | |
370 | ||
371 | /* Appends 'size' zeroed bytes to the tail end of 'b'. Data in 'b' is | |
372 | * reallocated and copied if necessary. Returns a pointer to the first byte of | |
373 | * the data's location in the ofpbuf. */ | |
374 | void * | |
375 | ofpbuf_put_zeros(struct ofpbuf *b, size_t size) | |
376 | { | |
377 | void *dst = ofpbuf_put_uninit(b, size); | |
316d0932 | 378 | nullable_memset(dst, 0, size); |
064af421 BP |
379 | return dst; |
380 | } | |
381 | ||
382 | /* Appends the 'size' bytes of data in 'p' to the tail end of 'b'. Data in 'b' | |
383 | * is reallocated and copied if necessary. Returns a pointer to the first | |
384 | * byte of the data's location in the ofpbuf. */ | |
385 | void * | |
d295e8e9 | 386 | ofpbuf_put(struct ofpbuf *b, const void *p, size_t size) |
064af421 BP |
387 | { |
388 | void *dst = ofpbuf_put_uninit(b, size); | |
389 | memcpy(dst, p, size); | |
390 | return dst; | |
391 | } | |
392 | ||
27aa8793 BP |
393 | /* Parses as many pairs of hex digits as possible (possibly separated by spaces |
394 | * or periods) from the beginning of 's', appending bytes for their values to | |
395 | * 'b'. Returns the first character of 's' that is not the first of a pair of | |
396 | * hex digits. If 'n' is nonnull, stores the number of bytes added to 'b' in | |
78090f63 BP |
397 | * '*n'. */ |
398 | char * | |
399 | ofpbuf_put_hex(struct ofpbuf *b, const char *s, size_t *n) | |
400 | { | |
6fd6ed71 | 401 | size_t initial_size = b->size; |
78090f63 BP |
402 | for (;;) { |
403 | uint8_t byte; | |
404 | bool ok; | |
405 | ||
27aa8793 | 406 | s += strspn(s, " .\t\r\n"); |
78090f63 BP |
407 | byte = hexits_value(s, 2, &ok); |
408 | if (!ok) { | |
409 | if (n) { | |
6fd6ed71 | 410 | *n = b->size - initial_size; |
78090f63 | 411 | } |
ebc56baa | 412 | return CONST_CAST(char *, s); |
78090f63 BP |
413 | } |
414 | ||
415 | ofpbuf_put(b, &byte, 1); | |
416 | s += 2; | |
417 | } | |
418 | } | |
419 | ||
064af421 BP |
420 | /* Reserves 'size' bytes of headroom so that they can be later allocated with |
421 | * ofpbuf_push_uninit() without reallocating the ofpbuf. */ | |
422 | void | |
d295e8e9 | 423 | ofpbuf_reserve(struct ofpbuf *b, size_t size) |
064af421 | 424 | { |
6fd6ed71 | 425 | ovs_assert(!b->size); |
064af421 | 426 | ofpbuf_prealloc_tailroom(b, size); |
6fd6ed71 | 427 | b->data = (char*)b->data + size; |
da546e07 JR |
428 | } |
429 | ||
0dce369b BP |
430 | /* Prefixes 'size' bytes to the head end of 'b', reallocating and copying its |
431 | * data if necessary. Returns a pointer to the first byte of the data's | |
432 | * location in the ofpbuf. The new data is left uninitialized. */ | |
064af421 | 433 | void * |
d295e8e9 | 434 | ofpbuf_push_uninit(struct ofpbuf *b, size_t size) |
064af421 BP |
435 | { |
436 | ofpbuf_prealloc_headroom(b, size); | |
6fd6ed71 PS |
437 | b->data = (char*)b->data - size; |
438 | b->size += size; | |
439 | return b->data; | |
064af421 BP |
440 | } |
441 | ||
0dce369b BP |
442 | /* Prefixes 'size' zeroed bytes to the head end of 'b', reallocating and |
443 | * copying its data if necessary. Returns a pointer to the first byte of the | |
444 | * data's location in the ofpbuf. */ | |
30f07f1a BP |
445 | void * |
446 | ofpbuf_push_zeros(struct ofpbuf *b, size_t size) | |
447 | { | |
448 | void *dst = ofpbuf_push_uninit(b, size); | |
449 | memset(dst, 0, size); | |
450 | return dst; | |
451 | } | |
452 | ||
0dce369b BP |
453 | /* Copies the 'size' bytes starting at 'p' to the head end of 'b', reallocating |
454 | * and copying its data if necessary. Returns a pointer to the first byte of | |
455 | * the data's location in the ofpbuf. */ | |
064af421 | 456 | void * |
d295e8e9 | 457 | ofpbuf_push(struct ofpbuf *b, const void *p, size_t size) |
064af421 BP |
458 | { |
459 | void *dst = ofpbuf_push_uninit(b, size); | |
460 | memcpy(dst, p, size); | |
461 | return dst; | |
462 | } | |
463 | ||
07e73e08 BP |
464 | /* Inserts the 'n' bytes of 'data' into 'b' starting at the given 'offset', |
465 | * moving data forward as necessary to make room. | |
466 | * | |
467 | * 'data' must not point inside 'b'. */ | |
468 | void | |
469 | ofpbuf_insert(struct ofpbuf *b, size_t offset, const void *data, size_t n) | |
470 | { | |
471 | if (offset < b->size) { | |
472 | ofpbuf_put_uninit(b, n); | |
473 | memmove((char *) b->data + offset + n, (char *) b->data + offset, | |
474 | b->size - offset); | |
475 | memcpy((char *) b->data + offset, data, n); | |
476 | } else { | |
477 | ovs_assert(offset == b->size); | |
478 | ofpbuf_put(b, data, n); | |
479 | } | |
480 | } | |
481 | ||
933369b1 BP |
482 | /* Returns the data in 'b' as a block of malloc()'d memory and frees the buffer |
483 | * within 'b'. (If 'b' itself was dynamically allocated, e.g. with | |
484 | * ofpbuf_new(), then it should still be freed with, e.g., ofpbuf_delete().) */ | |
485 | void * | |
486 | ofpbuf_steal_data(struct ofpbuf *b) | |
487 | { | |
488 | void *p; | |
20ebd771 | 489 | |
6fd6ed71 PS |
490 | if (b->source == OFPBUF_MALLOC && b->data == b->base) { |
491 | p = b->data; | |
933369b1 | 492 | } else { |
6fd6ed71 | 493 | p = xmemdup(b->data, b->size); |
933369b1 | 494 | if (b->source == OFPBUF_MALLOC) { |
6fd6ed71 | 495 | free(b->base); |
933369b1 BP |
496 | } |
497 | } | |
6fd6ed71 PS |
498 | b->base = NULL; |
499 | b->data = NULL; | |
38876d31 AW |
500 | b->header = NULL; |
501 | b->msg = NULL; | |
933369b1 BP |
502 | return p; |
503 | } | |
504 | ||
0ab8e15f BP |
505 | /* Returns a string that describes some of 'b''s metadata plus a hex dump of up |
506 | * to 'maxbytes' from the start of the buffer. */ | |
507 | char * | |
508 | ofpbuf_to_string(const struct ofpbuf *b, size_t maxbytes) | |
509 | { | |
510 | struct ds s; | |
511 | ||
512 | ds_init(&s); | |
437d0d22 | 513 | ds_put_format(&s, "size=%"PRIu32", allocated=%"PRIu32", head=%"PRIuSIZE", tail=%"PRIuSIZE"\n", |
6fd6ed71 | 514 | b->size, b->allocated, |
0ab8e15f | 515 | ofpbuf_headroom(b), ofpbuf_tailroom(b)); |
6fd6ed71 | 516 | ds_put_hex_dump(&s, b->data, MIN(b->size, maxbytes), 0, false); |
0ab8e15f BP |
517 | return ds_cstr(&s); |
518 | } | |
b3907fbc BP |
519 | |
520 | /* Removes each of the "struct ofpbuf"s on 'list' from the list and frees | |
521 | * them. */ | |
522 | void | |
ca6ba700 | 523 | ofpbuf_list_delete(struct ovs_list *list) |
b3907fbc | 524 | { |
5f03c983 | 525 | struct ofpbuf *b; |
b3907fbc | 526 | |
5f03c983 | 527 | LIST_FOR_EACH_POP (b, list_node, list) { |
b3907fbc BP |
528 | ofpbuf_delete(b); |
529 | } | |
530 | } |