diff options
author | Olaf Mandel <o.mandel@menlosystems.com> | 2021-08-13 08:48:55 +0000 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-08-14 12:04:24 +0100 |
commit | 0b8f844c8c00f5d9648d55e8bf57b2d0fde090a2 (patch) | |
tree | 887bfad7c0a29d32b387195c191ed0ce3109a223 /documentation/ref-manual | |
parent | 2eb5550db45d9617365f2d0a34ff1b9d2ea0c9ed (diff) | |
download | poky-0b8f844c8c00f5d9648d55e8bf57b2d0fde090a2.tar.gz |
kickstart: document which options accept units
Document which units are accepted as parameters for the four options
that accept units. Also be pedantic about using binary instead of
decimal prefixes so readers don't have to wonder.
(From yocto-docs rev: 6b1d7d102ed3b509dfb3e43a3d7a27226f504df5)
Signed-off-by: Olaf Mandel <o.mandel@menlosystems.com>
Reviewed-by: Quentin Schulz <foss@0leil.net>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/kickstart.rst | 30 |
1 files changed, 20 insertions, 10 deletions
diff --git a/documentation/ref-manual/kickstart.rst b/documentation/ref-manual/kickstart.rst index fc723ccbe2..cac9f2f491 100644 --- a/documentation/ref-manual/kickstart.rst +++ b/documentation/ref-manual/kickstart.rst | |||
@@ -65,13 +65,17 @@ Here is an example that uses "/" as the mountpoint. The command uses | |||
65 | Here is a list that describes other supported options you can use with | 65 | Here is a list that describes other supported options you can use with |
66 | the ``part`` and ``partition`` commands: | 66 | the ``part`` and ``partition`` commands: |
67 | 67 | ||
68 | - ``--size``: The minimum partition size in MBytes. Specify an | 68 | - ``--size``: The minimum partition size. Specify as an integer value |
69 | integer value such as 500. Do not append the number with "MB". You do | 69 | optionally followed by one of the units "k" / "K" for kibibyte, |
70 | not need this option if you use ``--source``. | 70 | "M" for mebibyte and "G" for gibibyte. The default unit if none is |
71 | 71 | given is "M". You do not need this option if you use ``--source``. | |
72 | - ``--fixed-size``: The exact partition size in MBytes. You cannot | 72 | |
73 | specify with ``--size``. An error occurs when assembling the disk | 73 | - ``--fixed-size``: The exact partition size. Specify as an integer |
74 | image if the partition data is larger than ``--fixed-size``. | 74 | value optionally followed by one of the units "k" / "K" for kibibyte, |
75 | "M" for mebibyte and "G" for gibibyte. The default unit if none is | ||
76 | given is "M". Cannot be specify together with ``--size``. An error | ||
77 | occurs when assembling the disk image if the partition data is larger | ||
78 | than ``--fixed-size``. | ||
75 | 79 | ||
76 | - ``--source``: This option is a Wic-specific option that names the | 80 | - ``--source``: This option is a Wic-specific option that names the |
77 | source of the data that populates the partition. The most common | 81 | source of the data that populates the partition. The most common |
@@ -134,10 +138,13 @@ the ``part`` and ``partition`` commands: | |||
134 | - ``--align (in KBytes)``: This option is a Wic-specific option that | 138 | - ``--align (in KBytes)``: This option is a Wic-specific option that |
135 | says to start partitions on boundaries given x KBytes. | 139 | says to start partitions on boundaries given x KBytes. |
136 | 140 | ||
137 | - ``--offset (in KBytes)``: This option is a Wic-specific option that | 141 | - ``--offset``: This option is a Wic-specific option that |
138 | says to place a partition at exactly the specified offset. If the | 142 | says to place a partition at exactly the specified offset. If the |
139 | partition cannot be placed at the specified offset, the image build | 143 | partition cannot be placed at the specified offset, the image build |
140 | will fail. | 144 | will fail. Specify as an integer value optionally followed by one of |
145 | the units "s" / "S" for 512 byte sector, "k" / "K" for kibibyte, "M" | ||
146 | for mebibyte and "G" for gibibyte. The default unit if none is given | ||
147 | is "k". | ||
141 | 148 | ||
142 | - ``--no-table``: This option is a Wic-specific option. Using the | 149 | - ``--no-table``: This option is a Wic-specific option. Using the |
143 | option reserves space for the partition and causes it to become | 150 | option reserves space for the partition and causes it to become |
@@ -151,7 +158,10 @@ the ``part`` and ``partition`` commands: | |||
151 | - ``--extra-space``: This option is a Wic-specific option that adds | 158 | - ``--extra-space``: This option is a Wic-specific option that adds |
152 | extra space after the space filled by the content of the partition. | 159 | extra space after the space filled by the content of the partition. |
153 | The final size can exceed the size specified by the ``--size`` | 160 | The final size can exceed the size specified by the ``--size`` |
154 | option. The default value is 10 Mbytes. | 161 | option. The default value is 10M. Specify as an integer value |
162 | optionally followed by one of the units "k" / "K" for kibibyte, "M" | ||
163 | for mebibyte and "G" for gibibyte. The default unit if none is given | ||
164 | is "M". | ||
155 | 165 | ||
156 | - ``--overhead-factor``: This option is a Wic-specific option that | 166 | - ``--overhead-factor``: This option is a Wic-specific option that |
157 | multiplies the size of the partition by the option's value. You must | 167 | multiplies the size of the partition by the option's value. You must |