Return-Path: Received: by yocto-www.yoctoproject.org (Postfix, from userid 118) id 57B00E009FA; Thu, 8 Dec 2016 05:03:07 -0800 (PST) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on yocto-www.yoctoproject.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.1 X-Spam-HAM-Report: * -0.7 RCVD_IN_DNSWL_LOW RBL: Sender listed at http://www.dnswl.org/, low * trust * [134.134.136.20 listed in list.dnswl.org] * -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% * [score: 0.0000] Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by yocto-www.yoctoproject.org (Postfix) with ESMTP id C2974E007E8 for ; Thu, 8 Dec 2016 05:03:01 -0800 (PST) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga101.jf.intel.com with ESMTP; 08 Dec 2016 05:03:01 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.33,319,1477983600"; d="scan'208";a="15396876" Received: from linux.intel.com ([10.54.29.200]) by orsmga002.jf.intel.com with ESMTP; 08 Dec 2016 05:03:00 -0800 Received: from vmed.fi.intel.com (vmed.fi.intel.com [10.237.72.38]) by linux.intel.com (Postfix) with ESMTP id 9EC306A4080; Thu, 8 Dec 2016 05:02:13 -0800 (PST) From: Ed Bartosh To: yocto@yoctoproject.org Date: Thu, 8 Dec 2016 15:01:46 +0200 Message-Id: <1481202106-13933-1-git-send-email-ed.bartosh@linux.intel.com> X-Mailer: git-send-email 2.1.4 Cc: scott.m.rifenbark@intel.com Subject: [PATCH] dev-manual: describe creation of wic images by oe build system X-BeenThere: yocto@yoctoproject.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: Discussion of all things Yocto Project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Dec 2016 13:03:07 -0000 Explained creation of wic partitioned images using oe build system. This way is preferable as it's more natural and easier to use and understand than currently documented way of using wic as a stand-alone tool. Signed-off-by: Ed Bartosh --- .../dev-manual/dev-manual-common-tasks.xml | 1840 ++++++++++---------- 1 file changed, 932 insertions(+), 908 deletions(-) diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 2c95ecb..6d0e018 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -4366,1014 +4366,1038 @@ Should your device require multiple partitions on an SD card, flash, or an HDD, you can use the OpenEmbedded Image Creator, wic, to create the properly partitioned image. - - - - The wic command generates partitioned images - from existing OpenEmbedded build artifacts. - Image generation is driven by partitioning commands contained - in an Openembedded kickstart file (.wks) - specified either directly on the command line or as one of a - selection of canned .wks files as shown - with the wic list images command in the - "Using an Existing Kickstart File" - section. - When applied to a given set of build artifacts, the result is an - image or set of images that can be directly written onto media and - used on a particular system. - + - - The wic command and the infrastructure - it is based on is by definition incomplete. - Its purpose is to allow the generation of customized images, - and as such was designed to be completely extensible through a - plug-in interface. - See the - "Plug-ins" - section for information on these plug-ins. - - - - This section provides some background information on - wic, describes what you need to have in - place to run the tool, provides instruction on how to use - wic, and provides several examples. + + wic images can be generated two ways: by OpenEmbedded + build system and by running OpenEmbedded Image Creator wic + directly. Former way is preferable as it's easier to use and understand. -
- Background - +
+ Creating partitioned images by OpenEmbedded build system - This section provides some background on the - wic utility. - While none of this information is required to use - wic, you might find it interesting. - - - The name "wic" is derived from OpenEmbedded - Image Creator (oeic). - The "oe" diphthong in "oeic" was promoted to the - letter "w", because "oeic" is both difficult to remember and - pronounce. - - wic is loosely based on the - Meego Image Creator (mic) - framework. - The wic implementation has been - heavily modified to make direct use of OpenEmbedded - build artifacts instead of package installation and - configuration, which are already incorporated within - the OpenEmbedded artifacts. - - wic is a completely independent - standalone utility that initially provides - easier-to-use and more flexible replacements for a - couple bits of existing functionality in OE Core's - image-live - class and mkefidisk.sh script. - The difference between - wic and those examples is - that with wic the - functionality of those scripts is implemented - by a general-purpose partitioning language, which is - based on Redhat kickstart syntax. - + OpenEmbedded build system can generate wic images the same way + as any other image type. To generate wic image 2 variables should be modified: + IMAGE_FSTYPES + should include 'wic' and + WKS_FILE + variable should contain the name of + "wic kickstart file + file. Further steps to generate an image are the same as for other image types. They're + described in "Building Images" section.
-
- Requirements - - - In order to use the wic utility - with the OpenEmbedded Build system, your system needs - to meet the following requirements: - - The Linux distribution on your - development host must support the Yocto Project. - See the - "Supported Linux Distributions" - section in the Yocto Project Reference Manual for this - list of distributions. - - The standard system utilities, such as - cp, must be installed on your - development host system. - - - You need to have the build artifacts already - available, which typically means that you must - have already created an image using the - Openembedded build system (e.g. - core-image-minimal). - While it might seem redundant to generate an image in - order to create an image using - wic, the current version of - wic requires the artifacts - in the form generated by the build system. - - - You must build several native tools, which are tools - built to run on the build system: - - $ bitbake parted-native dosfstools-native mtools-native - - - - You must have sourced one of the build environment - setup scripts (i.e. - &OE_INIT_FILE; - or - oe-init-build-env-memres) - found in the - Build Directory. - - - -
- -
- Getting Help - - - You can get general help for the wic - by entering the wic command by itself - or by entering the command with a help argument as follows: - - $ wic -h - $ wic --help - - - - - Currently, wic supports two commands: - create and list. - You can get help for these commands as follows: - - $ wic help command - - +
+ Generating partitioned images by OpenEmbedded Image Creator <filename>wic</filename> + + The wic command generates partitioned images + from existing OpenEmbedded build artifacts. + Image generation is driven by partitioning commands contained + in an Openembedded kickstart file (.wks) + specified either directly on the command line or as one of a + selection of canned .wks files as shown + with the wic list images command in the + "Using an Existing Kickstart File" + section. + When applied to a given set of build artifacts, the result is an + image or set of images that can be directly written onto media and + used on a particular system. + - - You can also get detailed help on a number of topics - from the help system. - The output of wic --help - displays a list of available help - topics under a "Help topics" heading. - You can have the help system display the help text for - a given topic by prefacing the topic with - wic help: - - $ wic help help_topic - - + + The wic command and the infrastructure + it is based on is by definition incomplete. + Its purpose is to allow the generation of customized images, + and as such was designed to be completely extensible through a + plug-in interface. + See the + "Plug-ins" + section for information on these plug-ins. + - - You can find out more about the images - wic creates using the existing - kickstart files with the following form of the command: - - $ wic list image help - - where image is either - directdisk or - mkefidisk. - -
+ + This section provides some background information on + wic, describes what you need to have in + place to run the tool, provides instruction on how to use + wic, and provides several examples. + -
- Operational Modes +
+ Background - - You can use wic in two different - modes, depending on how much control you need for - specifying the Openembedded build artifacts that are - used for creating the image: Raw and Cooked: - - Raw Mode: - You explicitly specify build artifacts through - command-line arguments. - Cooked Mode: - The current - MACHINE - setting and image name are used to automatically locate - and provide the build artifacts. - - + + This section provides some background on the + wic utility. + While none of this information is required to use + wic, you might find it interesting. + + + The name "wic" is derived from OpenEmbedded + Image Creator (oeic). + The "oe" diphthong in "oeic" was promoted to the + letter "w", because "oeic" is both difficult to remember and + pronounce. + + wic is loosely based on the + Meego Image Creator (mic) + framework. + The wic implementation has been + heavily modified to make direct use of OpenEmbedded + build artifacts instead of package installation and + configuration, which are already incorporated within + the OpenEmbedded artifacts. + + wic is a completely independent + standalone utility that initially provides + easier-to-use and more flexible replacements for a + couple bits of existing functionality in OE Core's + image-live + class and mkefidisk.sh script. + The difference between + wic and those examples is + that with wic the + functionality of those scripts is implemented + by a general-purpose partitioning language, which is + based on Redhat kickstart syntax. + + +
- - Regardless of the mode you use, you need to have the build - artifacts ready and available. - Additionally, the environment must be set up using the - &OE_INIT_FILE; - or - oe-init-build-env-memres - script found in the - Build Directory. - +
+ Requirements -
- Raw Mode + + In order to use the wic utility + with the OpenEmbedded Build system, your system needs + to meet the following requirements: + + The Linux distribution on your + development host must support the Yocto Project. + See the + "Supported Linux Distributions" + section in the Yocto Project Reference Manual for this + list of distributions. + + The standard system utilities, such as + cp, must be installed on your + development host system. + + + You need to have the build artifacts already + available, which typically means that you must + have already created an image using the + Openembedded build system (e.g. + core-image-minimal). + While it might seem redundant to generate an image in + order to create an image using + wic, the current version of + wic requires the artifacts + in the form generated by the build system. + + + You must build several native tools, which are tools + built to run on the build system: + + $ bitbake parted-native dosfstools-native mtools-native + + + + You must have sourced one of the build environment + setup scripts (i.e. + &OE_INIT_FILE; + or + oe-init-build-env-memres) + found in the + Build Directory. + + + +
- - The general form of the 'wic' command in raw mode is: - - $ wic create image_name.wks [options] [...] +
+ Getting Help - Where: + + You can get general help for the wic + by entering the wic command by itself + or by entering the command with a help argument as follows: + + $ wic -h + $ wic --help + + - image_name.wks - An OpenEmbedded kickstart file. You can provide - your own custom file or use a file from a set of - existing files as described by further options. + + Currently, wic supports two commands: + create and list. + You can get help for these commands as follows: + + $ wic help command + + - -o OUTDIR, --outdir=OUTDIR - The name of a directory in which to create image. + + You can also get detailed help on a number of topics + from the help system. + The output of wic --help + displays a list of available help + topics under a "Help topics" heading. + You can have the help system display the help text for + a given topic by prefacing the topic with + wic help: + + $ wic help help_topic + + - -i PROPERTIES_FILE, --infile=PROPERTIES_FILE - The name of a file containing the values for image - properties as a JSON file. + + You can find out more about the images + wic creates using the existing + kickstart files with the following form of the command: + + $ wic list image help + + where image is either + directdisk or + mkefidisk. + +
- -e IMAGE_NAME, --image-name=IMAGE_NAME - The name of the image from which to use the artifacts - (e.g. core-image-sato). +
+ Operational Modes - -r ROOTFS_DIR, --rootfs-dir=ROOTFS_DIR - The path to the /rootfs directory to use as the - .wks rootfs source. + + You can use wic in two different + modes, depending on how much control you need for + specifying the Openembedded build artifacts that are + used for creating the image: Raw and Cooked: + + Raw Mode: + You explicitly specify build artifacts through + command-line arguments. + Cooked Mode: + The current + MACHINE + setting and image name are used to automatically locate + and provide the build artifacts. + + - -b BOOTIMG_DIR, --bootimg-dir=BOOTIMG_DIR - The path to the directory containing the boot artifacts - (e.g. /EFI or /syslinux) to use as the .wks bootimg - source. + + Regardless of the mode you use, you need to have the build + artifacts ready and available. + Additionally, the environment must be set up using the + &OE_INIT_FILE; + or + oe-init-build-env-memres + script found in the + Build Directory. + - -k KERNEL_DIR, --kernel-dir=KERNEL_DIR - The path to the directory containing the kernel to use - in the .wks boot image. +
+ Raw Mode - -n NATIVE_SYSROOT, --native-sysroot=NATIVE_SYSROOT - The path to the native sysroot containing the tools to use - to build the image. + + The general form of the 'wic' command in raw mode is: + + $ wic create image_name.wks [options] [...] - -s, --skip-build-check - Skips the build check. + Where: - -D, --debug - Output debug information. - - - You do not need root privileges to run - wic. - In fact, you should not run as root when using the - utility. - - -
+ image_name.wks + An OpenEmbedded kickstart file. You can provide + your own custom file or use a file from a set of + existing files as described by further options. -
- Cooked Mode + -o OUTDIR, --outdir=OUTDIR + The name of a directory in which to create image. - - The general form of the wic command - using Cooked Mode is: - - $ wic create kickstart_file -e image_name + -i PROPERTIES_FILE, --infile=PROPERTIES_FILE + The name of a file containing the values for image + properties as a JSON file. - Where: + -e IMAGE_NAME, --image-name=IMAGE_NAME + The name of the image from which to use the artifacts + (e.g. core-image-sato). - kickstart_file - An OpenEmbedded kickstart file. You can provide your own - custom file or supplied file. + -r ROOTFS_DIR, --rootfs-dir=ROOTFS_DIR + The path to the /rootfs directory to use as the + .wks rootfs source. - image_name - Specifies the image built using the OpenEmbedded build - system. - - This form is the simplest and most user-friendly, as it - does not require specifying all individual parameters. - All you need to provide is your own - .wks file or one provided with the - release. - -
-
+ -b BOOTIMG_DIR, --bootimg-dir=BOOTIMG_DIR + The path to the directory containing the boot artifacts + (e.g. /EFI or /syslinux) to use as the .wks bootimg + source. -
- Using an Existing Kickstart File + -k KERNEL_DIR, --kernel-dir=KERNEL_DIR + The path to the directory containing the kernel to use + in the .wks boot image. - - If you do not want to create your own - .wks file, you can use an existing - file provided by the wic installation. - Use the following command to list the available files: - - $ wic list images - directdisk Create a 'pcbios' direct disk image - mkefidisk Create an EFI disk image - - When you use an existing file, you do not have to use the - .wks extension. - Here is an example in Raw Mode that uses the - directdisk file: - - $ wic create directdisk -r rootfs_dir -b bootimg_dir \ - -k kernel_dir -n native_sysroot - - + -n NATIVE_SYSROOT, --native-sysroot=NATIVE_SYSROOT + The path to the native sysroot containing the tools to use + to build the image. - - Here are the actual partition language commands - used in the mkefidisk.wks file to generate - an image: - - # short-description: Create an EFI disk image - # long-description: Creates a partitioned EFI disk image that the user - # can directly dd to boot media. + -s, --skip-build-check + Skips the build check. - part /boot --source bootimg-efi --ondisk sda --label msdos --active --align 1024 + -D, --debug + Output debug information. + + + You do not need root privileges to run + wic. + In fact, you should not run as root when using the + utility. + + +
- part / --source rootfs --ondisk sda --fstype=ext3 --label platform --align 1024 +
+ Cooked Mode - part swap --ondisk sda --size 44 --label swap1 --fstype=swap + + The general form of the wic command + using Cooked Mode is: + + $ wic create kickstart_file -e image_name - bootloader --timeout=10 --append="rootwait rootfstype=ext3 console=ttyPCH0,115200 console=tty0 vmalloc=256MB snd-hda-intel.enable_msi=0" - - -
+ Where: -
- Examples + kickstart_file + An OpenEmbedded kickstart file. You can provide your own + custom file or supplied file. - - This section provides several examples that show how to use - the wic utility. - All the examples assume the list of requirements in the - "Requirements" section - have been met. - The examples assume the previously generated image is - core-image-minimal. - + image_name + Specifies the image built using the OpenEmbedded build + system. + + This form is the simplest and most user-friendly, as it + does not require specifying all individual parameters. + All you need to provide is your own + .wks file or one provided with the + release. + +
+
-
- Generate an Image using an Existing Kickstart File +
+ Using an Existing Kickstart File - - This example runs in Cooked Mode and uses the - mkefidisk kickstart file: - - $ wic create mkefidisk -e core-image-minimal - Checking basic build environment... - Done. + + If you do not want to create your own + .wks file, you can use an existing + file provided by the wic installation. + Use the following command to list the available files: + + $ wic list images + directdisk Create a 'pcbios' direct disk image + mkefidisk Create an EFI disk image + + When you use an existing file, you do not have to use the + .wks extension. + Here is an example in Raw Mode that uses the + directdisk file: + + $ wic create directdisk -r rootfs_dir -b bootimg_dir \ + -k kernel_dir -n native_sysroot + + - Creating image(s)... + + Here are the actual partition language commands + used in the mkefidisk.wks file to generate + an image: + + # short-description: Create an EFI disk image + # long-description: Creates a partitioned EFI disk image that the user + # can directly dd to boot media. - Info: The new image(s) can be found here: - /var/tmp/wic/build/mkefidisk-201310230946-sda.direct + part /boot --source bootimg-efi --ondisk sda --label msdos --active --align 1024 - The following build artifacts were used to create the image(s): - ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/minnow-poky-linux/core-image-minimal/1.0-r0/rootfs - BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/work/minnow-poky-linux/core-image-minimal/1.0-r0/core-image-minimal-1.0/hddimg - KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/minnow/usr/src/kernel - NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux + part / --source rootfs --ondisk sda --fstype=ext3 --label platform --align 1024 + part swap --ondisk sda --size 44 --label swap1 --fstype=swap - The image(s) were created using OE kickstart file: - /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/mkefidisk.wks - - This example shows the easiest way to create an image - by running in Cooked Mode and using the - -e option with an existing kickstart - file. - All that is necessary is to specify the image used to - generate the artifacts. - Your local.conf needs to have the - MACHINE - variable set to the machine you are using, which is - "minnow" in this example. - + bootloader --timeout=10 --append="rootwait rootfstype=ext3 console=ttyPCH0,115200 console=tty0 vmalloc=256MB snd-hda-intel.enable_msi=0" + + +
- - The output specifies the exact image created as well as - where it was created. - The output also names the artifacts used and the exact - .wks script that was used to generate - the image. - - You should always verify the details provided in the - output to make sure that the image was indeed created - exactly as expected. - - +
+ Examples - - Continuing with the example, you can now directly - dd the image to a USB stick, or - whatever media for which you built your image, - and boot the resulting media: - - $ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdb - [sudo] password for trz: - 182274+0 records in - 182274+0 records out - 93324288 bytes (93 MB) copied, 14.4777 s, 6.4 MB/s - [trz@empanada ~]$ sudo eject /dev/sdb - - -
+ + This section provides several examples that show how to use + the wic utility. + All the examples assume the list of requirements in the + "Requirements" section + have been met. + The examples assume the previously generated image is + core-image-minimal. + -
- Using a Modified Kickstart File +
+ Generate an Image using an Existing Kickstart File - - Because wic image creation is driven - by the kickstart file, it is easy to affect image creation - by changing the parameters in the file. - This next example demonstrates that through modification - of the directdisk kickstart file. - + + This example runs in Cooked Mode and uses the + mkefidisk kickstart file: + + $ wic create mkefidisk -e core-image-minimal + Checking basic build environment... + Done. - - As mentioned earlier, you can use the command - wic list images to show the list - of existing kickstart files. - The directory in which these files reside is - scripts/lib/image/canned-wks/ - located in the - Source Directory. - Because the available files reside in this directory, you - can create and add your own custom files to the directory. - Subsequent use of the wic list images - command would then include your kickstart files. - + Creating image(s)... - - In this example, the existing - directdisk file already does most - of what is needed. - However, for the hardware in this example, the image will - need to boot from sdb instead of - sda, which is what the - directdisk kickstart file uses. - + Info: The new image(s) can be found here: + /var/tmp/wic/build/mkefidisk-201310230946-sda.direct - - The example begins by making a copy of the - directdisk.wks file in the - scripts/lib/image/canned-wks - directory and then changing the lines that specify the - target disk from which to boot. - - $ cp /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisk.wks \ - /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisksdb.wks - - Next, the example modifies the - directdisksdb.wks file and changes all - instances of "--ondisk sda" - to "--ondisk sdb". - The example changes the following two lines and leaves the - remaining lines untouched: - - part /boot --source bootimg-pcbios --ondisk sdb --label boot --active --align 1024 - part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024 - - Once the lines are changed, the example generates the - directdisksdb image. - The command points the process at the - core-image-minimal artifacts for the - Next Unit of Computing (nuc) - MACHINE - the local.conf. - - $ wic create directdisksdb -e core-image-minimal - Checking basic build environment... - Done. + The following build artifacts were used to create the image(s): + ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/minnow-poky-linux/core-image-minimal/1.0-r0/rootfs + BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/work/minnow-poky-linux/core-image-minimal/1.0-r0/core-image-minimal-1.0/hddimg + KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/minnow/usr/src/kernel + NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux - Creating image(s)... - Info: The new image(s) can be found here: - /var/tmp/wic/build/directdisksdb-201310231131-sdb.direct + The image(s) were created using OE kickstart file: + /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/mkefidisk.wks + + This example shows the easiest way to create an image + by running in Cooked Mode and using the + -e option with an existing kickstart + file. + All that is necessary is to specify the image used to + generate the artifacts. + Your local.conf needs to have the + MACHINE + variable set to the machine you are using, which is + "minnow" in this example. + - The following build artifacts were used to create the image(s): - ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/nuc-poky-linux/core-image-minimal/1.0-r0/rootfs - BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/nuc/usr/share - KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/nuc/usr/src/kernel - NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux + + The output specifies the exact image created as well as + where it was created. + The output also names the artifacts used and the exact + .wks script that was used to generate + the image. + + You should always verify the details provided in the + output to make sure that the image was indeed created + exactly as expected. + + + + Continuing with the example, you can now directly + dd the image to a USB stick, or + whatever media for which you built your image, + and boot the resulting media: + + $ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdb + [sudo] password for trz: + 182274+0 records in + 182274+0 records out + 93324288 bytes (93 MB) copied, 14.4777 s, 6.4 MB/s + [trz@empanada ~]$ sudo eject /dev/sdb + + +
- The image(s) were created using OE kickstart file: - /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisksdb.wks - - Continuing with the example, you can now directly - dd the image to a USB stick, or - whatever media for which you built your image, - and boot the resulting media: - - $ sudo dd if=/var/tmp/wic/build/directdisksdb-201310231131-sdb.direct of=/dev/sdb - 86018+0 records in - 86018+0 records out - 44041216 bytes (44 MB) copied, 13.0734 s, 3.4 MB/s - [trz@empanada tmp]$ sudo eject /dev/sdb - - -
+
+ Using a Modified Kickstart File -
- Creating an Image Based on <filename>core-image-minimal</filename> and <filename>crownbay-noemgd</filename> + + Because wic image creation is driven + by the kickstart file, it is easy to affect image creation + by changing the parameters in the file. + This next example demonstrates that through modification + of the directdisk kickstart file. + - - This example creates an image based on - core-image-minimal and a - crownbay-noemgd - MACHINE - that works right out of the box. - - $ wic create directdisk -e core-image-minimal + + As mentioned earlier, you can use the command + wic list images to show the list + of existing kickstart files. + The directory in which these files reside is + scripts/lib/image/canned-wks/ + located in the + Source Directory. + Because the available files reside in this directory, you + can create and add your own custom files to the directory. + Subsequent use of the wic list images + command would then include your kickstart files. + - Checking basic build environment... - Done. + + In this example, the existing + directdisk file already does most + of what is needed. + However, for the hardware in this example, the image will + need to boot from sdb instead of + sda, which is what the + directdisk kickstart file uses. + - Creating image(s)... + + The example begins by making a copy of the + directdisk.wks file in the + scripts/lib/image/canned-wks + directory and then changing the lines that specify the + target disk from which to boot. + + $ cp /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisk.wks \ + /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisksdb.wks + + Next, the example modifies the + directdisksdb.wks file and changes all + instances of "--ondisk sda" + to "--ondisk sdb". + The example changes the following two lines and leaves the + remaining lines untouched: + + part /boot --source bootimg-pcbios --ondisk sdb --label boot --active --align 1024 + part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024 + + Once the lines are changed, the example generates the + directdisksdb image. + The command points the process at the + core-image-minimal artifacts for the + Next Unit of Computing (nuc) + MACHINE + the local.conf. + + $ wic create directdisksdb -e core-image-minimal + Checking basic build environment... + Done. - Info: The new image(s) can be found here: - /var/tmp/wic/build/directdisk-201309252350-sda.direct + Creating image(s)... - The following build artifacts were used to create the image(s): + Info: The new image(s) can be found here: + /var/tmp/wic/build/directdisksdb-201310231131-sdb.direct - ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs - BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share - KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel - NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel + The following build artifacts were used to create the image(s): + ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/nuc-poky-linux/core-image-minimal/1.0-r0/rootfs + BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/nuc/usr/share + KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/nuc/usr/src/kernel + NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux - The image(s) were created using OE kickstart file: - /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisk.wks - - -
-
- Using a Modified Kickstart File and Running in Raw Mode + The image(s) were created using OE kickstart file: + /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisksdb.wks + + Continuing with the example, you can now directly + dd the image to a USB stick, or + whatever media for which you built your image, + and boot the resulting media: + + $ sudo dd if=/var/tmp/wic/build/directdisksdb-201310231131-sdb.direct of=/dev/sdb + 86018+0 records in + 86018+0 records out + 44041216 bytes (44 MB) copied, 13.0734 s, 3.4 MB/s + [trz@empanada tmp]$ sudo eject /dev/sdb + + +
- - This next example manually specifies each build artifact - (runs in Raw Mode) and uses a modified kickstart file. - The example also uses the -o option - to cause wic to create the output - somewhere other than the default - /var/tmp/wic directory: - - $ wic create ~/test.wks -o /home/trz/testwic --rootfs-dir \ - /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs \ - --bootimg-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share \ - --kernel-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel \ - --native-sysroot /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux +
+ Creating an Image Based on <filename>core-image-minimal</filename> and <filename>crownbay-noemgd</filename> - Creating image(s)... + + This example creates an image based on + core-image-minimal and a + crownbay-noemgd + MACHINE + that works right out of the box. + + $ wic create directdisk -e core-image-minimal - Info: The new image(s) can be found here: - /home/trz/testwic/build/test-201309260032-sda.direct + Checking basic build environment... + Done. - The following build artifacts were used to create the image(s): + Creating image(s)... - ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs - BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share - KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel - NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel + Info: The new image(s) can be found here: + /var/tmp/wic/build/directdisk-201309252350-sda.direct - The image(s) were created using OE kickstart file: - /home/trz/test.wks - - For this example, - MACHINE - did not have to be specified in the - local.conf file since the artifact is - manually specified. - -
-
+ The following build artifacts were used to create the image(s): -
- Plug-ins + ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs + BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share + KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel + NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel - - Plug-ins allow wic functionality to - be extended and specialized by users. - This section documents the plugin interface, which is - currently restricted to source plug ins. - + The image(s) were created using OE kickstart file: + /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/directdisk.wks + + +
- - Source plug ins provide a mechanism to customize - various aspects of the image generation process in - wic, mainly the contents of - partitions. - The plug ins provide a mechanism for mapping values - specified in .wks files using the - --source keyword to a - particular plugin implementation that populates a - corresponding partition. - +
+ Using a Modified Kickstart File and Running in Raw Mode - - A source plugin is created as a subclass of - SourcePlugin. - The plugin file containing it is added to - scripts/lib/wic/plugins/source/ to - make the plugin implementation available to the - wic implementation. - For more information, see - scripts/lib/wic/pluginbase.py. - + + This next example manually specifies each build artifact + (runs in Raw Mode) and uses a modified kickstart file. + The example also uses the -o option + to cause wic to create the output + somewhere other than the default + /var/tmp/wic directory: + + $ wic create ~/test.wks -o /home/trz/testwic --rootfs-dir \ + /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs \ + --bootimg-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share \ + --kernel-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel \ + --native-sysroot /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux - - Source plugins can also be implemented and added by - external layers. - As such, any plugins found in a - scripts/lib/wic/plugins/source/ - directory in an external layer are also made - available. - + Creating image(s)... - - When the wic implementation needs - to invoke a partition-specific implementation, it looks - for the plugin that has the same name as the - --source parameter given to - that partition. - For example, if the partition is set up as follows: - - part /boot --source bootimg-pcbios ... - - The methods defined as class members of the plugin - having the matching bootimg-pcbios.name - class member are used. - + Info: The new image(s) can be found here: + /home/trz/testwic/build/test-201309260032-sda.direct - - To be more concrete, here is the plugin definition that - matches a - --source bootimg-pcbios usage, - along with an example - method called by the wic implementation - when it needs to invoke an implementation-specific - partition-preparation function: - - class BootimgPcbiosPlugin(SourcePlugin): - name = 'bootimg-pcbios' + The following build artifacts were used to create the image(s): - @classmethod - def do_prepare_partition(self, part, ...) - - If the subclass itself does not implement a function, a - default version in a superclass is located and - used, which is why all plugins must be derived from - SourcePlugin. - + ROOTFS_DIR: /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs + BOOTIMG_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share + KERNEL_DIR: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel + NATIVE_SYSROOT: /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel - - The SourcePlugin class defines the - following methods, which is the current set of methods - that can be implemented or overridden by - --source plugins. - Any methods not implemented by a - SourcePlugin subclass inherit the - implementations present in the - SourcePlugin class. - For more information, see the - SourcePlugin source for details: - + The image(s) were created using OE kickstart file: + /home/trz/test.wks + + For this example, + MACHINE + did not have to be specified in the + local.conf file since the artifact is + manually specified. + +
+
- - - do_prepare_partition(): - Called to do the actual content population for a - partition. - In other words, the method prepares the final - partition image that is incorporated into the - disk image. - - do_configure_partition(): - Called before - do_prepare_partition(). - This method is typically used to create custom - configuration files for a partition (e.g. syslinux or - grub configuration files). - - do_install_disk(): - Called after all partitions have been prepared and - assembled into a disk image. - This method provides a hook to allow finalization of a - disk image, (e.g. writing an MBR). - - do_stage_partition(): - Special content-staging hook called before - do_prepare_partition(). - This method is normally empty. - Typically, a partition just uses the passed-in - parameters (e.g. the unmodified value of - bootimg_dir). - However, in some cases things might need to be - more tailored. - As an example, certain files might additionally - need to be taken from - bootimg_dir + /boot. - This hook allows those files to be staged in a - customized fashion. - - get_bitbake_var() - allows you to access non-standard variables - that you might want to use for this. - - - - +
+ Plug-ins - - This scheme is extensible. - Adding more hooks is a simple matter of adding more - plugin methods to SourcePlugin and - derived classes. - The code that then needs to call the plugin methods uses - plugin.get_source_plugin_methods() - to find the method or methods needed by the call. - Retrieval of those methods is accomplished - by filling up a dict with keys - containing the method names of interest. - On success, these will be filled in with the actual - methods. - Please see the wic - implementation for examples and details. - -
+ + Plug-ins allow wic functionality to + be extended and specialized by users. + This section documents the plugin interface, which is + currently restricted to source plug ins. + -
- OpenEmbedded Kickstart (.wks) Reference + + Source plug ins provide a mechanism to customize + various aspects of the image generation process in + wic, mainly the contents of + partitions. + The plug ins provide a mechanism for mapping values + specified in .wks files using the + --source keyword to a + particular plugin implementation that populates a + corresponding partition. + - - The current wic implementation supports - only the basic kickstart partitioning commands: - partition (or part - for short) and bootloader. - - Future updates will implement more commands and options. - If you use anything that is not specifically - supported, results can be unpredictable. - - + + A source plugin is created as a subclass of + SourcePlugin. + The plugin file containing it is added to + scripts/lib/wic/plugins/source/ to + make the plugin implementation available to the + wic implementation. + For more information, see + scripts/lib/wic/pluginbase.py. + - - 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: - - - http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition - - - http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader - - - + + Source plugins can also be implemented and added by + external layers. + As such, any plugins found in a + scripts/lib/wic/plugins/source/ + directory in an external layer are also made + available. + -
- Command: part or partition + + When the wic implementation needs + to invoke a partition-specific implementation, it looks + for the plugin that has the same name as the + --source parameter given to + that partition. + For example, if the partition is set up as follows: + + part /boot --source bootimg-pcbios ... + + The methods defined as class members of the plugin + having the matching bootimg-pcbios.name + class member are used. + - - Either of these commands create a partition on the system - and uses the following syntax: - - part [mntpoint] - partition [mntpoint] - - If you do not provide - mntpoint, wic creates a partition - but does not mount it. - + + To be more concrete, here is the plugin definition that + matches a + --source bootimg-pcbios usage, + along with an example + method called by the wic implementation + when it needs to invoke an implementation-specific + partition-preparation function: + + class BootimgPcbiosPlugin(SourcePlugin): + name = 'bootimg-pcbios' - - The mntpoint - is where the - partition will be mounted and must be of one of the - following forms: - - /path: - For example, /, - /usr, or - /home - swap: - The created partition is used as swap space. - - - + @classmethod + def do_prepare_partition(self, part, ...) + + If the subclass itself does not implement a function, a + default version in a superclass is located and + used, which is why all plugins must be derived from + SourcePlugin. + - - Specifying a mntpoint 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 --ondrive, - --ondisk, or - --use-uuid 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 sdb disk: - - part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024 - - + + The SourcePlugin class defines the + following methods, which is the current set of methods + that can be implemented or overridden by + --source plugins. + Any methods not implemented by a + SourcePlugin subclass inherit the + implementations present in the + SourcePlugin class. + For more information, see the + SourcePlugin source for details: + - - Here is a list that describes other supported options you - can use with the part and - partition commands: - - --size: - 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 - --source. - --source: - 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 plugin. - For information on the source plugins, see the - "Plugins" - section. - If you use - --source rootfs, - wic creates a partition as - large as needed and to fill it with the contents of - the root filesystem pointed to by the - -r command-line option - or the equivalent rootfs derived from the - -e command-line - option. - The filesystem type used to create the - partition is driven by the value of the - --fstype option - specified for the partition. - See the entry on - --fstype that - follows for more information. - - If you use - --source plugin-name, - wic creates a partition as - large as needed and fills it with the contents of - the partition that is generated by the - specified plugin name using the data pointed - to by the -r command-line - option or the equivalent rootfs derived from the - -e command-line - option. - Exactly what those contents and filesystem type end - up being are dependent on the given plugin - implementation. - - If you do not use the - --source option, the - wic command creates an empty - partition. - Consequently, you must use the - --size option to specify the - size of the empty partition. - - --ondisk or --ondrive: - Forces the partition to be created on a particular - disk. - --fstype: - Sets the file system type for the partition. - Valid values are: - - ext4 + + + do_prepare_partition(): + Called to do the actual content population for a + partition. + In other words, the method prepares the final + partition image that is incorporated into the + disk image. - ext3 + do_configure_partition(): + Called before + do_prepare_partition(). + This method is typically used to create custom + configuration files for a partition (e.g. syslinux or + grub configuration files). - ext2 + do_install_disk(): + Called after all partitions have been prepared and + assembled into a disk image. + This method provides a hook to allow finalization of a + disk image, (e.g. writing an MBR). - btrfs + do_stage_partition(): + Special content-staging hook called before + do_prepare_partition(). + This method is normally empty. + Typically, a partition just uses the passed-in + parameters (e.g. the unmodified value of + bootimg_dir). + However, in some cases things might need to be + more tailored. + As an example, certain files might additionally + need to be taken from + bootimg_dir + /boot. + This hook allows those files to be staged in a + customized fashion. + + get_bitbake_var() + allows you to access non-standard variables + that you might want to use for this. + - squashfs + + + + + This scheme is extensible. + Adding more hooks is a simple matter of adding more + plugin methods to SourcePlugin and + derived classes. + The code that then needs to call the plugin methods uses + plugin.get_source_plugin_methods() + to find the method or methods needed by the call. + Retrieval of those methods is accomplished + by filling up a dict with keys + containing the method names of interest. + On success, these will be filled in with the actual + methods. + Please see the wic + implementation for examples and details. + +
+ +
+ OpenEmbedded Kickstart (.wks) Reference + + + The current wic implementation supports + only the basic kickstart partitioning commands: + partition (or part + for short) and bootloader. + + Future updates will implement more commands and options. + If you use anything that is not specifically + supported, results can be unpredictable. + + + + + 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: + + + http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition - swap + + http://fedoraproject.org/wiki/Anaconda/Kickstart#bootloader - - --fsoptions: - Specifies a free-form string of options to be - used when mounting the filesystem. - This string will be copied into the - /etc/fstab file of the - installed system and should be enclosed in - quotes. - If not specified, the default string - is "defaults". - - --label label: - 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. - --active: - Marks the partition as active. - --align (in KBytes): - This option is a wic-specific - option that says to start a partition on an - x KBytes boundary. - --no-table: - 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. - - --extra-space: - 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 --size option. - The default value is 10 Mbytes. - - --overhead-factor: - 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". - - --part-type: - 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 - . - - --use-uuid: - 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. - - --uuid: - This option is a wic-specific - option that specifies the partition UUID. - - - -
+ + -
- Command: bootloader +
+ Command: part or partition - - This command specifies how the boot loader should be - configured and supports the following options: - - Bootloader functionality and boot partitions are - implemented by the various - --source - plugins that implement bootloader functionality. - The bootloader command essentially provides a means of - modifying bootloader configuration. - - - --timeout: - Specifies the number of seconds before the - bootloader times out and boots the default option. - - --append: - Specifies kernel parameters. - These parameters will be added to the syslinux - APPEND or - grub kernel command line. - - --configfile: - 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 - canned-wks folder. - This option overrides all other bootloader options. - - - -
+ + Either of these commands create a partition on the system + and uses the following syntax: + + part [mntpoint] + partition [mntpoint] + + If you do not provide + mntpoint, wic creates a partition + but does not mount it. + + + + The mntpoint + is where the + partition will be mounted and must be of one of the + following forms: + + /path: + For example, /, + /usr, or + /home + swap: + The created partition is used as swap space. + + + + + + Specifying a mntpoint 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 --ondrive, + --ondisk, or + --use-uuid 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 sdb disk: + + part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024 + + + + + Here is a list that describes other supported options you + can use with the part and + partition commands: + + --size: + 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 + --source. + --source: + 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 plugin. + For information on the source plugins, see the + "Plugins" + section. + If you use + --source rootfs, + wic creates a partition as + large as needed and to fill it with the contents of + the root filesystem pointed to by the + -r command-line option + or the equivalent rootfs derived from the + -e command-line + option. + The filesystem type used to create the + partition is driven by the value of the + --fstype option + specified for the partition. + See the entry on + --fstype that + follows for more information. + + If you use + --source plugin-name, + wic creates a partition as + large as needed and fills it with the contents of + the partition that is generated by the + specified plugin name using the data pointed + to by the -r command-line + option or the equivalent rootfs derived from the + -e command-line + option. + Exactly what those contents and filesystem type end + up being are dependent on the given plugin + implementation. + + If you do not use the + --source option, the + wic command creates an empty + partition. + Consequently, you must use the + --size option to specify the + size of the empty partition. + + --ondisk or --ondrive: + Forces the partition to be created on a particular + disk. + --fstype: + Sets the file system type for the partition. + Valid values are: + + ext4 + + ext3 + + ext2 + + btrfs + + squashfs + + swap + + + --fsoptions: + Specifies a free-form string of options to be + used when mounting the filesystem. + This string will be copied into the + /etc/fstab file of the + installed system and should be enclosed in + quotes. + If not specified, the default string + is "defaults". + + --label label: + 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. + --active: + Marks the partition as active. + --align (in KBytes): + This option is a wic-specific + option that says to start a partition on an + x KBytes boundary. + --no-table: + 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. + + --extra-space: + 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 --size option. + The default value is 10 Mbytes. + + --overhead-factor: + 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". + + --part-type: + 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 + . + + --use-uuid: + 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. + + --uuid: + This option is a wic-specific + option that specifies the partition UUID. + + + +
+ +
+ Command: bootloader + + + This command specifies how the boot loader should be + configured and supports the following options: + + Bootloader functionality and boot partitions are + implemented by the various + --source + plugins that implement bootloader functionality. + The bootloader command essentially provides a means of + modifying bootloader configuration. + + + --timeout: + Specifies the number of seconds before the + bootloader times out and boots the default option. + + --append: + Specifies kernel parameters. + These parameters will be added to the syslinux + APPEND or + grub kernel command line. + + --configfile: + 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 + canned-wks folder. + This option overrides all other bootloader options. + + + +
+
-- 2.1.4