Gitiles
Code Review Sign In
review.sourcearcade.org / flashprog / e4edb067a64275ba62669ebb4b42f653cb6aff0d / . / README
blob: 3082f71069ecf33672b7cd2dcf6c04d1e0bee9f8 [file] [log] [blame]
Uwe Hermann2dc5f422006-11-20 20:32:35 +0000[diff] [blame]1-------------------------------------------------------------------------------
Peter Stuge44dd3042009-04-20 12:34:30 +0000[diff] [blame]2flashrom README
Uwe Hermann2dc5f422006-11-20 20:32:35 +0000[diff] [blame]3-------------------------------------------------------------------------------
Ronald G. Minnich1e5003f2002-04-10 18:02:07 +0000[diff] [blame]4
Carl-Daniel Hailfinger1ebf8452009-08-18 23:50:14 +0000[diff] [blame]5flashrom is a utility for detecting, reading, writing, verifying and erasing
6flash chips. It is often used to flash BIOS/EFI/coreboot/firmware images
7in-system using a supported mainboard, but it also supports flashing of network
Uwe Hermannc7e8a0c2009-05-19 14:14:21 +0000[diff] [blame]8cards (NICs), SATA controller cards, and other external devices which can
9program flash chips.
Uwe Hermanne74b9f82009-04-10 14:41:29 +0000[diff] [blame]10
Carl-Daniel Hailfinger1ebf8452009-08-18 23:50:14 +0000[diff] [blame]11It supports a wide range of DIP32, PLCC32, DIP8, SO8/SOIC8, TSOP32, and TSOP40
12chips, which use various protocols such as LPC, FWH, parallel flash, or SPI.
Uwe Hermann42eb17f2008-01-18 17:48:51 +0000[diff] [blame]13
Stefan Reinauer009c51b2010-01-03 23:50:28 +0000[diff] [blame]14Please see the flashrom(8) manpage.
15
Uwe Hermann2dc5f422006-11-20 20:32:35 +0000[diff] [blame]16
Carl-Daniel Hailfingera23041c2009-06-12 14:49:10 +0000[diff] [blame]17Packaging
18---------
19
20To package flashrom and remove dependencies on subversion, either use
21make export
22or
23make tarball
24
25make export will export all flashrom files from the subversion repository at
26revision BASE into a directory named $EXPORTDIR/flashrom-$VERSION-r$SVNREVISION
27and will additionally modify the Makefile in that directory to contain the svn
28revision of the exported tree.
29
30make tarball will simply tar up the result of make export and gzip compress it.
31
32The snapshot tarballs are the result of make tarball and require no further
33processing.
34
35
Uwe Hermannd1129ac2009-05-28 15:07:42 +0000[diff] [blame]36Build Instructions
Stefan Reinauer06b2c4d2005-12-01 10:51:08 +0000[diff] [blame]37------------------
38
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]39To build flashrom you need to install the following packages or ports:
Stefan Reinauer06b2c4d2005-12-01 10:51:08 +0000[diff] [blame]40
Idwer Vollering5e410de2009-05-03 23:33:05 +0000[diff] [blame]41Linux et al:
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]42
Carl-Daniel Hailfingera472b8b2009-10-03 17:08:02 +0000[diff] [blame]43 * pciutils / libpci
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]44 * pciutils-devel / pciutils-dev / libpci-dev
Carl-Daniel Hailfinger10572fa2009-08-17 16:30:53 +0000[diff] [blame]45 * zlib-devel / zlib1g-dev (only needed if libpci is static)
Stefan Reinauer06b2c4d2005-12-01 10:51:08 +0000[diff] [blame]46
Idwer Vollering5e410de2009-05-03 23:33:05 +0000[diff] [blame]47On FreeBSD, you need the following ports:
Idwer Vollering5e410de2009-05-03 23:33:05 +0000[diff] [blame]48
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]49 * devel/gmake
50 * devel/libpci
Idwer Vollering5e410de2009-05-03 23:33:05 +0000[diff] [blame]51
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]52To compile on Linux, use:
Carl-Daniel Hailfinger9abf5292009-05-01 16:34:32 +0000[diff] [blame]53
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]54 make
55
56To compile on FreeBSD, use:
57
58 gmake
59
Carl-Daniel Hailfinger10572fa2009-08-17 16:30:53 +0000[diff] [blame]60To compile on Nexenta, use:
61
62 make
63
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]64To compile on Solaris, use:
65
Carl-Daniel Hailfinger10572fa2009-08-17 16:30:53 +0000[diff] [blame]66 gmake LDFLAGS="-L$pathtolibpci" CC="gcc -I$pathtopciheaders" CFLAGS=-O2
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]67
Jonathan A. Kollasch3646c8f2010-01-08 21:18:08 +0000[diff] [blame]68To compile on NetBSD or DragonFly BSD, use:
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]69
70 ln -s /usr/pkg/include/pciutils pci
Jonathan A. Kollasch3646c8f2010-01-08 21:18:08 +0000[diff] [blame]71 gmake CFLAGS=-I. LDFLAGS="-L/usr/pkg/lib -Wl,-rpath-link,/usr/pkg/lib"
Carl-Daniel Hailfinger9abf5292009-05-01 16:34:32 +0000[diff] [blame]72
73To compile and run on Darwin/Mac OS X:
Uwe Hermann87c07932009-05-05 16:15:46 +0000[diff] [blame]74
75 Install DirectIO from coresystems GmbH.
76 DirectIO is available at http://www.coresystems.de/en/directio.
Carl-Daniel Hailfinger9abf5292009-05-01 16:34:32 +0000[diff] [blame]77
Stefan Reinauer06b2c4d2005-12-01 10:51:08 +0000[diff] [blame]78
Uwe Hermannd1129ac2009-05-28 15:07:42 +0000[diff] [blame]79Installation
80------------
81
82In order to install flashrom and the manpage into /usr/local, type:
83
Carl-Daniel Hailfingera472b8b2009-10-03 17:08:02 +0000[diff] [blame]84 make install
Uwe Hermannd1129ac2009-05-28 15:07:42 +0000[diff] [blame]85
86For installation in a different directory use DESTDIR, e.g. like this:
87
Carl-Daniel Hailfingera472b8b2009-10-03 17:08:02 +0000[diff] [blame]88 make DESTDIR=/usr install
89
90If you have insufficient permissions for the destination directory, use sudo
91by adding sudo in front of the commands above.
Uwe Hermannd1129ac2009-05-28 15:07:42 +0000[diff] [blame]92
93
Joerg Mayer7221d5f2009-08-24 13:24:52 +0000[diff] [blame]94Contact
Uwe Hermanne94dbf22009-05-22 13:18:38 +0000[diff] [blame]95-------
96
97The official flashrom website is:
98
Stefan Reinauer22ea8cd2009-07-30 13:32:26 +0000[diff] [blame]99 http://www.flashrom.org/
Uwe Hermannb6d28322006-12-04 08:15:47 +0000[diff] [blame]100
Joerg Mayer7221d5f2009-08-24 13:24:52 +0000[diff] [blame]101The IRC channel is
102
103 #flashrom at irc.freenode.net
104
105The Mailing list addess is
106
107 flashrom@flashrom.org