trusty (8) flashrom.8.gz

Provided by: flashrom_0.9.6.1+r1563-1_amd64 bug

NAME

       flashrom - detect, read, write, verify and erase flash chips

SYNOPSIS

       flashrom [-h|-R|-L|-z|-p <programmername>[:<parameters>]
                      [-E|-r <file>|-w <file>|-v <file>] [-c <chipname>]
                      [-l <file> [-i <image>]] [-n] [-f]]
                [-V[V[V]]] [-o <logfile>]

DESCRIPTION

       flashrom is a utility for detecting, reading, writing, verifying and erasing flash chips. It's often used
       to flash BIOS/EFI/coreboot/firmware images in-system  using  a  supported  mainboard.  However,  it  also
       supports  various external PCI/USB/parallel-port/serial-port based devices which can program flash chips,
       including some network cards (NICs), SATA/IDE controller cards, graphics cards, the  Bus  Pirate  device,
       various FTDI FT2232/FT4232H based USB devices, and more.

       It  supports a wide range of DIP32, PLCC32, DIP8, SO8/SOIC8, TSOP32, TSOP40, TSOP48, and BGA chips, which
       use various protocols such as LPC, FWH, parallel flash, or SPI.

OPTIONS

       IMPORTANT: Please note that the command line interface for flashrom will change before flashrom  1.0.  Do
       not  use  flashrom  in scripts or other automated tools without checking that your flashrom version won't
       interpret options in a different way.

       You can specify one of -h, -R, -L, -z, -E, -r, -w, -v or no operation.  If  no  operation  is  specified,
       flashrom  will only probe for flash chips. It is recommended that if you try flashrom the first time on a
       system, you run it in probe-only mode and check the output. Also you are advised to make a backup of your
       current ROM contents with -r before you try to write a new image.

       -r, --read <file>
              Read  flash ROM contents and save them into the given <file>.  If the file already exists, it will
              be overwritten.

       -w, --write <file>
              Write <file> into flash ROM. This will first automatically erase the chip, then write to it.

              In the process the chip is also read several times. First an in-memory backup is made for disaster
              recovery  and  to  be  able to skip regions that are already equal to the image file. This copy is
              updated along with the write operation. In case of erase errors it  is  even  re-read  completely.
              After  writing  has  finished and if verification is enabled, the whole flash chip is read out and
              compared with the input image.

       -n, --noverify
              Skip the automatic verification of flash ROM contents after writing.  Using  this  option  is  not
              recommended,  you  should only use it if you know what you are doing and if you feel that the time
              for verification takes too long.

              Typical usage is: flashrom -p prog -n -w <file>

              This option is only useful in combination with --write.

       -v, --verify <file>
              Verify the flash ROM contents against the given <file>.

       -E, --erase
              Erase the flash ROM chip.

       -V, --verbose
              More verbose output. This option can be supplied multiple times (max. 3  times,  i.e.   -VVV)  for
              even more debug output.

       -c, --chip <chipname>
              Probe  only  for  the  specified  flash  ROM  chip.  This option takes the chip name as printed by
              flashrom -L without the vendor name  as  parameter.  Please  note  that  the  chip  name  is  case
              sensitive.

       -f, --force
              Force one or more of the following actions:

              * Force chip read and pretend the chip is there.

              * Force chip access even if the chip is bigger than the maximum supported size for the flash bus.

              * Force erase even if erase is known bad.

              * Force write even if write is known bad.

       -l, --layout <file>
              Read ROM layout from <file>.

              flashrom  supports  ROM  layouts. This allows you to flash certain parts of the flash chip only. A
              ROM layout file contains multiple lines with the following syntax:

                startaddr:endaddr imagename

              startaddr and endaddr are hexadecimal addresses within the ROM  file  and  do  not  refer  to  any
              physical  address.  Please  note  that  using  a  0x  prefix  for those hexadecimal numbers is not
              necessary, but you can't specify decimal/octal numbers.  imagename is an arbitrary  name  for  the
              region/image from  startaddr to endaddr (both addresses included).

              Example:

                00000000:00008fff gfxrom
                00009000:0003ffff normal
                00040000:0007ffff fallback

              If you only want to update the image named normal in a ROM based on the layout above, run

                flashrom -p prog --layout rom.layout --image normal -w some.rom

              To update only the images named normal and fallback, run:

                flashrom -p prog -l rom.layout -i normal -i fallback -w some.rom

              Overlapping sections are not supported.

       -i, --image <imagename>
              Only flash region/image <imagename> from flash layout.

       -L, --list-supported
              List the flash chips, chipsets, mainboards, and external programmers (including PCI, USB, parallel
              port, and serial port based devices) supported by flashrom.

              There are many unlisted boards which will  work  out  of  the  box,  without  special  support  in
              flashrom.  Please  let  us know if you can verify that other boards work or do not work out of the
              box.

              IMPORTANT: For verification you have to test an ERASE and/or WRITE operation,  so  make  sure  you
              only do that if you have proper means to recover from failure!

       -z, --list-supported-wiki
              Same  as  --list-supported, but outputs the supported hardware in MediaWiki syntax, so that it can
              be easily pasted into the wiki page  at  http://www.flashrom.org/.   Please  note  that  MediaWiki
              output is not compiled in by default.

       -p, --programmer <name>[:parameter[,parameter[,parameter]]]
              Specify  the  programmer  device.  This  is mandatory for all operations involving any chip access
              (probe/read/write/...). Currently supported are:

              * internal (default, for in-system flashing in the mainboard)

              * dummy (virtual programmer for testing flashrom)

              * nic3com (for flash ROMs on 3COM network cards)

              * nicrealtek (for flash ROMs on Realtek network cards)

              * nicsmc1211 (for flash ROMs on RTL8139-compatible SMC2 network cards)

              * nicnatsemi (for flash ROMs on National Semiconductor DP838* network cards)

              * nicintel (for parallel flash ROMs on Intel 10/100Mbit network cards)

              * gfxnvidia (for flash ROMs on NVIDIA graphics cards)

              * drkaiser (for flash ROMs on Dr. Kaiser PC-Waechter PCI cards)

              * satasii (for flash ROMs on Silicon Image SATA/IDE controllers)

              * satamv (for flash ROMs on Marvell SATA controllers)

              * atahpt (for flash ROMs on Highpoint ATA/RAID controllers)

              * ft2232_spi (for SPI flash ROMs attached to an FT2232/FT4232H family based USB  SPI  programmer),
              including  the  DLP  Design  DLP-USB1232H,  FTDI  FT2232H  Mini-Module,  FTDI FT4232H Mini-Module,
              openbiosprog-spi, Amontec JTAGkey/JTAGkey-tiny/JTAGkey-2, Dangerous Prototypes Bus Blaster, Olimex
              ARM-USB-TINY/-H,  Olimex  ARM-USB-OCD/-H,  TIAO/DIYGADGET  USB Multi-Protocol Adapter (TUMPA), and
              GOEPEL PicoTAP.

              * serprog (for flash ROMs attached to a programmer speaking serprog),  including  AVR  flasher  by
              Urja  Rannikko,  AVR flasher by eightdot, Arduino Mega flasher by fritz, InSystemFlasher by Juhana
              Helovuo, and atmegaXXu2-flasher by Stefan Tauner.

              * buspirate_spi (for SPI flash ROMs attached to a Bus Pirate)

              * dediprog (for SPI flash ROMs attached to a Dediprog SF100)

              * rayer_spi (for SPI flash ROMs attached to a RayeR parport or Xilinx DLC5 compatible cable)

              * pony_spi (for SPI flash ROMs attached to a SI-Prog serial port bitbanging adapter)

              * nicintel_spi (for SPI flash ROMs on Intel Gigabit network cards)

              * ogp_spi (for SPI flash ROMs on Open Graphics Project graphics card)

              * linux_spi (for SPI flash ROMs accessible via /dev/spidevX.Y on Linux)

              Some programmers have optional or mandatory parameters  which  are  described  in  detail  in  the
              PROGRAMMER  SPECIFIC  INFO  section. Support for some programmers can be disabled at compile time.
              flashrom -h lists all supported programmers.

       -h, --help
              Show a help text and exit.

       -o, --output <logfile>
              Save the full debug log to <logfile>.  If the file already exists, it will be overwritten. This is
              the  recommended  way  to  gather  logs from flashrom because they will be verbose even if the on-
              screen messages are not verbose.

       -R, --version
              Show version information and exit.

