summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
authorMark Asselstine <mark.asselstine@windriver.com>2020-02-18 16:33:28 -0500
committerRichard Purdie <richard.purdie@linuxfoundation.org>2020-03-11 14:41:44 +0000
commitcff864901861f80e0c3ed030499ae88d5f01befc (patch)
treef85cd59aaf8615f1f836fb18e98d4c0660c96317 /documentation/dev-manual
parent0daf901b5be2c1e3ac7e4c274b293e4679ecc10d (diff)
downloadpoky-cff864901861f80e0c3ed030499ae88d5f01befc.tar.gz
manuals: Updates to reflect that MACHINE defaults to qemux86-64
meta-yocto commit 69ddecdb1516 [local.conf.sample: change default MACHINE to qemux86-64] switched the default MACHINE from 'qemux86' to 'qemux86-64' but some documents which either explicitly mentioned the default, or where this was implicit didn't receive an equivalent update. Where it made sense we continue this change in default to the docs. In other places, such as the kernel-dev manual, we note the new default and instruct the user how to switch back to 'qemux86'. Eventually we should probably update the kernel-dev manual to use the default, but for now the intention was to limit the impact of these changes. Note that ext3 has also been replaced with ext4 for image generation, so while we are modifying runqemu lines to qemux86-64 we also make the change to reference ext4 such that the runqemu commands will function properly. (From yocto-docs rev: 8c1d8ab1170f47a2c2692beb903ab0b7c6835b7b) Signed-off-by: Mark Asselstine <mark.asselstine@windriver.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-qemu.xml22
1 files changed, 11 insertions, 11 deletions
diff --git a/documentation/dev-manual/dev-manual-qemu.xml b/documentation/dev-manual/dev-manual-qemu.xml
index f5a0d64afe..5ccc0dfe83 100644
--- a/documentation/dev-manual/dev-manual-qemu.xml
+++ b/documentation/dev-manual/dev-manual-qemu.xml
@@ -151,13 +151,13 @@
151 <itemizedlist> 151 <itemizedlist>
152 <listitem><para> 152 <listitem><para>
153 This example starts QEMU with 153 This example starts QEMU with
154 <replaceable>MACHINE</replaceable> set to "qemux86". 154 <replaceable>MACHINE</replaceable> set to "qemux86-64".
155 Assuming a standard 155 Assuming a standard
156 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>, 156 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>,
157 <filename>runqemu</filename> automatically finds the 157 <filename>runqemu</filename> automatically finds the
158 <filename>bzImage-qemux86.bin</filename> image file and 158 <filename>bzImage-qemux86-64.bin</filename> image file and
159 the 159 the
160 <filename>core-image-minimal-qemux86-20140707074611.rootfs.ext3</filename> 160 <filename>core-image-minimal-qemux86-64-20200218002850.rootfs.ext4</filename>
161 (assuming the current build created a 161 (assuming the current build created a
162 <filename>core-image-minimal</filename> image). 162 <filename>core-image-minimal</filename> image).
163 <note> 163 <note>
@@ -166,7 +166,7 @@
166 timestamp. 166 timestamp.
167 </note> 167 </note>
168 <literallayout class='monospaced'> 168 <literallayout class='monospaced'>
169 $ runqemu qemux86 169 $ runqemu qemux86-64
170 </literallayout> 170 </literallayout>
171 </para></listitem> 171 </para></listitem>
172 <listitem><para> 172 <listitem><para>
@@ -175,7 +175,7 @@
175 This command, however, specifically provides the image 175 This command, however, specifically provides the image
176 and root filesystem type. 176 and root filesystem type.
177 <literallayout class='monospaced'> 177 <literallayout class='monospaced'>
178 $ runqemu qemux86 core-image-minimal ext3 178 $ runqemu qemux86-64 core-image-minimal ext4
179 </literallayout> 179 </literallayout>
180 </para></listitem> 180 </para></listitem>
181 <listitem><para> 181 <listitem><para>
@@ -188,7 +188,7 @@
188 be installed (see the previous description for the 188 be installed (see the previous description for the
189 <filename>audio</filename> option for more information). 189 <filename>audio</filename> option for more information).
190 <literallayout class='monospaced'> 190 <literallayout class='monospaced'>
191 $ runqemu qemux86 ramfs audio 191 $ runqemu qemux86-64 ramfs audio
192 </literallayout> 192 </literallayout>
193 </para></listitem> 193 </para></listitem>
194 <listitem><para> 194 <listitem><para>
@@ -200,7 +200,7 @@
200 <replaceable>KERNEL</replaceable>, or 200 <replaceable>KERNEL</replaceable>, or
201 <replaceable>VM</replaceable> option. 201 <replaceable>VM</replaceable> option.
202 <literallayout class='monospaced'> 202 <literallayout class='monospaced'>
203 $ runqemu ext3 203 $ runqemu ext4
204 </literallayout> 204 </literallayout>
205 </para></listitem> 205 </para></listitem>
206 <listitem><para> 206 <listitem><para>
@@ -209,9 +209,9 @@
209 From the <filename>.wic.vmdk</filename>, 209 From the <filename>.wic.vmdk</filename>,
210 <filename>runqemu</filename> determines the QEMU 210 <filename>runqemu</filename> determines the QEMU
211 architecture (<replaceable>MACHINE</replaceable>) to be 211 architecture (<replaceable>MACHINE</replaceable>) to be
212 "qemux86" and the root filesystem type to be "vmdk". 212 "qemux86-64" and the root filesystem type to be "vmdk".
213 <literallayout class='monospaced'> 213 <literallayout class='monospaced'>
214 $ runqemu /home/scott-lenovo/vm/core-image-minimal-qemux86.wic.vmdk 214 $ runqemu /home/scott-lenovo/vm/core-image-minimal-qemux86-64.wic.vmdk
215 </literallayout> 215 </literallayout>
216 </para></listitem> 216 </para></listitem>
217 </itemizedlist> 217 </itemizedlist>
@@ -296,7 +296,7 @@
296 extracts it to a directory named 296 extracts it to a directory named
297 <filename>test-nfs</filename>: 297 <filename>test-nfs</filename>:
298 <literallayout class='monospaced'> 298 <literallayout class='monospaced'>
299 runqemu-extract-sdk ./tmp/deploy/images/qemux86/core-image-sato-qemux86.tar.bz2 test-nfs 299 runqemu-extract-sdk ./tmp/deploy/images/qemux86-64/core-image-sato-qemux86-64.tar.bz2 test-nfs
300 </literallayout> 300 </literallayout>
301 </para></listitem> 301 </para></listitem>
302 <listitem><para> 302 <listitem><para>
@@ -310,7 +310,7 @@
310 Here is an example using the <filename>qemux86</filename> 310 Here is an example using the <filename>qemux86</filename>
311 image: 311 image:
312 <literallayout class='monospaced'> 312 <literallayout class='monospaced'>
313 runqemu qemux86 ./test-nfs 313 runqemu qemux86-64 ./test-nfs
314 </literallayout> 314 </literallayout>
315 </para></listitem> 315 </para></listitem>
316 </orderedlist> 316 </orderedlist>