From e1561665e1231ce513facea6ca9865ac838a14bc Mon Sep 17 00:00:00 2001
From: Stefano Stabellini
Date: Thu, 1 Aug 2019 15:07:42 -0700
Subject: Document `package` format

Signed-off-by: Stefano Stabellini <stefanos@xilinx.com>
---
 PACKAGE.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 PACKAGE.md

diff --git a/PACKAGE.md b/PACKAGE.md
new file mode 100644
index 0000000..9d37e1c
--- /dev/null
+++ b/PACKAGE.md
@@ -0,0 +1,24 @@
+# A container package
+
+Imagebuilder takes multiple `package` containers as input and produces a
+runnable u-boot script or a runnable disk image as output. This document
+describes the package format.
+
+A package is a container containing all the relevant binaries for a
+given component under the following path:
+
+```
+/home/builder/output-<name>/
+```
+
+For instance, for DomUs a package containes the kernel, rootfs,
+additional configuration. As an example, zynqmp-dom1-package contains
+the following files:
+
+```
+/home/builder/output-zynqmp-dom1/Image-domU
+/home/builder/output-zynqmp-dom1/domU-ramdisk.cpio
+/home/builder/output-zynqmp-dom1/passthrough-example-part.dtb
+```
+
+Which are the kernel, ramdisk, passthrough configuration respectively.
-- 
cgit v1.2.3