Author: Leah Rowe <email@example.com>
Date: Fri, 14 Oct 2016 10:54:21 +0100
docs/index: re-add information about finding the version (moved from FAQ)
1 file changed, 53 insertions(+), 1 deletion(-)
diff --git a/docs/index.html b/docs/index.html
@@ -196,9 +196,61 @@
<h1>How do I know what version I'm running?</h1>
- See <a href="https://libreboot.org/faq/#version">https://libreboot.org/faq/#version</a>
+ If you are at least 127 commits after release 20150518
+ (commit message <em>build/roms/helper: add version information to CBFS</em>)
+ (or you have any <strong>upstream</strong> stable release of libreboot after 20150518), then you can
+ press C at the GRUB console, and use this command to find out what version of libreboot you have:<br/>
+ <strong>cat (cbfsdisk)/lbversion</strong><br/>
+ This will also work on non-release images (the version string is automatically generated,
+ using <em>git describe --tags HEAD</em>), built from the git repository.
+ A file named <em>version</em> will also be included in the archives that you downloaded (if you are
+ using release archives).
+ If it exists, you can also extract this <em>lbversion</em> file by using the <i>cbfstool</i> utility
+ which libreboot includes, from a ROM image that you either dumped or haven't flashed yet.
+ In your distribution, run cbfstool on your ROM image (<em>libreboot.rom</em>, in this example):<br/>
+ $ <strong>./cbfstool libreboot.rom extract -n lbversion -f lbversion</strong><br/>
+ You will now have a file, named <em>lbversion</em>, which you can read in whatever program
+ it is that you use for reading/writing text files.
+ For git, it's easy. Just check the git log.
+ For releases on or below 20150518, or snapshots generated from the git repository below 127 commits
+ after 20150518, you can find a file named <em>commitid</em> inside the archives. If you are using
+ pre-built ROM images from the libreboot project, you can press C in GRUB for access to the terminal,
+ and then run this command:<br/>
+ You may find a date in here, detailing when that ROM image was built. For pre-built images distributed
+ by the libreboot project, this is a rough approximation of what version you have, because the version
+ numbers are dated, and the release archives are typically built on the same day as the release; you can
+ correlate that with the release information in <a href="release.html">release.html</a>.
+ For 20160818, note that the lbversion file was missing from CBFS on GRUB images. You can still find out
+ what libreboot version you have by comparing checksums of image dumps (with the descriptor blanked out with 00s,
+ and the same done to the ROMs from the release archive, if you are on a GM45 laptop).
+ There may also be a ChangeLog file included in your release archive, so that you can
+ look in there to figure out what version you have.
+ You can also check the documentation that came with your archives, and in <em>docs/release.html</em> will be
+ the information about the version of libreboot that you are using.
+ Generally speaking, it is advisable to use the latest version of libreboot.