blob: 251a91279e704ae857d79f39f920c6de5e4b4595 [file] [log] [blame]
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +00001.TH ABUILD 1 "May 3, 2008"
Stefan Reinauer0bece042006-09-21 13:09:22 +00002.SH NAME
Stefan Reinauerf8ee1802008-01-18 15:08:58 +00003abuild \- build coreboot images for all available targets
Stefan Reinauer0bece042006-09-21 13:09:22 +00004.SH SYNOPSIS
5.B abuild
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +00006\fR[\fB\-abvxsTVh\fR] [\fB\-c\fR numcpus|max] [\fB\-t\fR vendor/board] [\fB\-p\fR dir]
Stefan Reinauer0bece042006-09-21 13:09:22 +00007[LBROOT]
8.SH DESCRIPTION
9.B abuild
Stefan Reinauerf8ee1802008-01-18 15:08:58 +000010is a utility used to easily build coreboot images for all available targets.
Stefan Reinauer0bece042006-09-21 13:09:22 +000011.SH OPTIONS
12The
13.B "[LBROOT]"
14parameter tells
15.B abuild
Stefan Reinauerf8ee1802008-01-18 15:08:58 +000016where the root directory of the coreboot build tree resides. Per default
Stefan Reinauer0bece042006-09-21 13:09:22 +000017this is
18.B "../.."
19as the
20.B abuild
21script resides in
Stefan Reinauerf8ee1802008-01-18 15:08:58 +000022.BR "[CBROOT]/utils/abuild" .
Stefan Reinauer0bece042006-09-21 13:09:22 +000023.TP
24.B "\-a, \-\-all"
25Build previously succeeded ports as well.
26.TP
27.B "\-b, \-\-broken"
28Attempt to build ports that are known to be broken.
29.TP
30.B "\-p, \-\-payloads <dir>"
31Use payloads in
32.B "<dir>"
Stefan Reinauer73368152006-10-25 19:08:12 +000033to build images. This will run payload.sh in that directory to find out the
Stefan Reinauer0caddbd2006-10-28 16:00:24 +000034path of the payload.
Stefan Reinauer0bece042006-09-21 13:09:22 +000035.TP
36.B "\-t, \-\-target <vendor/board>"
37Attempt to build target vendor/board only.
38.TP
39.B "\-x, \-\-xml"
40Write an XML log file instead of a plain-text one.
41The file will be called
42.B abuild.xml
43and will be created in the current directory.
44.TP
Stefan Reinauer3a140572006-10-25 19:02:34 +000045.B "\-T, \-\-test"
46Submit generated image(s) to the automated test system.
47The results of the tests will be made available at
Stefan Reinauerf8ee1802008-01-18 15:08:58 +000048.B http://qa.coreboot.org/log_manual.php
Stefan Reinauer3a140572006-10-25 19:02:34 +000049.TP
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +000050.B "\-c, \-\-cpus [<numcpus>|max]"
51Build on
52.B numcpus
53cpus at the same time, or on all available with
54.B max\fR.
55.TP
56.B "\-s, \-\-silent"
57Don't print any compiler calls in the log files. In coreboot v2 compiler
58calls are quite long, so it is hard to find the warnings between them.
59.TP
Stefan Reinauer0bece042006-09-21 13:09:22 +000060.B "\-v, \-\-verbose"
61More verbose output.
62.TP
63.B "\-h, \-\-help"
64Show a help text and exit.
65.TP
66.B "\-V, \-\-version"
67Show version information and exit.
68.SH BUGS
Stefan Reinauerf8ee1802008-01-18 15:08:58 +000069Please report any bugs at http://tracker.coreboot.org/.
Stefan Reinauer0bece042006-09-21 13:09:22 +000070.SH LICENCE
71.B abuild
72is 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
772004 Stefan Reinauer
78.br
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +0000792006-2008 coresystems GmbH
Stefan Reinauer0bece042006-09-21 13:09:22 +000080.SH AUTHORS
Stefan Reinauer3a140572006-10-25 19:02:34 +000081Stefan Reinauer <stepan@coresystems.de>
Stefan Reinauer0bece042006-09-21 13:09:22 +000082.PP
83This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
84It is licensed under the terms of the GNU GPL (v2 or later).