Skip to content

Commit

Permalink
README: document output files
Browse files Browse the repository at this point in the history
A grumpy BMC developer was wondering which file to flash to the machines
they were testing on. They longed for the old days where the answer was
'skiboot.lid'. Alas, those days are long past.

This updates the readme with a list of the current output formats and
where you might want to use them.

Signed-off-by: Joel Stanley <joel@jms.id.au>
[stewart: fix P8/P9 thing]
Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
  • Loading branch information
shenki authored and stewartsmith committed Mar 1, 2018
1 parent fbdc91e commit 0df8916
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,25 @@ You probably want to read the linux
https://kernel.org/doc/html/latest/process/submitting-patches.html as
much of it applies to skiboot.


## Output files

The Skiboot build process produces a bunch of different outputs. This is what
they are, and where you should use them:

skiboot.elf: The output of the linker. Don't flash to a system, but useful when debugging

skiboot.lid: The raw binary object, named .lid because IBM. Flash this on
really old P8 systems, the POWER Functional Simulator (mambo), or
FSP systems

skiboot.lid.stb: Lid wrapped with secure boot header. Use on FSP systems

skiboot.lid.xz: Compressed raw binary. Use this on a OpenPower P8

skiboot.lid.xz.stb: Compressed raw binary wrapped with a secure boot header.
Use this on OpenPower P9 systems

## License

See LICENSE

0 comments on commit 0df8916

Please sign in to comment.