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 |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 6 | \fR[\fB\-abvxsTVh\fR] [\fB\-c\fR numcpus|max] [\fB\-t\fR vendor/board] [\fB\-p\fR dir] |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 7 | [LBROOT] |
| 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 |
| 13 | .B "[LBROOT]" |
| 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 |
| 39 | .B "\-x, \-\-xml" |
| 40 | Write an XML log file instead of a plain-text one. |
| 41 | The file will be called |
| 42 | .B abuild.xml |
| 43 | and will be created in the current directory. |
| 44 | .TP |
Stefan Reinauer | 3a14057 | 2006-10-25 19:02:34 +0000 | [diff] [blame] | 45 | .B "\-T, \-\-test" |
| 46 | Submit generated image(s) to the automated test system. |
| 47 | The results of the tests will be made available at |
Stefan Reinauer | f8ee180 | 2008-01-18 15:08:58 +0000 | [diff] [blame] | 48 | .B http://qa.coreboot.org/log_manual.php |
Stefan Reinauer | 3a14057 | 2006-10-25 19:02:34 +0000 | [diff] [blame] | 49 | .TP |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 50 | .B "\-c, \-\-cpus [<numcpus>|max]" |
| 51 | Build on |
| 52 | .B numcpus |
| 53 | cpus at the same time, or on all available with |
| 54 | .B max\fR. |
| 55 | .TP |
| 56 | .B "\-s, \-\-silent" |
| 57 | Don't print any compiler calls in the log files. In coreboot v2 compiler |
| 58 | calls are quite long, so it is hard to find the warnings between them. |
| 59 | .TP |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 60 | .B "\-v, \-\-verbose" |
| 61 | More verbose output. |
| 62 | .TP |
| 63 | .B "\-h, \-\-help" |
| 64 | Show a help text and exit. |
| 65 | .TP |
| 66 | .B "\-V, \-\-version" |
| 67 | Show version information and exit. |
| 68 | .SH BUGS |
Stefan Reinauer | f8ee180 | 2008-01-18 15:08:58 +0000 | [diff] [blame] | 69 | Please report any bugs at http://tracker.coreboot.org/. |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 70 | .SH LICENCE |
| 71 | .B abuild |
| 72 | is covered by the GNU General Public License (GPL), version 2 or later. |
| 73 | .SH SEE ALSO |
| 74 | .BR romcc (1), |
| 75 | .BR flashrom (1). |
| 76 | .SH COPYRIGHT |
| 77 | 2004 Stefan Reinauer |
| 78 | .br |
Stefan Reinauer | 02a4e7f | 2008-05-27 18:29:26 +0000 | [diff] [blame] | 79 | 2006-2008 coresystems GmbH |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 80 | .SH AUTHORS |
Stefan Reinauer | 3a14057 | 2006-10-25 19:02:34 +0000 | [diff] [blame] | 81 | Stefan Reinauer <stepan@coresystems.de> |
Stefan Reinauer | 0bece04 | 2006-09-21 13:09:22 +0000 | [diff] [blame] | 82 | .PP |
| 83 | This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>. |
| 84 | It is licensed under the terms of the GNU GPL (v2 or later). |