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>.
.\" This manpage is licensed under the terms of the GNU GPL.
.TH FLASHROM 1 "July 26, 2006"
.TH FLASHROM 1 "September 19, 2006"
.SH NAME
flashrom \- the universal LinuxBIOS flash utility
.SH SYNOPSIS
@ -12,55 +10,56 @@ is the universal LinuxBIOS flash utility.
.SH OPTIONS
If no file is specified, then all that happens
is that flash info is dumped and the flash chip is set to writable.
.TP
.B "\-r, \-\-read"
Read flash and save contents into file.
.PP
.TP
.B "\-w, \-\-write"
Write file into flash (default when file is specified).
.PP
.TP
.B "\-v, \-\-verify"
Verify flash against file.
.PP
.TP
.B "\-E, \-\-erase"
Erase flash device.
.PP
.TP
.B "\-V, \-\-verbose"
More verbose output.
.PP
.TP
.B "\-c, \-\-chip" <chipname>
Probe only for specified flash chip.
.PP
.TP
.B "\-s, \-\-estart" <addr>
Exclude start position. (obsolete)
.PP
.TP
.B "\-e, \-\-eend" <addr>
Exclude end postion. (obsolete)
.PP
.TP
.B "\-m, \-\-mainboard" <vendor:part>
Override mainboard settings.
.PP
.TP
.B "\-f, \-\-force"
Force write without checking image.
.PP
.TP
.B "\-l, \-\-layout" <layout.file>
Read ROM layout from file.
.PP
.TP
.B "\-i, \-\-image" <name>
Only flash image name from flash layout.
.PP
.TP
.B "\-h, \-\-help"
Show a help text and exit.
.\".PP
.\".TP
.\".B "\-\-version"
.\"Show version information and exit.
.SH BUGS
Please report any bugs at http://bugzilla.openbios.org/.
.SH LICENCE
.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
.BR romcc (1).
.BR romcc (1),
.BR abuild (1).
.SH COPYRIGHT
2000 Silicon Integrated System Corporation
.br
@ -78,5 +77,5 @@ Niki W. Waibel <niki.waibel@gmx.net>
.br
some others
.PP
This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>,
for the Debian GNU/Linux system (but may be used by others).
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,230 +1,228 @@
.\" Copyright (C) 2006 Uwe Hermann <uwe@hermann-uwe.de>.
.\" This manpage is licensed under the terms of the GNU GPL.
.TH ROMCC 1 "September 7, 2006"
.TH ROMCC 1 "September 19, 2006"
.SH NAME
romcc \- compile C programs into binaries that don't use any RAM
.SH SYNOPSIS
.B romcc
.BR [ OPTIONS ]
.IR "<source>" ".c"
[OPTIONS]
<source>.c
.SH DESCRIPTION
.B romcc
is a C compiler which produces binaries which do not rely on RAM, but
instead only use CPU registers.
.br
.PP
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
used for other purposes, too.
.SH OPTIONS
.TP
.B "\-o" <filename>
Output file name.
.PP
.TP
.B "\-f<option>"
Specify a generic compiler option.
.PP
.TP
.B "\-m<option>"
Specify an architecture-dependent compiler option.
.PP
.TP
.B "\-\-"
Specify that this is the last option.
.PP
.SH "GENERIC COMPILER OPTIONS"
.B "\-O"
.PP
.TP
.B "\-O2"
.PP
.TP
.B "\-E"
.PP
.TP
.B "\-ftrigraphs"
.PP
.TP
.B "\-fno-trigraphs"
.PP
.TP
.B "\-fpp-only"
.PP
.TP
.B "\-fno-pp-only"
.PP
.TP
.B "\-feliminate-inefectual-code"
.PP
.TP
.B "\-fno-eliminate-inefectual-code"
.PP
.TP
.B "\-fsimplify"
.PP
.TP
.B "\-fno-simplify"
.PP
.TP
.B "\-fscc-transform"
.PP
.TP
.B "\-fno-scc-transform"
.PP
.TP
.B "\-fsimplify-op"
.PP
.TP
.B "\-fno-simplify-op"
.PP
.TP
.B "\-fsimplify-phi"
.PP
.TP
.B "\-fno-simplify-phi"
.PP
.TP
.B "\-fsimplify-label"
.PP
.TP
.B "\-fno-simplify-label"
.PP
.TP
.B "\-fsimplify-branch"
.PP
.TP
.B "\-fno-simplify-branch"
.PP
.TP
.B "\-fsimplify-copy"
.PP
.TP
.B "\-fno-simplify-copy"
.PP
.TP
.B "\-fsimplify-arith"
.PP
.TP
.B "\-fno-simplify-arith"
.PP
.TP
.B "\-fsimplify-shift"
.PP
.TP
.B "\-fno-simplify-shift"
.PP
.TP
.B "\-fsimplify-bitwise"
.PP
.TP
.B "\-fno-simplify-bitwise"
.PP
.TP
.B "\-fsimplify-logical"
.PP
.TP
.B "\-fno-simplify-logical"
.PP
.TP
.B "\-fsimplify-bitfield"
.PP
.TP
.B "\-fno-simplify-bitfield"
.PP
.TP
.B "\-finline-policy=always"
.PP
.TP
.B "\-finline-policy=never"
.PP
.TP
.B "\-finline-policy=defaulton"
.PP
.TP
.B "\-finline-policy=defaultoff"
.PP
.TP
.B "\-finline-policy=nopenalty"
.PP
.TP
.B "\-fdebug-all"
.PP
.TP
.B "\-fno-debug-all"
.PP
.TP
.B "\-fdebug-abort-on-error"
.PP
.TP
.B "\-fno-debug-abort-on-error"
.PP
.TP
.B "\-fdebug-basic-blocks"
.PP
.TP
.B "\-fno-debug-basic-blocks"
.PP
.TP
.B "\-fdebug-fdominators"
.PP
.TP
.B "\-fno-debug-fdominators"
.PP
.TP
.B "\-fdebug-rdominators"
.PP
.TP
.B "\-fno-debug-rdominators"
.PP
.TP
.B "\-fdebug-triples"
.PP
.TP
.B "\-fno-debug-triples"
.PP
.TP
.B "\-fdebug-interference"
.PP
.TP
.B "\-fno-debug-interference"
.PP
.TP
.B "\-fdebug-scc-transform"
.PP
.TP
.B "\-fno-debug-scc-transform"
.PP
.TP
.B "\-fdebug-scc-transform2"
.PP
.TP
.B "\-fno-debug-scc-transform2"
.PP
.TP
.B "\-fdebug-rebuild-ssa-form"
.PP
.TP
.B "\-fno-debug-rebuild-ssa-form"
.PP
.TP
.B "\-fdebug-inline"
.PP
.TP
.B "\-fno-debug-inline"
.PP
.TP
.B "\-fdebug-live-range-conflicts"
.PP
.TP
.B "\-fno-debug-live-range-conflicts"
.PP
.TP
.B "\-fdebug-live-range-conflicts2"
.PP
.TP
.B "\-fno-debug-live-range-conflicts2"
.PP
.TP
.B "\-fdebug-color-graph"
.PP
.TP
.B "\-fno-debug-color-graph"
.PP
.TP
.B "\-fdebug-color-graph2"
.PP
.TP
.B "\-fno-debug-color-graph2"
.PP
.TP
.B "\-fdebug-coalescing"
.PP
.TP
.B "\-fno-debug-coalescing"
.PP
.TP
.B "\-fdebug-coalescing2"
.PP
.TP
.B "\-fno-debug-coalescing2"
.PP
.TP
.B "\-fdebug-verification"
.PP
.TP
.B "\-fno-debug-verification"
.PP
.TP
.B "\-fdebug-calls"
.PP
.TP
.B "\-fno-debug-calls"
.PP
.TP
.B "\-fdebug-calls2"
.PP
.TP
.B "\-fno-debug-calls2"
.PP
.TP
.B "\-fdebug-tokens"
.PP
.TP
.B "\-fno-debug-tokens"
.PP
.TP
.B "\-flabel-prefix=<prefix for assembly language labels>"
.PP
.TP
.B "\-\-label-prefix=<prefix for assembly language labels>"
.PP
.TP
.B "\-I<include path>"
.PP
.TP
.B "\-D<macro>[=defn]"
.PP
.TP
.B "\-U<macro>"
.SH "ARCHITECTURE-SPECIFIC COMPILER OPTIONS"
.B "\-mmmx"
.PP
.TP
.B "\-mno-mmx"
.PP
.TP
.B "\-msse"
.PP
.TP
.B "\-mno-sse"
.PP
.TP
.B "\-mnoop-copy"
.PP
.TP
.B "\-mno-noop-copy"
.PP
.TP
.B "\-mcpu=i386"
.PP
.TP
.B "\-mcpu=p2"
.PP
.TP
.B "\-mcpu=p3"
.PP
.TP
.B "\-mcpu=p4"
.PP
.TP
.B "\-mcpu=k7"
.PP
.TP
.B "\-mcpu=k8"
.PP
.TP
.B "\-mcpu=c3"
.PP
.TP
.B "\-mcpu=c3-2"
.SH BUGS
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
is covered by the GNU General Public License (GPL), version 2.
.SH SEE ALSO
.BR flashrom (1).
.BR flashrom (1),
.BR abuild (1).
.SH COPYRIGHT
2003-2006 Eric W. Biederman
.SH AUTHORS
@ -241,3 +240,4 @@ Eric W. Biederman <ebiederman@lnxi.com>
Some contributions by others.
.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).