Coreinfo: Difference between revisions

From coreboot
Jump to navigation Jump to search
mNo edit summary
(Thanks to https://review.coreboot.org/#/c/12454/, libpayload does not to be linked manually anymore and works across all systems.)
 
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
'''coreinfo''' is a small informational [[Payloads|payload]] for coreboot. Currently, it can display CPU information, PCI information, coreboot table information, and show an NVRAM dump.
'''coreinfo''' is a small informational [[Payloads|payload]] for coreboot. Currently, it can display CPU information, PCI information, coreboot table information, show an NVRAM dump, as well as a RAM dump.


== Screenshots ==
== Screenshots ==


<gallery>
<gallery perrow="5">
Image:Coreinfo cpu.png|<small>CPU info</small>
Image:Coreinfo cpu.png|<small>CPU info</small>
Image:Coreinfo pci.png|<small>PCI info</small>
Image:Coreinfo pci.png|<small>PCI info</small>
Image:Coreinfo coreboot.png|<small>coreboot table</small>
Image:Coreinfo coreboot.png|<small>coreboot table</small>
Image:Coreinfo nvram.png|<small>NVRAM dump</small>
Image:Coreinfo nvram.png|<small>NVRAM dump</small>
Image:Coreinfo ramdump.jpg|<small>RAM dump</small>
</gallery>
</gallery>


== Downloading and building coreinfo ==
== Building coreinfo ==
 
[[libpayload]] and coreinfo are in the '''payloads/''' directory of the coreboot tree. If you have already checked out the tree, you can skip the git clone steps below.
 
$ '''git clone http://review.coreboot.org/p/coreboot'''
 
=== libpayload ===


The coreinfo payload uses [[libpayload]], thus you need to get that first and build it:
The coreinfo payload uses [[libpayload]], thus you need to get that first and build it:


  $ svn co svn://coreboot.org/repos/trunk/payloads/libpayload
  $ '''cd coreboot/payloads/libpayload'''
  $ cd libpayload
  $ '''make menuconfig'''
$ make menuconfig
  $ '''make install'''
  $ make
 
=== coreinfo ===


You can then get coreinfo itself and build it:
You can then get coreinfo itself and build it:


  $ cd ..
  $ '''cd coreboot/payloads/coreinfo'''
  $ svn co svn://coreboot.org/repos/trunk/payloads/coreinfo
$ '''make menuconfig'''
  $ cd coreinfo
  $ '''make'''
  $ make menuconfig
 
  $ make
If you are fine with coreboot's default configuration, you can also build coreinfo directly without any steps beforehand as libreboot's build system automatically builds libpayload as a dependency:
 
$ '''make -C coreboot/payloads/coreinfo'''
 
The file '''coreboot/payloads/coreinfo/build/coreinfo.elf''' is your final coreinfo payload which you can use with coreboot, either on real hardware or in a [[QEMU]] image.
 
=== coreboot ===
 
Finally, you have to build coreboot with coreinfo as payload:
 
$ '''cp coreboot/payloads/coreinfo/build/coreinfo.elf coreboot/payload.elf'''
  $ '''cd coreboot'''
  $ '''make menuconfig'''
 
Now enter the '''Payload''' menu and select '''Payload type''' and then '''An ELF executable payload file'''. Then, exit the menu, save your settings, and build coreboot:
 
  $ '''make'''
 
The file '''build/coreboot.rom''' is your final coreboot image, which also contains the coreinfo payload.
 
== Running coreinfo in QEMU ==
 
For running coreboot+coreinfo image in [[QEMU]], you need
 
1 Previously described steps (build coreboot image for QEMU)
 
2 Patched version of '''vgabios-cirrus.bin''' in your '''build''' directory:
 
$ '''cd build'''
$ '''wget http://www.coreboot.org/images/0/0d/Vgabios-cirrus.zip'''
$ '''unzip Vgabios-cirrus.zip'''
$ '''cd ..'''
 
You can now run coreinfo in [[QEMU]]:
 
$ qemu-system-i386 -L build -hda /dev/zero -serial stdio


The file '''build/coreinfo.elf''' is your final coreinfo payload which you can use with coreboot (v2 or v3), either on real hardware or in a QEMU image, e.g. like this:
== Ready-made coreinfo QEMU image ==


$ qemu -L build -hda /dev/zero -serial stdio
If you don't want to build libpayload, coreinfo, and coreboot from source, you can also use the [[QEMU#coreboot_v3_.2B_libpayload_.2B_coreinfo|ready-made coreinfo QEMU image]] by following the instructions on that page.


(where '''build/bios.bin''' is your coreboot v3 image in this case)


{{PD-self}}
{{PD-self}}

Latest revision as of 07:48, 7 December 2015

coreinfo is a small informational payload for coreboot. Currently, it can display CPU information, PCI information, coreboot table information, show an NVRAM dump, as well as a RAM dump.

Screenshots

Building coreinfo

libpayload and coreinfo are in the payloads/ directory of the coreboot tree. If you have already checked out the tree, you can skip the git clone steps below.

$ git clone http://review.coreboot.org/p/coreboot

libpayload

The coreinfo payload uses libpayload, thus you need to get that first and build it:

$ cd coreboot/payloads/libpayload
$ make menuconfig
$ make install

coreinfo

You can then get coreinfo itself and build it:

$ cd coreboot/payloads/coreinfo
$ make menuconfig
$ make

If you are fine with coreboot's default configuration, you can also build coreinfo directly without any steps beforehand as libreboot's build system automatically builds libpayload as a dependency:

$ make -C coreboot/payloads/coreinfo

The file coreboot/payloads/coreinfo/build/coreinfo.elf is your final coreinfo payload which you can use with coreboot, either on real hardware or in a QEMU image.

coreboot

Finally, you have to build coreboot with coreinfo as payload:

$ cp coreboot/payloads/coreinfo/build/coreinfo.elf coreboot/payload.elf
$ cd coreboot
$ make menuconfig

Now enter the Payload menu and select Payload type and then An ELF executable payload file. Then, exit the menu, save your settings, and build coreboot:

$ make

The file build/coreboot.rom is your final coreboot image, which also contains the coreinfo payload.

Running coreinfo in QEMU

For running coreboot+coreinfo image in QEMU, you need

1 Previously described steps (build coreboot image for QEMU)

2 Patched version of vgabios-cirrus.bin in your build directory:

$ cd build
$ wget http://www.coreboot.org/images/0/0d/Vgabios-cirrus.zip
$ unzip Vgabios-cirrus.zip
$ cd ..

You can now run coreinfo in QEMU:

$ qemu-system-i386 -L build -hda /dev/zero -serial stdio

Ready-made coreinfo QEMU image

If you don't want to build libpayload, coreinfo, and coreboot from source, you can also use the ready-made coreinfo QEMU image by following the instructions on that page.


Public domain I, the copyright holder of this work, hereby release it into the public domain. This applies worldwide.

In case this is not legally possible:
I grant anyone the right to use this work for any purpose, without any conditions, unless such conditions are required by law.