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>
author: Scott Rifenbark <srifenbark@gmail.com> 2017-10-11 15:57:19 -0700
committer: Richard Purdie <richard.purdie@linuxfoundation.org> 2017-10-16 23:46:52 +0100
commit: cbe8009a1779977a51d153c90c5b6e89fdbace99 (patch)
tree: 1a85432e3eeacf6ff91cf63c8ede5360d9c52624 /documentation/dev-manual
parent: 6077ebbe806bb232e3d96b0f138e1f4748e5ef5b (diff)
download: poky-cbe8009a1779977a51d153c90c5b6e89fdbace99.tar.gz
1 files changed, 3 insertions, 316 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 3f4c2802ce..ef2e9410d4 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -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>"
+                "<ulink url='&YOCTO_DOCS_REF_URL;#openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</ulink>"
-                section.
+                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'>
author	Scott Rifenbark <srifenbark@gmail.com>	2017-10-11 15:57:19 -0700
committer	Richard Purdie <richard.purdie@linuxfoundation.org>	2017-10-16 23:46:52 +0100
commit	cbe8009a1779977a51d153c90c5b6e89fdbace99 (patch)
tree	1a85432e3eeacf6ff91cf63c8ede5360d9c52624 /documentation/dev-manual
parent	6077ebbe806bb232e3d96b0f138e1f4748e5ef5b (diff)
download	poky-cbe8009a1779977a51d153c90c5b6e89fdbace99.tar.gz

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 3f4c2802ce..ef2e9410d4 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -4812,8 +4812,8 @@
4812	system.	4812	system.
4813	<note>	4813	<note>
4814	For a kickstart file reference, see the	4814	For a kickstart file reference, see the
4815	"<link linkend='openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link>"	4815	"<ulink url='&YOCTO_DOCS_REF_URL;#openembedded-kickstart-wks-reference'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</ulink>"
4816	section.	4816	Chapter in the Yocto Project Reference Manual.
4817	</note>	4817	</note>
4818	</para>	4818	</para>
4819		4819
@@ -4934,7 +4934,7 @@
4934	</para></listitem>	4934	</para></listitem>
4935	<listitem><para>	4935	<listitem><para>
4936	Include the name of the	4936	Include the name of the
4937	<link linkend='openembedded-kickstart-wks-reference'>wic kickstart file</link>	4937	<ulink url='&YOCTO_DOCS_REF_URL;#openembedded-kickstart-wks-reference'>wic kickstart file</ulink>
4938	as part of the	4938	as part of the
4939	<ulink url='&YOCTO_DOCS_REF_URL;#var-WKS_FILE'><filename>WKS_FILE</filename></ulink>	4939	<ulink url='&YOCTO_DOCS_REF_URL;#var-WKS_FILE'><filename>WKS_FILE</filename></ulink>
4940	variable	4940	variable
@@ -5439,319 +5439,6 @@
5439	</para>	5439	</para>
5440	</section>	5440	</section>
5441	</section>	5441	</section>
5442
5443	<section id='openembedded-kickstart-wks-reference'>
5444	<title>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</title>
5445
5446	<para>
5447	The current Wic implementation supports
5448	only the basic kickstart partitioning commands:
5449	<filename>partition</filename> (or <filename>part</filename>
5450	for short) and <filename>bootloader</filename>.
5451	<note>
5452	Future updates will implement more commands and options.
5453	If you use anything that is not specifically
5454	supported, results can be unpredictable.
5455	</note>
5456	</para>
5457
5458	<para>
5459	The following is a list of the commands, their syntax,
5460	and meanings.
5461	The commands are based on the Fedora
5462	kickstart versions but with modifications to
5463	reflect Wic capabilities.
5464	You can see the original documentation for those commands
5465	at the following links:
5466	<itemizedlist>
5467	<listitem><para>
5468	<ulink url='http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition'>http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition</ulink>
5469	</para></listitem>
5470	<listitem><para>
5471	<ulink url='http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader'>http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader</ulink>
5472	</para></listitem>
5473	</itemizedlist>
5474	</para>
5475
5476	<section id='command-part-or-partition'>
5477	<title>Command: part or partition</title>
5478
5479	<para>
5480	Either of these commands create a partition on the system
5481	and use the following syntax:
5482	<literallayout class='monospaced'>
5483	part [<replaceable>mntpoint</replaceable>]
5484	partition [<replaceable>mntpoint</replaceable>]
5485	</literallayout>
5486	If you do not provide
5487	<replaceable>mntpoint</replaceable>, Wic creates a
5488	partition but does not mount it.
5489	</para>
5490
5491	<para>
5492	The
5493	<filename><replaceable>mntpoint</replaceable></filename>
5494	is where the partition will be mounted and must be of
5495	one of the following forms:
5496	<itemizedlist>
5497	<listitem><para>
5498	<filename>/<replaceable>path</replaceable></filename>:
5499	For example, "/", "/usr", or "/home"
5500	</para></listitem>
5501	<listitem><para>
5502	<filename>swap</filename>:
5503	The created partition is used as swap space.
5504	</para></listitem>
5505	</itemizedlist>
5506	</para>
5507
5508	<para>
5509	Specifying a <replaceable>mntpoint</replaceable> causes
5510	the partition to automatically be mounted.
5511	Wic achieves this by adding entries to the filesystem
5512	table (fstab) during image generation.
5513	In order for wic to generate a valid fstab, you must
5514	also provide one of the <filename>--ondrive</filename>,
5515	<filename>--ondisk</filename>, or
5516	<filename>--use-uuid</filename> partition options as
5517	part of the command.
5518	Here is an example using "/" as the mountpoint.
5519	The command uses "--ondisk" to force the partition onto
5520	the <filename>sdb</filename> disk:
5521	<literallayout class='monospaced'>
5522	part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024
5523	</literallayout>
5524	</para>
5525
5526	<para>
5527	Here is a list that describes other supported options
5528	you can use with the <filename>part</filename> and
5529	<filename>partition</filename> commands:
5530	<itemizedlist>
5531	<listitem><para>
5532	<emphasis><filename>--size</filename>:</emphasis>
5533	The minimum partition size in MBytes.
5534	Specify an integer value such as 500.
5535	Do not append the number with "MB".
5536	You do not need this option if you use
5537	<filename>--source</filename>.
5538	</para></listitem>
5539	<listitem><para>
5540	<emphasis><filename>--source</filename>:</emphasis>
5541	This option is a
5542	Wic-specific option that
5543	names the source of the data that populates
5544	the partition.
5545	The most common value for this option is
5546	"rootfs", but you can use any value that maps to
5547	a valid source plug-in.
5548	For information on the source plug-ins, see the
5549	"<ulink url='&YOCTO_DOCS_REF_URL;#wic-plug-ins-interface'>Wic Plug-Ins Interface</ulink>"
5550	section in the Yocto Project Reference
5551	manual.</para>
5552
5553	<para>If you use
5554	<filename>--source rootfs</filename>,
5555	Wic creates a partition as
5556	large as needed and to fill it with the contents
5557	of the root filesystem pointed to by the
5558	<filename>-r</filename> command-line option
5559	or the equivalent rootfs derived from the
5560	<filename>-e</filename> command-line
5561	option.
5562	The filesystem type used to create the
5563	partition is driven by the value of the
5564	<filename>--fstype</filename> option
5565	specified for the partition.
5566	See the entry on
5567	<filename>--fstype</filename> that
5568	follows for more information.
5569	</para>
5570
5571	<para>If you use
5572	<filename>--source <replaceable>plugin-name</replaceable></filename>,
5573	Wic creates a partition as
5574	large as needed and fills it with the contents
5575	of the partition that is generated by the
5576	specified plug-in name using the data pointed
5577	to by the <filename>-r</filename> command-line
5578	option or the equivalent rootfs derived from the
5579	<filename>-e</filename> command-line
5580	option.
5581	Exactly what those contents and filesystem type
5582	end up being are dependent on the given plug-in
5583	implementation.
5584	</para>
5585
5586	<para>If you do not use the
5587	<filename>--source</filename> option, the
5588	<filename>wic</filename> command creates an
5589	empty partition.
5590	Consequently, you must use the
5591	<filename>--size</filename> option to specify
5592	the size of the empty partition.
5593	</para></listitem>
5594	<listitem><para>
5595	<emphasis><filename>--ondisk</filename> or <filename>--ondrive</filename>:</emphasis>
5596	Forces the partition to be created on a
5597	particular disk.
5598	</para></listitem>
5599	<listitem><para>
5600	<emphasis><filename>--fstype</filename>:</emphasis>
5601	Sets the file system type for the partition.
5602	Valid values are:
5603	<itemizedlist>
5604	<listitem><para>
5605	<filename>ext4</filename>
5606	</para></listitem>
5607	<listitem><para>
5608	<filename>ext3</filename>
5609	</para></listitem>
5610	<listitem><para>
5611	<filename>ext2</filename>
5612	</para></listitem>
5613	<listitem><para>
5614	<filename>btrfs</filename>
5615	</para></listitem>
5616	<listitem><para>
5617	<filename>squashfs</filename>
5618	</para></listitem>
5619	<listitem><para>
5620	<filename>swap</filename>
5621	</para></listitem>
5622	</itemizedlist>
5623	</para></listitem>
5624	<listitem><para>
5625	<emphasis><filename>--fsoptions</filename>:</emphasis>
5626	Specifies a free-form string of options to be
5627	used when mounting the filesystem.
5628	This string will be copied into the
5629	<filename>/etc/fstab</filename> file of the
5630	installed system and should be enclosed in
5631	quotes.
5632	If not specified, the default string
5633	is "defaults".
5634	</para></listitem>
5635	<listitem><para>
5636	<emphasis><filename>--label label</filename>:</emphasis>
5637	Specifies the label to give to the filesystem to
5638	be made on the partition.
5639	If the given label is already in use by another
5640	filesystem, a new label is created for the
5641	partition.
5642	</para></listitem>
5643	<listitem><para>
5644	<emphasis><filename>--active</filename>:</emphasis>
5645	Marks the partition as active.
5646	</para></listitem>
5647	<listitem><para>
5648	<emphasis><filename>--align (in KBytes)</filename>:</emphasis>
5649	This option is a
5650	Wic-specific option that
5651	says to start a partition on an
5652	<replaceable>x</replaceable> KBytes
5653	boundary.</para></listitem>
5654	<listitem><para>
5655	<emphasis><filename>--no-table</filename>:</emphasis>
5656	This option is a
5657	Wic-specific option.
5658	Using the option reserves space for the
5659	partition and causes it to become populated.
5660	However, the partition is not added to the
5661	partition table.
5662	</para></listitem>
5663	<listitem><para>
5664	<emphasis><filename>--extra-space</filename>:</emphasis>
5665	This option is a
5666	Wic-specific option that
5667	adds extra space after the space filled by the
5668	content of the partition.
5669	The final size can go beyond the size specified
5670	by the <filename>--size</filename> option.
5671	The default value is 10 Mbytes.
5672	</para></listitem>
5673	<listitem><para>
5674	<emphasis><filename>--overhead-factor</filename>:</emphasis>
5675	This option is a
5676	Wic-specific option that
5677	multiplies the size of the partition by the
5678	option's value.
5679	You must supply a value greater than or equal to
5680	"1".
5681	The default value is "1.3".
5682	</para></listitem>
5683	<listitem><para>
5684	<emphasis><filename>--part-type</filename>:</emphasis>
5685	This option is a
5686	Wic-specific option that
5687	specifies the partition type globally
5688	unique identifier (GUID) for GPT partitions.
5689	You can find the list of partition type GUIDs
5690	at
5691	<ulink url='http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs'></ulink>.
5692	</para></listitem>
5693	<listitem><para>
5694	<emphasis><filename>--use-uuid</filename>:</emphasis>
5695	This option is a
5696	Wic-specific option that
5697	causes Wic to generate a
5698	random GUID for the partition.
5699	The generated identifier is used in the
5700	bootloader configuration to specify the root
5701	partition.
5702	</para></listitem>
5703	<listitem><para>
5704	<emphasis><filename>--uuid</filename>:</emphasis>
5705	This option is a
5706	Wic-specific
5707	option that specifies the partition UUID.
5708	</para></listitem>
5709	</itemizedlist>
5710	</para>
5711	</section>
5712
5713	<section id='command-bootloader'>
5714	<title>Command: bootloader</title>
5715
5716	<para>
5717	This command specifies how the bootloader should be
5718	configured and supports the following options:
5719	<note>
5720	Bootloader functionality and boot partitions are
5721	implemented by the various
5722	<filename>--source</filename>
5723	plug-ins that implement bootloader functionality.
5724	The bootloader command essentially provides a
5725	means of modifying bootloader configuration.
5726	</note>
5727	<itemizedlist>
5728	<listitem><para>
5729	<emphasis><filename>--timeout</filename>:</emphasis>
5730	Specifies the number of seconds before the
5731	bootloader times out and boots the default
5732	option.
5733	</para></listitem>
5734	<listitem><para>
5735	<emphasis><filename>--append</filename>:</emphasis>
5736	Specifies kernel parameters.
5737	These parameters will be added to the syslinux
5738	<filename>APPEND</filename> or
5739	<filename>grub</filename> kernel command line.
5740	</para></listitem>
5741	<listitem><para>
5742	<emphasis><filename>--configfile</filename>:</emphasis>
5743	Specifies a user-defined configuration file for
5744	the bootloader.
5745	You can provide a full pathname for the file or
5746	a file that exists in the
5747	<filename>canned-wks</filename> folder.
5748	This option overrides all other bootloader
5749	options.
5750	</para></listitem>
5751	</itemizedlist>
5752	</para>
5753	</section>
5754	</section>
5755	</section>	5442	</section>
5756		5443
5757	<section id='building-an-initramfs-image'>	5444	<section id='building-an-initramfs-image'>