blob: 287b7f78fd0913f71cc89634af3f15f21ccdff0f [file] [log] [blame]
Uwe Hermann42eb17f2008-01-18 17:48:51 +00001.TH FLASHROM 8 "January 18, 2008"
Stefan Reinauer261144c2006-07-27 23:29:02 +00002.SH NAME
Uwe Hermann42eb17f2008-01-18 17:48:51 +00003flashrom \- a universal BIOS/ROM/flash programming utility
Stefan Reinauer261144c2006-07-27 23:29:02 +00004.SH SYNOPSIS
Bernhard Walle201bde32008-01-21 15:24:22 +00005.B flashrom \fR[\fB\-rwvEVfhR\fR] [\fB\-c\fR chipname] [\fB\-s\fR exclude_start] [\fB\-e\fR exclude_end]
Stefan Reinauerf8337dd2006-08-03 10:49:09 +00006 [\fB-m\fR vendor:part] [\fB-l\fR file.layout] [\fB-i\fR image_name] [file]
Stefan Reinauer261144c2006-07-27 23:29:02 +00007.SH DESCRIPTION
8.B flashrom
Uwe Hermann67808fe2007-10-18 00:29:05 +00009is a universal flash programming utility for DIP, PLCC, or SPI flash ROM
Stefan Reinauere3f3e2e2008-01-18 15:33:10 +000010chips. It can be used to flash BIOS/coreboot/firmware images, for example.
Uwe Hermann42eb17f2008-01-18 17:48:51 +000011
12(see
13.B http://coreboot.org
14for details on coreboot)
Stefan Reinauer261144c2006-07-27 23:29:02 +000015.SH OPTIONS
16If no file is specified, then all that happens
17is that flash info is dumped and the flash chip is set to writable.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000018.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000019.B "\-r, \-\-read"
Uwe Hermann42eb17f2008-01-18 17:48:51 +000020Read flash ROM contents and save them into the given file.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000021.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000022.B "\-w, \-\-write"
Uwe Hermann42eb17f2008-01-18 17:48:51 +000023Write file into flash ROM (default when file is specified).
Stefan Reinauerde063bf2006-09-21 13:09:22 +000024.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000025.B "\-v, \-\-verify"
Uwe Hermann67808fe2007-10-18 00:29:05 +000026Verify the flash ROM contents against the given file.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000027.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000028.B "\-E, \-\-erase"
Uwe Hermann42eb17f2008-01-18 17:48:51 +000029Erase the flash ROM device.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000030.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000031.B "\-V, \-\-verbose"
32More verbose output.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000033.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000034.B "\-c, \-\-chip" <chipname>
Uwe Hermann42eb17f2008-01-18 17:48:51 +000035Probe only for specified flash ROM chip.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000036.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000037.B "\-s, \-\-estart" <addr>
Uwe Hermann42eb17f2008-01-18 17:48:51 +000038Exclude start position (obsolete).
Stefan Reinauerde063bf2006-09-21 13:09:22 +000039.TP
Stefan Reinauerf8337dd2006-08-03 10:49:09 +000040.B "\-e, \-\-eend" <addr>
Uwe Hermann42eb17f2008-01-18 17:48:51 +000041Exclude end postion (obsolete).
Stefan Reinauerde063bf2006-09-21 13:09:22 +000042.TP
Peter Stuge6b53fed2008-01-27 16:21:21 +000043.B "\-m, \-\-mainboard" <[vendor:]part>
Uwe Hermann67808fe2007-10-18 00:29:05 +000044Override mainboard settings. This option is needed for some mainboards,
45see the
46.B flashrom
Peter Stuge6b53fed2008-01-27 16:21:21 +000047README for a list. The vendor is not required when the board name is unique.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000048.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000049.B "\-f, \-\-force"
Uwe Hermann67808fe2007-10-18 00:29:05 +000050Force write without checking whether the ROM image file is really meant
51to be used on this board.
52.sp
Stefan Reinauere3f3e2e2008-01-18 15:33:10 +000053Note: This check only works while coreboot is running, and only for those
54boards where the coreboot code supports it.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000055.TP
Stefan Reinauerf8337dd2006-08-03 10:49:09 +000056.B "\-l, \-\-layout" <layout.file>
Stefan Reinauer261144c2006-07-27 23:29:02 +000057Read ROM layout from file.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000058.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000059.B "\-i, \-\-image" <name>
Uwe Hermann67808fe2007-10-18 00:29:05 +000060Only flash image
61.B <name>
62from flash layout.
Stefan Reinauerde063bf2006-09-21 13:09:22 +000063.TP
Stefan Reinauer261144c2006-07-27 23:29:02 +000064.B "\-h, \-\-help"
65Show a help text and exit.
Bernhard Walle201bde32008-01-21 15:24:22 +000066.TP
67.B "\-R, \-\-version"
68Show version information and exit.
Stefan Reinauer261144c2006-07-27 23:29:02 +000069.SH BUGS
Uwe Hermann42eb17f2008-01-18 17:48:51 +000070Please report any bugs at
71.BR http://tracker.coreboot.org/trac/coreboot/newticket ","
72or on the coreboot mailing list
73.RB "(" http://coreboot.org/Mailinglist ")."
Stefan Reinauer261144c2006-07-27 23:29:02 +000074.SH LICENCE
75.B flashrom
Stefan Reinauerde063bf2006-09-21 13:09:22 +000076is covered by the GNU General Public License (GPL), version 2 or later.
Stefan Reinauer261144c2006-07-27 23:29:02 +000077.SH COPYRIGHT
782000 Silicon Integrated System Corporation
79.br
Stefan Reinauerf8337dd2006-08-03 10:49:09 +0000802003 Niki W. Waibel
81.br
Stefan Reinauer261144c2006-07-27 23:29:02 +0000822004 Tyan Corp
83.br
Stefan Reinauer5380d512007-05-24 09:08:36 +0000842005-2007 coresystems GmbH
Stefan Reinauer261144c2006-07-27 23:29:02 +000085.SH AUTHORS
Stefan Reinauerf8337dd2006-08-03 10:49:09 +000086Yinghai Lu <yinghai.lu@amd.com>
Stefan Reinauer261144c2006-07-27 23:29:02 +000087.br
88Stefan Reinauer <stepan@coresystems.de>
89.br
90Niki W. Waibel <niki.waibel@gmx.net>
Stefan Reinauerf8337dd2006-08-03 10:49:09 +000091.br
92some others
Stefan Reinauer261144c2006-07-27 23:29:02 +000093.PP
Stefan Reinauerde063bf2006-09-21 13:09:22 +000094This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
Uwe Hermann42eb17f2008-01-18 17:48:51 +000095It is licensed under the terms of the GNU GPL (version 2 or later).