OLD | NEW |
1 /* Copyright (c) 2010 The Chromium OS Authors. All rights reserved. | 1 /* Copyright (c) 2010 The Chromium OS Authors. All rights reserved. |
2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
4 */ | 4 */ |
5 | 5 |
6 /* Helper functions/wrappers for memory allocations, manipulation and | 6 /* Helper functions/wrappers for memory allocations, manipulation and |
7 * comparison. | 7 * comparison. |
8 */ | 8 */ |
9 | 9 |
10 #ifndef VBOOT_FIRMWARE_LIB_UTILITY_H_ | 10 #ifndef VBOOT_FIRMWARE_LIB_UTILITY_H_ |
11 #define VBOOT_FIRMWARE_LIB_UTILITY_H_ | 11 #define VBOOT_FIRMWARE_LIB_UTILITY_H_ |
12 | 12 |
13 #include "sysincludes.h" | 13 #include "sysincludes.h" |
14 | 14 |
15 /* Track remaining data to be read in a buffer. */ | 15 /* Track remaining data to be read in a buffer. */ |
16 typedef struct MemcpyState { | 16 typedef struct MemcpyState { |
17 void* remaining_buf; | 17 uint8_t* remaining_buf; |
18 uint64_t remaining_len; /* Remaining length of the buffer. */ | 18 uint64_t remaining_len; /* Remaining length of the buffer. */ |
19 uint8_t overrun; /* Flag set to 1 when an overrun occurs. */ | 19 uint8_t overrun; /* Flag set to 1 when an overrun occurs. */ |
20 } MemcpyState; | 20 } MemcpyState; |
21 | 21 |
22 /* Skip [len] bytes only if there's enough data to skip according | 22 /* Skip [len] bytes only if there's enough data to skip according |
23 * to [state]. | 23 * to [state]. |
24 * On success, return a meaningless but non-NULL pointer and updates [state]. | 24 * On success, return a meaningless but non-NULL pointer and updates [state]. |
25 * On failure, return NULL, set remaining_len in state to -1. | 25 * On failure, return NULL, set remaining_len in state to -1. |
26 * | 26 * |
27 * Useful for iterating through a binary blob to populate a struct. After the | 27 * Useful for iterating through a binary blob to populate a struct. After the |
(...skipping 25 matching lines...) Expand all Loading... |
53 * a constant value. | 53 * a constant value. |
54 * On success, return a meaningless but non-NULL pointer and updates [state]. | 54 * On success, return a meaningless but non-NULL pointer and updates [state]. |
55 * On failure, return NULL, set remaining_len in state to -1. | 55 * On failure, return NULL, set remaining_len in state to -1. |
56 * | 56 * |
57 * After the first failure (buffer overrun), successive calls will always fail. | 57 * After the first failure (buffer overrun), successive calls will always fail. |
58 */ | 58 */ |
59 const void* StatefulMemset_r(MemcpyState* state, const uint8_t val, | 59 const void* StatefulMemset_r(MemcpyState* state, const uint8_t val, |
60 uint64_t len); | 60 uint64_t len); |
61 | 61 |
62 #endif /* VBOOT_FIRMWARE_LIB_UTILITY_H_ */ | 62 #endif /* VBOOT_FIRMWARE_LIB_UTILITY_H_ */ |
OLD | NEW |