/*- * SPDX-License-Identifier: BSD-2-Clause * * Copyright (c) 2016-2018 Solarflare Communications Inc. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * The views and conclusions contained in the software and documentation are * those of the authors and should not be interpreted as representing official * policies, either expressed or implied, of the FreeBSD Project. */ /* * This is NOT the original source file. Do NOT edit it. * To update the image layout headers, please edit the copy in * the sfregistry repo and then, in that repo, * "make layout_headers" or "make export" to * regenerate and export all types of headers. */ /* * These structures define the layouts for the signed firmware image binary * saved in NVRAM. The original image is in the Cryptographic message * syntax (CMS) format which contains the bootable firmware binary plus the * signatures. The entire image is written into NVRAM to enable the firmware * to validate the signatures. However, the bootrom still requires the * bootable-image to start at offset 0 of the NVRAM partition. Hence the image * is parsed upfront by host utilities (sfupdate) and written into nvram as * 'signed_image_chunks' described by a header. * * This file is used by the MC as well as host-utilities (sfupdate). */ #ifndef _SYS_EF10_SIGNED_IMAGE_LAYOUT_H #define _SYS_EF10_SIGNED_IMAGE_LAYOUT_H /* Signed image chunk type identifiers */ enum { SIGNED_IMAGE_CHUNK_CMS_HEADER, /* CMS header describing the signed data */ SIGNED_IMAGE_CHUNK_REFLASH_HEADER, /* Reflash header */ SIGNED_IMAGE_CHUNK_IMAGE, /* Bootable binary image */ SIGNED_IMAGE_CHUNK_REFLASH_TRAILER, /* Reflash trailer */ SIGNED_IMAGE_CHUNK_SIGNATURE, /* Remaining contents of the signed image, * including the certifiates and signature */ NUM_SIGNED_IMAGE_CHUNKS, }; /* Magic */ #define SIGNED_IMAGE_CHUNK_HDR_MAGIC 0xEF105161 /* EF10 SIGned Image */ /* Initial version definition - version 1 */ #define SIGNED_IMAGE_CHUNK_HDR_VERSION 0x1 /* Header length is 32 bytes */ #define SIGNED_IMAGE_CHUNK_HDR_LEN 32 /* * Structure describing the header of each chunk of signed image * as stored in NVRAM. */ typedef struct signed_image_chunk_hdr_e { /* * Magic field to recognise a valid entry * should match SIGNED_IMAGE_CHUNK_HDR_MAGIC */ uint32_t magic; /* Version number of this header */ uint32_t version; /* Chunk type identifier */ uint32_t id; /* Chunk offset */ uint32_t offset; /* Chunk length */ uint32_t len; /* * Reserved for future expansion of this structure - always * set to zeros */ uint32_t reserved[3]; } signed_image_chunk_hdr_t; #endif /* _SYS_EF10_SIGNED_IMAGE_LAYOUT_H */
