diff options
author | Francis Rowe <info@gluglug.org.uk> | 2015-02-14 20:14:27 (EST) |
---|---|---|
committer | Francis Rowe <info@gluglug.org.uk> | 2015-02-14 23:20:27 (EST) |
commit | b840755acc24f5cebe561d5ecb3380e157de1583 (patch) | |
tree | 52869222b2994e151768efc9bb9fd75c3156e0e0 /docs | |
parent | 2080a1ffcf025f0cbb27f6c00f7165adfe7ec248 (diff) | |
download | libreboot-b840755acc24f5cebe561d5ecb3380e157de1583.zip libreboot-b840755acc24f5cebe561d5ecb3380e157de1583.tar.gz libreboot-b840755acc24f5cebe561d5ecb3380e157de1583.tar.bz2 |
Move all build scripts into a single generic script, with helpers
All build scripts were moved to resources/scripts/helpers/
Diffstat (limited to 'docs')
-rw-r--r-- | docs/git/index.html | 99 | ||||
-rw-r--r-- | docs/gnulinux/grub_cbfs.html | 2 | ||||
-rw-r--r-- | docs/grub/index.html | 4 | ||||
-rw-r--r-- | docs/hcl/gm45_remove_me.html | 10 | ||||
-rw-r--r-- | docs/release.html | 3 |
5 files changed, 68 insertions, 50 deletions
diff --git a/docs/git/index.html b/docs/git/index.html index e6682d1..320f309 100644 --- a/docs/git/index.html +++ b/docs/git/index.html @@ -51,15 +51,19 @@ <p> Before doing anything, you need the dependencies first. This is true if you want to build libreboot from source, with either libreboot_src.tar.xz or git. - <b>If you are using libreboot_bin.tar.xz (binary archive) then you can ignore this, because + <b>If you are using libreboot_util.tar.xz (binary archive) then you can ignore this, because ROM images and statically compiled executables for the utilities are included.</b> </p> - <ul> - <li><b>deps-trisquel</b> script installs dependencies for Trisquel 6 (also tested in Trisquel 7).</li> - </ul> + + <div class="important"> + <p> + For Trisquel 7, you can run the following command:<br/> + $ <b>sudo ./resources/scripts/dependencies/trisquel7dependencies</b> + </p> + </div> <p> - For all other GNU/Linux distributions, you may have to adapt these scripts. By all means send patches! + For other GNU/Linux distributions, you can adapt the Trisquel 7 script for your needs. </p> <p><a href="#pagetop">Back to top of page</a></p> @@ -105,7 +109,7 @@ <p> After that, run the script:<br/> - <b>$ ./download everything</b> + $ <b>./download everything</b> </p> <p> @@ -143,7 +147,7 @@ </p> <p> - BUC.TS utility is included in libreboot_src.tar.xz and libreboot_bin.tar.xz.<br/> + BUC.TS utility is included in libreboot_src.tar.xz and libreboot_util.tar.xz.<br/> <b>If you downloaded from git, follow <a href="#build_meta">#build_meta</a> before you proceed.</b> </p> @@ -162,7 +166,12 @@ <p> To build bucts, do this in the main directory:<br/> - <b>$ ./builddeps-bucts</b> + $ <b>./build module bucts</b> + </p> + + <p> + To statically compile it, do this:<br/> + $ <b>./build module bucts static</b> </p> <p> @@ -182,7 +191,7 @@ </p> <p> - Flashrom source code is included in libreboot_src.tar.gz and libreboot_bin.tar.gz.<br/> + Flashrom source code is included in libreboot_src.tar.xz and libreboot_util.tar.xz.<br/> <b>If you downloaded from git, follow <a href="#build_meta">#build_meta</a> before you proceed.</b> </p> @@ -197,8 +206,13 @@ </p> <p> - To build it, do that in the main directory:<br/> - <b>$ ./builddeps-flashrom</b> + To build it, do the following in the main directory:<br/> + $ <b>./build module flashrom</b> + </p> + + <p> + To statically compile it, do the following in the main directory:<br/> + $ <b>./build module flashrom static</b> </p> <p> @@ -577,7 +591,7 @@ <div class="section"> - <h1 id="build">How to build the ROM images!</h1> + <h1 id="build">How to build the ROM images</h1> <p>You don't need to do much, as there are scripts already written for you that can build everything automatically.</p> @@ -596,45 +610,50 @@ If you downloaded libreboot from git, refer to <a href="#build_meta">#build_meta</a>. </p> - <p>If running for the first time, run this:<br/> - <b>$ ./buildall</b> (also performs the "./build" step below)<br/> - Or if you only want to build dependencies (crossgcc, grub and so on):<br/> - <b>$ ./builddeps</b></p> - - <p>If you've already run ./builddeps and/or ./buildall before, you don't need to run them again. - Just run that from now on to build the ROM images:<br/> - <b>$ ./build</b></p> + <p> + Build all of the components used in libreboot:<br/> + $ <b>./build module all</b> + </p> - <p>To un-build (clean) the build dependencies that you built before, do the following:<br/> - This also deletes the ROM images under ./bin/:<br/> - <b>$ ./cleandeps</b></p> + <p> + After that, build the ROM images:<br/> + $ <b>./build roms withgrub</b> + </p> - <p>Note: after running 'cleandeps', you will need to run 'builddeps' or 'buildall' again before you can use 'build'.</p> + <p> + To clean (reverse) everything, do the following:<br/> + $ <b>./build clean all</b> + </p> - <p>After 'build' or 'buildall' has finished, you'll find the ROM images for each machine under ./bin/</p> + <p> + The ROM images will be stored under <b>bin/</b>. + </p> <div class="subsection"> <h2>Preparing release archives (optional)</h2> <p> - Run that script:<br/> - <b>$ ./build-release</b> + Do the following:<br/> + $ <b>./build release archives</b> </p> <p> - If you are building on an i686 host, this will include statically linked 32-bit binaries in the binary release archive that you created, + If you are building on an i686 host, this will include statically linked 32-bit binaries in + the binary release archive that you created, for: <b>nvramtool, cbfstool, bucts, flashrom, ich9deblob, cbmem</b>. </p> <p> - If you are building on an x86_64 host, this will include statically linked 32- and 64-bit binaries for <b>cbmem</b>, <b>ich9deblob</b>, <b>cbfstool</b> and <b>nvramtool</b>, while <b>flashrom</b> - and <b>bucts</b> will be included only as 64-bit statically linked binaries. <b>To include a statically linked flashrom and bucts for i686, you - will need to build them on a chroot, a virtual machine or a real 32-bit system. You can find the build dependencies for these packages listed in deps-*</b> + If you are building on an x86_64 host, this will include statically linked 32- and 64-bit binaries for + <b>cbmem</b>, <b>ich9deblob</b>, <b>cbfstool</b> and <b>nvramtool</b>, while <b>flashrom</b> + and <b>bucts</b> will be included only as 64-bit statically linked binaries. <b>To include a statically + linked flashrom and bucts for i686, you will need to build them on a chroot, a virtual machine or a real + 32-bit system. You can find the build dependencies for these packages listed in deps-*</b> </p> <p> - armv7l binaries (tested on a BeagleBone Black) are also included in libreboot_bin, for: + armv7l binaries (tested on a BeagleBone Black) are also included in libreboot_util, for: </p> <ul> <li>cbfstool</li> @@ -645,25 +664,25 @@ <p> If you are building 32-bit binaries on a live system or chroot (for flashrom/bucts), you can use the following to statically link them:<br/> - $ <b>./builddeps-flashrom static</b><br/> - $ <b>./builddeps-bucts static</b> + $ <b>./build module flashrom static</b><br/> + $ <b>./build module bucts static</b> </p> <p> - The same as above applies for ARM (except, building bucts on ARM is pointless, and for flashrom + The same conditions as above apply for ARM (except, building bucts on ARM is pointless, and for flashrom you only need the normal executable since the lenovobios_sst and _macronix executables are meant to run on an X60/T60 while lenovo bios is present, working around the security restrictions). </p> <p> - The script <b>mkextbuild</b> will generate a small source tarball called <b>tobuild.tar.xz</b> that - contains everything you need (including source) with which to build flashrom/bucts on these hosts. - The <b>build-release</b> script will have already executed this script for you, so the archive should - already exist. + The command that you used for generating the release archives will also run the following command:<br/> + $ <b>./build external source</b><br/> + The archive <b>tobuild.tar.xz</b> will have been created, containing bucts, flashrom and all other required + resources for building them. </p> <p> - You'll find that the files libreboot_bin.tar.xz and libreboot_src.tar.xz have been created. + You'll find that the files libreboot_util.tar.xz and libreboot_src.tar.xz have been created. </p> </div> diff --git a/docs/gnulinux/grub_cbfs.html b/docs/gnulinux/grub_cbfs.html index 73cce0c..874ebaf 100644 --- a/docs/gnulinux/grub_cbfs.html +++ b/docs/gnulinux/grub_cbfs.html @@ -152,7 +152,7 @@ executable. </p> <p> - Alternatively if you are working with libreboot_bin, you will find binaries under ./cbfstool/ + Alternatively if you are working with libreboot_util, you will find binaries under ./cbfstool/ </p> <p> diff --git a/docs/grub/index.html b/docs/grub/index.html index e37d7d7..e9e2c35 100644 --- a/docs/grub/index.html +++ b/docs/grub/index.html @@ -50,7 +50,7 @@ <p>This is a free font that is also contained in GNU/Linux distributions like Trisquel or Parabola.</p> <p><b>$ cd libreboot_src/grub</b><br/> - compile grub ('build' script has the info on how to do this)<br/> + compile grub (the build scripts info on how to do this)<br/> come back out into libreboot_src/resources/grub:<br/> <b>$ cd ../libreboot_src/resources/grub/font</b></p> @@ -95,7 +95,7 @@ </p> <p> - The scripts <b>build</b> and <b>buildrom-withgrub</b> will automatically see this, and automatically build + The build scripts will automatically see this, and automatically build ROM images with your custom layout (given the name) and include them under bin. Example: <b>libreboot_frazerty.rom</b>. </p> diff --git a/docs/hcl/gm45_remove_me.html b/docs/hcl/gm45_remove_me.html index d6c36f4..eff0eac 100644 --- a/docs/hcl/gm45_remove_me.html +++ b/docs/hcl/gm45_remove_me.html @@ -96,8 +96,8 @@ <p> ich9gen executables can be found under ./ich9deblob/ statically compiled in - libreboot_bin. If you are using src or git, build ich9gen from source with:<br/> - $ <b>./builddeps-ich9deblob</b><br/> + libreboot_util. If you are using src or git, build ich9gen from source with:<br/> + $ <b>./build module ich9deblob</b><br/> The executable will appear under resources/utilities/ich9deblob/ </p> @@ -138,13 +138,13 @@ </p> <p> If you are working with libreboot_src (or git), you can find the source under resources/utilities/ich9deblob/ - and will already be compiled if you ran ./builddeps or ./builddeps-ich9deblob from the main directory (./), + and will already be compiled if you ran <b>./build module all</b> or <b>./build module ich9deblob</b> from the main directory (./), otherwise you can build it like so:<br/> - $ <b>./builddeps-ich9deblob</b><br/> + $ <b>./build module ich9deblob</b><br/> An executable file named <b>ich9deblob</b> will now appear under resources/utilities/ich9deblob/ </p> <p> - If you are working with libreboot_bin release archive, you can find the utility included, statically compiled + If you are working with libreboot_util release archive, you can find the utility included, statically compiled (for i686 and x86_64 on GNU/Linux) under ./ich9deblob/. </p> diff --git a/docs/release.html b/docs/release.html index edc24e3..ad0422a 100644 --- a/docs/release.html +++ b/docs/release.html @@ -36,8 +36,7 @@ </p> <p> You can verify the downloaded archives as follows:<br/> - $ <b>gpg --verify libreboot_src.tar.xz.sig</b><br/> - $ <b>gpg --verify libreboot_bin.tar.xz.sig</b> + $ <b>for signature in $(ls libreboot*.tar.xz.sig); do gpg --verify $signature; done</b> </p> </div> |