Latest revision as of 15:39, 11 October 2016

PC System Flash emulation was added for QEMU in pc-1.1.

Flash Hardware

Uses CFI flash support in hw/pflash_cfi01.c.

Command line interface

Usage of -bios and -pflash parameters as of pc-1.1:

KVM enabled	-pflash used	-bios used	Result
No	Yes	-	-pflash parameter will be loaded as flash image just below 4GB. 'bios.bin' and -bios parameter will be ignored.
	No	No	'bios.bin' will be used to create a read-only pflash drive. A flash device is available, but it is read-only.
	No	Yes	-bios parameter will be used to create a read-only pflash drive. A flash device is available, but it is read-only.
Yes	Yes	-	An error message condition: PC system firmware (pflash) not available
	No	No	'bios.bin' will be loaded as rom image. No system flash is available.
	No	Yes	-bios parameter filename will be loaded as rom image. No system flash is available.

pflash drives

The flash image can be any drive image format supported by QEMU.

There are two ways to add the pflash drive when launching qemu-system-i386 or qemu-system-x86_64:

Use the -pflash parameter
Use the -drive parameter with if=pflash

@@ Line 1: / Line 1: @@
-This is a proposal for PC System Flash emulation for on QEMU/KVM.
+PC System Flash emulation was added for QEMU in pc-1.1.
 =Flash Hardware=
-Leverage the pre-existing CFI flash support in qemu/hw/pflash_cfi01.c.  (Another option is to use qemu/hw/pflash_cfi02.c.)
+Uses CFI flash support in hw/pflash_cfi01.c.
 =Command line interface=
-Today the (currently existing) -pflash parameter has no use with
+Usage of -bios and -pflash parameters as of pc-1.1:
-an x86 or x86-64 system.  To enable PC system flash, this parameter
-would now be used on x86 & x86-64 systems.
-The -bios parameter would take priority over
--pflash, but one or both could be used with qemu/kvm as follows:
 {| class='wikitable' border=1
-! -bios used !! -pflash used !! Result
+! KVM enabled !! -pflash used !! -bios used !! Result
 |-
-| <Center>No</Center> || <Center>No</Center> || (no change) 'bios.bin' will be loaded as rom image.
+|rowspan=3 | <Center>No</Center>
+| <Center>Yes</Center> || <Center>-</Center>
+| -pflash parameter will be loaded as flash image just below 4GB.
+'bios.bin' and -bios parameter will be ''ignored''.
 |-
-| <Center>Yes</Center> || <Center>No</Center> || (no change) -bios parameter will be loaded as rom image.
+| <Center>No</Center> || <Center>No</Center>
+| 'bios.bin' will be used to create a read-only pflash drive.
+A flash device is available, but it is read-only.
 |-
 | <Center>No</Center> || <Center>Yes</Center>
-| ('''changing''') -pflash parameter will be loaded as flash image just below 4GB.
+| -bios parameter will be used to create a read-only pflash drive.
+A flash device is available, but it is read-only.
+|-
+|rowspan=3 | <Center>Yes</Center>
+|| <Center>Yes</Center> || <Center>-</Center>
+| An error message condition:
+PC system firmware (pflash) not available
+|-
+|| <Center>No</Center> || <Center>No</Center>
+| 'bios.bin' will be loaded as rom image.
-'bios.bin' will be ''ignored''.
+No system flash is available.
 |-
-| <Center>Yes</Center> || <Center>Yes</Center>
+| <Center>No</Center> || <Center>Yes</Center>
-| ('''changing''') -bios parameter will be loaded as rom image just below 4GB.
+| -bios parameter filename will be loaded as rom image.
--pflash parameter will be loaded as flash image just below the bios rom image.
+No system flash is available.
 |}
+==pflash drives==
+The flash image can be any drive image format supported by QEMU.
+There are two ways to add the pflash drive when launching qemu-system-i386 or qemu-system-x86_64:
+# Use the -pflash parameter
+# Use the -drive parameter with if=pflash
+[[Category:Completed feature pages]]