summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2017-10-11 15:57:19 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-10-16 23:46:52 +0100
commitcbe8009a1779977a51d153c90c5b6e89fdbace99 (patch)
tree1a85432e3eeacf6ff91cf63c8ede5360d9c52624 /documentation/dev-manual
parent6077ebbe806bb232e3d96b0f138e1f4748e5ef5b (diff)
downloadpoky-cbe8009a1779977a51d153c90c5b6e89fdbace99.tar.gz
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>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml319
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 @@
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'>