summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-04-19 12:57:23 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-05-24 17:17:55 +0100
commit965c92d0a20af731c5ff0ca21299446998d8b9f8 (patch)
tree9955dadd0e26abb182544c29364bd8eacb5fb8e8 /documentation/dev-manual
parentce451add356771f41f5be5c55297696ee0e6367f (diff)
downloadpoky-965c92d0a20af731c5ff0ca21299446998d8b9f8.tar.gz
dev-manual: Updated Wic example
I updated the first example in the section telling how to build out a Wic image. I could not get the example to run so I used Stephano's output. (From yocto-docs rev: 6b4595215d6c24e3efb89288a7547f79ca3e59b7) 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.xml50
1 files changed, 24 insertions, 26 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 3c96cffc0a..f1a1966180 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -6615,11 +6615,9 @@
6615 <section id='generate-an-image-using-a-provided-kickstart-file'> 6615 <section id='generate-an-image-using-a-provided-kickstart-file'>
6616 <title>Generate an Image using an Existing Kickstart File</title> 6616 <title>Generate an Image using an Existing Kickstart File</title>
6617 6617
6618 <para role='writernotes'> 6618 <para>
6619 This example runs in Cooked Mode and uses the 6619 This example runs in Cooked Mode and uses the
6620 <filename>mkefidisk</filename> kickstart file: 6620 <filename>mkefidisk</filename> kickstart file:
6621 [OUTPUT IS WRONG DUE TO A BUG - ROOTFS_DIR AND BOOTIMG_DIR
6622 ARE DISPLAYING TEMPORARY FILES THAT WIC CLEANS UP BY DELETING]
6623 <literallayout class='monospaced'> 6621 <literallayout class='monospaced'>
6624 $ wic create mkefidisk -e core-image-minimal 6622 $ wic create mkefidisk -e core-image-minimal
6625 INFO: Building wic-tools... 6623 INFO: Building wic-tools...
@@ -6627,16 +6625,16 @@
6627 . 6625 .
6628 . 6626 .
6629 INFO: The new image(s) can be found here: 6627 INFO: The new image(s) can be found here:
6630 ./mkefidisk-201802211426-sda.direct 6628 ./mkefidisk-201804191017-sda.direct
6631 6629
6632 The following build artifacts were used to create the image(s): 6630 The following build artifacts were used to create the image(s):
6633 ROOTFS_DIR: /home/scottrif/poky/build/tmp.wic.zjs_iw41/rootfs_copy 6631 ROOTFS_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs
6634 BOOTIMG_DIR: /home/scottrif/poky/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share 6632 BOOTIMG_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share
6635 KERNEL_DIR: /home/scottrif/poky/build/tmp/deploy/images/qemux86 6633 KERNEL_DIR: /home/stephano/build/master/build/tmp-glibc/deploy/images/qemux86
6636 NATIVE_SYSROOT: /home/scottrif/poky/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native 6634 NATIVE_SYSROOT: /home/stephano/build/master/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native
6637 6635
6638 INFO: The image(s) were created using OE kickstart file: 6636 INFO: The image(s) were created using OE kickstart file:
6639 /home/scottrif/poky/scripts/lib/wic/canned-wks/mkefidisk.wks 6637 /home/stephano/build/master/openembedded-core/scripts/lib/wic/canned-wks/mkefidisk.wks
6640 </literallayout> 6638 </literallayout>
6641 The previous example shows the easiest way to create 6639 The previous example shows the easiest way to create
6642 an image by running in cooked mode and supplying 6640 an image by running in cooked mode and supplying
@@ -6668,11 +6666,11 @@
6668 <filename>bmaptool</filename> or 6666 <filename>bmaptool</filename> or
6669 <filename>dd</filename>: 6667 <filename>dd</filename>:
6670 <literallayout class='monospaced'> 6668 <literallayout class='monospaced'>
6671 $ oe-run-native bmaptool copy mkefidisk-201802211426-sda.direct /dev/sd<replaceable>X</replaceable> 6669 $ oe-run-native bmaptool copy mkefidisk-201804191017-sda.direct /dev/sd<replaceable>X</replaceable>
6672 </literallayout> 6670 </literallayout>
6673 or 6671 or
6674 <literallayout class='monospaced'> 6672 <literallayout class='monospaced'>
6675 $ sudo dd if=mkefidisk-201802211426-sda.direct of=/dev/sd<replaceable>X</replaceable> 6673 $ sudo dd if=mkefidisk-201804191017-sda.direct of=/dev/sd<replaceable>X</replaceable>
6676 </literallayout> 6674 </literallayout>
6677 <note> 6675 <note>
6678 For more information on how to use the 6676 For more information on how to use the
@@ -6732,8 +6730,8 @@
6732 directory and then by changing the lines that specify 6730 directory and then by changing the lines that specify
6733 the target disk from which to boot. 6731 the target disk from which to boot.
6734 <literallayout class='monospaced'> 6732 <literallayout class='monospaced'>
6735 $ cp /home/scottrif/poky/scripts/lib/wic/canned-wks/directdisk-gpt.wks \ 6733 $ cp /home/stephano/poky/scripts/lib/wic/canned-wks/directdisk-gpt.wks \
6736 /home/scottrif/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks 6734 /home/stephano/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks
6737 </literallayout> 6735 </literallayout>
6738 Next, the example modifies the 6736 Next, the example modifies the
6739 <filename>directdisksdb-gpt.wks</filename> file and 6737 <filename>directdisksdb-gpt.wks</filename> file and
@@ -6769,13 +6767,13 @@
6769 ./directdisksdb-gpt-201710090938-sdb.direct 6767 ./directdisksdb-gpt-201710090938-sdb.direct
6770 6768
6771 The following build artifacts were used to create the image(s): 6769 The following build artifacts were used to create the image(s):
6772 ROOTFS_DIR: /home/scottrif/poky/build/tmp.wic.hk3wl6zn/rootfs_copy 6770 ROOTFS_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs
6773 BOOTIMG_DIR: /home/scottrif/poky/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share 6771 BOOTIMG_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share
6774 KERNEL_DIR: /home/scottrif/poky/build/tmp/deploy/images/qemux86 6772 KERNEL_DIR: /home/stephano/build/master/build/tmp-glibc/deploy/images/qemux86
6775 NATIVE_SYSROOT: /home/scottrif/poky/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native 6773 NATIVE_SYSROOT: /home/stephano/build/master/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native
6776 6774
6777 INFO: The image(s) were created using OE kickstart file: 6775 INFO: The image(s) were created using OE kickstart file:
6778 /home/scottrif/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks 6776 /home/stephano/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks
6779 </literallayout> 6777 </literallayout>
6780 Continuing with the example, you can now directly 6778 Continuing with the example, you can now directly
6781 <filename>dd</filename> the image to a USB stick, or 6779 <filename>dd</filename> the image to a USB stick, or
@@ -6803,10 +6801,10 @@
6803 which is the current directory: 6801 which is the current directory:
6804 <literallayout class='monospaced'> 6802 <literallayout class='monospaced'>
6805 $ wic create /home/scottrif/my_yocto/test.wks -o /home/scottrif/testwic \ 6803 $ wic create /home/scottrif/my_yocto/test.wks -o /home/scottrif/testwic \
6806 --rootfs-dir /home/scottrif/poky/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/rootfs \ 6804 --rootfs-dir /home/stephano/build/master/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/rootfs \
6807 --bootimg-dir /home/scottrif/poky/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share \ 6805 --bootimg-dir /home/stephano/build/master/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share \
6808 --kernel-dir /home/scottrif/poky/build/tmp/deploy/images/qemux86 \ 6806 --kernel-dir /home/stephano/build/master/build/tmp/deploy/images/qemux86 \
6809 --native-sysroot /home/scottrif/poky/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native 6807 --native-sysroot /home/stephano/build/master/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native
6810 6808
6811 INFO: Creating image(s)... 6809 INFO: Creating image(s)...
6812 6810
@@ -6814,10 +6812,10 @@
6814 /home/scottrif/testwic/test-201710091445-sdb.direct 6812 /home/scottrif/testwic/test-201710091445-sdb.direct
6815 6813
6816 The following build artifacts were used to create the image(s): 6814 The following build artifacts were used to create the image(s):
6817 ROOTFS_DIR: /home/scottrif/testwic/tmp.wic.x4wipbmb/rootfs_copy 6815 ROOTFS_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs
6818 BOOTIMG_DIR: /home/scottrif/poky/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share 6816 BOOTIMG_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share
6819 KERNEL_DIR: /home/scottrif/poky/build/tmp/deploy/images/qemux86 6817 KERNEL_DIR: /home/stephano/build/master/build/tmp-glibc/deploy/images/qemux86
6820 NATIVE_SYSROOT: /home/scottrif/poky/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native 6818 NATIVE_SYSROOT: /home/stephano/build/master/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native
6821 6819
6822 INFO: The image(s) were created using OE kickstart file: 6820 INFO: The image(s) were created using OE kickstart file:
6823 /home/scottrif/my_yocto/test.wks 6821 /home/scottrif/my_yocto/test.wks