summaryrefslogtreecommitdiff
path: root/payloads/libpayload/include
diff options
context:
space:
mode:
authorDaisuke Nojiri <dnojiri@chromium.org>2015-11-05 10:05:38 -0800
committerLeroy P Leahy <leroy.p.leahy@intel.com>2015-12-16 19:00:53 +0100
commit6d2c7226cb86d005236cfc171bcfcf591b355dd6 (patch)
tree9997ac8035a9f068b08fa60b22f9d5494f4b7c62 /payloads/libpayload/include
parent6fc544d3d4479b8561e96e817f699323d25901a0 (diff)
downloadcoreboot-6d2c7226cb86d005236cfc171bcfcf591b355dd6.tar.xz
libpayload: add archive.h
archive.h is a header file for the programs which need to parse an archive created by 'archive' tool. See archive.h for the format description. BUG=chromium:502066 BRANCH=tot TEST=Tested on Glados Change-Id: I2bee9d7c12b0e1bce1529dfef360c5fa4ce0872d Signed-off-by: Daisuke Nojiri <dnojiri@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/311201 Reviewed-by: Randall Spangler <rspangler@chromium.org> Reviewed-on: https://review.coreboot.org/12734 Tested-by: build bot (Jenkins) Reviewed-by: Stefan Reinauer <stefan.reinauer@coreboot.org>
Diffstat (limited to 'payloads/libpayload/include')
-rw-r--r--payloads/libpayload/include/archive.h92
-rw-r--r--payloads/libpayload/include/libpayload.h1
2 files changed, 93 insertions, 0 deletions
diff --git a/payloads/libpayload/include/archive.h b/payloads/libpayload/include/archive.h
new file mode 100644
index 0000000000..47dc93cee0
--- /dev/null
+++ b/payloads/libpayload/include/archive.h
@@ -0,0 +1,92 @@
+/*
+ * This file is part of the libpayload project.
+ *
+ * Copyright (C) 2015 The ChromiumOS Authors. All rights reserved.
+ * written by Daisuke Nojiri <dnojiri@chromium.org>
+ *
+ * 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.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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.
+ */
+
+#ifndef __ARCHIVE_H
+#define __ARCHIVE_H
+
+#include <stdint.h>
+
+/*
+ * Archive file layout:
+ *
+ * +----------------------------------+
+ * | root header |
+ * +----------------------------------+
+ * | file_header[0] |
+ * +----------------------------------+
+ * | file_header[1] |
+ * +----------------------------------+
+ * | ... |
+ * +----------------------------------+
+ * | file_header[count-1] |
+ * +----------------------------------+
+ * | file(0) content |
+ * +----------------------------------+
+ * | file(1) content |
+ * +----------------------------------+
+ * | ... |
+ * +----------------------------------+
+ * | file(count-1) content |
+ * +----------------------------------+
+ */
+
+#define VERSION 0
+#define CBAR_MAGIC "CBAR"
+#define NAME_LENGTH 32
+
+/* Root header */
+struct directory {
+ char magic[4];
+ uint32_t version; /* version of the header. little endian */
+ uint32_t size; /* total size of archive. little endian */
+ uint32_t count; /* number of files. little endian */
+};
+
+/* File header */
+struct dentry {
+ /* file name. null-terminated if shorter than NAME_LENGTH */
+ char name[NAME_LENGTH];
+ /* file offset from the root header. little endian */
+ uint32_t offset;
+ /* file size. little endian */
+ uint32_t size;
+};
+
+static inline struct dentry *get_first_dentry(const struct directory *dir)
+{
+ return (struct dentry *)(dir + 1);
+}
+
+static inline uint32_t get_first_offset(const struct directory *dir)
+{
+ return sizeof(struct directory) + sizeof(struct dentry) * dir->count;
+}
+
+#endif
diff --git a/payloads/libpayload/include/libpayload.h b/payloads/libpayload/include/libpayload.h
index a1dbb0143b..1b66bf8ddb 100644
--- a/payloads/libpayload/include/libpayload.h
+++ b/payloads/libpayload/include/libpayload.h
@@ -61,6 +61,7 @@
#include <arch/virtual.h>
#include <sysinfo.h>
#include <pci.h>
+#include <archive.h>
#define MIN(a,b) ((a) < (b) ? (a) : (b))
#define MAX(a,b) ((a) > (b) ? (a) : (b))