summaryrefslogtreecommitdiff
path: root/extensions/rawdisk.write.help
diff options
context:
space:
mode:
authorEdward Cragg <edward.cragg@codethink.co.uk>2015-09-24 15:09:16 +0100
committerPedro Alvarez <pedro.alvarez@codethink.co.uk>2015-10-24 14:44:00 +0100
commitd9aeb29a199aa4f869c335e9923065554a1bb350 (patch)
tree44740b01023eb946f53b59d67e5f298134837bb6 /extensions/rawdisk.write.help
parent025e1444551457b2fc3d9a048402e6bdfd6da7e5 (diff)
downloaddefinitions-d9aeb29a199aa4f869c335e9923065554a1bb350.tar.gz
Rawdisk partitioning v2: Add documentation
Change-Id: Icf965499380522d8f80cc07f17678179dedeee1a
Diffstat (limited to 'extensions/rawdisk.write.help')
-rw-r--r--extensions/rawdisk.write.help45
1 files changed, 45 insertions, 0 deletions
diff --git a/extensions/rawdisk.write.help b/extensions/rawdisk.write.help
index 52ed73fb..72e285b7 100644
--- a/extensions/rawdisk.write.help
+++ b/extensions/rawdisk.write.help
@@ -78,5 +78,50 @@ help: |
(See https://www.kernel.org/doc/Documentation/kernel-parameters.txt)
+ * PARTITION_FILE=path: path to a YAML partition specification to use for
+ producing partitioned disks or devices. The default specification is
+ 'partitioning/default' in definitions, which specifies a device with a
+ single partition. This may serve as an example of the format of this
+ file, or check the pyfdisk.py documentation in pyfdisk.README.
+
+ In addition to the features available in pyfdisk.py, using this
+ extension, a list of 'raw_files' items can be added at the partition
+ level, or the top level of the partition specification. This specifies
+ files to be written directly to the target device or image using `dd`
+
+ start_offset: 2048
+ partition_table_format: mbr
+ partitions:
+ - description: boot
+ filesystem: none
+ ...
+ raw_files:
+ - file: boot/uboot.img
+ raw_files:
+ - file: boot/uboot-env.img
+ offset_bytes: 512
+ - file: boot/preloader.bin
+ skip_bytes: 128
+ count_bytes: 16K
+
+ * Files are written consecutively in the order they are listed, and
+ sourced from the unpacked root filesystem image
+ * Files can be given a specific offset with 'offset_sectors' or
+ 'offset_bytes'
+ * With 'raw_files' specified inside a partition, 'offset_sectors' or
+ 'offset_bytes' is counted from the start of that partition,
+ otherwise from the start of the device.
+ * For files without an explicit offset, the next file is written
+ starting with the next free byte following the previous file
+ * Providing an offset is optional for all files
+ * Specifying 'skip_bytes' will set the 'skip=' option for dd, skipping
+ a number of bytes at the start of the input file
+ * Specifying 'count_bytes' sets the 'count=' option for dd
+ * For properties which take an input in bytes, a human-readable
+ multiplier can be used, e.g. K, M, G (integer multiplicands only)
+
+ * USE_PARTITIONING=boolean (default: no) Use this flag to enable
+ partitioning functions.
+
(See `morph help deploy` for details of how to pass parameters to write
extensions)