Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 1 | .TH ABUILD 1 "May 3, 2008" |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 2 | .SH NAME |
Stefan Reinauer | f8ee180 | 2008-01-18 15:08:58 +0000 | [diff] [blame] | 3 | abuild \- build coreboot images for all available targets |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 4 | .SH SYNOPSIS |
| 5 | .B abuild |
Uwe Hermann | 4e00640 | 2009-04-15 16:07:27 +0000 | [diff] [blame] | 6 | \fR[\fB\-abrvxsTVh\fR] [\fB\-c\fR numcpus|max] [\fB\-t\fR vendor/board] [\fB\-p\fR dir] |
Jonathan Neuschäfer | da6ad0b | 2018-09-30 20:09:59 +0200 | [diff] [blame] | 7 | [CBROOT] |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 8 | .SH DESCRIPTION |
| 9 | .B abuild |
Stefan Reinauer | f8ee180 | 2008-01-18 15:08:58 +0000 | [diff] [blame] | 10 | is a utility used to easily build coreboot images for all available targets. |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 11 | .SH OPTIONS |
| 12 | The |
Jonathan Neuschäfer | da6ad0b | 2018-09-30 20:09:59 +0200 | [diff] [blame] | 13 | .B "[CBROOT]" |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 14 | parameter tells |
| 15 | .B abuild |
Stefan Reinauer | f8ee180 | 2008-01-18 15:08:58 +0000 | [diff] [blame] | 16 | where the root directory of the coreboot build tree resides. Per default |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 17 | this is |
| 18 | .B "../.." |
| 19 | as the |
| 20 | .B abuild |
| 21 | script resides in |
Stefan Reinauer | f8ee180 | 2008-01-18 15:08:58 +0000 | [diff] [blame] | 22 | .BR "[CBROOT]/utils/abuild" . |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 23 | .TP |
| 24 | .B "\-a, \-\-all" |
| 25 | Build previously succeeded ports as well. |
| 26 | .TP |
| 27 | .B "\-b, \-\-broken" |
| 28 | Attempt to build ports that are known to be broken. |
| 29 | .TP |
| 30 | .B "\-p, \-\-payloads <dir>" |
| 31 | Use payloads in |
| 32 | .B "<dir>" |
Stefan Reinauer | 7336815 | 2006-10-25 19:08:12 +0000 | [diff] [blame] | 33 | to build images. This will run payload.sh in that directory to find out the |
Stefan Reinauer | 0caddbd | 2006-10-28 16:00:24 +0000 | [diff] [blame] | 34 | path of the payload. |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 35 | .TP |
| 36 | .B "\-t, \-\-target <vendor/board>" |
| 37 | Attempt to build target vendor/board only. |
| 38 | .TP |
Uwe Hermann | 4e00640 | 2009-04-15 16:07:27 +0000 | [diff] [blame] | 39 | .B "\-r, \-\-remove" |
| 40 | Remove mainboard build directory after the respective target has been |
| 41 | built. This is mainly used for development purposes, when you don't need |
| 42 | the actual build output, but rather only want to know if a build failed |
| 43 | or not. |
| 44 | .TP |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 45 | .B "\-x, \-\-xml" |
| 46 | Write an XML log file instead of a plain-text one. |
| 47 | The file will be called |
| 48 | .B abuild.xml |
| 49 | and will be created in the current directory. |
| 50 | .TP |
Stefan Reinauer | 3a14057 | 2006-10-25 19:02:34 +0000 | [diff] [blame] | 51 | .B "\-T, \-\-test" |
| 52 | Submit generated image(s) to the automated test system. |
Stefan Reinauer | 14e2277 | 2010-04-27 06:56:47 +0000 | [diff] [blame] | 53 | The results of the tests will be made available at |
Paul Menzel | a8843de | 2017-06-05 12:33:23 +0200 | [diff] [blame] | 54 | .B https://qa.coreboot.org/log_manual.php |
Stefan Reinauer | 3a14057 | 2006-10-25 19:02:34 +0000 | [diff] [blame] | 55 | .TP |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 56 | .B "\-c, \-\-cpus [<numcpus>|max]" |
Stefan Reinauer | 14e2277 | 2010-04-27 06:56:47 +0000 | [diff] [blame] | 57 | Build on |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 58 | .B numcpus |
Stefan Reinauer | 14e2277 | 2010-04-27 06:56:47 +0000 | [diff] [blame] | 59 | cpus at the same time, or on all available with |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 60 | .B max\fR. |
| 61 | .TP |
| 62 | .B "\-s, \-\-silent" |
| 63 | Don't print any compiler calls in the log files. In coreboot v2 compiler |
| 64 | calls are quite long, so it is hard to find the warnings between them. |
| 65 | .TP |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 66 | .B "\-v, \-\-verbose" |
| 67 | More verbose output. |
| 68 | .TP |
| 69 | .B "\-h, \-\-help" |
| 70 | Show a help text and exit. |
| 71 | .TP |
| 72 | .B "\-V, \-\-version" |
| 73 | Show version information and exit. |
| 74 | .SH BUGS |
Martin Roth | 48a243b | 2014-12-07 22:25:02 -0700 | [diff] [blame] | 75 | Please report any bugs on the coreboot mailing list |
Paul Menzel | a8843de | 2017-06-05 12:33:23 +0200 | [diff] [blame] | 76 | .RB "(" https://coreboot.org/Mailinglist ")." |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 77 | .SH LICENCE |
| 78 | .B abuild |
| 79 | is covered by the GNU General Public License (GPL), version 2 or later. |
| 80 | .SH SEE ALSO |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 81 | .BR flashrom (1). |
| 82 | .SH COPYRIGHT |
| 83 | 2004 Stefan Reinauer |
| 84 | .br |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 85 | 2006-2008 coresystems GmbH |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 86 | .SH AUTHORS |
Stefan Reinauer | 3a14057 | 2006-10-25 19:02:34 +0000 | [diff] [blame] | 87 | Stefan Reinauer <stepan@coresystems.de> |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 88 | .PP |
| 89 | This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>. |
| 90 | It is licensed under the terms of the GNU GPL (v2 or later). |