PROGRAMMER SPECIFIC INFO

       Some programmer drivers accept further parameters to set programmer-specific parameters. These parameters
       are  separated  from  the  programmer  name  by  a  colon. While some programmers take arguments at fixed
       positions, other programmers use a key/value interface in which the key and  value  is  separated  by  an
       equal sign and different pairs are separated by a comma or a colon.

   internal programmer
       Board Enables

              Some  mainboards  require  to  run mainboard specific code to enable flash erase and write support
              (and probe support on old systems with parallel flash).  The mainboard  brand  and  model  (if  it
              requires  specific  code)  is  usually autodetected using one of the following mechanisms: If your
              system is running coreboot, the mainboard type is determined from the coreboot table.   Otherwise,
              the  mainboard  is detected by examining the onboard PCI devices and possibly DMI info. If PCI and
              DMI do not contain information to uniquely identify the mainboard (which is the exception), or  if
              you want to override the detected mainboard model, you can specify the mainboard using the

                flashrom -p internal:mainboard=[<vendor>:]<board> syntax.

              See  the  'Known  boards'  or 'Known laptops' section in the output of 'flashrom -L' for a list of
              boards which require the specification of the board name, if no coreboot table is found.

              Some of these board-specific flash enabling functions (called board enables) in flashrom have  not
              yet  been  tested.  If  your  mainboard  is  detected needing an untested board enable function, a
              warning message is printed and the board enable is not executed,  because  a  wrong  board  enable
              function  might  cause  the system to behave erratically, as board enable functions touch the low-
              level internals of a mainboard. Not executing a board enable function (if  one  is  needed)  might
              cause  detection  or  erasing failure. If your board protects only part of the flash (commonly the
              top end, called boot block), flashrom might encounter an error only after erasing the  unprotected
              part,  so  running without the board-enable function might be dangerous for erase and write (which
              includes erase).

              The suggested procedure for a mainboard with untested board specific code is to first try to probe
              the  ROM (just invoke flashrom and check that it detects your flash chip type) without running the
              board enable code (i.e.  without any parameters). If it finds your chip,  fine.  Otherwise,  retry
              probing your chip with the board-enable code running, using

                flashrom -p internal:boardenable=force

              If  your  chip  is  still not detected, the board enable code seems to be broken or the flash chip
              unsupported. Otherwise, make a backup of your current ROM contents (using -r) and store  it  to  a
              medium  outside  of  your  computer, like a USB drive or a network share. If you needed to run the
              board enable code already for probing, use it for reading too. Now you can try to  write  the  new
              image.  You should enable the board enable code in any case now, as it has been written because it
              is known that writing/erasing without the board enable is going to fail. In any case  (success  or
              failure), please report to the flashrom mailing list, see below.

       Coreboot

              On  systems  running  coreboot,  flashrom checks whether the desired image matches your mainboard.
              This needs some special board ID to be present in the image.  If flashrom detects that  the  image
              you want to write and the current board do not match, it will refuse to write the image unless you
              specify

                flashrom -p internal:boardmismatch=force

       ITE IT87 Super I/O

              If your mainboard uses an ITE IT87 series Super I/O for LPC<->SPI flash bus translation,  flashrom
              should  autodetect that configuration. If you want to set the I/O base port of the IT87 series SPI
              controller manually instead of using the value provided by the BIOS, use the

                flashrom -p internal:it87spiport=portnum

              syntax where portnum is the I/O port number (must be a  multiple  of  8).  In  the  unlikely  case
              flashrom  doesn't  detect  an  active  IT87  LPC<->SPI  bridge, please send a bug report so we can
              diagnose the problem.

       Intel chipsets

              If you have an Intel chipset with an ICH8 or later southbridge with SPI flash attached, and  if  a
              valid  descriptor  was written to it (e.g. by the vendor), the chipset provides an alternative way
              to access the flash chip(s) named Hardware Sequencing.  It is much simpler than the normal  access
              method (called Software Sequencing), but does not allow the software to choose the SPI commands to
              be sent.  You can use the

                flashrom -p internal:ich_spi_mode=value

              syntax where value can be auto, swseq or hwseq.  By default (or  when  setting  ich_spi_mode=auto)
              the  module  tries to use swseq and only activates hwseq if need be (e.g. if important opcodes are
              inaccessible due to lockdown; or if more than one flash  chip  is  attached).  The  other  options
              (swseq, hwseq) select the respective mode (if possible).

              ICH8  and  later  southbridges  may  also have locked address ranges of different kinds if a valid
              descriptor was written to it. The flash address space is then partitioned in  multiple  so  called
              "Flash  Regions"  containing  the host firmware, the ME firmware and so on respectively. The flash
              descriptor can also specify up to 5 so called "Protected Regions", which are freely chosen address
              ranges  independent  from the aforementioned "Flash Regions". All of them can be write and/or read
              protected individually. If flashrom detects such a lock it will disable write support  unless  the
              user forces it with the

                flashrom -p internal:ich_spi_force=yes

              syntax. If this leads to erase or write accesses to the flash it would most probably bring it into
              an inconsistent and unbootable state and we will not provide any support in such a case.

              If you have an Intel chipset with an ICH6 or later southbridge and if you  want  to  set  specific
              IDSEL values for a non-default flash chip or an embedded controller (EC), you can use the

                flashrom -p internal:fwh_idsel=value

              syntax where value is the 48-bit hexadecimal raw value to be written in the IDSEL registers of the
              Intel southbridge. The upper 32 bits use one hex digit each per 512 kB  range  between  0xffc00000
              and  0xffffffff, and the lower 16 bits use one hex digit each per 1024 kB range between 0xff400000
              and 0xff7fffff.  The rightmost hex digit corresponds with the lowest address  range.  All  address
              ranges  have  a  corresponding  sister range 4 MB below with identical IDSEL settings. The default
              value for ICH7 is given in the example below.

              Example: flashrom -p internal:fwh_idsel=0x001122334567

       Laptops

              Using flashrom on laptops is dangerous and may easily make your hardware unusable  (see  also  the
              BUGS section). The embedded controller (EC) in these machines often interacts badly with flashing.
              http://www.flashrom.org/Laptops has more  information.  For  example  the  EC  firmware  sometimes
              resides  on  the same flash chip as the host firmware. While flashrom tries to change the contents
              of that memory the EC might need to fetch new instructions or data from it and could stop  working
              correctly.  Probing for and reading from the chip may also irritate your EC and cause fan failure,
              backlight failure, sudden poweroff, and other nasty effects. flashrom will attempt to detect if it
              is  running on a laptop and abort immediately for safety reasons if it clearly identifies the host
              computer as one. If you want to proceed anyway at your own risk, use

                flashrom -p internal:laptop=force_I_want_a_brick

              We will not help you if you force flashing on a laptop because this is a really dumb idea.

              You have been warned.

              Currently we rely on the chassis type encoded in the  DMI/SMBIOS  data  to  detect  laptops.  Some
              vendors  did  not  implement  those  bits  correctly  or  set them to generic and/or dummy values.
              flashrom will then issue a warning and bail out like above. In this case you can use

                flashrom -p internal:laptop=this_is_not_a_laptop

              to tell flashrom (at your own risk) that it does not running on a laptop.

   dummy programmer
       The dummy programmer operates on a buffer in memory only. It provides a safe and fast way to test various
       aspects of flashrom and is mainly used in development and while debugging.

       It is able to emulate some chips to a certain degree (basic identify/read/erase/write operations work).

       An optional parameter specifies the bus types it should support. For that you have to use the

         flashrom -p dummy:bus=[type[+type[+type]]]

       syntax where type can be parallel, lpc, fwh, spi in any order. If you specify bus without type, all buses
       will be disabled.  If you do not specify bus, all buses will be enabled.

       Example: flashrom -p dummy:bus=lpc+fwh

       The dummy programmer supports flash chip emulation for automated self-tests without hardware  access.  If
       you want to emulate a flash chip, use the

         flashrom -p dummy:emulate=chip

       syntax where chip is one of the following chips (please specify only the chip name, not the vendor):

       * ST M25P10.RES SPI flash chip (RES, page write)

       * SST SST25VF040.REMS SPI flash chip (REMS, byte write)

       * SST SST25VF032B SPI flash chip (RDID, AAI write)

       * Macronix MX25L6436 SPI flash chip (RDID, SFDP)

       Example: flashrom -p dummy:emulate=SST25VF040.REMS

       Persistent images

              If you use flash chip emulation, flash image persistence is available as well by using the

                flashrom -p dummy:emulate=chip,image=image.rom

              syntax  where image.rom is the file where the simulated chip contents are read on flashrom startup
              and where the chip contents on flashrom shutdown are written to.

              Example: flashrom -p dummy:emulate=M25P10.RES,image=dummy.bin

       SPI write chunk size

              If you use SPI flash chip emulation for a chip which supports SPI  page  write  with  the  default
              opcode, you can set the maximum allowed write chunk size with the

                flashrom -p dummy:emulate=chip,spi_write_256_chunksize=size

              syntax where size is the number of bytes (min. 1, max. 256).

              Example:

                flashrom -p dummy:emulate=M25P10.RES,spi_write_256_chunksize=5

       SPI blacklist

              To  simulate  a  programmer  which refuses to send certain SPI commands to the flash chip, you can
              specify a blacklist of SPI commands with the

                flashrom -p dummy:spi_blacklist=commandlist

              syntax where commandlist is a list of two-digit hexadecimal representations of  SPI  commands.  If
              commandlist  is  e.g.  0302,  flashrom will behave as if the SPI controller refuses to run command
              0x03 (READ) and command 0x02 (WRITE).  commandlist may be up  to  512  characters  (256  commands)
              long.  Implementation note: flashrom will detect an error during command execution.

       SPI ignorelist

              To  simulate a flash chip which ignores (doesn't support) certain SPI commands, you can specify an
              ignorelist of SPI commands with the

                flashrom -p dummy:spi_ignorelist=commandlist

              syntax where commandlist is a list of two-digit hexadecimal representations of  SPI  commands.  If
              commandlist is e.g. 0302, the emulated flash chip will ignore command 0x03 (READ) and command 0x02
              (WRITE).  commandlist may be up to 512  characters  (256  commands)  long.   Implementation  note:
              flashrom won't detect an error during command execution.

       SPI status register

              You can specify the initial content of the chip's status register with the

                flashrom -p dummy:spi_status=content

              syntax where content is an 8-bit hexadecimal value.

   nic3com,  nicrealtek,  nicsmc1211, nicnatsemi, nicintel, nicintel_spi, gfxnvidia, ogp_spi, drkaiser, satasii,
       satamv, and atahpt programmers
       These programmers have an option to specify the PCI address of the card your want to use, which  must  be
       specified  if  more  than  one card supported by the selected programmer is installed in your system. The
       syntax is

         flashrom -p xxxx:pci=bb:dd.f,

       where xxxx is the name of the programmer bb is the PCI bus number, dd is the PCI device number, and f  is
       the PCI function number of the desired device.

       Example: flashrom -p nic3com:pci=05:04.0

   ft2232_spi programmer
       An  optional  parameter  specifies the controller type and interface/port it should support. For that you
       have to use the

         flashrom -p ft2232_spi:type=model,port=interface

       syntax where model can be 2232H, 4232H, jtagkey, busblaster, openmoko, arm-usb-tiny, arm-usb-tiny-h, arm-
       usb-ocd,  arm-usb-ocd-h,  tumpa, or picotap and interface can be A, or B.  The default model is 4232H and
       the default interface is B.

       All models supported by the ft2232_spi driver can configure the SPI clock rate by setting a divisor.  The
       expressible divisors are all even numbers between 2 and 2^17 (=131072) resulting in SPI clock frequencies
       of 6 MHz down to about 92 Hz for 12 MHz inputs. The default divisor is set to 2, but you can use  another
       one by specifying the optional divisor parameter with the

         flashrom -p ft2232_spi:divisor=div

       syntax.

   serprog programmer
       A  mandatory  parameter  specifies  either a serial device/baud combination or an IP/port combination for
       communication with the programmer. In the device/baud combination, the device has to start with a  slash.
       For serial, you have to use the

         flashrom -p serprog:dev=/dev/device:baud

       syntax and for IP, you have to use

         flashrom -p serprog:ip=ipaddr:port

       instead. More information about serprog is available in serprog-protocol.txt in the source distribution.

   buspirate_spi programmer
       A  required  dev  parameter  specifies  the  Bus  Pirate  device  node and an optional spispeed parameter
       specifies the frequency of the SPI bus. The parameter delimiter is a comma. Syntax is

         flashrom -p buspirate_spi:dev=/dev/device,spispeed=frequency

       where frequency can be 30k, 125k, 250k, 1M, 2M, 2.6M, 4M or 8M  (in  Hz).  The  default  is  the  maximum
       frequency of 8 MHz.

   dediprog programmer
       An  optional voltage parameter specifies the voltage the Dediprog should use. The default unit is Volt if
       no unit is specified. You can use mV, milliVolt, V or Volt as unit specifier. Syntax is

         flashrom -p dediprog:voltage=value

       where value can be 0V, 1.8V, 2.5V, 3.5V or the equivalent in mV.

   rayer_spi programmer
       The default I/O base address used for the parallel port is 0x378 and you  can  use  the  optional  iobase
       parameter to specify an alternate base I/O address with the

         flashrom -p rayer_spi:iobase=baseaddr

       syntax  where  baseaddr  is base I/O port address of the parallel port, which must be a multiple of four.
       Make sure to not forget the "0x" prefix for hexadecimal port addresses.

       The default cable type is the RayeR cable. You can use the optional type parameter to specify  the  cable
       type with the

         flashrom -p rayer_spi:type=model

       syntax where model can be rayer for the RayeR cable or xilinx for the Xilinx Parallel Cable III (DLC 5).

       More  information  about  the RayeR hardware is available at http://rayer.ic.cz/elektro/spipgm.htm .  The
       schematic        of        the        Xilinx        DLC        5         was         published         at
       http://www.xilinx.com/itp/xilinx4/data/docs/pac/appendixb.html .

   pony_spi programmer
       The  serial  port  (like  /dev/ttyS0,  /dev/ttyUSB0  on  Linux or COM3 on windows) is specified using the
       mandatory dev parameter. The adapter type is selectable  between  SI-Prog  (used  for  SPI  devices  with
       PonyProg 2000) or a custom made serial bitbanging programmer named "serbang". The optional type parameter
       accepts the values "si_prog" (default) or "serbang".

       Information about the SI-Prog adapter can be found at http://www.lancos.com/siprogsch.html .

       An example call to flashrom is

         flashrom -p pony_spi:dev=/dev/ttyS0,type=serbang

       Please note that while USB-to-serial adapters work under certain circumstances, this slows down operation
       considerably.

   ogp_spi programmer
       The flash ROM chip to access must be specified with the rom parameter.

         flashrom -p ogp_spi:rom=name

       Where  name  is  either cprom or s3 for the configuration ROM and bprom or bios for the BIOS ROM. If more
       than one card supported by the ogp_spi programmer is installed in your system, you have  to  specify  the
       PCI  address  of  the  card  you  want to use with the pci= parameter as explained in the nic3com section
       above.

       More information about the hardware is available at http://wiki.opengraphics.org.

   linux_spi programmer
       You have to specify the SPI controller to use with the

         flashrom -p linux_spi:dev=/dev/spidevX.Y

       syntax where /dev/spidevX.Y is the Linux device node for your SPI controller.

       Please note that the linux_spi driver only works on Linux.

EXAMPLES

       To back up and update your BIOS, run

       flashrom -p internal -r backup.rom -o backuplog.txt
       flashrom -p internal -w newbios.rom -o writelog.txt

       Please make sure to copy backup.rom to some external media before you try to write.  That  makes  offline
       recovery easier.
       If  writing fails and flashrom complains about the chip being in an unknown state, you can try to restore
       the backup by running

       flashrom -p internal -w backup.rom -o restorelog.txt

       If  you  encounter  any  problems,  please  contact  us  and  supply  backuplog.txt,   writelog.txt   and
       restorelog.txt. See section BUGS for contact info.

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.

REQUIREMENTS

       flashrom needs different access permissions for different programmers.

       internal needs raw memory access, PCI configuration space access, raw  I/O  port  access  (x86)  and  MSR
       access (x86).

       nic3com,  nicrealtek, nicsmc1211 and nicnatsemi need PCI configuration space read access and raw I/O port
       access.

       atahpt needs PCI configuration space access and raw I/O port access.

       gfxnvidia and drkaiser need PCI configuration space access and raw memory access.

       rayer_spi needs raw I/O port access.

       satasii needs PCI configuration space read access and raw memory access.

       satamv needs PCI configuration space read access, raw I/O port access and raw memory access.

       serprog needs TCP access to the network or userspace access to a serial port.

       buspirate_spi needs userspace access to a serial port.

       dediprog and ft2232_spi need access to the USB device via libusb.

       dummy needs no access permissions at all.

       internal, nic3com, nicrealtek, nicsmc1211, nicnatsemi, gfxnvidia, drkaiser, satasii,  satamv  and  atahpt
       have to be run as superuser/root, and need additional raw access permission.

       serprog,  buspirate_spi,  dediprog  and ft2232_spi can be run as normal user on most operating systems if
       appropriate device permissions are set.

       ogp needs PCI configuration space read access and raw memory access.

       On OpenBSD, you can obtain raw access permission by setting  securelevel=-1  in  /etc/rc.securelevel  and
       rebooting, or rebooting into single user mode.

BUGS

       Please report any bugs to the flashrom mailing list at <flashrom@flashrom.org>

       We recommend to subscribe first at

         http://www.flashrom.org/mailman/listinfo/flashrom

       Many  of  the developers communicate via the #flashrom IRC channel on chat.freenode.net.  You are welcome
       to join and ask questions, send us bug and success reports there too. Please provide a way to contact you
       later (e.g. a mail address) and be patient if there is no immediate reaction. Also, we provide a pastebin
       service at http://paste.flashrom.org that is very useful  when  you  want  to  share  logs  etc.  without
       spamming the channel.

   Laptops
       Using  flashrom on laptops is dangerous and may easily make your hardware unusable. flashrom will attempt
       to detect if it is running on a laptop and abort immediately for safety reasons. Please see the  detailed
       discussion  of  this  topic  and  associated  flashrom  options  in the Laptops paragraph in the internal
       programmer subsection of the PROGRAMMER SPECIFIC INFO section.    http://www.flashrom.org/Laptops

   One-time programmable (OTP) memory and unique IDs
       Some flash chips contain OTP memory often denoted as "security registers".  They usually have a  capacity
       in  the  range  of  some  bytes  to  a  few hundred bytes and can be used to give devices unique IDs etc.
       flashrom is not able to read or write these memories and may therefore not be able to  duplicate  a  chip
       completely. For chip types known to include OTP memories a warning is printed when they are detected.

       Similar  to OTP memories are unique, factory programmed, unforgeable IDs.  They are not modifiable by the
       user at all.

LICENSE

       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).

       Please see the individual files.

