NAME

       pflash - manual page for Open-Power Flash tool

SYNOPSIS

       pflash [options] commands...

DESCRIPTION

       pflash is a tool to access the flash modules on such systems and update the OpenPower firmware.

   Options
       -a address, --address=address
              Specify the start address for erasing, reading or flashing

       -s size, --size=size
              Specify the size in bytes for erasing, reading or flashing

       -P part_name, --partition=part_name
              Specify  the partition whose content is to be erased programmed or read. This is an alternative to
              -a and -s if both -P and -s are specified, the smallest of the two will be used

       -f, --force
              Don't ask for confirmation before erasing or flashing

       -d, --dummy
              Don't write to flash

       -m, --mtd
              Avoid accessing the flash directly if the BMC supports it.  This will access the flash through the
              kernel MTD layer and not the flash directly

       -b, --bmc
              Target BMC flash instead of host flash.  Note: This carries a high chance of bricking your BMC  if
              you don't know what you're doing. Consider --mtd to be safe(r)

       -F filename, --flash-file filename
              Target filename instead of actual flash.

       -S, --side
              Side of the flash on which to operate, 0 (default) or 1

       -T, --toc
              libffs TOC on which to operate, defaults to 0.  leading 0x is required for interpretation of a hex
              value

   Commands:
       -4, --enable-4B
              Switch the flash and controller to 4-bytes address mode (no confirmation needed).

       -3, --disable-4B
              Switch the flash and controller to 3-bytes address mode (no confirmation needed).

       -r file, --read=file
              Read  flash content from address into file, use -s to specify the size to read (or it will use the
              source file size if used in conjunction with -p and -s is not specified). When using  -r  together
              with -e or -p, the read will be performed first

       -E, --erase-all
              Erase entire flash chip (Not supported on all chips/controllers)

       -e, --erase
              Erase  the  specified  region. If size or address are not specified, but '--program' is used, then
              the file size will be used (rounded to an erase block) and the address defaults to 0.

       -p file, --program=file
              Will program the file to flash. If the address is not specified, it will use 0. If the size is not
              specified it will use the file size. Otherwise it will limit to the specified  size  (whatever  is
              smaller). If used in conjunction with any erase command, the erase will take place first.

       -t, --tune
              Just tune the flash controller & access size (Implicit for all other operations)

       -c --clear
              Used  to  ECC  clear  a partition of the flash Must be used in conjunction with -P. Will erase the
              partition and then set all the ECC bits as they should be

       -i, --info
              Display some information about the flash.

       -h, --help
              This message.

                                                 September 2016                                        pflash(8)