summaryrefslogtreecommitdiff
path: root/devel/script
diff options
context:
space:
mode:
authorA. Wilcox <AWilcox@Wilcox-Tech.com>2019-09-05 17:51:03 -0500
committerA. Wilcox <AWilcox@Wilcox-Tech.com>2019-09-05 17:51:03 -0500
commit403686e85aeb1756e1b1728509484eefb35fdbeb (patch)
treef0ae116501c6bd0b22daf696d42cc2258f3ec1b3 /devel/script
parent9457d3e1d0ab4179b5e85b34bb0303162e8f58fd (diff)
downloadhorizon-403686e85aeb1756e1b1728509484eefb35fdbeb.tar.gz
horizon-403686e85aeb1756e1b1728509484eefb35fdbeb.tar.bz2
horizon-403686e85aeb1756e1b1728509484eefb35fdbeb.tar.xz
horizon-403686e85aeb1756e1b1728509484eefb35fdbeb.zip
script: keys: Add disk section, and sizing guide
Diffstat (limited to 'devel/script')
-rw-r--r--devel/script/2_keys.xml23
1 files changed, 23 insertions, 0 deletions
diff --git a/devel/script/2_keys.xml b/devel/script/2_keys.xml
index 1303c12..e66d752 100644
--- a/devel/script/2_keys.xml
+++ b/devel/script/2_keys.xml
@@ -448,4 +448,27 @@ signingkey https://packages/builder@ourcompany.net.pub
</formalpara>
</section>
</section>
+ <section id="disk">
+ <title>Disk Partitioning Keys</title>
+ <para>This section describes the keys used for partitioning one or more hard disk drives using HorizonScript. Of these, only the <literal>mount</literal> key is required to be present in a valid HorizonScript.</para>
+ <section id="disk.sizing">
+ <title>Sizing</title>
+ <formalpara id="sizing.purpose">
+ <title>Purpose</title>
+ <para>All disk partitioning keys that take a size argument shall follow the format described in this section. There are three forms of valid size that may be specified.</para>
+ </formalpara>
+ <formalpara id="sizing.format1">
+ <title>Format #1: Block Size</title>
+ <para>Block sizing format is: <replaceable>number</replaceable>{K|M|G|T}. K, M, G, and T represent IEC binary prefixes; for example, "150G" would specify 150 GiB.</para>
+ </formalpara>
+ <formalpara id="sizing.format2">
+ <title>Format #2: Percentage</title>
+ <para>Percentage format is: <replaceable>number</replaceable>%, where <replaceable>number</replaceable> is a number from 1 to 100 inclusive. It is invalid to specify multiple partitions that would use more than 100% of a containing block device.</para>
+ </formalpara>
+ <formalpara id="sizing.format3">
+ <title>Format #3: Fill</title>
+ <para>The literal string <literal>fill</literal> specifies that the partition shall fill the remaining space of the containing block device. No partitions may come after one that specifies <literal>fill</literal> on the same containing block device.</para>
+ </formalpara>
+ </section>
+ </section>
</chapter>