diff options
author | Leah Rowe <info@minifree.org> | 2017-04-03 20:57:12 +0200 |
---|---|---|
committer | Gogs <gogitservice@gmail.com> | 2017-04-03 20:57:12 +0200 |
commit | e5d71ae5577d2ebafbda4a43a20211e996365d3f (patch) | |
tree | 031c0024b35c735a9461b1456fda5d125e7fe901 /docs/gnulinux/grub_cbfs.md | |
parent | f02ec452b4628e87121412e14ad9899cd85f98d5 (diff) | |
parent | 26c4759b17383087f7eba9f765dc63327d905a02 (diff) | |
download | librebootfr-e5d71ae5577d2ebafbda4a43a20211e996365d3f.tar.gz librebootfr-e5d71ae5577d2ebafbda4a43a20211e996365d3f.zip |
Merge branch 'web/code-blocks' of vimuser/libreboot into master
Diffstat (limited to 'docs/gnulinux/grub_cbfs.md')
-rw-r--r-- | docs/gnulinux/grub_cbfs.md | 49 |
1 files changed, 28 insertions, 21 deletions
diff --git a/docs/gnulinux/grub_cbfs.md b/docs/gnulinux/grub_cbfs.md index 538a04fd..9809785f 100644 --- a/docs/gnulinux/grub_cbfs.md +++ b/docs/gnulinux/grub_cbfs.md @@ -45,6 +45,7 @@ Table of Contents + Introduction ------------ @@ -122,8 +123,8 @@ Acquire the necessary utilities {#tools} Use ***cbfstool*** and ***flashrom***. There are available in the *libreboot\_util* release archive, or they can be compiled (see [../git/\#build\_flashrom](../git/#build_flashrom)). Flashrom is also -available from the repositories:\ -\# **pacman -S flashrom** +available from the repositories: + # pacman -S flashrom [Back to top of page.](#pagetop) @@ -138,12 +139,13 @@ flashed. For the purpose of this tutorial it is assumed that your ROM image file is named *libreboot.rom*, so please make sure to adapt. ROM images are included pre-compiled in libreboot. You can also dump -your current firmware, using flashrom:\ -\$ **sudo flashrom -p internal -r libreboot.rom**\ -\# **flashrom -p internal -r libreboot.rom**\ +your current firmware, using flashrom: + $ sudo flashrom -p internal -r libreboot.rom + # flashrom -p internal -r libreboot.rom If you are told to specify the chip, add the option **-c {your chip}** -to the command, for example:\ -\# **flashrom -c MX25L6405 -p internal -r libreboot.rom** +to the command, for example: + + # flashrom -c MX25L6405 -p internal -r libreboot.rom [Back to top of page.](#pagetop) @@ -152,8 +154,9 @@ to the command, for example:\ Extract grubtest.cfg from the ROM image {#extract_testconfig} --------------------------------------- -You can check the contents of the ROM image, inside CBFS:\ -**\$ cd \.../libreboot\_util/cbfstool** **\$ ./cbfstool libreboot.rom +You can check the contents of the ROM image, inside CBFS: + + $ cd \.../libreboot\_util/cbfstool** $ ./cbfstool libreboot.rom print** The files *grub.cfg* and *grubtest.cfg* should be present. grub.cfg is @@ -161,8 +164,9 @@ loaded by default, with a menuentry for switching to grubtest.cfg. In this tutorial, you will first modify and test *grubtest.cfg*. This is to reduce the possibility of bricking your device, so DO NOT SKIP THIS! -Extract grubtest.cfg from the ROM image:\ -**\$ ./cbfstool libreboot.rom extract -n grubtest.cfg -f grubtest.cfg** +Extract grubtest.cfg from the ROM image: + + $ ./cbfstool libreboot.rom extract -n grubtest.cfg -f grubtest.cfg Modify the grubtest.cfg accordingly. @@ -174,8 +178,9 @@ Re-insert the modified grubtest.cfg into the ROM image {#reinsert_modified_testc ------------------------------------------------------ Once your grubtest.cfg is modified and saved, delete the unmodified -config from the ROM image:\ -**\$ ./cbfstool libreboot.rom remove -n grubtest.cfg** +config from the ROM image: + + $ ./cbfstool libreboot.rom remove -n grubtest.cfg Next, insert the modified version:\ **\$ ./cbfstool libreboot.rom add -n grubtest.cfg -f grubtest.cfg -t @@ -190,12 +195,12 @@ Testing **Now you have a modified ROM. Refer back to [../install/\#flashrom](../install/#flashrom) for information on how to -flash it.\ -\$ **cd /libreboot\_util** \# **./flash update libreboot.rom**\ +flash it. + $ cd /libreboot\_util** \# **./flash update libreboot.rom\ Ocassionally, coreboot changes the name of a given board. If flashrom complains about a board mismatch, but you are sure that you chose the -correct ROM image, then run this alternative command:\ -\# **./flash forceupdate libreboot.rom**\ +correct ROM image, then run this alternative command: + # ./flash forceupdate libreboot.rom You should see **"Verifying flash\... VERIFIED."** written at the end of the flashrom output. Once you have done that, shut down and then boot up with your new test configuration.** @@ -227,11 +232,13 @@ the already modified config). From /libreboot\_util/cbfstool, do:\ 's:Switch to grub.cfg:Switch to grubtest.cfg:g' < grubtest.cfg > grub.cfg**\ -Delete the grub.cfg that remained inside the ROM:\ -**\$ ./cbfstool libreboot.rom remove -n grub.cfg** +Delete the grub.cfg that remained inside the ROM: + + $ ./cbfstool libreboot.rom remove -n grub.cfg + +Add the modified version that you just made: -Add the modified version that you just made:\ -**\$ ./cbfstool libreboot.rom add -n grub.cfg -f grub.cfg -t raw** + $ ./cbfstool libreboot.rom add -n grub.cfg -f grub.cfg -t raw **Now you have a modified ROM. Again, refer back to [../install/\#flashrom](../install/#flashrom) for information on how to |