NAME¶
flash-apex - write APEX binary image into MTD flash
SYNOPSIS¶
flash-apex
DESCRIPTION¶
The
flash-apex script reads a raw (objdump'd) APEX binary image from the
file
/boot/apex.flash, also part of the apex-nslu2 package, and writes
it into MTD flash. It is called automatically from the package postinst
script.
flash-apex is designed to safely upgrade APEX. It executes properly on
either big or little endian machiness, compensating for endianness mismatch as
necessary. Before flashing, it reads the APEX configuration environment from
MTD flash using
apex-env(8) and then writes it back into MTD after writing the
APEX image. In this release,
flash-apex only supports the Linksys
NSLU2.
If you need to flash a custom version of APEX, move the file
/boot/apex.flash out of the way, write your image to
/boot/apex.flash, and run
flash-apex.
flash-apex requires the
/dev/mtd driver.
WARNING¶
Though this script has been thoroughly tested, it modifies boot-flash. A failure
during this process could prevent your NSLU2 from booting. In this event,
you'll need to use upgrade mode to restore the NSLU2 to a working state. Use
/boot/apex.flash to install a custom version of APEX only if you know
what you are doing and only when you have a backup of MTD flash.
OPTIONS¶
none
FILES¶
- /boot/apex.flash
- The APEX binary image written to MTD flash by flash-apex.
BUGS¶
Please check the debian bug tracking system at
http://bugs.debian.org/src:apex
for known bugs before reporting any new bugs there.
AUTHOR¶
flash-apex was written by Gordon Farquharson
<gordonfarquharson@gmail.com>, Martin Michlmayr <tbm@cyrius.com>,
and Joey Hess <joeyh@debian.org>. This manpage was written by Kevin
Price <kp@kevin-price.de> and Marc Singer <elf@debian.org>.
SEE ALSO¶
http://www.nslu2-linux.org/wiki/Info/BootFlash
COPYING¶
The script and this manpage are copyrighted and protected by the GNU GPL.