summaryrefslogtreecommitdiff
path: root/payloads/libpayload/include/boot_device.h
blob: a946545792b3419d4a479cc2854ddf6ab4426813 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/* SPDX-License-Identifier: BSD-3-Clause */

#ifndef _BOOT_DEVICE_H
#define _BOOT_DEVICE_H

#include <stddef.h>

/**
 * This is a boot device access function, which is used by libpayload to read data from
 * the flash memory (or other boot device). It has to be implemented by payloads that want
 * to use FMAP or libcbfs.
 *
 * @param buf The output buffer to which the data should be written to.
 * @param offset Absolute offset in bytes of the requested boot device memory area. Not aligned.
 * @param size Size in bytes of the requested boot device memory area. Not aligned.
 *
 * @returns Number of bytes returned to the buffer, or negative value on error. Typically should
 *          be equal to the `size`, and not aligned forcefully.
 */
ssize_t boot_device_read(void *buf, size_t offset, size_t size);

#endif /* _BOOT_DEVICE_H */