blob: c047f8b9e2e9e8e67eb176821943ab9ea735c37d [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
Uwe Hermann4e006402009-04-15 16:07:27 +00006\fR[\fB\-abrvxsTVh\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
Uwe Hermann4e006402009-04-15 16:07:27 +000039.B "\-r, \-\-remove"
40Remove mainboard build directory after the respective target has been
41built. This is mainly used for development purposes, when you don't need
42the actual build output, but rather only want to know if a build failed
43or not.
44.TP
Stefan Reinauer0bece042006-09-21 13:09:22 +000045.B "\-x, \-\-xml"
46Write an XML log file instead of a plain-text one.
47The file will be called
48.B abuild.xml
49and will be created in the current directory.
50.TP
Stefan Reinauer3a140572006-10-25 19:02:34 +000051.B "\-T, \-\-test"
52Submit generated image(s) to the automated test system.
Stefan Reinauer14e22772010-04-27 06:56:47 +000053The results of the tests will be made available at
Stefan Reinauerf8ee1802008-01-18 15:08:58 +000054.B http://qa.coreboot.org/log_manual.php
Stefan Reinauer3a140572006-10-25 19:02:34 +000055.TP
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +000056.B "\-c, \-\-cpus [<numcpus>|max]"
Stefan Reinauer14e22772010-04-27 06:56:47 +000057Build on
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +000058.B numcpus
Stefan Reinauer14e22772010-04-27 06:56:47 +000059cpus at the same time, or on all available with
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +000060.B max\fR.
61.TP
62.B "\-s, \-\-silent"
63Don't print any compiler calls in the log files. In coreboot v2 compiler
64calls are quite long, so it is hard to find the warnings between them.
65.TP
Stefan Reinauer0bece042006-09-21 13:09:22 +000066.B "\-v, \-\-verbose"
67More verbose output.
68.TP
69.B "\-h, \-\-help"
70Show a help text and exit.
71.TP
72.B "\-V, \-\-version"
73Show version information and exit.
74.SH BUGS
Martin Roth48a243b2014-12-07 22:25:02 -070075Please report any bugs on the coreboot mailing list
76.RB "(" http://coreboot.org/Mailinglist ")."
Stefan Reinauer0bece042006-09-21 13:09:22 +000077.SH LICENCE
78.B abuild
79is covered by the GNU General Public License (GPL), version 2 or later.
80.SH SEE ALSO
81.BR romcc (1),
82.BR flashrom (1).
83.SH COPYRIGHT
842004 Stefan Reinauer
85.br
Stefan Reinauer02a4e7f2008-05-27 18:29:26 +0000862006-2008 coresystems GmbH
Stefan Reinauer0bece042006-09-21 13:09:22 +000087.SH AUTHORS
Stefan Reinauer3a140572006-10-25 19:02:34 +000088Stefan Reinauer <stepan@coresystems.de>
Stefan Reinauer0bece042006-09-21 13:09:22 +000089.PP
90This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
91It is licensed under the terms of the GNU GPL (v2 or later).