mirror of
https://git.yoctoproject.org/poky
synced 2026-04-27 03:32:12 +02:00
dev-manual, ref-manual: Moved kickstart reference to ref-manual
This section was misplaced in the dev-manual and really needed to be in the ref-manual. I created a new chapter that follows the devtool reference chapter and put the kickstart chapter there. Links were needed to be fixed up and a new chapter in the ref-manual named ref-kickstart.xml had to be created. (From yocto-docs rev: b4d5b7077a978e4966d1273a374741075a1b0c7d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
committed by
Richard Purdie
Richard Purdie
parent
6077ebbe80
commit
cbe8009a17
@@ -4812,8 +4812,8 @@
|
||||
system.
|
||||
<note>
|
||||
For a kickstart file reference, see the
|
||||
"<link linkend='openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link>"
|
||||
section.
|
||||
"<ulink url='&YOCTO_DOCS_REF_URL;#openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</ulink>"
|
||||
Chapter in the Yocto Project Reference Manual.
|
||||
</note>
|
||||
</para>
|
||||
|
||||
@@ -4934,7 +4934,7 @@
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Include the name of the
|
||||
<link linkend='openembedded-kickstart-wks-reference'>wic kickstart file</link>
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#openembedded-kickstart-wks-reference'>wic kickstart file</ulink>
|
||||
as part of the
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-WKS_FILE'><filename>WKS_FILE</filename></ulink>
|
||||
variable
|
||||
@@ -5439,319 +5439,6 @@
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<section id='openembedded-kickstart-wks-reference'>
|
||||
<title>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</title>
|
||||
|
||||
<para>
|
||||
The current Wic implementation supports
|
||||
only the basic kickstart partitioning commands:
|
||||
<filename>partition</filename> (or <filename>part</filename>
|
||||
for short) and <filename>bootloader</filename>.
|
||||
<note>
|
||||
Future updates will implement more commands and options.
|
||||
If you use anything that is not specifically
|
||||
supported, results can be unpredictable.
|
||||
</note>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The following is a list of the commands, their syntax,
|
||||
and meanings.
|
||||
The commands are based on the Fedora
|
||||
kickstart versions but with modifications to
|
||||
reflect Wic capabilities.
|
||||
You can see the original documentation for those commands
|
||||
at the following links:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<ulink url='http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition'>http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition</ulink>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<ulink url='http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader'>http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader</ulink>
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<section id='command-part-or-partition'>
|
||||
<title>Command: part or partition</title>
|
||||
|
||||
<para>
|
||||
Either of these commands create a partition on the system
|
||||
and use the following syntax:
|
||||
<literallayout class='monospaced'>
|
||||
part [<replaceable>mntpoint</replaceable>]
|
||||
partition [<replaceable>mntpoint</replaceable>]
|
||||
</literallayout>
|
||||
If you do not provide
|
||||
<replaceable>mntpoint</replaceable>, Wic creates a
|
||||
partition but does not mount it.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The
|
||||
<filename><replaceable>mntpoint</replaceable></filename>
|
||||
is where the partition will be mounted and must be of
|
||||
one of the following forms:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<filename>/<replaceable>path</replaceable></filename>:
|
||||
For example, "/", "/usr", or "/home"
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>swap</filename>:
|
||||
The created partition is used as swap space.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Specifying a <replaceable>mntpoint</replaceable> causes
|
||||
the partition to automatically be mounted.
|
||||
Wic achieves this by adding entries to the filesystem
|
||||
table (fstab) during image generation.
|
||||
In order for wic to generate a valid fstab, you must
|
||||
also provide one of the <filename>--ondrive</filename>,
|
||||
<filename>--ondisk</filename>, or
|
||||
<filename>--use-uuid</filename> partition options as
|
||||
part of the command.
|
||||
Here is an example using "/" as the mountpoint.
|
||||
The command uses "--ondisk" to force the partition onto
|
||||
the <filename>sdb</filename> disk:
|
||||
<literallayout class='monospaced'>
|
||||
part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024
|
||||
</literallayout>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Here is a list that describes other supported options
|
||||
you can use with the <filename>part</filename> and
|
||||
<filename>partition</filename> commands:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--size</filename>:</emphasis>
|
||||
The minimum partition size in MBytes.
|
||||
Specify an integer value such as 500.
|
||||
Do not append the number with "MB".
|
||||
You do not need this option if you use
|
||||
<filename>--source</filename>.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--source</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option that
|
||||
names the source of the data that populates
|
||||
the partition.
|
||||
The most common value for this option is
|
||||
"rootfs", but you can use any value that maps to
|
||||
a valid source plug-in.
|
||||
For information on the source plug-ins, see the
|
||||
"<ulink url='&YOCTO_DOCS_REF_URL;#wic-plug-ins-interface'>Wic Plug-Ins Interface</ulink>"
|
||||
section in the Yocto Project Reference
|
||||
manual.</para>
|
||||
|
||||
<para>If you use
|
||||
<filename>--source rootfs</filename>,
|
||||
Wic creates a partition as
|
||||
large as needed and to fill it with the contents
|
||||
of the root filesystem pointed to by the
|
||||
<filename>-r</filename> command-line option
|
||||
or the equivalent rootfs derived from the
|
||||
<filename>-e</filename> command-line
|
||||
option.
|
||||
The filesystem type used to create the
|
||||
partition is driven by the value of the
|
||||
<filename>--fstype</filename> option
|
||||
specified for the partition.
|
||||
See the entry on
|
||||
<filename>--fstype</filename> that
|
||||
follows for more information.
|
||||
</para>
|
||||
|
||||
<para>If you use
|
||||
<filename>--source <replaceable>plugin-name</replaceable></filename>,
|
||||
Wic creates a partition as
|
||||
large as needed and fills it with the contents
|
||||
of the partition that is generated by the
|
||||
specified plug-in name using the data pointed
|
||||
to by the <filename>-r</filename> command-line
|
||||
option or the equivalent rootfs derived from the
|
||||
<filename>-e</filename> command-line
|
||||
option.
|
||||
Exactly what those contents and filesystem type
|
||||
end up being are dependent on the given plug-in
|
||||
implementation.
|
||||
</para>
|
||||
|
||||
<para>If you do not use the
|
||||
<filename>--source</filename> option, the
|
||||
<filename>wic</filename> command creates an
|
||||
empty partition.
|
||||
Consequently, you must use the
|
||||
<filename>--size</filename> option to specify
|
||||
the size of the empty partition.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--ondisk</filename> or <filename>--ondrive</filename>:</emphasis>
|
||||
Forces the partition to be created on a
|
||||
particular disk.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--fstype</filename>:</emphasis>
|
||||
Sets the file system type for the partition.
|
||||
Valid values are:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<filename>ext4</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>ext3</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>ext2</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>btrfs</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>squashfs</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>swap</filename>
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--fsoptions</filename>:</emphasis>
|
||||
Specifies a free-form string of options to be
|
||||
used when mounting the filesystem.
|
||||
This string will be copied into the
|
||||
<filename>/etc/fstab</filename> file of the
|
||||
installed system and should be enclosed in
|
||||
quotes.
|
||||
If not specified, the default string
|
||||
is "defaults".
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--label label</filename>:</emphasis>
|
||||
Specifies the label to give to the filesystem to
|
||||
be made on the partition.
|
||||
If the given label is already in use by another
|
||||
filesystem, a new label is created for the
|
||||
partition.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--active</filename>:</emphasis>
|
||||
Marks the partition as active.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--align (in KBytes)</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option that
|
||||
says to start a partition on an
|
||||
<replaceable>x</replaceable> KBytes
|
||||
boundary.</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--no-table</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option.
|
||||
Using the option reserves space for the
|
||||
partition and causes it to become populated.
|
||||
However, the partition is not added to the
|
||||
partition table.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--extra-space</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option that
|
||||
adds extra space after the space filled by the
|
||||
content of the partition.
|
||||
The final size can go beyond the size specified
|
||||
by the <filename>--size</filename> option.
|
||||
The default value is 10 Mbytes.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--overhead-factor</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option that
|
||||
multiplies the size of the partition by the
|
||||
option's value.
|
||||
You must supply a value greater than or equal to
|
||||
"1".
|
||||
The default value is "1.3".
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--part-type</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option that
|
||||
specifies the partition type globally
|
||||
unique identifier (GUID) for GPT partitions.
|
||||
You can find the list of partition type GUIDs
|
||||
at
|
||||
<ulink url='http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs'></ulink>.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--use-uuid</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific option that
|
||||
causes Wic to generate a
|
||||
random GUID for the partition.
|
||||
The generated identifier is used in the
|
||||
bootloader configuration to specify the root
|
||||
partition.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--uuid</filename>:</emphasis>
|
||||
This option is a
|
||||
Wic-specific
|
||||
option that specifies the partition UUID.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id='command-bootloader'>
|
||||
<title>Command: bootloader</title>
|
||||
|
||||
<para>
|
||||
This command specifies how the bootloader should be
|
||||
configured and supports the following options:
|
||||
<note>
|
||||
Bootloader functionality and boot partitions are
|
||||
implemented by the various
|
||||
<filename>--source</filename>
|
||||
plug-ins that implement bootloader functionality.
|
||||
The bootloader command essentially provides a
|
||||
means of modifying bootloader configuration.
|
||||
</note>
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--timeout</filename>:</emphasis>
|
||||
Specifies the number of seconds before the
|
||||
bootloader times out and boots the default
|
||||
option.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--append</filename>:</emphasis>
|
||||
Specifies kernel parameters.
|
||||
These parameters will be added to the syslinux
|
||||
<filename>APPEND</filename> or
|
||||
<filename>grub</filename> kernel command line.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--configfile</filename>:</emphasis>
|
||||
Specifies a user-defined configuration file for
|
||||
the bootloader.
|
||||
You can provide a full pathname for the file or
|
||||
a file that exists in the
|
||||
<filename>canned-wks</filename> folder.
|
||||
This option overrides all other bootloader
|
||||
options.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<section id='building-an-initramfs-image'>
|
||||
|
||||
@@ -235,6 +235,9 @@
|
||||
<xi:include
|
||||
xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-devtool-reference.xml"/>
|
||||
|
||||
<xi:include
|
||||
xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-kickstart.xml"/>
|
||||
|
||||
<xi:include
|
||||
xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-qa-checks.xml"/>
|
||||
|
||||
|
||||
284
documentation/ref-manual/ref-kickstart.xml
Normal file
284
documentation/ref-manual/ref-kickstart.xml
Normal file
@@ -0,0 +1,284 @@
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
||||
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
|
||||
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
|
||||
|
||||
<chapter id='ref-kickstart'>
|
||||
<title>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</title>
|
||||
|
||||
<section id='openembedded-kickstart-wks-reference'>
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>
|
||||
The current Wic implementation supports only the basic kickstart
|
||||
partitioning commands:
|
||||
<filename>partition</filename> (or <filename>part</filename>
|
||||
for short) and <filename>bootloader</filename>.
|
||||
<note>
|
||||
Future updates will implement more commands and options.
|
||||
If you use anything that is not specifically supported, results
|
||||
can be unpredictable.
|
||||
</note>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
This chapter provides a reference on the available kickstart
|
||||
commands.
|
||||
The information lists the commands, their syntax, and meanings.
|
||||
Kickstart commands are based on the Fedora kickstart versions but
|
||||
with modifications to reflect Wic capabilities.
|
||||
You can see the original documentation for those commands at the
|
||||
following links:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<ulink url='http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition'>http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition</ulink>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<ulink url='http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader'>http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader</ulink>
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id='command-part-or-partition'>
|
||||
<title>Command: part or partition</title>
|
||||
|
||||
<para>
|
||||
Either of these commands create a partition on the system and use
|
||||
the following syntax:
|
||||
<literallayout class='monospaced'>
|
||||
part [<replaceable>mntpoint</replaceable>]
|
||||
partition [<replaceable>mntpoint</replaceable>]
|
||||
</literallayout>
|
||||
If you do not provide <replaceable>mntpoint</replaceable>, Wic
|
||||
creates a partition but does not mount it.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The <filename><replaceable>mntpoint</replaceable></filename> is
|
||||
where the partition will be mounted and must be of one of the
|
||||
following forms:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<filename>/<replaceable>path</replaceable></filename>:
|
||||
For example, "/", "/usr", or "/home"
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>swap</filename>:
|
||||
The created partition is used as swap space.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Specifying a <replaceable>mntpoint</replaceable> causes the
|
||||
partition to automatically be mounted.
|
||||
Wic achieves this by adding entries to the filesystem table (fstab)
|
||||
during image generation.
|
||||
In order for wic to generate a valid fstab, you must also provide
|
||||
one of the <filename>--ondrive</filename>,
|
||||
<filename>--ondisk</filename>, or
|
||||
<filename>--use-uuid</filename> partition options as part of the
|
||||
command.
|
||||
Here is an example using "/" as the mountpoint.
|
||||
The command uses "--ondisk" to force the partition onto the
|
||||
<filename>sdb</filename> disk:
|
||||
<literallayout class='monospaced'>
|
||||
part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024
|
||||
</literallayout>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Here is a list that describes other supported options you can use
|
||||
with the <filename>part</filename> and
|
||||
<filename>partition</filename> commands:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--size</filename>:</emphasis>
|
||||
The minimum partition size in MBytes.
|
||||
Specify an integer value such as 500.
|
||||
Do not append the number with "MB".
|
||||
You do not need this option if you use
|
||||
<filename>--source</filename>.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--source</filename>:</emphasis>
|
||||
This option is a Wic-specific option that names the source
|
||||
of the data that populates the partition.
|
||||
The most common value for this option is "rootfs", but you
|
||||
can use any value that maps to a valid source plug-in.
|
||||
For information on the source plug-ins, see the
|
||||
"<link linkend='wic-plug-ins-interface'>Wic Plug-Ins Interface</link>"
|
||||
section.</para>
|
||||
|
||||
<para>If you use <filename>--source rootfs</filename>, Wic
|
||||
creates a partition as large as needed and to fill it with
|
||||
the contents of the root filesystem pointed to by the
|
||||
<filename>-r</filename> command-line option or the
|
||||
equivalent rootfs derived from the <filename>-e</filename>
|
||||
command-line option.
|
||||
The filesystem type used to create the partition is driven
|
||||
by the value of the <filename>--fstype</filename> option
|
||||
specified for the partition.
|
||||
See the entry on <filename>--fstype</filename> that follows
|
||||
for more information.</para>
|
||||
|
||||
<para>If you use
|
||||
<filename>--source <replaceable>plugin-name</replaceable></filename>,
|
||||
Wic creates a partition as large as needed and fills it
|
||||
with the contents of the partition that is generated by the
|
||||
specified plug-in name using the data pointed to by the
|
||||
<filename>-r</filename> command-line option or the
|
||||
equivalent rootfs derived from the <filename>-e</filename>
|
||||
command-line option.
|
||||
Exactly what those contents and filesystem type end up
|
||||
being are dependent on the given plug-in implementation.
|
||||
</para>
|
||||
|
||||
<para>If you do not use the <filename>--source</filename>
|
||||
option, the <filename>wic</filename> command creates an
|
||||
empty partition.
|
||||
Consequently, you must use the <filename>--size</filename>
|
||||
option to specify the size of the empty partition.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--ondisk</filename> or <filename>--ondrive</filename>:</emphasis>
|
||||
Forces the partition to be created on a particular disk.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--fstype</filename>:</emphasis>
|
||||
Sets the file system type for the partition.
|
||||
Valid values are:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<filename>ext4</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>ext3</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>ext2</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>btrfs</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>squashfs</filename>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<filename>swap</filename>
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--fsoptions</filename>:</emphasis>
|
||||
Specifies a free-form string of options to be used when
|
||||
mounting the filesystem.
|
||||
This string will be copied into the
|
||||
<filename>/etc/fstab</filename> file of the installed
|
||||
system and should be enclosed in quotes.
|
||||
If not specified, the default string is "defaults".
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--label label</filename>:</emphasis>
|
||||
Specifies the label to give to the filesystem to be made on
|
||||
the partition.
|
||||
If the given label is already in use by another filesystem,
|
||||
a new label is created for the partition.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--active</filename>:</emphasis>
|
||||
Marks the partition as active.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--align (in KBytes)</filename>:</emphasis>
|
||||
This option is a Wic-specific option that says to start a
|
||||
partition on an <replaceable>x</replaceable> KBytes
|
||||
boundary.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--no-table</filename>:</emphasis>
|
||||
This option is a Wic-specific option.
|
||||
Using the option reserves space for the partition and
|
||||
causes it to become populated.
|
||||
However, the partition is not added to the partition table.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--extra-space</filename>:</emphasis>
|
||||
This option is a Wic-specific option that adds extra space
|
||||
after the space filled by the content of the partition.
|
||||
The final size can go beyond the size specified by the
|
||||
<filename>--size</filename> option.
|
||||
The default value is 10 Mbytes.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--overhead-factor</filename>:</emphasis>
|
||||
This option is a Wic-specific option that multiplies the
|
||||
size of the partition by the option's value.
|
||||
You must supply a value greater than or equal to "1".
|
||||
The default value is "1.3".
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--part-type</filename>:</emphasis>
|
||||
This option is a Wic-specific option that specifies the
|
||||
partition type globally unique identifier (GUID) for GPT
|
||||
partitions.
|
||||
You can find the list of partition type GUIDs at
|
||||
<ulink url='http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs'></ulink>.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--use-uuid</filename>:</emphasis>
|
||||
This option is a Wic-specific option that causes Wic to
|
||||
generate a random GUID for the partition.
|
||||
The generated identifier is used in the bootloader
|
||||
configuration to specify the root partition.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--uuid</filename>:</emphasis>
|
||||
This option is a Wic-specific option that specifies the
|
||||
partition UUID.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id='command-bootloader'>
|
||||
<title>Command: bootloader</title>
|
||||
|
||||
<para>
|
||||
This command specifies how the bootloader should be configured and
|
||||
supports the following options:
|
||||
<note>
|
||||
Bootloader functionality and boot partitions are implemented by
|
||||
the various <filename>--source</filename> plug-ins that
|
||||
implement bootloader functionality.
|
||||
The bootloader command essentially provides a means of
|
||||
modifying bootloader configuration.
|
||||
</note>
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--timeout</filename>:</emphasis>
|
||||
Specifies the number of seconds before the bootloader times
|
||||
out and boots the default option.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--append</filename>:</emphasis>
|
||||
Specifies kernel parameters.
|
||||
These parameters will be added to the syslinux
|
||||
<filename>APPEND</filename> or <filename>grub</filename>
|
||||
kernel command line.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis><filename>--configfile</filename>:</emphasis>
|
||||
Specifies a user-defined configuration file for the
|
||||
bootloader.
|
||||
You can provide a full pathname for the file or a file that
|
||||
exists in the <filename>canned-wks</filename> folder.
|
||||
This option overrides all other bootloader options.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</section>
|
||||
</chapter>
|
||||
<!--
|
||||
vim: expandtab tw=80 ts=4
|
||||
-->
|
||||
@@ -179,6 +179,8 @@
|
||||
|
||||
<xi:include href="ref-devtool-reference.xml"/>
|
||||
|
||||
<xi:include href="ref-kickstart.xml"/>
|
||||
|
||||
<xi:include href="ref-qa-checks.xml"/>
|
||||
|
||||
<xi:include href="ref-images.xml"/>
|
||||
|
||||
@@ -16252,8 +16252,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
|
||||
"<ulink url='&YOCTO_DOCS_DEV_URL;#creating-partitioned-images'>Creating Partitioned Images</ulink>"
|
||||
section in the Yocto Project Development Manual.
|
||||
For details on the kickstart file format, see the
|
||||
"<ulink url='&YOCTO_DOCS_DEV_URL;#openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</ulink>
|
||||
also in the Yocto Project Development Manual.
|
||||
"<link linkend='openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link>
|
||||
Chapter.
|
||||
</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
|
||||
Reference in New Issue
Block a user