mirror of
https://review.coreboot.org/flashrom.git
synced 2025-04-27 15:12:36 +02:00
a23041ccbe
In particular, it should no longer be necessary to patch the makefile for hassle-free compilation. The targets are: make export make tarball Both preserve svn revisions and the exported tree does not depend on subversion in any way or shape. Documentation for this feature has been added to README. We need this for five reasons: 1. Packagers currently have to patch flashrom source to compile it on systems without subversion. We should make it easier for them. 2. Snapshot tarballs currently have a .svn 1.5 directory included but this will cause errors for users with older svn 1.4. Not requiring subversion for snapshot compilation is best. 3. Since packagers seldom the svn revision in their fixup patches, some packages out there have incorrect or no revision, only major version numbers. 4. Releasing a new version of flashrom needs too many changes to the makefile which have to be reverted instantly after the release. That is unnecessary churn. 5. Making a release is easy with the change. Update the major version, then run "make tarball". Corresponding to flashrom svn r587. Signed-off-by: Carl-Daniel Hailfinger <c-d.hailfinger.devel.2006@gmx.net> Acked-by: Uwe Hermann <uwe@hermann-uwe.de>
127 lines
2.8 KiB
Plaintext
127 lines
2.8 KiB
Plaintext
-------------------------------------------------------------------------------
|
|
flashrom README
|
|
-------------------------------------------------------------------------------
|
|
|
|
flashrom is a utility for reading, writing, verifying and erasing flash ROM
|
|
chips. It's often used to flash BIOS/EFI/coreboot/firmware images in-system
|
|
using a supported mainboard, but it also supports flashing of network
|
|
cards (NICs), SATA controller cards, and other external devices which can
|
|
program flash chips.
|
|
|
|
It supports a wide range of DIP32, PLCC32, DIP8, SO8/SOIC8, TSOP32, and
|
|
TSOP40 chips, which use various protocols such as LPC, FWH, parallel flash,
|
|
or SPI.
|
|
|
|
(see http://coreboot.org for details on coreboot)
|
|
|
|
|
|
Packaging
|
|
---------
|
|
|
|
To package flashrom and remove dependencies on subversion, either use
|
|
make export
|
|
or
|
|
make tarball
|
|
|
|
make export will export all flashrom files from the subversion repository at
|
|
revision BASE into a directory named $EXPORTDIR/flashrom-$VERSION-r$SVNREVISION
|
|
and will additionally modify the Makefile in that directory to contain the svn
|
|
revision of the exported tree.
|
|
|
|
make tarball will simply tar up the result of make export and gzip compress it.
|
|
|
|
The snapshot tarballs are the result of make tarball and require no further
|
|
processing.
|
|
|
|
|
|
Build Instructions
|
|
------------------
|
|
|
|
To build flashrom you need to install the following packages or ports:
|
|
|
|
Linux et al:
|
|
|
|
* pciutils
|
|
* pciutils-devel / pciutils-dev / libpci-dev
|
|
* zlib-devel / zlib1g-dev
|
|
|
|
On FreeBSD, you need the following ports:
|
|
|
|
* devel/gmake
|
|
* devel/libpci
|
|
|
|
To compile on Linux, use:
|
|
|
|
make
|
|
|
|
To compile on FreeBSD, use:
|
|
|
|
gmake
|
|
|
|
To compile on Solaris, use:
|
|
|
|
gmake LDFLAGS="-L$pathtolibpci -lpci -lz" CC="gcc -I$pathtopciheaders" \
|
|
CFLAGS=-O2
|
|
|
|
To compile on DragonFly BSD, use:
|
|
|
|
ln -s /usr/pkg/include/pciutils pci
|
|
gmake CFLAGS=-I. LDFLAGS="-L/usr/pkg/lib -lpci -lz"
|
|
|
|
To compile and run on Darwin/Mac OS X:
|
|
|
|
Install DirectIO from coresystems GmbH.
|
|
DirectIO is available at http://www.coresystems.de/en/directio.
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
In order to install flashrom and the manpage into /usr/local, type:
|
|
|
|
sudo make install
|
|
|
|
For installation in a different directory use DESTDIR, e.g. like this:
|
|
|
|
sudo make DESTDIR=/usr install
|
|
|
|
|
|
Usage / Options
|
|
---------------
|
|
|
|
Please see the flashrom(8) manpage.
|
|
|
|
|
|
Exit status
|
|
-----------
|
|
|
|
Please see the flashrom(8) manpage.
|
|
|
|
|
|
coreboot Table and Mainboard Identification
|
|
--------------------------------------------
|
|
|
|
Please see the flashrom(8) manpage.
|
|
|
|
|
|
ROM Layout Support
|
|
------------------
|
|
|
|
Please see the flashrom(8) manpage.
|
|
|
|
|
|
Supported Flash Chips / Chipsets / Mainboards
|
|
---------------------------------------------
|
|
|
|
Please check the output of 'flashrom -L' for the list of supported
|
|
flash chips, chipsets/southbridges, mainboards, and flash programmers.
|
|
|
|
|
|
Website
|
|
-------
|
|
|
|
The official flashrom website is:
|
|
|
|
http://coreboot.org/Flashrom
|
|
|