abuild manpage and other fixes from Uwe Hermann. Thank you!

git-svn-id: svn://svn.coreboot.org/coreboot/trunk@2431 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
This commit is contained in:
Stefan Reinauer 2006-09-21 13:09:22 +00:00
parent 2ad85dbc65
commit 0bece04105
3 changed files with 196 additions and 129 deletions

68
util/abuild/abuild.1 Normal file
View File

@ -0,0 +1,68 @@
.TH ABUILD 1 "September 19, 2006"
.SH NAME
abuild \- build LinuxBIOS images for all available targets
.SH SYNOPSIS
.B abuild
\fR[\fB\-abxVh\fR] [\fB\-t\fR vendor/board] [\fB\-p\fR dir]
[LBROOT]
.SH DESCRIPTION
.B abuild
is a utility used to easily build LinuxBIOS images for all available targets.
.SH OPTIONS
The
.B "[LBROOT]"
parameter tells
.B abuild
where the root directory of the LinuxBIOS build tree resides. Per default
this is
.B "../.."
as the
.B abuild
script resides in
.BR "[LBROOT]/utils/abuild" .
.TP
.B "\-a, \-\-all"
Build previously succeeded ports as well.
.TP
.B "\-b, \-\-broken"
Attempt to build ports that are known to be broken.
.TP
.B "\-p, \-\-payloads <dir>"
Use payloads in
.B "<dir>"
to build images.
.TP
.B "\-t, \-\-target <vendor/board>"
Attempt to build target vendor/board only.
.TP
.B "\-x, \-\-xml"
Write an XML log file instead of a plain-text one.
The file will be called
.B abuild.xml
and will be created in the current directory.
.TP
.B "\-v, \-\-verbose"
More verbose output.
.TP
.B "\-h, \-\-help"
Show a help text and exit.
.TP
.B "\-V, \-\-version"
Show version information and exit.
.SH BUGS
Please report any bugs at http://bugzilla.openbios.org/.
.SH LICENCE
.B abuild
is covered by the GNU General Public License (GPL), version 2 or later.
.SH SEE ALSO
.BR romcc (1),
.BR flashrom (1).
.SH COPYRIGHT
2004 Stefan Reinauer
.br
2006 coresystems GmbH
.SH AUTHORS
Stefan Reinauer <stepan@openbios.org>
.PP
This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
It is licensed under the terms of the GNU GPL (v2 or later).

View File

@ -1,6 +1,4 @@
.\" Copyright (C) 2006 Uwe Hermann <uwe@hermann-uwe.de>. .TH FLASHROM 1 "September 19, 2006"
.\" This manpage is licensed under the terms of the GNU GPL.
.TH FLASHROM 1 "July 26, 2006"
.SH NAME .SH NAME
flashrom \- the universal LinuxBIOS flash utility flashrom \- the universal LinuxBIOS flash utility
.SH SYNOPSIS .SH SYNOPSIS
@ -12,55 +10,56 @@ is the universal LinuxBIOS flash utility.
.SH OPTIONS .SH OPTIONS
If no file is specified, then all that happens If no file is specified, then all that happens
is that flash info is dumped and the flash chip is set to writable. is that flash info is dumped and the flash chip is set to writable.
.TP
.B "\-r, \-\-read" .B "\-r, \-\-read"
Read flash and save contents into file. Read flash and save contents into file.
.PP .TP
.B "\-w, \-\-write" .B "\-w, \-\-write"
Write file into flash (default when file is specified). Write file into flash (default when file is specified).
.PP .TP
.B "\-v, \-\-verify" .B "\-v, \-\-verify"
Verify flash against file. Verify flash against file.
.PP .TP
.B "\-E, \-\-erase" .B "\-E, \-\-erase"
Erase flash device. Erase flash device.
.PP .TP
.B "\-V, \-\-verbose" .B "\-V, \-\-verbose"
More verbose output. More verbose output.
.PP .TP
.B "\-c, \-\-chip" <chipname> .B "\-c, \-\-chip" <chipname>
Probe only for specified flash chip. Probe only for specified flash chip.
.PP .TP
.B "\-s, \-\-estart" <addr> .B "\-s, \-\-estart" <addr>
Exclude start position. (obsolete) Exclude start position. (obsolete)
.PP .TP
.B "\-e, \-\-eend" <addr> .B "\-e, \-\-eend" <addr>
Exclude end postion. (obsolete) Exclude end postion. (obsolete)
.PP .TP
.B "\-m, \-\-mainboard" <vendor:part> .B "\-m, \-\-mainboard" <vendor:part>
Override mainboard settings. Override mainboard settings.
.PP .TP
.B "\-f, \-\-force" .B "\-f, \-\-force"
Force write without checking image. Force write without checking image.
.PP .TP
.B "\-l, \-\-layout" <layout.file> .B "\-l, \-\-layout" <layout.file>
Read ROM layout from file. Read ROM layout from file.
.PP .TP
.B "\-i, \-\-image" <name> .B "\-i, \-\-image" <name>
Only flash image name from flash layout. Only flash image name from flash layout.
.PP .TP
.B "\-h, \-\-help" .B "\-h, \-\-help"
Show a help text and exit. Show a help text and exit.
.\".PP .\".TP
.\".B "\-\-version" .\".B "\-\-version"
.\"Show version information and exit. .\"Show version information and exit.
.SH BUGS .SH BUGS
Please report any bugs at http://bugzilla.openbios.org/. Please report any bugs at http://bugzilla.openbios.org/.
.SH LICENCE .SH LICENCE
.B flashrom .B flashrom
is covered by the GNU General Public License (GPL). is covered by the GNU General Public License (GPL), version 2 or later.
.SH SEE ALSO .SH SEE ALSO
.BR romcc (1). .BR romcc (1),
.BR abuild (1).
.SH COPYRIGHT .SH COPYRIGHT
2000 Silicon Integrated System Corporation 2000 Silicon Integrated System Corporation
.br .br
@ -78,5 +77,5 @@ Niki W. Waibel <niki.waibel@gmx.net>
.br .br
some others some others
.PP .PP
This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>, This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
for the Debian GNU/Linux system (but may be used by others). It is licensed under the terms of the GNU GPL (v2 or later).

