mirror of
https://review.coreboot.org/flashrom.git
synced 2025-04-28 07:23:43 +02:00
016b5abc83
off_t is a special POSIX type that is used to represent file offsets in certain APIs (e.g. lseek(), mmap()), and should not be reused to represent anything else (such as flash offsets). In particular, the width of the type may change based on the definition of the _FILE_OFFSET_BITS macro. Using such a type at the libflashrom interface is particularly dangerous, because if a program is built with a different _FILE_OFFSET_BITS value than libflashrom, the resulting ABI corruption will cause very very nasty and confusing bugs. This patch replaces all instances of off_t that are not related to file offsets with (s)size_t. BUG=b:219811851 TEST=`elogtool list` on cherry. Signed-off-by: Julius Werner <jwerner@chromium.org> Change-Id: I68a386973f79ea634f63dfcd7d95a63400e1fdee Reviewed-on: https://review.coreboot.org/c/flashrom/+/61943 Reviewed-by: Nico Huber <nico.h@gmx.de> Reviewed-by: Angel Pons <th3fanbus@gmail.com> Reviewed-by: Edward O'Callaghan <quasisec@chromium.org> Reviewed-by: Nikolai Artemiev <nartemiev@google.com> Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
123 lines
4.3 KiB
C
123 lines
4.3 KiB
C
/*
|
|
* This file is part of the flashrom project.
|
|
*
|
|
* Copyright (C) 2012 secunet Security Networks AG
|
|
* (Written by Nico Huber <nico.huber@secunet.com> for secunet)
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
|
|
#ifndef __LIBFLASHROM_H__
|
|
#define __LIBFLASHROM_H__ 1
|
|
|
|
#include <sys/types.h>
|
|
#include <stddef.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stdarg.h>
|
|
|
|
int flashrom_init(int perform_selfcheck);
|
|
int flashrom_shutdown(void);
|
|
/** @ingroup flashrom-general */
|
|
enum flashrom_log_level {
|
|
FLASHROM_MSG_ERROR = 0,
|
|
FLASHROM_MSG_WARN = 1,
|
|
FLASHROM_MSG_INFO = 2,
|
|
FLASHROM_MSG_DEBUG = 3,
|
|
FLASHROM_MSG_DEBUG2 = 4,
|
|
FLASHROM_MSG_SPEW = 5,
|
|
};
|
|
/** @ingroup flashrom-general */
|
|
typedef int(flashrom_log_callback)(enum flashrom_log_level, const char *format, va_list);
|
|
void flashrom_set_log_callback(flashrom_log_callback *);
|
|
|
|
/** @ingroup flashrom-query */
|
|
enum flashrom_test_state {
|
|
FLASHROM_TESTED_OK = 0,
|
|
FLASHROM_TESTED_NT = 1,
|
|
FLASHROM_TESTED_BAD = 2,
|
|
FLASHROM_TESTED_DEP = 3,
|
|
FLASHROM_TESTED_NA = 4,
|
|
};
|
|
|
|
struct flashrom_flashchip_info {
|
|
const char *vendor;
|
|
const char *name;
|
|
unsigned int total_size;
|
|
struct flashrom_tested {
|
|
enum flashrom_test_state probe;
|
|
enum flashrom_test_state read;
|
|
enum flashrom_test_state erase;
|
|
enum flashrom_test_state write;
|
|
} tested;
|
|
};
|
|
|
|
struct flashrom_board_info {
|
|
const char *vendor;
|
|
const char *name;
|
|
enum flashrom_test_state working;
|
|
};
|
|
|
|
struct flashrom_chipset_info {
|
|
const char *vendor;
|
|
const char *chipset;
|
|
uint16_t vendor_id;
|
|
uint16_t chipset_id;
|
|
enum flashrom_test_state status;
|
|
};
|
|
|
|
const char *flashrom_version_info(void);
|
|
struct flashrom_flashchip_info *flashrom_supported_flash_chips(void);
|
|
struct flashrom_board_info *flashrom_supported_boards(void);
|
|
struct flashrom_chipset_info *flashrom_supported_chipsets(void);
|
|
int flashrom_data_free(void *const p);
|
|
|
|
/** @ingroup flashrom-prog */
|
|
struct flashrom_programmer;
|
|
int flashrom_programmer_init(struct flashrom_programmer **, const char *prog_name, const char *prog_params);
|
|
int flashrom_programmer_shutdown(struct flashrom_programmer *);
|
|
|
|
struct flashrom_flashctx;
|
|
int flashrom_flash_probe(struct flashrom_flashctx **, const struct flashrom_programmer *, const char *chip_name);
|
|
size_t flashrom_flash_getsize(const struct flashrom_flashctx *);
|
|
int flashrom_flash_erase(struct flashrom_flashctx *);
|
|
void flashrom_flash_release(struct flashrom_flashctx *);
|
|
|
|
/** @ingroup flashrom-flash */
|
|
enum flashrom_flag {
|
|
FLASHROM_FLAG_FORCE,
|
|
FLASHROM_FLAG_FORCE_BOARDMISMATCH,
|
|
FLASHROM_FLAG_VERIFY_AFTER_WRITE,
|
|
FLASHROM_FLAG_VERIFY_WHOLE_CHIP,
|
|
};
|
|
void flashrom_flag_set(struct flashrom_flashctx *, enum flashrom_flag, bool value);
|
|
bool flashrom_flag_get(const struct flashrom_flashctx *, enum flashrom_flag);
|
|
|
|
int flashrom_image_read(struct flashrom_flashctx *, void *buffer, size_t buffer_len);
|
|
int flashrom_image_write(struct flashrom_flashctx *, void *buffer, size_t buffer_len, const void *refbuffer);
|
|
int flashrom_image_verify(struct flashrom_flashctx *, const void *buffer, size_t buffer_len);
|
|
|
|
struct flashrom_layout;
|
|
int flashrom_layout_new(struct flashrom_layout **);
|
|
int flashrom_layout_read_from_ifd(struct flashrom_layout **, struct flashrom_flashctx *, const void *dump, size_t len);
|
|
int flashrom_layout_read_fmap_from_rom(struct flashrom_layout **,
|
|
struct flashrom_flashctx *, size_t offset, size_t length);
|
|
int flashrom_layout_read_fmap_from_buffer(struct flashrom_layout **layout,
|
|
struct flashrom_flashctx *, const uint8_t *buf, size_t len);
|
|
int flashrom_layout_add_region(struct flashrom_layout *, size_t start, size_t end, const char *name);
|
|
int flashrom_layout_include_region(struct flashrom_layout *, const char *name);
|
|
int flashrom_layout_get_region_range(struct flashrom_layout *, const char *name,
|
|
unsigned int *start, unsigned int *len);
|
|
void flashrom_layout_release(struct flashrom_layout *);
|
|
void flashrom_layout_set(struct flashrom_flashctx *, const struct flashrom_layout *);
|
|
|
|
#endif /* !__LIBFLASHROM_H__ */
|