coreboot-kgpe-d16/src/include/region_file.h
Patrick Georgi 6b5bc77c9b treewide: Remove "this file is part of" lines
Stefan thinks they don't add value.

Command used:
sed -i -e '/file is part of /d' $(git grep "file is part of " |egrep ":( */\*.*\*/\$|#|;#|-- | *\* )" | cut -d: -f1 |grep -v crossgcc |grep -v gcov | grep -v /elf.h |grep -v nvramtool)

The exceptions are for:
 - crossgcc (patch file)
 - gcov (imported from gcc)
 - elf.h (imported from GNU's libc)
 - nvramtool (more complicated header)

The removed lines are:
-       fmt.Fprintln(f, "/* This file is part of the coreboot project. */")
-# This file is part of a set of unofficial pre-commit hooks available
-/* This file is part of coreboot */
-# This file is part of msrtool.
-/* This file is part of msrtool. */
- * This file is part of ncurses, designed to be appended after curses.h.in
-/* This file is part of pgtblgen. */
- * This file is part of the coreboot project.
- /* This file is part of the coreboot project. */
-#  This file is part of the coreboot project.
-# This file is part of the coreboot project.
-## This file is part of the coreboot project.
--- This file is part of the coreboot project.
-/* This file is part of the coreboot project */
-/* This file is part of the coreboot project. */
-;## This file is part of the coreboot project.
-# This file is part of the coreboot project. It originated in the
- * This file is part of the coreinfo project.
-## This file is part of the coreinfo project.
- * This file is part of the depthcharge project.
-/* This file is part of the depthcharge project. */
-/* This file is part of the ectool project. */
- * This file is part of the GNU C Library.
- * This file is part of the libpayload project.
-## This file is part of the libpayload project.
-/* This file is part of the Linux kernel. */
-## This file is part of the superiotool project.
-/* This file is part of the superiotool project */
-/* This file is part of uio_usbdebug */

Change-Id: I82d872b3b337388c93d5f5bf704e9ee9e53ab3a9
Signed-off-by: Patrick Georgi <pgeorgi@google.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/41194
Reviewed-by: HAOUAS Elyes <ehaouas@noos.fr>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2020-05-11 17:11:40 +00:00

49 lines
1.5 KiB
C

/* SPDX-License-Identifier: GPL-2.0-only */
#ifndef REGION_FILE_H
#define REGION_FILE_H
#include <commonlib/region.h>
#include <stdint.h>
/*
* A region file is an abstraction to allow appending updates in a
* region_device where the data returned is the most recently written
* data. It is block based with a 16 byte granularity. So if you write
* 2 bytes into the file the data returned in the region_device would
* have 16 bytes allocated for the latest update. Additionally, the
* current maximum file size allowed is 1MiB - 48 bytes. See comments
* in C implementation file for further details.
*/
struct region_file;
/*
* Initialize a region file associated with a provided region device.
* Returns < 0 on error, 0 on success.
*/
int region_file_init(struct region_file *f, const struct region_device *p);
/*
* Initialize region device object associated with latest update of file data.
* Returns < 0 on error, 0 on success.
*/
int region_file_data(const struct region_file *f, struct region_device *rdev);
/* Update region file with latest data. Returns < 0 on error, 0 on success. */
int region_file_update_data(struct region_file *f, const void *buf,
size_t size);
/* Declared here for easy object allocation. */
struct region_file {
/* Region device covering file */
struct region_device rdev;
/* Metadata containing blocks of the data stream. */
struct region_device metadata;
/* Blocks forming data. */
uint16_t data_blocks[2];
/* Current slot in metadata marking end of data. */
int slot;
};
#endif /* REGION_FILE_H */