1
0
mirror of https://review.coreboot.org/flashrom.git synced 2025-04-27 07:02:34 +02:00
flashrom/doc/intro.rst
Anastasia Klimchuk cfc23898ad doc: Add Emergency help red box to the intro
Change-Id: Id7570b7f0773ec0e43662272e642bc807c8210c2
Signed-off-by: Anastasia Klimchuk <aklm@flashrom.org>
Reviewed-on: https://review.coreboot.org/c/flashrom/+/77292
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Peter Marheine <pmarheine@chromium.org>
2023-08-24 12:35:29 +00:00

35 lines
2.2 KiB
ReStructuredText

**flashrom** is a utility for identifying, reading, writing, verifying and erasing flash
chips. It is designed to flash BIOS/EFI/coreboot/firmware/optionROM images on mainboards,
network/graphics/storage controller cards, and various other programmer devices.
* Supports more than 476 flash chips, 291 chipsets, 500 mainboards, 79 PCI devices,
17 USB devices and various parallel/serial port-based programmers.
* Supports parallel, LPC, FWH and SPI flash interfaces and various chip packages (DIP32,
PLCC32, DIP8, SO8/SOIC8, TSOP32, TSOP40, TSOP48, BGA and more).
* No physical access needed, root access is sufficient (not needed for some programmers).
* No bootable floppy disk, bootable CD-ROM or other media needed.
* No keyboard or monitor needed. Simply reflash remotely via SSH.
* No instant reboot needed. Reflash your chip in a running system, verify it, be happy.
The new firmware will be present next time you boot.
* Crossflashing and hotflashing is possible as long as the flash chips are electrically
and logically compatible (same protocol). Great for recovery.
* Scriptability. Reflash a whole pool of identical machines at the same time from the
command line. It is recommended to check flashrom output and error codes.
* Speed. flashrom is often much faster than most vendor flash tools.
* Portability. Supports DOS, Linux, FreeBSD (including Debian/kFreeBSD), NetBSD, OpenBSD,
DragonFlyBSD, anything Solaris-like, Mac OS X, and other Unix-like OSes as well as GNU Hurd.
Partial Windows support is available (no internal programmer support at the moment, hence
no "BIOS flashing").
.. todo:: Convert Technology page and add links here
.. container:: danger, admonition
**Emergency help**
IMPORTANT: If something went wrong during flashing, do NOT turn off/reboot your computer.
Instead, let us help you recover. We can be contacted via `IRC <https://www.flashrom.org/contact.html#irc>`_
(#flashrom on `libera.chat <irc://irc.libera.chat/#flashrom>`_, `webchat <https://web.libera.chat/#flashrom>`_),
`Discord <https://www.flashrom.org/contact.html#discord>`_, or `email <https://www.flashrom.org/contact.html#mailing-list-1>`_.
Please allow some time until someone responds, we're all volunteers.