AUTHORS

       Andrew Morgan
       Carl-Daniel Hailfinger
       Claus Gindhart
       David Borg
       David Hendricks
       Dominik Geyer
       Eric Biederman
       Giampiero Giancipoli
       Helge Wagner
       Idwer Vollering
       Joe Bao
       Joerg Fischer
       Joshua Roys
       Luc Verhaegen
       Li-Ta Lo
       Mark Marshall
       Markus Boas
       Mattias Mattsson
       Michael Karcher
       Nikolay Petukhov
       Patrick Georgi
       Peter Lemenkov
       Peter Stuge
       Reinder E.N. de Haan
       Ronald G. Minnich
       Ronald Hoogenboom
       Sean Nelson
       Stefan Reinauer
       Stefan Tauner
       Stefan Wildemann
       Stephan Guilloux
       Steven James
       Uwe Hermann
       Wang Qingpei
       Yinghai Lu
       some others, please see the flashrom svn changelog for details.
       All authors can be reached via email at <flashrom@flashrom.org>.

       This  manual page was written by Uwe Hermann <uwe@hermann-uwe.de>, Carl-Daniel Hailfinger and others.  It
       is licensed under the terms of the GNU GPL (version 2 or later).

                                                  Feb 15, 2012                                       FLASHROM(8)