View File

@ -1,230 +1,228 @@
.\" Copyright (C) 2006 Uwe Hermann <uwe@hermann-uwe.de>. .TH ROMCC 1 "September 19, 2006"
.\" This manpage is licensed under the terms of the GNU GPL.
.TH ROMCC 1 "September 7, 2006"
.SH NAME .SH NAME
romcc \- compile C programs into binaries that don't use any RAM romcc \- compile C programs into binaries that don't use any RAM
.SH SYNOPSIS .SH SYNOPSIS
.B romcc .B romcc
.BR [ OPTIONS ] [OPTIONS]
.IR "<source>" ".c" <source>.c
.SH DESCRIPTION .SH DESCRIPTION
.B romcc .B romcc
is a C compiler which produces binaries which do not rely on RAM, but is a C compiler which produces binaries which do not rely on RAM, but
instead only use CPU registers. instead only use CPU registers.
.br .PP
It is prominently used in the LinuxBIOS project to compile C code which It is prominently used in the LinuxBIOS project to compile C code which
needs to run before the (Linux)BIOS has initialized the RAM, but can be needs to run before the (Linux)BIOS has initialized the RAM, but can be
used for other purposes, too. used for other purposes, too.
.SH OPTIONS .SH OPTIONS
.TP
.B "\-o" <filename> .B "\-o" <filename>
Output file name. Output file name.
.PP .TP
.B "\-f<option>" .B "\-f<option>"
Specify a generic compiler option. Specify a generic compiler option.
.PP .TP
.B "\-m<option>" .B "\-m<option>"
Specify an architecture-dependent compiler option. Specify an architecture-dependent compiler option.
.PP .TP
.B "\-\-" .B "\-\-"
Specify that this is the last option. Specify that this is the last option.
.PP
.SH "GENERIC COMPILER OPTIONS" .SH "GENERIC COMPILER OPTIONS"
.B "\-O" .B "\-O"
.PP .TP
.B "\-O2" .B "\-O2"
.PP .TP
.B "\-E" .B "\-E"
.PP .TP
.B "\-ftrigraphs" .B "\-ftrigraphs"
.PP .TP
.B "\-fno-trigraphs" .B "\-fno-trigraphs"
.PP .TP
.B "\-fpp-only" .B "\-fpp-only"
.PP .TP
.B "\-fno-pp-only" .B "\-fno-pp-only"
.PP .TP
.B "\-feliminate-inefectual-code" .B "\-feliminate-inefectual-code"
.PP .TP
.B "\-fno-eliminate-inefectual-code" .B "\-fno-eliminate-inefectual-code"
.PP .TP
.B "\-fsimplify" .B "\-fsimplify"
.PP .TP
.B "\-fno-simplify" .B "\-fno-simplify"
.PP .TP
.B "\-fscc-transform" .B "\-fscc-transform"
.PP .TP
.B "\-fno-scc-transform" .B "\-fno-scc-transform"
.PP .TP
.B "\-fsimplify-op" .B "\-fsimplify-op"
.PP .TP
.B "\-fno-simplify-op" .B "\-fno-simplify-op"
.PP .TP
.B "\-fsimplify-phi" .B "\-fsimplify-phi"
.PP .TP
.B "\-fno-simplify-phi" .B "\-fno-simplify-phi"
.PP .TP
.B "\-fsimplify-label" .B "\-fsimplify-label"
.PP .TP
.B "\-fno-simplify-label" .B "\-fno-simplify-label"
.PP .TP
.B "\-fsimplify-branch" .B "\-fsimplify-branch"
.PP .TP
.B "\-fno-simplify-branch" .B "\-fno-simplify-branch"
.PP .TP
.B "\-fsimplify-copy" .B "\-fsimplify-copy"
.PP .TP
.B "\-fno-simplify-copy" .B "\-fno-simplify-copy"
.PP .TP
.B "\-fsimplify-arith" .B "\-fsimplify-arith"
.PP .TP
.B "\-fno-simplify-arith" .B "\-fno-simplify-arith"
.PP .TP
.B "\-fsimplify-shift" .B "\-fsimplify-shift"
.PP .TP
.B "\-fno-simplify-shift" .B "\-fno-simplify-shift"
.PP .TP
.B "\-fsimplify-bitwise" .B "\-fsimplify-bitwise"
.PP .TP
.B "\-fno-simplify-bitwise" .B "\-fno-simplify-bitwise"
.PP .TP
.B "\-fsimplify-logical" .B "\-fsimplify-logical"
.PP .TP
.B "\-fno-simplify-logical" .B "\-fno-simplify-logical"
.PP .TP
.B "\-fsimplify-bitfield" .B "\-fsimplify-bitfield"
.PP .TP
.B "\-fno-simplify-bitfield" .B "\-fno-simplify-bitfield"
.PP .TP
.B "\-finline-policy=always" .B "\-finline-policy=always"
.PP .TP
.B "\-finline-policy=never" .B "\-finline-policy=never"
.PP .TP
.B "\-finline-policy=defaulton" .B "\-finline-policy=defaulton"
.PP .TP
.B "\-finline-policy=defaultoff" .B "\-finline-policy=defaultoff"
.PP .TP
.B "\-finline-policy=nopenalty" .B "\-finline-policy=nopenalty"
.PP .TP
.B "\-fdebug-all" .B "\-fdebug-all"
.PP .TP
.B "\-fno-debug-all" .B "\-fno-debug-all"
.PP .TP
.B "\-fdebug-abort-on-error" .B "\-fdebug-abort-on-error"
.PP .TP
.B "\-fno-debug-abort-on-error" .B "\-fno-debug-abort-on-error"
.PP .TP
.B "\-fdebug-basic-blocks" .B "\-fdebug-basic-blocks"
.PP .TP
.B "\-fno-debug-basic-blocks" .B "\-fno-debug-basic-blocks"
.PP .TP
.B "\-fdebug-fdominators" .B "\-fdebug-fdominators"
.PP .TP
.B "\-fno-debug-fdominators" .B "\-fno-debug-fdominators"
.PP .TP
.B "\-fdebug-rdominators" .B "\-fdebug-rdominators"
.PP .TP
.B "\-fno-debug-rdominators" .B "\-fno-debug-rdominators"
.PP .TP
.B "\-fdebug-triples" .B "\-fdebug-triples"
.PP .TP
.B "\-fno-debug-triples" .B "\-fno-debug-triples"
.PP .TP
.B "\-fdebug-interference" .B "\-fdebug-interference"
.PP .TP
.B "\-fno-debug-interference" .B "\-fno-debug-interference"
.PP .TP
.B "\-fdebug-scc-transform" .B "\-fdebug-scc-transform"
.PP .TP
.B "\-fno-debug-scc-transform" .B "\-fno-debug-scc-transform"
.PP .TP
.B "\-fdebug-scc-transform2" .B "\-fdebug-scc-transform2"
.PP .TP
.B "\-fno-debug-scc-transform2" .B "\-fno-debug-scc-transform2"
.PP .TP
.B "\-fdebug-rebuild-ssa-form" .B "\-fdebug-rebuild-ssa-form"
.PP .TP
.B "\-fno-debug-rebuild-ssa-form" .B "\-fno-debug-rebuild-ssa-form"
.PP .TP
.B "\-fdebug-inline" .B "\-fdebug-inline"
.PP .TP
.B "\-fno-debug-inline" .B "\-fno-debug-inline"
.PP .TP
.B "\-fdebug-live-range-conflicts" .B "\-fdebug-live-range-conflicts"
.PP .TP
.B "\-fno-debug-live-range-conflicts" .B "\-fno-debug-live-range-conflicts"
.PP .TP
.B "\-fdebug-live-range-conflicts2" .B "\-fdebug-live-range-conflicts2"
.PP .TP
.B "\-fno-debug-live-range-conflicts2" .B "\-fno-debug-live-range-conflicts2"
.PP .TP
.B "\-fdebug-color-graph" .B "\-fdebug-color-graph"
.PP .TP
.B "\-fno-debug-color-graph" .B "\-fno-debug-color-graph"
.PP .TP
.B "\-fdebug-color-graph2" .B "\-fdebug-color-graph2"
.PP .TP
.B "\-fno-debug-color-graph2" .B "\-fno-debug-color-graph2"
.PP .TP
.B "\-fdebug-coalescing" .B "\-fdebug-coalescing"
.PP .TP
.B "\-fno-debug-coalescing" .B "\-fno-debug-coalescing"
.PP .TP
.B "\-fdebug-coalescing2" .B "\-fdebug-coalescing2"
.PP .TP
.B "\-fno-debug-coalescing2" .B "\-fno-debug-coalescing2"
.PP .TP
.B "\-fdebug-verification" .B "\-fdebug-verification"
.PP .TP
.B "\-fno-debug-verification" .B "\-fno-debug-verification"
.PP .TP
.B "\-fdebug-calls" .B "\-fdebug-calls"
.PP .TP
.B "\-fno-debug-calls" .B "\-fno-debug-calls"
.PP .TP
.B "\-fdebug-calls2" .B "\-fdebug-calls2"
.PP .TP
.B "\-fno-debug-calls2" .B "\-fno-debug-calls2"
.PP .TP
.B "\-fdebug-tokens" .B "\-fdebug-tokens"
.PP .TP
.B "\-fno-debug-tokens" .B "\-fno-debug-tokens"
.PP .TP
.B "\-flabel-prefix=<prefix for assembly language labels>" .B "\-flabel-prefix=<prefix for assembly language labels>"
.PP .TP
.B "\-\-label-prefix=<prefix for assembly language labels>" .B "\-\-label-prefix=<prefix for assembly language labels>"
.PP .TP
.B "\-I<include path>" .B "\-I<include path>"
.PP .TP
.B "\-D<macro>[=defn]" .B "\-D<macro>[=defn]"
.PP .TP
.B "\-U<macro>" .B "\-U<macro>"
.SH "ARCHITECTURE-SPECIFIC COMPILER OPTIONS" .SH "ARCHITECTURE-SPECIFIC COMPILER OPTIONS"
.B "\-mmmx" .B "\-mmmx"
.PP .TP
.B "\-mno-mmx" .B "\-mno-mmx"
.PP .TP
.B "\-msse" .B "\-msse"
.PP .TP
.B "\-mno-sse" .B "\-mno-sse"
.PP .TP
.B "\-mnoop-copy" .B "\-mnoop-copy"
.PP .TP
.B "\-mno-noop-copy" .B "\-mno-noop-copy"
.PP .TP
.B "\-mcpu=i386" .B "\-mcpu=i386"
.PP .TP
.B "\-mcpu=p2" .B "\-mcpu=p2"
.PP .TP
.B "\-mcpu=p3" .B "\-mcpu=p3"
.PP .TP
.B "\-mcpu=p4" .B "\-mcpu=p4"
.PP .TP
.B "\-mcpu=k7" .B "\-mcpu=k7"
.PP .TP
.B "\-mcpu=k8" .B "\-mcpu=k8"
.PP .TP
.B "\-mcpu=c3" .B "\-mcpu=c3"
.PP .TP
.B "\-mcpu=c3-2" .B "\-mcpu=c3-2"
.SH BUGS .SH BUGS
Please report any bugs to Eric W. Biederman <ebiederman@lnxi.com>. Please report any bugs to Eric W. Biederman <ebiederman@lnxi.com>.
@ -232,7 +230,8 @@ Please report any bugs to Eric W. Biederman <ebiederman@lnxi.com>.
.B romcc .B romcc
is covered by the GNU General Public License (GPL), version 2. is covered by the GNU General Public License (GPL), version 2.
.SH SEE ALSO .SH SEE ALSO
.BR flashrom (1). .BR flashrom (1),
.BR abuild (1).
.SH COPYRIGHT .SH COPYRIGHT
2003-2006 Eric W. Biederman 2003-2006 Eric W. Biederman
.SH AUTHORS .SH AUTHORS
@ -241,3 +240,4 @@ Eric W. Biederman <ebiederman@lnxi.com>
Some contributions by others. Some contributions by others.
.PP .PP
This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>. This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
It is licensed under the terms of the GNU GPL (v2 or later).