util/abuild/abuild.1

   1 .TH ABUILD 1 "May 3, 2008"
   2 .SH NAME
   3 abuild \- build coreboot images for all available targets
   4 .SH SYNOPSIS
   5 .B abuild
   6 \fR[\fB\-abrvxsTVh\fR] [\fB\-c\fR numcpus|max] [\fB\-t\fR vendor/board] [\fB\-p\fR dir]
   7 [LBROOT]
   8 .SH DESCRIPTION
   9 .B abuild
  10 is a utility used to easily build coreboot images for all available targets.
  11 .SH OPTIONS
  12 The
  13 .B "[LBROOT]"
  14 parameter tells
  15 .B abuild
  16 where the root directory of the coreboot build tree resides. Per default
  17 this is
  18 .B "../.."
  19 as the
  20 .B abuild
  21 script resides in
  22 .BR "[CBROOT]/utils/abuild" .
  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>"
  33 to build images. This will run payload.sh in that directory to find out the
  34 path of the payload.
  35 .TP
  36 .B "\-t, \-\-target <vendor/board>"
  37 Attempt to build target vendor/board only.
  38 .TP
  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
  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
  51 .B "\-T, \-\-test"
  52 Submit generated image(s) to the automated test system.
  53 The results of the tests will be made available at
  54 .B http://qa.coreboot.org/log_manual.php
  55 .TP
  56 .B "\-c, \-\-cpus [<numcpus>|max]"
  57 Build on
  58 .B numcpus
  59 cpus at the same time, or on all available with
  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
  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
  75 Please report any bugs at http://tracker.coreboot.org/.
  76 .SH LICENCE
  77 .B abuild
  78 is covered by the GNU General Public License (GPL), version 2 or later.
  79 .SH SEE ALSO
  80 .BR romcc (1),
  81 .BR flashrom (1).
  82 .SH COPYRIGHT
  83 2004 Stefan Reinauer
  84 .br
  85 2006-2008 coresystems GmbH
  86 .SH AUTHORS
  87 Stefan Reinauer <stepan@coresystems.de>
  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).