summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml184
1 files changed, 120 insertions, 64 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 9030b96264..ba74e15d1a 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -741,13 +741,13 @@
741 ... 741 ...
742 DESCRIPTION = "A useful utility" 742 DESCRIPTION = "A useful utility"
743 ... 743 ...
744 EXTRA_OECONF = "--enable-something" 744 EXTRA_OECONF = "‐‐enable-something"
745 ... 745 ...
746 746
747 #### bbappended from meta-anotherlayer #### 747 #### bbappended from meta-anotherlayer ####
748 748
749 DESCRIPTION = "Customized utility" 749 DESCRIPTION = "Customized utility"
750 EXTRA_OECONF += "--enable-somethingelse" 750 EXTRA_OECONF += "‐‐enable-somethingelse"
751 </literallayout> 751 </literallayout>
752 Ideally, you would tidy up these utilities as 752 Ideally, you would tidy up these utilities as
753 follows: 753 follows:
@@ -755,7 +755,7 @@
755 ... 755 ...
756 DESCRIPTION = "Customized utility" 756 DESCRIPTION = "Customized utility"
757 ... 757 ...
758 EXTRA_OECONF = "--enable-something --enable-somethingelse" 758 EXTRA_OECONF = "&dash;&dash;enable-something &dash;&dash;enable-somethingelse"
759 ... 759 ...
760 </literallayout></para></listitem> 760 </literallayout></para></listitem>
761 </itemizedlist></para></listitem> 761 </itemizedlist></para></listitem>
@@ -1170,6 +1170,61 @@
1170 For other forms of image dependencies see the other areas of this section. 1170 For other forms of image dependencies see the other areas of this section.
1171 </para> 1171 </para>
1172 </section> 1172 </section>
1173
1174 <section id='usingpoky-extend-customimage-image-name'>
1175 <title>Customizing an Image Hostname</title>
1176
1177 <para>
1178 By default the configured hostname (i.e.
1179 <filename>/etc/hostname</filename>) in an image is the
1180 same as the machine name.
1181 For example, if
1182 <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
1183 equals "qemux86", the configured hostname written to
1184 <filename>/etc/hostname</filename> is "qemux86".
1185 </para>
1186
1187 <para>
1188 You can customize this name by altering the value of the
1189 "hostname" variable in the base-files recipe using either
1190 an append file or a configuration file.
1191 <note>
1192 Setting the variable to "" causes no hostname to be
1193 written to <filename>/etc/hostname</filename>.
1194 </note>
1195 Use the following in an append file:
1196 <literallayout class='monospaced'>
1197 hostname="myhostname"
1198 </literallayout>
1199 Use the following in a configuration file:
1200 <literallayout class='monospaced'>
1201 hostname_pn-base-files = "myhostname"
1202 </literallayout>
1203 </para>
1204
1205 <para>
1206 Changing the default value of the variable "hostname" can be
1207 useful in certain situations.
1208 For example, suppose you need to do extensive testing on an
1209 image and you would like to easily identify the image
1210 under test from existing images with typical default
1211 hostnames.
1212 In this situation, you could change the default hostname to
1213 "testme", which results in all the images using the name
1214 "testme".
1215 Once testing is complete and you do not need to rebuild the
1216 image for test any longer, you can easily reset the default
1217 hostname.
1218 </para>
1219
1220 <para>
1221 Another point of interest is that if you leave the variable
1222 "hostname" unset, the image will have no default hostname
1223 in the filesystem.
1224 This condition is suitable for environments that use
1225 dynamic hostnames such as virtual machines.
1226 </para>
1227 </section>
1173 </section> 1228 </section>
1174 1229
1175 <section id='new-recipe-writing-a-new-recipe'> 1230 <section id='new-recipe-writing-a-new-recipe'>
@@ -2275,7 +2330,7 @@
2275 configure script with the appropriate options.</para> 2330 configure script with the appropriate options.</para>
2276 <para>For the case involving a custom configure 2331 <para>For the case involving a custom configure
2277 script, you would run 2332 script, you would run
2278 <filename>./configure --help</filename> and look for 2333 <filename>./configure &dash;&dash;help</filename> and look for
2279 the options you need to set.</para></listitem> 2334 the options you need to set.</para></listitem>
2280 </itemizedlist> 2335 </itemizedlist>
2281 </para> 2336 </para>
@@ -2298,7 +2353,7 @@
2298 configure script as needed. 2353 configure script as needed.
2299 For reference information on configure options specific to the 2354 For reference information on configure options specific to the
2300 software you are building, you can consult the output of the 2355 software you are building, you can consult the output of the
2301 <filename>./configure --help</filename> command within 2356 <filename>./configure &dash;&dash;help</filename> command within
2302 <filename>${S}</filename> or consult the software's upstream 2357 <filename>${S}</filename> or consult the software's upstream
2303 documentation. 2358 documentation.
2304 </para> 2359 </para>
@@ -3780,7 +3835,7 @@
3780 or by entering the command with a help argument as follows: 3835 or by entering the command with a help argument as follows:
3781 <literallayout class='monospaced'> 3836 <literallayout class='monospaced'>
3782 $ wic -h 3837 $ wic -h
3783 $ wic --help 3838 $ wic &dash;&dash;help
3784 </literallayout> 3839 </literallayout>
3785 </para> 3840 </para>
3786 3841
@@ -3796,7 +3851,7 @@
3796 <para> 3851 <para>
3797 You can also get detailed help on a number of topics 3852 You can also get detailed help on a number of topics
3798 from the help system. 3853 from the help system.
3799 The output of <filename>wic --help</filename> 3854 The output of <filename>wic &dash;&dash;help</filename>
3800 displays a list of available help 3855 displays a list of available help
3801 topics under a "Help topics" heading. 3856 topics under a "Help topics" heading.
3802 You can have the help system display the help text for 3857 You can have the help system display the help text for
@@ -3866,38 +3921,38 @@
3866 your own custom file or use a file from a set of 3921 your own custom file or use a file from a set of
3867 existing files as described by further options. 3922 existing files as described by further options.
3868 3923
3869 -o <replaceable>OUTDIR</replaceable>, --outdir=<replaceable>OUTDIR</replaceable> 3924 -o <replaceable>OUTDIR</replaceable>, &dash;&dash;outdir=<replaceable>OUTDIR</replaceable>
3870 The name of a directory in which to create image. 3925 The name of a directory in which to create image.
3871 3926
3872 -i <replaceable>PROPERTIES_FILE</replaceable>, --infile=<replaceable>PROPERTIES_FILE</replaceable> 3927 -i <replaceable>PROPERTIES_FILE</replaceable>, &dash;&dash;infile=<replaceable>PROPERTIES_FILE</replaceable>
3873 The name of a file containing the values for image 3928 The name of a file containing the values for image
3874 properties as a JSON file. 3929 properties as a JSON file.
3875 3930
3876 -e <replaceable>IMAGE_NAME</replaceable>, --image-name=<replaceable>IMAGE_NAME</replaceable> 3931 -e <replaceable>IMAGE_NAME</replaceable>, &dash;&dash;image-name=<replaceable>IMAGE_NAME</replaceable>
3877 The name of the image from which to use the artifacts 3932 The name of the image from which to use the artifacts
3878 (e.g. <filename>core-image-sato</filename>). 3933 (e.g. <filename>core-image-sato</filename>).
3879 3934
3880 -r <replaceable>ROOTFS_DIR</replaceable>, --rootfs-dir=<replaceable>ROOTFS_DIR</replaceable> 3935 -r <replaceable>ROOTFS_DIR</replaceable>, &dash;&dash;rootfs-dir=<replaceable>ROOTFS_DIR</replaceable>
3881 The path to the <filename>/rootfs</filename> directory to use as the 3936 The path to the <filename>/rootfs</filename> directory to use as the
3882 <filename>.wks</filename> rootfs source. 3937 <filename>.wks</filename> rootfs source.
3883 3938
3884 -b <replaceable>BOOTIMG_DIR</replaceable>, --bootimg-dir=<replaceable>BOOTIMG_DIR</replaceable> 3939 -b <replaceable>BOOTIMG_DIR</replaceable>, &dash;&dash;bootimg-dir=<replaceable>BOOTIMG_DIR</replaceable>
3885 The path to the directory containing the boot artifacts 3940 The path to the directory containing the boot artifacts
3886 (e.g. <filename>/EFI</filename> or <filename>/syslinux</filename>) to use as the <filename>.wks</filename> bootimg 3941 (e.g. <filename>/EFI</filename> or <filename>/syslinux</filename>) to use as the <filename>.wks</filename> bootimg
3887 source. 3942 source.
3888 3943
3889 -k <replaceable>KERNEL_DIR</replaceable>, --kernel-dir=<replaceable>KERNEL_DIR</replaceable> 3944 -k <replaceable>KERNEL_DIR</replaceable>, &dash;&dash;kernel-dir=<replaceable>KERNEL_DIR</replaceable>
3890 The path to the directory containing the kernel to use 3945 The path to the directory containing the kernel to use
3891 in the <filename>.wks</filename> boot image. 3946 in the <filename>.wks</filename> boot image.
3892 3947
3893 -n <replaceable>NATIVE_SYSROOT</replaceable>, --native-sysroot=<replaceable>NATIVE_SYSROOT</replaceable> 3948 -n <replaceable>NATIVE_SYSROOT</replaceable>, &dash;&dash;native-sysroot=<replaceable>NATIVE_SYSROOT</replaceable>
3894 The path to the native sysroot containing the tools to use 3949 The path to the native sysroot containing the tools to use
3895 to build the image. 3950 to build the image.
3896 3951
3897 -s, --skip-build-check 3952 -s, &dash;&dash;skip-build-check
3898 Skips the build check. 3953 Skips the build check.
3899 3954
3900 -D, --debug 3955 -D, &dash;&dash;debug
3901 Output debug information. 3956 Output debug information.
3902 </literallayout> 3957 </literallayout>
3903 <note> 3958 <note>
@@ -4107,13 +4162,13 @@
4107 </literallayout> 4162 </literallayout>
4108 Next, the example modifies the 4163 Next, the example modifies the
4109 <filename>directdisksdb.wks</filename> file and changes all 4164 <filename>directdisksdb.wks</filename> file and changes all
4110 instances of "<filename>--ondisk sda</filename>" 4165 instances of "<filename>&dash;&dash;ondisk sda</filename>"
4111 to "<filename>--ondisk sdb</filename>". 4166 to "<filename>&dash;&dash;ondisk sdb</filename>".
4112 The example changes the following two lines and leaves the 4167 The example changes the following two lines and leaves the
4113 remaining lines untouched: 4168 remaining lines untouched:
4114 <literallayout class='monospaced'> 4169 <literallayout class='monospaced'>
4115 part /boot --source bootimg-pcbios --ondisk sdb --label boot --active --align 1024 4170 part /boot &dash;&dash;source bootimg-pcbios &dash;&dash;ondisk sdb &dash;&dash;label boot &dash;&dash;active &dash;&dash;align 1024
4116 part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024 4171 part / &dash;&dash;source rootfs &dash;&dash;ondisk sdb &dash;&dash;fstype=ext3 &dash;&dash;label platform &dash;&dash;align 1024
4117 </literallayout> 4172 </literallayout>
4118 Once the lines are changed, the example generates the 4173 Once the lines are changed, the example generates the
4119 <filename>directdisksdb</filename> image. 4174 <filename>directdisksdb</filename> image.
@@ -4200,11 +4255,11 @@
4200 somewhere other than the default 4255 somewhere other than the default
4201 <filename>/var/tmp/wic</filename> directory: 4256 <filename>/var/tmp/wic</filename> directory:
4202 <literallayout class='monospaced'> 4257 <literallayout class='monospaced'>
4203 $ wic create ~/test.wks -o /home/trz/testwic --rootfs-dir \ 4258 $ wic create ~/test.wks -o /home/trz/testwic &dash;&dash;rootfs-dir \
4204 /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs \ 4259 /home/trz/yocto/yocto-image/build/tmp/work/crownbay_noemgd-poky-linux/core-image-minimal/1.0-r0/rootfs \
4205 --bootimg-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share \ 4260 &dash;&dash;bootimg-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/share \
4206 --kernel-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel \ 4261 &dash;&dash;kernel-dir /home/trz/yocto/yocto-image/build/tmp/sysroots/crownbay-noemgd/usr/src/kernel \
4207 --native-sysroot /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux 4262 &dash;&dash;native-sysroot /home/trz/yocto/yocto-image/build/tmp/sysroots/x86_64-linux
4208 4263
4209 Creating image(s)... 4264 Creating image(s)...
4210 4265
@@ -4247,7 +4302,7 @@
4247 partitions. 4302 partitions.
4248 The plugins provide a mechanism for mapping values 4303 The plugins provide a mechanism for mapping values
4249 specified in <filename>.wks</filename> files using the 4304 specified in <filename>.wks</filename> files using the
4250 <filename>--source</filename> keyword to a 4305 <filename>&dash;&dash;source</filename> keyword to a
4251 particular plugin implementation that populates a 4306 particular plugin implementation that populates a
4252 corresponding partition. 4307 corresponding partition.
4253 </para> 4308 </para>
@@ -4276,11 +4331,11 @@
4276 When the <filename>wic</filename> implementation needs 4331 When the <filename>wic</filename> implementation needs
4277 to invoke a partition-specific implementation, it looks 4332 to invoke a partition-specific implementation, it looks
4278 for the plugin that has the same name as the 4333 for the plugin that has the same name as the
4279 <filename>--source</filename> parameter given to 4334 <filename>&dash;&dash;source</filename> parameter given to
4280 that partition. 4335 that partition.
4281 For example, if the partition is set up as follows: 4336 For example, if the partition is set up as follows:
4282 <literallayout class='monospaced'> 4337 <literallayout class='monospaced'>
4283 part /boot --source bootimg-pcbios ... 4338 part /boot &dash;&dash;source bootimg-pcbios ...
4284 </literallayout> 4339 </literallayout>
4285 The methods defined as class members of the plugin 4340 The methods defined as class members of the plugin
4286 having the matching <filename>bootimg-pcbios.name</filename> 4341 having the matching <filename>bootimg-pcbios.name</filename>
@@ -4290,7 +4345,7 @@
4290 <para> 4345 <para>
4291 To be more concrete, here is the plugin definition that 4346 To be more concrete, here is the plugin definition that
4292 matches a 4347 matches a
4293 <filename>--source bootimg-pcbios</filename> usage, 4348 <filename>&dash;&dash;source bootimg-pcbios</filename> usage,
4294 along with an example 4349 along with an example
4295 method called by the <filename>wic</filename> implementation 4350 method called by the <filename>wic</filename> implementation
4296 when it needs to invoke an implementation-specific 4351 when it needs to invoke an implementation-specific
@@ -4312,7 +4367,7 @@
4312 The <filename>SourcePlugin</filename> class defines the 4367 The <filename>SourcePlugin</filename> class defines the
4313 following methods, which is the current set of methods 4368 following methods, which is the current set of methods
4314 that can be implemented or overridden by 4369 that can be implemented or overridden by
4315 <filename>--source</filename> plugins. 4370 <filename>&dash;&dash;source</filename> plugins.
4316 Any methods not implemented by a 4371 Any methods not implemented by a
4317 <filename>SourcePlugin</filename> subclass inherit the 4372 <filename>SourcePlugin</filename> subclass inherit the
4318 implementations present in the 4373 implementations present in the
@@ -4444,13 +4499,13 @@
4444 <para> 4499 <para>
4445 Following are the supported options: 4500 Following are the supported options:
4446 <itemizedlist> 4501 <itemizedlist>
4447 <listitem><para><emphasis><filename>--size</filename>:</emphasis> 4502 <listitem><para><emphasis><filename>&dash;&dash;size</filename>:</emphasis>
4448 The minimum partition size in MBytes. 4503 The minimum partition size in MBytes.
4449 Specify an integer value such as 500. 4504 Specify an integer value such as 500.
4450 Do not append the number with "MB". 4505 Do not append the number with "MB".
4451 You do not need this option if you use 4506 You do not need this option if you use
4452 <filename>--source</filename>.</para></listitem> 4507 <filename>&dash;&dash;source</filename>.</para></listitem>
4453 <listitem><para><emphasis><filename>--source</filename>:</emphasis> 4508 <listitem><para><emphasis><filename>&dash;&dash;source</filename>:</emphasis>
4454 This option is a 4509 This option is a
4455 <filename>wic</filename>-specific option that 4510 <filename>wic</filename>-specific option that
4456 names the source of the data that populates 4511 names the source of the data that populates
@@ -4462,7 +4517,7 @@
4462 "<link linkend='openembedded-kickstart-plugins'>Plugins</link>" 4517 "<link linkend='openembedded-kickstart-plugins'>Plugins</link>"
4463 section.</para> 4518 section.</para>
4464 <para>If you use 4519 <para>If you use
4465 <filename>--source rootfs</filename>, 4520 <filename>&dash;&dash;source rootfs</filename>,
4466 <filename>wic</filename> creates a partition as 4521 <filename>wic</filename> creates a partition as
4467 large as needed and to fill it with the contents of 4522 large as needed and to fill it with the contents of
4468 the root filesystem pointed to by the 4523 the root filesystem pointed to by the
@@ -4472,14 +4527,14 @@
4472 option. 4527 option.
4473 The filesystem type used to create the 4528 The filesystem type used to create the
4474 partition is driven by the value of the 4529 partition is driven by the value of the
4475 <filename>--fstype</filename> option 4530 <filename>&dash;&dash;fstype</filename> option
4476 specified for the partition. 4531 specified for the partition.
4477 See the entry on 4532 See the entry on
4478 <filename>--fstype</filename> that 4533 <filename>&dash;&dash;fstype</filename> that
4479 follows for more information. 4534 follows for more information.
4480 </para> 4535 </para>
4481 <para>If you use 4536 <para>If you use
4482 <filename>--source <replaceable>plugin-name</replaceable></filename>, 4537 <filename>&dash;&dash;source <replaceable>plugin-name</replaceable></filename>,
4483 <filename>wic</filename> creates a partition as 4538 <filename>wic</filename> creates a partition as
4484 large as needed and fills it with the contents of 4539 large as needed and fills it with the contents of
4485 the partition that is generated by the 4540 the partition that is generated by the
@@ -4492,10 +4547,10 @@
4492 filesystem type end up being are dependent 4547 filesystem type end up being are dependent
4493 on the given plugin implementation. 4548 on the given plugin implementation.
4494 </para></listitem> 4549 </para></listitem>
4495 <listitem><para><emphasis><filename>--ondisk</filename> or <filename>--ondrive</filename>:</emphasis> 4550 <listitem><para><emphasis><filename>&dash;&dash;ondisk</filename> or <filename>&dash;&dash;ondrive</filename>:</emphasis>
4496 Forces the partition to be created on a particular 4551 Forces the partition to be created on a particular
4497 disk.</para></listitem> 4552 disk.</para></listitem>
4498 <listitem><para><emphasis><filename>--fstype</filename>:</emphasis> 4553 <listitem><para><emphasis><filename>&dash;&dash;fstype</filename>:</emphasis>
4499 Sets the file system type for the partition. 4554 Sets the file system type for the partition.
4500 Valid values are: 4555 Valid values are:
4501 <itemizedlist> 4556 <itemizedlist>
@@ -4512,7 +4567,7 @@
4512 <listitem><para><filename>swap</filename> 4567 <listitem><para><filename>swap</filename>
4513 </para></listitem> 4568 </para></listitem>
4514 </itemizedlist></para></listitem> 4569 </itemizedlist></para></listitem>
4515 <listitem><para><emphasis><filename>--fsoptions</filename>:</emphasis> 4570 <listitem><para><emphasis><filename>&dash;&dash;fsoptions</filename>:</emphasis>
4516 Specifies a free-form string of options to be 4571 Specifies a free-form string of options to be
4517 used when mounting the filesystem. 4572 used when mounting the filesystem.
4518 This string will be copied into the 4573 This string will be copied into the
@@ -4522,15 +4577,15 @@
4522 If not specified, the default string 4577 If not specified, the default string
4523 is "defaults". 4578 is "defaults".
4524 </para></listitem> 4579 </para></listitem>
4525 <listitem><para><emphasis><filename>--label label</filename>:</emphasis> 4580 <listitem><para><emphasis><filename>&dash;&dash;label label</filename>:</emphasis>
4526 Specifies the label to give to the filesystem to 4581 Specifies the label to give to the filesystem to
4527 be made on the partition. 4582 be made on the partition.
4528 If the given label is already in use by another 4583 If the given label is already in use by another
4529 filesystem, a new label is created for the 4584 filesystem, a new label is created for the
4530 partition.</para></listitem> 4585 partition.</para></listitem>
4531 <listitem><para><emphasis><filename>--active</filename>:</emphasis> 4586 <listitem><para><emphasis><filename>&dash;&dash;active</filename>:</emphasis>
4532 Marks the partition as active.</para></listitem> 4587 Marks the partition as active.</para></listitem>
4533 <listitem><para><emphasis><filename>--align (in KBytes)</filename>:</emphasis> 4588 <listitem><para><emphasis><filename>&dash;&dash;align (in KBytes)</filename>:</emphasis>
4534 This option is a <filename>wic</filename>-specific 4589 This option is a <filename>wic</filename>-specific
4535 option that says to start a partition on an 4590 option that says to start a partition on an
4536 x KBytes boundary.</para></listitem> 4591 x KBytes boundary.</para></listitem>
@@ -4547,17 +4602,17 @@
4547 <note> 4602 <note>
4548 Bootloader functionality and boot partitions are 4603 Bootloader functionality and boot partitions are
4549 implemented by the various 4604 implemented by the various
4550 <filename>--source</filename> 4605 <filename>&dash;&dash;source</filename>
4551 plugins that implement bootloader functionality. 4606 plugins that implement bootloader functionality.
4552 The bootloader command essentially provides a means of 4607 The bootloader command essentially provides a means of
4553 modifying bootloader configuration. 4608 modifying bootloader configuration.
4554 </note> 4609 </note>
4555 <itemizedlist> 4610 <itemizedlist>
4556 <listitem><para><emphasis><filename>--timeout</filename>:</emphasis> 4611 <listitem><para><emphasis><filename>&dash;&dash;timeout</filename>:</emphasis>
4557 Specifies the number of seconds before the 4612 Specifies the number of seconds before the
4558 bootloader times out and boots the default option. 4613 bootloader times out and boots the default option.
4559 </para></listitem> 4614 </para></listitem>
4560 <listitem><para><emphasis><filename>--append</filename>:</emphasis> 4615 <listitem><para><emphasis><filename>&dash;&dash;append</filename>:</emphasis>
4561 Specifies kernel parameters. 4616 Specifies kernel parameters.
4562 These parameters will be added to the syslinux 4617 These parameters will be added to the syslinux
4563 <filename>APPEND</filename> or 4618 <filename>APPEND</filename> or
@@ -5826,7 +5881,8 @@
5826 <para>The <filename>merge_config.sh</filename> script is 5881 <para>The <filename>merge_config.sh</filename> script is
5827 part of the Linux Yocto kernel Git repositories 5882 part of the Linux Yocto kernel Git repositories
5828 (i.e. <filename>linux-yocto-3.14</filename>, 5883 (i.e. <filename>linux-yocto-3.14</filename>,
5829 <filename>linux-yocto-3.19</filename>, and so forth) 5884 <filename>linux-yocto-3.10</filename>,
5885 <filename>linux-yocto-3.8</filename>, and so forth)
5830 in the 5886 in the
5831 <filename>scripts/kconfig</filename> directory.</para> 5887 <filename>scripts/kconfig</filename> directory.</para>
5832 <para>For more information on configuration fragments, 5888 <para>For more information on configuration fragments,
@@ -6484,7 +6540,7 @@
6484 For this scenario, you need to start the PR Service using 6540 For this scenario, you need to start the PR Service using
6485 the <filename>bitbake-prserv</filename> command: 6541 the <filename>bitbake-prserv</filename> command:
6486 <literallayout class='monospaced'> 6542 <literallayout class='monospaced'>
6487 bitbake-prserv --host <replaceable>ip</replaceable> --port <replaceable>port</replaceable> --start 6543 bitbake-prserv &dash;&dash;host <replaceable>ip</replaceable> &dash;&dash;port <replaceable>port</replaceable> &dash;&dash;start
6488 </literallayout> 6544 </literallayout>
6489 In addition to hand-starting the service, you need to 6545 In addition to hand-starting the service, you need to
6490 update the <filename>local.conf</filename> file of each 6546 update the <filename>local.conf</filename> file of each
@@ -7136,9 +7192,9 @@
7136 Given this example, issue the following commands on the 7192 Given this example, issue the following commands on the
7137 target: 7193 target:
7138 <literallayout class='monospaced'> 7194 <literallayout class='monospaced'>
7139 # smart channel --add all type=rpm-md baseurl=http://server.name/rpm/all 7195 # smart channel &dash;&dash;add all type=rpm-md baseurl=http://server.name/rpm/all
7140 # smart channel --add i585 type=rpm-md baseurl=http://server.name/rpm/i586 7196 # smart channel &dash;&dash;add i585 type=rpm-md baseurl=http://server.name/rpm/i586
7141 # smart channel --add qemux86 type=rpm-md baseurl=http://server.name/rpm/qemux86 7197 # smart channel &dash;&dash;add qemux86 type=rpm-md baseurl=http://server.name/rpm/qemux86
7142 </literallayout> 7198 </literallayout>
7143 Also from the target machine, fetch the repository 7199 Also from the target machine, fetch the repository
7144 information using this command: 7200 information using this command:
@@ -8588,13 +8644,13 @@
8588 Consequently, running the tests on other machine 8644 Consequently, running the tests on other machine
8589 means that you have to move the contents and call 8645 means that you have to move the contents and call
8590 <filename>runexported.py</filename> with 8646 <filename>runexported.py</filename> with
8591 "--deploy-dir <replaceable>path</replaceable>" as 8647 "&dash;&dash;deploy-dir <replaceable>path</replaceable>" as
8592 follows: 8648 follows:
8593 <literallayout class='monospaced'> 8649 <literallayout class='monospaced'>
8594 ./runexported.py --deploy-dir /new/path/on/this/machine testdata.json 8650 ./runexported.py &dash;&dash;deploy-dir /new/path/on/this/machine testdata.json
8595 </literallayout> 8651 </literallayout>
8596 <filename>runexported.py</filename> accepts other arguments 8652 <filename>runexported.py</filename> accepts other arguments
8597 as well as described using <filename>--help</filename>. 8653 as well as described using <filename>&dash;&dash;help</filename>.
8598 </para> 8654 </para>
8599 </section> 8655 </section>
8600 8656
@@ -9054,7 +9110,7 @@
9054 | DEBUG: SITE files ['endian-little', 'bit-32', 'ix86-common', 'common-linux', 'common-glibc', 'i586-linux', 'common'] 9110 | DEBUG: SITE files ['endian-little', 'bit-32', 'ix86-common', 'common-linux', 'common-glibc', 'i586-linux', 'common']
9055 | DEBUG: Executing shell function do_compile 9111 | DEBUG: Executing shell function do_compile
9056 | NOTE: make -j 16 9112 | NOTE: make -j 16
9057 | make --no-print-directory all-am 9113 | make &dash;&dash;no-print-directory all-am
9058 | /bin/mkdir -p include/near 9114 | /bin/mkdir -p include/near
9059 | /bin/mkdir -p include/near 9115 | /bin/mkdir -p include/near
9060 | /bin/mkdir -p include/near 9116 | /bin/mkdir -p include/near
@@ -9095,7 +9151,7 @@
9095 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9151 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9096 0.14-r0/neard-0.14/include/dbus.h include/near/dbus.h 9152 0.14-r0/neard-0.14/include/dbus.h include/near/dbus.h
9097 | ./src/genbuiltin nfctype1 nfctype2 nfctype3 nfctype4 p2p > src/builtin.h 9153 | ./src/genbuiltin nfctype1 nfctype2 nfctype3 nfctype4 p2p > src/builtin.h
9098 | i586-poky-linux-gcc -m32 -march=i586 --sysroot=/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/ 9154 | i586-poky-linux-gcc -m32 -march=i586 &dash;&dash;sysroot=/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/
9099 build/build/tmp/sysroots/qemux86 -DHAVE_CONFIG_H -I. -I./include -I./src -I./gdbus -I/home/pokybuild/ 9155 build/build/tmp/sysroots/qemux86 -DHAVE_CONFIG_H -I. -I./include -I./src -I./gdbus -I/home/pokybuild/
9100 yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/include/glib-2.0 9156 yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/include/glib-2.0
9101 -I/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/ 9157 -I/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/
@@ -9170,7 +9226,7 @@
9170 Here is some abbreviated, sample output with the 9226 Here is some abbreviated, sample output with the
9171 missing dependency clearly visible at the end: 9227 missing dependency clearly visible at the end:
9172 <literallayout class='monospaced'> 9228 <literallayout class='monospaced'>
9173 i586-poky-linux-gcc -m32 -march=i586 --sysroot=/home/scott-lenovo/...... 9229 i586-poky-linux-gcc -m32 -march=i586 &dash;&dash;sysroot=/home/scott-lenovo/......
9174 . 9230 .
9175 . 9231 .
9176 . 9232 .
@@ -9565,14 +9621,14 @@
9565 9621
9566 <para> 9622 <para>
9567 <literallayout class='monospaced'> 9623 <literallayout class='monospaced'>
9568 # opcontrol --reset 9624 # opcontrol &dash;&dash;reset
9569 # opcontrol --start --separate=lib --no-vmlinux -c 5 9625 # opcontrol &dash;&dash;start &dash;&dash;separate=lib &dash;&dash;no-vmlinux -c 5
9570 . 9626 .
9571 . 9627 .
9572 [do whatever is being profiled] 9628 [do whatever is being profiled]
9573 . 9629 .
9574 . 9630 .
9575 # opcontrol --stop 9631 # opcontrol &dash;&dash;stop
9576 $ opreport -cl 9632 $ opreport -cl
9577 </literallayout> 9633 </literallayout>
9578 </para> 9634 </para>
@@ -9585,7 +9641,7 @@
9585 five levels deep. 9641 five levels deep.
9586 <note> 9642 <note>
9587 To profile the kernel, you would specify the 9643 To profile the kernel, you would specify the
9588 <filename>--vmlinux=/path/to/vmlinux</filename> option. 9644 <filename>&dash;&dash;vmlinux=/path/to/vmlinux</filename> option.
9589 The <filename>vmlinux</filename> file is usually in the source directory in the 9645 The <filename>vmlinux</filename> file is usually in the source directory in the
9590 <filename>/boot/</filename> directory and must match the running kernel. 9646 <filename>/boot/</filename> directory and must match the running kernel.
9591 </note> 9647 </note>
@@ -9648,7 +9704,7 @@
9648 With this connection, you just need to run "oprofile-server" on the device. 9704 With this connection, you just need to run "oprofile-server" on the device.
9649 By default, OProfile listens on port 4224. 9705 By default, OProfile listens on port 4224.
9650 <note> 9706 <note>
9651 You can change the port using the <filename>--port</filename> command-line 9707 You can change the port using the <filename>&dash;&dash;port</filename> command-line
9652 option. 9708 option.
9653 </note> 9709 </note>
9654 </para> 9710 </para>
@@ -9738,14 +9794,14 @@
9738 If network access to the target is unavailable, you can generate 9794 If network access to the target is unavailable, you can generate
9739 an archive for processing in <filename>oprofile-viewer</filename> as follows: 9795 an archive for processing in <filename>oprofile-viewer</filename> as follows:
9740 <literallayout class='monospaced'> 9796 <literallayout class='monospaced'>
9741 # opcontrol --reset 9797 # opcontrol &dash;&dash;reset
9742 # opcontrol --start --separate=lib --no-vmlinux -c 5 9798 # opcontrol &dash;&dash;start &dash;&dash;separate=lib &dash;&dash;no-vmlinux -c 5
9743 . 9799 .
9744 . 9800 .
9745 [do whatever is being profiled] 9801 [do whatever is being profiled]
9746 . 9802 .
9747 . 9803 .
9748 # opcontrol --stop 9804 # opcontrol &dash;&dash;stop
9749 # oparchive -o my_archive 9805 # oparchive -o my_archive
9750 </literallayout> 9806 </literallayout>
9751 </para> 9807 </para>