Bug 7940

Summary: wic help is incomplete
Product: [Build System, Metadata & Runtime] OE-Core Reporter: Igor Stoppa <igor.stoppa>
Component: devtools / tool chainAssignee: Ed Bartosh <eduard.bartosh>
Status: VERIFIED FIXED QA Contact: Daniel Istrate <daniel.alexandrux.istrate>
Severity: minor    
Priority: Medium CC: bogdanx.a.voiculescu, meta.mr.watcher, meta.watcher
Version: unspecified   
Target Milestone: 1.9   
Hardware: x86   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Don't know

Description Igor Stoppa 2015-07-01 13:41:06 UTC 
When running "wic help overview", among various other examples, the help shows how to specify manually on the command line various parameters and a non-canned wks file, but it doesn't show the content of the custom .wks file used.


The text starts with "Here's an example that doesn't take the easy way out ..."

It would seem appropriate to provide also the content of the ~/test.wks file referred by the example, as it is not a canned one.
Comment 1 Ed Bartosh 2015-07-21 10:15:41 UTC 
I'm going to change help to this:


Here's an example that doesn't take the easy way out and manually
    specifies each build artifact, along with a non-canned .wks file,
    and also uses the -o option to have wic create the output
    somewhere other than the default /var/tmp/wic:

      $ wic create ./test.wks -o ./out -r tmp/work/qemux86_64-poky-linux/core-image-minimal/1.0-r0/rootfs -b tmp/sysroots/qemux86-64/usr/share -k tmp/deploy/images/qemux86-64 -n tmp/sysroots/x86_64-linux -o 

Creating image(s)...

Info: The new image(s) can be found here:
  out/build/test-201507211313-sda.direct

The following build artifacts were used to create the image(s):
  ROOTFS_DIR:                   tmp/work/qemux86_64-poky-linux/core-image-minimal/1.0-r0/rootfs
  BOOTIMG_DIR:                  tmp/sysroots/qemux86-64/usr/share
  KERNEL_DIR:                   tmp/deploy/images/qemux86-64
  NATIVE_SYSROOT:               tmp/sysroots/x86_64-linux

The image(s) were created using OE kickstart file:
  ./test.wks

Here is a content of test.wks:

part /boot --source bootimg-pcbios --ondisk sda --label boot --active --align 1024
part / --source rootfs --ondisk sda --fstype=ext3 --label platform --align 1024

bootloader  --timeout=0  --append="rootwait rootfstype=ext3 video=vesafb vga=0x318 console=tty0"


Igor, please confirm it's ok for you.
Comment 2 Ed Bartosh 2015-08-03 13:57:19 UTC 
Submitted fix for review: http://lists.openembedded.org/pipermail/openembedded-core/2015-August/108258.html
Comment 4 Daniel Istrate 2015-09-09 14:37:01 UTC 
Verified on master: c1df471feacaf2590216aa476ce242908dac38cf