149 lines
4.1 KiB
Groff
149 lines
4.1 KiB
Groff
.TH FLASHROM 8 "January 5, 2009"
|
|
.SH NAME
|
|
flashrom \- utility for reading, writing, and erasing BIOS/ROM/flash chips
|
|
.SH SYNOPSIS
|
|
.B flashrom \fR[\fB\-rwvEVfLhR\fR] [\fB\-c\fR chipname] [\fB\-s\fR exclude_start] [\fB\-e\fR exclude_end]
|
|
[\fB-m\fR vendor:part] [\fB-l\fR file.layout] [\fB-i\fR image_name] [file]
|
|
.SH DESCRIPTION
|
|
.B flashrom
|
|
is a utility for reading, writing, and erasing flash ROM chips.
|
|
It's often used to flash BIOS/coreboot/firmware images.
|
|
.PP
|
|
It supports a wide range of DIP32, PLCC32, DIP8, and TSOP chips, which use
|
|
various protocols such as LPC, FWH, parallel flash, or SPI.
|
|
.PP
|
|
(see
|
|
.B http://coreboot.org
|
|
for details on coreboot)
|
|
.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 <file>"
|
|
Read flash ROM contents and save them into the given
|
|
.BR <file> .
|
|
.TP
|
|
.B "\-w, \-\-write <file>"
|
|
Write file into flash ROM (default when
|
|
.B <file>
|
|
is specified).
|
|
.TP
|
|
.B "\-v, \-\-verify <file>"
|
|
Verify the flash ROM contents against the given
|
|
.BR <file> .
|
|
.TP
|
|
.B "\-E, \-\-erase"
|
|
Erase the flash ROM chip.
|
|
.TP
|
|
.B "\-V, \-\-verbose"
|
|
More verbose output.
|
|
.TP
|
|
.B "\-c, \-\-chip" <chipname>
|
|
Probe only for specified flash ROM chip.
|
|
.TP
|
|
.B "\-s, \-\-estart" <addr>
|
|
Exclude start position (obsolete).
|
|
.TP
|
|
.B "\-e, \-\-eend" <addr>
|
|
Exclude end postion (obsolete).
|
|
.TP
|
|
.B "\-m, \-\-mainboard" <[vendor:]part>
|
|
Override mainboard settings. This option is needed for some mainboards,
|
|
see the
|
|
.B "flashrom \-\-list\-supported"
|
|
output for a list. The vendor is not required when the board name is unique.
|
|
.TP
|
|
.B "\-f, \-\-force"
|
|
Force write without checking whether the ROM image file is really meant
|
|
to be used on this board.
|
|
.sp
|
|
Note: This check only works while coreboot is running, and only for those
|
|
boards where the coreboot code supports it.
|
|
.TP
|
|
.B "\-l, \-\-layout <file>"
|
|
Read ROM layout from
|
|
.BR <file> .
|
|
.TP
|
|
.B "\-i, \-\-image <name>"
|
|
Only flash image
|
|
.B <name>
|
|
from flash layout.
|
|
.TP
|
|
.B "\-L, \-\-list\-supported"
|
|
List the ROM chips, chipsets, and mainboards supported by flashrom.
|
|
The list of mainboards consists of those boards which need a special
|
|
ROM write-enable function for flashrom to work.
|
|
.sp
|
|
There are many other boards which will work out of the box, without such
|
|
special support in flashrom. Some of the known-good/known-bad and tested ones
|
|
are listed at
|
|
.BR http://coreboot.org/Flashrom#Supported_mainboards ,
|
|
but the list is not exhaustive, of course.
|
|
.sp
|
|
Please let us know if you can verify other boards to work or not work out
|
|
of the box.
|
|
.TP
|
|
.B "\-h, \-\-help"
|
|
Show a help text and exit.
|
|
.TP
|
|
.B "\-R, \-\-version"
|
|
Show version information and exit.
|
|
.SH EXIT STATUS
|
|
flashrom exits with 0 on success, 1 on most failures but with 2 if /dev/mem
|
|
(/dev/xsvc on Solaris) can not be opened and with 3 if a call to mmap() fails.
|
|
.SH BUGS
|
|
Please report any bugs at
|
|
.BR http://tracker.coreboot.org/trac/coreboot/newticket ","
|
|
or on the coreboot mailing list
|
|
.RB "(" http://coreboot.org/Mailinglist ")."
|
|
.SH LICENCE
|
|
.B flashrom
|
|
is covered by the GNU General Public License (GPL), version 2. Some files are
|
|
additionally available under the GPL (version 2, or any later version).
|
|
.SH COPYRIGHT
|
|
.br
|
|
Please see the individual files.
|
|
.SH AUTHORS
|
|
Carl-Daniel Hailfinger
|
|
.br
|
|
Claus Gindhart <claus.gindhart@kontron.com>
|
|
.br
|
|
Dominik Geyer <dominik.geyer@kontron.com>
|
|
.br
|
|
Eric Biederman <ebiederman@lnxi.com>
|
|
.br
|
|
Giampiero Giancipoli <gianci@email.it>
|
|
.br
|
|
Joe Bao <Zheng.Bao@amd.com>
|
|
.br
|
|
Luc Verhaegen <libv@skynet.be>
|
|
.br
|
|
Markus Boas <ryven@ryven.de>
|
|
.br
|
|
Nikolay Petukhov <nikolay.petukhov@gmail.com>
|
|
.br
|
|
Peter Stuge <peter@stuge.se>
|
|
.br
|
|
Reinder E.N. de Haan <lb_reha@mveas.com>
|
|
.br
|
|
Ronald G. Minnich <rminnich@gmail.com>
|
|
.br
|
|
Ronald Hoogenboom <ronald@zonnet.nl>
|
|
.br
|
|
Stefan Reinauer <stepan@coresystems.de>
|
|
.br
|
|
Stefan Wildemann <stefan.wildemann@kontron.com>
|
|
.br
|
|
Steven James <pyro@linuxlabs.com>
|
|
.br
|
|
Uwe Hermann <uwe@hermann-uwe.de>
|
|
.br
|
|
Wang Qingpei <Qingpei.Wang@amd.com>
|
|
.br
|
|
Yinghai Lu <yinghai.lu@amd.com>
|
|
.br
|
|
some others
|
|
.PP
|
|
This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
|
|
It is licensed under the terms of the GNU GPL (version 2 or later).
|